From 2ca768ad80da1643680ce99fee977080e19f2e2b Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 9 Jul 2026 16:42:33 +0000
Subject: [PATCH 1/6] feat(api): gpt-5.6-sol updates

---
 .stats.yml                                    |     8 +-
 .../kotlin/com/openai/models/ChatModel.kt     |    18 +
 .../kotlin/com/openai/models/Reasoning.kt     |   228 +-
 .../com/openai/models/ReasoningEffort.kt      |    21 +-
 .../beta/assistants/AssistantCreateParams.kt  |    71 +-
 .../beta/assistants/AssistantUpdateParams.kt  |    71 +-
 .../beta/responses/BetaApplyPatchTool.kt      |   376 +
 .../beta/responses/BetaCompactedResponse.kt   |   558 +
 .../beta/responses/BetaComputerAction.kt      |  2881 ++
 .../models/beta/responses/BetaComputerTool.kt |   171 +
 .../responses/BetaComputerUsePreviewTool.kt   |   477 +
 .../beta/responses/BetaContainerAuto.kt       |   987 +
 .../BetaContainerNetworkPolicyAllowlist.kt    |   311 +
 .../BetaContainerNetworkPolicyDisabled.kt     |   173 +
 .../BetaContainerNetworkPolicyDomainSecret.kt |   259 +
 .../beta/responses/BetaContainerReference.kt  |   227 +
 .../models/beta/responses/BetaCustomTool.kt   |  1188 +
 .../beta/responses/BetaEasyInputMessage.kt    |  1004 +
 .../beta/responses/BetaFileSearchTool.kt      |  3930 +++
 .../beta/responses/BetaFunctionShellTool.kt   |   699 +
 .../models/beta/responses/BetaFunctionTool.kt |   894 +
 .../models/beta/responses/BetaInlineSkill.kt  |   303 +
 .../beta/responses/BetaInlineSkillSource.kt   |   262 +
 .../beta/responses/BetaLocalEnvironment.kt    |   228 +
 .../models/beta/responses/BetaLocalSkill.kt   |   260 +
 .../beta/responses/BetaNamespaceTool.kt       |  1336 +
 .../models/beta/responses/BetaResponse.kt     |  9394 ++++++
 .../BetaResponseApplyPatchToolCall.kt         |  2209 ++
 .../BetaResponseApplyPatchToolCallOutput.kt   |  1216 +
 .../responses/BetaResponseAudioDeltaEvent.kt  |   475 +
 .../responses/BetaResponseAudioDoneEvent.kt   |   439 +
 .../BetaResponseAudioTranscriptDeltaEvent.kt  |   479 +
 .../BetaResponseAudioTranscriptDoneEvent.kt   |   443 +
 ...sponseCodeInterpreterCallCodeDeltaEvent.kt |   557 +
 ...esponseCodeInterpreterCallCodeDoneEvent.kt |   557 +
 ...sponseCodeInterpreterCallCompletedEvent.kt |   525 +
 ...ponseCodeInterpreterCallInProgressEvent.kt |   525 +
 ...nseCodeInterpreterCallInterpretingEvent.kt |   525 +
 .../BetaResponseCodeInterpreterToolCall.kt    |  1444 +
 .../responses/BetaResponseCompactionItem.kt   |   512 +
 .../BetaResponseCompactionItemParam.kt        |   484 +
 .../responses/BetaResponseCompletedEvent.kt   |   478 +
 .../responses/BetaResponseComputerToolCall.kt |  1320 +
 .../BetaResponseComputerToolCallOutputItem.kt |  1073 +
 ...esponseComputerToolCallOutputScreenshot.kt |   251 +
 .../BetaResponseContainerReference.kt         |   227 +
 .../beta/responses/BetaResponseContent.kt     |   600 +
 .../BetaResponseContentPartAddedEvent.kt      |  1104 +
 .../BetaResponseContentPartDoneEvent.kt       |  1104 +
 .../BetaResponseConversationParam.kt          |   183 +
 .../responses/BetaResponseCreatedEvent.kt     |   478 +
 .../responses/BetaResponseCustomToolCall.kt   |  1062 +
 ...taResponseCustomToolCallInputDeltaEvent.kt |   556 +
 ...etaResponseCustomToolCallInputDoneEvent.kt |   556 +
 .../BetaResponseCustomToolCallItem.kt         |   733 +
 .../BetaResponseCustomToolCallOutput.kt       |  1535 +
 .../BetaResponseCustomToolCallOutputItem.kt   |   683 +
 .../beta/responses/BetaResponseError.kt       |   458 +
 .../beta/responses/BetaResponseErrorEvent.kt  |   553 +
 .../beta/responses/BetaResponseFailedEvent.kt |   478 +
 ...etaResponseFileSearchCallCompletedEvent.kt |   518 +
 ...taResponseFileSearchCallInProgressEvent.kt |   520 +
 ...etaResponseFileSearchCallSearchingEvent.kt |   518 +
 .../BetaResponseFileSearchToolCall.kt         |  1180 +
 .../responses/BetaResponseFormatTextConfig.kt |   332 +
 .../BetaResponseFormatTextJsonSchemaConfig.kt |   484 +
 ...ResponseFunctionCallArgumentsDeltaEvent.kt |   556 +
 ...aResponseFunctionCallArgumentsDoneEvent.kt |   600 +
 .../BetaResponseFunctionCallOutputItem.kt     |   290 +
 ...aResponseFunctionShellCallOutputContent.kt |   731 +
 .../BetaResponseFunctionShellToolCall.kt      |  1819 ++
 ...BetaResponseFunctionShellToolCallOutput.kt |  2063 ++
 .../responses/BetaResponseFunctionToolCall.kt |  1261 +
 .../BetaResponseFunctionToolCallItem.kt       |   748 +
 .../BetaResponseFunctionToolCallOutputItem.kt |  1767 ++
 .../BetaResponseFunctionWebSearch.kt          |  1906 ++
 .../BetaResponseImageGenCallCompletedEvent.kt |   520 +
 ...BetaResponseImageGenCallGeneratingEvent.kt |   522 +
 ...BetaResponseImageGenCallInProgressEvent.kt |   520 +
 ...taResponseImageGenCallPartialImageEvent.kt |   630 +
 .../responses/BetaResponseInProgressEvent.kt  |   478 +
 .../beta/responses/BetaResponseIncludable.kt  |   195 +
 .../responses/BetaResponseIncompleteEvent.kt  |   478 +
 .../BetaResponseInjectCreatedEvent.kt         |   312 +
 .../beta/responses/BetaResponseInjectEvent.kt |   573 +
 .../BetaResponseInjectFailedEvent.kt          |  1038 +
 .../beta/responses/BetaResponseInputAudio.kt  |   574 +
 .../responses/BetaResponseInputContent.kt     |   284 +
 .../beta/responses/BetaResponseInputFile.kt   |   734 +
 .../responses/BetaResponseInputFileContent.kt |   752 +
 .../beta/responses/BetaResponseInputImage.kt  |   673 +
 .../BetaResponseInputImageContent.kt          |   671 +
 .../beta/responses/BetaResponseInputItem.kt   | 24772 ++++++++++++++++
 .../responses/BetaResponseInputMessageItem.kt |   888 +
 .../beta/responses/BetaResponseInputText.kt   |   437 +
 .../responses/BetaResponseInputTextContent.kt |   444 +
 .../models/beta/responses/BetaResponseItem.kt | 13038 ++++++++
 .../responses/BetaResponseLocalEnvironment.kt |   171 +
 .../BetaResponseMcpCallArgumentsDeltaEvent.kt |   554 +
 .../BetaResponseMcpCallArgumentsDoneEvent.kt  |   563 +
 .../BetaResponseMcpCallCompletedEvent.kt      |   517 +
 .../BetaResponseMcpCallFailedEvent.kt         |   516 +
 .../BetaResponseMcpCallInProgressEvent.kt     |   517 +
 .../BetaResponseMcpListToolsCompletedEvent.kt |   518 +
 .../BetaResponseMcpListToolsFailedEvent.kt    |   518 +
 ...BetaResponseMcpListToolsInProgressEvent.kt |   518 +
 .../beta/responses/BetaResponseOutputAudio.kt |   262 +
 .../beta/responses/BetaResponseOutputItem.kt  | 12967 ++++++++
 .../BetaResponseOutputItemAddedEvent.kt       |   699 +
 .../BetaResponseOutputItemDoneEvent.kt        |   699 +
 .../responses/BetaResponseOutputMessage.kt    |  1140 +
 .../responses/BetaResponseOutputRefusal.kt    |   223 +
 .../beta/responses/BetaResponseOutputText.kt  |  2514 ++
 ...aResponseOutputTextAnnotationAddedEvent.kt |   645 +
 .../beta/responses/BetaResponsePrompt.kt      |   383 +
 .../beta/responses/BetaResponseQueuedEvent.kt |   478 +
 .../responses/BetaResponseReasoningItem.kt    |  1198 +
 ...aResponseReasoningSummaryPartAddedEvent.kt |   812 +
 ...taResponseReasoningSummaryPartDoneEvent.kt |   994 +
 ...aResponseReasoningSummaryTextDeltaEvent.kt |   606 +
 ...taResponseReasoningSummaryTextDoneEvent.kt |   606 +
 .../BetaResponseReasoningTextDeltaEvent.kt    |   604 +
 .../BetaResponseReasoningTextDoneEvent.kt     |   603 +
 .../BetaResponseRefusalDeltaEvent.kt          |   601 +
 .../responses/BetaResponseRefusalDoneEvent.kt |   609 +
 .../beta/responses/BetaResponseStatus.kt      |   170 +
 .../beta/responses/BetaResponseStreamEvent.kt |  2851 ++
 .../beta/responses/BetaResponseTextConfig.kt  |   409 +
 .../responses/BetaResponseTextDeltaEvent.kt   |  1126 +
 .../responses/BetaResponseTextDoneEvent.kt    |  1126 +
 .../responses/BetaResponseToolSearchCall.kt   |   887 +
 .../BetaResponseToolSearchOutputItem.kt       |  1035 +
 .../BetaResponseToolSearchOutputItemParam.kt  |   992 +
 .../beta/responses/BetaResponseUsage.kt       |   786 +
 ...BetaResponseWebSearchCallCompletedEvent.kt |   518 +
 ...etaResponseWebSearchCallInProgressEvent.kt |   520 +
 ...BetaResponseWebSearchCallSearchingEvent.kt |   518 +
 .../responses/BetaResponsesClientEvent.kt     |  8384 ++++++
 .../responses/BetaResponsesServerEvent.kt     |  2972 ++
 .../beta/responses/BetaSkillReference.kt      |   257 +
 .../openai/models/beta/responses/BetaTool.kt  |  7168 +++++
 .../beta/responses/BetaToolChoiceAllowed.kt   |   556 +
 .../responses/BetaToolChoiceApplyPatch.kt     |   169 +
 .../beta/responses/BetaToolChoiceCustom.kt    |   223 +
 .../beta/responses/BetaToolChoiceFunction.kt  |   223 +
 .../beta/responses/BetaToolChoiceMcp.kt       |   269 +
 .../beta/responses/BetaToolChoiceOptions.kt   |   157 +
 .../beta/responses/BetaToolChoiceShell.kt     |   169 +
 .../beta/responses/BetaToolChoiceTypes.kt     |   389 +
 .../beta/responses/BetaToolSearchTool.kt      |   412 +
 .../responses/BetaWebSearchPreviewTool.kt     |  1099 +
 .../beta/responses/BetaWebSearchTool.kt       |  1249 +
 .../beta/responses/ResponseCancelParams.kt    |   396 +
 .../beta/responses/ResponseCompactParams.kt   |  3060 ++
 .../beta/responses/ResponseCreateParams.kt    |  9777 ++++++
 .../beta/responses/ResponseDeleteParams.kt    |   392 +
 .../beta/responses/ResponseRetrieveParams.kt  |   461 +
 .../inputitems/BetaResponseItemList.kt        |   543 +
 .../responses/inputitems/InputItemListPage.kt |   287 +
 .../inputitems/InputItemListPageAsync.kt      |   302 +
 .../inputitems/InputItemListParams.kt         |   604 +
 .../inputtokens/InputTokenCountParams.kt      |  4973 ++++
 .../inputtokens/InputTokenCountResponse.kt    |   220 +
 .../beta/threads/runs/RunCreateParams.kt      |    71 +-
 .../completions/ChatCompletionContentPart.kt  |   234 +-
 .../ChatCompletionContentPartImage.kt         |   220 +-
 .../ChatCompletionContentPartInputAudio.kt    |   221 +-
 .../ChatCompletionContentPartText.kt          |   222 +-
 .../completions/ChatCompletionCreateParams.kt |  1637 +-
 .../models/completions/CompletionUsage.kt     |    55 +-
 .../ComputerScreenshotContent.kt              |   218 +-
 .../conversations/ConversationCreateParams.kt |    18 +
 .../conversations/items/ConversationItem.kt   |   850 +
 .../items/ConversationItemList.kt             |     8 +
 .../conversations/items/ItemCreateParams.kt   |    18 +
 .../CreateEvalCompletionsRunDataSource.kt     |    36 +-
 .../models/evals/runs/RunCancelResponse.kt    |    82 +-
 .../models/evals/runs/RunCreateParams.kt      |    82 +-
 .../models/evals/runs/RunCreateResponse.kt    |    82 +-
 .../models/evals/runs/RunListResponse.kt      |    82 +-
 .../models/evals/runs/RunRetrieveResponse.kt  |    82 +-
 .../graders/gradermodels/ScoreModelGrader.kt  |    36 +-
 .../realtime/RealtimeResponseCreateMcpTool.kt |   201 +-
 .../realtime/RealtimeSessionCreateRequest.kt  |    12 +
 .../realtime/RealtimeToolsConfigUnion.kt      |   205 +-
 .../RealtimeSessionCreateResponse.kt          |   221 +-
 .../openai/models/responses/ApplyPatchTool.kt |   220 +-
 .../models/responses/CompactedResponse.kt     |    10 +
 .../com/openai/models/responses/CustomTool.kt |   214 +-
 .../models/responses/FunctionShellTool.kt     |   214 +-
 .../openai/models/responses/FunctionTool.kt   |   381 +-
 .../openai/models/responses/NamespaceTool.kt  |   401 +-
 .../com/openai/models/responses/Response.kt   |   649 +-
 .../responses/ResponseApplyPatchToolCall.kt   |   485 +-
 .../ResponseApplyPatchToolCallOutput.kt       |   495 +-
 .../models/responses/ResponseCompactParams.kt |   651 +-
 .../models/responses/ResponseCreateParams.kt  |  1899 +-
 .../responses/ResponseCustomToolCall.kt       |   496 +-
 .../responses/ResponseCustomToolCallItem.kt   |    68 +-
 .../responses/ResponseCustomToolCallOutput.kt |   489 +-
 .../ResponseCustomToolCallOutputItem.kt       |    73 +-
 .../openai/models/responses/ResponseError.kt  |     6 +
 .../ResponseFunctionShellToolCall.kt          |   495 +-
 .../ResponseFunctionShellToolCallOutput.kt    |   484 +-
 .../responses/ResponseFunctionToolCall.kt     |   505 +-
 .../responses/ResponseFunctionToolCallItem.kt |    79 +-
 .../ResponseFunctionToolCallOutputItem.kt     |   487 +-
 .../models/responses/ResponseInputFile.kt     |   260 +-
 .../responses/ResponseInputFileContent.kt     |   267 +-
 .../models/responses/ResponseInputImage.kt    |   218 +-
 .../responses/ResponseInputImageContent.kt    |   225 +-
 .../models/responses/ResponseInputItem.kt     | 14455 +++++----
 .../models/responses/ResponseInputText.kt     |   222 +-
 .../responses/ResponseInputTextContent.kt     |   229 +-
 .../openai/models/responses/ResponseItem.kt   |   850 +
 .../models/responses/ResponseOutputItem.kt    |  1074 +-
 .../responses/ResponseOutputItemAddedEvent.kt |     7 +
 .../responses/ResponseOutputItemDoneEvent.kt  |     7 +
 .../ResponseReasoningSummaryPartDoneEvent.kt  |   181 +-
 .../responses/ResponseToolSearchOutputItem.kt |     3 +
 .../ResponseToolSearchOutputItemParam.kt      |     3 +
 .../openai/models/responses/ResponseUsage.kt  |    58 +-
 .../models/responses/ResponsesClientEvent.kt  |  1859 +-
 .../com/openai/models/responses/Tool.kt       |   463 +-
 .../responses/inputitems/InputItemListPage.kt |     8 +
 .../inputitems/InputItemListPageAsync.kt      |     8 +
 .../responses/inputitems/ResponseItemList.kt  |     7 +
 .../inputtokens/InputTokenCountParams.kt      |    95 +-
 .../SafetyIdentifierBlockedWebhookEvent.kt    |   809 +
 .../models/webhooks/UnwrapWebhookEvent.kt     |    50 +-
 .../openai/services/async/BetaServiceAsync.kt |     8 -
 .../services/async/BetaServiceAsyncImpl.kt    |    12 -
 .../async/beta/ResponseServiceAsync.kt        |   517 +
 .../async/beta/ResponseServiceAsyncImpl.kt    |   418 +
 .../beta/responses/InputItemServiceAsync.kt   |   117 +
 .../responses/InputItemServiceAsyncImpl.kt    |   104 +
 .../beta/responses/InputTokenServiceAsync.kt  |    89 +
 .../responses/InputTokenServiceAsyncImpl.kt   |    92 +
 .../openai/services/blocking/BetaService.kt   |     8 -
 .../services/blocking/BetaServiceImpl.kt      |    12 -
 .../services/blocking/beta/ResponseService.kt |   508 +
 .../blocking/beta/ResponseServiceImpl.kt      |   382 +
 .../beta/responses/InputItemService.kt        |   110 +
 .../beta/responses/InputItemServiceImpl.kt    |    99 +
 .../beta/responses/InputTokenService.kt       |    86 +
 .../beta/responses/InputTokenServiceImpl.kt   |    88 +
 .../kotlin/com/openai/models/AllModelsTest.kt |     4 +-
 .../kotlin/com/openai/models/ReasoningTest.kt |     3 +
 .../com/openai/models/ResponsesModelTest.kt   |     4 +-
 .../beta/responses/BetaApplyPatchToolTest.kt  |    40 +
 .../responses/BetaCompactedResponseTest.kt    |   211 +
 .../beta/responses/BetaComputerActionTest.kt  |   361 +
 .../beta/responses/BetaComputerToolTest.kt    |    30 +
 .../BetaComputerUsePreviewToolTest.kt         |    45 +
 .../beta/responses/BetaContainerAutoTest.kt   |    58 +
 ...BetaContainerNetworkPolicyAllowlistTest.kt |    62 +
 .../BetaContainerNetworkPolicyDisabledTest.kt |    33 +
 ...aContainerNetworkPolicyDomainSecretTest.kt |    45 +
 .../responses/BetaContainerReferenceTest.kt   |    34 +
 .../beta/responses/BetaCustomToolTest.kt      |    52 +
 .../responses/BetaEasyInputMessageTest.kt     |    48 +
 .../beta/responses/BetaFileSearchToolTest.kt  |   102 +
 .../responses/BetaFunctionShellToolTest.kt    |    73 +
 .../beta/responses/BetaFunctionToolTest.kt    |    85 +
 .../responses/BetaInlineSkillSourceTest.kt    |    32 +
 .../beta/responses/BetaInlineSkillTest.kt     |    45 +
 .../responses/BetaLocalEnvironmentTest.kt     |    58 +
 .../beta/responses/BetaLocalSkillTest.kt      |    36 +
 .../beta/responses/BetaNamespaceToolTest.kt   |    90 +
 ...etaResponseApplyPatchToolCallOutputTest.kt |    70 +
 .../BetaResponseApplyPatchToolCallTest.kt     |    84 +
 .../BetaResponseAudioDeltaEventTest.kt        |    45 +
 .../BetaResponseAudioDoneEventTest.kt         |    42 +
 ...taResponseAudioTranscriptDeltaEventTest.kt |    58 +
 ...etaResponseAudioTranscriptDoneEventTest.kt |    53 +
 ...seCodeInterpreterCallCodeDeltaEventTest.kt |    64 +
 ...nseCodeInterpreterCallCodeDoneEventTest.kt |    64 +
 ...seCodeInterpreterCallCompletedEventTest.kt |    61 +
 ...eCodeInterpreterCallInProgressEventTest.kt |    61 +
 ...odeInterpreterCallInterpretingEventTest.kt |    61 +
 ...BetaResponseCodeInterpreterToolCallTest.kt |    72 +
 .../BetaResponseCompactionItemParamTest.kt    |    53 +
 .../BetaResponseCompactionItemTest.kt         |    48 +
 .../BetaResponseCompletedEventTest.kt         |   683 +
 ...aResponseComputerToolCallOutputItemTest.kt |   107 +
 ...nseComputerToolCallOutputScreenshotTest.kt |    43 +
 .../BetaResponseComputerToolCallTest.kt       |   130 +
 .../BetaResponseContainerReferenceTest.kt     |    35 +
 .../BetaResponseContentPartAddedEventTest.kt  |   143 +
 .../BetaResponseContentPartDoneEventTest.kt   |   139 +
 .../beta/responses/BetaResponseContentTest.kt |   312 +
 .../BetaResponseConversationParamTest.kt      |    35 +
 .../responses/BetaResponseCreatedEventTest.kt |   683 +
 ...sponseCustomToolCallInputDeltaEventTest.kt |    64 +
 ...esponseCustomToolCallInputDoneEventTest.kt |    64 +
 .../BetaResponseCustomToolCallItemTest.kt     |    66 +
 ...etaResponseCustomToolCallOutputItemTest.kt |    67 +
 .../BetaResponseCustomToolCallOutputTest.kt   |    60 +
 .../BetaResponseCustomToolCallTest.kt         |    58 +
 .../responses/BetaResponseErrorEventTest.kt   |    51 +
 .../beta/responses/BetaResponseErrorTest.kt   |    41 +
 .../responses/BetaResponseFailedEventTest.kt  |   683 +
 ...esponseFileSearchCallCompletedEventTest.kt |    61 +
 ...sponseFileSearchCallInProgressEventTest.kt |    61 +
 ...esponseFileSearchCallSearchingEventTest.kt |    61 +
 .../BetaResponseFileSearchToolCallTest.kt     |    98 +
 .../BetaResponseFormatTextConfigTest.kt       |   130 +
 ...aResponseFormatTextJsonSchemaConfigTest.kt |    62 +
 ...onseFunctionCallArgumentsDeltaEventTest.kt |    64 +
 ...ponseFunctionCallArgumentsDoneEventTest.kt |    67 +
 .../BetaResponseFunctionCallOutputItemTest.kt |   173 +
 ...ponseFunctionShellCallOutputContentTest.kt |    46 +
 ...ResponseFunctionShellToolCallOutputTest.kt |    97 +
 .../BetaResponseFunctionShellToolCallTest.kt  |    97 +
 .../BetaResponseFunctionToolCallItemTest.kt   |    66 +
 ...aResponseFunctionToolCallOutputItemTest.kt |    73 +
 .../BetaResponseFunctionToolCallTest.kt       |    62 +
 .../BetaResponseFunctionWebSearchTest.kt      |    87 +
 ...aResponseImageGenCallCompletedEventTest.kt |    61 +
 ...ResponseImageGenCallGeneratingEventTest.kt |    61 +
 ...ResponseImageGenCallInProgressEventTest.kt |    61 +
 ...sponseImageGenCallPartialImageEventTest.kt |    68 +
 .../BetaResponseInProgressEventTest.kt        |   683 +
 .../BetaResponseIncompleteEventTest.kt        |   683 +
 .../BetaResponseInjectCreatedEventTest.kt     |    45 +
 .../responses/BetaResponseInjectEventTest.kt  |    65 +
 .../BetaResponseInjectFailedEventTest.kt      |    91 +
 .../responses/BetaResponseInputAudioTest.kt   |    54 +
 .../responses/BetaResponseInputContentTest.kt |   163 +
 .../BetaResponseInputFileContentTest.kt       |    59 +
 .../responses/BetaResponseInputFileTest.kt    |    58 +
 .../BetaResponseInputImageContentTest.kt      |    54 +
 .../responses/BetaResponseInputImageTest.kt   |    52 +
 .../responses/BetaResponseInputItemTest.kt    |  3220 ++
 .../BetaResponseInputMessageItemTest.kt       |    77 +
 .../BetaResponseInputTextContentTest.kt       |    46 +
 .../responses/BetaResponseInputTextTest.kt    |    46 +
 .../beta/responses/BetaResponseItemTest.kt    |  2891 ++
 .../BetaResponseLocalEnvironmentTest.kt       |    30 +
 ...aResponseMcpCallArgumentsDeltaEventTest.kt |    64 +
 ...taResponseMcpCallArgumentsDoneEventTest.kt |    64 +
 .../BetaResponseMcpCallCompletedEventTest.kt  |    59 +
 .../BetaResponseMcpCallFailedEventTest.kt     |    55 +
 .../BetaResponseMcpCallInProgressEventTest.kt |    59 +
 ...aResponseMcpListToolsCompletedEventTest.kt |    61 +
 ...BetaResponseMcpListToolsFailedEventTest.kt |    59 +
 ...ResponseMcpListToolsInProgressEventTest.kt |    61 +
 .../responses/BetaResponseOutputAudioTest.kt  |    35 +
 .../BetaResponseOutputItemAddedEventTest.kt   |   169 +
 .../BetaResponseOutputItemDoneEventTest.kt    |   169 +
 .../responses/BetaResponseOutputItemTest.kt   |  2796 ++
 .../BetaResponseOutputMessageTest.kt          |   131 +
 .../BetaResponseOutputRefusalTest.kt          |    34 +
 ...ponseOutputTextAnnotationAddedEventTest.kt |    72 +
 .../responses/BetaResponseOutputTextTest.kt   |   106 +
 .../beta/responses/BetaResponsePromptTest.kt  |    58 +
 .../responses/BetaResponseQueuedEventTest.kt  |   683 +
 .../BetaResponseReasoningItemTest.kt          |    58 +
 ...ponseReasoningSummaryPartAddedEventTest.kt |    74 +
 ...sponseReasoningSummaryPartDoneEventTest.kt |    74 +
 ...ponseReasoningSummaryTextDeltaEventTest.kt |    67 +
 ...sponseReasoningSummaryTextDoneEventTest.kt |    67 +
 ...BetaResponseReasoningTextDeltaEventTest.kt |    65 +
 .../BetaResponseReasoningTextDoneEventTest.kt |    65 +
 .../BetaResponseRefusalDeltaEventTest.kt      |    59 +
 .../BetaResponseRefusalDoneEventTest.kt       |    54 +
 .../responses/BetaResponseStreamEventTest.kt  |  8177 +++++
 .../models/beta/responses/BetaResponseTest.kt |   660 +
 .../responses/BetaResponseTextConfigTest.kt   |    42 +
 .../BetaResponseTextDeltaEventTest.kt         |    91 +
 .../BetaResponseTextDoneEventTest.kt          |    91 +
 .../BetaResponseToolSearchCallTest.kt         |    61 +
 ...taResponseToolSearchOutputItemParamTest.kt |   127 +
 .../BetaResponseToolSearchOutputItemTest.kt   |   124 +
 .../beta/responses/BetaResponseUsageTest.kt   |    71 +
 ...ResponseWebSearchCallCompletedEventTest.kt |    61 +
 ...esponseWebSearchCallInProgressEventTest.kt |    61 +
 ...ResponseWebSearchCallSearchingEventTest.kt |    61 +
 .../responses/BetaResponsesClientEventTest.kt |   386 +
 .../responses/BetaResponsesServerEventTest.kt |  8501 ++++++
 .../beta/responses/BetaSkillReferenceTest.kt  |    35 +
 .../responses/BetaToolChoiceAllowedTest.kt    |    55 +
 .../responses/BetaToolChoiceApplyPatchTest.kt |    30 +
 .../responses/BetaToolChoiceCustomTest.kt     |    32 +
 .../responses/BetaToolChoiceFunctionTest.kt   |    32 +
 .../beta/responses/BetaToolChoiceMcpTest.kt   |    35 +
 .../beta/responses/BetaToolChoiceShellTest.kt |    30 +
 .../beta/responses/BetaToolChoiceTypesTest.kt |    34 +
 .../beta/responses/BetaToolSearchToolTest.kt  |    45 +
 .../models/beta/responses/BetaToolTest.kt     |   980 +
 .../responses/BetaWebSearchPreviewToolTest.kt |    73 +
 .../beta/responses/BetaWebSearchToolTest.kt   |    74 +
 .../responses/ResponseCancelParamsTest.kt     |    56 +
 .../responses/ResponseCompactParamsTest.kt    |   115 +
 .../responses/ResponseCreateParamsTest.kt     |   526 +
 .../responses/ResponseDeleteParamsTest.kt     |    56 +
 .../responses/ResponseRetrieveParamsTest.kt   |    98 +
 .../inputitems/BetaResponseItemListTest.kt    |   110 +
 .../inputitems/InputItemListParamsTest.kt     |    94 +
 .../inputtokens/InputTokenCountParamsTest.kt  |   242 +
 .../InputTokenCountResponseTest.kt            |    32 +
 .../threads/ThreadCreateAndRunParamsTest.kt   |     6 +-
 .../beta/threads/runs/RunCreateParamsTest.kt  |     8 +-
 .../completions/ChatCompletionChunkTest.kt    |     3 +
 .../ChatCompletionContentPartImageTest.kt     |     8 +
 ...ChatCompletionContentPartInputAudioTest.kt |     8 +
 .../ChatCompletionContentPartTest.kt          |    33 +-
 .../ChatCompletionContentPartTextTest.kt      |    16 +-
 .../ChatCompletionCreateParamsTest.kt         |    97 +-
 .../ChatCompletionListPageResponseTest.kt     |     3 +
 .../ChatCompletionStoreMessageTest.kt         |    25 +-
 .../chat/completions/ChatCompletionTest.kt    |     3 +
 .../messages/MessageListPageResponseTest.kt   |    26 +-
 .../models/completions/CompletionTest.kt      |     3 +
 .../models/completions/CompletionUsageTest.kt |     3 +
 .../ComputerScreenshotContentTest.kt          |     8 +
 .../models/conversations/MessageTest.kt       |    27 +-
 .../items/ConversationItemListTest.kt         |    28 +-
 .../items/ConversationItemTest.kt             |   239 +-
 .../gradermodels/EvalContentItemTest.kt       |    15 +-
 .../RealtimeResponseCreateMcpToolTest.kt      |     5 +
 .../realtime/RealtimeToolsConfigUnionTest.kt  |     2 +
 .../models/responses/ApplyPatchToolTest.kt    |    10 +-
 .../models/responses/CompactedResponseTest.kt |    15 +-
 .../openai/models/responses/CustomToolTest.kt |     5 +
 .../models/responses/FunctionShellToolTest.kt |     5 +
 .../models/responses/FunctionToolTest.kt      |    21 +
 .../models/responses/NamespaceToolTest.kt     |    18 +
 .../ResponseApplyPatchToolCallOutputTest.kt   |     4 +
 .../ResponseApplyPatchToolCallTest.kt         |     4 +
 .../responses/ResponseCompactParamsTest.kt    |    29 +-
 .../responses/ResponseCompletedEventTest.kt   |    46 +-
 .../models/responses/ResponseContentTest.kt   |    27 +-
 .../responses/ResponseCreateParamsTest.kt     |   104 +-
 .../responses/ResponseCreatedEventTest.kt     |    46 +-
 .../ResponseCustomToolCallItemTest.kt         |     4 +
 .../ResponseCustomToolCallOutputItemTest.kt   |     4 +
 .../ResponseCustomToolCallOutputTest.kt       |     4 +
 .../responses/ResponseCustomToolCallTest.kt   |     4 +
 .../responses/ResponseFailedEventTest.kt      |    46 +-
 .../ResponseFunctionCallOutputItemTest.kt     |    31 +-
 ...ResponseFunctionShellToolCallOutputTest.kt |     4 +
 .../ResponseFunctionShellToolCallTest.kt      |     4 +
 .../ResponseFunctionToolCallItemTest.kt       |     4 +
 .../ResponseFunctionToolCallOutputItemTest.kt |     4 +
 .../responses/ResponseFunctionToolCallTest.kt |     4 +
 .../responses/ResponseInProgressEventTest.kt  |    46 +-
 .../responses/ResponseIncompleteEventTest.kt  |    46 +-
 .../responses/ResponseInputContentTest.kt     |    27 +-
 .../responses/ResponseInputFileContentTest.kt |    14 +-
 .../models/responses/ResponseInputFileTest.kt |    10 +-
 .../ResponseInputImageContentTest.kt          |     8 +
 .../responses/ResponseInputImageTest.kt       |     4 +
 .../models/responses/ResponseInputItemTest.kt |   254 +-
 .../responses/ResponseInputMessageItemTest.kt |    27 +-
 .../responses/ResponseInputTextContentTest.kt |    18 +-
 .../models/responses/ResponseInputTextTest.kt |    14 +-
 .../models/responses/ResponseItemTest.kt      |   242 +-
 .../responses/ResponseOutputItemTest.kt       |   220 +
 .../responses/ResponseQueuedEventTest.kt      |    46 +-
 ...sponseReasoningSummaryPartDoneEventTest.kt |     4 +
 .../responses/ResponseStreamEventTest.kt      |   170 +
 .../openai/models/responses/ResponseTest.kt   |    55 +-
 .../ResponseToolSearchOutputItemParamTest.kt  |    18 +
 .../ResponseToolSearchOutputItemTest.kt       |    18 +
 .../models/responses/ResponseUsageTest.kt     |    17 +-
 .../responses/ResponsesClientEventTest.kt     |   108 +-
 .../responses/ResponsesServerEventTest.kt     |   170 +
 .../com/openai/models/responses/ToolTest.kt   |   102 +-
 .../inputitems/ResponseItemListTest.kt        |    28 +-
 .../inputtokens/InputTokenCountParamsTest.kt  |    21 +
 ...SafetyIdentifierBlockedWebhookEventTest.kt |    74 +
 .../models/webhooks/UnwrapWebhookEventTest.kt |    84 +
 .../com/openai/services/ServiceParamsTest.kt  |    32 +-
 .../async/ResponseServiceAsyncTest.kt         |    86 +-
 .../async/beta/ResponseServiceAsyncTest.kt    |   436 +
 .../async/beta/ThreadServiceAsyncTest.kt      |     4 +-
 .../responses/InputItemServiceAsyncTest.kt    |    28 +
 .../responses/InputTokenServiceAsyncTest.kt   |    80 +
 .../async/beta/threads/RunServiceAsyncTest.kt |     4 +-
 .../chat/ChatCompletionServiceAsyncTest.kt    |    66 +-
 .../responses/InputTokenServiceAsyncTest.kt   |     7 +
 .../services/blocking/ResponseServiceTest.kt  |    86 +-
 .../blocking/beta/ResponseServiceTest.kt      |   425 +
 .../blocking/beta/ThreadServiceTest.kt        |     4 +-
 .../beta/responses/InputItemServiceTest.kt    |    27 +
 .../beta/responses/InputTokenServiceTest.kt   |    79 +
 .../blocking/beta/threads/RunServiceTest.kt   |     4 +-
 .../chat/ChatCompletionServiceTest.kt         |    66 +-
 .../responses/InputTokenServiceTest.kt        |     7 +
 .../proguard/ProGuardCompatibilityTest.kt     |     8 +-
 491 files changed, 278164 insertions(+), 6852 deletions(-)
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaApplyPatchTool.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaCompactedResponse.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaComputerAction.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaComputerTool.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaComputerUsePreviewTool.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerAuto.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyAllowlist.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyDisabled.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyDomainSecret.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerReference.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaCustomTool.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaEasyInputMessage.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaFileSearchTool.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaFunctionShellTool.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaFunctionTool.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaInlineSkill.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaInlineSkillSource.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaLocalEnvironment.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaLocalSkill.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaNamespaceTool.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponse.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseApplyPatchToolCall.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseApplyPatchToolCallOutput.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseAudioDeltaEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseAudioDoneEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseAudioTranscriptDeltaEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseAudioTranscriptDoneEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCodeDeltaEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCodeDoneEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCompletedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallInProgressEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallInterpretingEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterToolCall.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCompactionItem.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCompactionItemParam.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCompletedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCall.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallOutputItem.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallOutputScreenshot.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseContainerReference.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseContent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseContentPartAddedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseContentPartDoneEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseConversationParam.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCreatedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCall.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallInputDeltaEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallInputDoneEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallItem.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallOutput.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallOutputItem.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseError.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseErrorEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFailedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallCompletedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallInProgressEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallSearchingEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchToolCall.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFormatTextConfig.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFormatTextJsonSchemaConfig.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallArgumentsDeltaEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallArgumentsDoneEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallOutputItem.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellCallOutputContent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellToolCall.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellToolCallOutput.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCall.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallItem.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallOutputItem.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionWebSearch.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallCompletedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallGeneratingEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallInProgressEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallPartialImageEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInProgressEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseIncludable.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseIncompleteEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInjectCreatedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInjectEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInjectFailedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputAudio.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputContent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputFile.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputFileContent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputImage.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputImageContent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputItem.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputMessageItem.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputText.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputTextContent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseItem.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseLocalEnvironment.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallArgumentsDeltaEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallArgumentsDoneEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallCompletedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallFailedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallInProgressEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsCompletedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsFailedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsInProgressEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputAudio.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputItem.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemAddedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemDoneEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputMessage.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputRefusal.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputText.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputTextAnnotationAddedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponsePrompt.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseQueuedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningItem.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryPartAddedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryPartDoneEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryTextDeltaEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryTextDoneEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningTextDeltaEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningTextDoneEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseRefusalDeltaEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseRefusalDoneEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseStatus.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseStreamEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseTextConfig.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseTextDeltaEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseTextDoneEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchCall.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItem.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItemParam.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseUsage.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallCompletedEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallInProgressEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallSearchingEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponsesClientEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponsesServerEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaSkillReference.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaTool.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceAllowed.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceApplyPatch.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceCustom.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceFunction.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceMcp.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceOptions.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceShell.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceTypes.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolSearchTool.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaWebSearchPreviewTool.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaWebSearchTool.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseCancelParams.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseCompactParams.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseCreateParams.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseDeleteParams.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseRetrieveParams.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputitems/BetaResponseItemList.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputitems/InputItemListPage.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputitems/InputItemListPageAsync.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputitems/InputItemListParams.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputtokens/InputTokenCountParams.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputtokens/InputTokenCountResponse.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/models/webhooks/SafetyIdentifierBlockedWebhookEvent.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/services/async/beta/ResponseServiceAsync.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/services/async/beta/ResponseServiceAsyncImpl.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/services/async/beta/responses/InputItemServiceAsync.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/services/async/beta/responses/InputItemServiceAsyncImpl.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/services/async/beta/responses/InputTokenServiceAsync.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/services/async/beta/responses/InputTokenServiceAsyncImpl.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/ResponseService.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/ResponseServiceImpl.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/responses/InputItemService.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/responses/InputItemServiceImpl.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/responses/InputTokenService.kt
 create mode 100644 openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/responses/InputTokenServiceImpl.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaApplyPatchToolTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaCompactedResponseTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaComputerActionTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaComputerToolTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaComputerUsePreviewToolTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerAutoTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyAllowlistTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyDisabledTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyDomainSecretTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerReferenceTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaCustomToolTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaEasyInputMessageTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaFileSearchToolTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaFunctionShellToolTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaFunctionToolTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaInlineSkillSourceTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaInlineSkillTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaLocalEnvironmentTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaLocalSkillTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaNamespaceToolTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseApplyPatchToolCallOutputTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseApplyPatchToolCallTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseAudioDeltaEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseAudioDoneEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseAudioTranscriptDeltaEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseAudioTranscriptDoneEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCodeDeltaEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCodeDoneEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCompletedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallInProgressEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallInterpretingEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterToolCallTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCompactionItemParamTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCompactionItemTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCompletedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallOutputItemTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallOutputScreenshotTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseContainerReferenceTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseContentPartAddedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseContentPartDoneEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseContentTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseConversationParamTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCreatedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallInputDeltaEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallInputDoneEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallItemTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallOutputItemTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallOutputTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseErrorEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseErrorTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFailedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallCompletedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallInProgressEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallSearchingEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchToolCallTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFormatTextConfigTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFormatTextJsonSchemaConfigTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallArgumentsDeltaEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallArgumentsDoneEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallOutputItemTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellCallOutputContentTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellToolCallOutputTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellToolCallTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallItemTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallOutputItemTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionWebSearchTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallCompletedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallGeneratingEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallInProgressEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallPartialImageEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInProgressEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseIncompleteEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInjectCreatedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInjectEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInjectFailedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputAudioTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputContentTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputFileContentTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputFileTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputImageContentTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputImageTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputItemTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputMessageItemTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputTextContentTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputTextTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseItemTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseLocalEnvironmentTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallArgumentsDeltaEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallArgumentsDoneEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallCompletedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallFailedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallInProgressEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsCompletedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsFailedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsInProgressEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputAudioTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemAddedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemDoneEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputMessageTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputRefusalTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputTextAnnotationAddedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputTextTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponsePromptTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseQueuedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningItemTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryPartAddedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryPartDoneEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryTextDeltaEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryTextDoneEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningTextDeltaEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningTextDoneEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseRefusalDeltaEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseRefusalDoneEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseStreamEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseTextConfigTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseTextDeltaEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseTextDoneEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchCallTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItemParamTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItemTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseUsageTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallCompletedEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallInProgressEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallSearchingEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponsesClientEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponsesServerEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaSkillReferenceTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceAllowedTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceApplyPatchTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceCustomTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceFunctionTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceMcpTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceShellTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceTypesTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolSearchToolTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaWebSearchPreviewToolTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaWebSearchToolTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseCancelParamsTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseCompactParamsTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseCreateParamsTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseDeleteParamsTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseRetrieveParamsTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/inputitems/BetaResponseItemListTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/inputitems/InputItemListParamsTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/inputtokens/InputTokenCountParamsTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/beta/responses/inputtokens/InputTokenCountResponseTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/models/webhooks/SafetyIdentifierBlockedWebhookEventTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/services/async/beta/ResponseServiceAsyncTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/services/async/beta/responses/InputItemServiceAsyncTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/services/async/beta/responses/InputTokenServiceAsyncTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/ResponseServiceTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/responses/InputItemServiceTest.kt
 create mode 100644 openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/responses/InputTokenServiceTest.kt

diff --git a/.stats.yml b/.stats.yml
index fe88e03e3..4e142c3c3 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
-configured_endpoints: 263
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai/openai-b5b621065906a2579dc180db1236ee3b08a4fca9539accc2fbbf88da0ca3923f.yml
-openapi_spec_hash: 45b1b4692b26e714008d8120ccfc7433
-config_hash: ef3ce17315a31703e7af0567b3e9738c
+configured_endpoints: 270
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai/openai-356010b9b9fd6228b457b8fcfa376cf4928a8f3bd4728e7ba5e4b6b5ef4f5843.yml
+openapi_spec_hash: 885864ae98a443166f585f856c464fb2
+config_hash: 1f1e3b4050e2cb4bc780ce0b70e2b3e6
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/ChatModel.kt b/openai-java-core/src/main/kotlin/com/openai/models/ChatModel.kt
index 16bf07847..35755e10b 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/ChatModel.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/ChatModel.kt
@@ -20,6 +20,12 @@ class ChatModel @JsonCreator private constructor(private val value: JsonField<St
 
     companion object {
 
+        @JvmField val GPT_5_6_SOL = of("gpt-5.6-sol")
+
+        @JvmField val GPT_5_6_TERRA = of("gpt-5.6-terra")
+
+        @JvmField val GPT_5_6_LUNA = of("gpt-5.6-luna")
+
         @JvmField val GPT_5_4 = of("gpt-5.4")
 
         @JvmField val GPT_5_4_MINI = of("gpt-5.4-mini")
@@ -183,6 +189,9 @@ class ChatModel @JsonCreator private constructor(private val value: JsonField<St
 
     /** An enum containing [ChatModel]'s known values. */
     enum class Known {
+        GPT_5_6_SOL,
+        GPT_5_6_TERRA,
+        GPT_5_6_LUNA,
         GPT_5_4,
         GPT_5_4_MINI,
         GPT_5_4_NANO,
@@ -273,6 +282,9 @@ class ChatModel @JsonCreator private constructor(private val value: JsonField<St
      * - It was constructed with an arbitrary value using the [of] method.
      */
     enum class Value {
+        GPT_5_6_SOL,
+        GPT_5_6_TERRA,
+        GPT_5_6_LUNA,
         GPT_5_4,
         GPT_5_4_MINI,
         GPT_5_4_NANO,
@@ -364,6 +376,9 @@ class ChatModel @JsonCreator private constructor(private val value: JsonField<St
      */
     fun value(): Value =
         when (this) {
+            GPT_5_6_SOL -> Value.GPT_5_6_SOL
+            GPT_5_6_TERRA -> Value.GPT_5_6_TERRA
+            GPT_5_6_LUNA -> Value.GPT_5_6_LUNA
             GPT_5_4 -> Value.GPT_5_4
             GPT_5_4_MINI -> Value.GPT_5_4_MINI
             GPT_5_4_NANO -> Value.GPT_5_4_NANO
@@ -455,6 +470,9 @@ class ChatModel @JsonCreator private constructor(private val value: JsonField<St
      */
     fun known(): Known =
         when (this) {
+            GPT_5_6_SOL -> Known.GPT_5_6_SOL
+            GPT_5_6_TERRA -> Known.GPT_5_6_TERRA
+            GPT_5_6_LUNA -> Known.GPT_5_6_LUNA
             GPT_5_4 -> Known.GPT_5_4
             GPT_5_4_MINI -> Known.GPT_5_4_MINI
             GPT_5_4_NANO -> Known.GPT_5_4_NANO
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/Reasoning.kt b/openai-java-core/src/main/kotlin/com/openai/models/Reasoning.kt
index 285ebff40..df225da7f 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/Reasoning.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/Reasoning.kt
@@ -28,6 +28,7 @@ private constructor(
     private val context: JsonField<Context>,
     private val effort: JsonField<ReasoningEffort>,
     private val generateSummary: JsonField<GenerateSummary>,
+    private val mode: JsonField<Mode>,
     private val summary: JsonField<Summary>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
@@ -41,8 +42,9 @@ private constructor(
         @JsonProperty("generate_summary")
         @ExcludeMissing
         generateSummary: JsonField<GenerateSummary> = JsonMissing.of(),
+        @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of(),
         @JsonProperty("summary") @ExcludeMissing summary: JsonField<Summary> = JsonMissing.of(),
-    ) : this(context, effort, generateSummary, summary, mutableMapOf())
+    ) : this(context, effort, generateSummary, mode, summary, mutableMapOf())
 
     /**
      * Controls which reasoning items are rendered back to the model on later turns. When returned
@@ -54,17 +56,12 @@ private constructor(
     fun context(): Optional<Context> = context.getOptional("context")
 
     /**
-     * Constrains effort on reasoning for
-     * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported
-     * values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing reasoning effort
-     * can result in faster responses and fewer tokens used on reasoning in a response.
-     * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
-     *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for
-     *   all reasoning values in gpt-5.1.
-     * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support
-     *   `none`.
-     * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+     * Constrains effort on reasoning for reasoning models. Currently supported values are `none`,
+     * `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort can result
+     * in faster responses and fewer tokens used on reasoning in a response. Not all reasoning
+     * models support every value. See the
+     * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+     * support.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -84,6 +81,16 @@ private constructor(
     fun generateSummary(): Optional<GenerateSummary> =
         generateSummary.getOptional("generate_summary")
 
+    /**
+     * Controls the reasoning execution mode for the request.
+     *
+     * When returned on a response, this is the effective execution mode.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun mode(): Optional<Mode> = mode.getOptional("mode")
+
     /**
      * A summary of the reasoning performed by the model. This can be useful for debugging and
      * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
@@ -120,6 +127,13 @@ private constructor(
     @ExcludeMissing
     fun _generateSummary(): JsonField<GenerateSummary> = generateSummary
 
+    /**
+     * Returns the raw JSON value of [mode].
+     *
+     * Unlike [mode], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
     /**
      * Returns the raw JSON value of [summary].
      *
@@ -151,6 +165,7 @@ private constructor(
         private var context: JsonField<Context> = JsonMissing.of()
         private var effort: JsonField<ReasoningEffort> = JsonMissing.of()
         private var generateSummary: JsonField<GenerateSummary> = JsonMissing.of()
+        private var mode: JsonField<Mode> = JsonMissing.of()
         private var summary: JsonField<Summary> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
@@ -159,6 +174,7 @@ private constructor(
             context = reasoning.context
             effort = reasoning.effort
             generateSummary = reasoning.generateSummary
+            mode = reasoning.mode
             summary = reasoning.summary
             additionalProperties = reasoning.additionalProperties.toMutableMap()
         }
@@ -182,18 +198,12 @@ private constructor(
         fun context(context: JsonField<Context>) = apply { this.context = context }
 
         /**
-         * Constrains effort on reasoning for
-         * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-         * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing
-         * reasoning effort can result in faster responses and fewer tokens used on reasoning in a
-         * response.
-         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
-         *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported
-         *   for all reasoning values in gpt-5.1.
-         * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support
-         *   `none`.
-         * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-         * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
          */
         fun effort(effort: ReasoningEffort?) = effort(JsonField.ofNullable(effort))
 
@@ -236,6 +246,29 @@ private constructor(
             this.generateSummary = generateSummary
         }
 
+        /**
+         * Controls the reasoning execution mode for the request.
+         *
+         * When returned on a response, this is the effective execution mode.
+         */
+        fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+        /**
+         * Sets [Builder.mode] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.mode] with a well-typed [Mode] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+        /**
+         * Sets [mode] to an arbitrary [String].
+         *
+         * You should usually call [mode] with a well-typed [Mode] constant instead. This method is
+         * primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun mode(value: String) = mode(Mode.of(value))
+
         /**
          * A summary of the reasoning performed by the model. This can be useful for debugging and
          * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
@@ -285,6 +318,7 @@ private constructor(
                 context,
                 effort,
                 generateSummary,
+                mode,
                 summary,
                 additionalProperties.toMutableMap(),
             )
@@ -308,6 +342,7 @@ private constructor(
         context().ifPresent { it.validate() }
         effort().ifPresent { it.validate() }
         generateSummary().ifPresent { it.validate() }
+        mode()
         summary().ifPresent { it.validate() }
         validated = true
     }
@@ -330,6 +365,7 @@ private constructor(
         (context.asKnown().getOrNull()?.validity() ?: 0) +
             (effort.asKnown().getOrNull()?.validity() ?: 0) +
             (generateSummary.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (mode.asKnown().isPresent) 1 else 0) +
             (summary.asKnown().getOrNull()?.validity() ?: 0)
 
     /**
@@ -627,6 +663,145 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /**
+     * Controls the reasoning execution mode for the request.
+     *
+     * When returned on a response, this is the effective execution mode.
+     */
+    class Mode @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val STANDARD = of("standard")
+
+            @JvmField val PRO = of("pro")
+
+            @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+        }
+
+        /** An enum containing [Mode]'s known values. */
+        enum class Known {
+            STANDARD,
+            PRO,
+        }
+
+        /**
+         * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Mode] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            STANDARD,
+            PRO,
+            /** An enum member indicating that [Mode] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                STANDARD -> Value.STANDARD
+                PRO -> Value.PRO
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                STANDARD -> Known.STANDARD
+                PRO -> Known.PRO
+                else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Mode = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Mode && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
     /**
      * A summary of the reasoning performed by the model. This can be useful for debugging and
      * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
@@ -783,16 +958,17 @@ private constructor(
             context == other.context &&
             effort == other.effort &&
             generateSummary == other.generateSummary &&
+            mode == other.mode &&
             summary == other.summary &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(context, effort, generateSummary, summary, additionalProperties)
+        Objects.hash(context, effort, generateSummary, mode, summary, additionalProperties)
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "Reasoning{context=$context, effort=$effort, generateSummary=$generateSummary, summary=$summary, additionalProperties=$additionalProperties}"
+        "Reasoning{context=$context, effort=$effort, generateSummary=$generateSummary, mode=$mode, summary=$summary, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/ReasoningEffort.kt b/openai-java-core/src/main/kotlin/com/openai/models/ReasoningEffort.kt
index 0bead0c0a..24e86d596 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/ReasoningEffort.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/ReasoningEffort.kt
@@ -8,16 +8,11 @@ import com.openai.core.JsonField
 import com.openai.errors.OpenAIInvalidDataException
 
 /**
- * Constrains effort on reasoning for
- * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported values
- * are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing reasoning effort can result
- * in faster responses and fewer tokens used on reasoning in a response.
- * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning values
- *   for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for all
- *   reasoning values in gpt-5.1.
- * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support `none`.
- * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
- * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+ * Constrains effort on reasoning for reasoning models. Currently supported values are `none`,
+ * `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort can result in
+ * faster responses and fewer tokens used on reasoning in a response. Not all reasoning models
+ * support every value. See the [reasoning guide](https://platform.openai.com/docs/guides/reasoning)
+ * for model-specific support.
  */
 class ReasoningEffort @JsonCreator private constructor(private val value: JsonField<String>) :
     Enum {
@@ -45,6 +40,8 @@ class ReasoningEffort @JsonCreator private constructor(private val value: JsonFi
 
         @JvmField val XHIGH = of("xhigh")
 
+        @JvmField val MAX = of("max")
+
         @JvmStatic fun of(value: String) = ReasoningEffort(JsonField.of(value))
     }
 
@@ -56,6 +53,7 @@ class ReasoningEffort @JsonCreator private constructor(private val value: JsonFi
         MEDIUM,
         HIGH,
         XHIGH,
+        MAX,
     }
 
     /**
@@ -74,6 +72,7 @@ class ReasoningEffort @JsonCreator private constructor(private val value: JsonFi
         MEDIUM,
         HIGH,
         XHIGH,
+        MAX,
         /**
          * An enum member indicating that [ReasoningEffort] was instantiated with an unknown value.
          */
@@ -95,6 +94,7 @@ class ReasoningEffort @JsonCreator private constructor(private val value: JsonFi
             MEDIUM -> Value.MEDIUM
             HIGH -> Value.HIGH
             XHIGH -> Value.XHIGH
+            MAX -> Value.MAX
             else -> Value._UNKNOWN
         }
 
@@ -114,6 +114,7 @@ class ReasoningEffort @JsonCreator private constructor(private val value: JsonFi
             MEDIUM -> Known.MEDIUM
             HIGH -> Known.HIGH
             XHIGH -> Known.XHIGH
+            MAX -> Known.MAX
             else -> throw OpenAIInvalidDataException("Unknown ReasoningEffort: $value")
         }
 
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/assistants/AssistantCreateParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/assistants/AssistantCreateParams.kt
index 0613798c1..4dc7723f5 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/beta/assistants/AssistantCreateParams.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/assistants/AssistantCreateParams.kt
@@ -97,17 +97,12 @@ private constructor(
     fun name(): Optional<String> = body.name()
 
     /**
-     * Constrains effort on reasoning for
-     * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported
-     * values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing reasoning effort
-     * can result in faster responses and fewer tokens used on reasoning in a response.
-     * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
-     *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for
-     *   all reasoning values in gpt-5.1.
-     * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support
-     *   `none`.
-     * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+     * Constrains effort on reasoning for reasoning models. Currently supported values are `none`,
+     * `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort can result
+     * in faster responses and fewer tokens used on reasoning in a response. Not all reasoning
+     * models support every value. See the
+     * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+     * support.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -403,18 +398,12 @@ private constructor(
         fun name(name: JsonField<String>) = apply { body.name(name) }
 
         /**
-         * Constrains effort on reasoning for
-         * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-         * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing
-         * reasoning effort can result in faster responses and fewer tokens used on reasoning in a
-         * response.
-         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
-         *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported
-         *   for all reasoning values in gpt-5.1.
-         * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support
-         *   `none`.
-         * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-         * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
          */
         fun reasoningEffort(reasoningEffort: ReasoningEffort?) = apply {
             body.reasoningEffort(reasoningEffort)
@@ -873,18 +862,12 @@ private constructor(
         fun name(): Optional<String> = name.getOptional("name")
 
         /**
-         * Constrains effort on reasoning for
-         * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-         * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing
-         * reasoning effort can result in faster responses and fewer tokens used on reasoning in a
-         * response.
-         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
-         *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported
-         *   for all reasoning values in gpt-5.1.
-         * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support
-         *   `none`.
-         * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-         * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -1212,18 +1195,12 @@ private constructor(
             fun name(name: JsonField<String>) = apply { this.name = name }
 
             /**
-             * Constrains effort on reasoning for
-             * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-             * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-             * Reducing reasoning effort can result in faster responses and fewer tokens used on
-             * reasoning in a response.
-             * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-             *   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls
-             *   are supported for all reasoning values in gpt-5.1.
-             * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-             *   support `none`.
-             * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-             * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+             * Constrains effort on reasoning for reasoning models. Currently supported values are
+             * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning
+             * effort can result in faster responses and fewer tokens used on reasoning in a
+             * response. Not all reasoning models support every value. See the
+             * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+             * model-specific support.
              */
             fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                 reasoningEffort(JsonField.ofNullable(reasoningEffort))
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/assistants/AssistantUpdateParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/assistants/AssistantUpdateParams.kt
index 93e6ecff9..4115e8f65 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/beta/assistants/AssistantUpdateParams.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/assistants/AssistantUpdateParams.kt
@@ -89,17 +89,12 @@ private constructor(
     fun name(): Optional<String> = body.name()
 
     /**
-     * Constrains effort on reasoning for
-     * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported
-     * values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing reasoning effort
-     * can result in faster responses and fewer tokens used on reasoning in a response.
-     * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
-     *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for
-     *   all reasoning values in gpt-5.1.
-     * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support
-     *   `none`.
-     * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+     * Constrains effort on reasoning for reasoning models. Currently supported values are `none`,
+     * `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort can result
+     * in faster responses and fewer tokens used on reasoning in a response. Not all reasoning
+     * models support every value. See the
+     * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+     * support.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -397,18 +392,12 @@ private constructor(
         fun name(name: JsonField<String>) = apply { body.name(name) }
 
         /**
-         * Constrains effort on reasoning for
-         * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-         * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing
-         * reasoning effort can result in faster responses and fewer tokens used on reasoning in a
-         * response.
-         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
-         *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported
-         *   for all reasoning values in gpt-5.1.
-         * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support
-         *   `none`.
-         * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-         * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
          */
         fun reasoningEffort(reasoningEffort: ReasoningEffort?) = apply {
             body.reasoningEffort(reasoningEffort)
@@ -867,18 +856,12 @@ private constructor(
         fun name(): Optional<String> = name.getOptional("name")
 
         /**
-         * Constrains effort on reasoning for
-         * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-         * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing
-         * reasoning effort can result in faster responses and fewer tokens used on reasoning in a
-         * response.
-         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
-         *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported
-         *   for all reasoning values in gpt-5.1.
-         * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support
-         *   `none`.
-         * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-         * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -1199,18 +1182,12 @@ private constructor(
             fun name(name: JsonField<String>) = apply { this.name = name }
 
             /**
-             * Constrains effort on reasoning for
-             * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-             * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-             * Reducing reasoning effort can result in faster responses and fewer tokens used on
-             * reasoning in a response.
-             * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-             *   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls
-             *   are supported for all reasoning values in gpt-5.1.
-             * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-             *   support `none`.
-             * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-             * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+             * Constrains effort on reasoning for reasoning models. Currently supported values are
+             * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning
+             * effort can result in faster responses and fewer tokens used on reasoning in a
+             * response. Not all reasoning models support every value. See the
+             * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+             * model-specific support.
              */
             fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                 reasoningEffort(JsonField.ofNullable(reasoningEffort))
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaApplyPatchTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaApplyPatchTool.kt
new file mode 100644
index 000000000..c0b39c34e
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaApplyPatchTool.kt
@@ -0,0 +1,376 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Allows the assistant to create, delete, or update files using unified diffs. */
+class BetaApplyPatchTool
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonValue,
+    private val allowedCallers: JsonField<List<AllowedCaller>>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("allowed_callers")
+        @ExcludeMissing
+        allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
+    ) : this(type, allowedCallers, mutableMapOf())
+
+    /**
+     * The type of the tool. Always `apply_patch`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("apply_patch")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The tool invocation context(s).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun allowedCallers(): Optional<List<AllowedCaller>> =
+        allowedCallers.getOptional("allowed_callers")
+
+    /**
+     * Returns the raw JSON value of [allowedCallers].
+     *
+     * Unlike [allowedCallers], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("allowed_callers")
+    @ExcludeMissing
+    fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [BetaApplyPatchTool]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaApplyPatchTool]. */
+    class Builder internal constructor() {
+
+        private var type: JsonValue = JsonValue.from("apply_patch")
+        private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaApplyPatchTool: BetaApplyPatchTool) = apply {
+            type = betaApplyPatchTool.type
+            allowedCallers = betaApplyPatchTool.allowedCallers.map { it.toMutableList() }
+            additionalProperties = betaApplyPatchTool.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("apply_patch")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The tool invocation context(s). */
+        fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+            allowedCallers(JsonField.ofNullable(allowedCallers))
+
+        /** Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`. */
+        fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+            allowedCallers(allowedCallers.getOrNull())
+
+        /**
+         * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.allowedCallers] with a well-typed `List<AllowedCaller>`
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+            this.allowedCallers = allowedCallers.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [AllowedCaller] to [allowedCallers].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+            allowedCallers =
+                (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("allowedCallers", it).add(allowedCaller)
+                }
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaApplyPatchTool].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): BetaApplyPatchTool =
+            BetaApplyPatchTool(
+                type,
+                (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaApplyPatchTool = apply {
+        if (validated) {
+            return@apply
+        }
+
+        _type().let {
+            if (it != JsonValue.from("apply_patch")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        allowedCallers().ifPresent { it.forEach { it.validate() } }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        type.let { if (it == JsonValue.from("apply_patch")) 1 else 0 } +
+            (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+    class AllowedCaller @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val DIRECT = of("direct")
+
+            @JvmField val PROGRAMMATIC = of("programmatic")
+
+            @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+        }
+
+        /** An enum containing [AllowedCaller]'s known values. */
+        enum class Known {
+            DIRECT,
+            PROGRAMMATIC,
+        }
+
+        /**
+         * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            DIRECT,
+            PROGRAMMATIC,
+            /**
+             * An enum member indicating that [AllowedCaller] was instantiated with an unknown
+             * value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                DIRECT -> Value.DIRECT
+                PROGRAMMATIC -> Value.PROGRAMMATIC
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                DIRECT -> Known.DIRECT
+                PROGRAMMATIC -> Known.PROGRAMMATIC
+                else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): AllowedCaller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AllowedCaller && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaApplyPatchTool &&
+            type == other.type &&
+            allowedCallers == other.allowedCallers &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(type, allowedCallers, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaApplyPatchTool{type=$type, allowedCallers=$allowedCallers, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaCompactedResponse.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaCompactedResponse.kt
new file mode 100644
index 000000000..ddc58444a
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaCompactedResponse.kt
@@ -0,0 +1,558 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import kotlin.jvm.optionals.getOrNull
+
+class BetaCompactedResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val createdAt: JsonField<Long>,
+    private val object_: JsonValue,
+    private val output: JsonField<List<BetaResponseOutputItem>>,
+    private val usage: JsonField<BetaResponseUsage>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("created_at") @ExcludeMissing createdAt: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("object") @ExcludeMissing object_: JsonValue = JsonMissing.of(),
+        @JsonProperty("output")
+        @ExcludeMissing
+        output: JsonField<List<BetaResponseOutputItem>> = JsonMissing.of(),
+        @JsonProperty("usage")
+        @ExcludeMissing
+        usage: JsonField<BetaResponseUsage> = JsonMissing.of(),
+    ) : this(id, createdAt, object_, output, usage, mutableMapOf())
+
+    /**
+     * The unique identifier for the compacted response.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * Unix timestamp (in seconds) when the compacted conversation was created.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun createdAt(): Long = createdAt.getRequired("created_at")
+
+    /**
+     * The object type. Always `response.compaction`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.compaction")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("object") @ExcludeMissing fun _object_(): JsonValue = object_
+
+    /**
+     * The compacted list of output items. This is a list of all user messages, followed by a single
+     * compaction item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun output(): List<BetaResponseOutputItem> = output.getRequired("output")
+
+    /**
+     * Token accounting for the compaction pass, including cached, reasoning, and total tokens.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun usage(): BetaResponseUsage = usage.getRequired("usage")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [createdAt].
+     *
+     * Unlike [createdAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_at") @ExcludeMissing fun _createdAt(): JsonField<Long> = createdAt
+
+    /**
+     * Returns the raw JSON value of [output].
+     *
+     * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output")
+    @ExcludeMissing
+    fun _output(): JsonField<List<BetaResponseOutputItem>> = output
+
+    /**
+     * Returns the raw JSON value of [usage].
+     *
+     * Unlike [usage], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("usage") @ExcludeMissing fun _usage(): JsonField<BetaResponseUsage> = usage
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaCompactedResponse].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .createdAt()
+         * .output()
+         * .usage()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaCompactedResponse]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var createdAt: JsonField<Long>? = null
+        private var object_: JsonValue = JsonValue.from("response.compaction")
+        private var output: JsonField<MutableList<BetaResponseOutputItem>>? = null
+        private var usage: JsonField<BetaResponseUsage>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaCompactedResponse: BetaCompactedResponse) = apply {
+            id = betaCompactedResponse.id
+            createdAt = betaCompactedResponse.createdAt
+            object_ = betaCompactedResponse.object_
+            output = betaCompactedResponse.output.map { it.toMutableList() }
+            usage = betaCompactedResponse.usage
+            additionalProperties = betaCompactedResponse.additionalProperties.toMutableMap()
+        }
+
+        /** The unique identifier for the compacted response. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** Unix timestamp (in seconds) when the compacted conversation was created. */
+        fun createdAt(createdAt: Long) = createdAt(JsonField.of(createdAt))
+
+        /**
+         * Sets [Builder.createdAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdAt] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun createdAt(createdAt: JsonField<Long>) = apply { this.createdAt = createdAt }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.compaction")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun object_(object_: JsonValue) = apply { this.object_ = object_ }
+
+        /**
+         * The compacted list of output items. This is a list of all user messages, followed by a
+         * single compaction item.
+         */
+        fun output(output: List<BetaResponseOutputItem>) = output(JsonField.of(output))
+
+        /**
+         * Sets [Builder.output] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.output] with a well-typed `List<BetaResponseOutputItem>`
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun output(output: JsonField<List<BetaResponseOutputItem>>) = apply {
+            this.output = output.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [BetaResponseOutputItem] to [Builder.output].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addOutput(output: BetaResponseOutputItem) = apply {
+            this.output =
+                (this.output ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("output", it).add(output)
+                }
+        }
+
+        /** Alias for calling [addOutput] with `BetaResponseOutputItem.ofMessage(message)`. */
+        fun addOutput(message: BetaResponseOutputMessage) =
+            addOutput(BetaResponseOutputItem.ofMessage(message))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofFileSearchCall(fileSearchCall)`.
+         */
+        fun addOutput(fileSearchCall: BetaResponseFileSearchToolCall) =
+            addOutput(BetaResponseOutputItem.ofFileSearchCall(fileSearchCall))
+
+        /**
+         * Alias for calling [addOutput] with `BetaResponseOutputItem.ofFunctionCall(functionCall)`.
+         */
+        fun addOutput(functionCall: BetaResponseFunctionToolCall) =
+            addOutput(BetaResponseOutputItem.ofFunctionCall(functionCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofFunctionCallOutput(functionCallOutput)`.
+         */
+        fun addOutput(functionCallOutput: BetaResponseFunctionToolCallOutputItem) =
+            addOutput(BetaResponseOutputItem.ofFunctionCallOutput(functionCallOutput))
+
+        /**
+         * Alias for calling [addOutput] with `BetaResponseOutputItem.ofAgentMessage(agentMessage)`.
+         */
+        fun addOutput(agentMessage: BetaResponseOutputItem.AgentMessage) =
+            addOutput(BetaResponseOutputItem.ofAgentMessage(agentMessage))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofMultiAgentCall(multiAgentCall)`.
+         */
+        fun addOutput(multiAgentCall: BetaResponseOutputItem.MultiAgentCall) =
+            addOutput(BetaResponseOutputItem.ofMultiAgentCall(multiAgentCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofMultiAgentCallOutput(multiAgentCallOutput)`.
+         */
+        fun addOutput(multiAgentCallOutput: BetaResponseOutputItem.MultiAgentCallOutput) =
+            addOutput(BetaResponseOutputItem.ofMultiAgentCallOutput(multiAgentCallOutput))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofWebSearchCall(webSearchCall)`.
+         */
+        fun addOutput(webSearchCall: BetaResponseFunctionWebSearch) =
+            addOutput(BetaResponseOutputItem.ofWebSearchCall(webSearchCall))
+
+        /**
+         * Alias for calling [addOutput] with `BetaResponseOutputItem.ofComputerCall(computerCall)`.
+         */
+        fun addOutput(computerCall: BetaResponseComputerToolCall) =
+            addOutput(BetaResponseOutputItem.ofComputerCall(computerCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofComputerCallOutput(computerCallOutput)`.
+         */
+        fun addOutput(computerCallOutput: BetaResponseComputerToolCallOutputItem) =
+            addOutput(BetaResponseOutputItem.ofComputerCallOutput(computerCallOutput))
+
+        /** Alias for calling [addOutput] with `BetaResponseOutputItem.ofReasoning(reasoning)`. */
+        fun addOutput(reasoning: BetaResponseReasoningItem) =
+            addOutput(BetaResponseOutputItem.ofReasoning(reasoning))
+
+        /** Alias for calling [addOutput] with `BetaResponseOutputItem.ofProgram(program)`. */
+        fun addOutput(program: BetaResponseOutputItem.Program) =
+            addOutput(BetaResponseOutputItem.ofProgram(program))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofProgramOutput(programOutput)`.
+         */
+        fun addOutput(programOutput: BetaResponseOutputItem.ProgramOutput) =
+            addOutput(BetaResponseOutputItem.ofProgramOutput(programOutput))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofToolSearchCall(toolSearchCall)`.
+         */
+        fun addOutput(toolSearchCall: BetaResponseToolSearchCall) =
+            addOutput(BetaResponseOutputItem.ofToolSearchCall(toolSearchCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofToolSearchOutput(toolSearchOutput)`.
+         */
+        fun addOutput(toolSearchOutput: BetaResponseToolSearchOutputItem) =
+            addOutput(BetaResponseOutputItem.ofToolSearchOutput(toolSearchOutput))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofAdditionalTools(additionalTools)`.
+         */
+        fun addOutput(additionalTools: BetaResponseOutputItem.AdditionalTools) =
+            addOutput(BetaResponseOutputItem.ofAdditionalTools(additionalTools))
+
+        /** Alias for calling [addOutput] with `BetaResponseOutputItem.ofCompaction(compaction)`. */
+        fun addOutput(compaction: BetaResponseCompactionItem) =
+            addOutput(BetaResponseOutputItem.ofCompaction(compaction))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofImageGenerationCall(imageGenerationCall)`.
+         */
+        fun addOutput(imageGenerationCall: BetaResponseOutputItem.ImageGenerationCall) =
+            addOutput(BetaResponseOutputItem.ofImageGenerationCall(imageGenerationCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofCodeInterpreterCall(codeInterpreterCall)`.
+         */
+        fun addOutput(codeInterpreterCall: BetaResponseCodeInterpreterToolCall) =
+            addOutput(BetaResponseOutputItem.ofCodeInterpreterCall(codeInterpreterCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofLocalShellCall(localShellCall)`.
+         */
+        fun addOutput(localShellCall: BetaResponseOutputItem.LocalShellCall) =
+            addOutput(BetaResponseOutputItem.ofLocalShellCall(localShellCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofLocalShellCallOutput(localShellCallOutput)`.
+         */
+        fun addOutput(localShellCallOutput: BetaResponseOutputItem.LocalShellCallOutput) =
+            addOutput(BetaResponseOutputItem.ofLocalShellCallOutput(localShellCallOutput))
+
+        /** Alias for calling [addOutput] with `BetaResponseOutputItem.ofShellCall(shellCall)`. */
+        fun addOutput(shellCall: BetaResponseFunctionShellToolCall) =
+            addOutput(BetaResponseOutputItem.ofShellCall(shellCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofShellCallOutput(shellCallOutput)`.
+         */
+        fun addOutput(shellCallOutput: BetaResponseFunctionShellToolCallOutput) =
+            addOutput(BetaResponseOutputItem.ofShellCallOutput(shellCallOutput))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofApplyPatchCall(applyPatchCall)`.
+         */
+        fun addOutput(applyPatchCall: BetaResponseApplyPatchToolCall) =
+            addOutput(BetaResponseOutputItem.ofApplyPatchCall(applyPatchCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofApplyPatchCallOutput(applyPatchCallOutput)`.
+         */
+        fun addOutput(applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput) =
+            addOutput(BetaResponseOutputItem.ofApplyPatchCallOutput(applyPatchCallOutput))
+
+        /** Alias for calling [addOutput] with `BetaResponseOutputItem.ofMcpCall(mcpCall)`. */
+        fun addOutput(mcpCall: BetaResponseOutputItem.McpCall) =
+            addOutput(BetaResponseOutputItem.ofMcpCall(mcpCall))
+
+        /**
+         * Alias for calling [addOutput] with `BetaResponseOutputItem.ofMcpListTools(mcpListTools)`.
+         */
+        fun addOutput(mcpListTools: BetaResponseOutputItem.McpListTools) =
+            addOutput(BetaResponseOutputItem.ofMcpListTools(mcpListTools))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofMcpApprovalRequest(mcpApprovalRequest)`.
+         */
+        fun addOutput(mcpApprovalRequest: BetaResponseOutputItem.McpApprovalRequest) =
+            addOutput(BetaResponseOutputItem.ofMcpApprovalRequest(mcpApprovalRequest))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofMcpApprovalResponse(mcpApprovalResponse)`.
+         */
+        fun addOutput(mcpApprovalResponse: BetaResponseOutputItem.McpApprovalResponse) =
+            addOutput(BetaResponseOutputItem.ofMcpApprovalResponse(mcpApprovalResponse))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofCustomToolCall(customToolCall)`.
+         */
+        fun addOutput(customToolCall: BetaResponseCustomToolCall) =
+            addOutput(BetaResponseOutputItem.ofCustomToolCall(customToolCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofCustomToolCallOutput(customToolCallOutput)`.
+         */
+        fun addOutput(customToolCallOutput: BetaResponseCustomToolCallOutputItem) =
+            addOutput(BetaResponseOutputItem.ofCustomToolCallOutput(customToolCallOutput))
+
+        /**
+         * Token accounting for the compaction pass, including cached, reasoning, and total tokens.
+         */
+        fun usage(usage: BetaResponseUsage) = usage(JsonField.of(usage))
+
+        /**
+         * Sets [Builder.usage] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.usage] with a well-typed [BetaResponseUsage] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun usage(usage: JsonField<BetaResponseUsage>) = apply { this.usage = usage }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaCompactedResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .createdAt()
+         * .output()
+         * .usage()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaCompactedResponse =
+            BetaCompactedResponse(
+                checkRequired("id", id),
+                checkRequired("createdAt", createdAt),
+                object_,
+                checkRequired("output", output).map { it.toImmutable() },
+                checkRequired("usage", usage),
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaCompactedResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        createdAt()
+        _object_().let {
+            if (it != JsonValue.from("response.compaction")) {
+                throw OpenAIInvalidDataException("'object_' is invalid, received $it")
+            }
+        }
+        output().forEach { it.validate() }
+        usage().validate()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (if (createdAt.asKnown().isPresent) 1 else 0) +
+            object_.let { if (it == JsonValue.from("response.compaction")) 1 else 0 } +
+            (output.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (usage.asKnown().getOrNull()?.validity() ?: 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaCompactedResponse &&
+            id == other.id &&
+            createdAt == other.createdAt &&
+            object_ == other.object_ &&
+            output == other.output &&
+            usage == other.usage &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(id, createdAt, object_, output, usage, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaCompactedResponse{id=$id, createdAt=$createdAt, object_=$object_, output=$output, usage=$usage, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaComputerAction.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaComputerAction.kt
new file mode 100644
index 000000000..b9585d360
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaComputerAction.kt
@@ -0,0 +1,2881 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** A click action. */
+@JsonDeserialize(using = BetaComputerAction.Deserializer::class)
+@JsonSerialize(using = BetaComputerAction.Serializer::class)
+class BetaComputerAction
+private constructor(
+    private val click: Click? = null,
+    private val doubleClick: DoubleClick? = null,
+    private val drag: Drag? = null,
+    private val keypress: Keypress? = null,
+    private val move: Move? = null,
+    private val screenshot: JsonValue? = null,
+    private val scroll: Scroll? = null,
+    private val type: Type? = null,
+    private val wait: JsonValue? = null,
+    private val _json: JsonValue? = null,
+) {
+
+    /** A click action. */
+    fun click(): Optional<Click> = Optional.ofNullable(click)
+
+    /** A double click action. */
+    fun doubleClick(): Optional<DoubleClick> = Optional.ofNullable(doubleClick)
+
+    /** A drag action. */
+    fun drag(): Optional<Drag> = Optional.ofNullable(drag)
+
+    /** A collection of keypresses the model would like to perform. */
+    fun keypress(): Optional<Keypress> = Optional.ofNullable(keypress)
+
+    /** A mouse move action. */
+    fun move(): Optional<Move> = Optional.ofNullable(move)
+
+    /** A screenshot action. */
+    fun screenshot(): Optional<JsonValue> = Optional.ofNullable(screenshot)
+
+    /** A scroll action. */
+    fun scroll(): Optional<Scroll> = Optional.ofNullable(scroll)
+
+    /** An action to type in text. */
+    fun type(): Optional<Type> = Optional.ofNullable(type)
+
+    /** A wait action. */
+    fun wait(): Optional<JsonValue> = Optional.ofNullable(wait)
+
+    fun isClick(): Boolean = click != null
+
+    fun isDoubleClick(): Boolean = doubleClick != null
+
+    fun isDrag(): Boolean = drag != null
+
+    fun isKeypress(): Boolean = keypress != null
+
+    fun isMove(): Boolean = move != null
+
+    fun isScreenshot(): Boolean = screenshot != null
+
+    fun isScroll(): Boolean = scroll != null
+
+    fun isType(): Boolean = type != null
+
+    fun isWait(): Boolean = wait != null
+
+    /** A click action. */
+    fun asClick(): Click = click.getOrThrow("click")
+
+    /** A double click action. */
+    fun asDoubleClick(): DoubleClick = doubleClick.getOrThrow("doubleClick")
+
+    /** A drag action. */
+    fun asDrag(): Drag = drag.getOrThrow("drag")
+
+    /** A collection of keypresses the model would like to perform. */
+    fun asKeypress(): Keypress = keypress.getOrThrow("keypress")
+
+    /** A mouse move action. */
+    fun asMove(): Move = move.getOrThrow("move")
+
+    /** A screenshot action. */
+    fun asScreenshot(): JsonValue = screenshot.getOrThrow("screenshot")
+
+    /** A scroll action. */
+    fun asScroll(): Scroll = scroll.getOrThrow("scroll")
+
+    /** An action to type in text. */
+    fun asType(): Type = type.getOrThrow("type")
+
+    /** A wait action. */
+    fun asWait(): JsonValue = wait.getOrThrow("wait")
+
+    fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+    /**
+     * Maps this instance's current variant to a value of type [T] using the given [visitor].
+     *
+     * Note that this method is _not_ forwards compatible with new variants from the API, unless
+     * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of the
+     * SDK gracefully, consider overriding [Visitor.unknown]:
+     * ```java
+     * import com.openai.core.JsonValue;
+     * import java.util.Optional;
+     *
+     * Optional<String> result = betaComputerAction.accept(new BetaComputerAction.Visitor<Optional<String>>() {
+     *     @Override
+     *     public Optional<String> visitClick(Click click) {
+     *         return Optional.of(click.toString());
+     *     }
+     *
+     *     // ...
+     *
+     *     @Override
+     *     public Optional<String> unknown(JsonValue json) {
+     *         // Or inspect the `json`.
+     *         return Optional.empty();
+     *     }
+     * });
+     * ```
+     *
+     * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor] and
+     *   the current variant is unknown.
+     */
+    fun <T> accept(visitor: Visitor<T>): T =
+        when {
+            click != null -> visitor.visitClick(click)
+            doubleClick != null -> visitor.visitDoubleClick(doubleClick)
+            drag != null -> visitor.visitDrag(drag)
+            keypress != null -> visitor.visitKeypress(keypress)
+            move != null -> visitor.visitMove(move)
+            screenshot != null -> visitor.visitScreenshot(screenshot)
+            scroll != null -> visitor.visitScroll(scroll)
+            type != null -> visitor.visitType(type)
+            wait != null -> visitor.visitWait(wait)
+            else -> visitor.unknown(_json)
+        }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaComputerAction = apply {
+        if (validated) {
+            return@apply
+        }
+
+        accept(
+            object : Visitor<Unit> {
+                override fun visitClick(click: Click) {
+                    click.validate()
+                }
+
+                override fun visitDoubleClick(doubleClick: DoubleClick) {
+                    doubleClick.validate()
+                }
+
+                override fun visitDrag(drag: Drag) {
+                    drag.validate()
+                }
+
+                override fun visitKeypress(keypress: Keypress) {
+                    keypress.validate()
+                }
+
+                override fun visitMove(move: Move) {
+                    move.validate()
+                }
+
+                override fun visitScreenshot(screenshot: JsonValue) {
+                    screenshot.let {
+                        if (it != JsonValue.from(mapOf("type" to "screenshot"))) {
+                            throw OpenAIInvalidDataException(
+                                "'screenshot' is invalid, received $it"
+                            )
+                        }
+                    }
+                }
+
+                override fun visitScroll(scroll: Scroll) {
+                    scroll.validate()
+                }
+
+                override fun visitType(type: Type) {
+                    type.validate()
+                }
+
+                override fun visitWait(wait: JsonValue) {
+                    wait.let {
+                        if (it != JsonValue.from(mapOf("type" to "wait"))) {
+                            throw OpenAIInvalidDataException("'wait' is invalid, received $it")
+                        }
+                    }
+                }
+            }
+        )
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        accept(
+            object : Visitor<Int> {
+                override fun visitClick(click: Click) = click.validity()
+
+                override fun visitDoubleClick(doubleClick: DoubleClick) = doubleClick.validity()
+
+                override fun visitDrag(drag: Drag) = drag.validity()
+
+                override fun visitKeypress(keypress: Keypress) = keypress.validity()
+
+                override fun visitMove(move: Move) = move.validity()
+
+                override fun visitScreenshot(screenshot: JsonValue) =
+                    screenshot.let {
+                        if (it == JsonValue.from(mapOf("type" to "screenshot"))) 1 else 0
+                    }
+
+                override fun visitScroll(scroll: Scroll) = scroll.validity()
+
+                override fun visitType(type: Type) = type.validity()
+
+                override fun visitWait(wait: JsonValue) =
+                    wait.let { if (it == JsonValue.from(mapOf("type" to "wait"))) 1 else 0 }
+
+                override fun unknown(json: JsonValue?) = 0
+            }
+        )
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaComputerAction &&
+            click == other.click &&
+            doubleClick == other.doubleClick &&
+            drag == other.drag &&
+            keypress == other.keypress &&
+            move == other.move &&
+            screenshot == other.screenshot &&
+            scroll == other.scroll &&
+            type == other.type &&
+            wait == other.wait
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(click, doubleClick, drag, keypress, move, screenshot, scroll, type, wait)
+
+    override fun toString(): String =
+        when {
+            click != null -> "BetaComputerAction{click=$click}"
+            doubleClick != null -> "BetaComputerAction{doubleClick=$doubleClick}"
+            drag != null -> "BetaComputerAction{drag=$drag}"
+            keypress != null -> "BetaComputerAction{keypress=$keypress}"
+            move != null -> "BetaComputerAction{move=$move}"
+            screenshot != null -> "BetaComputerAction{screenshot=$screenshot}"
+            scroll != null -> "BetaComputerAction{scroll=$scroll}"
+            type != null -> "BetaComputerAction{type=$type}"
+            wait != null -> "BetaComputerAction{wait=$wait}"
+            _json != null -> "BetaComputerAction{_unknown=$_json}"
+            else -> throw IllegalStateException("Invalid BetaComputerAction")
+        }
+
+    companion object {
+
+        /** A click action. */
+        @JvmStatic fun ofClick(click: Click) = BetaComputerAction(click = click)
+
+        /** A double click action. */
+        @JvmStatic
+        fun ofDoubleClick(doubleClick: DoubleClick) = BetaComputerAction(doubleClick = doubleClick)
+
+        /** A drag action. */
+        @JvmStatic fun ofDrag(drag: Drag) = BetaComputerAction(drag = drag)
+
+        /** A collection of keypresses the model would like to perform. */
+        @JvmStatic fun ofKeypress(keypress: Keypress) = BetaComputerAction(keypress = keypress)
+
+        /** A mouse move action. */
+        @JvmStatic fun ofMove(move: Move) = BetaComputerAction(move = move)
+
+        /** A screenshot action. */
+        @JvmStatic
+        fun ofScreenshot() =
+            BetaComputerAction(screenshot = JsonValue.from(mapOf("type" to "screenshot")))
+
+        /** A scroll action. */
+        @JvmStatic fun ofScroll(scroll: Scroll) = BetaComputerAction(scroll = scroll)
+
+        /** An action to type in text. */
+        @JvmStatic fun ofType(type: Type) = BetaComputerAction(type = type)
+
+        /** A wait action. */
+        @JvmStatic fun ofWait() = BetaComputerAction(wait = JsonValue.from(mapOf("type" to "wait")))
+    }
+
+    /**
+     * An interface that defines how to map each variant of [BetaComputerAction] to a value of type
+     * [T].
+     */
+    interface Visitor<out T> {
+
+        /** A click action. */
+        fun visitClick(click: Click): T
+
+        /** A double click action. */
+        fun visitDoubleClick(doubleClick: DoubleClick): T
+
+        /** A drag action. */
+        fun visitDrag(drag: Drag): T
+
+        /** A collection of keypresses the model would like to perform. */
+        fun visitKeypress(keypress: Keypress): T
+
+        /** A mouse move action. */
+        fun visitMove(move: Move): T
+
+        /** A screenshot action. */
+        fun visitScreenshot(screenshot: JsonValue): T
+
+        /** A scroll action. */
+        fun visitScroll(scroll: Scroll): T
+
+        /** An action to type in text. */
+        fun visitType(type: Type): T
+
+        /** A wait action. */
+        fun visitWait(wait: JsonValue): T
+
+        /**
+         * Maps an unknown variant of [BetaComputerAction] to a value of type [T].
+         *
+         * An instance of [BetaComputerAction] can contain an unknown variant if it was deserialized
+         * from data that doesn't match any known variant. For example, if the SDK is on an older
+         * version than the API, then the API may respond with new variants that the SDK is unaware
+         * of.
+         *
+         * @throws OpenAIInvalidDataException in the default implementation.
+         */
+        fun unknown(json: JsonValue?): T {
+            throw OpenAIInvalidDataException("Unknown BetaComputerAction: $json")
+        }
+    }
+
+    internal class Deserializer : BaseDeserializer<BetaComputerAction>(BetaComputerAction::class) {
+
+        override fun ObjectCodec.deserialize(node: JsonNode): BetaComputerAction {
+            val json = JsonValue.fromJsonNode(node)
+            val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+            when (type) {
+                "click" -> {
+                    return tryDeserialize(node, jacksonTypeRef<Click>())?.let {
+                        BetaComputerAction(click = it, _json = json)
+                    } ?: BetaComputerAction(_json = json)
+                }
+                "double_click" -> {
+                    return tryDeserialize(node, jacksonTypeRef<DoubleClick>())?.let {
+                        BetaComputerAction(doubleClick = it, _json = json)
+                    } ?: BetaComputerAction(_json = json)
+                }
+                "drag" -> {
+                    return tryDeserialize(node, jacksonTypeRef<Drag>())?.let {
+                        BetaComputerAction(drag = it, _json = json)
+                    } ?: BetaComputerAction(_json = json)
+                }
+                "keypress" -> {
+                    return tryDeserialize(node, jacksonTypeRef<Keypress>())?.let {
+                        BetaComputerAction(keypress = it, _json = json)
+                    } ?: BetaComputerAction(_json = json)
+                }
+                "move" -> {
+                    return tryDeserialize(node, jacksonTypeRef<Move>())?.let {
+                        BetaComputerAction(move = it, _json = json)
+                    } ?: BetaComputerAction(_json = json)
+                }
+                "screenshot" -> {
+                    return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                        ?.let { BetaComputerAction(screenshot = it, _json = json) }
+                        ?.takeIf { it.isValid() } ?: BetaComputerAction(_json = json)
+                }
+                "scroll" -> {
+                    return tryDeserialize(node, jacksonTypeRef<Scroll>())?.let {
+                        BetaComputerAction(scroll = it, _json = json)
+                    } ?: BetaComputerAction(_json = json)
+                }
+                "type" -> {
+                    return tryDeserialize(node, jacksonTypeRef<Type>())?.let {
+                        BetaComputerAction(type = it, _json = json)
+                    } ?: BetaComputerAction(_json = json)
+                }
+                "wait" -> {
+                    return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                        ?.let { BetaComputerAction(wait = it, _json = json) }
+                        ?.takeIf { it.isValid() } ?: BetaComputerAction(_json = json)
+                }
+            }
+
+            return BetaComputerAction(_json = json)
+        }
+    }
+
+    internal class Serializer : BaseSerializer<BetaComputerAction>(BetaComputerAction::class) {
+
+        override fun serialize(
+            value: BetaComputerAction,
+            generator: JsonGenerator,
+            provider: SerializerProvider,
+        ) {
+            when {
+                value.click != null -> generator.writeObject(value.click)
+                value.doubleClick != null -> generator.writeObject(value.doubleClick)
+                value.drag != null -> generator.writeObject(value.drag)
+                value.keypress != null -> generator.writeObject(value.keypress)
+                value.move != null -> generator.writeObject(value.move)
+                value.screenshot != null -> generator.writeObject(value.screenshot)
+                value.scroll != null -> generator.writeObject(value.scroll)
+                value.type != null -> generator.writeObject(value.type)
+                value.wait != null -> generator.writeObject(value.wait)
+                value._json != null -> generator.writeObject(value._json)
+                else -> throw IllegalStateException("Invalid BetaComputerAction")
+            }
+        }
+    }
+
+    /** A click action. */
+    class Click
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val button: JsonField<Button>,
+        private val type: JsonValue,
+        private val x: JsonField<Long>,
+        private val y: JsonField<Long>,
+        private val keys: JsonField<List<String>>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("button") @ExcludeMissing button: JsonField<Button> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("x") @ExcludeMissing x: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("y") @ExcludeMissing y: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("keys") @ExcludeMissing keys: JsonField<List<String>> = JsonMissing.of(),
+        ) : this(button, type, x, y, keys, mutableMapOf())
+
+        /**
+         * Indicates which mouse button was pressed during the click. One of `left`, `right`,
+         * `wheel`, `back`, or `forward`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun button(): Button = button.getRequired("button")
+
+        /**
+         * Specifies the event type. For a click action, this property is always `click`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("click")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The x-coordinate where the click occurred.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun x(): Long = x.getRequired("x")
+
+        /**
+         * The y-coordinate where the click occurred.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun y(): Long = y.getRequired("y")
+
+        /**
+         * The keys being held while clicking.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun keys(): Optional<List<String>> = keys.getOptional("keys")
+
+        /**
+         * Returns the raw JSON value of [button].
+         *
+         * Unlike [button], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("button") @ExcludeMissing fun _button(): JsonField<Button> = button
+
+        /**
+         * Returns the raw JSON value of [x].
+         *
+         * Unlike [x], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("x") @ExcludeMissing fun _x(): JsonField<Long> = x
+
+        /**
+         * Returns the raw JSON value of [y].
+         *
+         * Unlike [y], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("y") @ExcludeMissing fun _y(): JsonField<Long> = y
+
+        /**
+         * Returns the raw JSON value of [keys].
+         *
+         * Unlike [keys], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("keys") @ExcludeMissing fun _keys(): JsonField<List<String>> = keys
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Click].
+             *
+             * The following fields are required:
+             * ```java
+             * .button()
+             * .x()
+             * .y()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Click]. */
+        class Builder internal constructor() {
+
+            private var button: JsonField<Button>? = null
+            private var type: JsonValue = JsonValue.from("click")
+            private var x: JsonField<Long>? = null
+            private var y: JsonField<Long>? = null
+            private var keys: JsonField<MutableList<String>>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(click: Click) = apply {
+                button = click.button
+                type = click.type
+                x = click.x
+                y = click.y
+                keys = click.keys.map { it.toMutableList() }
+                additionalProperties = click.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Indicates which mouse button was pressed during the click. One of `left`, `right`,
+             * `wheel`, `back`, or `forward`.
+             */
+            fun button(button: Button) = button(JsonField.of(button))
+
+            /**
+             * Sets [Builder.button] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.button] with a well-typed [Button] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun button(button: JsonField<Button>) = apply { this.button = button }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("click")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The x-coordinate where the click occurred. */
+            fun x(x: Long) = x(JsonField.of(x))
+
+            /**
+             * Sets [Builder.x] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.x] with a well-typed [Long] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun x(x: JsonField<Long>) = apply { this.x = x }
+
+            /** The y-coordinate where the click occurred. */
+            fun y(y: Long) = y(JsonField.of(y))
+
+            /**
+             * Sets [Builder.y] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.y] with a well-typed [Long] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun y(y: JsonField<Long>) = apply { this.y = y }
+
+            /** The keys being held while clicking. */
+            fun keys(keys: List<String>?) = keys(JsonField.ofNullable(keys))
+
+            /** Alias for calling [Builder.keys] with `keys.orElse(null)`. */
+            fun keys(keys: Optional<List<String>>) = keys(keys.getOrNull())
+
+            /**
+             * Sets [Builder.keys] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.keys] with a well-typed `List<String>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun keys(keys: JsonField<List<String>>) = apply {
+                this.keys = keys.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [String] to [keys].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addKey(key: String) = apply {
+                keys =
+                    (keys ?: JsonField.of(mutableListOf())).also { checkKnown("keys", it).add(key) }
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Click].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .button()
+             * .x()
+             * .y()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Click =
+                Click(
+                    checkRequired("button", button),
+                    type,
+                    checkRequired("x", x),
+                    checkRequired("y", y),
+                    (keys ?: JsonMissing.of()).map { it.toImmutable() },
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Click = apply {
+            if (validated) {
+                return@apply
+            }
+
+            button().validate()
+            _type().let {
+                if (it != JsonValue.from("click")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            x()
+            y()
+            keys()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (button.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("click")) 1 else 0 } +
+                (if (x.asKnown().isPresent) 1 else 0) +
+                (if (y.asKnown().isPresent) 1 else 0) +
+                (keys.asKnown().getOrNull()?.size ?: 0)
+
+        /**
+         * Indicates which mouse button was pressed during the click. One of `left`, `right`,
+         * `wheel`, `back`, or `forward`.
+         */
+        class Button @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val LEFT = of("left")
+
+                @JvmField val RIGHT = of("right")
+
+                @JvmField val WHEEL = of("wheel")
+
+                @JvmField val BACK = of("back")
+
+                @JvmField val FORWARD = of("forward")
+
+                @JvmStatic fun of(value: String) = Button(JsonField.of(value))
+            }
+
+            /** An enum containing [Button]'s known values. */
+            enum class Known {
+                LEFT,
+                RIGHT,
+                WHEEL,
+                BACK,
+                FORWARD,
+            }
+
+            /**
+             * An enum containing [Button]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Button] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                LEFT,
+                RIGHT,
+                WHEEL,
+                BACK,
+                FORWARD,
+                /**
+                 * An enum member indicating that [Button] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    LEFT -> Value.LEFT
+                    RIGHT -> Value.RIGHT
+                    WHEEL -> Value.WHEEL
+                    BACK -> Value.BACK
+                    FORWARD -> Value.FORWARD
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    LEFT -> Known.LEFT
+                    RIGHT -> Known.RIGHT
+                    WHEEL -> Known.WHEEL
+                    BACK -> Known.BACK
+                    FORWARD -> Known.FORWARD
+                    else -> throw OpenAIInvalidDataException("Unknown Button: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Button = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Button && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Click &&
+                button == other.button &&
+                type == other.type &&
+                x == other.x &&
+                y == other.y &&
+                keys == other.keys &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(button, type, x, y, keys, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Click{button=$button, type=$type, x=$x, y=$y, keys=$keys, additionalProperties=$additionalProperties}"
+    }
+
+    /** A double click action. */
+    class DoubleClick
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val keys: JsonField<List<String>>,
+        private val type: JsonValue,
+        private val x: JsonField<Long>,
+        private val y: JsonField<Long>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("keys") @ExcludeMissing keys: JsonField<List<String>> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("x") @ExcludeMissing x: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("y") @ExcludeMissing y: JsonField<Long> = JsonMissing.of(),
+        ) : this(keys, type, x, y, mutableMapOf())
+
+        /**
+         * The keys being held while double-clicking.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun keys(): Optional<List<String>> = keys.getOptional("keys")
+
+        /**
+         * Specifies the event type. For a double click action, this property is always set to
+         * `double_click`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("double_click")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The x-coordinate where the double click occurred.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun x(): Long = x.getRequired("x")
+
+        /**
+         * The y-coordinate where the double click occurred.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun y(): Long = y.getRequired("y")
+
+        /**
+         * Returns the raw JSON value of [keys].
+         *
+         * Unlike [keys], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("keys") @ExcludeMissing fun _keys(): JsonField<List<String>> = keys
+
+        /**
+         * Returns the raw JSON value of [x].
+         *
+         * Unlike [x], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("x") @ExcludeMissing fun _x(): JsonField<Long> = x
+
+        /**
+         * Returns the raw JSON value of [y].
+         *
+         * Unlike [y], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("y") @ExcludeMissing fun _y(): JsonField<Long> = y
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [DoubleClick].
+             *
+             * The following fields are required:
+             * ```java
+             * .keys()
+             * .x()
+             * .y()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [DoubleClick]. */
+        class Builder internal constructor() {
+
+            private var keys: JsonField<MutableList<String>>? = null
+            private var type: JsonValue = JsonValue.from("double_click")
+            private var x: JsonField<Long>? = null
+            private var y: JsonField<Long>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(doubleClick: DoubleClick) = apply {
+                keys = doubleClick.keys.map { it.toMutableList() }
+                type = doubleClick.type
+                x = doubleClick.x
+                y = doubleClick.y
+                additionalProperties = doubleClick.additionalProperties.toMutableMap()
+            }
+
+            /** The keys being held while double-clicking. */
+            fun keys(keys: List<String>?) = keys(JsonField.ofNullable(keys))
+
+            /** Alias for calling [Builder.keys] with `keys.orElse(null)`. */
+            fun keys(keys: Optional<List<String>>) = keys(keys.getOrNull())
+
+            /**
+             * Sets [Builder.keys] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.keys] with a well-typed `List<String>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun keys(keys: JsonField<List<String>>) = apply {
+                this.keys = keys.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [String] to [keys].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addKey(key: String) = apply {
+                keys =
+                    (keys ?: JsonField.of(mutableListOf())).also { checkKnown("keys", it).add(key) }
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("double_click")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The x-coordinate where the double click occurred. */
+            fun x(x: Long) = x(JsonField.of(x))
+
+            /**
+             * Sets [Builder.x] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.x] with a well-typed [Long] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun x(x: JsonField<Long>) = apply { this.x = x }
+
+            /** The y-coordinate where the double click occurred. */
+            fun y(y: Long) = y(JsonField.of(y))
+
+            /**
+             * Sets [Builder.y] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.y] with a well-typed [Long] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun y(y: JsonField<Long>) = apply { this.y = y }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [DoubleClick].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .keys()
+             * .x()
+             * .y()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): DoubleClick =
+                DoubleClick(
+                    checkRequired("keys", keys).map { it.toImmutable() },
+                    type,
+                    checkRequired("x", x),
+                    checkRequired("y", y),
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): DoubleClick = apply {
+            if (validated) {
+                return@apply
+            }
+
+            keys()
+            _type().let {
+                if (it != JsonValue.from("double_click")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            x()
+            y()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (keys.asKnown().getOrNull()?.size ?: 0) +
+                type.let { if (it == JsonValue.from("double_click")) 1 else 0 } +
+                (if (x.asKnown().isPresent) 1 else 0) +
+                (if (y.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is DoubleClick &&
+                keys == other.keys &&
+                type == other.type &&
+                x == other.x &&
+                y == other.y &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(keys, type, x, y, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "DoubleClick{keys=$keys, type=$type, x=$x, y=$y, additionalProperties=$additionalProperties}"
+    }
+
+    /** A drag action. */
+    class Drag
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val path: JsonField<List<Path>>,
+        private val type: JsonValue,
+        private val keys: JsonField<List<String>>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("path") @ExcludeMissing path: JsonField<List<Path>> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("keys") @ExcludeMissing keys: JsonField<List<String>> = JsonMissing.of(),
+        ) : this(path, type, keys, mutableMapOf())
+
+        /**
+         * An array of coordinates representing the path of the drag action. Coordinates will appear
+         * as an array of objects, eg
+         *
+         * ```
+         * [
+         *   { x: 100, y: 200 },
+         *   { x: 200, y: 300 }
+         * ]
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun path(): List<Path> = path.getRequired("path")
+
+        /**
+         * Specifies the event type. For a drag action, this property is always set to `drag`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("drag")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The keys being held while dragging the mouse.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun keys(): Optional<List<String>> = keys.getOptional("keys")
+
+        /**
+         * Returns the raw JSON value of [path].
+         *
+         * Unlike [path], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("path") @ExcludeMissing fun _path(): JsonField<List<Path>> = path
+
+        /**
+         * Returns the raw JSON value of [keys].
+         *
+         * Unlike [keys], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("keys") @ExcludeMissing fun _keys(): JsonField<List<String>> = keys
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Drag].
+             *
+             * The following fields are required:
+             * ```java
+             * .path()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Drag]. */
+        class Builder internal constructor() {
+
+            private var path: JsonField<MutableList<Path>>? = null
+            private var type: JsonValue = JsonValue.from("drag")
+            private var keys: JsonField<MutableList<String>>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(drag: Drag) = apply {
+                path = drag.path.map { it.toMutableList() }
+                type = drag.type
+                keys = drag.keys.map { it.toMutableList() }
+                additionalProperties = drag.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * An array of coordinates representing the path of the drag action. Coordinates will
+             * appear as an array of objects, eg
+             *
+             * ```
+             * [
+             *   { x: 100, y: 200 },
+             *   { x: 200, y: 300 }
+             * ]
+             * ```
+             */
+            fun path(path: List<Path>) = path(JsonField.of(path))
+
+            /**
+             * Sets [Builder.path] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.path] with a well-typed `List<Path>` value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun path(path: JsonField<List<Path>>) = apply {
+                this.path = path.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [Path] to [Builder.path].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addPath(path: Path) = apply {
+                this.path =
+                    (this.path ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("path", it).add(path)
+                    }
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("drag")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The keys being held while dragging the mouse. */
+            fun keys(keys: List<String>?) = keys(JsonField.ofNullable(keys))
+
+            /** Alias for calling [Builder.keys] with `keys.orElse(null)`. */
+            fun keys(keys: Optional<List<String>>) = keys(keys.getOrNull())
+
+            /**
+             * Sets [Builder.keys] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.keys] with a well-typed `List<String>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun keys(keys: JsonField<List<String>>) = apply {
+                this.keys = keys.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [String] to [keys].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addKey(key: String) = apply {
+                keys =
+                    (keys ?: JsonField.of(mutableListOf())).also { checkKnown("keys", it).add(key) }
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Drag].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .path()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Drag =
+                Drag(
+                    checkRequired("path", path).map { it.toImmutable() },
+                    type,
+                    (keys ?: JsonMissing.of()).map { it.toImmutable() },
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Drag = apply {
+            if (validated) {
+                return@apply
+            }
+
+            path().forEach { it.validate() }
+            _type().let {
+                if (it != JsonValue.from("drag")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            keys()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (path.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                type.let { if (it == JsonValue.from("drag")) 1 else 0 } +
+                (keys.asKnown().getOrNull()?.size ?: 0)
+
+        /** An x/y coordinate pair, e.g. `{ x: 100, y: 200 }`. */
+        class Path
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val x: JsonField<Long>,
+            private val y: JsonField<Long>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("x") @ExcludeMissing x: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("y") @ExcludeMissing y: JsonField<Long> = JsonMissing.of(),
+            ) : this(x, y, mutableMapOf())
+
+            /**
+             * The x-coordinate.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun x(): Long = x.getRequired("x")
+
+            /**
+             * The y-coordinate.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun y(): Long = y.getRequired("y")
+
+            /**
+             * Returns the raw JSON value of [x].
+             *
+             * Unlike [x], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("x") @ExcludeMissing fun _x(): JsonField<Long> = x
+
+            /**
+             * Returns the raw JSON value of [y].
+             *
+             * Unlike [y], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("y") @ExcludeMissing fun _y(): JsonField<Long> = y
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Path].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .x()
+                 * .y()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Path]. */
+            class Builder internal constructor() {
+
+                private var x: JsonField<Long>? = null
+                private var y: JsonField<Long>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(path: Path) = apply {
+                    x = path.x
+                    y = path.y
+                    additionalProperties = path.additionalProperties.toMutableMap()
+                }
+
+                /** The x-coordinate. */
+                fun x(x: Long) = x(JsonField.of(x))
+
+                /**
+                 * Sets [Builder.x] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.x] with a well-typed [Long] value instead. This
+                 * method is primarily for setting the field to an undocumented or not yet supported
+                 * value.
+                 */
+                fun x(x: JsonField<Long>) = apply { this.x = x }
+
+                /** The y-coordinate. */
+                fun y(y: Long) = y(JsonField.of(y))
+
+                /**
+                 * Sets [Builder.y] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.y] with a well-typed [Long] value instead. This
+                 * method is primarily for setting the field to an undocumented or not yet supported
+                 * value.
+                 */
+                fun y(y: JsonField<Long>) = apply { this.y = y }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Path].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .x()
+                 * .y()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Path =
+                    Path(
+                        checkRequired("x", x),
+                        checkRequired("y", y),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Path = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                x()
+                y()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (x.asKnown().isPresent) 1 else 0) + (if (y.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Path &&
+                    x == other.x &&
+                    y == other.y &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(x, y, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() = "Path{x=$x, y=$y, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Drag &&
+                path == other.path &&
+                type == other.type &&
+                keys == other.keys &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(path, type, keys, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Drag{path=$path, type=$type, keys=$keys, additionalProperties=$additionalProperties}"
+    }
+
+    /** A collection of keypresses the model would like to perform. */
+    class Keypress
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val keys: JsonField<List<String>>,
+        private val type: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("keys") @ExcludeMissing keys: JsonField<List<String>> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(keys, type, mutableMapOf())
+
+        /**
+         * The combination of keys the model is requesting to be pressed. This is an array of
+         * strings, each representing a key.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun keys(): List<String> = keys.getRequired("keys")
+
+        /**
+         * Specifies the event type. For a keypress action, this property is always set to
+         * `keypress`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("keypress")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Returns the raw JSON value of [keys].
+         *
+         * Unlike [keys], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("keys") @ExcludeMissing fun _keys(): JsonField<List<String>> = keys
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Keypress].
+             *
+             * The following fields are required:
+             * ```java
+             * .keys()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Keypress]. */
+        class Builder internal constructor() {
+
+            private var keys: JsonField<MutableList<String>>? = null
+            private var type: JsonValue = JsonValue.from("keypress")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(keypress: Keypress) = apply {
+                keys = keypress.keys.map { it.toMutableList() }
+                type = keypress.type
+                additionalProperties = keypress.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * The combination of keys the model is requesting to be pressed. This is an array of
+             * strings, each representing a key.
+             */
+            fun keys(keys: List<String>) = keys(JsonField.of(keys))
+
+            /**
+             * Sets [Builder.keys] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.keys] with a well-typed `List<String>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun keys(keys: JsonField<List<String>>) = apply {
+                this.keys = keys.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [String] to [keys].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addKey(key: String) = apply {
+                keys =
+                    (keys ?: JsonField.of(mutableListOf())).also { checkKnown("keys", it).add(key) }
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("keypress")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Keypress].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .keys()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Keypress =
+                Keypress(
+                    checkRequired("keys", keys).map { it.toImmutable() },
+                    type,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Keypress = apply {
+            if (validated) {
+                return@apply
+            }
+
+            keys()
+            _type().let {
+                if (it != JsonValue.from("keypress")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (keys.asKnown().getOrNull()?.size ?: 0) +
+                type.let { if (it == JsonValue.from("keypress")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Keypress &&
+                keys == other.keys &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(keys, type, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Keypress{keys=$keys, type=$type, additionalProperties=$additionalProperties}"
+    }
+
+    /** A mouse move action. */
+    class Move
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val type: JsonValue,
+        private val x: JsonField<Long>,
+        private val y: JsonField<Long>,
+        private val keys: JsonField<List<String>>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("x") @ExcludeMissing x: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("y") @ExcludeMissing y: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("keys") @ExcludeMissing keys: JsonField<List<String>> = JsonMissing.of(),
+        ) : this(type, x, y, keys, mutableMapOf())
+
+        /**
+         * Specifies the event type. For a move action, this property is always set to `move`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("move")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The x-coordinate to move to.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun x(): Long = x.getRequired("x")
+
+        /**
+         * The y-coordinate to move to.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun y(): Long = y.getRequired("y")
+
+        /**
+         * The keys being held while moving the mouse.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun keys(): Optional<List<String>> = keys.getOptional("keys")
+
+        /**
+         * Returns the raw JSON value of [x].
+         *
+         * Unlike [x], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("x") @ExcludeMissing fun _x(): JsonField<Long> = x
+
+        /**
+         * Returns the raw JSON value of [y].
+         *
+         * Unlike [y], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("y") @ExcludeMissing fun _y(): JsonField<Long> = y
+
+        /**
+         * Returns the raw JSON value of [keys].
+         *
+         * Unlike [keys], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("keys") @ExcludeMissing fun _keys(): JsonField<List<String>> = keys
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Move].
+             *
+             * The following fields are required:
+             * ```java
+             * .x()
+             * .y()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Move]. */
+        class Builder internal constructor() {
+
+            private var type: JsonValue = JsonValue.from("move")
+            private var x: JsonField<Long>? = null
+            private var y: JsonField<Long>? = null
+            private var keys: JsonField<MutableList<String>>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(move: Move) = apply {
+                type = move.type
+                x = move.x
+                y = move.y
+                keys = move.keys.map { it.toMutableList() }
+                additionalProperties = move.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("move")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The x-coordinate to move to. */
+            fun x(x: Long) = x(JsonField.of(x))
+
+            /**
+             * Sets [Builder.x] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.x] with a well-typed [Long] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun x(x: JsonField<Long>) = apply { this.x = x }
+
+            /** The y-coordinate to move to. */
+            fun y(y: Long) = y(JsonField.of(y))
+
+            /**
+             * Sets [Builder.y] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.y] with a well-typed [Long] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun y(y: JsonField<Long>) = apply { this.y = y }
+
+            /** The keys being held while moving the mouse. */
+            fun keys(keys: List<String>?) = keys(JsonField.ofNullable(keys))
+
+            /** Alias for calling [Builder.keys] with `keys.orElse(null)`. */
+            fun keys(keys: Optional<List<String>>) = keys(keys.getOrNull())
+
+            /**
+             * Sets [Builder.keys] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.keys] with a well-typed `List<String>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun keys(keys: JsonField<List<String>>) = apply {
+                this.keys = keys.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [String] to [keys].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addKey(key: String) = apply {
+                keys =
+                    (keys ?: JsonField.of(mutableListOf())).also { checkKnown("keys", it).add(key) }
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Move].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .x()
+             * .y()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Move =
+                Move(
+                    type,
+                    checkRequired("x", x),
+                    checkRequired("y", y),
+                    (keys ?: JsonMissing.of()).map { it.toImmutable() },
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Move = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _type().let {
+                if (it != JsonValue.from("move")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            x()
+            y()
+            keys()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            type.let { if (it == JsonValue.from("move")) 1 else 0 } +
+                (if (x.asKnown().isPresent) 1 else 0) +
+                (if (y.asKnown().isPresent) 1 else 0) +
+                (keys.asKnown().getOrNull()?.size ?: 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Move &&
+                type == other.type &&
+                x == other.x &&
+                y == other.y &&
+                keys == other.keys &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(type, x, y, keys, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Move{type=$type, x=$x, y=$y, keys=$keys, additionalProperties=$additionalProperties}"
+    }
+
+    /** A scroll action. */
+    class Scroll
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val scrollX: JsonField<Long>,
+        private val scrollY: JsonField<Long>,
+        private val type: JsonValue,
+        private val x: JsonField<Long>,
+        private val y: JsonField<Long>,
+        private val keys: JsonField<List<String>>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("scroll_x") @ExcludeMissing scrollX: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("scroll_y") @ExcludeMissing scrollY: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("x") @ExcludeMissing x: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("y") @ExcludeMissing y: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("keys") @ExcludeMissing keys: JsonField<List<String>> = JsonMissing.of(),
+        ) : this(scrollX, scrollY, type, x, y, keys, mutableMapOf())
+
+        /**
+         * The horizontal scroll distance.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun scrollX(): Long = scrollX.getRequired("scroll_x")
+
+        /**
+         * The vertical scroll distance.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun scrollY(): Long = scrollY.getRequired("scroll_y")
+
+        /**
+         * Specifies the event type. For a scroll action, this property is always set to `scroll`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("scroll")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The x-coordinate where the scroll occurred.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun x(): Long = x.getRequired("x")
+
+        /**
+         * The y-coordinate where the scroll occurred.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun y(): Long = y.getRequired("y")
+
+        /**
+         * The keys being held while scrolling.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun keys(): Optional<List<String>> = keys.getOptional("keys")
+
+        /**
+         * Returns the raw JSON value of [scrollX].
+         *
+         * Unlike [scrollX], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("scroll_x") @ExcludeMissing fun _scrollX(): JsonField<Long> = scrollX
+
+        /**
+         * Returns the raw JSON value of [scrollY].
+         *
+         * Unlike [scrollY], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("scroll_y") @ExcludeMissing fun _scrollY(): JsonField<Long> = scrollY
+
+        /**
+         * Returns the raw JSON value of [x].
+         *
+         * Unlike [x], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("x") @ExcludeMissing fun _x(): JsonField<Long> = x
+
+        /**
+         * Returns the raw JSON value of [y].
+         *
+         * Unlike [y], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("y") @ExcludeMissing fun _y(): JsonField<Long> = y
+
+        /**
+         * Returns the raw JSON value of [keys].
+         *
+         * Unlike [keys], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("keys") @ExcludeMissing fun _keys(): JsonField<List<String>> = keys
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Scroll].
+             *
+             * The following fields are required:
+             * ```java
+             * .scrollX()
+             * .scrollY()
+             * .x()
+             * .y()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Scroll]. */
+        class Builder internal constructor() {
+
+            private var scrollX: JsonField<Long>? = null
+            private var scrollY: JsonField<Long>? = null
+            private var type: JsonValue = JsonValue.from("scroll")
+            private var x: JsonField<Long>? = null
+            private var y: JsonField<Long>? = null
+            private var keys: JsonField<MutableList<String>>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(scroll: Scroll) = apply {
+                scrollX = scroll.scrollX
+                scrollY = scroll.scrollY
+                type = scroll.type
+                x = scroll.x
+                y = scroll.y
+                keys = scroll.keys.map { it.toMutableList() }
+                additionalProperties = scroll.additionalProperties.toMutableMap()
+            }
+
+            /** The horizontal scroll distance. */
+            fun scrollX(scrollX: Long) = scrollX(JsonField.of(scrollX))
+
+            /**
+             * Sets [Builder.scrollX] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.scrollX] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun scrollX(scrollX: JsonField<Long>) = apply { this.scrollX = scrollX }
+
+            /** The vertical scroll distance. */
+            fun scrollY(scrollY: Long) = scrollY(JsonField.of(scrollY))
+
+            /**
+             * Sets [Builder.scrollY] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.scrollY] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun scrollY(scrollY: JsonField<Long>) = apply { this.scrollY = scrollY }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("scroll")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The x-coordinate where the scroll occurred. */
+            fun x(x: Long) = x(JsonField.of(x))
+
+            /**
+             * Sets [Builder.x] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.x] with a well-typed [Long] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun x(x: JsonField<Long>) = apply { this.x = x }
+
+            /** The y-coordinate where the scroll occurred. */
+            fun y(y: Long) = y(JsonField.of(y))
+
+            /**
+             * Sets [Builder.y] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.y] with a well-typed [Long] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun y(y: JsonField<Long>) = apply { this.y = y }
+
+            /** The keys being held while scrolling. */
+            fun keys(keys: List<String>?) = keys(JsonField.ofNullable(keys))
+
+            /** Alias for calling [Builder.keys] with `keys.orElse(null)`. */
+            fun keys(keys: Optional<List<String>>) = keys(keys.getOrNull())
+
+            /**
+             * Sets [Builder.keys] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.keys] with a well-typed `List<String>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun keys(keys: JsonField<List<String>>) = apply {
+                this.keys = keys.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [String] to [keys].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addKey(key: String) = apply {
+                keys =
+                    (keys ?: JsonField.of(mutableListOf())).also { checkKnown("keys", it).add(key) }
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Scroll].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .scrollX()
+             * .scrollY()
+             * .x()
+             * .y()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Scroll =
+                Scroll(
+                    checkRequired("scrollX", scrollX),
+                    checkRequired("scrollY", scrollY),
+                    type,
+                    checkRequired("x", x),
+                    checkRequired("y", y),
+                    (keys ?: JsonMissing.of()).map { it.toImmutable() },
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Scroll = apply {
+            if (validated) {
+                return@apply
+            }
+
+            scrollX()
+            scrollY()
+            _type().let {
+                if (it != JsonValue.from("scroll")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            x()
+            y()
+            keys()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (scrollX.asKnown().isPresent) 1 else 0) +
+                (if (scrollY.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("scroll")) 1 else 0 } +
+                (if (x.asKnown().isPresent) 1 else 0) +
+                (if (y.asKnown().isPresent) 1 else 0) +
+                (keys.asKnown().getOrNull()?.size ?: 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Scroll &&
+                scrollX == other.scrollX &&
+                scrollY == other.scrollY &&
+                type == other.type &&
+                x == other.x &&
+                y == other.y &&
+                keys == other.keys &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(scrollX, scrollY, type, x, y, keys, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Scroll{scrollX=$scrollX, scrollY=$scrollY, type=$type, x=$x, y=$y, keys=$keys, additionalProperties=$additionalProperties}"
+    }
+
+    /** An action to type in text. */
+    class Type
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val text: JsonField<String>,
+        private val type: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(text, type, mutableMapOf())
+
+        /**
+         * The text to type.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun text(): String = text.getRequired("text")
+
+        /**
+         * Specifies the event type. For a type action, this property is always set to `type`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("type")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Returns the raw JSON value of [text].
+         *
+         * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Type].
+             *
+             * The following fields are required:
+             * ```java
+             * .text()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Type]. */
+        class Builder internal constructor() {
+
+            private var text: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("type")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(type: Type) = apply {
+                text = type.text
+                this.type = type.type
+                additionalProperties = type.additionalProperties.toMutableMap()
+            }
+
+            /** The text to type. */
+            fun text(text: String) = text(JsonField.of(text))
+
+            /**
+             * Sets [Builder.text] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.text] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun text(text: JsonField<String>) = apply { this.text = text }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("type")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Type].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .text()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Type =
+                Type(checkRequired("text", text), type, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Type = apply {
+            if (validated) {
+                return@apply
+            }
+
+            text()
+            _type().let {
+                if (it != JsonValue.from("type")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (text.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("type")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Type &&
+                text == other.text &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Type{text=$text, type=$type, additionalProperties=$additionalProperties}"
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaComputerTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaComputerTool.kt
new file mode 100644
index 000000000..89e3a50a1
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaComputerTool.kt
@@ -0,0 +1,171 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+
+/**
+ * A tool that controls a virtual computer. Learn more about the
+ * [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+ */
+class BetaComputerTool
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of()
+    ) : this(type, mutableMapOf())
+
+    /**
+     * The type of the computer tool. Always `computer`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("computer")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [BetaComputerTool]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaComputerTool]. */
+    class Builder internal constructor() {
+
+        private var type: JsonValue = JsonValue.from("computer")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaComputerTool: BetaComputerTool) = apply {
+            type = betaComputerTool.type
+            additionalProperties = betaComputerTool.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("computer")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaComputerTool].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): BetaComputerTool = BetaComputerTool(type, additionalProperties.toMutableMap())
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaComputerTool = apply {
+        if (validated) {
+            return@apply
+        }
+
+        _type().let {
+            if (it != JsonValue.from("computer")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int = type.let { if (it == JsonValue.from("computer")) 1 else 0 }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaComputerTool &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(type, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaComputerTool{type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaComputerUsePreviewTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaComputerUsePreviewTool.kt
new file mode 100644
index 000000000..09769f2f8
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaComputerUsePreviewTool.kt
@@ -0,0 +1,477 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * A tool that controls a virtual computer. Learn more about the
+ * [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+ */
+class BetaComputerUsePreviewTool
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val displayHeight: JsonField<Long>,
+    private val displayWidth: JsonField<Long>,
+    private val environment: JsonField<Environment>,
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("display_height")
+        @ExcludeMissing
+        displayHeight: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("display_width")
+        @ExcludeMissing
+        displayWidth: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("environment")
+        @ExcludeMissing
+        environment: JsonField<Environment> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+    ) : this(displayHeight, displayWidth, environment, type, mutableMapOf())
+
+    /**
+     * The height of the computer display.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun displayHeight(): Long = displayHeight.getRequired("display_height")
+
+    /**
+     * The width of the computer display.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun displayWidth(): Long = displayWidth.getRequired("display_width")
+
+    /**
+     * The type of computer environment to control.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun environment(): Environment = environment.getRequired("environment")
+
+    /**
+     * The type of the computer use tool. Always `computer_use_preview`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("computer_use_preview")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Returns the raw JSON value of [displayHeight].
+     *
+     * Unlike [displayHeight], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("display_height")
+    @ExcludeMissing
+    fun _displayHeight(): JsonField<Long> = displayHeight
+
+    /**
+     * Returns the raw JSON value of [displayWidth].
+     *
+     * Unlike [displayWidth], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("display_width")
+    @ExcludeMissing
+    fun _displayWidth(): JsonField<Long> = displayWidth
+
+    /**
+     * Returns the raw JSON value of [environment].
+     *
+     * Unlike [environment], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("environment")
+    @ExcludeMissing
+    fun _environment(): JsonField<Environment> = environment
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaComputerUsePreviewTool].
+         *
+         * The following fields are required:
+         * ```java
+         * .displayHeight()
+         * .displayWidth()
+         * .environment()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaComputerUsePreviewTool]. */
+    class Builder internal constructor() {
+
+        private var displayHeight: JsonField<Long>? = null
+        private var displayWidth: JsonField<Long>? = null
+        private var environment: JsonField<Environment>? = null
+        private var type: JsonValue = JsonValue.from("computer_use_preview")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaComputerUsePreviewTool: BetaComputerUsePreviewTool) = apply {
+            displayHeight = betaComputerUsePreviewTool.displayHeight
+            displayWidth = betaComputerUsePreviewTool.displayWidth
+            environment = betaComputerUsePreviewTool.environment
+            type = betaComputerUsePreviewTool.type
+            additionalProperties = betaComputerUsePreviewTool.additionalProperties.toMutableMap()
+        }
+
+        /** The height of the computer display. */
+        fun displayHeight(displayHeight: Long) = displayHeight(JsonField.of(displayHeight))
+
+        /**
+         * Sets [Builder.displayHeight] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.displayHeight] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun displayHeight(displayHeight: JsonField<Long>) = apply {
+            this.displayHeight = displayHeight
+        }
+
+        /** The width of the computer display. */
+        fun displayWidth(displayWidth: Long) = displayWidth(JsonField.of(displayWidth))
+
+        /**
+         * Sets [Builder.displayWidth] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.displayWidth] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun displayWidth(displayWidth: JsonField<Long>) = apply { this.displayWidth = displayWidth }
+
+        /** The type of computer environment to control. */
+        fun environment(environment: Environment) = environment(JsonField.of(environment))
+
+        /**
+         * Sets [Builder.environment] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.environment] with a well-typed [Environment] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun environment(environment: JsonField<Environment>) = apply {
+            this.environment = environment
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("computer_use_preview")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaComputerUsePreviewTool].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .displayHeight()
+         * .displayWidth()
+         * .environment()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaComputerUsePreviewTool =
+            BetaComputerUsePreviewTool(
+                checkRequired("displayHeight", displayHeight),
+                checkRequired("displayWidth", displayWidth),
+                checkRequired("environment", environment),
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaComputerUsePreviewTool = apply {
+        if (validated) {
+            return@apply
+        }
+
+        displayHeight()
+        displayWidth()
+        environment().validate()
+        _type().let {
+            if (it != JsonValue.from("computer_use_preview")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (displayHeight.asKnown().isPresent) 1 else 0) +
+            (if (displayWidth.asKnown().isPresent) 1 else 0) +
+            (environment.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("computer_use_preview")) 1 else 0 }
+
+    /** The type of computer environment to control. */
+    class Environment @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val WINDOWS = of("windows")
+
+            @JvmField val MAC = of("mac")
+
+            @JvmField val LINUX = of("linux")
+
+            @JvmField val UBUNTU = of("ubuntu")
+
+            @JvmField val BROWSER = of("browser")
+
+            @JvmStatic fun of(value: String) = Environment(JsonField.of(value))
+        }
+
+        /** An enum containing [Environment]'s known values. */
+        enum class Known {
+            WINDOWS,
+            MAC,
+            LINUX,
+            UBUNTU,
+            BROWSER,
+        }
+
+        /**
+         * An enum containing [Environment]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Environment] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            WINDOWS,
+            MAC,
+            LINUX,
+            UBUNTU,
+            BROWSER,
+            /**
+             * An enum member indicating that [Environment] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                WINDOWS -> Value.WINDOWS
+                MAC -> Value.MAC
+                LINUX -> Value.LINUX
+                UBUNTU -> Value.UBUNTU
+                BROWSER -> Value.BROWSER
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                WINDOWS -> Known.WINDOWS
+                MAC -> Known.MAC
+                LINUX -> Known.LINUX
+                UBUNTU -> Known.UBUNTU
+                BROWSER -> Known.BROWSER
+                else -> throw OpenAIInvalidDataException("Unknown Environment: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Environment = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Environment && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaComputerUsePreviewTool &&
+            displayHeight == other.displayHeight &&
+            displayWidth == other.displayWidth &&
+            environment == other.environment &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(displayHeight, displayWidth, environment, type, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaComputerUsePreviewTool{displayHeight=$displayHeight, displayWidth=$displayWidth, environment=$environment, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerAuto.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerAuto.kt
new file mode 100644
index 000000000..caa49994f
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerAuto.kt
@@ -0,0 +1,987 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class BetaContainerAuto
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonValue,
+    private val fileIds: JsonField<List<String>>,
+    private val memoryLimit: JsonField<MemoryLimit>,
+    private val networkPolicy: JsonField<NetworkPolicy>,
+    private val skills: JsonField<List<Skill>>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("file_ids")
+        @ExcludeMissing
+        fileIds: JsonField<List<String>> = JsonMissing.of(),
+        @JsonProperty("memory_limit")
+        @ExcludeMissing
+        memoryLimit: JsonField<MemoryLimit> = JsonMissing.of(),
+        @JsonProperty("network_policy")
+        @ExcludeMissing
+        networkPolicy: JsonField<NetworkPolicy> = JsonMissing.of(),
+        @JsonProperty("skills") @ExcludeMissing skills: JsonField<List<Skill>> = JsonMissing.of(),
+    ) : this(type, fileIds, memoryLimit, networkPolicy, skills, mutableMapOf())
+
+    /**
+     * Automatically creates a container for this request
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("container_auto")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * An optional list of uploaded files to make available to your code.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun fileIds(): Optional<List<String>> = fileIds.getOptional("file_ids")
+
+    /**
+     * The memory limit for the container.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun memoryLimit(): Optional<MemoryLimit> = memoryLimit.getOptional("memory_limit")
+
+    /**
+     * Network access policy for the container.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun networkPolicy(): Optional<NetworkPolicy> = networkPolicy.getOptional("network_policy")
+
+    /**
+     * An optional list of skills referenced by id or inline data.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun skills(): Optional<List<Skill>> = skills.getOptional("skills")
+
+    /**
+     * Returns the raw JSON value of [fileIds].
+     *
+     * Unlike [fileIds], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("file_ids") @ExcludeMissing fun _fileIds(): JsonField<List<String>> = fileIds
+
+    /**
+     * Returns the raw JSON value of [memoryLimit].
+     *
+     * Unlike [memoryLimit], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("memory_limit")
+    @ExcludeMissing
+    fun _memoryLimit(): JsonField<MemoryLimit> = memoryLimit
+
+    /**
+     * Returns the raw JSON value of [networkPolicy].
+     *
+     * Unlike [networkPolicy], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("network_policy")
+    @ExcludeMissing
+    fun _networkPolicy(): JsonField<NetworkPolicy> = networkPolicy
+
+    /**
+     * Returns the raw JSON value of [skills].
+     *
+     * Unlike [skills], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("skills") @ExcludeMissing fun _skills(): JsonField<List<Skill>> = skills
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [BetaContainerAuto]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaContainerAuto]. */
+    class Builder internal constructor() {
+
+        private var type: JsonValue = JsonValue.from("container_auto")
+        private var fileIds: JsonField<MutableList<String>>? = null
+        private var memoryLimit: JsonField<MemoryLimit> = JsonMissing.of()
+        private var networkPolicy: JsonField<NetworkPolicy> = JsonMissing.of()
+        private var skills: JsonField<MutableList<Skill>>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaContainerAuto: BetaContainerAuto) = apply {
+            type = betaContainerAuto.type
+            fileIds = betaContainerAuto.fileIds.map { it.toMutableList() }
+            memoryLimit = betaContainerAuto.memoryLimit
+            networkPolicy = betaContainerAuto.networkPolicy
+            skills = betaContainerAuto.skills.map { it.toMutableList() }
+            additionalProperties = betaContainerAuto.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("container_auto")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** An optional list of uploaded files to make available to your code. */
+        fun fileIds(fileIds: List<String>) = fileIds(JsonField.of(fileIds))
+
+        /**
+         * Sets [Builder.fileIds] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.fileIds] with a well-typed `List<String>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun fileIds(fileIds: JsonField<List<String>>) = apply {
+            this.fileIds = fileIds.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [String] to [fileIds].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addFileId(fileId: String) = apply {
+            fileIds =
+                (fileIds ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("fileIds", it).add(fileId)
+                }
+        }
+
+        /** The memory limit for the container. */
+        fun memoryLimit(memoryLimit: MemoryLimit?) = memoryLimit(JsonField.ofNullable(memoryLimit))
+
+        /** Alias for calling [Builder.memoryLimit] with `memoryLimit.orElse(null)`. */
+        fun memoryLimit(memoryLimit: Optional<MemoryLimit>) = memoryLimit(memoryLimit.getOrNull())
+
+        /**
+         * Sets [Builder.memoryLimit] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.memoryLimit] with a well-typed [MemoryLimit] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun memoryLimit(memoryLimit: JsonField<MemoryLimit>) = apply {
+            this.memoryLimit = memoryLimit
+        }
+
+        /** Network access policy for the container. */
+        fun networkPolicy(networkPolicy: NetworkPolicy) = networkPolicy(JsonField.of(networkPolicy))
+
+        /**
+         * Sets [Builder.networkPolicy] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.networkPolicy] with a well-typed [NetworkPolicy] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun networkPolicy(networkPolicy: JsonField<NetworkPolicy>) = apply {
+            this.networkPolicy = networkPolicy
+        }
+
+        /** Alias for calling [networkPolicy] with `NetworkPolicy.ofDisabled(disabled)`. */
+        fun networkPolicy(disabled: BetaContainerNetworkPolicyDisabled) =
+            networkPolicy(NetworkPolicy.ofDisabled(disabled))
+
+        /** Alias for calling [networkPolicy] with `NetworkPolicy.ofAllowlist(allowlist)`. */
+        fun networkPolicy(allowlist: BetaContainerNetworkPolicyAllowlist) =
+            networkPolicy(NetworkPolicy.ofAllowlist(allowlist))
+
+        /**
+         * Alias for calling [networkPolicy] with the following:
+         * ```java
+         * BetaContainerNetworkPolicyAllowlist.builder()
+         *     .allowedDomains(allowedDomains)
+         *     .build()
+         * ```
+         */
+        fun allowlistNetworkPolicy(allowedDomains: List<String>) =
+            networkPolicy(
+                BetaContainerNetworkPolicyAllowlist.builder().allowedDomains(allowedDomains).build()
+            )
+
+        /** An optional list of skills referenced by id or inline data. */
+        fun skills(skills: List<Skill>) = skills(JsonField.of(skills))
+
+        /**
+         * Sets [Builder.skills] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.skills] with a well-typed `List<Skill>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun skills(skills: JsonField<List<Skill>>) = apply {
+            this.skills = skills.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Skill] to [skills].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addSkill(skill: Skill) = apply {
+            skills =
+                (skills ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("skills", it).add(skill)
+                }
+        }
+
+        /** Alias for calling [addSkill] with `Skill.ofReference(reference)`. */
+        fun addSkill(reference: BetaSkillReference) = addSkill(Skill.ofReference(reference))
+
+        /**
+         * Alias for calling [addSkill] with the following:
+         * ```java
+         * BetaSkillReference.builder()
+         *     .skillId(skillId)
+         *     .build()
+         * ```
+         */
+        fun addReferenceSkill(skillId: String) =
+            addSkill(BetaSkillReference.builder().skillId(skillId).build())
+
+        /** Alias for calling [addSkill] with `Skill.ofInline(inline)`. */
+        fun addSkill(inline: BetaInlineSkill) = addSkill(Skill.ofInline(inline))
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaContainerAuto].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): BetaContainerAuto =
+            BetaContainerAuto(
+                type,
+                (fileIds ?: JsonMissing.of()).map { it.toImmutable() },
+                memoryLimit,
+                networkPolicy,
+                (skills ?: JsonMissing.of()).map { it.toImmutable() },
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaContainerAuto = apply {
+        if (validated) {
+            return@apply
+        }
+
+        _type().let {
+            if (it != JsonValue.from("container_auto")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        fileIds()
+        memoryLimit().ifPresent { it.validate() }
+        networkPolicy().ifPresent { it.validate() }
+        skills().ifPresent { it.forEach { it.validate() } }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        type.let { if (it == JsonValue.from("container_auto")) 1 else 0 } +
+            (fileIds.asKnown().getOrNull()?.size ?: 0) +
+            (memoryLimit.asKnown().getOrNull()?.validity() ?: 0) +
+            (networkPolicy.asKnown().getOrNull()?.validity() ?: 0) +
+            (skills.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+    /** The memory limit for the container. */
+    class MemoryLimit @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val _1G = of("1g")
+
+            @JvmField val _4G = of("4g")
+
+            @JvmField val _16G = of("16g")
+
+            @JvmField val _64G = of("64g")
+
+            @JvmStatic fun of(value: String) = MemoryLimit(JsonField.of(value))
+        }
+
+        /** An enum containing [MemoryLimit]'s known values. */
+        enum class Known {
+            _1G,
+            _4G,
+            _16G,
+            _64G,
+        }
+
+        /**
+         * An enum containing [MemoryLimit]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [MemoryLimit] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            _1G,
+            _4G,
+            _16G,
+            _64G,
+            /**
+             * An enum member indicating that [MemoryLimit] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                _1G -> Value._1G
+                _4G -> Value._4G
+                _16G -> Value._16G
+                _64G -> Value._64G
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                _1G -> Known._1G
+                _4G -> Known._4G
+                _16G -> Known._16G
+                _64G -> Known._64G
+                else -> throw OpenAIInvalidDataException("Unknown MemoryLimit: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): MemoryLimit = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is MemoryLimit && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** Network access policy for the container. */
+    @JsonDeserialize(using = NetworkPolicy.Deserializer::class)
+    @JsonSerialize(using = NetworkPolicy.Serializer::class)
+    class NetworkPolicy
+    private constructor(
+        private val disabled: BetaContainerNetworkPolicyDisabled? = null,
+        private val allowlist: BetaContainerNetworkPolicyAllowlist? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun disabled(): Optional<BetaContainerNetworkPolicyDisabled> = Optional.ofNullable(disabled)
+
+        fun allowlist(): Optional<BetaContainerNetworkPolicyAllowlist> =
+            Optional.ofNullable(allowlist)
+
+        fun isDisabled(): Boolean = disabled != null
+
+        fun isAllowlist(): Boolean = allowlist != null
+
+        fun asDisabled(): BetaContainerNetworkPolicyDisabled = disabled.getOrThrow("disabled")
+
+        fun asAllowlist(): BetaContainerNetworkPolicyAllowlist = allowlist.getOrThrow("allowlist")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = networkPolicy.accept(new NetworkPolicy.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDisabled(BetaContainerNetworkPolicyDisabled disabled) {
+         *         return Optional.of(disabled.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                disabled != null -> visitor.visitDisabled(disabled)
+                allowlist != null -> visitor.visitAllowlist(allowlist)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): NetworkPolicy = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDisabled(disabled: BetaContainerNetworkPolicyDisabled) {
+                        disabled.validate()
+                    }
+
+                    override fun visitAllowlist(allowlist: BetaContainerNetworkPolicyAllowlist) {
+                        allowlist.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDisabled(disabled: BetaContainerNetworkPolicyDisabled) =
+                        disabled.validity()
+
+                    override fun visitAllowlist(allowlist: BetaContainerNetworkPolicyAllowlist) =
+                        allowlist.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is NetworkPolicy &&
+                disabled == other.disabled &&
+                allowlist == other.allowlist
+        }
+
+        override fun hashCode(): Int = Objects.hash(disabled, allowlist)
+
+        override fun toString(): String =
+            when {
+                disabled != null -> "NetworkPolicy{disabled=$disabled}"
+                allowlist != null -> "NetworkPolicy{allowlist=$allowlist}"
+                _json != null -> "NetworkPolicy{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid NetworkPolicy")
+            }
+
+        companion object {
+
+            @JvmStatic
+            fun ofDisabled(disabled: BetaContainerNetworkPolicyDisabled) =
+                NetworkPolicy(disabled = disabled)
+
+            @JvmStatic
+            fun ofAllowlist(allowlist: BetaContainerNetworkPolicyAllowlist) =
+                NetworkPolicy(allowlist = allowlist)
+        }
+
+        /**
+         * An interface that defines how to map each variant of [NetworkPolicy] to a value of type
+         * [T].
+         */
+        interface Visitor<out T> {
+
+            fun visitDisabled(disabled: BetaContainerNetworkPolicyDisabled): T
+
+            fun visitAllowlist(allowlist: BetaContainerNetworkPolicyAllowlist): T
+
+            /**
+             * Maps an unknown variant of [NetworkPolicy] to a value of type [T].
+             *
+             * An instance of [NetworkPolicy] can contain an unknown variant if it was deserialized
+             * from data that doesn't match any known variant. For example, if the SDK is on an
+             * older version than the API, then the API may respond with new variants that the SDK
+             * is unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown NetworkPolicy: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<NetworkPolicy>(NetworkPolicy::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): NetworkPolicy {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "disabled" -> {
+                        return tryDeserialize(
+                                node,
+                                jacksonTypeRef<BetaContainerNetworkPolicyDisabled>(),
+                            )
+                            ?.let { NetworkPolicy(disabled = it, _json = json) }
+                            ?: NetworkPolicy(_json = json)
+                    }
+                    "allowlist" -> {
+                        return tryDeserialize(
+                                node,
+                                jacksonTypeRef<BetaContainerNetworkPolicyAllowlist>(),
+                            )
+                            ?.let { NetworkPolicy(allowlist = it, _json = json) }
+                            ?: NetworkPolicy(_json = json)
+                    }
+                }
+
+                return NetworkPolicy(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<NetworkPolicy>(NetworkPolicy::class) {
+
+            override fun serialize(
+                value: NetworkPolicy,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.disabled != null -> generator.writeObject(value.disabled)
+                    value.allowlist != null -> generator.writeObject(value.allowlist)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid NetworkPolicy")
+                }
+            }
+        }
+    }
+
+    @JsonDeserialize(using = Skill.Deserializer::class)
+    @JsonSerialize(using = Skill.Serializer::class)
+    class Skill
+    private constructor(
+        private val reference: BetaSkillReference? = null,
+        private val inline: BetaInlineSkill? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun reference(): Optional<BetaSkillReference> = Optional.ofNullable(reference)
+
+        fun inline(): Optional<BetaInlineSkill> = Optional.ofNullable(inline)
+
+        fun isReference(): Boolean = reference != null
+
+        fun isInline(): Boolean = inline != null
+
+        fun asReference(): BetaSkillReference = reference.getOrThrow("reference")
+
+        fun asInline(): BetaInlineSkill = inline.getOrThrow("inline")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = skill.accept(new Skill.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitReference(BetaSkillReference reference) {
+         *         return Optional.of(reference.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                reference != null -> visitor.visitReference(reference)
+                inline != null -> visitor.visitInline(inline)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Skill = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitReference(reference: BetaSkillReference) {
+                        reference.validate()
+                    }
+
+                    override fun visitInline(inline: BetaInlineSkill) {
+                        inline.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitReference(reference: BetaSkillReference) =
+                        reference.validity()
+
+                    override fun visitInline(inline: BetaInlineSkill) = inline.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Skill && reference == other.reference && inline == other.inline
+        }
+
+        override fun hashCode(): Int = Objects.hash(reference, inline)
+
+        override fun toString(): String =
+            when {
+                reference != null -> "Skill{reference=$reference}"
+                inline != null -> "Skill{inline=$inline}"
+                _json != null -> "Skill{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Skill")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofReference(reference: BetaSkillReference) = Skill(reference = reference)
+
+            @JvmStatic fun ofInline(inline: BetaInlineSkill) = Skill(inline = inline)
+        }
+
+        /** An interface that defines how to map each variant of [Skill] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitReference(reference: BetaSkillReference): T
+
+            fun visitInline(inline: BetaInlineSkill): T
+
+            /**
+             * Maps an unknown variant of [Skill] to a value of type [T].
+             *
+             * An instance of [Skill] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Skill: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Skill>(Skill::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Skill {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "skill_reference" -> {
+                        return tryDeserialize(node, jacksonTypeRef<BetaSkillReference>())?.let {
+                            Skill(reference = it, _json = json)
+                        } ?: Skill(_json = json)
+                    }
+                    "inline" -> {
+                        return tryDeserialize(node, jacksonTypeRef<BetaInlineSkill>())?.let {
+                            Skill(inline = it, _json = json)
+                        } ?: Skill(_json = json)
+                    }
+                }
+
+                return Skill(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Skill>(Skill::class) {
+
+            override fun serialize(
+                value: Skill,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.reference != null -> generator.writeObject(value.reference)
+                    value.inline != null -> generator.writeObject(value.inline)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Skill")
+                }
+            }
+        }
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaContainerAuto &&
+            type == other.type &&
+            fileIds == other.fileIds &&
+            memoryLimit == other.memoryLimit &&
+            networkPolicy == other.networkPolicy &&
+            skills == other.skills &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(type, fileIds, memoryLimit, networkPolicy, skills, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaContainerAuto{type=$type, fileIds=$fileIds, memoryLimit=$memoryLimit, networkPolicy=$networkPolicy, skills=$skills, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyAllowlist.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyAllowlist.kt
new file mode 100644
index 000000000..60cc1b8f9
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyAllowlist.kt
@@ -0,0 +1,311 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class BetaContainerNetworkPolicyAllowlist
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val allowedDomains: JsonField<List<String>>,
+    private val type: JsonValue,
+    private val domainSecrets: JsonField<List<BetaContainerNetworkPolicyDomainSecret>>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("allowed_domains")
+        @ExcludeMissing
+        allowedDomains: JsonField<List<String>> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("domain_secrets")
+        @ExcludeMissing
+        domainSecrets: JsonField<List<BetaContainerNetworkPolicyDomainSecret>> = JsonMissing.of(),
+    ) : this(allowedDomains, type, domainSecrets, mutableMapOf())
+
+    /**
+     * A list of allowed domains when type is `allowlist`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun allowedDomains(): List<String> = allowedDomains.getRequired("allowed_domains")
+
+    /**
+     * Allow outbound network access only to specified domains. Always `allowlist`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("allowlist")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Optional domain-scoped secrets for allowlisted domains.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun domainSecrets(): Optional<List<BetaContainerNetworkPolicyDomainSecret>> =
+        domainSecrets.getOptional("domain_secrets")
+
+    /**
+     * Returns the raw JSON value of [allowedDomains].
+     *
+     * Unlike [allowedDomains], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("allowed_domains")
+    @ExcludeMissing
+    fun _allowedDomains(): JsonField<List<String>> = allowedDomains
+
+    /**
+     * Returns the raw JSON value of [domainSecrets].
+     *
+     * Unlike [domainSecrets], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("domain_secrets")
+    @ExcludeMissing
+    fun _domainSecrets(): JsonField<List<BetaContainerNetworkPolicyDomainSecret>> = domainSecrets
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaContainerNetworkPolicyAllowlist].
+         *
+         * The following fields are required:
+         * ```java
+         * .allowedDomains()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaContainerNetworkPolicyAllowlist]. */
+    class Builder internal constructor() {
+
+        private var allowedDomains: JsonField<MutableList<String>>? = null
+        private var type: JsonValue = JsonValue.from("allowlist")
+        private var domainSecrets: JsonField<MutableList<BetaContainerNetworkPolicyDomainSecret>>? =
+            null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaContainerNetworkPolicyAllowlist: BetaContainerNetworkPolicyAllowlist
+        ) = apply {
+            allowedDomains =
+                betaContainerNetworkPolicyAllowlist.allowedDomains.map { it.toMutableList() }
+            type = betaContainerNetworkPolicyAllowlist.type
+            domainSecrets =
+                betaContainerNetworkPolicyAllowlist.domainSecrets.map { it.toMutableList() }
+            additionalProperties =
+                betaContainerNetworkPolicyAllowlist.additionalProperties.toMutableMap()
+        }
+
+        /** A list of allowed domains when type is `allowlist`. */
+        fun allowedDomains(allowedDomains: List<String>) =
+            allowedDomains(JsonField.of(allowedDomains))
+
+        /**
+         * Sets [Builder.allowedDomains] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.allowedDomains] with a well-typed `List<String>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun allowedDomains(allowedDomains: JsonField<List<String>>) = apply {
+            this.allowedDomains = allowedDomains.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [String] to [allowedDomains].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addAllowedDomain(allowedDomain: String) = apply {
+            allowedDomains =
+                (allowedDomains ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("allowedDomains", it).add(allowedDomain)
+                }
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("allowlist")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** Optional domain-scoped secrets for allowlisted domains. */
+        fun domainSecrets(domainSecrets: List<BetaContainerNetworkPolicyDomainSecret>) =
+            domainSecrets(JsonField.of(domainSecrets))
+
+        /**
+         * Sets [Builder.domainSecrets] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.domainSecrets] with a well-typed
+         * `List<BetaContainerNetworkPolicyDomainSecret>` value instead. This method is primarily
+         * for setting the field to an undocumented or not yet supported value.
+         */
+        fun domainSecrets(domainSecrets: JsonField<List<BetaContainerNetworkPolicyDomainSecret>>) =
+            apply {
+                this.domainSecrets = domainSecrets.map { it.toMutableList() }
+            }
+
+        /**
+         * Adds a single [BetaContainerNetworkPolicyDomainSecret] to [domainSecrets].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addDomainSecret(domainSecret: BetaContainerNetworkPolicyDomainSecret) = apply {
+            domainSecrets =
+                (domainSecrets ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("domainSecrets", it).add(domainSecret)
+                }
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaContainerNetworkPolicyAllowlist].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .allowedDomains()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaContainerNetworkPolicyAllowlist =
+            BetaContainerNetworkPolicyAllowlist(
+                checkRequired("allowedDomains", allowedDomains).map { it.toImmutable() },
+                type,
+                (domainSecrets ?: JsonMissing.of()).map { it.toImmutable() },
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaContainerNetworkPolicyAllowlist = apply {
+        if (validated) {
+            return@apply
+        }
+
+        allowedDomains()
+        _type().let {
+            if (it != JsonValue.from("allowlist")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        domainSecrets().ifPresent { it.forEach { it.validate() } }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (allowedDomains.asKnown().getOrNull()?.size ?: 0) +
+            type.let { if (it == JsonValue.from("allowlist")) 1 else 0 } +
+            (domainSecrets.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaContainerNetworkPolicyAllowlist &&
+            allowedDomains == other.allowedDomains &&
+            type == other.type &&
+            domainSecrets == other.domainSecrets &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(allowedDomains, type, domainSecrets, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaContainerNetworkPolicyAllowlist{allowedDomains=$allowedDomains, type=$type, domainSecrets=$domainSecrets, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyDisabled.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyDisabled.kt
new file mode 100644
index 000000000..19457c623
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyDisabled.kt
@@ -0,0 +1,173 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+
+class BetaContainerNetworkPolicyDisabled
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of()
+    ) : this(type, mutableMapOf())
+
+    /**
+     * Disable outbound network access. Always `disabled`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("disabled")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaContainerNetworkPolicyDisabled].
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaContainerNetworkPolicyDisabled]. */
+    class Builder internal constructor() {
+
+        private var type: JsonValue = JsonValue.from("disabled")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaContainerNetworkPolicyDisabled: BetaContainerNetworkPolicyDisabled) =
+            apply {
+                type = betaContainerNetworkPolicyDisabled.type
+                additionalProperties =
+                    betaContainerNetworkPolicyDisabled.additionalProperties.toMutableMap()
+            }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("disabled")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaContainerNetworkPolicyDisabled].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): BetaContainerNetworkPolicyDisabled =
+            BetaContainerNetworkPolicyDisabled(type, additionalProperties.toMutableMap())
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaContainerNetworkPolicyDisabled = apply {
+        if (validated) {
+            return@apply
+        }
+
+        _type().let {
+            if (it != JsonValue.from("disabled")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int = type.let { if (it == JsonValue.from("disabled")) 1 else 0 }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaContainerNetworkPolicyDisabled &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(type, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaContainerNetworkPolicyDisabled{type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyDomainSecret.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyDomainSecret.kt
new file mode 100644
index 000000000..539a1e63d
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyDomainSecret.kt
@@ -0,0 +1,259 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+
+class BetaContainerNetworkPolicyDomainSecret
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val domain: JsonField<String>,
+    private val name: JsonField<String>,
+    private val value: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("domain") @ExcludeMissing domain: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("value") @ExcludeMissing value: JsonField<String> = JsonMissing.of(),
+    ) : this(domain, name, value, mutableMapOf())
+
+    /**
+     * The domain associated with the secret.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun domain(): String = domain.getRequired("domain")
+
+    /**
+     * The name of the secret to inject for the domain.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun name(): String = name.getRequired("name")
+
+    /**
+     * The secret value to inject for the domain.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun value(): String = value.getRequired("value")
+
+    /**
+     * Returns the raw JSON value of [domain].
+     *
+     * Unlike [domain], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("domain") @ExcludeMissing fun _domain(): JsonField<String> = domain
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    /**
+     * Returns the raw JSON value of [value].
+     *
+     * Unlike [value], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("value") @ExcludeMissing fun _value(): JsonField<String> = value
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaContainerNetworkPolicyDomainSecret].
+         *
+         * The following fields are required:
+         * ```java
+         * .domain()
+         * .name()
+         * .value()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaContainerNetworkPolicyDomainSecret]. */
+    class Builder internal constructor() {
+
+        private var domain: JsonField<String>? = null
+        private var name: JsonField<String>? = null
+        private var value: JsonField<String>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaContainerNetworkPolicyDomainSecret: BetaContainerNetworkPolicyDomainSecret
+        ) = apply {
+            domain = betaContainerNetworkPolicyDomainSecret.domain
+            name = betaContainerNetworkPolicyDomainSecret.name
+            value = betaContainerNetworkPolicyDomainSecret.value
+            additionalProperties =
+                betaContainerNetworkPolicyDomainSecret.additionalProperties.toMutableMap()
+        }
+
+        /** The domain associated with the secret. */
+        fun domain(domain: String) = domain(JsonField.of(domain))
+
+        /**
+         * Sets [Builder.domain] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.domain] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun domain(domain: JsonField<String>) = apply { this.domain = domain }
+
+        /** The name of the secret to inject for the domain. */
+        fun name(name: String) = name(JsonField.of(name))
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        /** The secret value to inject for the domain. */
+        fun value(value: String) = value(JsonField.of(value))
+
+        /**
+         * Sets [Builder.value] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.value] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun value(value: JsonField<String>) = apply { this.value = value }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaContainerNetworkPolicyDomainSecret].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .domain()
+         * .name()
+         * .value()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaContainerNetworkPolicyDomainSecret =
+            BetaContainerNetworkPolicyDomainSecret(
+                checkRequired("domain", domain),
+                checkRequired("name", name),
+                checkRequired("value", value),
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaContainerNetworkPolicyDomainSecret = apply {
+        if (validated) {
+            return@apply
+        }
+
+        domain()
+        name()
+        value()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (domain.asKnown().isPresent) 1 else 0) +
+            (if (name.asKnown().isPresent) 1 else 0) +
+            (if (value.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaContainerNetworkPolicyDomainSecret &&
+            domain == other.domain &&
+            name == other.name &&
+            value == other.value &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(domain, name, value, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaContainerNetworkPolicyDomainSecret{domain=$domain, name=$name, value=$value, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerReference.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerReference.kt
new file mode 100644
index 000000000..4c7c07f39
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaContainerReference.kt
@@ -0,0 +1,227 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+
+class BetaContainerReference
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val containerId: JsonField<String>,
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("container_id")
+        @ExcludeMissing
+        containerId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+    ) : this(containerId, type, mutableMapOf())
+
+    /**
+     * The ID of the referenced container.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun containerId(): String = containerId.getRequired("container_id")
+
+    /**
+     * References a container created with the /v1/containers endpoint
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("container_reference")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Returns the raw JSON value of [containerId].
+     *
+     * Unlike [containerId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("container_id")
+    @ExcludeMissing
+    fun _containerId(): JsonField<String> = containerId
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaContainerReference].
+         *
+         * The following fields are required:
+         * ```java
+         * .containerId()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaContainerReference]. */
+    class Builder internal constructor() {
+
+        private var containerId: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("container_reference")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaContainerReference: BetaContainerReference) = apply {
+            containerId = betaContainerReference.containerId
+            type = betaContainerReference.type
+            additionalProperties = betaContainerReference.additionalProperties.toMutableMap()
+        }
+
+        /** The ID of the referenced container. */
+        fun containerId(containerId: String) = containerId(JsonField.of(containerId))
+
+        /**
+         * Sets [Builder.containerId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.containerId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun containerId(containerId: JsonField<String>) = apply { this.containerId = containerId }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("container_reference")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaContainerReference].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .containerId()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaContainerReference =
+            BetaContainerReference(
+                checkRequired("containerId", containerId),
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaContainerReference = apply {
+        if (validated) {
+            return@apply
+        }
+
+        containerId()
+        _type().let {
+            if (it != JsonValue.from("container_reference")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (containerId.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("container_reference")) 1 else 0 }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaContainerReference &&
+            containerId == other.containerId &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(containerId, type, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaContainerReference{containerId=$containerId, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaCustomTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaCustomTool.kt
new file mode 100644
index 000000000..6cb3dd1af
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaCustomTool.kt
@@ -0,0 +1,1188 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * A custom tool that processes input using a specified format. Learn more about
+ * [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
+ */
+class BetaCustomTool
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val name: JsonField<String>,
+    private val type: JsonValue,
+    private val allowedCallers: JsonField<List<AllowedCaller>>,
+    private val deferLoading: JsonField<Boolean>,
+    private val description: JsonField<String>,
+    private val format: JsonField<Format>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("allowed_callers")
+        @ExcludeMissing
+        allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
+        @JsonProperty("defer_loading")
+        @ExcludeMissing
+        deferLoading: JsonField<Boolean> = JsonMissing.of(),
+        @JsonProperty("description")
+        @ExcludeMissing
+        description: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("format") @ExcludeMissing format: JsonField<Format> = JsonMissing.of(),
+    ) : this(name, type, allowedCallers, deferLoading, description, format, mutableMapOf())
+
+    /**
+     * The name of the custom tool, used to identify it in tool calls.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun name(): String = name.getRequired("name")
+
+    /**
+     * The type of the custom tool. Always `custom`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("custom")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The tool invocation context(s).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun allowedCallers(): Optional<List<AllowedCaller>> =
+        allowedCallers.getOptional("allowed_callers")
+
+    /**
+     * Whether this tool should be deferred and discovered via tool search.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun deferLoading(): Optional<Boolean> = deferLoading.getOptional("defer_loading")
+
+    /**
+     * Optional description of the custom tool, used to provide more context.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun description(): Optional<String> = description.getOptional("description")
+
+    /**
+     * The input format for the custom tool. Default is unconstrained text.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun format(): Optional<Format> = format.getOptional("format")
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    /**
+     * Returns the raw JSON value of [allowedCallers].
+     *
+     * Unlike [allowedCallers], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("allowed_callers")
+    @ExcludeMissing
+    fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
+    /**
+     * Returns the raw JSON value of [deferLoading].
+     *
+     * Unlike [deferLoading], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("defer_loading")
+    @ExcludeMissing
+    fun _deferLoading(): JsonField<Boolean> = deferLoading
+
+    /**
+     * Returns the raw JSON value of [description].
+     *
+     * Unlike [description], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("description") @ExcludeMissing fun _description(): JsonField<String> = description
+
+    /**
+     * Returns the raw JSON value of [format].
+     *
+     * Unlike [format], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("format") @ExcludeMissing fun _format(): JsonField<Format> = format
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaCustomTool].
+         *
+         * The following fields are required:
+         * ```java
+         * .name()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaCustomTool]. */
+    class Builder internal constructor() {
+
+        private var name: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("custom")
+        private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
+        private var deferLoading: JsonField<Boolean> = JsonMissing.of()
+        private var description: JsonField<String> = JsonMissing.of()
+        private var format: JsonField<Format> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaCustomTool: BetaCustomTool) = apply {
+            name = betaCustomTool.name
+            type = betaCustomTool.type
+            allowedCallers = betaCustomTool.allowedCallers.map { it.toMutableList() }
+            deferLoading = betaCustomTool.deferLoading
+            description = betaCustomTool.description
+            format = betaCustomTool.format
+            additionalProperties = betaCustomTool.additionalProperties.toMutableMap()
+        }
+
+        /** The name of the custom tool, used to identify it in tool calls. */
+        fun name(name: String) = name(JsonField.of(name))
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("custom")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The tool invocation context(s). */
+        fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+            allowedCallers(JsonField.ofNullable(allowedCallers))
+
+        /** Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`. */
+        fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+            allowedCallers(allowedCallers.getOrNull())
+
+        /**
+         * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.allowedCallers] with a well-typed `List<AllowedCaller>`
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+            this.allowedCallers = allowedCallers.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [AllowedCaller] to [allowedCallers].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+            allowedCallers =
+                (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("allowedCallers", it).add(allowedCaller)
+                }
+        }
+
+        /** Whether this tool should be deferred and discovered via tool search. */
+        fun deferLoading(deferLoading: Boolean) = deferLoading(JsonField.of(deferLoading))
+
+        /**
+         * Sets [Builder.deferLoading] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.deferLoading] with a well-typed [Boolean] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun deferLoading(deferLoading: JsonField<Boolean>) = apply {
+            this.deferLoading = deferLoading
+        }
+
+        /** Optional description of the custom tool, used to provide more context. */
+        fun description(description: String) = description(JsonField.of(description))
+
+        /**
+         * Sets [Builder.description] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.description] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun description(description: JsonField<String>) = apply { this.description = description }
+
+        /** The input format for the custom tool. Default is unconstrained text. */
+        fun format(format: Format) = format(JsonField.of(format))
+
+        /**
+         * Sets [Builder.format] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.format] with a well-typed [Format] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun format(format: JsonField<Format>) = apply { this.format = format }
+
+        /** Alias for calling [format] with `Format.ofText()`. */
+        fun formatText() = format(Format.ofText())
+
+        /** Alias for calling [format] with `Format.ofGrammar(grammar)`. */
+        fun format(grammar: Format.Grammar) = format(Format.ofGrammar(grammar))
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaCustomTool].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .name()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaCustomTool =
+            BetaCustomTool(
+                checkRequired("name", name),
+                type,
+                (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
+                deferLoading,
+                description,
+                format,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaCustomTool = apply {
+        if (validated) {
+            return@apply
+        }
+
+        name()
+        _type().let {
+            if (it != JsonValue.from("custom")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        allowedCallers().ifPresent { it.forEach { it.validate() } }
+        deferLoading()
+        description()
+        format().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (name.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("custom")) 1 else 0 } +
+            (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (if (deferLoading.asKnown().isPresent) 1 else 0) +
+            (if (description.asKnown().isPresent) 1 else 0) +
+            (format.asKnown().getOrNull()?.validity() ?: 0)
+
+    class AllowedCaller @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val DIRECT = of("direct")
+
+            @JvmField val PROGRAMMATIC = of("programmatic")
+
+            @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+        }
+
+        /** An enum containing [AllowedCaller]'s known values. */
+        enum class Known {
+            DIRECT,
+            PROGRAMMATIC,
+        }
+
+        /**
+         * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            DIRECT,
+            PROGRAMMATIC,
+            /**
+             * An enum member indicating that [AllowedCaller] was instantiated with an unknown
+             * value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                DIRECT -> Value.DIRECT
+                PROGRAMMATIC -> Value.PROGRAMMATIC
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                DIRECT -> Known.DIRECT
+                PROGRAMMATIC -> Known.PROGRAMMATIC
+                else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): AllowedCaller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AllowedCaller && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The input format for the custom tool. Default is unconstrained text. */
+    @JsonDeserialize(using = Format.Deserializer::class)
+    @JsonSerialize(using = Format.Serializer::class)
+    class Format
+    private constructor(
+        private val text: JsonValue? = null,
+        private val grammar: Grammar? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** Unconstrained free-form text. */
+        fun text(): Optional<JsonValue> = Optional.ofNullable(text)
+
+        /** A grammar defined by the user. */
+        fun grammar(): Optional<Grammar> = Optional.ofNullable(grammar)
+
+        fun isText(): Boolean = text != null
+
+        fun isGrammar(): Boolean = grammar != null
+
+        /** Unconstrained free-form text. */
+        fun asText(): JsonValue = text.getOrThrow("text")
+
+        /** A grammar defined by the user. */
+        fun asGrammar(): Grammar = grammar.getOrThrow("grammar")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = format.accept(new Format.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitText(JsonValue text) {
+         *         return Optional.of(text.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                text != null -> visitor.visitText(text)
+                grammar != null -> visitor.visitGrammar(grammar)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Format = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitText(text: JsonValue) {
+                        text.let {
+                            if (it != JsonValue.from(mapOf("type" to "text"))) {
+                                throw OpenAIInvalidDataException("'text' is invalid, received $it")
+                            }
+                        }
+                    }
+
+                    override fun visitGrammar(grammar: Grammar) {
+                        grammar.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitText(text: JsonValue) =
+                        text.let { if (it == JsonValue.from(mapOf("type" to "text"))) 1 else 0 }
+
+                    override fun visitGrammar(grammar: Grammar) = grammar.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Format && text == other.text && grammar == other.grammar
+        }
+
+        override fun hashCode(): Int = Objects.hash(text, grammar)
+
+        override fun toString(): String =
+            when {
+                text != null -> "Format{text=$text}"
+                grammar != null -> "Format{grammar=$grammar}"
+                _json != null -> "Format{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Format")
+            }
+
+        companion object {
+
+            /** Unconstrained free-form text. */
+            @JvmStatic fun ofText() = Format(text = JsonValue.from(mapOf("type" to "text")))
+
+            /** A grammar defined by the user. */
+            @JvmStatic fun ofGrammar(grammar: Grammar) = Format(grammar = grammar)
+        }
+
+        /** An interface that defines how to map each variant of [Format] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            /** Unconstrained free-form text. */
+            fun visitText(text: JsonValue): T
+
+            /** A grammar defined by the user. */
+            fun visitGrammar(grammar: Grammar): T
+
+            /**
+             * Maps an unknown variant of [Format] to a value of type [T].
+             *
+             * An instance of [Format] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Format: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Format>(Format::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Format {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "text" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Format(text = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Format(_json = json)
+                    }
+                    "grammar" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Grammar>())?.let {
+                            Format(grammar = it, _json = json)
+                        } ?: Format(_json = json)
+                    }
+                }
+
+                return Format(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Format>(Format::class) {
+
+            override fun serialize(
+                value: Format,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.text != null -> generator.writeObject(value.text)
+                    value.grammar != null -> generator.writeObject(value.grammar)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Format")
+                }
+            }
+        }
+
+        /** A grammar defined by the user. */
+        class Grammar
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val definition: JsonField<String>,
+            private val syntax: JsonField<Syntax>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("definition")
+                @ExcludeMissing
+                definition: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("syntax")
+                @ExcludeMissing
+                syntax: JsonField<Syntax> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(definition, syntax, type, mutableMapOf())
+
+            /**
+             * The grammar definition.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun definition(): String = definition.getRequired("definition")
+
+            /**
+             * The syntax of the grammar definition. One of `lark` or `regex`.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun syntax(): Syntax = syntax.getRequired("syntax")
+
+            /**
+             * Grammar format. Always `grammar`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("grammar")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [definition].
+             *
+             * Unlike [definition], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("definition")
+            @ExcludeMissing
+            fun _definition(): JsonField<String> = definition
+
+            /**
+             * Returns the raw JSON value of [syntax].
+             *
+             * Unlike [syntax], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("syntax") @ExcludeMissing fun _syntax(): JsonField<Syntax> = syntax
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Grammar].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .definition()
+                 * .syntax()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Grammar]. */
+            class Builder internal constructor() {
+
+                private var definition: JsonField<String>? = null
+                private var syntax: JsonField<Syntax>? = null
+                private var type: JsonValue = JsonValue.from("grammar")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(grammar: Grammar) = apply {
+                    definition = grammar.definition
+                    syntax = grammar.syntax
+                    type = grammar.type
+                    additionalProperties = grammar.additionalProperties.toMutableMap()
+                }
+
+                /** The grammar definition. */
+                fun definition(definition: String) = definition(JsonField.of(definition))
+
+                /**
+                 * Sets [Builder.definition] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.definition] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun definition(definition: JsonField<String>) = apply {
+                    this.definition = definition
+                }
+
+                /** The syntax of the grammar definition. One of `lark` or `regex`. */
+                fun syntax(syntax: Syntax) = syntax(JsonField.of(syntax))
+
+                /**
+                 * Sets [Builder.syntax] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.syntax] with a well-typed [Syntax] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun syntax(syntax: JsonField<Syntax>) = apply { this.syntax = syntax }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("grammar")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Grammar].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .definition()
+                 * .syntax()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Grammar =
+                    Grammar(
+                        checkRequired("definition", definition),
+                        checkRequired("syntax", syntax),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Grammar = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                definition()
+                syntax().validate()
+                _type().let {
+                    if (it != JsonValue.from("grammar")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (definition.asKnown().isPresent) 1 else 0) +
+                    (syntax.asKnown().getOrNull()?.validity() ?: 0) +
+                    type.let { if (it == JsonValue.from("grammar")) 1 else 0 }
+
+            /** The syntax of the grammar definition. One of `lark` or `regex`. */
+            class Syntax @JsonCreator private constructor(private val value: JsonField<String>) :
+                Enum {
+
+                /**
+                 * Returns this class instance's raw value.
+                 *
+                 * This is usually only useful if this instance was deserialized from data that
+                 * doesn't match any known member, and you want to know that value. For example, if
+                 * the SDK is on an older version than the API, then the API may respond with new
+                 * members that the SDK is unaware of.
+                 */
+                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+                companion object {
+
+                    @JvmField val LARK = of("lark")
+
+                    @JvmField val REGEX = of("regex")
+
+                    @JvmStatic fun of(value: String) = Syntax(JsonField.of(value))
+                }
+
+                /** An enum containing [Syntax]'s known values. */
+                enum class Known {
+                    LARK,
+                    REGEX,
+                }
+
+                /**
+                 * An enum containing [Syntax]'s known values, as well as an [_UNKNOWN] member.
+                 *
+                 * An instance of [Syntax] can contain an unknown value in a couple of cases:
+                 * - It was deserialized from data that doesn't match any known member. For example,
+                 *   if the SDK is on an older version than the API, then the API may respond with
+                 *   new members that the SDK is unaware of.
+                 * - It was constructed with an arbitrary value using the [of] method.
+                 */
+                enum class Value {
+                    LARK,
+                    REGEX,
+                    /**
+                     * An enum member indicating that [Syntax] was instantiated with an unknown
+                     * value.
+                     */
+                    _UNKNOWN,
+                }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value, or
+                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                 *
+                 * Use the [known] method instead if you're certain the value is always known or if
+                 * you want to throw for the unknown case.
+                 */
+                fun value(): Value =
+                    when (this) {
+                        LARK -> Value.LARK
+                        REGEX -> Value.REGEX
+                        else -> Value._UNKNOWN
+                    }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value.
+                 *
+                 * Use the [value] method instead if you're uncertain the value is always known and
+                 * don't want to throw for the unknown case.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                 *   known member.
+                 */
+                fun known(): Known =
+                    when (this) {
+                        LARK -> Known.LARK
+                        REGEX -> Known.REGEX
+                        else -> throw OpenAIInvalidDataException("Unknown Syntax: $value")
+                    }
+
+                /**
+                 * Returns this class instance's primitive wire representation.
+                 *
+                 * This differs from the [toString] method because that method is primarily for
+                 * debugging and generally doesn't throw.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value does not have
+                 *   the expected primitive type.
+                 */
+                fun asString(): String =
+                    _value().asString().orElseThrow {
+                        OpenAIInvalidDataException("Value is not a String")
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Syntax = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    known()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Syntax && value == other.value
+                }
+
+                override fun hashCode() = value.hashCode()
+
+                override fun toString() = value.toString()
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Grammar &&
+                    definition == other.definition &&
+                    syntax == other.syntax &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(definition, syntax, type, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Grammar{definition=$definition, syntax=$syntax, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaCustomTool &&
+            name == other.name &&
+            type == other.type &&
+            allowedCallers == other.allowedCallers &&
+            deferLoading == other.deferLoading &&
+            description == other.description &&
+            format == other.format &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            name,
+            type,
+            allowedCallers,
+            deferLoading,
+            description,
+            format,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaCustomTool{name=$name, type=$type, allowedCallers=$allowedCallers, deferLoading=$deferLoading, description=$description, format=$format, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaEasyInputMessage.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaEasyInputMessage.kt
new file mode 100644
index 000000000..370c194e2
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaEasyInputMessage.kt
@@ -0,0 +1,1004 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.allMaxBy
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * A message input to the model with a role indicating instruction following hierarchy. Instructions
+ * given with the `developer` or `system` role take precedence over instructions given with the
+ * `user` role. Messages with the `assistant` role are presumed to have been generated by the model
+ * in previous interactions.
+ */
+class BetaEasyInputMessage
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val content: JsonField<Content>,
+    private val role: JsonField<Role>,
+    private val phase: JsonField<Phase>,
+    private val type: JsonField<Type>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("content") @ExcludeMissing content: JsonField<Content> = JsonMissing.of(),
+        @JsonProperty("role") @ExcludeMissing role: JsonField<Role> = JsonMissing.of(),
+        @JsonProperty("phase") @ExcludeMissing phase: JsonField<Phase> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
+    ) : this(content, role, phase, type, mutableMapOf())
+
+    /**
+     * Text, image, or audio input to the model, used to generate a response. Can also contain
+     * previous assistant responses.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun content(): Content = content.getRequired("content")
+
+    /**
+     * The role of the message input. One of `user`, `assistant`, `system`, or `developer`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun role(): Role = role.getRequired("role")
+
+    /**
+     * Labels an `assistant` message as intermediate commentary (`commentary`) or the final answer
+     * (`final_answer`). For models like `gpt-5.3-codex` and beyond, when sending follow-up
+     * requests, preserve and resend phase on all assistant messages — dropping it can degrade
+     * performance. Not used for user messages.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun phase(): Optional<Phase> = phase.getOptional("phase")
+
+    /**
+     * The type of the message input. Always `message`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun type(): Optional<Type> = type.getOptional("type")
+
+    /**
+     * Returns the raw JSON value of [content].
+     *
+     * Unlike [content], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("content") @ExcludeMissing fun _content(): JsonField<Content> = content
+
+    /**
+     * Returns the raw JSON value of [role].
+     *
+     * Unlike [role], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("role") @ExcludeMissing fun _role(): JsonField<Role> = role
+
+    /**
+     * Returns the raw JSON value of [phase].
+     *
+     * Unlike [phase], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("phase") @ExcludeMissing fun _phase(): JsonField<Phase> = phase
+
+    /**
+     * Returns the raw JSON value of [type].
+     *
+     * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaEasyInputMessage].
+         *
+         * The following fields are required:
+         * ```java
+         * .content()
+         * .role()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaEasyInputMessage]. */
+    class Builder internal constructor() {
+
+        private var content: JsonField<Content>? = null
+        private var role: JsonField<Role>? = null
+        private var phase: JsonField<Phase> = JsonMissing.of()
+        private var type: JsonField<Type> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaEasyInputMessage: BetaEasyInputMessage) = apply {
+            content = betaEasyInputMessage.content
+            role = betaEasyInputMessage.role
+            phase = betaEasyInputMessage.phase
+            type = betaEasyInputMessage.type
+            additionalProperties = betaEasyInputMessage.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * Text, image, or audio input to the model, used to generate a response. Can also contain
+         * previous assistant responses.
+         */
+        fun content(content: Content) = content(JsonField.of(content))
+
+        /**
+         * Sets [Builder.content] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.content] with a well-typed [Content] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun content(content: JsonField<Content>) = apply { this.content = content }
+
+        /** Alias for calling [content] with `Content.ofTextInput(textInput)`. */
+        fun content(textInput: String) = content(Content.ofTextInput(textInput))
+
+        /**
+         * Alias for calling [content] with
+         * `Content.ofBetaResponseInputMessageContentList(betaResponseInputMessageContentList)`.
+         */
+        fun contentOfBetaResponseInputMessageContentList(
+            betaResponseInputMessageContentList: List<BetaResponseInputContent>
+        ) =
+            content(
+                Content.ofBetaResponseInputMessageContentList(betaResponseInputMessageContentList)
+            )
+
+        /** The role of the message input. One of `user`, `assistant`, `system`, or `developer`. */
+        fun role(role: Role) = role(JsonField.of(role))
+
+        /**
+         * Sets [Builder.role] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.role] with a well-typed [Role] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun role(role: JsonField<Role>) = apply { this.role = role }
+
+        /**
+         * Labels an `assistant` message as intermediate commentary (`commentary`) or the final
+         * answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when sending
+         * follow-up requests, preserve and resend phase on all assistant messages — dropping it can
+         * degrade performance. Not used for user messages.
+         */
+        fun phase(phase: Phase?) = phase(JsonField.ofNullable(phase))
+
+        /** Alias for calling [Builder.phase] with `phase.orElse(null)`. */
+        fun phase(phase: Optional<Phase>) = phase(phase.getOrNull())
+
+        /**
+         * Sets [Builder.phase] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.phase] with a well-typed [Phase] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun phase(phase: JsonField<Phase>) = apply { this.phase = phase }
+
+        /** The type of the message input. Always `message`. */
+        fun type(type: Type) = type(JsonField.of(type))
+
+        /**
+         * Sets [Builder.type] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.type] with a well-typed [Type] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun type(type: JsonField<Type>) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaEasyInputMessage].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .content()
+         * .role()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaEasyInputMessage =
+            BetaEasyInputMessage(
+                checkRequired("content", content),
+                checkRequired("role", role),
+                phase,
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaEasyInputMessage = apply {
+        if (validated) {
+            return@apply
+        }
+
+        content().validate()
+        role().validate()
+        phase().ifPresent { it.validate() }
+        type().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (content.asKnown().getOrNull()?.validity() ?: 0) +
+            (role.asKnown().getOrNull()?.validity() ?: 0) +
+            (phase.asKnown().getOrNull()?.validity() ?: 0) +
+            (type.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * Text, image, or audio input to the model, used to generate a response. Can also contain
+     * previous assistant responses.
+     */
+    @JsonDeserialize(using = Content.Deserializer::class)
+    @JsonSerialize(using = Content.Serializer::class)
+    class Content
+    private constructor(
+        private val textInput: String? = null,
+        private val betaResponseInputMessageContentList: List<BetaResponseInputContent>? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** A text input to the model. */
+        fun textInput(): Optional<String> = Optional.ofNullable(textInput)
+
+        /** A list of one or many input items to the model, containing different content types. */
+        fun betaResponseInputMessageContentList(): Optional<List<BetaResponseInputContent>> =
+            Optional.ofNullable(betaResponseInputMessageContentList)
+
+        fun isTextInput(): Boolean = textInput != null
+
+        fun isBetaResponseInputMessageContentList(): Boolean =
+            betaResponseInputMessageContentList != null
+
+        /** A text input to the model. */
+        fun asTextInput(): String = textInput.getOrThrow("textInput")
+
+        /** A list of one or many input items to the model, containing different content types. */
+        fun asBetaResponseInputMessageContentList(): List<BetaResponseInputContent> =
+            betaResponseInputMessageContentList.getOrThrow("betaResponseInputMessageContentList")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = content.accept(new Content.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitTextInput(String textInput) {
+         *         return Optional.of(textInput.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                textInput != null -> visitor.visitTextInput(textInput)
+                betaResponseInputMessageContentList != null ->
+                    visitor.visitBetaResponseInputMessageContentList(
+                        betaResponseInputMessageContentList
+                    )
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Content = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitTextInput(textInput: String) {}
+
+                    override fun visitBetaResponseInputMessageContentList(
+                        betaResponseInputMessageContentList: List<BetaResponseInputContent>
+                    ) {
+                        betaResponseInputMessageContentList.forEach { it.validate() }
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitTextInput(textInput: String) = 1
+
+                    override fun visitBetaResponseInputMessageContentList(
+                        betaResponseInputMessageContentList: List<BetaResponseInputContent>
+                    ) = betaResponseInputMessageContentList.sumOf { it.validity().toInt() }
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Content &&
+                textInput == other.textInput &&
+                betaResponseInputMessageContentList == other.betaResponseInputMessageContentList
+        }
+
+        override fun hashCode(): Int = Objects.hash(textInput, betaResponseInputMessageContentList)
+
+        override fun toString(): String =
+            when {
+                textInput != null -> "Content{textInput=$textInput}"
+                betaResponseInputMessageContentList != null ->
+                    "Content{betaResponseInputMessageContentList=$betaResponseInputMessageContentList}"
+                _json != null -> "Content{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Content")
+            }
+
+        companion object {
+
+            /** A text input to the model. */
+            @JvmStatic fun ofTextInput(textInput: String) = Content(textInput = textInput)
+
+            /**
+             * A list of one or many input items to the model, containing different content types.
+             */
+            @JvmStatic
+            fun ofBetaResponseInputMessageContentList(
+                betaResponseInputMessageContentList: List<BetaResponseInputContent>
+            ) =
+                Content(
+                    betaResponseInputMessageContentList =
+                        betaResponseInputMessageContentList.toImmutable()
+                )
+        }
+
+        /**
+         * An interface that defines how to map each variant of [Content] to a value of type [T].
+         */
+        interface Visitor<out T> {
+
+            /** A text input to the model. */
+            fun visitTextInput(textInput: String): T
+
+            /**
+             * A list of one or many input items to the model, containing different content types.
+             */
+            fun visitBetaResponseInputMessageContentList(
+                betaResponseInputMessageContentList: List<BetaResponseInputContent>
+            ): T
+
+            /**
+             * Maps an unknown variant of [Content] to a value of type [T].
+             *
+             * An instance of [Content] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Content: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Content>(Content::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Content {
+                val json = JsonValue.fromJsonNode(node)
+
+                val bestMatches =
+                    sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                Content(textInput = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<List<BetaResponseInputContent>>())
+                                ?.let {
+                                    Content(betaResponseInputMessageContentList = it, _json = json)
+                                },
+                        )
+                        .filterNotNull()
+                        .allMaxBy { it.validity() }
+                        .toList()
+                return when (bestMatches.size) {
+                    // This can happen if what we're deserializing is completely incompatible with
+                    // all the possible variants (e.g. deserializing from boolean).
+                    0 -> Content(_json = json)
+                    1 -> bestMatches.single()
+                    // If there's more than one match with the highest validity, then use the first
+                    // completely valid match, or simply the first match if none are completely
+                    // valid.
+                    else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                }
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Content>(Content::class) {
+
+            override fun serialize(
+                value: Content,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.textInput != null -> generator.writeObject(value.textInput)
+                    value.betaResponseInputMessageContentList != null ->
+                        generator.writeObject(value.betaResponseInputMessageContentList)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Content")
+                }
+            }
+        }
+    }
+
+    /** The role of the message input. One of `user`, `assistant`, `system`, or `developer`. */
+    class Role @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val USER = of("user")
+
+            @JvmField val ASSISTANT = of("assistant")
+
+            @JvmField val SYSTEM = of("system")
+
+            @JvmField val DEVELOPER = of("developer")
+
+            @JvmStatic fun of(value: String) = Role(JsonField.of(value))
+        }
+
+        /** An enum containing [Role]'s known values. */
+        enum class Known {
+            USER,
+            ASSISTANT,
+            SYSTEM,
+            DEVELOPER,
+        }
+
+        /**
+         * An enum containing [Role]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Role] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            USER,
+            ASSISTANT,
+            SYSTEM,
+            DEVELOPER,
+            /** An enum member indicating that [Role] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                USER -> Value.USER
+                ASSISTANT -> Value.ASSISTANT
+                SYSTEM -> Value.SYSTEM
+                DEVELOPER -> Value.DEVELOPER
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                USER -> Known.USER
+                ASSISTANT -> Known.ASSISTANT
+                SYSTEM -> Known.SYSTEM
+                DEVELOPER -> Known.DEVELOPER
+                else -> throw OpenAIInvalidDataException("Unknown Role: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Role = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Role && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /**
+     * Labels an `assistant` message as intermediate commentary (`commentary`) or the final answer
+     * (`final_answer`). For models like `gpt-5.3-codex` and beyond, when sending follow-up
+     * requests, preserve and resend phase on all assistant messages — dropping it can degrade
+     * performance. Not used for user messages.
+     */
+    class Phase @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val COMMENTARY = of("commentary")
+
+            @JvmField val FINAL_ANSWER = of("final_answer")
+
+            @JvmStatic fun of(value: String) = Phase(JsonField.of(value))
+        }
+
+        /** An enum containing [Phase]'s known values. */
+        enum class Known {
+            COMMENTARY,
+            FINAL_ANSWER,
+        }
+
+        /**
+         * An enum containing [Phase]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Phase] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            COMMENTARY,
+            FINAL_ANSWER,
+            /** An enum member indicating that [Phase] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                COMMENTARY -> Value.COMMENTARY
+                FINAL_ANSWER -> Value.FINAL_ANSWER
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                COMMENTARY -> Known.COMMENTARY
+                FINAL_ANSWER -> Known.FINAL_ANSWER
+                else -> throw OpenAIInvalidDataException("Unknown Phase: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Phase = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Phase && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The type of the message input. Always `message`. */
+    class Type @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val MESSAGE = of("message")
+
+            @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+        }
+
+        /** An enum containing [Type]'s known values. */
+        enum class Known {
+            MESSAGE
+        }
+
+        /**
+         * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Type] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            MESSAGE,
+            /** An enum member indicating that [Type] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                MESSAGE -> Value.MESSAGE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                MESSAGE -> Known.MESSAGE
+                else -> throw OpenAIInvalidDataException("Unknown Type: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Type = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Type && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaEasyInputMessage &&
+            content == other.content &&
+            role == other.role &&
+            phase == other.phase &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(content, role, phase, type, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaEasyInputMessage{content=$content, role=$role, phase=$phase, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaFileSearchTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaFileSearchTool.kt
new file mode 100644
index 000000000..273bb439d
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaFileSearchTool.kt
@@ -0,0 +1,3930 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.allMaxBy
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * A tool that searches for relevant content from uploaded files. Learn more about the
+ * [file search tool](https://platform.openai.com/docs/guides/tools-file-search).
+ */
+class BetaFileSearchTool
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonValue,
+    private val vectorStoreIds: JsonField<List<String>>,
+    private val filters: JsonField<Filters>,
+    private val maxNumResults: JsonField<Long>,
+    private val rankingOptions: JsonField<RankingOptions>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("vector_store_ids")
+        @ExcludeMissing
+        vectorStoreIds: JsonField<List<String>> = JsonMissing.of(),
+        @JsonProperty("filters") @ExcludeMissing filters: JsonField<Filters> = JsonMissing.of(),
+        @JsonProperty("max_num_results")
+        @ExcludeMissing
+        maxNumResults: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("ranking_options")
+        @ExcludeMissing
+        rankingOptions: JsonField<RankingOptions> = JsonMissing.of(),
+    ) : this(type, vectorStoreIds, filters, maxNumResults, rankingOptions, mutableMapOf())
+
+    /**
+     * The type of the file search tool. Always `file_search`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("file_search")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The IDs of the vector stores to search.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun vectorStoreIds(): List<String> = vectorStoreIds.getRequired("vector_store_ids")
+
+    /**
+     * A filter to apply.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun filters(): Optional<Filters> = filters.getOptional("filters")
+
+    /**
+     * The maximum number of results to return. This number should be between 1 and 50 inclusive.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun maxNumResults(): Optional<Long> = maxNumResults.getOptional("max_num_results")
+
+    /**
+     * Ranking options for search.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun rankingOptions(): Optional<RankingOptions> = rankingOptions.getOptional("ranking_options")
+
+    /**
+     * Returns the raw JSON value of [vectorStoreIds].
+     *
+     * Unlike [vectorStoreIds], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("vector_store_ids")
+    @ExcludeMissing
+    fun _vectorStoreIds(): JsonField<List<String>> = vectorStoreIds
+
+    /**
+     * Returns the raw JSON value of [filters].
+     *
+     * Unlike [filters], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("filters") @ExcludeMissing fun _filters(): JsonField<Filters> = filters
+
+    /**
+     * Returns the raw JSON value of [maxNumResults].
+     *
+     * Unlike [maxNumResults], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("max_num_results")
+    @ExcludeMissing
+    fun _maxNumResults(): JsonField<Long> = maxNumResults
+
+    /**
+     * Returns the raw JSON value of [rankingOptions].
+     *
+     * Unlike [rankingOptions], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("ranking_options")
+    @ExcludeMissing
+    fun _rankingOptions(): JsonField<RankingOptions> = rankingOptions
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaFileSearchTool].
+         *
+         * The following fields are required:
+         * ```java
+         * .vectorStoreIds()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaFileSearchTool]. */
+    class Builder internal constructor() {
+
+        private var type: JsonValue = JsonValue.from("file_search")
+        private var vectorStoreIds: JsonField<MutableList<String>>? = null
+        private var filters: JsonField<Filters> = JsonMissing.of()
+        private var maxNumResults: JsonField<Long> = JsonMissing.of()
+        private var rankingOptions: JsonField<RankingOptions> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaFileSearchTool: BetaFileSearchTool) = apply {
+            type = betaFileSearchTool.type
+            vectorStoreIds = betaFileSearchTool.vectorStoreIds.map { it.toMutableList() }
+            filters = betaFileSearchTool.filters
+            maxNumResults = betaFileSearchTool.maxNumResults
+            rankingOptions = betaFileSearchTool.rankingOptions
+            additionalProperties = betaFileSearchTool.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("file_search")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The IDs of the vector stores to search. */
+        fun vectorStoreIds(vectorStoreIds: List<String>) =
+            vectorStoreIds(JsonField.of(vectorStoreIds))
+
+        /**
+         * Sets [Builder.vectorStoreIds] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.vectorStoreIds] with a well-typed `List<String>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun vectorStoreIds(vectorStoreIds: JsonField<List<String>>) = apply {
+            this.vectorStoreIds = vectorStoreIds.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [String] to [vectorStoreIds].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addVectorStoreId(vectorStoreId: String) = apply {
+            vectorStoreIds =
+                (vectorStoreIds ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("vectorStoreIds", it).add(vectorStoreId)
+                }
+        }
+
+        /** A filter to apply. */
+        fun filters(filters: Filters?) = filters(JsonField.ofNullable(filters))
+
+        /** Alias for calling [Builder.filters] with `filters.orElse(null)`. */
+        fun filters(filters: Optional<Filters>) = filters(filters.getOrNull())
+
+        /**
+         * Sets [Builder.filters] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.filters] with a well-typed [Filters] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun filters(filters: JsonField<Filters>) = apply { this.filters = filters }
+
+        /** Alias for calling [filters] with `Filters.ofComparisonFilter(comparisonFilter)`. */
+        fun filters(comparisonFilter: Filters.ComparisonFilter) =
+            filters(Filters.ofComparisonFilter(comparisonFilter))
+
+        /** Alias for calling [filters] with `Filters.ofCompoundFilter(compoundFilter)`. */
+        fun filters(compoundFilter: Filters.CompoundFilter) =
+            filters(Filters.ofCompoundFilter(compoundFilter))
+
+        /**
+         * The maximum number of results to return. This number should be between 1 and 50
+         * inclusive.
+         */
+        fun maxNumResults(maxNumResults: Long) = maxNumResults(JsonField.of(maxNumResults))
+
+        /**
+         * Sets [Builder.maxNumResults] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.maxNumResults] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun maxNumResults(maxNumResults: JsonField<Long>) = apply {
+            this.maxNumResults = maxNumResults
+        }
+
+        /** Ranking options for search. */
+        fun rankingOptions(rankingOptions: RankingOptions) =
+            rankingOptions(JsonField.of(rankingOptions))
+
+        /**
+         * Sets [Builder.rankingOptions] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.rankingOptions] with a well-typed [RankingOptions] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun rankingOptions(rankingOptions: JsonField<RankingOptions>) = apply {
+            this.rankingOptions = rankingOptions
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaFileSearchTool].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .vectorStoreIds()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaFileSearchTool =
+            BetaFileSearchTool(
+                type,
+                checkRequired("vectorStoreIds", vectorStoreIds).map { it.toImmutable() },
+                filters,
+                maxNumResults,
+                rankingOptions,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaFileSearchTool = apply {
+        if (validated) {
+            return@apply
+        }
+
+        _type().let {
+            if (it != JsonValue.from("file_search")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        vectorStoreIds()
+        filters().ifPresent { it.validate() }
+        maxNumResults()
+        rankingOptions().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        type.let { if (it == JsonValue.from("file_search")) 1 else 0 } +
+            (vectorStoreIds.asKnown().getOrNull()?.size ?: 0) +
+            (filters.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (maxNumResults.asKnown().isPresent) 1 else 0) +
+            (rankingOptions.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** A filter to apply. */
+    @JsonDeserialize(using = Filters.Deserializer::class)
+    @JsonSerialize(using = Filters.Serializer::class)
+    class Filters
+    private constructor(
+        private val comparisonFilter: ComparisonFilter? = null,
+        private val compoundFilter: CompoundFilter? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /**
+         * A filter used to compare a specified attribute key to a given value using a defined
+         * comparison operation.
+         */
+        fun comparisonFilter(): Optional<ComparisonFilter> = Optional.ofNullable(comparisonFilter)
+
+        /** Combine multiple filters using `and` or `or`. */
+        fun compoundFilter(): Optional<CompoundFilter> = Optional.ofNullable(compoundFilter)
+
+        fun isComparisonFilter(): Boolean = comparisonFilter != null
+
+        fun isCompoundFilter(): Boolean = compoundFilter != null
+
+        /**
+         * A filter used to compare a specified attribute key to a given value using a defined
+         * comparison operation.
+         */
+        fun asComparisonFilter(): ComparisonFilter = comparisonFilter.getOrThrow("comparisonFilter")
+
+        /** Combine multiple filters using `and` or `or`. */
+        fun asCompoundFilter(): CompoundFilter = compoundFilter.getOrThrow("compoundFilter")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = filters.accept(new Filters.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitComparisonFilter(ComparisonFilter comparisonFilter) {
+         *         return Optional.of(comparisonFilter.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                comparisonFilter != null -> visitor.visitComparisonFilter(comparisonFilter)
+                compoundFilter != null -> visitor.visitCompoundFilter(compoundFilter)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Filters = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitComparisonFilter(comparisonFilter: ComparisonFilter) {
+                        comparisonFilter.validate()
+                    }
+
+                    override fun visitCompoundFilter(compoundFilter: CompoundFilter) {
+                        compoundFilter.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitComparisonFilter(comparisonFilter: ComparisonFilter) =
+                        comparisonFilter.validity()
+
+                    override fun visitCompoundFilter(compoundFilter: CompoundFilter) =
+                        compoundFilter.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Filters &&
+                comparisonFilter == other.comparisonFilter &&
+                compoundFilter == other.compoundFilter
+        }
+
+        override fun hashCode(): Int = Objects.hash(comparisonFilter, compoundFilter)
+
+        override fun toString(): String =
+            when {
+                comparisonFilter != null -> "Filters{comparisonFilter=$comparisonFilter}"
+                compoundFilter != null -> "Filters{compoundFilter=$compoundFilter}"
+                _json != null -> "Filters{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Filters")
+            }
+
+        companion object {
+
+            /**
+             * A filter used to compare a specified attribute key to a given value using a defined
+             * comparison operation.
+             */
+            @JvmStatic
+            fun ofComparisonFilter(comparisonFilter: ComparisonFilter) =
+                Filters(comparisonFilter = comparisonFilter)
+
+            /** Combine multiple filters using `and` or `or`. */
+            @JvmStatic
+            fun ofCompoundFilter(compoundFilter: CompoundFilter) =
+                Filters(compoundFilter = compoundFilter)
+        }
+
+        /**
+         * An interface that defines how to map each variant of [Filters] to a value of type [T].
+         */
+        interface Visitor<out T> {
+
+            /**
+             * A filter used to compare a specified attribute key to a given value using a defined
+             * comparison operation.
+             */
+            fun visitComparisonFilter(comparisonFilter: ComparisonFilter): T
+
+            /** Combine multiple filters using `and` or `or`. */
+            fun visitCompoundFilter(compoundFilter: CompoundFilter): T
+
+            /**
+             * Maps an unknown variant of [Filters] to a value of type [T].
+             *
+             * An instance of [Filters] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Filters: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Filters>(Filters::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Filters {
+                val json = JsonValue.fromJsonNode(node)
+
+                val bestMatches =
+                    sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<ComparisonFilter>())?.let {
+                                Filters(comparisonFilter = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<CompoundFilter>())?.let {
+                                Filters(compoundFilter = it, _json = json)
+                            },
+                        )
+                        .filterNotNull()
+                        .allMaxBy { it.validity() }
+                        .toList()
+                return when (bestMatches.size) {
+                    // This can happen if what we're deserializing is completely incompatible with
+                    // all the possible variants (e.g. deserializing from boolean).
+                    0 -> Filters(_json = json)
+                    1 -> bestMatches.single()
+                    // If there's more than one match with the highest validity, then use the first
+                    // completely valid match, or simply the first match if none are completely
+                    // valid.
+                    else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                }
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Filters>(Filters::class) {
+
+            override fun serialize(
+                value: Filters,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.comparisonFilter != null -> generator.writeObject(value.comparisonFilter)
+                    value.compoundFilter != null -> generator.writeObject(value.compoundFilter)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Filters")
+                }
+            }
+        }
+
+        /**
+         * A filter used to compare a specified attribute key to a given value using a defined
+         * comparison operation.
+         */
+        class ComparisonFilter
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val key: JsonField<String>,
+            private val type: JsonField<Type>,
+            private val value: JsonField<Value>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("key") @ExcludeMissing key: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
+                @JsonProperty("value") @ExcludeMissing value: JsonField<Value> = JsonMissing.of(),
+            ) : this(key, type, value, mutableMapOf())
+
+            /**
+             * The key to compare against the value.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun key(): String = key.getRequired("key")
+
+            /**
+             * Specifies the comparison operator: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, `nin`.
+             * - `eq`: equals
+             * - `ne`: not equal
+             * - `gt`: greater than
+             * - `gte`: greater than or equal
+             * - `lt`: less than
+             * - `lte`: less than or equal
+             * - `in`: in
+             * - `nin`: not in
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun type(): Type = type.getRequired("type")
+
+            /**
+             * The value to compare against the attribute key; supports string, number, or boolean
+             * types.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun value(): Value = value.getRequired("value")
+
+            /**
+             * Returns the raw JSON value of [key].
+             *
+             * Unlike [key], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("key") @ExcludeMissing fun _key(): JsonField<String> = key
+
+            /**
+             * Returns the raw JSON value of [type].
+             *
+             * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+
+            /**
+             * Returns the raw JSON value of [value].
+             *
+             * Unlike [value], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("value") @ExcludeMissing fun _value(): JsonField<Value> = value
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [ComparisonFilter].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .key()
+                 * .type()
+                 * .value()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [ComparisonFilter]. */
+            class Builder internal constructor() {
+
+                private var key: JsonField<String>? = null
+                private var type: JsonField<Type>? = null
+                private var value: JsonField<Value>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(comparisonFilter: ComparisonFilter) = apply {
+                    key = comparisonFilter.key
+                    type = comparisonFilter.type
+                    value = comparisonFilter.value
+                    additionalProperties = comparisonFilter.additionalProperties.toMutableMap()
+                }
+
+                /** The key to compare against the value. */
+                fun key(key: String) = key(JsonField.of(key))
+
+                /**
+                 * Sets [Builder.key] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.key] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun key(key: JsonField<String>) = apply { this.key = key }
+
+                /**
+                 * Specifies the comparison operator: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`,
+                 * `nin`.
+                 * - `eq`: equals
+                 * - `ne`: not equal
+                 * - `gt`: greater than
+                 * - `gte`: greater than or equal
+                 * - `lt`: less than
+                 * - `lte`: less than or equal
+                 * - `in`: in
+                 * - `nin`: not in
+                 */
+                fun type(type: Type) = type(JsonField.of(type))
+
+                /**
+                 * Sets [Builder.type] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.type] with a well-typed [Type] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonField<Type>) = apply { this.type = type }
+
+                /**
+                 * The value to compare against the attribute key; supports string, number, or
+                 * boolean types.
+                 */
+                fun value(value: Value) = value(JsonField.of(value))
+
+                /**
+                 * Sets [Builder.value] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.value] with a well-typed [Value] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun value(value: JsonField<Value>) = apply { this.value = value }
+
+                /** Alias for calling [value] with `Value.ofString(string)`. */
+                fun value(string: String) = value(Value.ofString(string))
+
+                /** Alias for calling [value] with `Value.ofNumber(number)`. */
+                fun value(number: Double) = value(Value.ofNumber(number))
+
+                /** Alias for calling [value] with `Value.ofBool(bool)`. */
+                fun value(bool: Boolean) = value(Value.ofBool(bool))
+
+                /**
+                 * Alias for calling [value] with
+                 * `Value.ofComparisonFilterValueItems(comparisonFilterValueItems)`.
+                 */
+                fun valueOfComparisonFilterValueItems(
+                    comparisonFilterValueItems: List<Value.ComparisonFilterValueItem>
+                ) = value(Value.ofComparisonFilterValueItems(comparisonFilterValueItems))
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [ComparisonFilter].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .key()
+                 * .type()
+                 * .value()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): ComparisonFilter =
+                    ComparisonFilter(
+                        checkRequired("key", key),
+                        checkRequired("type", type),
+                        checkRequired("value", value),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): ComparisonFilter = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                key()
+                type().validate()
+                value().validate()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (key.asKnown().isPresent) 1 else 0) +
+                    (type.asKnown().getOrNull()?.validity() ?: 0) +
+                    (value.asKnown().getOrNull()?.validity() ?: 0)
+
+            /**
+             * Specifies the comparison operator: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, `nin`.
+             * - `eq`: equals
+             * - `ne`: not equal
+             * - `gt`: greater than
+             * - `gte`: greater than or equal
+             * - `lt`: less than
+             * - `lte`: less than or equal
+             * - `in`: in
+             * - `nin`: not in
+             */
+            class Type @JsonCreator private constructor(private val value: JsonField<String>) :
+                Enum {
+
+                /**
+                 * Returns this class instance's raw value.
+                 *
+                 * This is usually only useful if this instance was deserialized from data that
+                 * doesn't match any known member, and you want to know that value. For example, if
+                 * the SDK is on an older version than the API, then the API may respond with new
+                 * members that the SDK is unaware of.
+                 */
+                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+                companion object {
+
+                    @JvmField val EQ = of("eq")
+
+                    @JvmField val NE = of("ne")
+
+                    @JvmField val GT = of("gt")
+
+                    @JvmField val GTE = of("gte")
+
+                    @JvmField val LT = of("lt")
+
+                    @JvmField val LTE = of("lte")
+
+                    @JvmField val IN = of("in")
+
+                    @JvmField val NIN = of("nin")
+
+                    @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+                }
+
+                /** An enum containing [Type]'s known values. */
+                enum class Known {
+                    EQ,
+                    NE,
+                    GT,
+                    GTE,
+                    LT,
+                    LTE,
+                    IN,
+                    NIN,
+                }
+
+                /**
+                 * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
+                 *
+                 * An instance of [Type] can contain an unknown value in a couple of cases:
+                 * - It was deserialized from data that doesn't match any known member. For example,
+                 *   if the SDK is on an older version than the API, then the API may respond with
+                 *   new members that the SDK is unaware of.
+                 * - It was constructed with an arbitrary value using the [of] method.
+                 */
+                enum class Value {
+                    EQ,
+                    NE,
+                    GT,
+                    GTE,
+                    LT,
+                    LTE,
+                    IN,
+                    NIN,
+                    /**
+                     * An enum member indicating that [Type] was instantiated with an unknown value.
+                     */
+                    _UNKNOWN,
+                }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value, or
+                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                 *
+                 * Use the [known] method instead if you're certain the value is always known or if
+                 * you want to throw for the unknown case.
+                 */
+                fun value(): Value =
+                    when (this) {
+                        EQ -> Value.EQ
+                        NE -> Value.NE
+                        GT -> Value.GT
+                        GTE -> Value.GTE
+                        LT -> Value.LT
+                        LTE -> Value.LTE
+                        IN -> Value.IN
+                        NIN -> Value.NIN
+                        else -> Value._UNKNOWN
+                    }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value.
+                 *
+                 * Use the [value] method instead if you're uncertain the value is always known and
+                 * don't want to throw for the unknown case.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                 *   known member.
+                 */
+                fun known(): Known =
+                    when (this) {
+                        EQ -> Known.EQ
+                        NE -> Known.NE
+                        GT -> Known.GT
+                        GTE -> Known.GTE
+                        LT -> Known.LT
+                        LTE -> Known.LTE
+                        IN -> Known.IN
+                        NIN -> Known.NIN
+                        else -> throw OpenAIInvalidDataException("Unknown Type: $value")
+                    }
+
+                /**
+                 * Returns this class instance's primitive wire representation.
+                 *
+                 * This differs from the [toString] method because that method is primarily for
+                 * debugging and generally doesn't throw.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value does not have
+                 *   the expected primitive type.
+                 */
+                fun asString(): String =
+                    _value().asString().orElseThrow {
+                        OpenAIInvalidDataException("Value is not a String")
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Type = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    known()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Type && value == other.value
+                }
+
+                override fun hashCode() = value.hashCode()
+
+                override fun toString() = value.toString()
+            }
+
+            /**
+             * The value to compare against the attribute key; supports string, number, or boolean
+             * types.
+             */
+            @JsonDeserialize(using = Value.Deserializer::class)
+            @JsonSerialize(using = Value.Serializer::class)
+            class Value
+            private constructor(
+                private val string: String? = null,
+                private val number: Double? = null,
+                private val bool: Boolean? = null,
+                private val comparisonFilterValueItems: List<ComparisonFilterValueItem>? = null,
+                private val _json: JsonValue? = null,
+            ) {
+
+                fun string(): Optional<String> = Optional.ofNullable(string)
+
+                fun number(): Optional<Double> = Optional.ofNullable(number)
+
+                fun bool(): Optional<Boolean> = Optional.ofNullable(bool)
+
+                fun comparisonFilterValueItems(): Optional<List<ComparisonFilterValueItem>> =
+                    Optional.ofNullable(comparisonFilterValueItems)
+
+                fun isString(): Boolean = string != null
+
+                fun isNumber(): Boolean = number != null
+
+                fun isBool(): Boolean = bool != null
+
+                fun isComparisonFilterValueItems(): Boolean = comparisonFilterValueItems != null
+
+                fun asString(): String = string.getOrThrow("string")
+
+                fun asNumber(): Double = number.getOrThrow("number")
+
+                fun asBool(): Boolean = bool.getOrThrow("bool")
+
+                fun asComparisonFilterValueItems(): List<ComparisonFilterValueItem> =
+                    comparisonFilterValueItems.getOrThrow("comparisonFilterValueItems")
+
+                fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+                /**
+                 * Maps this instance's current variant to a value of type [T] using the given
+                 * [visitor].
+                 *
+                 * Note that this method is _not_ forwards compatible with new variants from the
+                 * API, unless [visitor] overrides [Visitor.unknown]. To handle variants not known
+                 * to this version of the SDK gracefully, consider overriding [Visitor.unknown]:
+                 * ```java
+                 * import com.openai.core.JsonValue;
+                 * import java.util.Optional;
+                 *
+                 * Optional<String> result = value.accept(new Value.Visitor<Optional<String>>() {
+                 *     @Override
+                 *     public Optional<String> visitString(String string) {
+                 *         return Optional.of(string.toString());
+                 *     }
+                 *
+                 *     // ...
+                 *
+                 *     @Override
+                 *     public Optional<String> unknown(JsonValue json) {
+                 *         // Or inspect the `json`.
+                 *         return Optional.empty();
+                 *     }
+                 * });
+                 * ```
+                 *
+                 * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+                 *   [visitor] and the current variant is unknown.
+                 */
+                fun <T> accept(visitor: Visitor<T>): T =
+                    when {
+                        string != null -> visitor.visitString(string)
+                        number != null -> visitor.visitNumber(number)
+                        bool != null -> visitor.visitBool(bool)
+                        comparisonFilterValueItems != null ->
+                            visitor.visitComparisonFilterValueItems(comparisonFilterValueItems)
+                        else -> visitor.unknown(_json)
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Value = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    accept(
+                        object : Visitor<Unit> {
+                            override fun visitString(string: String) {}
+
+                            override fun visitNumber(number: Double) {}
+
+                            override fun visitBool(bool: Boolean) {}
+
+                            override fun visitComparisonFilterValueItems(
+                                comparisonFilterValueItems: List<ComparisonFilterValueItem>
+                            ) {
+                                comparisonFilterValueItems.forEach { it.validate() }
+                            }
+                        }
+                    )
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    accept(
+                        object : Visitor<Int> {
+                            override fun visitString(string: String) = 1
+
+                            override fun visitNumber(number: Double) = 1
+
+                            override fun visitBool(bool: Boolean) = 1
+
+                            override fun visitComparisonFilterValueItems(
+                                comparisonFilterValueItems: List<ComparisonFilterValueItem>
+                            ) = comparisonFilterValueItems.sumOf { it.validity().toInt() }
+
+                            override fun unknown(json: JsonValue?) = 0
+                        }
+                    )
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Value &&
+                        string == other.string &&
+                        number == other.number &&
+                        bool == other.bool &&
+                        comparisonFilterValueItems == other.comparisonFilterValueItems
+                }
+
+                override fun hashCode(): Int =
+                    Objects.hash(string, number, bool, comparisonFilterValueItems)
+
+                override fun toString(): String =
+                    when {
+                        string != null -> "Value{string=$string}"
+                        number != null -> "Value{number=$number}"
+                        bool != null -> "Value{bool=$bool}"
+                        comparisonFilterValueItems != null ->
+                            "Value{comparisonFilterValueItems=$comparisonFilterValueItems}"
+                        _json != null -> "Value{_unknown=$_json}"
+                        else -> throw IllegalStateException("Invalid Value")
+                    }
+
+                companion object {
+
+                    @JvmStatic fun ofString(string: String) = Value(string = string)
+
+                    @JvmStatic fun ofNumber(number: Double) = Value(number = number)
+
+                    @JvmStatic fun ofBool(bool: Boolean) = Value(bool = bool)
+
+                    @JvmStatic
+                    fun ofComparisonFilterValueItems(
+                        comparisonFilterValueItems: List<ComparisonFilterValueItem>
+                    ) = Value(comparisonFilterValueItems = comparisonFilterValueItems.toImmutable())
+                }
+
+                /**
+                 * An interface that defines how to map each variant of [Value] to a value of type
+                 * [T].
+                 */
+                interface Visitor<out T> {
+
+                    fun visitString(string: String): T
+
+                    fun visitNumber(number: Double): T
+
+                    fun visitBool(bool: Boolean): T
+
+                    fun visitComparisonFilterValueItems(
+                        comparisonFilterValueItems: List<ComparisonFilterValueItem>
+                    ): T
+
+                    /**
+                     * Maps an unknown variant of [Value] to a value of type [T].
+                     *
+                     * An instance of [Value] can contain an unknown variant if it was deserialized
+                     * from data that doesn't match any known variant. For example, if the SDK is on
+                     * an older version than the API, then the API may respond with new variants
+                     * that the SDK is unaware of.
+                     *
+                     * @throws OpenAIInvalidDataException in the default implementation.
+                     */
+                    fun unknown(json: JsonValue?): T {
+                        throw OpenAIInvalidDataException("Unknown Value: $json")
+                    }
+                }
+
+                internal class Deserializer : BaseDeserializer<Value>(Value::class) {
+
+                    override fun ObjectCodec.deserialize(node: JsonNode): Value {
+                        val json = JsonValue.fromJsonNode(node)
+
+                        val bestMatches =
+                            sequenceOf(
+                                    tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                        Value(string = it, _json = json)
+                                    },
+                                    tryDeserialize(node, jacksonTypeRef<Double>())?.let {
+                                        Value(number = it, _json = json)
+                                    },
+                                    tryDeserialize(node, jacksonTypeRef<Boolean>())?.let {
+                                        Value(bool = it, _json = json)
+                                    },
+                                    tryDeserialize(
+                                            node,
+                                            jacksonTypeRef<List<ComparisonFilterValueItem>>(),
+                                        )
+                                        ?.let {
+                                            Value(comparisonFilterValueItems = it, _json = json)
+                                        },
+                                )
+                                .filterNotNull()
+                                .allMaxBy { it.validity() }
+                                .toList()
+                        return when (bestMatches.size) {
+                            // This can happen if what we're deserializing is completely
+                            // incompatible with all the possible variants (e.g. deserializing from
+                            // object).
+                            0 -> Value(_json = json)
+                            1 -> bestMatches.single()
+                            // If there's more than one match with the highest validity, then use
+                            // the first completely valid match, or simply the first match if none
+                            // are completely valid.
+                            else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                        }
+                    }
+                }
+
+                internal class Serializer : BaseSerializer<Value>(Value::class) {
+
+                    override fun serialize(
+                        value: Value,
+                        generator: JsonGenerator,
+                        provider: SerializerProvider,
+                    ) {
+                        when {
+                            value.string != null -> generator.writeObject(value.string)
+                            value.number != null -> generator.writeObject(value.number)
+                            value.bool != null -> generator.writeObject(value.bool)
+                            value.comparisonFilterValueItems != null ->
+                                generator.writeObject(value.comparisonFilterValueItems)
+                            value._json != null -> generator.writeObject(value._json)
+                            else -> throw IllegalStateException("Invalid Value")
+                        }
+                    }
+                }
+
+                @JsonDeserialize(using = ComparisonFilterValueItem.Deserializer::class)
+                @JsonSerialize(using = ComparisonFilterValueItem.Serializer::class)
+                class ComparisonFilterValueItem
+                private constructor(
+                    private val string: String? = null,
+                    private val number: Double? = null,
+                    private val _json: JsonValue? = null,
+                ) {
+
+                    fun string(): Optional<String> = Optional.ofNullable(string)
+
+                    fun number(): Optional<Double> = Optional.ofNullable(number)
+
+                    fun isString(): Boolean = string != null
+
+                    fun isNumber(): Boolean = number != null
+
+                    fun asString(): String = string.getOrThrow("string")
+
+                    fun asNumber(): Double = number.getOrThrow("number")
+
+                    fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+                    /**
+                     * Maps this instance's current variant to a value of type [T] using the given
+                     * [visitor].
+                     *
+                     * Note that this method is _not_ forwards compatible with new variants from the
+                     * API, unless [visitor] overrides [Visitor.unknown]. To handle variants not
+                     * known to this version of the SDK gracefully, consider overriding
+                     * [Visitor.unknown]:
+                     * ```java
+                     * import com.openai.core.JsonValue;
+                     * import java.util.Optional;
+                     *
+                     * Optional<String> result = comparisonFilterValueItem.accept(new ComparisonFilterValueItem.Visitor<Optional<String>>() {
+                     *     @Override
+                     *     public Optional<String> visitString(String string) {
+                     *         return Optional.of(string.toString());
+                     *     }
+                     *
+                     *     // ...
+                     *
+                     *     @Override
+                     *     public Optional<String> unknown(JsonValue json) {
+                     *         // Or inspect the `json`.
+                     *         return Optional.empty();
+                     *     }
+                     * });
+                     * ```
+                     *
+                     * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+                     *   [visitor] and the current variant is unknown.
+                     */
+                    fun <T> accept(visitor: Visitor<T>): T =
+                        when {
+                            string != null -> visitor.visitString(string)
+                            number != null -> visitor.visitNumber(number)
+                            else -> visitor.unknown(_json)
+                        }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): ComparisonFilterValueItem = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        accept(
+                            object : Visitor<Unit> {
+                                override fun visitString(string: String) {}
+
+                                override fun visitNumber(number: Double) {}
+                            }
+                        )
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        accept(
+                            object : Visitor<Int> {
+                                override fun visitString(string: String) = 1
+
+                                override fun visitNumber(number: Double) = 1
+
+                                override fun unknown(json: JsonValue?) = 0
+                            }
+                        )
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is ComparisonFilterValueItem &&
+                            string == other.string &&
+                            number == other.number
+                    }
+
+                    override fun hashCode(): Int = Objects.hash(string, number)
+
+                    override fun toString(): String =
+                        when {
+                            string != null -> "ComparisonFilterValueItem{string=$string}"
+                            number != null -> "ComparisonFilterValueItem{number=$number}"
+                            _json != null -> "ComparisonFilterValueItem{_unknown=$_json}"
+                            else -> throw IllegalStateException("Invalid ComparisonFilterValueItem")
+                        }
+
+                    companion object {
+
+                        @JvmStatic
+                        fun ofString(string: String) = ComparisonFilterValueItem(string = string)
+
+                        @JvmStatic
+                        fun ofNumber(number: Double) = ComparisonFilterValueItem(number = number)
+                    }
+
+                    /**
+                     * An interface that defines how to map each variant of
+                     * [ComparisonFilterValueItem] to a value of type [T].
+                     */
+                    interface Visitor<out T> {
+
+                        fun visitString(string: String): T
+
+                        fun visitNumber(number: Double): T
+
+                        /**
+                         * Maps an unknown variant of [ComparisonFilterValueItem] to a value of type
+                         * [T].
+                         *
+                         * An instance of [ComparisonFilterValueItem] can contain an unknown variant
+                         * if it was deserialized from data that doesn't match any known variant.
+                         * For example, if the SDK is on an older version than the API, then the API
+                         * may respond with new variants that the SDK is unaware of.
+                         *
+                         * @throws OpenAIInvalidDataException in the default implementation.
+                         */
+                        fun unknown(json: JsonValue?): T {
+                            throw OpenAIInvalidDataException(
+                                "Unknown ComparisonFilterValueItem: $json"
+                            )
+                        }
+                    }
+
+                    internal class Deserializer :
+                        BaseDeserializer<ComparisonFilterValueItem>(
+                            ComparisonFilterValueItem::class
+                        ) {
+
+                        override fun ObjectCodec.deserialize(
+                            node: JsonNode
+                        ): ComparisonFilterValueItem {
+                            val json = JsonValue.fromJsonNode(node)
+
+                            val bestMatches =
+                                sequenceOf(
+                                        tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                            ComparisonFilterValueItem(string = it, _json = json)
+                                        },
+                                        tryDeserialize(node, jacksonTypeRef<Double>())?.let {
+                                            ComparisonFilterValueItem(number = it, _json = json)
+                                        },
+                                    )
+                                    .filterNotNull()
+                                    .allMaxBy { it.validity() }
+                                    .toList()
+                            return when (bestMatches.size) {
+                                // This can happen if what we're deserializing is completely
+                                // incompatible with all the possible variants (e.g. deserializing
+                                // from boolean).
+                                0 -> ComparisonFilterValueItem(_json = json)
+                                1 -> bestMatches.single()
+                                // If there's more than one match with the highest validity, then
+                                // use the first completely valid match, or simply the first match
+                                // if none are completely valid.
+                                else ->
+                                    bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                            }
+                        }
+                    }
+
+                    internal class Serializer :
+                        BaseSerializer<ComparisonFilterValueItem>(
+                            ComparisonFilterValueItem::class
+                        ) {
+
+                        override fun serialize(
+                            value: ComparisonFilterValueItem,
+                            generator: JsonGenerator,
+                            provider: SerializerProvider,
+                        ) {
+                            when {
+                                value.string != null -> generator.writeObject(value.string)
+                                value.number != null -> generator.writeObject(value.number)
+                                value._json != null -> generator.writeObject(value._json)
+                                else ->
+                                    throw IllegalStateException("Invalid ComparisonFilterValueItem")
+                            }
+                        }
+                    }
+                }
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is ComparisonFilter &&
+                    key == other.key &&
+                    type == other.type &&
+                    value == other.value &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(key, type, value, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "ComparisonFilter{key=$key, type=$type, value=$value, additionalProperties=$additionalProperties}"
+        }
+
+        /** Combine multiple filters using `and` or `or`. */
+        class CompoundFilter
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val filters: JsonField<List<Filter>>,
+            private val type: JsonField<Type>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("filters")
+                @ExcludeMissing
+                filters: JsonField<List<Filter>> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
+            ) : this(filters, type, mutableMapOf())
+
+            /**
+             * Array of filters to combine. Items can be `ComparisonFilter` or `CompoundFilter`.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun filters(): List<Filter> = filters.getRequired("filters")
+
+            /**
+             * Type of operation: `and` or `or`.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun type(): Type = type.getRequired("type")
+
+            /**
+             * Returns the raw JSON value of [filters].
+             *
+             * Unlike [filters], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("filters")
+            @ExcludeMissing
+            fun _filters(): JsonField<List<Filter>> = filters
+
+            /**
+             * Returns the raw JSON value of [type].
+             *
+             * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [CompoundFilter].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .filters()
+                 * .type()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [CompoundFilter]. */
+            class Builder internal constructor() {
+
+                private var filters: JsonField<MutableList<Filter>>? = null
+                private var type: JsonField<Type>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(compoundFilter: CompoundFilter) = apply {
+                    filters = compoundFilter.filters.map { it.toMutableList() }
+                    type = compoundFilter.type
+                    additionalProperties = compoundFilter.additionalProperties.toMutableMap()
+                }
+
+                /**
+                 * Array of filters to combine. Items can be `ComparisonFilter` or `CompoundFilter`.
+                 */
+                fun filters(filters: List<Filter>) = filters(JsonField.of(filters))
+
+                /**
+                 * Sets [Builder.filters] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.filters] with a well-typed `List<Filter>` value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun filters(filters: JsonField<List<Filter>>) = apply {
+                    this.filters = filters.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [Filter] to [filters].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addFilter(filter: Filter) = apply {
+                    filters =
+                        (filters ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("filters", it).add(filter)
+                        }
+                }
+
+                /** Alias for calling [addFilter] with `Filter.ofComparison(comparison)`. */
+                fun addFilter(comparison: Filter.ComparisonFilter) =
+                    addFilter(Filter.ofComparison(comparison))
+
+                /** Alias for calling [addFilter] with `Filter.ofJsonValue(jsonValue)`. */
+                fun addFilter(jsonValue: JsonValue) = addFilter(Filter.ofJsonValue(jsonValue))
+
+                /** Type of operation: `and` or `or`. */
+                fun type(type: Type) = type(JsonField.of(type))
+
+                /**
+                 * Sets [Builder.type] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.type] with a well-typed [Type] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonField<Type>) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [CompoundFilter].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .filters()
+                 * .type()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): CompoundFilter =
+                    CompoundFilter(
+                        checkRequired("filters", filters).map { it.toImmutable() },
+                        checkRequired("type", type),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): CompoundFilter = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                filters().forEach { it.validate() }
+                type().validate()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (filters.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                    (type.asKnown().getOrNull()?.validity() ?: 0)
+
+            /**
+             * A filter used to compare a specified attribute key to a given value using a defined
+             * comparison operation.
+             */
+            @JsonDeserialize(using = Filter.Deserializer::class)
+            @JsonSerialize(using = Filter.Serializer::class)
+            class Filter
+            private constructor(
+                private val comparison: ComparisonFilter? = null,
+                private val jsonValue: JsonValue? = null,
+                private val _json: JsonValue? = null,
+            ) {
+
+                /**
+                 * A filter used to compare a specified attribute key to a given value using a
+                 * defined comparison operation.
+                 */
+                fun comparison(): Optional<ComparisonFilter> = Optional.ofNullable(comparison)
+
+                fun jsonValue(): Optional<JsonValue> = Optional.ofNullable(jsonValue)
+
+                fun isComparison(): Boolean = comparison != null
+
+                fun isJsonValue(): Boolean = jsonValue != null
+
+                /**
+                 * A filter used to compare a specified attribute key to a given value using a
+                 * defined comparison operation.
+                 */
+                fun asComparison(): ComparisonFilter = comparison.getOrThrow("comparison")
+
+                fun asJsonValue(): JsonValue = jsonValue.getOrThrow("jsonValue")
+
+                fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+                /**
+                 * Maps this instance's current variant to a value of type [T] using the given
+                 * [visitor].
+                 *
+                 * Note that this method is _not_ forwards compatible with new variants from the
+                 * API, unless [visitor] overrides [Visitor.unknown]. To handle variants not known
+                 * to this version of the SDK gracefully, consider overriding [Visitor.unknown]:
+                 * ```java
+                 * import com.openai.core.JsonValue;
+                 * import java.util.Optional;
+                 *
+                 * Optional<String> result = filter.accept(new Filter.Visitor<Optional<String>>() {
+                 *     @Override
+                 *     public Optional<String> visitComparison(ComparisonFilter comparison) {
+                 *         return Optional.of(comparison.toString());
+                 *     }
+                 *
+                 *     // ...
+                 *
+                 *     @Override
+                 *     public Optional<String> unknown(JsonValue json) {
+                 *         // Or inspect the `json`.
+                 *         return Optional.empty();
+                 *     }
+                 * });
+                 * ```
+                 *
+                 * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+                 *   [visitor] and the current variant is unknown.
+                 */
+                fun <T> accept(visitor: Visitor<T>): T =
+                    when {
+                        comparison != null -> visitor.visitComparison(comparison)
+                        jsonValue != null -> visitor.visitJsonValue(jsonValue)
+                        else -> visitor.unknown(_json)
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Filter = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    accept(
+                        object : Visitor<Unit> {
+                            override fun visitComparison(comparison: ComparisonFilter) {
+                                comparison.validate()
+                            }
+
+                            override fun visitJsonValue(jsonValue: JsonValue) {}
+                        }
+                    )
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    accept(
+                        object : Visitor<Int> {
+                            override fun visitComparison(comparison: ComparisonFilter) =
+                                comparison.validity()
+
+                            override fun visitJsonValue(jsonValue: JsonValue) = 1
+
+                            override fun unknown(json: JsonValue?) = 0
+                        }
+                    )
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Filter &&
+                        comparison == other.comparison &&
+                        jsonValue == other.jsonValue
+                }
+
+                override fun hashCode(): Int = Objects.hash(comparison, jsonValue)
+
+                override fun toString(): String =
+                    when {
+                        comparison != null -> "Filter{comparison=$comparison}"
+                        jsonValue != null -> "Filter{jsonValue=$jsonValue}"
+                        _json != null -> "Filter{_unknown=$_json}"
+                        else -> throw IllegalStateException("Invalid Filter")
+                    }
+
+                companion object {
+
+                    /**
+                     * A filter used to compare a specified attribute key to a given value using a
+                     * defined comparison operation.
+                     */
+                    @JvmStatic
+                    fun ofComparison(comparison: ComparisonFilter) = Filter(comparison = comparison)
+
+                    @JvmStatic fun ofJsonValue(jsonValue: JsonValue) = Filter(jsonValue = jsonValue)
+                }
+
+                /**
+                 * An interface that defines how to map each variant of [Filter] to a value of type
+                 * [T].
+                 */
+                interface Visitor<out T> {
+
+                    /**
+                     * A filter used to compare a specified attribute key to a given value using a
+                     * defined comparison operation.
+                     */
+                    fun visitComparison(comparison: ComparisonFilter): T
+
+                    fun visitJsonValue(jsonValue: JsonValue): T
+
+                    /**
+                     * Maps an unknown variant of [Filter] to a value of type [T].
+                     *
+                     * An instance of [Filter] can contain an unknown variant if it was deserialized
+                     * from data that doesn't match any known variant. For example, if the SDK is on
+                     * an older version than the API, then the API may respond with new variants
+                     * that the SDK is unaware of.
+                     *
+                     * @throws OpenAIInvalidDataException in the default implementation.
+                     */
+                    fun unknown(json: JsonValue?): T {
+                        throw OpenAIInvalidDataException("Unknown Filter: $json")
+                    }
+                }
+
+                internal class Deserializer : BaseDeserializer<Filter>(Filter::class) {
+
+                    override fun ObjectCodec.deserialize(node: JsonNode): Filter {
+                        val json = JsonValue.fromJsonNode(node)
+
+                        val bestMatches =
+                            sequenceOf(
+                                    tryDeserialize(node, jacksonTypeRef<ComparisonFilter>())?.let {
+                                        Filter(comparison = it, _json = json)
+                                    },
+                                    tryDeserialize(node, jacksonTypeRef<JsonValue>())?.let {
+                                        Filter(jsonValue = it, _json = json)
+                                    },
+                                )
+                                .filterNotNull()
+                                .allMaxBy { it.validity() }
+                                .toList()
+                        return when (bestMatches.size) {
+                            // This can happen if what we're deserializing is completely
+                            // incompatible with all the possible variants.
+                            0 -> Filter(_json = json)
+                            1 -> bestMatches.single()
+                            // If there's more than one match with the highest validity, then use
+                            // the first completely valid match, or simply the first match if none
+                            // are completely valid.
+                            else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                        }
+                    }
+                }
+
+                internal class Serializer : BaseSerializer<Filter>(Filter::class) {
+
+                    override fun serialize(
+                        value: Filter,
+                        generator: JsonGenerator,
+                        provider: SerializerProvider,
+                    ) {
+                        when {
+                            value.comparison != null -> generator.writeObject(value.comparison)
+                            value.jsonValue != null -> generator.writeObject(value.jsonValue)
+                            value._json != null -> generator.writeObject(value._json)
+                            else -> throw IllegalStateException("Invalid Filter")
+                        }
+                    }
+                }
+
+                /**
+                 * A filter used to compare a specified attribute key to a given value using a
+                 * defined comparison operation.
+                 */
+                class ComparisonFilter
+                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+                private constructor(
+                    private val key: JsonField<String>,
+                    private val type: JsonField<Type>,
+                    private val value: JsonField<Value>,
+                    private val additionalProperties: MutableMap<String, JsonValue>,
+                ) {
+
+                    @JsonCreator
+                    private constructor(
+                        @JsonProperty("key")
+                        @ExcludeMissing
+                        key: JsonField<String> = JsonMissing.of(),
+                        @JsonProperty("type")
+                        @ExcludeMissing
+                        type: JsonField<Type> = JsonMissing.of(),
+                        @JsonProperty("value")
+                        @ExcludeMissing
+                        value: JsonField<Value> = JsonMissing.of(),
+                    ) : this(key, type, value, mutableMapOf())
+
+                    /**
+                     * The key to compare against the value.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun key(): String = key.getRequired("key")
+
+                    /**
+                     * Specifies the comparison operator: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`,
+                     * `in`, `nin`.
+                     * - `eq`: equals
+                     * - `ne`: not equal
+                     * - `gt`: greater than
+                     * - `gte`: greater than or equal
+                     * - `lt`: less than
+                     * - `lte`: less than or equal
+                     * - `in`: in
+                     * - `nin`: not in
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun type(): Type = type.getRequired("type")
+
+                    /**
+                     * The value to compare against the attribute key; supports string, number, or
+                     * boolean types.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun value(): Value = value.getRequired("value")
+
+                    /**
+                     * Returns the raw JSON value of [key].
+                     *
+                     * Unlike [key], this method doesn't throw if the JSON field has an unexpected
+                     * type.
+                     */
+                    @JsonProperty("key") @ExcludeMissing fun _key(): JsonField<String> = key
+
+                    /**
+                     * Returns the raw JSON value of [type].
+                     *
+                     * Unlike [type], this method doesn't throw if the JSON field has an unexpected
+                     * type.
+                     */
+                    @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+
+                    /**
+                     * Returns the raw JSON value of [value].
+                     *
+                     * Unlike [value], this method doesn't throw if the JSON field has an unexpected
+                     * type.
+                     */
+                    @JsonProperty("value") @ExcludeMissing fun _value(): JsonField<Value> = value
+
+                    @JsonAnySetter
+                    private fun putAdditionalProperty(key: String, value: JsonValue) {
+                        additionalProperties.put(key, value)
+                    }
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> =
+                        Collections.unmodifiableMap(additionalProperties)
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of
+                         * [ComparisonFilter].
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .key()
+                         * .type()
+                         * .value()
+                         * ```
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [ComparisonFilter]. */
+                    class Builder internal constructor() {
+
+                        private var key: JsonField<String>? = null
+                        private var type: JsonField<Type>? = null
+                        private var value: JsonField<Value>? = null
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(comparisonFilter: ComparisonFilter) = apply {
+                            key = comparisonFilter.key
+                            type = comparisonFilter.type
+                            value = comparisonFilter.value
+                            additionalProperties =
+                                comparisonFilter.additionalProperties.toMutableMap()
+                        }
+
+                        /** The key to compare against the value. */
+                        fun key(key: String) = key(JsonField.of(key))
+
+                        /**
+                         * Sets [Builder.key] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.key] with a well-typed [String] value
+                         * instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun key(key: JsonField<String>) = apply { this.key = key }
+
+                        /**
+                         * Specifies the comparison operator: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`,
+                         * `in`, `nin`.
+                         * - `eq`: equals
+                         * - `ne`: not equal
+                         * - `gt`: greater than
+                         * - `gte`: greater than or equal
+                         * - `lt`: less than
+                         * - `lte`: less than or equal
+                         * - `in`: in
+                         * - `nin`: not in
+                         */
+                        fun type(type: Type) = type(JsonField.of(type))
+
+                        /**
+                         * Sets [Builder.type] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.type] with a well-typed [Type] value
+                         * instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun type(type: JsonField<Type>) = apply { this.type = type }
+
+                        /**
+                         * The value to compare against the attribute key; supports string, number,
+                         * or boolean types.
+                         */
+                        fun value(value: Value) = value(JsonField.of(value))
+
+                        /**
+                         * Sets [Builder.value] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.value] with a well-typed [Value] value
+                         * instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun value(value: JsonField<Value>) = apply { this.value = value }
+
+                        /** Alias for calling [value] with `Value.ofString(string)`. */
+                        fun value(string: String) = value(Value.ofString(string))
+
+                        /** Alias for calling [value] with `Value.ofNumber(number)`. */
+                        fun value(number: Double) = value(Value.ofNumber(number))
+
+                        /** Alias for calling [value] with `Value.ofBool(bool)`. */
+                        fun value(bool: Boolean) = value(Value.ofBool(bool))
+
+                        /**
+                         * Alias for calling [value] with
+                         * `Value.ofComparisonFilterValueItems(comparisonFilterValueItems)`.
+                         */
+                        fun valueOfComparisonFilterValueItems(
+                            comparisonFilterValueItems: List<Value.ComparisonFilterValueItem>
+                        ) = value(Value.ofComparisonFilterValueItems(comparisonFilterValueItems))
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [ComparisonFilter].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .key()
+                         * .type()
+                         * .value()
+                         * ```
+                         *
+                         * @throws IllegalStateException if any required field is unset.
+                         */
+                        fun build(): ComparisonFilter =
+                            ComparisonFilter(
+                                checkRequired("key", key),
+                                checkRequired("type", type),
+                                checkRequired("value", value),
+                                additionalProperties.toMutableMap(),
+                            )
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): ComparisonFilter = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        key()
+                        type().validate()
+                        value().validate()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        (if (key.asKnown().isPresent) 1 else 0) +
+                            (type.asKnown().getOrNull()?.validity() ?: 0) +
+                            (value.asKnown().getOrNull()?.validity() ?: 0)
+
+                    /**
+                     * Specifies the comparison operator: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`,
+                     * `in`, `nin`.
+                     * - `eq`: equals
+                     * - `ne`: not equal
+                     * - `gt`: greater than
+                     * - `gte`: greater than or equal
+                     * - `lt`: less than
+                     * - `lte`: less than or equal
+                     * - `in`: in
+                     * - `nin`: not in
+                     */
+                    class Type
+                    @JsonCreator
+                    private constructor(private val value: JsonField<String>) : Enum {
+
+                        /**
+                         * Returns this class instance's raw value.
+                         *
+                         * This is usually only useful if this instance was deserialized from data
+                         * that doesn't match any known member, and you want to know that value. For
+                         * example, if the SDK is on an older version than the API, then the API may
+                         * respond with new members that the SDK is unaware of.
+                         */
+                        @com.fasterxml.jackson.annotation.JsonValue
+                        fun _value(): JsonField<String> = value
+
+                        companion object {
+
+                            @JvmField val EQ = of("eq")
+
+                            @JvmField val NE = of("ne")
+
+                            @JvmField val GT = of("gt")
+
+                            @JvmField val GTE = of("gte")
+
+                            @JvmField val LT = of("lt")
+
+                            @JvmField val LTE = of("lte")
+
+                            @JvmField val IN = of("in")
+
+                            @JvmField val NIN = of("nin")
+
+                            @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+                        }
+
+                        /** An enum containing [Type]'s known values. */
+                        enum class Known {
+                            EQ,
+                            NE,
+                            GT,
+                            GTE,
+                            LT,
+                            LTE,
+                            IN,
+                            NIN,
+                        }
+
+                        /**
+                         * An enum containing [Type]'s known values, as well as an [_UNKNOWN]
+                         * member.
+                         *
+                         * An instance of [Type] can contain an unknown value in a couple of cases:
+                         * - It was deserialized from data that doesn't match any known member. For
+                         *   example, if the SDK is on an older version than the API, then the API
+                         *   may respond with new members that the SDK is unaware of.
+                         * - It was constructed with an arbitrary value using the [of] method.
+                         */
+                        enum class Value {
+                            EQ,
+                            NE,
+                            GT,
+                            GTE,
+                            LT,
+                            LTE,
+                            IN,
+                            NIN,
+                            /**
+                             * An enum member indicating that [Type] was instantiated with an
+                             * unknown value.
+                             */
+                            _UNKNOWN,
+                        }
+
+                        /**
+                         * Returns an enum member corresponding to this class instance's value, or
+                         * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                         *
+                         * Use the [known] method instead if you're certain the value is always
+                         * known or if you want to throw for the unknown case.
+                         */
+                        fun value(): Value =
+                            when (this) {
+                                EQ -> Value.EQ
+                                NE -> Value.NE
+                                GT -> Value.GT
+                                GTE -> Value.GTE
+                                LT -> Value.LT
+                                LTE -> Value.LTE
+                                IN -> Value.IN
+                                NIN -> Value.NIN
+                                else -> Value._UNKNOWN
+                            }
+
+                        /**
+                         * Returns an enum member corresponding to this class instance's value.
+                         *
+                         * Use the [value] method instead if you're uncertain the value is always
+                         * known and don't want to throw for the unknown case.
+                         *
+                         * @throws OpenAIInvalidDataException if this class instance's value is a
+                         *   not a known member.
+                         */
+                        fun known(): Known =
+                            when (this) {
+                                EQ -> Known.EQ
+                                NE -> Known.NE
+                                GT -> Known.GT
+                                GTE -> Known.GTE
+                                LT -> Known.LT
+                                LTE -> Known.LTE
+                                IN -> Known.IN
+                                NIN -> Known.NIN
+                                else -> throw OpenAIInvalidDataException("Unknown Type: $value")
+                            }
+
+                        /**
+                         * Returns this class instance's primitive wire representation.
+                         *
+                         * This differs from the [toString] method because that method is primarily
+                         * for debugging and generally doesn't throw.
+                         *
+                         * @throws OpenAIInvalidDataException if this class instance's value does
+                         *   not have the expected primitive type.
+                         */
+                        fun asString(): String =
+                            _value().asString().orElseThrow {
+                                OpenAIInvalidDataException("Value is not a String")
+                            }
+
+                        private var validated: Boolean = false
+
+                        /**
+                         * Validates that the types of all values in this object match their
+                         * expected types recursively.
+                         *
+                         * This method is _not_ forwards compatible with new types from the API for
+                         * existing fields.
+                         *
+                         * @throws OpenAIInvalidDataException if any value type in this object
+                         *   doesn't match its expected type.
+                         */
+                        fun validate(): Type = apply {
+                            if (validated) {
+                                return@apply
+                            }
+
+                            known()
+                            validated = true
+                        }
+
+                        fun isValid(): Boolean =
+                            try {
+                                validate()
+                                true
+                            } catch (e: OpenAIInvalidDataException) {
+                                false
+                            }
+
+                        /**
+                         * Returns a score indicating how many valid values are contained in this
+                         * object recursively.
+                         *
+                         * Used for best match union deserialization.
+                         */
+                        @JvmSynthetic
+                        internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                        override fun equals(other: Any?): Boolean {
+                            if (this === other) {
+                                return true
+                            }
+
+                            return other is Type && value == other.value
+                        }
+
+                        override fun hashCode() = value.hashCode()
+
+                        override fun toString() = value.toString()
+                    }
+
+                    /**
+                     * The value to compare against the attribute key; supports string, number, or
+                     * boolean types.
+                     */
+                    @JsonDeserialize(using = Value.Deserializer::class)
+                    @JsonSerialize(using = Value.Serializer::class)
+                    class Value
+                    private constructor(
+                        private val string: String? = null,
+                        private val number: Double? = null,
+                        private val bool: Boolean? = null,
+                        private val comparisonFilterValueItems: List<ComparisonFilterValueItem>? =
+                            null,
+                        private val _json: JsonValue? = null,
+                    ) {
+
+                        fun string(): Optional<String> = Optional.ofNullable(string)
+
+                        fun number(): Optional<Double> = Optional.ofNullable(number)
+
+                        fun bool(): Optional<Boolean> = Optional.ofNullable(bool)
+
+                        fun comparisonFilterValueItems():
+                            Optional<List<ComparisonFilterValueItem>> =
+                            Optional.ofNullable(comparisonFilterValueItems)
+
+                        fun isString(): Boolean = string != null
+
+                        fun isNumber(): Boolean = number != null
+
+                        fun isBool(): Boolean = bool != null
+
+                        fun isComparisonFilterValueItems(): Boolean =
+                            comparisonFilterValueItems != null
+
+                        fun asString(): String = string.getOrThrow("string")
+
+                        fun asNumber(): Double = number.getOrThrow("number")
+
+                        fun asBool(): Boolean = bool.getOrThrow("bool")
+
+                        fun asComparisonFilterValueItems(): List<ComparisonFilterValueItem> =
+                            comparisonFilterValueItems.getOrThrow("comparisonFilterValueItems")
+
+                        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+                        /**
+                         * Maps this instance's current variant to a value of type [T] using the
+                         * given [visitor].
+                         *
+                         * Note that this method is _not_ forwards compatible with new variants from
+                         * the API, unless [visitor] overrides [Visitor.unknown]. To handle variants
+                         * not known to this version of the SDK gracefully, consider overriding
+                         * [Visitor.unknown]:
+                         * ```java
+                         * import com.openai.core.JsonValue;
+                         * import java.util.Optional;
+                         *
+                         * Optional<String> result = value.accept(new Value.Visitor<Optional<String>>() {
+                         *     @Override
+                         *     public Optional<String> visitString(String string) {
+                         *         return Optional.of(string.toString());
+                         *     }
+                         *
+                         *     // ...
+                         *
+                         *     @Override
+                         *     public Optional<String> unknown(JsonValue json) {
+                         *         // Or inspect the `json`.
+                         *         return Optional.empty();
+                         *     }
+                         * });
+                         * ```
+                         *
+                         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden
+                         *   in [visitor] and the current variant is unknown.
+                         */
+                        fun <T> accept(visitor: Visitor<T>): T =
+                            when {
+                                string != null -> visitor.visitString(string)
+                                number != null -> visitor.visitNumber(number)
+                                bool != null -> visitor.visitBool(bool)
+                                comparisonFilterValueItems != null ->
+                                    visitor.visitComparisonFilterValueItems(
+                                        comparisonFilterValueItems
+                                    )
+                                else -> visitor.unknown(_json)
+                            }
+
+                        private var validated: Boolean = false
+
+                        /**
+                         * Validates that the types of all values in this object match their
+                         * expected types recursively.
+                         *
+                         * This method is _not_ forwards compatible with new types from the API for
+                         * existing fields.
+                         *
+                         * @throws OpenAIInvalidDataException if any value type in this object
+                         *   doesn't match its expected type.
+                         */
+                        fun validate(): Value = apply {
+                            if (validated) {
+                                return@apply
+                            }
+
+                            accept(
+                                object : Visitor<Unit> {
+                                    override fun visitString(string: String) {}
+
+                                    override fun visitNumber(number: Double) {}
+
+                                    override fun visitBool(bool: Boolean) {}
+
+                                    override fun visitComparisonFilterValueItems(
+                                        comparisonFilterValueItems: List<ComparisonFilterValueItem>
+                                    ) {
+                                        comparisonFilterValueItems.forEach { it.validate() }
+                                    }
+                                }
+                            )
+                            validated = true
+                        }
+
+                        fun isValid(): Boolean =
+                            try {
+                                validate()
+                                true
+                            } catch (e: OpenAIInvalidDataException) {
+                                false
+                            }
+
+                        /**
+                         * Returns a score indicating how many valid values are contained in this
+                         * object recursively.
+                         *
+                         * Used for best match union deserialization.
+                         */
+                        @JvmSynthetic
+                        internal fun validity(): Int =
+                            accept(
+                                object : Visitor<Int> {
+                                    override fun visitString(string: String) = 1
+
+                                    override fun visitNumber(number: Double) = 1
+
+                                    override fun visitBool(bool: Boolean) = 1
+
+                                    override fun visitComparisonFilterValueItems(
+                                        comparisonFilterValueItems: List<ComparisonFilterValueItem>
+                                    ) = comparisonFilterValueItems.sumOf { it.validity().toInt() }
+
+                                    override fun unknown(json: JsonValue?) = 0
+                                }
+                            )
+
+                        override fun equals(other: Any?): Boolean {
+                            if (this === other) {
+                                return true
+                            }
+
+                            return other is Value &&
+                                string == other.string &&
+                                number == other.number &&
+                                bool == other.bool &&
+                                comparisonFilterValueItems == other.comparisonFilterValueItems
+                        }
+
+                        override fun hashCode(): Int =
+                            Objects.hash(string, number, bool, comparisonFilterValueItems)
+
+                        override fun toString(): String =
+                            when {
+                                string != null -> "Value{string=$string}"
+                                number != null -> "Value{number=$number}"
+                                bool != null -> "Value{bool=$bool}"
+                                comparisonFilterValueItems != null ->
+                                    "Value{comparisonFilterValueItems=$comparisonFilterValueItems}"
+                                _json != null -> "Value{_unknown=$_json}"
+                                else -> throw IllegalStateException("Invalid Value")
+                            }
+
+                        companion object {
+
+                            @JvmStatic fun ofString(string: String) = Value(string = string)
+
+                            @JvmStatic fun ofNumber(number: Double) = Value(number = number)
+
+                            @JvmStatic fun ofBool(bool: Boolean) = Value(bool = bool)
+
+                            @JvmStatic
+                            fun ofComparisonFilterValueItems(
+                                comparisonFilterValueItems: List<ComparisonFilterValueItem>
+                            ) =
+                                Value(
+                                    comparisonFilterValueItems =
+                                        comparisonFilterValueItems.toImmutable()
+                                )
+                        }
+
+                        /**
+                         * An interface that defines how to map each variant of [Value] to a value
+                         * of type [T].
+                         */
+                        interface Visitor<out T> {
+
+                            fun visitString(string: String): T
+
+                            fun visitNumber(number: Double): T
+
+                            fun visitBool(bool: Boolean): T
+
+                            fun visitComparisonFilterValueItems(
+                                comparisonFilterValueItems: List<ComparisonFilterValueItem>
+                            ): T
+
+                            /**
+                             * Maps an unknown variant of [Value] to a value of type [T].
+                             *
+                             * An instance of [Value] can contain an unknown variant if it was
+                             * deserialized from data that doesn't match any known variant. For
+                             * example, if the SDK is on an older version than the API, then the API
+                             * may respond with new variants that the SDK is unaware of.
+                             *
+                             * @throws OpenAIInvalidDataException in the default implementation.
+                             */
+                            fun unknown(json: JsonValue?): T {
+                                throw OpenAIInvalidDataException("Unknown Value: $json")
+                            }
+                        }
+
+                        internal class Deserializer : BaseDeserializer<Value>(Value::class) {
+
+                            override fun ObjectCodec.deserialize(node: JsonNode): Value {
+                                val json = JsonValue.fromJsonNode(node)
+
+                                val bestMatches =
+                                    sequenceOf(
+                                            tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                                Value(string = it, _json = json)
+                                            },
+                                            tryDeserialize(node, jacksonTypeRef<Double>())?.let {
+                                                Value(number = it, _json = json)
+                                            },
+                                            tryDeserialize(node, jacksonTypeRef<Boolean>())?.let {
+                                                Value(bool = it, _json = json)
+                                            },
+                                            tryDeserialize(
+                                                    node,
+                                                    jacksonTypeRef<
+                                                        List<ComparisonFilterValueItem>
+                                                    >(),
+                                                )
+                                                ?.let {
+                                                    Value(
+                                                        comparisonFilterValueItems = it,
+                                                        _json = json,
+                                                    )
+                                                },
+                                        )
+                                        .filterNotNull()
+                                        .allMaxBy { it.validity() }
+                                        .toList()
+                                return when (bestMatches.size) {
+                                    // This can happen if what we're deserializing is completely
+                                    // incompatible with all the possible variants (e.g.
+                                    // deserializing from object).
+                                    0 -> Value(_json = json)
+                                    1 -> bestMatches.single()
+                                    // If there's more than one match with the highest validity,
+                                    // then use the first completely valid match, or simply the
+                                    // first match if none are completely valid.
+                                    else ->
+                                        bestMatches.firstOrNull { it.isValid() }
+                                            ?: bestMatches.first()
+                                }
+                            }
+                        }
+
+                        internal class Serializer : BaseSerializer<Value>(Value::class) {
+
+                            override fun serialize(
+                                value: Value,
+                                generator: JsonGenerator,
+                                provider: SerializerProvider,
+                            ) {
+                                when {
+                                    value.string != null -> generator.writeObject(value.string)
+                                    value.number != null -> generator.writeObject(value.number)
+                                    value.bool != null -> generator.writeObject(value.bool)
+                                    value.comparisonFilterValueItems != null ->
+                                        generator.writeObject(value.comparisonFilterValueItems)
+                                    value._json != null -> generator.writeObject(value._json)
+                                    else -> throw IllegalStateException("Invalid Value")
+                                }
+                            }
+                        }
+
+                        @JsonDeserialize(using = ComparisonFilterValueItem.Deserializer::class)
+                        @JsonSerialize(using = ComparisonFilterValueItem.Serializer::class)
+                        class ComparisonFilterValueItem
+                        private constructor(
+                            private val string: String? = null,
+                            private val number: Double? = null,
+                            private val _json: JsonValue? = null,
+                        ) {
+
+                            fun string(): Optional<String> = Optional.ofNullable(string)
+
+                            fun number(): Optional<Double> = Optional.ofNullable(number)
+
+                            fun isString(): Boolean = string != null
+
+                            fun isNumber(): Boolean = number != null
+
+                            fun asString(): String = string.getOrThrow("string")
+
+                            fun asNumber(): Double = number.getOrThrow("number")
+
+                            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+                            /**
+                             * Maps this instance's current variant to a value of type [T] using the
+                             * given [visitor].
+                             *
+                             * Note that this method is _not_ forwards compatible with new variants
+                             * from the API, unless [visitor] overrides [Visitor.unknown]. To handle
+                             * variants not known to this version of the SDK gracefully, consider
+                             * overriding [Visitor.unknown]:
+                             * ```java
+                             * import com.openai.core.JsonValue;
+                             * import java.util.Optional;
+                             *
+                             * Optional<String> result = comparisonFilterValueItem.accept(new ComparisonFilterValueItem.Visitor<Optional<String>>() {
+                             *     @Override
+                             *     public Optional<String> visitString(String string) {
+                             *         return Optional.of(string.toString());
+                             *     }
+                             *
+                             *     // ...
+                             *
+                             *     @Override
+                             *     public Optional<String> unknown(JsonValue json) {
+                             *         // Or inspect the `json`.
+                             *         return Optional.empty();
+                             *     }
+                             * });
+                             * ```
+                             *
+                             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not
+                             *   overridden in [visitor] and the current variant is unknown.
+                             */
+                            fun <T> accept(visitor: Visitor<T>): T =
+                                when {
+                                    string != null -> visitor.visitString(string)
+                                    number != null -> visitor.visitNumber(number)
+                                    else -> visitor.unknown(_json)
+                                }
+
+                            private var validated: Boolean = false
+
+                            /**
+                             * Validates that the types of all values in this object match their
+                             * expected types recursively.
+                             *
+                             * This method is _not_ forwards compatible with new types from the API
+                             * for existing fields.
+                             *
+                             * @throws OpenAIInvalidDataException if any value type in this object
+                             *   doesn't match its expected type.
+                             */
+                            fun validate(): ComparisonFilterValueItem = apply {
+                                if (validated) {
+                                    return@apply
+                                }
+
+                                accept(
+                                    object : Visitor<Unit> {
+                                        override fun visitString(string: String) {}
+
+                                        override fun visitNumber(number: Double) {}
+                                    }
+                                )
+                                validated = true
+                            }
+
+                            fun isValid(): Boolean =
+                                try {
+                                    validate()
+                                    true
+                                } catch (e: OpenAIInvalidDataException) {
+                                    false
+                                }
+
+                            /**
+                             * Returns a score indicating how many valid values are contained in
+                             * this object recursively.
+                             *
+                             * Used for best match union deserialization.
+                             */
+                            @JvmSynthetic
+                            internal fun validity(): Int =
+                                accept(
+                                    object : Visitor<Int> {
+                                        override fun visitString(string: String) = 1
+
+                                        override fun visitNumber(number: Double) = 1
+
+                                        override fun unknown(json: JsonValue?) = 0
+                                    }
+                                )
+
+                            override fun equals(other: Any?): Boolean {
+                                if (this === other) {
+                                    return true
+                                }
+
+                                return other is ComparisonFilterValueItem &&
+                                    string == other.string &&
+                                    number == other.number
+                            }
+
+                            override fun hashCode(): Int = Objects.hash(string, number)
+
+                            override fun toString(): String =
+                                when {
+                                    string != null -> "ComparisonFilterValueItem{string=$string}"
+                                    number != null -> "ComparisonFilterValueItem{number=$number}"
+                                    _json != null -> "ComparisonFilterValueItem{_unknown=$_json}"
+                                    else ->
+                                        throw IllegalStateException(
+                                            "Invalid ComparisonFilterValueItem"
+                                        )
+                                }
+
+                            companion object {
+
+                                @JvmStatic
+                                fun ofString(string: String) =
+                                    ComparisonFilterValueItem(string = string)
+
+                                @JvmStatic
+                                fun ofNumber(number: Double) =
+                                    ComparisonFilterValueItem(number = number)
+                            }
+
+                            /**
+                             * An interface that defines how to map each variant of
+                             * [ComparisonFilterValueItem] to a value of type [T].
+                             */
+                            interface Visitor<out T> {
+
+                                fun visitString(string: String): T
+
+                                fun visitNumber(number: Double): T
+
+                                /**
+                                 * Maps an unknown variant of [ComparisonFilterValueItem] to a value
+                                 * of type [T].
+                                 *
+                                 * An instance of [ComparisonFilterValueItem] can contain an unknown
+                                 * variant if it was deserialized from data that doesn't match any
+                                 * known variant. For example, if the SDK is on an older version
+                                 * than the API, then the API may respond with new variants that the
+                                 * SDK is unaware of.
+                                 *
+                                 * @throws OpenAIInvalidDataException in the default implementation.
+                                 */
+                                fun unknown(json: JsonValue?): T {
+                                    throw OpenAIInvalidDataException(
+                                        "Unknown ComparisonFilterValueItem: $json"
+                                    )
+                                }
+                            }
+
+                            internal class Deserializer :
+                                BaseDeserializer<ComparisonFilterValueItem>(
+                                    ComparisonFilterValueItem::class
+                                ) {
+
+                                override fun ObjectCodec.deserialize(
+                                    node: JsonNode
+                                ): ComparisonFilterValueItem {
+                                    val json = JsonValue.fromJsonNode(node)
+
+                                    val bestMatches =
+                                        sequenceOf(
+                                                tryDeserialize(node, jacksonTypeRef<String>())
+                                                    ?.let {
+                                                        ComparisonFilterValueItem(
+                                                            string = it,
+                                                            _json = json,
+                                                        )
+                                                    },
+                                                tryDeserialize(node, jacksonTypeRef<Double>())
+                                                    ?.let {
+                                                        ComparisonFilterValueItem(
+                                                            number = it,
+                                                            _json = json,
+                                                        )
+                                                    },
+                                            )
+                                            .filterNotNull()
+                                            .allMaxBy { it.validity() }
+                                            .toList()
+                                    return when (bestMatches.size) {
+                                        // This can happen if what we're deserializing is completely
+                                        // incompatible with all the possible variants (e.g.
+                                        // deserializing from boolean).
+                                        0 -> ComparisonFilterValueItem(_json = json)
+                                        1 -> bestMatches.single()
+                                        // If there's more than one match with the highest validity,
+                                        // then use the first completely valid match, or simply the
+                                        // first match if none are completely valid.
+                                        else ->
+                                            bestMatches.firstOrNull { it.isValid() }
+                                                ?: bestMatches.first()
+                                    }
+                                }
+                            }
+
+                            internal class Serializer :
+                                BaseSerializer<ComparisonFilterValueItem>(
+                                    ComparisonFilterValueItem::class
+                                ) {
+
+                                override fun serialize(
+                                    value: ComparisonFilterValueItem,
+                                    generator: JsonGenerator,
+                                    provider: SerializerProvider,
+                                ) {
+                                    when {
+                                        value.string != null -> generator.writeObject(value.string)
+                                        value.number != null -> generator.writeObject(value.number)
+                                        value._json != null -> generator.writeObject(value._json)
+                                        else ->
+                                            throw IllegalStateException(
+                                                "Invalid ComparisonFilterValueItem"
+                                            )
+                                    }
+                                }
+                            }
+                        }
+                    }
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is ComparisonFilter &&
+                            key == other.key &&
+                            type == other.type &&
+                            value == other.value &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy {
+                        Objects.hash(key, type, value, additionalProperties)
+                    }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "ComparisonFilter{key=$key, type=$type, value=$value, additionalProperties=$additionalProperties}"
+                }
+            }
+
+            /** Type of operation: `and` or `or`. */
+            class Type @JsonCreator private constructor(private val value: JsonField<String>) :
+                Enum {
+
+                /**
+                 * Returns this class instance's raw value.
+                 *
+                 * This is usually only useful if this instance was deserialized from data that
+                 * doesn't match any known member, and you want to know that value. For example, if
+                 * the SDK is on an older version than the API, then the API may respond with new
+                 * members that the SDK is unaware of.
+                 */
+                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+                companion object {
+
+                    @JvmField val AND = of("and")
+
+                    @JvmField val OR = of("or")
+
+                    @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+                }
+
+                /** An enum containing [Type]'s known values. */
+                enum class Known {
+                    AND,
+                    OR,
+                }
+
+                /**
+                 * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
+                 *
+                 * An instance of [Type] can contain an unknown value in a couple of cases:
+                 * - It was deserialized from data that doesn't match any known member. For example,
+                 *   if the SDK is on an older version than the API, then the API may respond with
+                 *   new members that the SDK is unaware of.
+                 * - It was constructed with an arbitrary value using the [of] method.
+                 */
+                enum class Value {
+                    AND,
+                    OR,
+                    /**
+                     * An enum member indicating that [Type] was instantiated with an unknown value.
+                     */
+                    _UNKNOWN,
+                }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value, or
+                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                 *
+                 * Use the [known] method instead if you're certain the value is always known or if
+                 * you want to throw for the unknown case.
+                 */
+                fun value(): Value =
+                    when (this) {
+                        AND -> Value.AND
+                        OR -> Value.OR
+                        else -> Value._UNKNOWN
+                    }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value.
+                 *
+                 * Use the [value] method instead if you're uncertain the value is always known and
+                 * don't want to throw for the unknown case.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                 *   known member.
+                 */
+                fun known(): Known =
+                    when (this) {
+                        AND -> Known.AND
+                        OR -> Known.OR
+                        else -> throw OpenAIInvalidDataException("Unknown Type: $value")
+                    }
+
+                /**
+                 * Returns this class instance's primitive wire representation.
+                 *
+                 * This differs from the [toString] method because that method is primarily for
+                 * debugging and generally doesn't throw.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value does not have
+                 *   the expected primitive type.
+                 */
+                fun asString(): String =
+                    _value().asString().orElseThrow {
+                        OpenAIInvalidDataException("Value is not a String")
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Type = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    known()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Type && value == other.value
+                }
+
+                override fun hashCode() = value.hashCode()
+
+                override fun toString() = value.toString()
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is CompoundFilter &&
+                    filters == other.filters &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(filters, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "CompoundFilter{filters=$filters, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    /** Ranking options for search. */
+    class RankingOptions
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val hybridSearch: JsonField<HybridSearch>,
+        private val ranker: JsonField<Ranker>,
+        private val scoreThreshold: JsonField<Double>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("hybrid_search")
+            @ExcludeMissing
+            hybridSearch: JsonField<HybridSearch> = JsonMissing.of(),
+            @JsonProperty("ranker") @ExcludeMissing ranker: JsonField<Ranker> = JsonMissing.of(),
+            @JsonProperty("score_threshold")
+            @ExcludeMissing
+            scoreThreshold: JsonField<Double> = JsonMissing.of(),
+        ) : this(hybridSearch, ranker, scoreThreshold, mutableMapOf())
+
+        /**
+         * Weights that control how reciprocal rank fusion balances semantic embedding matches
+         * versus sparse keyword matches when hybrid search is enabled.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun hybridSearch(): Optional<HybridSearch> = hybridSearch.getOptional("hybrid_search")
+
+        /**
+         * The ranker to use for the file search.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun ranker(): Optional<Ranker> = ranker.getOptional("ranker")
+
+        /**
+         * The score threshold for the file search, a number between 0 and 1. Numbers closer to 1
+         * will attempt to return only the most relevant results, but may return fewer results.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun scoreThreshold(): Optional<Double> = scoreThreshold.getOptional("score_threshold")
+
+        /**
+         * Returns the raw JSON value of [hybridSearch].
+         *
+         * Unlike [hybridSearch], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("hybrid_search")
+        @ExcludeMissing
+        fun _hybridSearch(): JsonField<HybridSearch> = hybridSearch
+
+        /**
+         * Returns the raw JSON value of [ranker].
+         *
+         * Unlike [ranker], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("ranker") @ExcludeMissing fun _ranker(): JsonField<Ranker> = ranker
+
+        /**
+         * Returns the raw JSON value of [scoreThreshold].
+         *
+         * Unlike [scoreThreshold], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("score_threshold")
+        @ExcludeMissing
+        fun _scoreThreshold(): JsonField<Double> = scoreThreshold
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [RankingOptions]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [RankingOptions]. */
+        class Builder internal constructor() {
+
+            private var hybridSearch: JsonField<HybridSearch> = JsonMissing.of()
+            private var ranker: JsonField<Ranker> = JsonMissing.of()
+            private var scoreThreshold: JsonField<Double> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(rankingOptions: RankingOptions) = apply {
+                hybridSearch = rankingOptions.hybridSearch
+                ranker = rankingOptions.ranker
+                scoreThreshold = rankingOptions.scoreThreshold
+                additionalProperties = rankingOptions.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Weights that control how reciprocal rank fusion balances semantic embedding matches
+             * versus sparse keyword matches when hybrid search is enabled.
+             */
+            fun hybridSearch(hybridSearch: HybridSearch) = hybridSearch(JsonField.of(hybridSearch))
+
+            /**
+             * Sets [Builder.hybridSearch] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.hybridSearch] with a well-typed [HybridSearch] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun hybridSearch(hybridSearch: JsonField<HybridSearch>) = apply {
+                this.hybridSearch = hybridSearch
+            }
+
+            /** The ranker to use for the file search. */
+            fun ranker(ranker: Ranker) = ranker(JsonField.of(ranker))
+
+            /**
+             * Sets [Builder.ranker] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.ranker] with a well-typed [Ranker] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun ranker(ranker: JsonField<Ranker>) = apply { this.ranker = ranker }
+
+            /**
+             * The score threshold for the file search, a number between 0 and 1. Numbers closer to
+             * 1 will attempt to return only the most relevant results, but may return fewer
+             * results.
+             */
+            fun scoreThreshold(scoreThreshold: Double) =
+                scoreThreshold(JsonField.of(scoreThreshold))
+
+            /**
+             * Sets [Builder.scoreThreshold] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.scoreThreshold] with a well-typed [Double] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun scoreThreshold(scoreThreshold: JsonField<Double>) = apply {
+                this.scoreThreshold = scoreThreshold
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [RankingOptions].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): RankingOptions =
+                RankingOptions(
+                    hybridSearch,
+                    ranker,
+                    scoreThreshold,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): RankingOptions = apply {
+            if (validated) {
+                return@apply
+            }
+
+            hybridSearch().ifPresent { it.validate() }
+            ranker().ifPresent { it.validate() }
+            scoreThreshold()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (hybridSearch.asKnown().getOrNull()?.validity() ?: 0) +
+                (ranker.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (scoreThreshold.asKnown().isPresent) 1 else 0)
+
+        /**
+         * Weights that control how reciprocal rank fusion balances semantic embedding matches
+         * versus sparse keyword matches when hybrid search is enabled.
+         */
+        class HybridSearch
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val embeddingWeight: JsonField<Double>,
+            private val textWeight: JsonField<Double>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("embedding_weight")
+                @ExcludeMissing
+                embeddingWeight: JsonField<Double> = JsonMissing.of(),
+                @JsonProperty("text_weight")
+                @ExcludeMissing
+                textWeight: JsonField<Double> = JsonMissing.of(),
+            ) : this(embeddingWeight, textWeight, mutableMapOf())
+
+            /**
+             * The weight of the embedding in the reciprocal ranking fusion.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun embeddingWeight(): Double = embeddingWeight.getRequired("embedding_weight")
+
+            /**
+             * The weight of the text in the reciprocal ranking fusion.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun textWeight(): Double = textWeight.getRequired("text_weight")
+
+            /**
+             * Returns the raw JSON value of [embeddingWeight].
+             *
+             * Unlike [embeddingWeight], this method doesn't throw if the JSON field has an
+             * unexpected type.
+             */
+            @JsonProperty("embedding_weight")
+            @ExcludeMissing
+            fun _embeddingWeight(): JsonField<Double> = embeddingWeight
+
+            /**
+             * Returns the raw JSON value of [textWeight].
+             *
+             * Unlike [textWeight], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("text_weight")
+            @ExcludeMissing
+            fun _textWeight(): JsonField<Double> = textWeight
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [HybridSearch].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .embeddingWeight()
+                 * .textWeight()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [HybridSearch]. */
+            class Builder internal constructor() {
+
+                private var embeddingWeight: JsonField<Double>? = null
+                private var textWeight: JsonField<Double>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(hybridSearch: HybridSearch) = apply {
+                    embeddingWeight = hybridSearch.embeddingWeight
+                    textWeight = hybridSearch.textWeight
+                    additionalProperties = hybridSearch.additionalProperties.toMutableMap()
+                }
+
+                /** The weight of the embedding in the reciprocal ranking fusion. */
+                fun embeddingWeight(embeddingWeight: Double) =
+                    embeddingWeight(JsonField.of(embeddingWeight))
+
+                /**
+                 * Sets [Builder.embeddingWeight] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.embeddingWeight] with a well-typed [Double]
+                 * value instead. This method is primarily for setting the field to an undocumented
+                 * or not yet supported value.
+                 */
+                fun embeddingWeight(embeddingWeight: JsonField<Double>) = apply {
+                    this.embeddingWeight = embeddingWeight
+                }
+
+                /** The weight of the text in the reciprocal ranking fusion. */
+                fun textWeight(textWeight: Double) = textWeight(JsonField.of(textWeight))
+
+                /**
+                 * Sets [Builder.textWeight] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.textWeight] with a well-typed [Double] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun textWeight(textWeight: JsonField<Double>) = apply {
+                    this.textWeight = textWeight
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [HybridSearch].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .embeddingWeight()
+                 * .textWeight()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): HybridSearch =
+                    HybridSearch(
+                        checkRequired("embeddingWeight", embeddingWeight),
+                        checkRequired("textWeight", textWeight),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): HybridSearch = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                embeddingWeight()
+                textWeight()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (embeddingWeight.asKnown().isPresent) 1 else 0) +
+                    (if (textWeight.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is HybridSearch &&
+                    embeddingWeight == other.embeddingWeight &&
+                    textWeight == other.textWeight &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(embeddingWeight, textWeight, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "HybridSearch{embeddingWeight=$embeddingWeight, textWeight=$textWeight, additionalProperties=$additionalProperties}"
+        }
+
+        /** The ranker to use for the file search. */
+        class Ranker @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmField val DEFAULT_2024_11_15 = of("default-2024-11-15")
+
+                @JvmStatic fun of(value: String) = Ranker(JsonField.of(value))
+            }
+
+            /** An enum containing [Ranker]'s known values. */
+            enum class Known {
+                AUTO,
+                DEFAULT_2024_11_15,
+            }
+
+            /**
+             * An enum containing [Ranker]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Ranker] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                AUTO,
+                DEFAULT_2024_11_15,
+                /**
+                 * An enum member indicating that [Ranker] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    AUTO -> Value.AUTO
+                    DEFAULT_2024_11_15 -> Value.DEFAULT_2024_11_15
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    AUTO -> Known.AUTO
+                    DEFAULT_2024_11_15 -> Known.DEFAULT_2024_11_15
+                    else -> throw OpenAIInvalidDataException("Unknown Ranker: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Ranker = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Ranker && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is RankingOptions &&
+                hybridSearch == other.hybridSearch &&
+                ranker == other.ranker &&
+                scoreThreshold == other.scoreThreshold &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(hybridSearch, ranker, scoreThreshold, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "RankingOptions{hybridSearch=$hybridSearch, ranker=$ranker, scoreThreshold=$scoreThreshold, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaFileSearchTool &&
+            type == other.type &&
+            vectorStoreIds == other.vectorStoreIds &&
+            filters == other.filters &&
+            maxNumResults == other.maxNumResults &&
+            rankingOptions == other.rankingOptions &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            type,
+            vectorStoreIds,
+            filters,
+            maxNumResults,
+            rankingOptions,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaFileSearchTool{type=$type, vectorStoreIds=$vectorStoreIds, filters=$filters, maxNumResults=$maxNumResults, rankingOptions=$rankingOptions, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaFunctionShellTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaFunctionShellTool.kt
new file mode 100644
index 000000000..355f51659
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaFunctionShellTool.kt
@@ -0,0 +1,699 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** A tool that allows the model to execute shell commands. */
+class BetaFunctionShellTool
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonValue,
+    private val allowedCallers: JsonField<List<AllowedCaller>>,
+    private val environment: JsonField<Environment>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("allowed_callers")
+        @ExcludeMissing
+        allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
+        @JsonProperty("environment")
+        @ExcludeMissing
+        environment: JsonField<Environment> = JsonMissing.of(),
+    ) : this(type, allowedCallers, environment, mutableMapOf())
+
+    /**
+     * The type of the shell tool. Always `shell`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("shell")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The tool invocation context(s).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun allowedCallers(): Optional<List<AllowedCaller>> =
+        allowedCallers.getOptional("allowed_callers")
+
+    /**
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun environment(): Optional<Environment> = environment.getOptional("environment")
+
+    /**
+     * Returns the raw JSON value of [allowedCallers].
+     *
+     * Unlike [allowedCallers], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("allowed_callers")
+    @ExcludeMissing
+    fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
+    /**
+     * Returns the raw JSON value of [environment].
+     *
+     * Unlike [environment], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("environment")
+    @ExcludeMissing
+    fun _environment(): JsonField<Environment> = environment
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [BetaFunctionShellTool]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaFunctionShellTool]. */
+    class Builder internal constructor() {
+
+        private var type: JsonValue = JsonValue.from("shell")
+        private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
+        private var environment: JsonField<Environment> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaFunctionShellTool: BetaFunctionShellTool) = apply {
+            type = betaFunctionShellTool.type
+            allowedCallers = betaFunctionShellTool.allowedCallers.map { it.toMutableList() }
+            environment = betaFunctionShellTool.environment
+            additionalProperties = betaFunctionShellTool.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("shell")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The tool invocation context(s). */
+        fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+            allowedCallers(JsonField.ofNullable(allowedCallers))
+
+        /** Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`. */
+        fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+            allowedCallers(allowedCallers.getOrNull())
+
+        /**
+         * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.allowedCallers] with a well-typed `List<AllowedCaller>`
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+            this.allowedCallers = allowedCallers.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [AllowedCaller] to [allowedCallers].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+            allowedCallers =
+                (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("allowedCallers", it).add(allowedCaller)
+                }
+        }
+
+        fun environment(environment: Environment?) = environment(JsonField.ofNullable(environment))
+
+        /** Alias for calling [Builder.environment] with `environment.orElse(null)`. */
+        fun environment(environment: Optional<Environment>) = environment(environment.getOrNull())
+
+        /**
+         * Sets [Builder.environment] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.environment] with a well-typed [Environment] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun environment(environment: JsonField<Environment>) = apply {
+            this.environment = environment
+        }
+
+        /** Alias for calling [environment] with `Environment.ofContainerAuto(containerAuto)`. */
+        fun environment(containerAuto: BetaContainerAuto) =
+            environment(Environment.ofContainerAuto(containerAuto))
+
+        /** Alias for calling [environment] with `Environment.ofLocal(local)`. */
+        fun environment(local: BetaLocalEnvironment) = environment(Environment.ofLocal(local))
+
+        /**
+         * Alias for calling [environment] with
+         * `Environment.ofContainerReference(containerReference)`.
+         */
+        fun environment(containerReference: BetaContainerReference) =
+            environment(Environment.ofContainerReference(containerReference))
+
+        /**
+         * Alias for calling [environment] with the following:
+         * ```java
+         * BetaContainerReference.builder()
+         *     .containerId(containerId)
+         *     .build()
+         * ```
+         */
+        fun containerReferenceEnvironment(containerId: String) =
+            environment(BetaContainerReference.builder().containerId(containerId).build())
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaFunctionShellTool].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): BetaFunctionShellTool =
+            BetaFunctionShellTool(
+                type,
+                (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
+                environment,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaFunctionShellTool = apply {
+        if (validated) {
+            return@apply
+        }
+
+        _type().let {
+            if (it != JsonValue.from("shell")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        allowedCallers().ifPresent { it.forEach { it.validate() } }
+        environment().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        type.let { if (it == JsonValue.from("shell")) 1 else 0 } +
+            (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (environment.asKnown().getOrNull()?.validity() ?: 0)
+
+    class AllowedCaller @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val DIRECT = of("direct")
+
+            @JvmField val PROGRAMMATIC = of("programmatic")
+
+            @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+        }
+
+        /** An enum containing [AllowedCaller]'s known values. */
+        enum class Known {
+            DIRECT,
+            PROGRAMMATIC,
+        }
+
+        /**
+         * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            DIRECT,
+            PROGRAMMATIC,
+            /**
+             * An enum member indicating that [AllowedCaller] was instantiated with an unknown
+             * value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                DIRECT -> Value.DIRECT
+                PROGRAMMATIC -> Value.PROGRAMMATIC
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                DIRECT -> Known.DIRECT
+                PROGRAMMATIC -> Known.PROGRAMMATIC
+                else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): AllowedCaller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AllowedCaller && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    @JsonDeserialize(using = Environment.Deserializer::class)
+    @JsonSerialize(using = Environment.Serializer::class)
+    class Environment
+    private constructor(
+        private val containerAuto: BetaContainerAuto? = null,
+        private val local: BetaLocalEnvironment? = null,
+        private val containerReference: BetaContainerReference? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun containerAuto(): Optional<BetaContainerAuto> = Optional.ofNullable(containerAuto)
+
+        fun local(): Optional<BetaLocalEnvironment> = Optional.ofNullable(local)
+
+        fun containerReference(): Optional<BetaContainerReference> =
+            Optional.ofNullable(containerReference)
+
+        fun isContainerAuto(): Boolean = containerAuto != null
+
+        fun isLocal(): Boolean = local != null
+
+        fun isContainerReference(): Boolean = containerReference != null
+
+        fun asContainerAuto(): BetaContainerAuto = containerAuto.getOrThrow("containerAuto")
+
+        fun asLocal(): BetaLocalEnvironment = local.getOrThrow("local")
+
+        fun asContainerReference(): BetaContainerReference =
+            containerReference.getOrThrow("containerReference")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = environment.accept(new Environment.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitContainerAuto(BetaContainerAuto containerAuto) {
+         *         return Optional.of(containerAuto.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                containerAuto != null -> visitor.visitContainerAuto(containerAuto)
+                local != null -> visitor.visitLocal(local)
+                containerReference != null -> visitor.visitContainerReference(containerReference)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Environment = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitContainerAuto(containerAuto: BetaContainerAuto) {
+                        containerAuto.validate()
+                    }
+
+                    override fun visitLocal(local: BetaLocalEnvironment) {
+                        local.validate()
+                    }
+
+                    override fun visitContainerReference(
+                        containerReference: BetaContainerReference
+                    ) {
+                        containerReference.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitContainerAuto(containerAuto: BetaContainerAuto) =
+                        containerAuto.validity()
+
+                    override fun visitLocal(local: BetaLocalEnvironment) = local.validity()
+
+                    override fun visitContainerReference(
+                        containerReference: BetaContainerReference
+                    ) = containerReference.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Environment &&
+                containerAuto == other.containerAuto &&
+                local == other.local &&
+                containerReference == other.containerReference
+        }
+
+        override fun hashCode(): Int = Objects.hash(containerAuto, local, containerReference)
+
+        override fun toString(): String =
+            when {
+                containerAuto != null -> "Environment{containerAuto=$containerAuto}"
+                local != null -> "Environment{local=$local}"
+                containerReference != null -> "Environment{containerReference=$containerReference}"
+                _json != null -> "Environment{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Environment")
+            }
+
+        companion object {
+
+            @JvmStatic
+            fun ofContainerAuto(containerAuto: BetaContainerAuto) =
+                Environment(containerAuto = containerAuto)
+
+            @JvmStatic fun ofLocal(local: BetaLocalEnvironment) = Environment(local = local)
+
+            @JvmStatic
+            fun ofContainerReference(containerReference: BetaContainerReference) =
+                Environment(containerReference = containerReference)
+        }
+
+        /**
+         * An interface that defines how to map each variant of [Environment] to a value of type
+         * [T].
+         */
+        interface Visitor<out T> {
+
+            fun visitContainerAuto(containerAuto: BetaContainerAuto): T
+
+            fun visitLocal(local: BetaLocalEnvironment): T
+
+            fun visitContainerReference(containerReference: BetaContainerReference): T
+
+            /**
+             * Maps an unknown variant of [Environment] to a value of type [T].
+             *
+             * An instance of [Environment] can contain an unknown variant if it was deserialized
+             * from data that doesn't match any known variant. For example, if the SDK is on an
+             * older version than the API, then the API may respond with new variants that the SDK
+             * is unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Environment: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Environment>(Environment::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Environment {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "container_auto" -> {
+                        return tryDeserialize(node, jacksonTypeRef<BetaContainerAuto>())?.let {
+                            Environment(containerAuto = it, _json = json)
+                        } ?: Environment(_json = json)
+                    }
+                    "local" -> {
+                        return tryDeserialize(node, jacksonTypeRef<BetaLocalEnvironment>())?.let {
+                            Environment(local = it, _json = json)
+                        } ?: Environment(_json = json)
+                    }
+                    "container_reference" -> {
+                        return tryDeserialize(node, jacksonTypeRef<BetaContainerReference>())?.let {
+                            Environment(containerReference = it, _json = json)
+                        } ?: Environment(_json = json)
+                    }
+                }
+
+                return Environment(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Environment>(Environment::class) {
+
+            override fun serialize(
+                value: Environment,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.containerAuto != null -> generator.writeObject(value.containerAuto)
+                    value.local != null -> generator.writeObject(value.local)
+                    value.containerReference != null ->
+                        generator.writeObject(value.containerReference)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Environment")
+                }
+            }
+        }
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaFunctionShellTool &&
+            type == other.type &&
+            allowedCallers == other.allowedCallers &&
+            environment == other.environment &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(type, allowedCallers, environment, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaFunctionShellTool{type=$type, allowedCallers=$allowedCallers, environment=$environment, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaFunctionTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaFunctionTool.kt
new file mode 100644
index 000000000..5919847f6
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaFunctionTool.kt
@@ -0,0 +1,894 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Defines a function in your own code the model can choose to call. Learn more about
+ * [function calling](https://platform.openai.com/docs/guides/function-calling).
+ */
+class BetaFunctionTool
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val name: JsonField<String>,
+    private val parameters: JsonField<Parameters>,
+    private val strict: JsonField<Boolean>,
+    private val type: JsonValue,
+    private val allowedCallers: JsonField<List<AllowedCaller>>,
+    private val deferLoading: JsonField<Boolean>,
+    private val description: JsonField<String>,
+    private val outputSchema: JsonField<OutputSchema>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("parameters")
+        @ExcludeMissing
+        parameters: JsonField<Parameters> = JsonMissing.of(),
+        @JsonProperty("strict") @ExcludeMissing strict: JsonField<Boolean> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("allowed_callers")
+        @ExcludeMissing
+        allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
+        @JsonProperty("defer_loading")
+        @ExcludeMissing
+        deferLoading: JsonField<Boolean> = JsonMissing.of(),
+        @JsonProperty("description")
+        @ExcludeMissing
+        description: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_schema")
+        @ExcludeMissing
+        outputSchema: JsonField<OutputSchema> = JsonMissing.of(),
+    ) : this(
+        name,
+        parameters,
+        strict,
+        type,
+        allowedCallers,
+        deferLoading,
+        description,
+        outputSchema,
+        mutableMapOf(),
+    )
+
+    /**
+     * The name of the function to call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun name(): String = name.getRequired("name")
+
+    /**
+     * A JSON schema object describing the parameters of the function.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun parameters(): Optional<Parameters> = parameters.getOptional("parameters")
+
+    /**
+     * Whether strict parameter validation is enforced for this function tool.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun strict(): Optional<Boolean> = strict.getOptional("strict")
+
+    /**
+     * The type of the function tool. Always `function`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("function")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The tool invocation context(s).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun allowedCallers(): Optional<List<AllowedCaller>> =
+        allowedCallers.getOptional("allowed_callers")
+
+    /**
+     * Whether this function is deferred and loaded via tool search.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun deferLoading(): Optional<Boolean> = deferLoading.getOptional("defer_loading")
+
+    /**
+     * A description of the function. Used by the model to determine whether or not to call the
+     * function.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun description(): Optional<String> = description.getOptional("description")
+
+    /**
+     * A JSON schema object describing the JSON value encoded in string outputs for this function.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun outputSchema(): Optional<OutputSchema> = outputSchema.getOptional("output_schema")
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    /**
+     * Returns the raw JSON value of [parameters].
+     *
+     * Unlike [parameters], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("parameters")
+    @ExcludeMissing
+    fun _parameters(): JsonField<Parameters> = parameters
+
+    /**
+     * Returns the raw JSON value of [strict].
+     *
+     * Unlike [strict], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("strict") @ExcludeMissing fun _strict(): JsonField<Boolean> = strict
+
+    /**
+     * Returns the raw JSON value of [allowedCallers].
+     *
+     * Unlike [allowedCallers], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("allowed_callers")
+    @ExcludeMissing
+    fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
+    /**
+     * Returns the raw JSON value of [deferLoading].
+     *
+     * Unlike [deferLoading], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("defer_loading")
+    @ExcludeMissing
+    fun _deferLoading(): JsonField<Boolean> = deferLoading
+
+    /**
+     * Returns the raw JSON value of [description].
+     *
+     * Unlike [description], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("description") @ExcludeMissing fun _description(): JsonField<String> = description
+
+    /**
+     * Returns the raw JSON value of [outputSchema].
+     *
+     * Unlike [outputSchema], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_schema")
+    @ExcludeMissing
+    fun _outputSchema(): JsonField<OutputSchema> = outputSchema
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaFunctionTool].
+         *
+         * The following fields are required:
+         * ```java
+         * .name()
+         * .parameters()
+         * .strict()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaFunctionTool]. */
+    class Builder internal constructor() {
+
+        private var name: JsonField<String>? = null
+        private var parameters: JsonField<Parameters>? = null
+        private var strict: JsonField<Boolean>? = null
+        private var type: JsonValue = JsonValue.from("function")
+        private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
+        private var deferLoading: JsonField<Boolean> = JsonMissing.of()
+        private var description: JsonField<String> = JsonMissing.of()
+        private var outputSchema: JsonField<OutputSchema> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaFunctionTool: BetaFunctionTool) = apply {
+            name = betaFunctionTool.name
+            parameters = betaFunctionTool.parameters
+            strict = betaFunctionTool.strict
+            type = betaFunctionTool.type
+            allowedCallers = betaFunctionTool.allowedCallers.map { it.toMutableList() }
+            deferLoading = betaFunctionTool.deferLoading
+            description = betaFunctionTool.description
+            outputSchema = betaFunctionTool.outputSchema
+            additionalProperties = betaFunctionTool.additionalProperties.toMutableMap()
+        }
+
+        /** The name of the function to call. */
+        fun name(name: String) = name(JsonField.of(name))
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        /** A JSON schema object describing the parameters of the function. */
+        fun parameters(parameters: Parameters?) = parameters(JsonField.ofNullable(parameters))
+
+        /** Alias for calling [Builder.parameters] with `parameters.orElse(null)`. */
+        fun parameters(parameters: Optional<Parameters>) = parameters(parameters.getOrNull())
+
+        /**
+         * Sets [Builder.parameters] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.parameters] with a well-typed [Parameters] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun parameters(parameters: JsonField<Parameters>) = apply { this.parameters = parameters }
+
+        /** Whether strict parameter validation is enforced for this function tool. */
+        fun strict(strict: Boolean?) = strict(JsonField.ofNullable(strict))
+
+        /**
+         * Alias for [Builder.strict].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun strict(strict: Boolean) = strict(strict as Boolean?)
+
+        /** Alias for calling [Builder.strict] with `strict.orElse(null)`. */
+        fun strict(strict: Optional<Boolean>) = strict(strict.getOrNull())
+
+        /**
+         * Sets [Builder.strict] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.strict] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun strict(strict: JsonField<Boolean>) = apply { this.strict = strict }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("function")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The tool invocation context(s). */
+        fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+            allowedCallers(JsonField.ofNullable(allowedCallers))
+
+        /** Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`. */
+        fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+            allowedCallers(allowedCallers.getOrNull())
+
+        /**
+         * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.allowedCallers] with a well-typed `List<AllowedCaller>`
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+            this.allowedCallers = allowedCallers.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [AllowedCaller] to [allowedCallers].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+            allowedCallers =
+                (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("allowedCallers", it).add(allowedCaller)
+                }
+        }
+
+        /** Whether this function is deferred and loaded via tool search. */
+        fun deferLoading(deferLoading: Boolean) = deferLoading(JsonField.of(deferLoading))
+
+        /**
+         * Sets [Builder.deferLoading] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.deferLoading] with a well-typed [Boolean] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun deferLoading(deferLoading: JsonField<Boolean>) = apply {
+            this.deferLoading = deferLoading
+        }
+
+        /**
+         * A description of the function. Used by the model to determine whether or not to call the
+         * function.
+         */
+        fun description(description: String?) = description(JsonField.ofNullable(description))
+
+        /** Alias for calling [Builder.description] with `description.orElse(null)`. */
+        fun description(description: Optional<String>) = description(description.getOrNull())
+
+        /**
+         * Sets [Builder.description] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.description] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun description(description: JsonField<String>) = apply { this.description = description }
+
+        /**
+         * A JSON schema object describing the JSON value encoded in string outputs for this
+         * function.
+         */
+        fun outputSchema(outputSchema: OutputSchema?) =
+            outputSchema(JsonField.ofNullable(outputSchema))
+
+        /** Alias for calling [Builder.outputSchema] with `outputSchema.orElse(null)`. */
+        fun outputSchema(outputSchema: Optional<OutputSchema>) =
+            outputSchema(outputSchema.getOrNull())
+
+        /**
+         * Sets [Builder.outputSchema] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputSchema] with a well-typed [OutputSchema] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun outputSchema(outputSchema: JsonField<OutputSchema>) = apply {
+            this.outputSchema = outputSchema
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaFunctionTool].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .name()
+         * .parameters()
+         * .strict()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaFunctionTool =
+            BetaFunctionTool(
+                checkRequired("name", name),
+                checkRequired("parameters", parameters),
+                checkRequired("strict", strict),
+                type,
+                (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
+                deferLoading,
+                description,
+                outputSchema,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaFunctionTool = apply {
+        if (validated) {
+            return@apply
+        }
+
+        name()
+        parameters().ifPresent { it.validate() }
+        strict()
+        _type().let {
+            if (it != JsonValue.from("function")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        allowedCallers().ifPresent { it.forEach { it.validate() } }
+        deferLoading()
+        description()
+        outputSchema().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (name.asKnown().isPresent) 1 else 0) +
+            (parameters.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (strict.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("function")) 1 else 0 } +
+            (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (if (deferLoading.asKnown().isPresent) 1 else 0) +
+            (if (description.asKnown().isPresent) 1 else 0) +
+            (outputSchema.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** A JSON schema object describing the parameters of the function. */
+    class Parameters
+    @JsonCreator
+    private constructor(
+        @com.fasterxml.jackson.annotation.JsonValue
+        private val additionalProperties: Map<String, JsonValue>
+    ) {
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Parameters]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Parameters]. */
+        class Builder internal constructor() {
+
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(parameters: Parameters) = apply {
+                additionalProperties = parameters.additionalProperties.toMutableMap()
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Parameters].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Parameters = Parameters(additionalProperties.toImmutable())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Parameters = apply {
+            if (validated) {
+                return@apply
+            }
+
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            additionalProperties.count { (_, value) -> !value.isNull() && !value.isMissing() }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Parameters && additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() = "Parameters{additionalProperties=$additionalProperties}"
+    }
+
+    class AllowedCaller @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val DIRECT = of("direct")
+
+            @JvmField val PROGRAMMATIC = of("programmatic")
+
+            @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+        }
+
+        /** An enum containing [AllowedCaller]'s known values. */
+        enum class Known {
+            DIRECT,
+            PROGRAMMATIC,
+        }
+
+        /**
+         * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            DIRECT,
+            PROGRAMMATIC,
+            /**
+             * An enum member indicating that [AllowedCaller] was instantiated with an unknown
+             * value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                DIRECT -> Value.DIRECT
+                PROGRAMMATIC -> Value.PROGRAMMATIC
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                DIRECT -> Known.DIRECT
+                PROGRAMMATIC -> Known.PROGRAMMATIC
+                else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): AllowedCaller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AllowedCaller && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /**
+     * A JSON schema object describing the JSON value encoded in string outputs for this function.
+     */
+    class OutputSchema
+    @JsonCreator
+    private constructor(
+        @com.fasterxml.jackson.annotation.JsonValue
+        private val additionalProperties: Map<String, JsonValue>
+    ) {
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [OutputSchema]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [OutputSchema]. */
+        class Builder internal constructor() {
+
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(outputSchema: OutputSchema) = apply {
+                additionalProperties = outputSchema.additionalProperties.toMutableMap()
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [OutputSchema].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): OutputSchema = OutputSchema(additionalProperties.toImmutable())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): OutputSchema = apply {
+            if (validated) {
+                return@apply
+            }
+
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            additionalProperties.count { (_, value) -> !value.isNull() && !value.isMissing() }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is OutputSchema && additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() = "OutputSchema{additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaFunctionTool &&
+            name == other.name &&
+            parameters == other.parameters &&
+            strict == other.strict &&
+            type == other.type &&
+            allowedCallers == other.allowedCallers &&
+            deferLoading == other.deferLoading &&
+            description == other.description &&
+            outputSchema == other.outputSchema &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            name,
+            parameters,
+            strict,
+            type,
+            allowedCallers,
+            deferLoading,
+            description,
+            outputSchema,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaFunctionTool{name=$name, parameters=$parameters, strict=$strict, type=$type, allowedCallers=$allowedCallers, deferLoading=$deferLoading, description=$description, outputSchema=$outputSchema, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaInlineSkill.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaInlineSkill.kt
new file mode 100644
index 000000000..8e3438b35
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaInlineSkill.kt
@@ -0,0 +1,303 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import kotlin.jvm.optionals.getOrNull
+
+class BetaInlineSkill
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val description: JsonField<String>,
+    private val name: JsonField<String>,
+    private val source: JsonField<BetaInlineSkillSource>,
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("description")
+        @ExcludeMissing
+        description: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("source")
+        @ExcludeMissing
+        source: JsonField<BetaInlineSkillSource> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+    ) : this(description, name, source, type, mutableMapOf())
+
+    /**
+     * The description of the skill.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun description(): String = description.getRequired("description")
+
+    /**
+     * The name of the skill.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun name(): String = name.getRequired("name")
+
+    /**
+     * Inline skill payload
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun source(): BetaInlineSkillSource = source.getRequired("source")
+
+    /**
+     * Defines an inline skill for this request.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("inline")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Returns the raw JSON value of [description].
+     *
+     * Unlike [description], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("description") @ExcludeMissing fun _description(): JsonField<String> = description
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    /**
+     * Returns the raw JSON value of [source].
+     *
+     * Unlike [source], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("source") @ExcludeMissing fun _source(): JsonField<BetaInlineSkillSource> = source
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaInlineSkill].
+         *
+         * The following fields are required:
+         * ```java
+         * .description()
+         * .name()
+         * .source()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaInlineSkill]. */
+    class Builder internal constructor() {
+
+        private var description: JsonField<String>? = null
+        private var name: JsonField<String>? = null
+        private var source: JsonField<BetaInlineSkillSource>? = null
+        private var type: JsonValue = JsonValue.from("inline")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaInlineSkill: BetaInlineSkill) = apply {
+            description = betaInlineSkill.description
+            name = betaInlineSkill.name
+            source = betaInlineSkill.source
+            type = betaInlineSkill.type
+            additionalProperties = betaInlineSkill.additionalProperties.toMutableMap()
+        }
+
+        /** The description of the skill. */
+        fun description(description: String) = description(JsonField.of(description))
+
+        /**
+         * Sets [Builder.description] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.description] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun description(description: JsonField<String>) = apply { this.description = description }
+
+        /** The name of the skill. */
+        fun name(name: String) = name(JsonField.of(name))
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        /** Inline skill payload */
+        fun source(source: BetaInlineSkillSource) = source(JsonField.of(source))
+
+        /**
+         * Sets [Builder.source] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.source] with a well-typed [BetaInlineSkillSource] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun source(source: JsonField<BetaInlineSkillSource>) = apply { this.source = source }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("inline")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaInlineSkill].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .description()
+         * .name()
+         * .source()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaInlineSkill =
+            BetaInlineSkill(
+                checkRequired("description", description),
+                checkRequired("name", name),
+                checkRequired("source", source),
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaInlineSkill = apply {
+        if (validated) {
+            return@apply
+        }
+
+        description()
+        name()
+        source().validate()
+        _type().let {
+            if (it != JsonValue.from("inline")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (description.asKnown().isPresent) 1 else 0) +
+            (if (name.asKnown().isPresent) 1 else 0) +
+            (source.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("inline")) 1 else 0 }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaInlineSkill &&
+            description == other.description &&
+            name == other.name &&
+            source == other.source &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(description, name, source, type, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaInlineSkill{description=$description, name=$name, source=$source, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaInlineSkillSource.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaInlineSkillSource.kt
new file mode 100644
index 000000000..a2247d8ed
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaInlineSkillSource.kt
@@ -0,0 +1,262 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+
+/** Inline skill payload */
+class BetaInlineSkillSource
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val data: JsonField<String>,
+    private val mediaType: JsonValue,
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("data") @ExcludeMissing data: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("media_type") @ExcludeMissing mediaType: JsonValue = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+    ) : this(data, mediaType, type, mutableMapOf())
+
+    /**
+     * Base64-encoded skill zip bundle.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun data(): String = data.getRequired("data")
+
+    /**
+     * The media type of the inline skill payload. Must be `application/zip`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("application/zip")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("media_type") @ExcludeMissing fun _mediaType(): JsonValue = mediaType
+
+    /**
+     * The type of the inline skill source. Must be `base64`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("base64")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Returns the raw JSON value of [data].
+     *
+     * Unlike [data], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("data") @ExcludeMissing fun _data(): JsonField<String> = data
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaInlineSkillSource].
+         *
+         * The following fields are required:
+         * ```java
+         * .data()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaInlineSkillSource]. */
+    class Builder internal constructor() {
+
+        private var data: JsonField<String>? = null
+        private var mediaType: JsonValue = JsonValue.from("application/zip")
+        private var type: JsonValue = JsonValue.from("base64")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaInlineSkillSource: BetaInlineSkillSource) = apply {
+            data = betaInlineSkillSource.data
+            mediaType = betaInlineSkillSource.mediaType
+            type = betaInlineSkillSource.type
+            additionalProperties = betaInlineSkillSource.additionalProperties.toMutableMap()
+        }
+
+        /** Base64-encoded skill zip bundle. */
+        fun data(data: String) = data(JsonField.of(data))
+
+        /**
+         * Sets [Builder.data] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.data] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun data(data: JsonField<String>) = apply { this.data = data }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("application/zip")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun mediaType(mediaType: JsonValue) = apply { this.mediaType = mediaType }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("base64")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaInlineSkillSource].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .data()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaInlineSkillSource =
+            BetaInlineSkillSource(
+                checkRequired("data", data),
+                mediaType,
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaInlineSkillSource = apply {
+        if (validated) {
+            return@apply
+        }
+
+        data()
+        _mediaType().let {
+            if (it != JsonValue.from("application/zip")) {
+                throw OpenAIInvalidDataException("'mediaType' is invalid, received $it")
+            }
+        }
+        _type().let {
+            if (it != JsonValue.from("base64")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (data.asKnown().isPresent) 1 else 0) +
+            mediaType.let { if (it == JsonValue.from("application/zip")) 1 else 0 } +
+            type.let { if (it == JsonValue.from("base64")) 1 else 0 }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaInlineSkillSource &&
+            data == other.data &&
+            mediaType == other.mediaType &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(data, mediaType, type, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaInlineSkillSource{data=$data, mediaType=$mediaType, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaLocalEnvironment.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaLocalEnvironment.kt
new file mode 100644
index 000000000..d4409030b
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaLocalEnvironment.kt
@@ -0,0 +1,228 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class BetaLocalEnvironment
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonValue,
+    private val skills: JsonField<List<BetaLocalSkill>>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("skills")
+        @ExcludeMissing
+        skills: JsonField<List<BetaLocalSkill>> = JsonMissing.of(),
+    ) : this(type, skills, mutableMapOf())
+
+    /**
+     * Use a local computer environment.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("local")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * An optional list of skills.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun skills(): Optional<List<BetaLocalSkill>> = skills.getOptional("skills")
+
+    /**
+     * Returns the raw JSON value of [skills].
+     *
+     * Unlike [skills], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("skills") @ExcludeMissing fun _skills(): JsonField<List<BetaLocalSkill>> = skills
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [BetaLocalEnvironment]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaLocalEnvironment]. */
+    class Builder internal constructor() {
+
+        private var type: JsonValue = JsonValue.from("local")
+        private var skills: JsonField<MutableList<BetaLocalSkill>>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaLocalEnvironment: BetaLocalEnvironment) = apply {
+            type = betaLocalEnvironment.type
+            skills = betaLocalEnvironment.skills.map { it.toMutableList() }
+            additionalProperties = betaLocalEnvironment.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("local")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** An optional list of skills. */
+        fun skills(skills: List<BetaLocalSkill>) = skills(JsonField.of(skills))
+
+        /**
+         * Sets [Builder.skills] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.skills] with a well-typed `List<BetaLocalSkill>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun skills(skills: JsonField<List<BetaLocalSkill>>) = apply {
+            this.skills = skills.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [BetaLocalSkill] to [skills].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addSkill(skill: BetaLocalSkill) = apply {
+            skills =
+                (skills ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("skills", it).add(skill)
+                }
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaLocalEnvironment].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): BetaLocalEnvironment =
+            BetaLocalEnvironment(
+                type,
+                (skills ?: JsonMissing.of()).map { it.toImmutable() },
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaLocalEnvironment = apply {
+        if (validated) {
+            return@apply
+        }
+
+        _type().let {
+            if (it != JsonValue.from("local")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        skills().ifPresent { it.forEach { it.validate() } }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        type.let { if (it == JsonValue.from("local")) 1 else 0 } +
+            (skills.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaLocalEnvironment &&
+            type == other.type &&
+            skills == other.skills &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(type, skills, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaLocalEnvironment{type=$type, skills=$skills, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaLocalSkill.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaLocalSkill.kt
new file mode 100644
index 000000000..db4ab9804
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaLocalSkill.kt
@@ -0,0 +1,260 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+
+class BetaLocalSkill
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val description: JsonField<String>,
+    private val name: JsonField<String>,
+    private val path: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("description")
+        @ExcludeMissing
+        description: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("path") @ExcludeMissing path: JsonField<String> = JsonMissing.of(),
+    ) : this(description, name, path, mutableMapOf())
+
+    /**
+     * The description of the skill.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun description(): String = description.getRequired("description")
+
+    /**
+     * The name of the skill.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun name(): String = name.getRequired("name")
+
+    /**
+     * The path to the directory containing the skill.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun path(): String = path.getRequired("path")
+
+    /**
+     * Returns the raw JSON value of [description].
+     *
+     * Unlike [description], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("description") @ExcludeMissing fun _description(): JsonField<String> = description
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    /**
+     * Returns the raw JSON value of [path].
+     *
+     * Unlike [path], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("path") @ExcludeMissing fun _path(): JsonField<String> = path
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaLocalSkill].
+         *
+         * The following fields are required:
+         * ```java
+         * .description()
+         * .name()
+         * .path()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaLocalSkill]. */
+    class Builder internal constructor() {
+
+        private var description: JsonField<String>? = null
+        private var name: JsonField<String>? = null
+        private var path: JsonField<String>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaLocalSkill: BetaLocalSkill) = apply {
+            description = betaLocalSkill.description
+            name = betaLocalSkill.name
+            path = betaLocalSkill.path
+            additionalProperties = betaLocalSkill.additionalProperties.toMutableMap()
+        }
+
+        /** The description of the skill. */
+        fun description(description: String) = description(JsonField.of(description))
+
+        /**
+         * Sets [Builder.description] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.description] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun description(description: JsonField<String>) = apply { this.description = description }
+
+        /** The name of the skill. */
+        fun name(name: String) = name(JsonField.of(name))
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        /** The path to the directory containing the skill. */
+        fun path(path: String) = path(JsonField.of(path))
+
+        /**
+         * Sets [Builder.path] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.path] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun path(path: JsonField<String>) = apply { this.path = path }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaLocalSkill].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .description()
+         * .name()
+         * .path()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaLocalSkill =
+            BetaLocalSkill(
+                checkRequired("description", description),
+                checkRequired("name", name),
+                checkRequired("path", path),
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaLocalSkill = apply {
+        if (validated) {
+            return@apply
+        }
+
+        description()
+        name()
+        path()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (description.asKnown().isPresent) 1 else 0) +
+            (if (name.asKnown().isPresent) 1 else 0) +
+            (if (path.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaLocalSkill &&
+            description == other.description &&
+            name == other.name &&
+            path == other.path &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(description, name, path, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaLocalSkill{description=$description, name=$name, path=$path, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaNamespaceTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaNamespaceTool.kt
new file mode 100644
index 000000000..9f9b18713
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaNamespaceTool.kt
@@ -0,0 +1,1336 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Groups function/custom tools under a shared namespace. */
+class BetaNamespaceTool
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val description: JsonField<String>,
+    private val name: JsonField<String>,
+    private val tools: JsonField<List<Tool>>,
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("description")
+        @ExcludeMissing
+        description: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("tools") @ExcludeMissing tools: JsonField<List<Tool>> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+    ) : this(description, name, tools, type, mutableMapOf())
+
+    /**
+     * A description of the namespace shown to the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun description(): String = description.getRequired("description")
+
+    /**
+     * The namespace name used in tool calls (for example, `crm`).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun name(): String = name.getRequired("name")
+
+    /**
+     * The function/custom tools available inside this namespace.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun tools(): List<Tool> = tools.getRequired("tools")
+
+    /**
+     * The type of the tool. Always `namespace`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("namespace")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Returns the raw JSON value of [description].
+     *
+     * Unlike [description], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("description") @ExcludeMissing fun _description(): JsonField<String> = description
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    /**
+     * Returns the raw JSON value of [tools].
+     *
+     * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<Tool>> = tools
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaNamespaceTool].
+         *
+         * The following fields are required:
+         * ```java
+         * .description()
+         * .name()
+         * .tools()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaNamespaceTool]. */
+    class Builder internal constructor() {
+
+        private var description: JsonField<String>? = null
+        private var name: JsonField<String>? = null
+        private var tools: JsonField<MutableList<Tool>>? = null
+        private var type: JsonValue = JsonValue.from("namespace")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaNamespaceTool: BetaNamespaceTool) = apply {
+            description = betaNamespaceTool.description
+            name = betaNamespaceTool.name
+            tools = betaNamespaceTool.tools.map { it.toMutableList() }
+            type = betaNamespaceTool.type
+            additionalProperties = betaNamespaceTool.additionalProperties.toMutableMap()
+        }
+
+        /** A description of the namespace shown to the model. */
+        fun description(description: String) = description(JsonField.of(description))
+
+        /**
+         * Sets [Builder.description] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.description] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun description(description: JsonField<String>) = apply { this.description = description }
+
+        /** The namespace name used in tool calls (for example, `crm`). */
+        fun name(name: String) = name(JsonField.of(name))
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        /** The function/custom tools available inside this namespace. */
+        fun tools(tools: List<Tool>) = tools(JsonField.of(tools))
+
+        /**
+         * Sets [Builder.tools] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.tools] with a well-typed `List<Tool>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun tools(tools: JsonField<List<Tool>>) = apply {
+            this.tools = tools.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Tool] to [tools].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addTool(tool: Tool) = apply {
+            tools =
+                (tools ?: JsonField.of(mutableListOf())).also { checkKnown("tools", it).add(tool) }
+        }
+
+        /** Alias for calling [addTool] with `Tool.ofFunction(function)`. */
+        fun addTool(function: Tool.Function) = addTool(Tool.ofFunction(function))
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * Tool.Function.builder()
+         *     .name(name)
+         *     .build()
+         * ```
+         */
+        fun addFunctionTool(name: String) = addTool(Tool.Function.builder().name(name).build())
+
+        /** Alias for calling [addTool] with `Tool.ofCustom(custom)`. */
+        fun addTool(custom: BetaCustomTool) = addTool(Tool.ofCustom(custom))
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaCustomTool.builder()
+         *     .name(name)
+         *     .build()
+         * ```
+         */
+        fun addCustomTool(name: String) = addTool(BetaCustomTool.builder().name(name).build())
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("namespace")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaNamespaceTool].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .description()
+         * .name()
+         * .tools()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaNamespaceTool =
+            BetaNamespaceTool(
+                checkRequired("description", description),
+                checkRequired("name", name),
+                checkRequired("tools", tools).map { it.toImmutable() },
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaNamespaceTool = apply {
+        if (validated) {
+            return@apply
+        }
+
+        description()
+        name()
+        tools().forEach { it.validate() }
+        _type().let {
+            if (it != JsonValue.from("namespace")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (description.asKnown().isPresent) 1 else 0) +
+            (if (name.asKnown().isPresent) 1 else 0) +
+            (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            type.let { if (it == JsonValue.from("namespace")) 1 else 0 }
+
+    /** A function or custom tool that belongs to a namespace. */
+    @JsonDeserialize(using = Tool.Deserializer::class)
+    @JsonSerialize(using = Tool.Serializer::class)
+    class Tool
+    private constructor(
+        private val function: Function? = null,
+        private val custom: BetaCustomTool? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun function(): Optional<Function> = Optional.ofNullable(function)
+
+        /**
+         * A custom tool that processes input using a specified format. Learn more about
+         * [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
+         */
+        fun custom(): Optional<BetaCustomTool> = Optional.ofNullable(custom)
+
+        fun isFunction(): Boolean = function != null
+
+        fun isCustom(): Boolean = custom != null
+
+        fun asFunction(): Function = function.getOrThrow("function")
+
+        /**
+         * A custom tool that processes input using a specified format. Learn more about
+         * [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
+         */
+        fun asCustom(): BetaCustomTool = custom.getOrThrow("custom")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = tool.accept(new Tool.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitFunction(Function function) {
+         *         return Optional.of(function.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                function != null -> visitor.visitFunction(function)
+                custom != null -> visitor.visitCustom(custom)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Tool = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitFunction(function: Function) {
+                        function.validate()
+                    }
+
+                    override fun visitCustom(custom: BetaCustomTool) {
+                        custom.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitFunction(function: Function) = function.validity()
+
+                    override fun visitCustom(custom: BetaCustomTool) = custom.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Tool && function == other.function && custom == other.custom
+        }
+
+        override fun hashCode(): Int = Objects.hash(function, custom)
+
+        override fun toString(): String =
+            when {
+                function != null -> "Tool{function=$function}"
+                custom != null -> "Tool{custom=$custom}"
+                _json != null -> "Tool{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Tool")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofFunction(function: Function) = Tool(function = function)
+
+            /**
+             * A custom tool that processes input using a specified format. Learn more about
+             * [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
+             */
+            @JvmStatic fun ofCustom(custom: BetaCustomTool) = Tool(custom = custom)
+        }
+
+        /** An interface that defines how to map each variant of [Tool] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitFunction(function: Function): T
+
+            /**
+             * A custom tool that processes input using a specified format. Learn more about
+             * [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
+             */
+            fun visitCustom(custom: BetaCustomTool): T
+
+            /**
+             * Maps an unknown variant of [Tool] to a value of type [T].
+             *
+             * An instance of [Tool] can contain an unknown variant if it was deserialized from data
+             * that doesn't match any known variant. For example, if the SDK is on an older version
+             * than the API, then the API may respond with new variants that the SDK is unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Tool: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Tool>(Tool::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Tool {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "function" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Function>())?.let {
+                            Tool(function = it, _json = json)
+                        } ?: Tool(_json = json)
+                    }
+                    "custom" -> {
+                        return tryDeserialize(node, jacksonTypeRef<BetaCustomTool>())?.let {
+                            Tool(custom = it, _json = json)
+                        } ?: Tool(_json = json)
+                    }
+                }
+
+                return Tool(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Tool>(Tool::class) {
+
+            override fun serialize(
+                value: Tool,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.function != null -> generator.writeObject(value.function)
+                    value.custom != null -> generator.writeObject(value.custom)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Tool")
+                }
+            }
+        }
+
+        class Function
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val name: JsonField<String>,
+            private val type: JsonValue,
+            private val allowedCallers: JsonField<List<AllowedCaller>>,
+            private val deferLoading: JsonField<Boolean>,
+            private val description: JsonField<String>,
+            private val outputSchema: JsonField<OutputSchema>,
+            private val parameters: JsonValue,
+            private val strict: JsonField<Boolean>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                @JsonProperty("allowed_callers")
+                @ExcludeMissing
+                allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
+                @JsonProperty("defer_loading")
+                @ExcludeMissing
+                deferLoading: JsonField<Boolean> = JsonMissing.of(),
+                @JsonProperty("description")
+                @ExcludeMissing
+                description: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("output_schema")
+                @ExcludeMissing
+                outputSchema: JsonField<OutputSchema> = JsonMissing.of(),
+                @JsonProperty("parameters")
+                @ExcludeMissing
+                parameters: JsonValue = JsonMissing.of(),
+                @JsonProperty("strict")
+                @ExcludeMissing
+                strict: JsonField<Boolean> = JsonMissing.of(),
+            ) : this(
+                name,
+                type,
+                allowedCallers,
+                deferLoading,
+                description,
+                outputSchema,
+                parameters,
+                strict,
+                mutableMapOf(),
+            )
+
+            /**
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun name(): String = name.getRequired("name")
+
+            /**
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("function")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * The tool invocation context(s).
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun allowedCallers(): Optional<List<AllowedCaller>> =
+                allowedCallers.getOptional("allowed_callers")
+
+            /**
+             * Whether this function should be deferred and discovered via tool search.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun deferLoading(): Optional<Boolean> = deferLoading.getOptional("defer_loading")
+
+            /**
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun description(): Optional<String> = description.getOptional("description")
+
+            /**
+             * A JSON Schema describing the JSON value encoded in string outputs for this function
+             * tool. This does not describe content-array outputs.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun outputSchema(): Optional<OutputSchema> = outputSchema.getOptional("output_schema")
+
+            /**
+             * This arbitrary value can be deserialized into a custom type using the `convert`
+             * method:
+             * ```java
+             * MyClass myObject = function.parameters().convert(MyClass.class);
+             * ```
+             */
+            @JsonProperty("parameters") @ExcludeMissing fun _parameters(): JsonValue = parameters
+
+            /**
+             * Whether to enforce strict parameter validation. If omitted, Responses attempts to use
+             * strict validation when the schema is compatible, and falls back to non-strict
+             * validation otherwise.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun strict(): Optional<Boolean> = strict.getOptional("strict")
+
+            /**
+             * Returns the raw JSON value of [name].
+             *
+             * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+            /**
+             * Returns the raw JSON value of [allowedCallers].
+             *
+             * Unlike [allowedCallers], this method doesn't throw if the JSON field has an
+             * unexpected type.
+             */
+            @JsonProperty("allowed_callers")
+            @ExcludeMissing
+            fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
+            /**
+             * Returns the raw JSON value of [deferLoading].
+             *
+             * Unlike [deferLoading], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("defer_loading")
+            @ExcludeMissing
+            fun _deferLoading(): JsonField<Boolean> = deferLoading
+
+            /**
+             * Returns the raw JSON value of [description].
+             *
+             * Unlike [description], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("description")
+            @ExcludeMissing
+            fun _description(): JsonField<String> = description
+
+            /**
+             * Returns the raw JSON value of [outputSchema].
+             *
+             * Unlike [outputSchema], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("output_schema")
+            @ExcludeMissing
+            fun _outputSchema(): JsonField<OutputSchema> = outputSchema
+
+            /**
+             * Returns the raw JSON value of [strict].
+             *
+             * Unlike [strict], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("strict") @ExcludeMissing fun _strict(): JsonField<Boolean> = strict
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Function].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .name()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Function]. */
+            class Builder internal constructor() {
+
+                private var name: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("function")
+                private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
+                private var deferLoading: JsonField<Boolean> = JsonMissing.of()
+                private var description: JsonField<String> = JsonMissing.of()
+                private var outputSchema: JsonField<OutputSchema> = JsonMissing.of()
+                private var parameters: JsonValue = JsonMissing.of()
+                private var strict: JsonField<Boolean> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(function: Function) = apply {
+                    name = function.name
+                    type = function.type
+                    allowedCallers = function.allowedCallers.map { it.toMutableList() }
+                    deferLoading = function.deferLoading
+                    description = function.description
+                    outputSchema = function.outputSchema
+                    parameters = function.parameters
+                    strict = function.strict
+                    additionalProperties = function.additionalProperties.toMutableMap()
+                }
+
+                fun name(name: String) = name(JsonField.of(name))
+
+                /**
+                 * Sets [Builder.name] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.name] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun name(name: JsonField<String>) = apply { this.name = name }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("function")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                /** The tool invocation context(s). */
+                fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+                    allowedCallers(JsonField.ofNullable(allowedCallers))
+
+                /**
+                 * Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`.
+                 */
+                fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+                    allowedCallers(allowedCallers.getOrNull())
+
+                /**
+                 * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.allowedCallers] with a well-typed
+                 * `List<AllowedCaller>` value instead. This method is primarily for setting the
+                 * field to an undocumented or not yet supported value.
+                 */
+                fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+                    this.allowedCallers = allowedCallers.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [AllowedCaller] to [allowedCallers].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+                    allowedCallers =
+                        (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("allowedCallers", it).add(allowedCaller)
+                        }
+                }
+
+                /** Whether this function should be deferred and discovered via tool search. */
+                fun deferLoading(deferLoading: Boolean) = deferLoading(JsonField.of(deferLoading))
+
+                /**
+                 * Sets [Builder.deferLoading] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.deferLoading] with a well-typed [Boolean] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun deferLoading(deferLoading: JsonField<Boolean>) = apply {
+                    this.deferLoading = deferLoading
+                }
+
+                fun description(description: String?) =
+                    description(JsonField.ofNullable(description))
+
+                /** Alias for calling [Builder.description] with `description.orElse(null)`. */
+                fun description(description: Optional<String>) =
+                    description(description.getOrNull())
+
+                /**
+                 * Sets [Builder.description] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.description] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun description(description: JsonField<String>) = apply {
+                    this.description = description
+                }
+
+                /**
+                 * A JSON Schema describing the JSON value encoded in string outputs for this
+                 * function tool. This does not describe content-array outputs.
+                 */
+                fun outputSchema(outputSchema: OutputSchema?) =
+                    outputSchema(JsonField.ofNullable(outputSchema))
+
+                /** Alias for calling [Builder.outputSchema] with `outputSchema.orElse(null)`. */
+                fun outputSchema(outputSchema: Optional<OutputSchema>) =
+                    outputSchema(outputSchema.getOrNull())
+
+                /**
+                 * Sets [Builder.outputSchema] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.outputSchema] with a well-typed [OutputSchema]
+                 * value instead. This method is primarily for setting the field to an undocumented
+                 * or not yet supported value.
+                 */
+                fun outputSchema(outputSchema: JsonField<OutputSchema>) = apply {
+                    this.outputSchema = outputSchema
+                }
+
+                fun parameters(parameters: JsonValue) = apply { this.parameters = parameters }
+
+                /**
+                 * Whether to enforce strict parameter validation. If omitted, Responses attempts to
+                 * use strict validation when the schema is compatible, and falls back to non-strict
+                 * validation otherwise.
+                 */
+                fun strict(strict: Boolean?) = strict(JsonField.ofNullable(strict))
+
+                /**
+                 * Alias for [Builder.strict].
+                 *
+                 * This unboxed primitive overload exists for backwards compatibility.
+                 */
+                fun strict(strict: Boolean) = strict(strict as Boolean?)
+
+                /** Alias for calling [Builder.strict] with `strict.orElse(null)`. */
+                fun strict(strict: Optional<Boolean>) = strict(strict.getOrNull())
+
+                /**
+                 * Sets [Builder.strict] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.strict] with a well-typed [Boolean] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun strict(strict: JsonField<Boolean>) = apply { this.strict = strict }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Function].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .name()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Function =
+                    Function(
+                        checkRequired("name", name),
+                        type,
+                        (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
+                        deferLoading,
+                        description,
+                        outputSchema,
+                        parameters,
+                        strict,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Function = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                name()
+                _type().let {
+                    if (it != JsonValue.from("function")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                allowedCallers().ifPresent { it.forEach { it.validate() } }
+                deferLoading()
+                description()
+                outputSchema().ifPresent { it.validate() }
+                strict()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (name.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("function")) 1 else 0 } +
+                    (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                    (if (deferLoading.asKnown().isPresent) 1 else 0) +
+                    (if (description.asKnown().isPresent) 1 else 0) +
+                    (outputSchema.asKnown().getOrNull()?.validity() ?: 0) +
+                    (if (strict.asKnown().isPresent) 1 else 0)
+
+            class AllowedCaller
+            @JsonCreator
+            private constructor(private val value: JsonField<String>) : Enum {
+
+                /**
+                 * Returns this class instance's raw value.
+                 *
+                 * This is usually only useful if this instance was deserialized from data that
+                 * doesn't match any known member, and you want to know that value. For example, if
+                 * the SDK is on an older version than the API, then the API may respond with new
+                 * members that the SDK is unaware of.
+                 */
+                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+                companion object {
+
+                    @JvmField val DIRECT = of("direct")
+
+                    @JvmField val PROGRAMMATIC = of("programmatic")
+
+                    @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+                }
+
+                /** An enum containing [AllowedCaller]'s known values. */
+                enum class Known {
+                    DIRECT,
+                    PROGRAMMATIC,
+                }
+
+                /**
+                 * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN]
+                 * member.
+                 *
+                 * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+                 * - It was deserialized from data that doesn't match any known member. For example,
+                 *   if the SDK is on an older version than the API, then the API may respond with
+                 *   new members that the SDK is unaware of.
+                 * - It was constructed with an arbitrary value using the [of] method.
+                 */
+                enum class Value {
+                    DIRECT,
+                    PROGRAMMATIC,
+                    /**
+                     * An enum member indicating that [AllowedCaller] was instantiated with an
+                     * unknown value.
+                     */
+                    _UNKNOWN,
+                }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value, or
+                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                 *
+                 * Use the [known] method instead if you're certain the value is always known or if
+                 * you want to throw for the unknown case.
+                 */
+                fun value(): Value =
+                    when (this) {
+                        DIRECT -> Value.DIRECT
+                        PROGRAMMATIC -> Value.PROGRAMMATIC
+                        else -> Value._UNKNOWN
+                    }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value.
+                 *
+                 * Use the [value] method instead if you're uncertain the value is always known and
+                 * don't want to throw for the unknown case.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                 *   known member.
+                 */
+                fun known(): Known =
+                    when (this) {
+                        DIRECT -> Known.DIRECT
+                        PROGRAMMATIC -> Known.PROGRAMMATIC
+                        else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+                    }
+
+                /**
+                 * Returns this class instance's primitive wire representation.
+                 *
+                 * This differs from the [toString] method because that method is primarily for
+                 * debugging and generally doesn't throw.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value does not have
+                 *   the expected primitive type.
+                 */
+                fun asString(): String =
+                    _value().asString().orElseThrow {
+                        OpenAIInvalidDataException("Value is not a String")
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): AllowedCaller = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    known()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is AllowedCaller && value == other.value
+                }
+
+                override fun hashCode() = value.hashCode()
+
+                override fun toString() = value.toString()
+            }
+
+            /**
+             * A JSON Schema describing the JSON value encoded in string outputs for this function
+             * tool. This does not describe content-array outputs.
+             */
+            class OutputSchema
+            @JsonCreator
+            private constructor(
+                @com.fasterxml.jackson.annotation.JsonValue
+                private val additionalProperties: Map<String, JsonValue>
+            ) {
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /** Returns a mutable builder for constructing an instance of [OutputSchema]. */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [OutputSchema]. */
+                class Builder internal constructor() {
+
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(outputSchema: OutputSchema) = apply {
+                        additionalProperties = outputSchema.additionalProperties.toMutableMap()
+                    }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [OutputSchema].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     */
+                    fun build(): OutputSchema = OutputSchema(additionalProperties.toImmutable())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): OutputSchema = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    additionalProperties.count { (_, value) ->
+                        !value.isNull() && !value.isMissing()
+                    }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is OutputSchema &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() = "OutputSchema{additionalProperties=$additionalProperties}"
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Function &&
+                    name == other.name &&
+                    type == other.type &&
+                    allowedCallers == other.allowedCallers &&
+                    deferLoading == other.deferLoading &&
+                    description == other.description &&
+                    outputSchema == other.outputSchema &&
+                    parameters == other.parameters &&
+                    strict == other.strict &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(
+                    name,
+                    type,
+                    allowedCallers,
+                    deferLoading,
+                    description,
+                    outputSchema,
+                    parameters,
+                    strict,
+                    additionalProperties,
+                )
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Function{name=$name, type=$type, allowedCallers=$allowedCallers, deferLoading=$deferLoading, description=$description, outputSchema=$outputSchema, parameters=$parameters, strict=$strict, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaNamespaceTool &&
+            description == other.description &&
+            name == other.name &&
+            tools == other.tools &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(description, name, tools, type, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaNamespaceTool{description=$description, name=$name, tools=$tools, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponse.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponse.kt
new file mode 100644
index 000000000..2deddffa9
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponse.kt
@@ -0,0 +1,9394 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.allMaxBy
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class BetaResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val createdAt: JsonField<Double>,
+    private val error: JsonField<BetaResponseError>,
+    private val incompleteDetails: JsonField<IncompleteDetails>,
+    private val instructions: JsonField<Instructions>,
+    private val metadata: JsonField<Metadata>,
+    private val model: JsonField<Model>,
+    private val object_: JsonValue,
+    private val output: JsonField<List<BetaResponseOutputItem>>,
+    private val parallelToolCalls: JsonField<Boolean>,
+    private val temperature: JsonField<Double>,
+    private val toolChoice: JsonField<ToolChoice>,
+    private val tools: JsonField<List<BetaTool>>,
+    private val topP: JsonField<Double>,
+    private val background: JsonField<Boolean>,
+    private val completedAt: JsonField<Double>,
+    private val conversation: JsonField<Conversation>,
+    private val maxOutputTokens: JsonField<Long>,
+    private val maxToolCalls: JsonField<Long>,
+    private val moderation: JsonField<Moderation>,
+    private val previousResponseId: JsonField<String>,
+    private val prompt: JsonField<BetaResponsePrompt>,
+    private val promptCacheKey: JsonField<String>,
+    private val promptCacheOptions: JsonField<PromptCacheOptions>,
+    private val promptCacheRetention: JsonField<PromptCacheRetention>,
+    private val reasoning: JsonField<Reasoning>,
+    private val safetyIdentifier: JsonField<String>,
+    private val serviceTier: JsonField<ServiceTier>,
+    private val status: JsonField<BetaResponseStatus>,
+    private val text: JsonField<BetaResponseTextConfig>,
+    private val topLogprobs: JsonField<Long>,
+    private val truncation: JsonField<Truncation>,
+    private val usage: JsonField<BetaResponseUsage>,
+    private val user: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("created_at") @ExcludeMissing createdAt: JsonField<Double> = JsonMissing.of(),
+        @JsonProperty("error")
+        @ExcludeMissing
+        error: JsonField<BetaResponseError> = JsonMissing.of(),
+        @JsonProperty("incomplete_details")
+        @ExcludeMissing
+        incompleteDetails: JsonField<IncompleteDetails> = JsonMissing.of(),
+        @JsonProperty("instructions")
+        @ExcludeMissing
+        instructions: JsonField<Instructions> = JsonMissing.of(),
+        @JsonProperty("metadata") @ExcludeMissing metadata: JsonField<Metadata> = JsonMissing.of(),
+        @JsonProperty("model") @ExcludeMissing model: JsonField<Model> = JsonMissing.of(),
+        @JsonProperty("object") @ExcludeMissing object_: JsonValue = JsonMissing.of(),
+        @JsonProperty("output")
+        @ExcludeMissing
+        output: JsonField<List<BetaResponseOutputItem>> = JsonMissing.of(),
+        @JsonProperty("parallel_tool_calls")
+        @ExcludeMissing
+        parallelToolCalls: JsonField<Boolean> = JsonMissing.of(),
+        @JsonProperty("temperature")
+        @ExcludeMissing
+        temperature: JsonField<Double> = JsonMissing.of(),
+        @JsonProperty("tool_choice")
+        @ExcludeMissing
+        toolChoice: JsonField<ToolChoice> = JsonMissing.of(),
+        @JsonProperty("tools") @ExcludeMissing tools: JsonField<List<BetaTool>> = JsonMissing.of(),
+        @JsonProperty("top_p") @ExcludeMissing topP: JsonField<Double> = JsonMissing.of(),
+        @JsonProperty("background")
+        @ExcludeMissing
+        background: JsonField<Boolean> = JsonMissing.of(),
+        @JsonProperty("completed_at")
+        @ExcludeMissing
+        completedAt: JsonField<Double> = JsonMissing.of(),
+        @JsonProperty("conversation")
+        @ExcludeMissing
+        conversation: JsonField<Conversation> = JsonMissing.of(),
+        @JsonProperty("max_output_tokens")
+        @ExcludeMissing
+        maxOutputTokens: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("max_tool_calls")
+        @ExcludeMissing
+        maxToolCalls: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("moderation")
+        @ExcludeMissing
+        moderation: JsonField<Moderation> = JsonMissing.of(),
+        @JsonProperty("previous_response_id")
+        @ExcludeMissing
+        previousResponseId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("prompt")
+        @ExcludeMissing
+        prompt: JsonField<BetaResponsePrompt> = JsonMissing.of(),
+        @JsonProperty("prompt_cache_key")
+        @ExcludeMissing
+        promptCacheKey: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("prompt_cache_options")
+        @ExcludeMissing
+        promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of(),
+        @JsonProperty("prompt_cache_retention")
+        @ExcludeMissing
+        promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of(),
+        @JsonProperty("reasoning")
+        @ExcludeMissing
+        reasoning: JsonField<Reasoning> = JsonMissing.of(),
+        @JsonProperty("safety_identifier")
+        @ExcludeMissing
+        safetyIdentifier: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("service_tier")
+        @ExcludeMissing
+        serviceTier: JsonField<ServiceTier> = JsonMissing.of(),
+        @JsonProperty("status")
+        @ExcludeMissing
+        status: JsonField<BetaResponseStatus> = JsonMissing.of(),
+        @JsonProperty("text")
+        @ExcludeMissing
+        text: JsonField<BetaResponseTextConfig> = JsonMissing.of(),
+        @JsonProperty("top_logprobs")
+        @ExcludeMissing
+        topLogprobs: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("truncation")
+        @ExcludeMissing
+        truncation: JsonField<Truncation> = JsonMissing.of(),
+        @JsonProperty("usage")
+        @ExcludeMissing
+        usage: JsonField<BetaResponseUsage> = JsonMissing.of(),
+        @JsonProperty("user") @ExcludeMissing user: JsonField<String> = JsonMissing.of(),
+    ) : this(
+        id,
+        createdAt,
+        error,
+        incompleteDetails,
+        instructions,
+        metadata,
+        model,
+        object_,
+        output,
+        parallelToolCalls,
+        temperature,
+        toolChoice,
+        tools,
+        topP,
+        background,
+        completedAt,
+        conversation,
+        maxOutputTokens,
+        maxToolCalls,
+        moderation,
+        previousResponseId,
+        prompt,
+        promptCacheKey,
+        promptCacheOptions,
+        promptCacheRetention,
+        reasoning,
+        safetyIdentifier,
+        serviceTier,
+        status,
+        text,
+        topLogprobs,
+        truncation,
+        usage,
+        user,
+        mutableMapOf(),
+    )
+
+    /**
+     * Unique identifier for this Response.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * Unix timestamp (in seconds) of when this Response was created.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun createdAt(): Double = createdAt.getRequired("created_at")
+
+    /**
+     * An error object returned when the model fails to generate a Response.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun error(): Optional<BetaResponseError> = error.getOptional("error")
+
+    /**
+     * Details about why the response is incomplete.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun incompleteDetails(): Optional<IncompleteDetails> =
+        incompleteDetails.getOptional("incomplete_details")
+
+    /**
+     * A system (or developer) message inserted into the model's context.
+     *
+     * When using along with `previous_response_id`, the instructions from a previous response will
+     * not be carried over to the next response. This makes it simple to swap out system (or
+     * developer) messages in new responses.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun instructions(): Optional<Instructions> = instructions.getOptional("instructions")
+
+    /**
+     * Set of 16 key-value pairs that can be attached to an object. This can be useful for storing
+     * additional information about the object in a structured format, and querying for objects via
+     * API or the dashboard.
+     *
+     * Keys are strings with a maximum length of 64 characters. Values are strings with a maximum
+     * length of 512 characters.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun metadata(): Optional<Metadata> = metadata.getOptional("metadata")
+
+    /**
+     * Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide range of
+     * models with different capabilities, performance characteristics, and price points. Refer to
+     * the [model guide](https://platform.openai.com/docs/models) to browse and compare available
+     * models.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun model(): Model = model.getRequired("model")
+
+    /**
+     * The object type of this resource - always set to `response`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("object") @ExcludeMissing fun _object_(): JsonValue = object_
+
+    /**
+     * An array of content items generated by the model.
+     * - The length and order of items in the `output` array is dependent on the model's response.
+     * - Rather than accessing the first item in the `output` array and assuming it's an `assistant`
+     *   message with the content generated by the model, you might consider using the `output_text`
+     *   property where supported in SDKs.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun output(): List<BetaResponseOutputItem> = output.getRequired("output")
+
+    /**
+     * Whether to allow the model to run tool calls in parallel.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun parallelToolCalls(): Boolean = parallelToolCalls.getRequired("parallel_tool_calls")
+
+    /**
+     * What sampling temperature to use, between 0 and 2. Higher values like 0.8 will make the
+     * output more random, while lower values like 0.2 will make it more focused and deterministic.
+     * We generally recommend altering this or `top_p` but not both.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun temperature(): Optional<Double> = temperature.getOptional("temperature")
+
+    /**
+     * How the model should select which tool (or tools) to use when generating a response. See the
+     * `tools` parameter to see how to specify which tools the model can call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun toolChoice(): ToolChoice = toolChoice.getRequired("tool_choice")
+
+    /**
+     * An array of tools the model may call while generating a response. You can specify which tool
+     * to use by setting the `tool_choice` parameter.
+     *
+     * We support the following categories of tools:
+     * - **Built-in tools**: Tools that are provided by OpenAI that extend the model's capabilities,
+     *   like [web search](https://platform.openai.com/docs/guides/tools-web-search) or
+     *   [file search](https://platform.openai.com/docs/guides/tools-file-search). Learn more about
+     *   [built-in tools](https://platform.openai.com/docs/guides/tools).
+     * - **MCP Tools**: Integrations with third-party systems via custom MCP servers or predefined
+     *   connectors such as Google Drive and SharePoint. Learn more about
+     *   [MCP Tools](https://platform.openai.com/docs/guides/tools-connectors-mcp).
+     * - **Function calls (custom tools)**: Functions that are defined by you, enabling the model to
+     *   call your own code with strongly typed arguments and outputs. Learn more about
+     *   [function calling](https://platform.openai.com/docs/guides/function-calling). You can also
+     *   use custom tools to call your own code.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun tools(): List<BetaTool> = tools.getRequired("tools")
+
+    /**
+     * An alternative to sampling with temperature, called nucleus sampling, where the model
+     * considers the results of the tokens with top_p probability mass. So 0.1 means only the tokens
+     * comprising the top 10% probability mass are considered.
+     *
+     * We generally recommend altering this or `temperature` but not both.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun topP(): Optional<Double> = topP.getOptional("top_p")
+
+    /**
+     * Whether to run the model response in the background.
+     * [Learn more](https://platform.openai.com/docs/guides/background).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun background(): Optional<Boolean> = background.getOptional("background")
+
+    /**
+     * Unix timestamp (in seconds) of when this Response was completed. Only present when the status
+     * is `completed`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun completedAt(): Optional<Double> = completedAt.getOptional("completed_at")
+
+    /**
+     * The conversation that this response belonged to. Input items and output items from this
+     * response were automatically added to this conversation.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun conversation(): Optional<Conversation> = conversation.getOptional("conversation")
+
+    /**
+     * An upper bound for the number of tokens that can be generated for a response, including
+     * visible output tokens and
+     * [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun maxOutputTokens(): Optional<Long> = maxOutputTokens.getOptional("max_output_tokens")
+
+    /**
+     * The maximum number of total calls to built-in tools that can be processed in a response. This
+     * maximum number applies across all built-in tool calls, not per individual tool. Any further
+     * attempts to call a tool by the model will be ignored.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun maxToolCalls(): Optional<Long> = maxToolCalls.getOptional("max_tool_calls")
+
+    /**
+     * Moderation results for the response input and output, if moderated completions were
+     * requested.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun moderation(): Optional<Moderation> = moderation.getOptional("moderation")
+
+    /**
+     * The unique ID of the previous response to the model. Use this to create multi-turn
+     * conversations. Learn more about
+     * [conversation state](https://platform.openai.com/docs/guides/conversation-state). Cannot be
+     * used in conjunction with `conversation`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun previousResponseId(): Optional<String> =
+        previousResponseId.getOptional("previous_response_id")
+
+    /**
+     * Reference to a prompt template and its variables.
+     * [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun prompt(): Optional<BetaResponsePrompt> = prompt.getOptional("prompt")
+
+    /**
+     * Used by OpenAI to cache responses for similar requests to optimize your cache hit rates.
+     * Replaces the `user` field.
+     * [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheKey(): Optional<String> = promptCacheKey.getOptional("prompt_cache_key")
+
+    /**
+     * The prompt-caching options that were applied to the response. Supported for `gpt-5.6` and
+     * later models.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheOptions(): Optional<PromptCacheOptions> =
+        promptCacheOptions.getOptional("prompt_cache_options")
+
+    /**
+     * Deprecated. Use `prompt_cache_options.ttl` instead.
+     *
+     * The retention policy for the prompt cache. Set to `24h` to enable extended prompt caching,
+     * which keeps cached prefixes active for longer, up to a maximum of 24 hours.
+     * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+     * This field expresses a maximum retention policy, while `prompt_cache_options.ttl` expresses a
+     * minimum cache lifetime. The two fields are independent and do not interact. For `gpt-5.5`,
+     * `gpt-5.5-pro`, and future models, only `24h` is supported.
+     *
+     * For older models that support both `in_memory` and `24h`, the default depends on your
+     * organization's data retention policy:
+     * - Organizations without ZDR enabled default to `24h`.
+     * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is not
+     *   specified.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    @Deprecated("deprecated")
+    fun promptCacheRetention(): Optional<PromptCacheRetention> =
+        promptCacheRetention.getOptional("prompt_cache_retention")
+
+    /**
+     * **gpt-5 and o-series models only**
+     *
+     * Configuration options for
+     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun reasoning(): Optional<Reasoning> = reasoning.getOptional("reasoning")
+
+    /**
+     * A stable identifier used to help detect users of your application that may be violating
+     * OpenAI's usage policies. The IDs should be a string that uniquely identifies each user, with
+     * a maximum length of 64 characters. We recommend hashing their username or email address, in
+     * order to avoid sending us any identifying information.
+     * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun safetyIdentifier(): Optional<String> = safetyIdentifier.getOptional("safety_identifier")
+
+    /**
+     * Specifies the processing type used for serving the request.
+     * - If set to 'auto', then the request will be processed with the service tier configured in
+     *   the Project settings. Unless otherwise configured, the Project will use 'default'.
+     * - If set to 'default', then the request will be processed with the standard pricing and
+     *   performance for the selected model.
+     * - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
+     *   '[priority](https://openai.com/api-priority-processing/)', then the request will be
+     *   processed with the corresponding service tier.
+     * - When not set, the default behavior is 'auto'.
+     *
+     *   When the `service_tier` parameter is set, the response body will include the `service_tier`
+     *   value based on the processing mode actually used to serve the request. This response value
+     *   may be different from the value set in the parameter.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun serviceTier(): Optional<ServiceTier> = serviceTier.getOptional("service_tier")
+
+    /**
+     * The status of the response generation. One of `completed`, `failed`, `in_progress`,
+     * `cancelled`, `queued`, or `incomplete`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun status(): Optional<BetaResponseStatus> = status.getOptional("status")
+
+    /**
+     * Configuration options for a text response from the model. Can be plain text or structured
+     * JSON data. Learn more:
+     * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+     * - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun text(): Optional<BetaResponseTextConfig> = text.getOptional("text")
+
+    /**
+     * An integer between 0 and 20 specifying the maximum number of most likely tokens to return at
+     * each token position, each with an associated log probability. In some cases, the number of
+     * returned tokens may be fewer than requested.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun topLogprobs(): Optional<Long> = topLogprobs.getOptional("top_logprobs")
+
+    /**
+     * The truncation strategy to use for the model response.
+     * - `auto`: If the input to this Response exceeds the model's context window size, the model
+     *   will truncate the response to fit the context window by dropping items from the beginning
+     *   of the conversation.
+     * - `disabled` (default): If the input size will exceed the context window size for a model,
+     *   the request will fail with a 400 error.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun truncation(): Optional<Truncation> = truncation.getOptional("truncation")
+
+    /**
+     * Represents token usage details including input tokens, output tokens, a breakdown of output
+     * tokens, and the total tokens used.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun usage(): Optional<BetaResponseUsage> = usage.getOptional("usage")
+
+    /**
+     * This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+     * `prompt_cache_key` instead to maintain caching optimizations. 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#safety-identifiers).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    @Deprecated("deprecated") fun user(): Optional<String> = user.getOptional("user")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [createdAt].
+     *
+     * Unlike [createdAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_at") @ExcludeMissing fun _createdAt(): JsonField<Double> = createdAt
+
+    /**
+     * Returns the raw JSON value of [error].
+     *
+     * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<BetaResponseError> = error
+
+    /**
+     * Returns the raw JSON value of [incompleteDetails].
+     *
+     * Unlike [incompleteDetails], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("incomplete_details")
+    @ExcludeMissing
+    fun _incompleteDetails(): JsonField<IncompleteDetails> = incompleteDetails
+
+    /**
+     * Returns the raw JSON value of [instructions].
+     *
+     * Unlike [instructions], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("instructions")
+    @ExcludeMissing
+    fun _instructions(): JsonField<Instructions> = instructions
+
+    /**
+     * Returns the raw JSON value of [metadata].
+     *
+     * Unlike [metadata], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("metadata") @ExcludeMissing fun _metadata(): JsonField<Metadata> = metadata
+
+    /**
+     * Returns the raw JSON value of [model].
+     *
+     * Unlike [model], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("model") @ExcludeMissing fun _model(): JsonField<Model> = model
+
+    /**
+     * Returns the raw JSON value of [output].
+     *
+     * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output")
+    @ExcludeMissing
+    fun _output(): JsonField<List<BetaResponseOutputItem>> = output
+
+    /**
+     * Returns the raw JSON value of [parallelToolCalls].
+     *
+     * Unlike [parallelToolCalls], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("parallel_tool_calls")
+    @ExcludeMissing
+    fun _parallelToolCalls(): JsonField<Boolean> = parallelToolCalls
+
+    /**
+     * Returns the raw JSON value of [temperature].
+     *
+     * Unlike [temperature], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("temperature") @ExcludeMissing fun _temperature(): JsonField<Double> = temperature
+
+    /**
+     * Returns the raw JSON value of [toolChoice].
+     *
+     * Unlike [toolChoice], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("tool_choice")
+    @ExcludeMissing
+    fun _toolChoice(): JsonField<ToolChoice> = toolChoice
+
+    /**
+     * Returns the raw JSON value of [tools].
+     *
+     * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<BetaTool>> = tools
+
+    /**
+     * Returns the raw JSON value of [topP].
+     *
+     * Unlike [topP], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("top_p") @ExcludeMissing fun _topP(): JsonField<Double> = topP
+
+    /**
+     * Returns the raw JSON value of [background].
+     *
+     * Unlike [background], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("background") @ExcludeMissing fun _background(): JsonField<Boolean> = background
+
+    /**
+     * Returns the raw JSON value of [completedAt].
+     *
+     * Unlike [completedAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("completed_at")
+    @ExcludeMissing
+    fun _completedAt(): JsonField<Double> = completedAt
+
+    /**
+     * Returns the raw JSON value of [conversation].
+     *
+     * Unlike [conversation], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("conversation")
+    @ExcludeMissing
+    fun _conversation(): JsonField<Conversation> = conversation
+
+    /**
+     * Returns the raw JSON value of [maxOutputTokens].
+     *
+     * Unlike [maxOutputTokens], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("max_output_tokens")
+    @ExcludeMissing
+    fun _maxOutputTokens(): JsonField<Long> = maxOutputTokens
+
+    /**
+     * Returns the raw JSON value of [maxToolCalls].
+     *
+     * Unlike [maxToolCalls], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("max_tool_calls")
+    @ExcludeMissing
+    fun _maxToolCalls(): JsonField<Long> = maxToolCalls
+
+    /**
+     * Returns the raw JSON value of [moderation].
+     *
+     * Unlike [moderation], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("moderation")
+    @ExcludeMissing
+    fun _moderation(): JsonField<Moderation> = moderation
+
+    /**
+     * Returns the raw JSON value of [previousResponseId].
+     *
+     * Unlike [previousResponseId], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("previous_response_id")
+    @ExcludeMissing
+    fun _previousResponseId(): JsonField<String> = previousResponseId
+
+    /**
+     * Returns the raw JSON value of [prompt].
+     *
+     * Unlike [prompt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("prompt") @ExcludeMissing fun _prompt(): JsonField<BetaResponsePrompt> = prompt
+
+    /**
+     * Returns the raw JSON value of [promptCacheKey].
+     *
+     * Unlike [promptCacheKey], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("prompt_cache_key")
+    @ExcludeMissing
+    fun _promptCacheKey(): JsonField<String> = promptCacheKey
+
+    /**
+     * Returns the raw JSON value of [promptCacheOptions].
+     *
+     * Unlike [promptCacheOptions], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_options")
+    @ExcludeMissing
+    fun _promptCacheOptions(): JsonField<PromptCacheOptions> = promptCacheOptions
+
+    /**
+     * Returns the raw JSON value of [promptCacheRetention].
+     *
+     * Unlike [promptCacheRetention], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @Deprecated("deprecated")
+    @JsonProperty("prompt_cache_retention")
+    @ExcludeMissing
+    fun _promptCacheRetention(): JsonField<PromptCacheRetention> = promptCacheRetention
+
+    /**
+     * Returns the raw JSON value of [reasoning].
+     *
+     * Unlike [reasoning], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("reasoning") @ExcludeMissing fun _reasoning(): JsonField<Reasoning> = reasoning
+
+    /**
+     * Returns the raw JSON value of [safetyIdentifier].
+     *
+     * Unlike [safetyIdentifier], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("safety_identifier")
+    @ExcludeMissing
+    fun _safetyIdentifier(): JsonField<String> = safetyIdentifier
+
+    /**
+     * Returns the raw JSON value of [serviceTier].
+     *
+     * Unlike [serviceTier], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("service_tier")
+    @ExcludeMissing
+    fun _serviceTier(): JsonField<ServiceTier> = serviceTier
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<BetaResponseStatus> = status
+
+    /**
+     * Returns the raw JSON value of [text].
+     *
+     * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<BetaResponseTextConfig> = text
+
+    /**
+     * Returns the raw JSON value of [topLogprobs].
+     *
+     * Unlike [topLogprobs], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("top_logprobs") @ExcludeMissing fun _topLogprobs(): JsonField<Long> = topLogprobs
+
+    /**
+     * Returns the raw JSON value of [truncation].
+     *
+     * Unlike [truncation], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("truncation")
+    @ExcludeMissing
+    fun _truncation(): JsonField<Truncation> = truncation
+
+    /**
+     * Returns the raw JSON value of [usage].
+     *
+     * Unlike [usage], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("usage") @ExcludeMissing fun _usage(): JsonField<BetaResponseUsage> = usage
+
+    /**
+     * Returns the raw JSON value of [user].
+     *
+     * Unlike [user], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @Deprecated("deprecated")
+    @JsonProperty("user")
+    @ExcludeMissing
+    fun _user(): JsonField<String> = user
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponse].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .createdAt()
+         * .error()
+         * .incompleteDetails()
+         * .instructions()
+         * .metadata()
+         * .model()
+         * .output()
+         * .parallelToolCalls()
+         * .temperature()
+         * .toolChoice()
+         * .tools()
+         * .topP()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponse]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var createdAt: JsonField<Double>? = null
+        private var error: JsonField<BetaResponseError>? = null
+        private var incompleteDetails: JsonField<IncompleteDetails>? = null
+        private var instructions: JsonField<Instructions>? = null
+        private var metadata: JsonField<Metadata>? = null
+        private var model: JsonField<Model>? = null
+        private var object_: JsonValue = JsonValue.from("response")
+        private var output: JsonField<MutableList<BetaResponseOutputItem>>? = null
+        private var parallelToolCalls: JsonField<Boolean>? = null
+        private var temperature: JsonField<Double>? = null
+        private var toolChoice: JsonField<ToolChoice>? = null
+        private var tools: JsonField<MutableList<BetaTool>>? = null
+        private var topP: JsonField<Double>? = null
+        private var background: JsonField<Boolean> = JsonMissing.of()
+        private var completedAt: JsonField<Double> = JsonMissing.of()
+        private var conversation: JsonField<Conversation> = JsonMissing.of()
+        private var maxOutputTokens: JsonField<Long> = JsonMissing.of()
+        private var maxToolCalls: JsonField<Long> = JsonMissing.of()
+        private var moderation: JsonField<Moderation> = JsonMissing.of()
+        private var previousResponseId: JsonField<String> = JsonMissing.of()
+        private var prompt: JsonField<BetaResponsePrompt> = JsonMissing.of()
+        private var promptCacheKey: JsonField<String> = JsonMissing.of()
+        private var promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of()
+        private var promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of()
+        private var reasoning: JsonField<Reasoning> = JsonMissing.of()
+        private var safetyIdentifier: JsonField<String> = JsonMissing.of()
+        private var serviceTier: JsonField<ServiceTier> = JsonMissing.of()
+        private var status: JsonField<BetaResponseStatus> = JsonMissing.of()
+        private var text: JsonField<BetaResponseTextConfig> = JsonMissing.of()
+        private var topLogprobs: JsonField<Long> = JsonMissing.of()
+        private var truncation: JsonField<Truncation> = JsonMissing.of()
+        private var usage: JsonField<BetaResponseUsage> = JsonMissing.of()
+        private var user: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponse: BetaResponse) = apply {
+            id = betaResponse.id
+            createdAt = betaResponse.createdAt
+            error = betaResponse.error
+            incompleteDetails = betaResponse.incompleteDetails
+            instructions = betaResponse.instructions
+            metadata = betaResponse.metadata
+            model = betaResponse.model
+            object_ = betaResponse.object_
+            output = betaResponse.output.map { it.toMutableList() }
+            parallelToolCalls = betaResponse.parallelToolCalls
+            temperature = betaResponse.temperature
+            toolChoice = betaResponse.toolChoice
+            tools = betaResponse.tools.map { it.toMutableList() }
+            topP = betaResponse.topP
+            background = betaResponse.background
+            completedAt = betaResponse.completedAt
+            conversation = betaResponse.conversation
+            maxOutputTokens = betaResponse.maxOutputTokens
+            maxToolCalls = betaResponse.maxToolCalls
+            moderation = betaResponse.moderation
+            previousResponseId = betaResponse.previousResponseId
+            prompt = betaResponse.prompt
+            promptCacheKey = betaResponse.promptCacheKey
+            promptCacheOptions = betaResponse.promptCacheOptions
+            promptCacheRetention = betaResponse.promptCacheRetention
+            reasoning = betaResponse.reasoning
+            safetyIdentifier = betaResponse.safetyIdentifier
+            serviceTier = betaResponse.serviceTier
+            status = betaResponse.status
+            text = betaResponse.text
+            topLogprobs = betaResponse.topLogprobs
+            truncation = betaResponse.truncation
+            usage = betaResponse.usage
+            user = betaResponse.user
+            additionalProperties = betaResponse.additionalProperties.toMutableMap()
+        }
+
+        /** Unique identifier for this Response. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** Unix timestamp (in seconds) of when this Response was created. */
+        fun createdAt(createdAt: Double) = createdAt(JsonField.of(createdAt))
+
+        /**
+         * Sets [Builder.createdAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdAt] with a well-typed [Double] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun createdAt(createdAt: JsonField<Double>) = apply { this.createdAt = createdAt }
+
+        /** An error object returned when the model fails to generate a Response. */
+        fun error(error: BetaResponseError?) = error(JsonField.ofNullable(error))
+
+        /** Alias for calling [Builder.error] with `error.orElse(null)`. */
+        fun error(error: Optional<BetaResponseError>) = error(error.getOrNull())
+
+        /**
+         * Sets [Builder.error] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.error] with a well-typed [BetaResponseError] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun error(error: JsonField<BetaResponseError>) = apply { this.error = error }
+
+        /** Details about why the response is incomplete. */
+        fun incompleteDetails(incompleteDetails: IncompleteDetails?) =
+            incompleteDetails(JsonField.ofNullable(incompleteDetails))
+
+        /** Alias for calling [Builder.incompleteDetails] with `incompleteDetails.orElse(null)`. */
+        fun incompleteDetails(incompleteDetails: Optional<IncompleteDetails>) =
+            incompleteDetails(incompleteDetails.getOrNull())
+
+        /**
+         * Sets [Builder.incompleteDetails] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.incompleteDetails] with a well-typed [IncompleteDetails]
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun incompleteDetails(incompleteDetails: JsonField<IncompleteDetails>) = apply {
+            this.incompleteDetails = incompleteDetails
+        }
+
+        /**
+         * A system (or developer) message inserted into the model's context.
+         *
+         * When using along with `previous_response_id`, the instructions from a previous response
+         * will not be carried over to the next response. This makes it simple to swap out system
+         * (or developer) messages in new responses.
+         */
+        fun instructions(instructions: Instructions?) =
+            instructions(JsonField.ofNullable(instructions))
+
+        /** Alias for calling [Builder.instructions] with `instructions.orElse(null)`. */
+        fun instructions(instructions: Optional<Instructions>) =
+            instructions(instructions.getOrNull())
+
+        /**
+         * Sets [Builder.instructions] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.instructions] with a well-typed [Instructions] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun instructions(instructions: JsonField<Instructions>) = apply {
+            this.instructions = instructions
+        }
+
+        /** Alias for calling [instructions] with `Instructions.ofString(string)`. */
+        fun instructions(string: String) = instructions(Instructions.ofString(string))
+
+        /** Alias for calling [instructions] with `Instructions.ofInputItemList(inputItemList)`. */
+        fun instructionsOfInputItemList(inputItemList: List<BetaResponseInputItem>) =
+            instructions(Instructions.ofInputItemList(inputItemList))
+
+        /**
+         * Set of 16 key-value pairs that can be attached to an object. This can be useful for
+         * storing additional information about the object in a structured format, and querying for
+         * objects via API or the dashboard.
+         *
+         * Keys are strings with a maximum length of 64 characters. Values are strings with a
+         * maximum length of 512 characters.
+         */
+        fun metadata(metadata: Metadata?) = metadata(JsonField.ofNullable(metadata))
+
+        /** Alias for calling [Builder.metadata] with `metadata.orElse(null)`. */
+        fun metadata(metadata: Optional<Metadata>) = metadata(metadata.getOrNull())
+
+        /**
+         * Sets [Builder.metadata] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.metadata] with a well-typed [Metadata] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun metadata(metadata: JsonField<Metadata>) = apply { this.metadata = metadata }
+
+        /**
+         * Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide range
+         * of models with different capabilities, performance characteristics, and price points.
+         * Refer to the [model guide](https://platform.openai.com/docs/models) to browse and compare
+         * available models.
+         */
+        fun model(model: Model) = model(JsonField.of(model))
+
+        /**
+         * Sets [Builder.model] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.model] with a well-typed [Model] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun model(model: JsonField<Model>) = apply { this.model = model }
+
+        /**
+         * Sets [model] to an arbitrary [String].
+         *
+         * You should usually call [model] with a well-typed [Model] constant instead. This method
+         * is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun model(value: String) = model(Model.of(value))
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun object_(object_: JsonValue) = apply { this.object_ = object_ }
+
+        /**
+         * An array of content items generated by the model.
+         * - The length and order of items in the `output` array is dependent on the model's
+         *   response.
+         * - Rather than accessing the first item in the `output` array and assuming it's an
+         *   `assistant` message with the content generated by the model, you might consider using
+         *   the `output_text` property where supported in SDKs.
+         */
+        fun output(output: List<BetaResponseOutputItem>) = output(JsonField.of(output))
+
+        /**
+         * Sets [Builder.output] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.output] with a well-typed `List<BetaResponseOutputItem>`
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun output(output: JsonField<List<BetaResponseOutputItem>>) = apply {
+            this.output = output.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [BetaResponseOutputItem] to [Builder.output].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addOutput(output: BetaResponseOutputItem) = apply {
+            this.output =
+                (this.output ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("output", it).add(output)
+                }
+        }
+
+        /** Alias for calling [addOutput] with `BetaResponseOutputItem.ofMessage(message)`. */
+        fun addOutput(message: BetaResponseOutputMessage) =
+            addOutput(BetaResponseOutputItem.ofMessage(message))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofFileSearchCall(fileSearchCall)`.
+         */
+        fun addOutput(fileSearchCall: BetaResponseFileSearchToolCall) =
+            addOutput(BetaResponseOutputItem.ofFileSearchCall(fileSearchCall))
+
+        /**
+         * Alias for calling [addOutput] with `BetaResponseOutputItem.ofFunctionCall(functionCall)`.
+         */
+        fun addOutput(functionCall: BetaResponseFunctionToolCall) =
+            addOutput(BetaResponseOutputItem.ofFunctionCall(functionCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofFunctionCallOutput(functionCallOutput)`.
+         */
+        fun addOutput(functionCallOutput: BetaResponseFunctionToolCallOutputItem) =
+            addOutput(BetaResponseOutputItem.ofFunctionCallOutput(functionCallOutput))
+
+        /**
+         * Alias for calling [addOutput] with `BetaResponseOutputItem.ofAgentMessage(agentMessage)`.
+         */
+        fun addOutput(agentMessage: BetaResponseOutputItem.AgentMessage) =
+            addOutput(BetaResponseOutputItem.ofAgentMessage(agentMessage))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofMultiAgentCall(multiAgentCall)`.
+         */
+        fun addOutput(multiAgentCall: BetaResponseOutputItem.MultiAgentCall) =
+            addOutput(BetaResponseOutputItem.ofMultiAgentCall(multiAgentCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofMultiAgentCallOutput(multiAgentCallOutput)`.
+         */
+        fun addOutput(multiAgentCallOutput: BetaResponseOutputItem.MultiAgentCallOutput) =
+            addOutput(BetaResponseOutputItem.ofMultiAgentCallOutput(multiAgentCallOutput))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofWebSearchCall(webSearchCall)`.
+         */
+        fun addOutput(webSearchCall: BetaResponseFunctionWebSearch) =
+            addOutput(BetaResponseOutputItem.ofWebSearchCall(webSearchCall))
+
+        /**
+         * Alias for calling [addOutput] with `BetaResponseOutputItem.ofComputerCall(computerCall)`.
+         */
+        fun addOutput(computerCall: BetaResponseComputerToolCall) =
+            addOutput(BetaResponseOutputItem.ofComputerCall(computerCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofComputerCallOutput(computerCallOutput)`.
+         */
+        fun addOutput(computerCallOutput: BetaResponseComputerToolCallOutputItem) =
+            addOutput(BetaResponseOutputItem.ofComputerCallOutput(computerCallOutput))
+
+        /** Alias for calling [addOutput] with `BetaResponseOutputItem.ofReasoning(reasoning)`. */
+        fun addOutput(reasoning: BetaResponseReasoningItem) =
+            addOutput(BetaResponseOutputItem.ofReasoning(reasoning))
+
+        /** Alias for calling [addOutput] with `BetaResponseOutputItem.ofProgram(program)`. */
+        fun addOutput(program: BetaResponseOutputItem.Program) =
+            addOutput(BetaResponseOutputItem.ofProgram(program))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofProgramOutput(programOutput)`.
+         */
+        fun addOutput(programOutput: BetaResponseOutputItem.ProgramOutput) =
+            addOutput(BetaResponseOutputItem.ofProgramOutput(programOutput))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofToolSearchCall(toolSearchCall)`.
+         */
+        fun addOutput(toolSearchCall: BetaResponseToolSearchCall) =
+            addOutput(BetaResponseOutputItem.ofToolSearchCall(toolSearchCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofToolSearchOutput(toolSearchOutput)`.
+         */
+        fun addOutput(toolSearchOutput: BetaResponseToolSearchOutputItem) =
+            addOutput(BetaResponseOutputItem.ofToolSearchOutput(toolSearchOutput))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofAdditionalTools(additionalTools)`.
+         */
+        fun addOutput(additionalTools: BetaResponseOutputItem.AdditionalTools) =
+            addOutput(BetaResponseOutputItem.ofAdditionalTools(additionalTools))
+
+        /** Alias for calling [addOutput] with `BetaResponseOutputItem.ofCompaction(compaction)`. */
+        fun addOutput(compaction: BetaResponseCompactionItem) =
+            addOutput(BetaResponseOutputItem.ofCompaction(compaction))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofImageGenerationCall(imageGenerationCall)`.
+         */
+        fun addOutput(imageGenerationCall: BetaResponseOutputItem.ImageGenerationCall) =
+            addOutput(BetaResponseOutputItem.ofImageGenerationCall(imageGenerationCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofCodeInterpreterCall(codeInterpreterCall)`.
+         */
+        fun addOutput(codeInterpreterCall: BetaResponseCodeInterpreterToolCall) =
+            addOutput(BetaResponseOutputItem.ofCodeInterpreterCall(codeInterpreterCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofLocalShellCall(localShellCall)`.
+         */
+        fun addOutput(localShellCall: BetaResponseOutputItem.LocalShellCall) =
+            addOutput(BetaResponseOutputItem.ofLocalShellCall(localShellCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofLocalShellCallOutput(localShellCallOutput)`.
+         */
+        fun addOutput(localShellCallOutput: BetaResponseOutputItem.LocalShellCallOutput) =
+            addOutput(BetaResponseOutputItem.ofLocalShellCallOutput(localShellCallOutput))
+
+        /** Alias for calling [addOutput] with `BetaResponseOutputItem.ofShellCall(shellCall)`. */
+        fun addOutput(shellCall: BetaResponseFunctionShellToolCall) =
+            addOutput(BetaResponseOutputItem.ofShellCall(shellCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofShellCallOutput(shellCallOutput)`.
+         */
+        fun addOutput(shellCallOutput: BetaResponseFunctionShellToolCallOutput) =
+            addOutput(BetaResponseOutputItem.ofShellCallOutput(shellCallOutput))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofApplyPatchCall(applyPatchCall)`.
+         */
+        fun addOutput(applyPatchCall: BetaResponseApplyPatchToolCall) =
+            addOutput(BetaResponseOutputItem.ofApplyPatchCall(applyPatchCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofApplyPatchCallOutput(applyPatchCallOutput)`.
+         */
+        fun addOutput(applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput) =
+            addOutput(BetaResponseOutputItem.ofApplyPatchCallOutput(applyPatchCallOutput))
+
+        /** Alias for calling [addOutput] with `BetaResponseOutputItem.ofMcpCall(mcpCall)`. */
+        fun addOutput(mcpCall: BetaResponseOutputItem.McpCall) =
+            addOutput(BetaResponseOutputItem.ofMcpCall(mcpCall))
+
+        /**
+         * Alias for calling [addOutput] with `BetaResponseOutputItem.ofMcpListTools(mcpListTools)`.
+         */
+        fun addOutput(mcpListTools: BetaResponseOutputItem.McpListTools) =
+            addOutput(BetaResponseOutputItem.ofMcpListTools(mcpListTools))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofMcpApprovalRequest(mcpApprovalRequest)`.
+         */
+        fun addOutput(mcpApprovalRequest: BetaResponseOutputItem.McpApprovalRequest) =
+            addOutput(BetaResponseOutputItem.ofMcpApprovalRequest(mcpApprovalRequest))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofMcpApprovalResponse(mcpApprovalResponse)`.
+         */
+        fun addOutput(mcpApprovalResponse: BetaResponseOutputItem.McpApprovalResponse) =
+            addOutput(BetaResponseOutputItem.ofMcpApprovalResponse(mcpApprovalResponse))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofCustomToolCall(customToolCall)`.
+         */
+        fun addOutput(customToolCall: BetaResponseCustomToolCall) =
+            addOutput(BetaResponseOutputItem.ofCustomToolCall(customToolCall))
+
+        /**
+         * Alias for calling [addOutput] with
+         * `BetaResponseOutputItem.ofCustomToolCallOutput(customToolCallOutput)`.
+         */
+        fun addOutput(customToolCallOutput: BetaResponseCustomToolCallOutputItem) =
+            addOutput(BetaResponseOutputItem.ofCustomToolCallOutput(customToolCallOutput))
+
+        /** Whether to allow the model to run tool calls in parallel. */
+        fun parallelToolCalls(parallelToolCalls: Boolean) =
+            parallelToolCalls(JsonField.of(parallelToolCalls))
+
+        /**
+         * Sets [Builder.parallelToolCalls] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.parallelToolCalls] with a well-typed [Boolean] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun parallelToolCalls(parallelToolCalls: JsonField<Boolean>) = apply {
+            this.parallelToolCalls = parallelToolCalls
+        }
+
+        /**
+         * What sampling temperature to use, between 0 and 2. Higher values like 0.8 will make the
+         * output more random, while lower values like 0.2 will make it more focused and
+         * deterministic. We generally recommend altering this or `top_p` but not both.
+         */
+        fun temperature(temperature: Double?) = temperature(JsonField.ofNullable(temperature))
+
+        /**
+         * Alias for [Builder.temperature].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun temperature(temperature: Double) = temperature(temperature as Double?)
+
+        /** Alias for calling [Builder.temperature] with `temperature.orElse(null)`. */
+        fun temperature(temperature: Optional<Double>) = temperature(temperature.getOrNull())
+
+        /**
+         * Sets [Builder.temperature] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.temperature] with a well-typed [Double] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun temperature(temperature: JsonField<Double>) = apply { this.temperature = temperature }
+
+        /**
+         * How the model should select which tool (or tools) to use when generating a response. See
+         * the `tools` parameter to see how to specify which tools the model can call.
+         */
+        fun toolChoice(toolChoice: ToolChoice) = toolChoice(JsonField.of(toolChoice))
+
+        /**
+         * Sets [Builder.toolChoice] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.toolChoice] with a well-typed [ToolChoice] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun toolChoice(toolChoice: JsonField<ToolChoice>) = apply { this.toolChoice = toolChoice }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceOptions(betaToolChoiceOptions)`.
+         */
+        fun toolChoice(betaToolChoiceOptions: BetaToolChoiceOptions) =
+            toolChoice(ToolChoice.ofBetaToolChoiceOptions(betaToolChoiceOptions))
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceAllowed(betaToolChoiceAllowed)`.
+         */
+        fun toolChoice(betaToolChoiceAllowed: BetaToolChoiceAllowed) =
+            toolChoice(ToolChoice.ofBetaToolChoiceAllowed(betaToolChoiceAllowed))
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceTypes(betaToolChoiceTypes)`.
+         */
+        fun toolChoice(betaToolChoiceTypes: BetaToolChoiceTypes) =
+            toolChoice(ToolChoice.ofBetaToolChoiceTypes(betaToolChoiceTypes))
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceFunction(betaToolChoiceFunction)`.
+         */
+        fun toolChoice(betaToolChoiceFunction: BetaToolChoiceFunction) =
+            toolChoice(ToolChoice.ofBetaToolChoiceFunction(betaToolChoiceFunction))
+
+        /**
+         * Alias for calling [toolChoice] with `ToolChoice.ofBetaToolChoiceMcp(betaToolChoiceMcp)`.
+         */
+        fun toolChoice(betaToolChoiceMcp: BetaToolChoiceMcp) =
+            toolChoice(ToolChoice.ofBetaToolChoiceMcp(betaToolChoiceMcp))
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceCustom(betaToolChoiceCustom)`.
+         */
+        fun toolChoice(betaToolChoiceCustom: BetaToolChoiceCustom) =
+            toolChoice(ToolChoice.ofBetaToolChoiceCustom(betaToolChoiceCustom))
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaSpecificProgrammaticToolCallingParam()`.
+         */
+        fun toolChoiceBetaSpecificProgrammaticToolCallingParam() =
+            toolChoice(ToolChoice.ofBetaSpecificProgrammaticToolCallingParam())
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch)`.
+         */
+        fun toolChoice(betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch) =
+            toolChoice(ToolChoice.ofBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch))
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceShell(betaToolChoiceShell)`.
+         */
+        fun toolChoice(betaToolChoiceShell: BetaToolChoiceShell) =
+            toolChoice(ToolChoice.ofBetaToolChoiceShell(betaToolChoiceShell))
+
+        /**
+         * An array of tools the model may call while generating a response. You can specify which
+         * tool to use by setting the `tool_choice` parameter.
+         *
+         * We support the following categories of tools:
+         * - **Built-in tools**: Tools that are provided by OpenAI that extend the model's
+         *   capabilities, like
+         *   [web search](https://platform.openai.com/docs/guides/tools-web-search) or
+         *   [file search](https://platform.openai.com/docs/guides/tools-file-search). Learn more
+         *   about [built-in tools](https://platform.openai.com/docs/guides/tools).
+         * - **MCP Tools**: Integrations with third-party systems via custom MCP servers or
+         *   predefined connectors such as Google Drive and SharePoint. Learn more about
+         *   [MCP Tools](https://platform.openai.com/docs/guides/tools-connectors-mcp).
+         * - **Function calls (custom tools)**: Functions that are defined by you, enabling the
+         *   model to call your own code with strongly typed arguments and outputs. Learn more about
+         *   [function calling](https://platform.openai.com/docs/guides/function-calling). You can
+         *   also use custom tools to call your own code.
+         */
+        fun tools(tools: List<BetaTool>) = tools(JsonField.of(tools))
+
+        /**
+         * Sets [Builder.tools] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.tools] with a well-typed `List<BetaTool>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun tools(tools: JsonField<List<BetaTool>>) = apply {
+            this.tools = tools.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [BetaTool] to [tools].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addTool(tool: BetaTool) = apply {
+            tools =
+                (tools ?: JsonField.of(mutableListOf())).also { checkKnown("tools", it).add(tool) }
+        }
+
+        /** Alias for calling [addTool] with `BetaTool.ofFunction(function)`. */
+        fun addTool(function: BetaFunctionTool) = addTool(BetaTool.ofFunction(function))
+
+        /** Alias for calling [addTool] with `BetaTool.ofFileSearch(fileSearch)`. */
+        fun addTool(fileSearch: BetaFileSearchTool) = addTool(BetaTool.ofFileSearch(fileSearch))
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaFileSearchTool.builder()
+         *     .vectorStoreIds(vectorStoreIds)
+         *     .build()
+         * ```
+         */
+        fun addFileSearchTool(vectorStoreIds: List<String>) =
+            addTool(BetaFileSearchTool.builder().vectorStoreIds(vectorStoreIds).build())
+
+        /** Alias for calling [addTool] with `BetaTool.ofComputer(computer)`. */
+        fun addTool(computer: BetaComputerTool) = addTool(BetaTool.ofComputer(computer))
+
+        /** Alias for calling [addTool] with `BetaTool.ofComputerUsePreview(computerUsePreview)`. */
+        fun addTool(computerUsePreview: BetaComputerUsePreviewTool) =
+            addTool(BetaTool.ofComputerUsePreview(computerUsePreview))
+
+        /** Alias for calling [addTool] with `BetaTool.ofWebSearch(webSearch)`. */
+        fun addTool(webSearch: BetaWebSearchTool) = addTool(BetaTool.ofWebSearch(webSearch))
+
+        /** Alias for calling [addTool] with `BetaTool.ofMcp(mcp)`. */
+        fun addTool(mcp: BetaTool.Mcp) = addTool(BetaTool.ofMcp(mcp))
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaTool.Mcp.builder()
+         *     .serverLabel(serverLabel)
+         *     .build()
+         * ```
+         */
+        fun addMcpTool(serverLabel: String) =
+            addTool(BetaTool.Mcp.builder().serverLabel(serverLabel).build())
+
+        /** Alias for calling [addTool] with `BetaTool.ofCodeInterpreter(codeInterpreter)`. */
+        fun addTool(codeInterpreter: BetaTool.CodeInterpreter) =
+            addTool(BetaTool.ofCodeInterpreter(codeInterpreter))
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaTool.CodeInterpreter.builder()
+         *     .container(container)
+         *     .build()
+         * ```
+         */
+        fun addCodeInterpreterTool(container: BetaTool.CodeInterpreter.Container) =
+            addTool(BetaTool.CodeInterpreter.builder().container(container).build())
+
+        /**
+         * Alias for calling [addCodeInterpreterTool] with
+         * `BetaTool.CodeInterpreter.Container.ofString(string)`.
+         */
+        fun addCodeInterpreterTool(string: String) =
+            addCodeInterpreterTool(BetaTool.CodeInterpreter.Container.ofString(string))
+
+        /**
+         * Alias for calling [addCodeInterpreterTool] with
+         * `BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)`.
+         */
+        fun addCodeInterpreterTool(
+            codeInterpreterToolAuto: BetaTool.CodeInterpreter.Container.CodeInterpreterToolAuto
+        ) =
+            addCodeInterpreterTool(
+                BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(
+                    codeInterpreterToolAuto
+                )
+            )
+
+        /** Alias for calling [addTool] with `BetaTool.ofProgrammaticToolCalling()`. */
+        fun addToolProgrammaticToolCalling() = addTool(BetaTool.ofProgrammaticToolCalling())
+
+        /** Alias for calling [addTool] with `BetaTool.ofImageGeneration(imageGeneration)`. */
+        fun addTool(imageGeneration: BetaTool.ImageGeneration) =
+            addTool(BetaTool.ofImageGeneration(imageGeneration))
+
+        /** Alias for calling [addTool] with `BetaTool.ofLocalShell()`. */
+        fun addToolLocalShell() = addTool(BetaTool.ofLocalShell())
+
+        /** Alias for calling [addTool] with `BetaTool.ofShell(shell)`. */
+        fun addTool(shell: BetaFunctionShellTool) = addTool(BetaTool.ofShell(shell))
+
+        /** Alias for calling [addTool] with `BetaTool.ofCustom(custom)`. */
+        fun addTool(custom: BetaCustomTool) = addTool(BetaTool.ofCustom(custom))
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaCustomTool.builder()
+         *     .name(name)
+         *     .build()
+         * ```
+         */
+        fun addCustomTool(name: String) = addTool(BetaCustomTool.builder().name(name).build())
+
+        /** Alias for calling [addTool] with `BetaTool.ofNamespace(namespace)`. */
+        fun addTool(namespace: BetaNamespaceTool) = addTool(BetaTool.ofNamespace(namespace))
+
+        /** Alias for calling [addTool] with `BetaTool.ofToolSearch(toolSearch)`. */
+        fun addTool(toolSearch: BetaToolSearchTool) = addTool(BetaTool.ofToolSearch(toolSearch))
+
+        /** Alias for calling [addTool] with `BetaTool.ofWebSearchPreview(webSearchPreview)`. */
+        fun addTool(webSearchPreview: BetaWebSearchPreviewTool) =
+            addTool(BetaTool.ofWebSearchPreview(webSearchPreview))
+
+        /** Alias for calling [addTool] with `BetaTool.ofApplyPatch(applyPatch)`. */
+        fun addTool(applyPatch: BetaApplyPatchTool) = addTool(BetaTool.ofApplyPatch(applyPatch))
+
+        /**
+         * An alternative to sampling with temperature, called nucleus sampling, where the model
+         * considers the results of the tokens with top_p probability mass. So 0.1 means only the
+         * tokens comprising the top 10% probability mass are considered.
+         *
+         * We generally recommend altering this or `temperature` but not both.
+         */
+        fun topP(topP: Double?) = topP(JsonField.ofNullable(topP))
+
+        /**
+         * Alias for [Builder.topP].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun topP(topP: Double) = topP(topP as Double?)
+
+        /** Alias for calling [Builder.topP] with `topP.orElse(null)`. */
+        fun topP(topP: Optional<Double>) = topP(topP.getOrNull())
+
+        /**
+         * Sets [Builder.topP] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.topP] with a well-typed [Double] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun topP(topP: JsonField<Double>) = apply { this.topP = topP }
+
+        /**
+         * Whether to run the model response in the background.
+         * [Learn more](https://platform.openai.com/docs/guides/background).
+         */
+        fun background(background: Boolean?) = background(JsonField.ofNullable(background))
+
+        /**
+         * Alias for [Builder.background].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun background(background: Boolean) = background(background as Boolean?)
+
+        /** Alias for calling [Builder.background] with `background.orElse(null)`. */
+        fun background(background: Optional<Boolean>) = background(background.getOrNull())
+
+        /**
+         * Sets [Builder.background] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.background] with a well-typed [Boolean] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun background(background: JsonField<Boolean>) = apply { this.background = background }
+
+        /**
+         * Unix timestamp (in seconds) of when this Response was completed. Only present when the
+         * status is `completed`.
+         */
+        fun completedAt(completedAt: Double?) = completedAt(JsonField.ofNullable(completedAt))
+
+        /**
+         * Alias for [Builder.completedAt].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun completedAt(completedAt: Double) = completedAt(completedAt as Double?)
+
+        /** Alias for calling [Builder.completedAt] with `completedAt.orElse(null)`. */
+        fun completedAt(completedAt: Optional<Double>) = completedAt(completedAt.getOrNull())
+
+        /**
+         * Sets [Builder.completedAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.completedAt] with a well-typed [Double] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun completedAt(completedAt: JsonField<Double>) = apply { this.completedAt = completedAt }
+
+        /**
+         * The conversation that this response belonged to. Input items and output items from this
+         * response were automatically added to this conversation.
+         */
+        fun conversation(conversation: Conversation?) =
+            conversation(JsonField.ofNullable(conversation))
+
+        /** Alias for calling [Builder.conversation] with `conversation.orElse(null)`. */
+        fun conversation(conversation: Optional<Conversation>) =
+            conversation(conversation.getOrNull())
+
+        /**
+         * Sets [Builder.conversation] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.conversation] with a well-typed [Conversation] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun conversation(conversation: JsonField<Conversation>) = apply {
+            this.conversation = conversation
+        }
+
+        /**
+         * An upper bound for the number of tokens that can be generated for a response, including
+         * visible output tokens and
+         * [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
+         */
+        fun maxOutputTokens(maxOutputTokens: Long?) =
+            maxOutputTokens(JsonField.ofNullable(maxOutputTokens))
+
+        /**
+         * Alias for [Builder.maxOutputTokens].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun maxOutputTokens(maxOutputTokens: Long) = maxOutputTokens(maxOutputTokens as Long?)
+
+        /** Alias for calling [Builder.maxOutputTokens] with `maxOutputTokens.orElse(null)`. */
+        fun maxOutputTokens(maxOutputTokens: Optional<Long>) =
+            maxOutputTokens(maxOutputTokens.getOrNull())
+
+        /**
+         * Sets [Builder.maxOutputTokens] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.maxOutputTokens] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun maxOutputTokens(maxOutputTokens: JsonField<Long>) = apply {
+            this.maxOutputTokens = maxOutputTokens
+        }
+
+        /**
+         * The maximum number of total calls to built-in tools that can be processed in a response.
+         * This maximum number applies across all built-in tool calls, not per individual tool. Any
+         * further attempts to call a tool by the model will be ignored.
+         */
+        fun maxToolCalls(maxToolCalls: Long?) = maxToolCalls(JsonField.ofNullable(maxToolCalls))
+
+        /**
+         * Alias for [Builder.maxToolCalls].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun maxToolCalls(maxToolCalls: Long) = maxToolCalls(maxToolCalls as Long?)
+
+        /** Alias for calling [Builder.maxToolCalls] with `maxToolCalls.orElse(null)`. */
+        fun maxToolCalls(maxToolCalls: Optional<Long>) = maxToolCalls(maxToolCalls.getOrNull())
+
+        /**
+         * Sets [Builder.maxToolCalls] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.maxToolCalls] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun maxToolCalls(maxToolCalls: JsonField<Long>) = apply { this.maxToolCalls = maxToolCalls }
+
+        /**
+         * Moderation results for the response input and output, if moderated completions were
+         * requested.
+         */
+        fun moderation(moderation: Moderation?) = moderation(JsonField.ofNullable(moderation))
+
+        /** Alias for calling [Builder.moderation] with `moderation.orElse(null)`. */
+        fun moderation(moderation: Optional<Moderation>) = moderation(moderation.getOrNull())
+
+        /**
+         * Sets [Builder.moderation] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.moderation] with a well-typed [Moderation] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun moderation(moderation: JsonField<Moderation>) = apply { this.moderation = moderation }
+
+        /**
+         * The unique ID of the previous response to the model. Use this to create multi-turn
+         * conversations. Learn more about
+         * [conversation state](https://platform.openai.com/docs/guides/conversation-state). Cannot
+         * be used in conjunction with `conversation`.
+         */
+        fun previousResponseId(previousResponseId: String?) =
+            previousResponseId(JsonField.ofNullable(previousResponseId))
+
+        /**
+         * Alias for calling [Builder.previousResponseId] with `previousResponseId.orElse(null)`.
+         */
+        fun previousResponseId(previousResponseId: Optional<String>) =
+            previousResponseId(previousResponseId.getOrNull())
+
+        /**
+         * Sets [Builder.previousResponseId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.previousResponseId] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun previousResponseId(previousResponseId: JsonField<String>) = apply {
+            this.previousResponseId = previousResponseId
+        }
+
+        /**
+         * Reference to a prompt template and its variables.
+         * [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+         */
+        fun prompt(prompt: BetaResponsePrompt?) = prompt(JsonField.ofNullable(prompt))
+
+        /** Alias for calling [Builder.prompt] with `prompt.orElse(null)`. */
+        fun prompt(prompt: Optional<BetaResponsePrompt>) = prompt(prompt.getOrNull())
+
+        /**
+         * Sets [Builder.prompt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.prompt] with a well-typed [BetaResponsePrompt] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun prompt(prompt: JsonField<BetaResponsePrompt>) = apply { this.prompt = prompt }
+
+        /**
+         * Used by OpenAI to cache responses for similar requests to optimize your cache hit rates.
+         * Replaces the `user` field.
+         * [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+         */
+        fun promptCacheKey(promptCacheKey: String) = promptCacheKey(JsonField.of(promptCacheKey))
+
+        /**
+         * Sets [Builder.promptCacheKey] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheKey] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun promptCacheKey(promptCacheKey: JsonField<String>) = apply {
+            this.promptCacheKey = promptCacheKey
+        }
+
+        /**
+         * The prompt-caching options that were applied to the response. Supported for `gpt-5.6` and
+         * later models.
+         */
+        fun promptCacheOptions(promptCacheOptions: PromptCacheOptions) =
+            promptCacheOptions(JsonField.of(promptCacheOptions))
+
+        /**
+         * Sets [Builder.promptCacheOptions] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheOptions] with a well-typed
+         * [PromptCacheOptions] value instead. This method is primarily for setting the field to an
+         * undocumented or not yet supported value.
+         */
+        fun promptCacheOptions(promptCacheOptions: JsonField<PromptCacheOptions>) = apply {
+            this.promptCacheOptions = promptCacheOptions
+        }
+
+        /**
+         * Deprecated. Use `prompt_cache_options.ttl` instead.
+         *
+         * The retention policy for the prompt cache. Set to `24h` to enable extended prompt
+         * caching, which keeps cached prefixes active for longer, up to a maximum of 24 hours.
+         * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+         * This field expresses a maximum retention policy, while `prompt_cache_options.ttl`
+         * expresses a minimum cache lifetime. The two fields are independent and do not interact.
+         * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+         *
+         * For older models that support both `in_memory` and `24h`, the default depends on your
+         * organization's data retention policy:
+         * - Organizations without ZDR enabled default to `24h`.
+         * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is
+         *   not specified.
+         */
+        @Deprecated("deprecated")
+        fun promptCacheRetention(promptCacheRetention: PromptCacheRetention?) =
+            promptCacheRetention(JsonField.ofNullable(promptCacheRetention))
+
+        /**
+         * Alias for calling [Builder.promptCacheRetention] with
+         * `promptCacheRetention.orElse(null)`.
+         */
+        @Deprecated("deprecated")
+        fun promptCacheRetention(promptCacheRetention: Optional<PromptCacheRetention>) =
+            promptCacheRetention(promptCacheRetention.getOrNull())
+
+        /**
+         * Sets [Builder.promptCacheRetention] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheRetention] with a well-typed
+         * [PromptCacheRetention] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        @Deprecated("deprecated")
+        fun promptCacheRetention(promptCacheRetention: JsonField<PromptCacheRetention>) = apply {
+            this.promptCacheRetention = promptCacheRetention
+        }
+
+        /**
+         * **gpt-5 and o-series models only**
+         *
+         * Configuration options for
+         * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+         */
+        fun reasoning(reasoning: Reasoning?) = reasoning(JsonField.ofNullable(reasoning))
+
+        /** Alias for calling [Builder.reasoning] with `reasoning.orElse(null)`. */
+        fun reasoning(reasoning: Optional<Reasoning>) = reasoning(reasoning.getOrNull())
+
+        /**
+         * Sets [Builder.reasoning] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.reasoning] with a well-typed [Reasoning] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun reasoning(reasoning: JsonField<Reasoning>) = apply { this.reasoning = reasoning }
+
+        /**
+         * A stable identifier used to help detect users of your application that may be violating
+         * OpenAI's usage policies. The IDs should be a string that uniquely identifies each user,
+         * with a maximum length of 64 characters. We recommend hashing their username or email
+         * address, in order to avoid sending us any identifying information.
+         * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+         */
+        fun safetyIdentifier(safetyIdentifier: String) =
+            safetyIdentifier(JsonField.of(safetyIdentifier))
+
+        /**
+         * Sets [Builder.safetyIdentifier] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.safetyIdentifier] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun safetyIdentifier(safetyIdentifier: JsonField<String>) = apply {
+            this.safetyIdentifier = safetyIdentifier
+        }
+
+        /**
+         * Specifies the processing type used for serving the request.
+         * - If set to 'auto', then the request will be processed with the service tier configured
+         *   in the Project settings. Unless otherwise configured, the Project will use 'default'.
+         * - If set to 'default', then the request will be processed with the standard pricing and
+         *   performance for the selected model.
+         * - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
+         *   '[priority](https://openai.com/api-priority-processing/)', then the request will be
+         *   processed with the corresponding service tier.
+         * - When not set, the default behavior is 'auto'.
+         *
+         *   When the `service_tier` parameter is set, the response body will include the
+         *   `service_tier` value based on the processing mode actually used to serve the request.
+         *   This response value may be different from the value set in the parameter.
+         */
+        fun serviceTier(serviceTier: ServiceTier?) = serviceTier(JsonField.ofNullable(serviceTier))
+
+        /** Alias for calling [Builder.serviceTier] with `serviceTier.orElse(null)`. */
+        fun serviceTier(serviceTier: Optional<ServiceTier>) = serviceTier(serviceTier.getOrNull())
+
+        /**
+         * Sets [Builder.serviceTier] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.serviceTier] with a well-typed [ServiceTier] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun serviceTier(serviceTier: JsonField<ServiceTier>) = apply {
+            this.serviceTier = serviceTier
+        }
+
+        /**
+         * The status of the response generation. One of `completed`, `failed`, `in_progress`,
+         * `cancelled`, `queued`, or `incomplete`.
+         */
+        fun status(status: BetaResponseStatus) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [BetaResponseStatus] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun status(status: JsonField<BetaResponseStatus>) = apply { this.status = status }
+
+        /**
+         * Configuration options for a text response from the model. Can be plain text or structured
+         * JSON data. Learn more:
+         * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+         * - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+         */
+        fun text(text: BetaResponseTextConfig) = text(JsonField.of(text))
+
+        /**
+         * Sets [Builder.text] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.text] with a well-typed [BetaResponseTextConfig] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun text(text: JsonField<BetaResponseTextConfig>) = apply { this.text = text }
+
+        /**
+         * An integer between 0 and 20 specifying the maximum number of most likely tokens to return
+         * at each token position, each with an associated log probability. In some cases, the
+         * number of returned tokens may be fewer than requested.
+         */
+        fun topLogprobs(topLogprobs: Long?) = topLogprobs(JsonField.ofNullable(topLogprobs))
+
+        /**
+         * Alias for [Builder.topLogprobs].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun topLogprobs(topLogprobs: Long) = topLogprobs(topLogprobs as Long?)
+
+        /** Alias for calling [Builder.topLogprobs] with `topLogprobs.orElse(null)`. */
+        fun topLogprobs(topLogprobs: Optional<Long>) = topLogprobs(topLogprobs.getOrNull())
+
+        /**
+         * Sets [Builder.topLogprobs] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.topLogprobs] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun topLogprobs(topLogprobs: JsonField<Long>) = apply { this.topLogprobs = topLogprobs }
+
+        /**
+         * The truncation strategy to use for the model response.
+         * - `auto`: If the input to this Response exceeds the model's context window size, the
+         *   model will truncate the response to fit the context window by dropping items from the
+         *   beginning of the conversation.
+         * - `disabled` (default): If the input size will exceed the context window size for a
+         *   model, the request will fail with a 400 error.
+         */
+        fun truncation(truncation: Truncation?) = truncation(JsonField.ofNullable(truncation))
+
+        /** Alias for calling [Builder.truncation] with `truncation.orElse(null)`. */
+        fun truncation(truncation: Optional<Truncation>) = truncation(truncation.getOrNull())
+
+        /**
+         * Sets [Builder.truncation] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.truncation] with a well-typed [Truncation] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun truncation(truncation: JsonField<Truncation>) = apply { this.truncation = truncation }
+
+        /**
+         * Represents token usage details including input tokens, output tokens, a breakdown of
+         * output tokens, and the total tokens used.
+         */
+        fun usage(usage: BetaResponseUsage) = usage(JsonField.of(usage))
+
+        /**
+         * Sets [Builder.usage] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.usage] with a well-typed [BetaResponseUsage] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun usage(usage: JsonField<BetaResponseUsage>) = apply { this.usage = usage }
+
+        /**
+         * This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+         * `prompt_cache_key` instead to maintain caching optimizations. 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#safety-identifiers).
+         */
+        @Deprecated("deprecated") fun user(user: String) = user(JsonField.of(user))
+
+        /**
+         * Sets [Builder.user] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.user] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        @Deprecated("deprecated") fun user(user: JsonField<String>) = apply { this.user = user }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .createdAt()
+         * .error()
+         * .incompleteDetails()
+         * .instructions()
+         * .metadata()
+         * .model()
+         * .output()
+         * .parallelToolCalls()
+         * .temperature()
+         * .toolChoice()
+         * .tools()
+         * .topP()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponse =
+            BetaResponse(
+                checkRequired("id", id),
+                checkRequired("createdAt", createdAt),
+                checkRequired("error", error),
+                checkRequired("incompleteDetails", incompleteDetails),
+                checkRequired("instructions", instructions),
+                checkRequired("metadata", metadata),
+                checkRequired("model", model),
+                object_,
+                checkRequired("output", output).map { it.toImmutable() },
+                checkRequired("parallelToolCalls", parallelToolCalls),
+                checkRequired("temperature", temperature),
+                checkRequired("toolChoice", toolChoice),
+                checkRequired("tools", tools).map { it.toImmutable() },
+                checkRequired("topP", topP),
+                background,
+                completedAt,
+                conversation,
+                maxOutputTokens,
+                maxToolCalls,
+                moderation,
+                previousResponseId,
+                prompt,
+                promptCacheKey,
+                promptCacheOptions,
+                promptCacheRetention,
+                reasoning,
+                safetyIdentifier,
+                serviceTier,
+                status,
+                text,
+                topLogprobs,
+                truncation,
+                usage,
+                user,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        createdAt()
+        error().ifPresent { it.validate() }
+        incompleteDetails().ifPresent { it.validate() }
+        instructions().ifPresent { it.validate() }
+        metadata().ifPresent { it.validate() }
+        model()
+        _object_().let {
+            if (it != JsonValue.from("response")) {
+                throw OpenAIInvalidDataException("'object_' is invalid, received $it")
+            }
+        }
+        output().forEach { it.validate() }
+        parallelToolCalls()
+        temperature()
+        toolChoice().validate()
+        tools().forEach { it.validate() }
+        topP()
+        background()
+        completedAt()
+        conversation().ifPresent { it.validate() }
+        maxOutputTokens()
+        maxToolCalls()
+        moderation().ifPresent { it.validate() }
+        previousResponseId()
+        prompt().ifPresent { it.validate() }
+        promptCacheKey()
+        promptCacheOptions().ifPresent { it.validate() }
+        promptCacheRetention().ifPresent { it.validate() }
+        reasoning().ifPresent { it.validate() }
+        safetyIdentifier()
+        serviceTier().ifPresent { it.validate() }
+        status().ifPresent { it.validate() }
+        text().ifPresent { it.validate() }
+        topLogprobs()
+        truncation().ifPresent { it.validate() }
+        usage().ifPresent { it.validate() }
+        user()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (if (createdAt.asKnown().isPresent) 1 else 0) +
+            (error.asKnown().getOrNull()?.validity() ?: 0) +
+            (incompleteDetails.asKnown().getOrNull()?.validity() ?: 0) +
+            (instructions.asKnown().getOrNull()?.validity() ?: 0) +
+            (metadata.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (model.asKnown().isPresent) 1 else 0) +
+            object_.let { if (it == JsonValue.from("response")) 1 else 0 } +
+            (output.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (if (parallelToolCalls.asKnown().isPresent) 1 else 0) +
+            (if (temperature.asKnown().isPresent) 1 else 0) +
+            (toolChoice.asKnown().getOrNull()?.validity() ?: 0) +
+            (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (if (topP.asKnown().isPresent) 1 else 0) +
+            (if (background.asKnown().isPresent) 1 else 0) +
+            (if (completedAt.asKnown().isPresent) 1 else 0) +
+            (conversation.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (maxOutputTokens.asKnown().isPresent) 1 else 0) +
+            (if (maxToolCalls.asKnown().isPresent) 1 else 0) +
+            (moderation.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (previousResponseId.asKnown().isPresent) 1 else 0) +
+            (prompt.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (promptCacheKey.asKnown().isPresent) 1 else 0) +
+            (promptCacheOptions.asKnown().getOrNull()?.validity() ?: 0) +
+            (promptCacheRetention.asKnown().getOrNull()?.validity() ?: 0) +
+            (reasoning.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (safetyIdentifier.asKnown().isPresent) 1 else 0) +
+            (serviceTier.asKnown().getOrNull()?.validity() ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            (text.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (topLogprobs.asKnown().isPresent) 1 else 0) +
+            (truncation.asKnown().getOrNull()?.validity() ?: 0) +
+            (usage.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (user.asKnown().isPresent) 1 else 0)
+
+    /** Details about why the response is incomplete. */
+    class IncompleteDetails
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val reason: JsonField<Reason>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("reason") @ExcludeMissing reason: JsonField<Reason> = JsonMissing.of()
+        ) : this(reason, mutableMapOf())
+
+        /**
+         * The reason why the response is incomplete.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun reason(): Optional<Reason> = reason.getOptional("reason")
+
+        /**
+         * Returns the raw JSON value of [reason].
+         *
+         * Unlike [reason], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("reason") @ExcludeMissing fun _reason(): JsonField<Reason> = reason
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [IncompleteDetails]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [IncompleteDetails]. */
+        class Builder internal constructor() {
+
+            private var reason: JsonField<Reason> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(incompleteDetails: IncompleteDetails) = apply {
+                reason = incompleteDetails.reason
+                additionalProperties = incompleteDetails.additionalProperties.toMutableMap()
+            }
+
+            /** The reason why the response is incomplete. */
+            fun reason(reason: Reason) = reason(JsonField.of(reason))
+
+            /**
+             * Sets [Builder.reason] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.reason] with a well-typed [Reason] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun reason(reason: JsonField<Reason>) = apply { this.reason = reason }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [IncompleteDetails].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): IncompleteDetails =
+                IncompleteDetails(reason, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): IncompleteDetails = apply {
+            if (validated) {
+                return@apply
+            }
+
+            reason().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (reason.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The reason why the response is incomplete. */
+        class Reason @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val MAX_OUTPUT_TOKENS = of("max_output_tokens")
+
+                @JvmField val CONTENT_FILTER = of("content_filter")
+
+                @JvmStatic fun of(value: String) = Reason(JsonField.of(value))
+            }
+
+            /** An enum containing [Reason]'s known values. */
+            enum class Known {
+                MAX_OUTPUT_TOKENS,
+                CONTENT_FILTER,
+            }
+
+            /**
+             * An enum containing [Reason]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Reason] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                MAX_OUTPUT_TOKENS,
+                CONTENT_FILTER,
+                /**
+                 * An enum member indicating that [Reason] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    MAX_OUTPUT_TOKENS -> Value.MAX_OUTPUT_TOKENS
+                    CONTENT_FILTER -> Value.CONTENT_FILTER
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    MAX_OUTPUT_TOKENS -> Known.MAX_OUTPUT_TOKENS
+                    CONTENT_FILTER -> Known.CONTENT_FILTER
+                    else -> throw OpenAIInvalidDataException("Unknown Reason: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Reason = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Reason && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is IncompleteDetails &&
+                reason == other.reason &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(reason, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "IncompleteDetails{reason=$reason, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * A system (or developer) message inserted into the model's context.
+     *
+     * When using along with `previous_response_id`, the instructions from a previous response will
+     * not be carried over to the next response. This makes it simple to swap out system (or
+     * developer) messages in new responses.
+     */
+    @JsonDeserialize(using = Instructions.Deserializer::class)
+    @JsonSerialize(using = Instructions.Serializer::class)
+    class Instructions
+    private constructor(
+        private val string: String? = null,
+        private val inputItemList: List<BetaResponseInputItem>? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** A text input to the model, equivalent to a text input with the `developer` role. */
+        fun string(): Optional<String> = Optional.ofNullable(string)
+
+        /** A list of one or many input items to the model, containing different content types. */
+        fun inputItemList(): Optional<List<BetaResponseInputItem>> =
+            Optional.ofNullable(inputItemList)
+
+        fun isString(): Boolean = string != null
+
+        fun isInputItemList(): Boolean = inputItemList != null
+
+        /** A text input to the model, equivalent to a text input with the `developer` role. */
+        fun asString(): String = string.getOrThrow("string")
+
+        /** A list of one or many input items to the model, containing different content types. */
+        fun asInputItemList(): List<BetaResponseInputItem> =
+            inputItemList.getOrThrow("inputItemList")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = instructions.accept(new Instructions.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitString(String string) {
+         *         return Optional.of(string.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                string != null -> visitor.visitString(string)
+                inputItemList != null -> visitor.visitInputItemList(inputItemList)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Instructions = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitString(string: String) {}
+
+                    override fun visitInputItemList(inputItemList: List<BetaResponseInputItem>) {
+                        inputItemList.forEach { it.validate() }
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitString(string: String) = 1
+
+                    override fun visitInputItemList(inputItemList: List<BetaResponseInputItem>) =
+                        inputItemList.sumOf { it.validity().toInt() }
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Instructions &&
+                string == other.string &&
+                inputItemList == other.inputItemList
+        }
+
+        override fun hashCode(): Int = Objects.hash(string, inputItemList)
+
+        override fun toString(): String =
+            when {
+                string != null -> "Instructions{string=$string}"
+                inputItemList != null -> "Instructions{inputItemList=$inputItemList}"
+                _json != null -> "Instructions{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Instructions")
+            }
+
+        companion object {
+
+            /** A text input to the model, equivalent to a text input with the `developer` role. */
+            @JvmStatic fun ofString(string: String) = Instructions(string = string)
+
+            /**
+             * A list of one or many input items to the model, containing different content types.
+             */
+            @JvmStatic
+            fun ofInputItemList(inputItemList: List<BetaResponseInputItem>) =
+                Instructions(inputItemList = inputItemList.toImmutable())
+        }
+
+        /**
+         * An interface that defines how to map each variant of [Instructions] to a value of type
+         * [T].
+         */
+        interface Visitor<out T> {
+
+            /** A text input to the model, equivalent to a text input with the `developer` role. */
+            fun visitString(string: String): T
+
+            /**
+             * A list of one or many input items to the model, containing different content types.
+             */
+            fun visitInputItemList(inputItemList: List<BetaResponseInputItem>): T
+
+            /**
+             * Maps an unknown variant of [Instructions] to a value of type [T].
+             *
+             * An instance of [Instructions] can contain an unknown variant if it was deserialized
+             * from data that doesn't match any known variant. For example, if the SDK is on an
+             * older version than the API, then the API may respond with new variants that the SDK
+             * is unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Instructions: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Instructions>(Instructions::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Instructions {
+                val json = JsonValue.fromJsonNode(node)
+
+                val bestMatches =
+                    sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                Instructions(string = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<List<BetaResponseInputItem>>())
+                                ?.let { Instructions(inputItemList = it, _json = json) },
+                        )
+                        .filterNotNull()
+                        .allMaxBy { it.validity() }
+                        .toList()
+                return when (bestMatches.size) {
+                    // This can happen if what we're deserializing is completely incompatible with
+                    // all the possible variants (e.g. deserializing from boolean).
+                    0 -> Instructions(_json = json)
+                    1 -> bestMatches.single()
+                    // If there's more than one match with the highest validity, then use the first
+                    // completely valid match, or simply the first match if none are completely
+                    // valid.
+                    else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                }
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Instructions>(Instructions::class) {
+
+            override fun serialize(
+                value: Instructions,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.string != null -> generator.writeObject(value.string)
+                    value.inputItemList != null -> generator.writeObject(value.inputItemList)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Instructions")
+                }
+            }
+        }
+    }
+
+    /**
+     * Set of 16 key-value pairs that can be attached to an object. This can be useful for storing
+     * additional information about the object in a structured format, and querying for objects via
+     * API or the dashboard.
+     *
+     * Keys are strings with a maximum length of 64 characters. Values are strings with a maximum
+     * length of 512 characters.
+     */
+    class Metadata
+    @JsonCreator
+    private constructor(
+        @com.fasterxml.jackson.annotation.JsonValue
+        private val additionalProperties: Map<String, JsonValue>
+    ) {
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Metadata]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Metadata]. */
+        class Builder internal constructor() {
+
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(metadata: Metadata) = apply {
+                additionalProperties = metadata.additionalProperties.toMutableMap()
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Metadata].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Metadata = Metadata(additionalProperties.toImmutable())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Metadata = apply {
+            if (validated) {
+                return@apply
+            }
+
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            additionalProperties.count { (_, value) -> !value.isNull() && !value.isMissing() }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Metadata && additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() = "Metadata{additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide range of
+     * models with different capabilities, performance characteristics, and price points. Refer to
+     * the [model guide](https://platform.openai.com/docs/models) to browse and compare available
+     * models.
+     */
+    class Model @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val GPT_5_6_SOL = of("gpt-5.6-sol")
+
+            @JvmField val GPT_5_6_TERRA = of("gpt-5.6-terra")
+
+            @JvmField val GPT_5_6_LUNA = of("gpt-5.6-luna")
+
+            @JvmField val GPT_5_4 = of("gpt-5.4")
+
+            @JvmField val GPT_5_4_MINI = of("gpt-5.4-mini")
+
+            @JvmField val GPT_5_4_NANO = of("gpt-5.4-nano")
+
+            @JvmField val GPT_5_4_MINI_2026_03_17 = of("gpt-5.4-mini-2026-03-17")
+
+            @JvmField val GPT_5_4_NANO_2026_03_17 = of("gpt-5.4-nano-2026-03-17")
+
+            @JvmField val GPT_5_3_CHAT_LATEST = of("gpt-5.3-chat-latest")
+
+            @JvmField val GPT_5_2 = of("gpt-5.2")
+
+            @JvmField val GPT_5_2_2025_12_11 = of("gpt-5.2-2025-12-11")
+
+            @JvmField val GPT_5_2_CHAT_LATEST = of("gpt-5.2-chat-latest")
+
+            @JvmField val GPT_5_2_PRO = of("gpt-5.2-pro")
+
+            @JvmField val GPT_5_2_PRO_2025_12_11 = of("gpt-5.2-pro-2025-12-11")
+
+            @JvmField val GPT_5_1 = of("gpt-5.1")
+
+            @JvmField val GPT_5_1_2025_11_13 = of("gpt-5.1-2025-11-13")
+
+            @JvmField val GPT_5_1_CODEX = of("gpt-5.1-codex")
+
+            @JvmField val GPT_5_1_MINI = of("gpt-5.1-mini")
+
+            @JvmField val GPT_5_1_CHAT_LATEST = of("gpt-5.1-chat-latest")
+
+            @JvmField val GPT_5 = of("gpt-5")
+
+            @JvmField val GPT_5_MINI = of("gpt-5-mini")
+
+            @JvmField val GPT_5_NANO = of("gpt-5-nano")
+
+            @JvmField val GPT_5_2025_08_07 = of("gpt-5-2025-08-07")
+
+            @JvmField val GPT_5_MINI_2025_08_07 = of("gpt-5-mini-2025-08-07")
+
+            @JvmField val GPT_5_NANO_2025_08_07 = of("gpt-5-nano-2025-08-07")
+
+            @JvmField val GPT_5_CHAT_LATEST = of("gpt-5-chat-latest")
+
+            @JvmField val GPT_4_1 = of("gpt-4.1")
+
+            @JvmField val GPT_4_1_MINI = of("gpt-4.1-mini")
+
+            @JvmField val GPT_4_1_NANO = of("gpt-4.1-nano")
+
+            @JvmField val GPT_4_1_2025_04_14 = of("gpt-4.1-2025-04-14")
+
+            @JvmField val GPT_4_1_MINI_2025_04_14 = of("gpt-4.1-mini-2025-04-14")
+
+            @JvmField val GPT_4_1_NANO_2025_04_14 = of("gpt-4.1-nano-2025-04-14")
+
+            @JvmField val O4_MINI = of("o4-mini")
+
+            @JvmField val O4_MINI_2025_04_16 = of("o4-mini-2025-04-16")
+
+            @JvmField val O3 = of("o3")
+
+            @JvmField val O3_2025_04_16 = of("o3-2025-04-16")
+
+            @JvmField val O3_MINI = of("o3-mini")
+
+            @JvmField val O3_MINI_2025_01_31 = of("o3-mini-2025-01-31")
+
+            @JvmField val O1 = of("o1")
+
+            @JvmField val O1_2024_12_17 = of("o1-2024-12-17")
+
+            @JvmField val O1_PREVIEW = of("o1-preview")
+
+            @JvmField val O1_PREVIEW_2024_09_12 = of("o1-preview-2024-09-12")
+
+            @JvmField val O1_MINI = of("o1-mini")
+
+            @JvmField val O1_MINI_2024_09_12 = of("o1-mini-2024-09-12")
+
+            @JvmField val GPT_4O = of("gpt-4o")
+
+            @JvmField val GPT_4O_2024_11_20 = of("gpt-4o-2024-11-20")
+
+            @JvmField val GPT_4O_2024_08_06 = of("gpt-4o-2024-08-06")
+
+            @JvmField val GPT_4O_2024_05_13 = of("gpt-4o-2024-05-13")
+
+            @JvmField val GPT_4O_AUDIO_PREVIEW = of("gpt-4o-audio-preview")
+
+            @JvmField val GPT_4O_AUDIO_PREVIEW_2024_10_01 = of("gpt-4o-audio-preview-2024-10-01")
+
+            @JvmField val GPT_4O_AUDIO_PREVIEW_2024_12_17 = of("gpt-4o-audio-preview-2024-12-17")
+
+            @JvmField val GPT_4O_AUDIO_PREVIEW_2025_06_03 = of("gpt-4o-audio-preview-2025-06-03")
+
+            @JvmField val GPT_4O_MINI_AUDIO_PREVIEW = of("gpt-4o-mini-audio-preview")
+
+            @JvmField
+            val GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17 = of("gpt-4o-mini-audio-preview-2024-12-17")
+
+            @JvmField val GPT_4O_SEARCH_PREVIEW = of("gpt-4o-search-preview")
+
+            @JvmField val GPT_4O_MINI_SEARCH_PREVIEW = of("gpt-4o-mini-search-preview")
+
+            @JvmField val GPT_4O_SEARCH_PREVIEW_2025_03_11 = of("gpt-4o-search-preview-2025-03-11")
+
+            @JvmField
+            val GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11 = of("gpt-4o-mini-search-preview-2025-03-11")
+
+            @JvmField val CHATGPT_4O_LATEST = of("chatgpt-4o-latest")
+
+            @JvmField val CODEX_MINI_LATEST = of("codex-mini-latest")
+
+            @JvmField val GPT_4O_MINI = of("gpt-4o-mini")
+
+            @JvmField val GPT_4O_MINI_2024_07_18 = of("gpt-4o-mini-2024-07-18")
+
+            @JvmField val GPT_4_TURBO = of("gpt-4-turbo")
+
+            @JvmField val GPT_4_TURBO_2024_04_09 = of("gpt-4-turbo-2024-04-09")
+
+            @JvmField val GPT_4_0125_PREVIEW = of("gpt-4-0125-preview")
+
+            @JvmField val GPT_4_TURBO_PREVIEW = of("gpt-4-turbo-preview")
+
+            @JvmField val GPT_4_1106_PREVIEW = of("gpt-4-1106-preview")
+
+            @JvmField val GPT_4_VISION_PREVIEW = of("gpt-4-vision-preview")
+
+            @JvmField val GPT_4 = of("gpt-4")
+
+            @JvmField val GPT_4_0314 = of("gpt-4-0314")
+
+            @JvmField val GPT_4_0613 = of("gpt-4-0613")
+
+            @JvmField val GPT_4_32K = of("gpt-4-32k")
+
+            @JvmField val GPT_4_32K_0314 = of("gpt-4-32k-0314")
+
+            @JvmField val GPT_4_32K_0613 = of("gpt-4-32k-0613")
+
+            @JvmField val GPT_3_5_TURBO = of("gpt-3.5-turbo")
+
+            @JvmField val GPT_3_5_TURBO_16K = of("gpt-3.5-turbo-16k")
+
+            @JvmField val GPT_3_5_TURBO_0301 = of("gpt-3.5-turbo-0301")
+
+            @JvmField val GPT_3_5_TURBO_0613 = of("gpt-3.5-turbo-0613")
+
+            @JvmField val GPT_3_5_TURBO_1106 = of("gpt-3.5-turbo-1106")
+
+            @JvmField val GPT_3_5_TURBO_0125 = of("gpt-3.5-turbo-0125")
+
+            @JvmField val GPT_3_5_TURBO_16K_0613 = of("gpt-3.5-turbo-16k-0613")
+
+            @JvmField val O1_PRO = of("o1-pro")
+
+            @JvmField val O1_PRO_2025_03_19 = of("o1-pro-2025-03-19")
+
+            @JvmField val O3_PRO = of("o3-pro")
+
+            @JvmField val O3_PRO_2025_06_10 = of("o3-pro-2025-06-10")
+
+            @JvmField val O3_DEEP_RESEARCH = of("o3-deep-research")
+
+            @JvmField val O3_DEEP_RESEARCH_2025_06_26 = of("o3-deep-research-2025-06-26")
+
+            @JvmField val O4_MINI_DEEP_RESEARCH = of("o4-mini-deep-research")
+
+            @JvmField val O4_MINI_DEEP_RESEARCH_2025_06_26 = of("o4-mini-deep-research-2025-06-26")
+
+            @JvmField val COMPUTER_USE_PREVIEW = of("computer-use-preview")
+
+            @JvmField val COMPUTER_USE_PREVIEW_2025_03_11 = of("computer-use-preview-2025-03-11")
+
+            @JvmField val GPT_5_CODEX = of("gpt-5-codex")
+
+            @JvmField val GPT_5_PRO = of("gpt-5-pro")
+
+            @JvmField val GPT_5_PRO_2025_10_06 = of("gpt-5-pro-2025-10-06")
+
+            @JvmField val GPT_5_1_CODEX_MAX = of("gpt-5.1-codex-max")
+
+            @JvmStatic fun of(value: String) = Model(JsonField.of(value))
+        }
+
+        /** An enum containing [Model]'s known values. */
+        enum class Known {
+            GPT_5_6_SOL,
+            GPT_5_6_TERRA,
+            GPT_5_6_LUNA,
+            GPT_5_4,
+            GPT_5_4_MINI,
+            GPT_5_4_NANO,
+            GPT_5_4_MINI_2026_03_17,
+            GPT_5_4_NANO_2026_03_17,
+            GPT_5_3_CHAT_LATEST,
+            GPT_5_2,
+            GPT_5_2_2025_12_11,
+            GPT_5_2_CHAT_LATEST,
+            GPT_5_2_PRO,
+            GPT_5_2_PRO_2025_12_11,
+            GPT_5_1,
+            GPT_5_1_2025_11_13,
+            GPT_5_1_CODEX,
+            GPT_5_1_MINI,
+            GPT_5_1_CHAT_LATEST,
+            GPT_5,
+            GPT_5_MINI,
+            GPT_5_NANO,
+            GPT_5_2025_08_07,
+            GPT_5_MINI_2025_08_07,
+            GPT_5_NANO_2025_08_07,
+            GPT_5_CHAT_LATEST,
+            GPT_4_1,
+            GPT_4_1_MINI,
+            GPT_4_1_NANO,
+            GPT_4_1_2025_04_14,
+            GPT_4_1_MINI_2025_04_14,
+            GPT_4_1_NANO_2025_04_14,
+            O4_MINI,
+            O4_MINI_2025_04_16,
+            O3,
+            O3_2025_04_16,
+            O3_MINI,
+            O3_MINI_2025_01_31,
+            O1,
+            O1_2024_12_17,
+            O1_PREVIEW,
+            O1_PREVIEW_2024_09_12,
+            O1_MINI,
+            O1_MINI_2024_09_12,
+            GPT_4O,
+            GPT_4O_2024_11_20,
+            GPT_4O_2024_08_06,
+            GPT_4O_2024_05_13,
+            GPT_4O_AUDIO_PREVIEW,
+            GPT_4O_AUDIO_PREVIEW_2024_10_01,
+            GPT_4O_AUDIO_PREVIEW_2024_12_17,
+            GPT_4O_AUDIO_PREVIEW_2025_06_03,
+            GPT_4O_MINI_AUDIO_PREVIEW,
+            GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17,
+            GPT_4O_SEARCH_PREVIEW,
+            GPT_4O_MINI_SEARCH_PREVIEW,
+            GPT_4O_SEARCH_PREVIEW_2025_03_11,
+            GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11,
+            CHATGPT_4O_LATEST,
+            CODEX_MINI_LATEST,
+            GPT_4O_MINI,
+            GPT_4O_MINI_2024_07_18,
+            GPT_4_TURBO,
+            GPT_4_TURBO_2024_04_09,
+            GPT_4_0125_PREVIEW,
+            GPT_4_TURBO_PREVIEW,
+            GPT_4_1106_PREVIEW,
+            GPT_4_VISION_PREVIEW,
+            GPT_4,
+            GPT_4_0314,
+            GPT_4_0613,
+            GPT_4_32K,
+            GPT_4_32K_0314,
+            GPT_4_32K_0613,
+            GPT_3_5_TURBO,
+            GPT_3_5_TURBO_16K,
+            GPT_3_5_TURBO_0301,
+            GPT_3_5_TURBO_0613,
+            GPT_3_5_TURBO_1106,
+            GPT_3_5_TURBO_0125,
+            GPT_3_5_TURBO_16K_0613,
+            O1_PRO,
+            O1_PRO_2025_03_19,
+            O3_PRO,
+            O3_PRO_2025_06_10,
+            O3_DEEP_RESEARCH,
+            O3_DEEP_RESEARCH_2025_06_26,
+            O4_MINI_DEEP_RESEARCH,
+            O4_MINI_DEEP_RESEARCH_2025_06_26,
+            COMPUTER_USE_PREVIEW,
+            COMPUTER_USE_PREVIEW_2025_03_11,
+            GPT_5_CODEX,
+            GPT_5_PRO,
+            GPT_5_PRO_2025_10_06,
+            GPT_5_1_CODEX_MAX,
+        }
+
+        /**
+         * An enum containing [Model]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Model] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            GPT_5_6_SOL,
+            GPT_5_6_TERRA,
+            GPT_5_6_LUNA,
+            GPT_5_4,
+            GPT_5_4_MINI,
+            GPT_5_4_NANO,
+            GPT_5_4_MINI_2026_03_17,
+            GPT_5_4_NANO_2026_03_17,
+            GPT_5_3_CHAT_LATEST,
+            GPT_5_2,
+            GPT_5_2_2025_12_11,
+            GPT_5_2_CHAT_LATEST,
+            GPT_5_2_PRO,
+            GPT_5_2_PRO_2025_12_11,
+            GPT_5_1,
+            GPT_5_1_2025_11_13,
+            GPT_5_1_CODEX,
+            GPT_5_1_MINI,
+            GPT_5_1_CHAT_LATEST,
+            GPT_5,
+            GPT_5_MINI,
+            GPT_5_NANO,
+            GPT_5_2025_08_07,
+            GPT_5_MINI_2025_08_07,
+            GPT_5_NANO_2025_08_07,
+            GPT_5_CHAT_LATEST,
+            GPT_4_1,
+            GPT_4_1_MINI,
+            GPT_4_1_NANO,
+            GPT_4_1_2025_04_14,
+            GPT_4_1_MINI_2025_04_14,
+            GPT_4_1_NANO_2025_04_14,
+            O4_MINI,
+            O4_MINI_2025_04_16,
+            O3,
+            O3_2025_04_16,
+            O3_MINI,
+            O3_MINI_2025_01_31,
+            O1,
+            O1_2024_12_17,
+            O1_PREVIEW,
+            O1_PREVIEW_2024_09_12,
+            O1_MINI,
+            O1_MINI_2024_09_12,
+            GPT_4O,
+            GPT_4O_2024_11_20,
+            GPT_4O_2024_08_06,
+            GPT_4O_2024_05_13,
+            GPT_4O_AUDIO_PREVIEW,
+            GPT_4O_AUDIO_PREVIEW_2024_10_01,
+            GPT_4O_AUDIO_PREVIEW_2024_12_17,
+            GPT_4O_AUDIO_PREVIEW_2025_06_03,
+            GPT_4O_MINI_AUDIO_PREVIEW,
+            GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17,
+            GPT_4O_SEARCH_PREVIEW,
+            GPT_4O_MINI_SEARCH_PREVIEW,
+            GPT_4O_SEARCH_PREVIEW_2025_03_11,
+            GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11,
+            CHATGPT_4O_LATEST,
+            CODEX_MINI_LATEST,
+            GPT_4O_MINI,
+            GPT_4O_MINI_2024_07_18,
+            GPT_4_TURBO,
+            GPT_4_TURBO_2024_04_09,
+            GPT_4_0125_PREVIEW,
+            GPT_4_TURBO_PREVIEW,
+            GPT_4_1106_PREVIEW,
+            GPT_4_VISION_PREVIEW,
+            GPT_4,
+            GPT_4_0314,
+            GPT_4_0613,
+            GPT_4_32K,
+            GPT_4_32K_0314,
+            GPT_4_32K_0613,
+            GPT_3_5_TURBO,
+            GPT_3_5_TURBO_16K,
+            GPT_3_5_TURBO_0301,
+            GPT_3_5_TURBO_0613,
+            GPT_3_5_TURBO_1106,
+            GPT_3_5_TURBO_0125,
+            GPT_3_5_TURBO_16K_0613,
+            O1_PRO,
+            O1_PRO_2025_03_19,
+            O3_PRO,
+            O3_PRO_2025_06_10,
+            O3_DEEP_RESEARCH,
+            O3_DEEP_RESEARCH_2025_06_26,
+            O4_MINI_DEEP_RESEARCH,
+            O4_MINI_DEEP_RESEARCH_2025_06_26,
+            COMPUTER_USE_PREVIEW,
+            COMPUTER_USE_PREVIEW_2025_03_11,
+            GPT_5_CODEX,
+            GPT_5_PRO,
+            GPT_5_PRO_2025_10_06,
+            GPT_5_1_CODEX_MAX,
+            /** An enum member indicating that [Model] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                GPT_5_6_SOL -> Value.GPT_5_6_SOL
+                GPT_5_6_TERRA -> Value.GPT_5_6_TERRA
+                GPT_5_6_LUNA -> Value.GPT_5_6_LUNA
+                GPT_5_4 -> Value.GPT_5_4
+                GPT_5_4_MINI -> Value.GPT_5_4_MINI
+                GPT_5_4_NANO -> Value.GPT_5_4_NANO
+                GPT_5_4_MINI_2026_03_17 -> Value.GPT_5_4_MINI_2026_03_17
+                GPT_5_4_NANO_2026_03_17 -> Value.GPT_5_4_NANO_2026_03_17
+                GPT_5_3_CHAT_LATEST -> Value.GPT_5_3_CHAT_LATEST
+                GPT_5_2 -> Value.GPT_5_2
+                GPT_5_2_2025_12_11 -> Value.GPT_5_2_2025_12_11
+                GPT_5_2_CHAT_LATEST -> Value.GPT_5_2_CHAT_LATEST
+                GPT_5_2_PRO -> Value.GPT_5_2_PRO
+                GPT_5_2_PRO_2025_12_11 -> Value.GPT_5_2_PRO_2025_12_11
+                GPT_5_1 -> Value.GPT_5_1
+                GPT_5_1_2025_11_13 -> Value.GPT_5_1_2025_11_13
+                GPT_5_1_CODEX -> Value.GPT_5_1_CODEX
+                GPT_5_1_MINI -> Value.GPT_5_1_MINI
+                GPT_5_1_CHAT_LATEST -> Value.GPT_5_1_CHAT_LATEST
+                GPT_5 -> Value.GPT_5
+                GPT_5_MINI -> Value.GPT_5_MINI
+                GPT_5_NANO -> Value.GPT_5_NANO
+                GPT_5_2025_08_07 -> Value.GPT_5_2025_08_07
+                GPT_5_MINI_2025_08_07 -> Value.GPT_5_MINI_2025_08_07
+                GPT_5_NANO_2025_08_07 -> Value.GPT_5_NANO_2025_08_07
+                GPT_5_CHAT_LATEST -> Value.GPT_5_CHAT_LATEST
+                GPT_4_1 -> Value.GPT_4_1
+                GPT_4_1_MINI -> Value.GPT_4_1_MINI
+                GPT_4_1_NANO -> Value.GPT_4_1_NANO
+                GPT_4_1_2025_04_14 -> Value.GPT_4_1_2025_04_14
+                GPT_4_1_MINI_2025_04_14 -> Value.GPT_4_1_MINI_2025_04_14
+                GPT_4_1_NANO_2025_04_14 -> Value.GPT_4_1_NANO_2025_04_14
+                O4_MINI -> Value.O4_MINI
+                O4_MINI_2025_04_16 -> Value.O4_MINI_2025_04_16
+                O3 -> Value.O3
+                O3_2025_04_16 -> Value.O3_2025_04_16
+                O3_MINI -> Value.O3_MINI
+                O3_MINI_2025_01_31 -> Value.O3_MINI_2025_01_31
+                O1 -> Value.O1
+                O1_2024_12_17 -> Value.O1_2024_12_17
+                O1_PREVIEW -> Value.O1_PREVIEW
+                O1_PREVIEW_2024_09_12 -> Value.O1_PREVIEW_2024_09_12
+                O1_MINI -> Value.O1_MINI
+                O1_MINI_2024_09_12 -> Value.O1_MINI_2024_09_12
+                GPT_4O -> Value.GPT_4O
+                GPT_4O_2024_11_20 -> Value.GPT_4O_2024_11_20
+                GPT_4O_2024_08_06 -> Value.GPT_4O_2024_08_06
+                GPT_4O_2024_05_13 -> Value.GPT_4O_2024_05_13
+                GPT_4O_AUDIO_PREVIEW -> Value.GPT_4O_AUDIO_PREVIEW
+                GPT_4O_AUDIO_PREVIEW_2024_10_01 -> Value.GPT_4O_AUDIO_PREVIEW_2024_10_01
+                GPT_4O_AUDIO_PREVIEW_2024_12_17 -> Value.GPT_4O_AUDIO_PREVIEW_2024_12_17
+                GPT_4O_AUDIO_PREVIEW_2025_06_03 -> Value.GPT_4O_AUDIO_PREVIEW_2025_06_03
+                GPT_4O_MINI_AUDIO_PREVIEW -> Value.GPT_4O_MINI_AUDIO_PREVIEW
+                GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17 -> Value.GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17
+                GPT_4O_SEARCH_PREVIEW -> Value.GPT_4O_SEARCH_PREVIEW
+                GPT_4O_MINI_SEARCH_PREVIEW -> Value.GPT_4O_MINI_SEARCH_PREVIEW
+                GPT_4O_SEARCH_PREVIEW_2025_03_11 -> Value.GPT_4O_SEARCH_PREVIEW_2025_03_11
+                GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11 -> Value.GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11
+                CHATGPT_4O_LATEST -> Value.CHATGPT_4O_LATEST
+                CODEX_MINI_LATEST -> Value.CODEX_MINI_LATEST
+                GPT_4O_MINI -> Value.GPT_4O_MINI
+                GPT_4O_MINI_2024_07_18 -> Value.GPT_4O_MINI_2024_07_18
+                GPT_4_TURBO -> Value.GPT_4_TURBO
+                GPT_4_TURBO_2024_04_09 -> Value.GPT_4_TURBO_2024_04_09
+                GPT_4_0125_PREVIEW -> Value.GPT_4_0125_PREVIEW
+                GPT_4_TURBO_PREVIEW -> Value.GPT_4_TURBO_PREVIEW
+                GPT_4_1106_PREVIEW -> Value.GPT_4_1106_PREVIEW
+                GPT_4_VISION_PREVIEW -> Value.GPT_4_VISION_PREVIEW
+                GPT_4 -> Value.GPT_4
+                GPT_4_0314 -> Value.GPT_4_0314
+                GPT_4_0613 -> Value.GPT_4_0613
+                GPT_4_32K -> Value.GPT_4_32K
+                GPT_4_32K_0314 -> Value.GPT_4_32K_0314
+                GPT_4_32K_0613 -> Value.GPT_4_32K_0613
+                GPT_3_5_TURBO -> Value.GPT_3_5_TURBO
+                GPT_3_5_TURBO_16K -> Value.GPT_3_5_TURBO_16K
+                GPT_3_5_TURBO_0301 -> Value.GPT_3_5_TURBO_0301
+                GPT_3_5_TURBO_0613 -> Value.GPT_3_5_TURBO_0613
+                GPT_3_5_TURBO_1106 -> Value.GPT_3_5_TURBO_1106
+                GPT_3_5_TURBO_0125 -> Value.GPT_3_5_TURBO_0125
+                GPT_3_5_TURBO_16K_0613 -> Value.GPT_3_5_TURBO_16K_0613
+                O1_PRO -> Value.O1_PRO
+                O1_PRO_2025_03_19 -> Value.O1_PRO_2025_03_19
+                O3_PRO -> Value.O3_PRO
+                O3_PRO_2025_06_10 -> Value.O3_PRO_2025_06_10
+                O3_DEEP_RESEARCH -> Value.O3_DEEP_RESEARCH
+                O3_DEEP_RESEARCH_2025_06_26 -> Value.O3_DEEP_RESEARCH_2025_06_26
+                O4_MINI_DEEP_RESEARCH -> Value.O4_MINI_DEEP_RESEARCH
+                O4_MINI_DEEP_RESEARCH_2025_06_26 -> Value.O4_MINI_DEEP_RESEARCH_2025_06_26
+                COMPUTER_USE_PREVIEW -> Value.COMPUTER_USE_PREVIEW
+                COMPUTER_USE_PREVIEW_2025_03_11 -> Value.COMPUTER_USE_PREVIEW_2025_03_11
+                GPT_5_CODEX -> Value.GPT_5_CODEX
+                GPT_5_PRO -> Value.GPT_5_PRO
+                GPT_5_PRO_2025_10_06 -> Value.GPT_5_PRO_2025_10_06
+                GPT_5_1_CODEX_MAX -> Value.GPT_5_1_CODEX_MAX
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                GPT_5_6_SOL -> Known.GPT_5_6_SOL
+                GPT_5_6_TERRA -> Known.GPT_5_6_TERRA
+                GPT_5_6_LUNA -> Known.GPT_5_6_LUNA
+                GPT_5_4 -> Known.GPT_5_4
+                GPT_5_4_MINI -> Known.GPT_5_4_MINI
+                GPT_5_4_NANO -> Known.GPT_5_4_NANO
+                GPT_5_4_MINI_2026_03_17 -> Known.GPT_5_4_MINI_2026_03_17
+                GPT_5_4_NANO_2026_03_17 -> Known.GPT_5_4_NANO_2026_03_17
+                GPT_5_3_CHAT_LATEST -> Known.GPT_5_3_CHAT_LATEST
+                GPT_5_2 -> Known.GPT_5_2
+                GPT_5_2_2025_12_11 -> Known.GPT_5_2_2025_12_11
+                GPT_5_2_CHAT_LATEST -> Known.GPT_5_2_CHAT_LATEST
+                GPT_5_2_PRO -> Known.GPT_5_2_PRO
+                GPT_5_2_PRO_2025_12_11 -> Known.GPT_5_2_PRO_2025_12_11
+                GPT_5_1 -> Known.GPT_5_1
+                GPT_5_1_2025_11_13 -> Known.GPT_5_1_2025_11_13
+                GPT_5_1_CODEX -> Known.GPT_5_1_CODEX
+                GPT_5_1_MINI -> Known.GPT_5_1_MINI
+                GPT_5_1_CHAT_LATEST -> Known.GPT_5_1_CHAT_LATEST
+                GPT_5 -> Known.GPT_5
+                GPT_5_MINI -> Known.GPT_5_MINI
+                GPT_5_NANO -> Known.GPT_5_NANO
+                GPT_5_2025_08_07 -> Known.GPT_5_2025_08_07
+                GPT_5_MINI_2025_08_07 -> Known.GPT_5_MINI_2025_08_07
+                GPT_5_NANO_2025_08_07 -> Known.GPT_5_NANO_2025_08_07
+                GPT_5_CHAT_LATEST -> Known.GPT_5_CHAT_LATEST
+                GPT_4_1 -> Known.GPT_4_1
+                GPT_4_1_MINI -> Known.GPT_4_1_MINI
+                GPT_4_1_NANO -> Known.GPT_4_1_NANO
+                GPT_4_1_2025_04_14 -> Known.GPT_4_1_2025_04_14
+                GPT_4_1_MINI_2025_04_14 -> Known.GPT_4_1_MINI_2025_04_14
+                GPT_4_1_NANO_2025_04_14 -> Known.GPT_4_1_NANO_2025_04_14
+                O4_MINI -> Known.O4_MINI
+                O4_MINI_2025_04_16 -> Known.O4_MINI_2025_04_16
+                O3 -> Known.O3
+                O3_2025_04_16 -> Known.O3_2025_04_16
+                O3_MINI -> Known.O3_MINI
+                O3_MINI_2025_01_31 -> Known.O3_MINI_2025_01_31
+                O1 -> Known.O1
+                O1_2024_12_17 -> Known.O1_2024_12_17
+                O1_PREVIEW -> Known.O1_PREVIEW
+                O1_PREVIEW_2024_09_12 -> Known.O1_PREVIEW_2024_09_12
+                O1_MINI -> Known.O1_MINI
+                O1_MINI_2024_09_12 -> Known.O1_MINI_2024_09_12
+                GPT_4O -> Known.GPT_4O
+                GPT_4O_2024_11_20 -> Known.GPT_4O_2024_11_20
+                GPT_4O_2024_08_06 -> Known.GPT_4O_2024_08_06
+                GPT_4O_2024_05_13 -> Known.GPT_4O_2024_05_13
+                GPT_4O_AUDIO_PREVIEW -> Known.GPT_4O_AUDIO_PREVIEW
+                GPT_4O_AUDIO_PREVIEW_2024_10_01 -> Known.GPT_4O_AUDIO_PREVIEW_2024_10_01
+                GPT_4O_AUDIO_PREVIEW_2024_12_17 -> Known.GPT_4O_AUDIO_PREVIEW_2024_12_17
+                GPT_4O_AUDIO_PREVIEW_2025_06_03 -> Known.GPT_4O_AUDIO_PREVIEW_2025_06_03
+                GPT_4O_MINI_AUDIO_PREVIEW -> Known.GPT_4O_MINI_AUDIO_PREVIEW
+                GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17 -> Known.GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17
+                GPT_4O_SEARCH_PREVIEW -> Known.GPT_4O_SEARCH_PREVIEW
+                GPT_4O_MINI_SEARCH_PREVIEW -> Known.GPT_4O_MINI_SEARCH_PREVIEW
+                GPT_4O_SEARCH_PREVIEW_2025_03_11 -> Known.GPT_4O_SEARCH_PREVIEW_2025_03_11
+                GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11 -> Known.GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11
+                CHATGPT_4O_LATEST -> Known.CHATGPT_4O_LATEST
+                CODEX_MINI_LATEST -> Known.CODEX_MINI_LATEST
+                GPT_4O_MINI -> Known.GPT_4O_MINI
+                GPT_4O_MINI_2024_07_18 -> Known.GPT_4O_MINI_2024_07_18
+                GPT_4_TURBO -> Known.GPT_4_TURBO
+                GPT_4_TURBO_2024_04_09 -> Known.GPT_4_TURBO_2024_04_09
+                GPT_4_0125_PREVIEW -> Known.GPT_4_0125_PREVIEW
+                GPT_4_TURBO_PREVIEW -> Known.GPT_4_TURBO_PREVIEW
+                GPT_4_1106_PREVIEW -> Known.GPT_4_1106_PREVIEW
+                GPT_4_VISION_PREVIEW -> Known.GPT_4_VISION_PREVIEW
+                GPT_4 -> Known.GPT_4
+                GPT_4_0314 -> Known.GPT_4_0314
+                GPT_4_0613 -> Known.GPT_4_0613
+                GPT_4_32K -> Known.GPT_4_32K
+                GPT_4_32K_0314 -> Known.GPT_4_32K_0314
+                GPT_4_32K_0613 -> Known.GPT_4_32K_0613
+                GPT_3_5_TURBO -> Known.GPT_3_5_TURBO
+                GPT_3_5_TURBO_16K -> Known.GPT_3_5_TURBO_16K
+                GPT_3_5_TURBO_0301 -> Known.GPT_3_5_TURBO_0301
+                GPT_3_5_TURBO_0613 -> Known.GPT_3_5_TURBO_0613
+                GPT_3_5_TURBO_1106 -> Known.GPT_3_5_TURBO_1106
+                GPT_3_5_TURBO_0125 -> Known.GPT_3_5_TURBO_0125
+                GPT_3_5_TURBO_16K_0613 -> Known.GPT_3_5_TURBO_16K_0613
+                O1_PRO -> Known.O1_PRO
+                O1_PRO_2025_03_19 -> Known.O1_PRO_2025_03_19
+                O3_PRO -> Known.O3_PRO
+                O3_PRO_2025_06_10 -> Known.O3_PRO_2025_06_10
+                O3_DEEP_RESEARCH -> Known.O3_DEEP_RESEARCH
+                O3_DEEP_RESEARCH_2025_06_26 -> Known.O3_DEEP_RESEARCH_2025_06_26
+                O4_MINI_DEEP_RESEARCH -> Known.O4_MINI_DEEP_RESEARCH
+                O4_MINI_DEEP_RESEARCH_2025_06_26 -> Known.O4_MINI_DEEP_RESEARCH_2025_06_26
+                COMPUTER_USE_PREVIEW -> Known.COMPUTER_USE_PREVIEW
+                COMPUTER_USE_PREVIEW_2025_03_11 -> Known.COMPUTER_USE_PREVIEW_2025_03_11
+                GPT_5_CODEX -> Known.GPT_5_CODEX
+                GPT_5_PRO -> Known.GPT_5_PRO
+                GPT_5_PRO_2025_10_06 -> Known.GPT_5_PRO_2025_10_06
+                GPT_5_1_CODEX_MAX -> Known.GPT_5_1_CODEX_MAX
+                else -> throw OpenAIInvalidDataException("Unknown Model: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Model = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Model && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /**
+     * How the model should select which tool (or tools) to use when generating a response. See the
+     * `tools` parameter to see how to specify which tools the model can call.
+     */
+    @JsonDeserialize(using = ToolChoice.Deserializer::class)
+    @JsonSerialize(using = ToolChoice.Serializer::class)
+    class ToolChoice
+    private constructor(
+        private val betaToolChoiceOptions: BetaToolChoiceOptions? = null,
+        private val betaToolChoiceAllowed: BetaToolChoiceAllowed? = null,
+        private val betaToolChoiceTypes: BetaToolChoiceTypes? = null,
+        private val betaToolChoiceFunction: BetaToolChoiceFunction? = null,
+        private val betaToolChoiceMcp: BetaToolChoiceMcp? = null,
+        private val betaToolChoiceCustom: BetaToolChoiceCustom? = null,
+        private val betaSpecificProgrammaticToolCallingParam: JsonValue? = null,
+        private val betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch? = null,
+        private val betaToolChoiceShell: BetaToolChoiceShell? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /**
+         * Controls which (if any) tool is called by the model.
+         *
+         * `none` means the model will not call any tool and instead generates a message.
+         *
+         * `auto` means the model can pick between generating a message or calling one or more
+         * tools.
+         *
+         * `required` means the model must call one or more tools.
+         */
+        fun betaToolChoiceOptions(): Optional<BetaToolChoiceOptions> =
+            Optional.ofNullable(betaToolChoiceOptions)
+
+        /** Constrains the tools available to the model to a pre-defined set. */
+        fun betaToolChoiceAllowed(): Optional<BetaToolChoiceAllowed> =
+            Optional.ofNullable(betaToolChoiceAllowed)
+
+        /**
+         * Indicates that the model should use a built-in tool to generate a response.
+         * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+         */
+        fun betaToolChoiceTypes(): Optional<BetaToolChoiceTypes> =
+            Optional.ofNullable(betaToolChoiceTypes)
+
+        /** Use this option to force the model to call a specific function. */
+        fun betaToolChoiceFunction(): Optional<BetaToolChoiceFunction> =
+            Optional.ofNullable(betaToolChoiceFunction)
+
+        /** Use this option to force the model to call a specific tool on a remote MCP server. */
+        fun betaToolChoiceMcp(): Optional<BetaToolChoiceMcp> =
+            Optional.ofNullable(betaToolChoiceMcp)
+
+        /** Use this option to force the model to call a specific custom tool. */
+        fun betaToolChoiceCustom(): Optional<BetaToolChoiceCustom> =
+            Optional.ofNullable(betaToolChoiceCustom)
+
+        fun betaSpecificProgrammaticToolCallingParam(): Optional<JsonValue> =
+            Optional.ofNullable(betaSpecificProgrammaticToolCallingParam)
+
+        /** Forces the model to call the apply_patch tool when executing a tool call. */
+        fun betaToolChoiceApplyPatch(): Optional<BetaToolChoiceApplyPatch> =
+            Optional.ofNullable(betaToolChoiceApplyPatch)
+
+        /** Forces the model to call the shell tool when a tool call is required. */
+        fun betaToolChoiceShell(): Optional<BetaToolChoiceShell> =
+            Optional.ofNullable(betaToolChoiceShell)
+
+        fun isBetaToolChoiceOptions(): Boolean = betaToolChoiceOptions != null
+
+        fun isBetaToolChoiceAllowed(): Boolean = betaToolChoiceAllowed != null
+
+        fun isBetaToolChoiceTypes(): Boolean = betaToolChoiceTypes != null
+
+        fun isBetaToolChoiceFunction(): Boolean = betaToolChoiceFunction != null
+
+        fun isBetaToolChoiceMcp(): Boolean = betaToolChoiceMcp != null
+
+        fun isBetaToolChoiceCustom(): Boolean = betaToolChoiceCustom != null
+
+        fun isBetaSpecificProgrammaticToolCallingParam(): Boolean =
+            betaSpecificProgrammaticToolCallingParam != null
+
+        fun isBetaToolChoiceApplyPatch(): Boolean = betaToolChoiceApplyPatch != null
+
+        fun isBetaToolChoiceShell(): Boolean = betaToolChoiceShell != null
+
+        /**
+         * Controls which (if any) tool is called by the model.
+         *
+         * `none` means the model will not call any tool and instead generates a message.
+         *
+         * `auto` means the model can pick between generating a message or calling one or more
+         * tools.
+         *
+         * `required` means the model must call one or more tools.
+         */
+        fun asBetaToolChoiceOptions(): BetaToolChoiceOptions =
+            betaToolChoiceOptions.getOrThrow("betaToolChoiceOptions")
+
+        /** Constrains the tools available to the model to a pre-defined set. */
+        fun asBetaToolChoiceAllowed(): BetaToolChoiceAllowed =
+            betaToolChoiceAllowed.getOrThrow("betaToolChoiceAllowed")
+
+        /**
+         * Indicates that the model should use a built-in tool to generate a response.
+         * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+         */
+        fun asBetaToolChoiceTypes(): BetaToolChoiceTypes =
+            betaToolChoiceTypes.getOrThrow("betaToolChoiceTypes")
+
+        /** Use this option to force the model to call a specific function. */
+        fun asBetaToolChoiceFunction(): BetaToolChoiceFunction =
+            betaToolChoiceFunction.getOrThrow("betaToolChoiceFunction")
+
+        /** Use this option to force the model to call a specific tool on a remote MCP server. */
+        fun asBetaToolChoiceMcp(): BetaToolChoiceMcp =
+            betaToolChoiceMcp.getOrThrow("betaToolChoiceMcp")
+
+        /** Use this option to force the model to call a specific custom tool. */
+        fun asBetaToolChoiceCustom(): BetaToolChoiceCustom =
+            betaToolChoiceCustom.getOrThrow("betaToolChoiceCustom")
+
+        fun asBetaSpecificProgrammaticToolCallingParam(): JsonValue =
+            betaSpecificProgrammaticToolCallingParam.getOrThrow(
+                "betaSpecificProgrammaticToolCallingParam"
+            )
+
+        /** Forces the model to call the apply_patch tool when executing a tool call. */
+        fun asBetaToolChoiceApplyPatch(): BetaToolChoiceApplyPatch =
+            betaToolChoiceApplyPatch.getOrThrow("betaToolChoiceApplyPatch")
+
+        /** Forces the model to call the shell tool when a tool call is required. */
+        fun asBetaToolChoiceShell(): BetaToolChoiceShell =
+            betaToolChoiceShell.getOrThrow("betaToolChoiceShell")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = toolChoice.accept(new ToolChoice.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitBetaToolChoiceOptions(BetaToolChoiceOptions betaToolChoiceOptions) {
+         *         return Optional.of(betaToolChoiceOptions.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                betaToolChoiceOptions != null ->
+                    visitor.visitBetaToolChoiceOptions(betaToolChoiceOptions)
+                betaToolChoiceAllowed != null ->
+                    visitor.visitBetaToolChoiceAllowed(betaToolChoiceAllowed)
+                betaToolChoiceTypes != null -> visitor.visitBetaToolChoiceTypes(betaToolChoiceTypes)
+                betaToolChoiceFunction != null ->
+                    visitor.visitBetaToolChoiceFunction(betaToolChoiceFunction)
+                betaToolChoiceMcp != null -> visitor.visitBetaToolChoiceMcp(betaToolChoiceMcp)
+                betaToolChoiceCustom != null ->
+                    visitor.visitBetaToolChoiceCustom(betaToolChoiceCustom)
+                betaSpecificProgrammaticToolCallingParam != null ->
+                    visitor.visitBetaSpecificProgrammaticToolCallingParam(
+                        betaSpecificProgrammaticToolCallingParam
+                    )
+                betaToolChoiceApplyPatch != null ->
+                    visitor.visitBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch)
+                betaToolChoiceShell != null -> visitor.visitBetaToolChoiceShell(betaToolChoiceShell)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ToolChoice = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitBetaToolChoiceOptions(
+                        betaToolChoiceOptions: BetaToolChoiceOptions
+                    ) {
+                        betaToolChoiceOptions.validate()
+                    }
+
+                    override fun visitBetaToolChoiceAllowed(
+                        betaToolChoiceAllowed: BetaToolChoiceAllowed
+                    ) {
+                        betaToolChoiceAllowed.validate()
+                    }
+
+                    override fun visitBetaToolChoiceTypes(
+                        betaToolChoiceTypes: BetaToolChoiceTypes
+                    ) {
+                        betaToolChoiceTypes.validate()
+                    }
+
+                    override fun visitBetaToolChoiceFunction(
+                        betaToolChoiceFunction: BetaToolChoiceFunction
+                    ) {
+                        betaToolChoiceFunction.validate()
+                    }
+
+                    override fun visitBetaToolChoiceMcp(betaToolChoiceMcp: BetaToolChoiceMcp) {
+                        betaToolChoiceMcp.validate()
+                    }
+
+                    override fun visitBetaToolChoiceCustom(
+                        betaToolChoiceCustom: BetaToolChoiceCustom
+                    ) {
+                        betaToolChoiceCustom.validate()
+                    }
+
+                    override fun visitBetaSpecificProgrammaticToolCallingParam(
+                        betaSpecificProgrammaticToolCallingParam: JsonValue
+                    ) {
+                        betaSpecificProgrammaticToolCallingParam.let {
+                            if (
+                                it != JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                            ) {
+                                throw OpenAIInvalidDataException(
+                                    "'betaSpecificProgrammaticToolCallingParam' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitBetaToolChoiceApplyPatch(
+                        betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch
+                    ) {
+                        betaToolChoiceApplyPatch.validate()
+                    }
+
+                    override fun visitBetaToolChoiceShell(
+                        betaToolChoiceShell: BetaToolChoiceShell
+                    ) {
+                        betaToolChoiceShell.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitBetaToolChoiceOptions(
+                        betaToolChoiceOptions: BetaToolChoiceOptions
+                    ) = betaToolChoiceOptions.validity()
+
+                    override fun visitBetaToolChoiceAllowed(
+                        betaToolChoiceAllowed: BetaToolChoiceAllowed
+                    ) = betaToolChoiceAllowed.validity()
+
+                    override fun visitBetaToolChoiceTypes(
+                        betaToolChoiceTypes: BetaToolChoiceTypes
+                    ) = betaToolChoiceTypes.validity()
+
+                    override fun visitBetaToolChoiceFunction(
+                        betaToolChoiceFunction: BetaToolChoiceFunction
+                    ) = betaToolChoiceFunction.validity()
+
+                    override fun visitBetaToolChoiceMcp(betaToolChoiceMcp: BetaToolChoiceMcp) =
+                        betaToolChoiceMcp.validity()
+
+                    override fun visitBetaToolChoiceCustom(
+                        betaToolChoiceCustom: BetaToolChoiceCustom
+                    ) = betaToolChoiceCustom.validity()
+
+                    override fun visitBetaSpecificProgrammaticToolCallingParam(
+                        betaSpecificProgrammaticToolCallingParam: JsonValue
+                    ) =
+                        betaSpecificProgrammaticToolCallingParam.let {
+                            if (it == JsonValue.from(mapOf("type" to "programmatic_tool_calling")))
+                                1
+                            else 0
+                        }
+
+                    override fun visitBetaToolChoiceApplyPatch(
+                        betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch
+                    ) = betaToolChoiceApplyPatch.validity()
+
+                    override fun visitBetaToolChoiceShell(
+                        betaToolChoiceShell: BetaToolChoiceShell
+                    ) = betaToolChoiceShell.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ToolChoice &&
+                betaToolChoiceOptions == other.betaToolChoiceOptions &&
+                betaToolChoiceAllowed == other.betaToolChoiceAllowed &&
+                betaToolChoiceTypes == other.betaToolChoiceTypes &&
+                betaToolChoiceFunction == other.betaToolChoiceFunction &&
+                betaToolChoiceMcp == other.betaToolChoiceMcp &&
+                betaToolChoiceCustom == other.betaToolChoiceCustom &&
+                betaSpecificProgrammaticToolCallingParam ==
+                    other.betaSpecificProgrammaticToolCallingParam &&
+                betaToolChoiceApplyPatch == other.betaToolChoiceApplyPatch &&
+                betaToolChoiceShell == other.betaToolChoiceShell
+        }
+
+        override fun hashCode(): Int =
+            Objects.hash(
+                betaToolChoiceOptions,
+                betaToolChoiceAllowed,
+                betaToolChoiceTypes,
+                betaToolChoiceFunction,
+                betaToolChoiceMcp,
+                betaToolChoiceCustom,
+                betaSpecificProgrammaticToolCallingParam,
+                betaToolChoiceApplyPatch,
+                betaToolChoiceShell,
+            )
+
+        override fun toString(): String =
+            when {
+                betaToolChoiceOptions != null ->
+                    "ToolChoice{betaToolChoiceOptions=$betaToolChoiceOptions}"
+                betaToolChoiceAllowed != null ->
+                    "ToolChoice{betaToolChoiceAllowed=$betaToolChoiceAllowed}"
+                betaToolChoiceTypes != null ->
+                    "ToolChoice{betaToolChoiceTypes=$betaToolChoiceTypes}"
+                betaToolChoiceFunction != null ->
+                    "ToolChoice{betaToolChoiceFunction=$betaToolChoiceFunction}"
+                betaToolChoiceMcp != null -> "ToolChoice{betaToolChoiceMcp=$betaToolChoiceMcp}"
+                betaToolChoiceCustom != null ->
+                    "ToolChoice{betaToolChoiceCustom=$betaToolChoiceCustom}"
+                betaSpecificProgrammaticToolCallingParam != null ->
+                    "ToolChoice{betaSpecificProgrammaticToolCallingParam=$betaSpecificProgrammaticToolCallingParam}"
+                betaToolChoiceApplyPatch != null ->
+                    "ToolChoice{betaToolChoiceApplyPatch=$betaToolChoiceApplyPatch}"
+                betaToolChoiceShell != null ->
+                    "ToolChoice{betaToolChoiceShell=$betaToolChoiceShell}"
+                _json != null -> "ToolChoice{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid ToolChoice")
+            }
+
+        companion object {
+
+            /**
+             * Controls which (if any) tool is called by the model.
+             *
+             * `none` means the model will not call any tool and instead generates a message.
+             *
+             * `auto` means the model can pick between generating a message or calling one or more
+             * tools.
+             *
+             * `required` means the model must call one or more tools.
+             */
+            @JvmStatic
+            fun ofBetaToolChoiceOptions(betaToolChoiceOptions: BetaToolChoiceOptions) =
+                ToolChoice(betaToolChoiceOptions = betaToolChoiceOptions)
+
+            /** Constrains the tools available to the model to a pre-defined set. */
+            @JvmStatic
+            fun ofBetaToolChoiceAllowed(betaToolChoiceAllowed: BetaToolChoiceAllowed) =
+                ToolChoice(betaToolChoiceAllowed = betaToolChoiceAllowed)
+
+            /**
+             * Indicates that the model should use a built-in tool to generate a response.
+             * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+             */
+            @JvmStatic
+            fun ofBetaToolChoiceTypes(betaToolChoiceTypes: BetaToolChoiceTypes) =
+                ToolChoice(betaToolChoiceTypes = betaToolChoiceTypes)
+
+            /** Use this option to force the model to call a specific function. */
+            @JvmStatic
+            fun ofBetaToolChoiceFunction(betaToolChoiceFunction: BetaToolChoiceFunction) =
+                ToolChoice(betaToolChoiceFunction = betaToolChoiceFunction)
+
+            /**
+             * Use this option to force the model to call a specific tool on a remote MCP server.
+             */
+            @JvmStatic
+            fun ofBetaToolChoiceMcp(betaToolChoiceMcp: BetaToolChoiceMcp) =
+                ToolChoice(betaToolChoiceMcp = betaToolChoiceMcp)
+
+            /** Use this option to force the model to call a specific custom tool. */
+            @JvmStatic
+            fun ofBetaToolChoiceCustom(betaToolChoiceCustom: BetaToolChoiceCustom) =
+                ToolChoice(betaToolChoiceCustom = betaToolChoiceCustom)
+
+            @JvmStatic
+            fun ofBetaSpecificProgrammaticToolCallingParam() =
+                ToolChoice(
+                    betaSpecificProgrammaticToolCallingParam =
+                        JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                )
+
+            /** Forces the model to call the apply_patch tool when executing a tool call. */
+            @JvmStatic
+            fun ofBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch) =
+                ToolChoice(betaToolChoiceApplyPatch = betaToolChoiceApplyPatch)
+
+            /** Forces the model to call the shell tool when a tool call is required. */
+            @JvmStatic
+            fun ofBetaToolChoiceShell(betaToolChoiceShell: BetaToolChoiceShell) =
+                ToolChoice(betaToolChoiceShell = betaToolChoiceShell)
+        }
+
+        /**
+         * An interface that defines how to map each variant of [ToolChoice] to a value of type [T].
+         */
+        interface Visitor<out T> {
+
+            /**
+             * Controls which (if any) tool is called by the model.
+             *
+             * `none` means the model will not call any tool and instead generates a message.
+             *
+             * `auto` means the model can pick between generating a message or calling one or more
+             * tools.
+             *
+             * `required` means the model must call one or more tools.
+             */
+            fun visitBetaToolChoiceOptions(betaToolChoiceOptions: BetaToolChoiceOptions): T
+
+            /** Constrains the tools available to the model to a pre-defined set. */
+            fun visitBetaToolChoiceAllowed(betaToolChoiceAllowed: BetaToolChoiceAllowed): T
+
+            /**
+             * Indicates that the model should use a built-in tool to generate a response.
+             * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+             */
+            fun visitBetaToolChoiceTypes(betaToolChoiceTypes: BetaToolChoiceTypes): T
+
+            /** Use this option to force the model to call a specific function. */
+            fun visitBetaToolChoiceFunction(betaToolChoiceFunction: BetaToolChoiceFunction): T
+
+            /**
+             * Use this option to force the model to call a specific tool on a remote MCP server.
+             */
+            fun visitBetaToolChoiceMcp(betaToolChoiceMcp: BetaToolChoiceMcp): T
+
+            /** Use this option to force the model to call a specific custom tool. */
+            fun visitBetaToolChoiceCustom(betaToolChoiceCustom: BetaToolChoiceCustom): T
+
+            fun visitBetaSpecificProgrammaticToolCallingParam(
+                betaSpecificProgrammaticToolCallingParam: JsonValue
+            ): T
+
+            /** Forces the model to call the apply_patch tool when executing a tool call. */
+            fun visitBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch): T
+
+            /** Forces the model to call the shell tool when a tool call is required. */
+            fun visitBetaToolChoiceShell(betaToolChoiceShell: BetaToolChoiceShell): T
+
+            /**
+             * Maps an unknown variant of [ToolChoice] to a value of type [T].
+             *
+             * An instance of [ToolChoice] can contain an unknown variant if it was deserialized
+             * from data that doesn't match any known variant. For example, if the SDK is on an
+             * older version than the API, then the API may respond with new variants that the SDK
+             * is unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown ToolChoice: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<ToolChoice>(ToolChoice::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): ToolChoice {
+                val json = JsonValue.fromJsonNode(node)
+
+                val bestMatches =
+                    sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let {
+                                    ToolChoice(
+                                        betaSpecificProgrammaticToolCallingParam = it,
+                                        _json = json,
+                                    )
+                                }
+                                ?.takeIf { it.isValid() },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceOptions>())?.let {
+                                ToolChoice(betaToolChoiceOptions = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceAllowed>())?.let {
+                                ToolChoice(betaToolChoiceAllowed = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceTypes>())?.let {
+                                ToolChoice(betaToolChoiceTypes = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceFunction>())?.let {
+                                ToolChoice(betaToolChoiceFunction = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceMcp>())?.let {
+                                ToolChoice(betaToolChoiceMcp = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceCustom>())?.let {
+                                ToolChoice(betaToolChoiceCustom = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceApplyPatch>())?.let {
+                                ToolChoice(betaToolChoiceApplyPatch = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceShell>())?.let {
+                                ToolChoice(betaToolChoiceShell = it, _json = json)
+                            },
+                        )
+                        .filterNotNull()
+                        .allMaxBy { it.validity() }
+                        .toList()
+                return when (bestMatches.size) {
+                    // This can happen if what we're deserializing is completely incompatible with
+                    // all the possible variants (e.g. deserializing from boolean).
+                    0 -> ToolChoice(_json = json)
+                    1 -> bestMatches.single()
+                    // If there's more than one match with the highest validity, then use the first
+                    // completely valid match, or simply the first match if none are completely
+                    // valid.
+                    else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                }
+            }
+        }
+
+        internal class Serializer : BaseSerializer<ToolChoice>(ToolChoice::class) {
+
+            override fun serialize(
+                value: ToolChoice,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.betaToolChoiceOptions != null ->
+                        generator.writeObject(value.betaToolChoiceOptions)
+                    value.betaToolChoiceAllowed != null ->
+                        generator.writeObject(value.betaToolChoiceAllowed)
+                    value.betaToolChoiceTypes != null ->
+                        generator.writeObject(value.betaToolChoiceTypes)
+                    value.betaToolChoiceFunction != null ->
+                        generator.writeObject(value.betaToolChoiceFunction)
+                    value.betaToolChoiceMcp != null ->
+                        generator.writeObject(value.betaToolChoiceMcp)
+                    value.betaToolChoiceCustom != null ->
+                        generator.writeObject(value.betaToolChoiceCustom)
+                    value.betaSpecificProgrammaticToolCallingParam != null ->
+                        generator.writeObject(value.betaSpecificProgrammaticToolCallingParam)
+                    value.betaToolChoiceApplyPatch != null ->
+                        generator.writeObject(value.betaToolChoiceApplyPatch)
+                    value.betaToolChoiceShell != null ->
+                        generator.writeObject(value.betaToolChoiceShell)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid ToolChoice")
+                }
+            }
+        }
+    }
+
+    /**
+     * The conversation that this response belonged to. Input items and output items from this
+     * response were automatically added to this conversation.
+     */
+    class Conversation
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of()
+        ) : this(id, mutableMapOf())
+
+        /**
+         * The unique ID of the conversation that this response was associated with.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Conversation].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Conversation]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(conversation: Conversation) = apply {
+                id = conversation.id
+                additionalProperties = conversation.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the conversation that this response was associated with. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Conversation].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Conversation =
+                Conversation(checkRequired("id", id), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Conversation = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (id.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Conversation &&
+                id == other.id &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(id, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() = "Conversation{id=$id, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Moderation results for the response input and output, if moderated completions were
+     * requested.
+     */
+    class Moderation
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val input: JsonField<Input>,
+        private val output: JsonField<Output>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("input") @ExcludeMissing input: JsonField<Input> = JsonMissing.of(),
+            @JsonProperty("output") @ExcludeMissing output: JsonField<Output> = JsonMissing.of(),
+        ) : this(input, output, mutableMapOf())
+
+        /**
+         * Moderation for the response input.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun input(): Input = input.getRequired("input")
+
+        /**
+         * Moderation for the response output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun output(): Output = output.getRequired("output")
+
+        /**
+         * Returns the raw JSON value of [input].
+         *
+         * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("input") @ExcludeMissing fun _input(): JsonField<Input> = input
+
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<Output> = output
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Moderation].
+             *
+             * The following fields are required:
+             * ```java
+             * .input()
+             * .output()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Moderation]. */
+        class Builder internal constructor() {
+
+            private var input: JsonField<Input>? = null
+            private var output: JsonField<Output>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(moderation: Moderation) = apply {
+                input = moderation.input
+                output = moderation.output
+                additionalProperties = moderation.additionalProperties.toMutableMap()
+            }
+
+            /** Moderation for the response input. */
+            fun input(input: Input) = input(JsonField.of(input))
+
+            /**
+             * Sets [Builder.input] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.input] with a well-typed [Input] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun input(input: JsonField<Input>) = apply { this.input = input }
+
+            /** Alias for calling [input] with `Input.ofModerationResult(moderationResult)`. */
+            fun input(moderationResult: Input.ModerationResult) =
+                input(Input.ofModerationResult(moderationResult))
+
+            /** Alias for calling [input] with `Input.ofError(error)`. */
+            fun input(error: Input.Error) = input(Input.ofError(error))
+
+            /** Moderation for the response output. */
+            fun output(output: Output) = output(JsonField.of(output))
+
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed [Output] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun output(output: JsonField<Output>) = apply { this.output = output }
+
+            /** Alias for calling [output] with `Output.ofModerationResult(moderationResult)`. */
+            fun output(moderationResult: Output.ModerationResult) =
+                output(Output.ofModerationResult(moderationResult))
+
+            /** Alias for calling [output] with `Output.ofError(error)`. */
+            fun output(error: Output.Error) = output(Output.ofError(error))
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Moderation].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .input()
+             * .output()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Moderation =
+                Moderation(
+                    checkRequired("input", input),
+                    checkRequired("output", output),
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Moderation = apply {
+            if (validated) {
+                return@apply
+            }
+
+            input().validate()
+            output().validate()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (input.asKnown().getOrNull()?.validity() ?: 0) +
+                (output.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** Moderation for the response input. */
+        @JsonDeserialize(using = Input.Deserializer::class)
+        @JsonSerialize(using = Input.Serializer::class)
+        class Input
+        private constructor(
+            private val moderationResult: ModerationResult? = null,
+            private val error: Error? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /** A moderation result produced for the response input or output. */
+            fun moderationResult(): Optional<ModerationResult> =
+                Optional.ofNullable(moderationResult)
+
+            /** An error produced while attempting moderation for the response input or output. */
+            fun error(): Optional<Error> = Optional.ofNullable(error)
+
+            fun isModerationResult(): Boolean = moderationResult != null
+
+            fun isError(): Boolean = error != null
+
+            /** A moderation result produced for the response input or output. */
+            fun asModerationResult(): ModerationResult =
+                moderationResult.getOrThrow("moderationResult")
+
+            /** An error produced while attempting moderation for the response input or output. */
+            fun asError(): Error = error.getOrThrow("error")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = input.accept(new Input.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitModerationResult(ModerationResult moderationResult) {
+             *         return Optional.of(moderationResult.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    moderationResult != null -> visitor.visitModerationResult(moderationResult)
+                    error != null -> visitor.visitError(error)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Input = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitModerationResult(moderationResult: ModerationResult) {
+                            moderationResult.validate()
+                        }
+
+                        override fun visitError(error: Error) {
+                            error.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitModerationResult(moderationResult: ModerationResult) =
+                            moderationResult.validity()
+
+                        override fun visitError(error: Error) = error.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Input &&
+                    moderationResult == other.moderationResult &&
+                    error == other.error
+            }
+
+            override fun hashCode(): Int = Objects.hash(moderationResult, error)
+
+            override fun toString(): String =
+                when {
+                    moderationResult != null -> "Input{moderationResult=$moderationResult}"
+                    error != null -> "Input{error=$error}"
+                    _json != null -> "Input{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Input")
+                }
+
+            companion object {
+
+                /** A moderation result produced for the response input or output. */
+                @JvmStatic
+                fun ofModerationResult(moderationResult: ModerationResult) =
+                    Input(moderationResult = moderationResult)
+
+                /**
+                 * An error produced while attempting moderation for the response input or output.
+                 */
+                @JvmStatic fun ofError(error: Error) = Input(error = error)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Input] to a value of type [T].
+             */
+            interface Visitor<out T> {
+
+                /** A moderation result produced for the response input or output. */
+                fun visitModerationResult(moderationResult: ModerationResult): T
+
+                /**
+                 * An error produced while attempting moderation for the response input or output.
+                 */
+                fun visitError(error: Error): T
+
+                /**
+                 * Maps an unknown variant of [Input] to a value of type [T].
+                 *
+                 * An instance of [Input] can contain an unknown variant if it was deserialized from
+                 * data that doesn't match any known variant. For example, if the SDK is on an older
+                 * version than the API, then the API may respond with new variants that the SDK is
+                 * unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Input: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Input>(Input::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Input {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "moderation_result" -> {
+                            return tryDeserialize(node, jacksonTypeRef<ModerationResult>())?.let {
+                                Input(moderationResult = it, _json = json)
+                            } ?: Input(_json = json)
+                        }
+                        "error" -> {
+                            return tryDeserialize(node, jacksonTypeRef<Error>())?.let {
+                                Input(error = it, _json = json)
+                            } ?: Input(_json = json)
+                        }
+                    }
+
+                    return Input(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Input>(Input::class) {
+
+                override fun serialize(
+                    value: Input,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.moderationResult != null ->
+                            generator.writeObject(value.moderationResult)
+                        value.error != null -> generator.writeObject(value.error)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Input")
+                    }
+                }
+            }
+
+            /** A moderation result produced for the response input or output. */
+            class ModerationResult
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val categories: JsonField<Categories>,
+                private val categoryAppliedInputTypes: JsonField<CategoryAppliedInputTypes>,
+                private val categoryScores: JsonField<CategoryScores>,
+                private val flagged: JsonField<Boolean>,
+                private val model: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("categories")
+                    @ExcludeMissing
+                    categories: JsonField<Categories> = JsonMissing.of(),
+                    @JsonProperty("category_applied_input_types")
+                    @ExcludeMissing
+                    categoryAppliedInputTypes: JsonField<CategoryAppliedInputTypes> =
+                        JsonMissing.of(),
+                    @JsonProperty("category_scores")
+                    @ExcludeMissing
+                    categoryScores: JsonField<CategoryScores> = JsonMissing.of(),
+                    @JsonProperty("flagged")
+                    @ExcludeMissing
+                    flagged: JsonField<Boolean> = JsonMissing.of(),
+                    @JsonProperty("model")
+                    @ExcludeMissing
+                    model: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(
+                    categories,
+                    categoryAppliedInputTypes,
+                    categoryScores,
+                    flagged,
+                    model,
+                    type,
+                    mutableMapOf(),
+                )
+
+                /**
+                 * A dictionary of moderation categories to booleans, True if the input is flagged
+                 * under this category.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun categories(): Categories = categories.getRequired("categories")
+
+                /**
+                 * Which modalities of input are reflected by the score for each category.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun categoryAppliedInputTypes(): CategoryAppliedInputTypes =
+                    categoryAppliedInputTypes.getRequired("category_applied_input_types")
+
+                /**
+                 * A dictionary of moderation categories to scores.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun categoryScores(): CategoryScores = categoryScores.getRequired("category_scores")
+
+                /**
+                 * A boolean indicating whether the content was flagged by any category.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun flagged(): Boolean = flagged.getRequired("flagged")
+
+                /**
+                 * The moderation model that produced this result.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun model(): String = model.getRequired("model")
+
+                /**
+                 * The object type, which was always `moderation_result` for successful moderation
+                 * results.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("moderation_result")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [categories].
+                 *
+                 * Unlike [categories], this method doesn't throw if the JSON field has an
+                 * unexpected type.
+                 */
+                @JsonProperty("categories")
+                @ExcludeMissing
+                fun _categories(): JsonField<Categories> = categories
+
+                /**
+                 * Returns the raw JSON value of [categoryAppliedInputTypes].
+                 *
+                 * Unlike [categoryAppliedInputTypes], this method doesn't throw if the JSON field
+                 * has an unexpected type.
+                 */
+                @JsonProperty("category_applied_input_types")
+                @ExcludeMissing
+                fun _categoryAppliedInputTypes(): JsonField<CategoryAppliedInputTypes> =
+                    categoryAppliedInputTypes
+
+                /**
+                 * Returns the raw JSON value of [categoryScores].
+                 *
+                 * Unlike [categoryScores], this method doesn't throw if the JSON field has an
+                 * unexpected type.
+                 */
+                @JsonProperty("category_scores")
+                @ExcludeMissing
+                fun _categoryScores(): JsonField<CategoryScores> = categoryScores
+
+                /**
+                 * Returns the raw JSON value of [flagged].
+                 *
+                 * Unlike [flagged], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("flagged")
+                @ExcludeMissing
+                fun _flagged(): JsonField<Boolean> = flagged
+
+                /**
+                 * Returns the raw JSON value of [model].
+                 *
+                 * Unlike [model], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("model") @ExcludeMissing fun _model(): JsonField<String> = model
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [ModerationResult].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .categories()
+                     * .categoryAppliedInputTypes()
+                     * .categoryScores()
+                     * .flagged()
+                     * .model()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [ModerationResult]. */
+                class Builder internal constructor() {
+
+                    private var categories: JsonField<Categories>? = null
+                    private var categoryAppliedInputTypes: JsonField<CategoryAppliedInputTypes>? =
+                        null
+                    private var categoryScores: JsonField<CategoryScores>? = null
+                    private var flagged: JsonField<Boolean>? = null
+                    private var model: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("moderation_result")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(moderationResult: ModerationResult) = apply {
+                        categories = moderationResult.categories
+                        categoryAppliedInputTypes = moderationResult.categoryAppliedInputTypes
+                        categoryScores = moderationResult.categoryScores
+                        flagged = moderationResult.flagged
+                        model = moderationResult.model
+                        type = moderationResult.type
+                        additionalProperties = moderationResult.additionalProperties.toMutableMap()
+                    }
+
+                    /**
+                     * A dictionary of moderation categories to booleans, True if the input is
+                     * flagged under this category.
+                     */
+                    fun categories(categories: Categories) = categories(JsonField.of(categories))
+
+                    /**
+                     * Sets [Builder.categories] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.categories] with a well-typed [Categories]
+                     * value instead. This method is primarily for setting the field to an
+                     * undocumented or not yet supported value.
+                     */
+                    fun categories(categories: JsonField<Categories>) = apply {
+                        this.categories = categories
+                    }
+
+                    /** Which modalities of input are reflected by the score for each category. */
+                    fun categoryAppliedInputTypes(
+                        categoryAppliedInputTypes: CategoryAppliedInputTypes
+                    ) = categoryAppliedInputTypes(JsonField.of(categoryAppliedInputTypes))
+
+                    /**
+                     * Sets [Builder.categoryAppliedInputTypes] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.categoryAppliedInputTypes] with a well-typed
+                     * [CategoryAppliedInputTypes] value instead. This method is primarily for
+                     * setting the field to an undocumented or not yet supported value.
+                     */
+                    fun categoryAppliedInputTypes(
+                        categoryAppliedInputTypes: JsonField<CategoryAppliedInputTypes>
+                    ) = apply { this.categoryAppliedInputTypes = categoryAppliedInputTypes }
+
+                    /** A dictionary of moderation categories to scores. */
+                    fun categoryScores(categoryScores: CategoryScores) =
+                        categoryScores(JsonField.of(categoryScores))
+
+                    /**
+                     * Sets [Builder.categoryScores] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.categoryScores] with a well-typed
+                     * [CategoryScores] value instead. This method is primarily for setting the
+                     * field to an undocumented or not yet supported value.
+                     */
+                    fun categoryScores(categoryScores: JsonField<CategoryScores>) = apply {
+                        this.categoryScores = categoryScores
+                    }
+
+                    /** A boolean indicating whether the content was flagged by any category. */
+                    fun flagged(flagged: Boolean) = flagged(JsonField.of(flagged))
+
+                    /**
+                     * Sets [Builder.flagged] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.flagged] with a well-typed [Boolean] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun flagged(flagged: JsonField<Boolean>) = apply { this.flagged = flagged }
+
+                    /** The moderation model that produced this result. */
+                    fun model(model: String) = model(JsonField.of(model))
+
+                    /**
+                     * Sets [Builder.model] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.model] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun model(model: JsonField<String>) = apply { this.model = model }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("moderation_result")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [ModerationResult].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .categories()
+                     * .categoryAppliedInputTypes()
+                     * .categoryScores()
+                     * .flagged()
+                     * .model()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): ModerationResult =
+                        ModerationResult(
+                            checkRequired("categories", categories),
+                            checkRequired("categoryAppliedInputTypes", categoryAppliedInputTypes),
+                            checkRequired("categoryScores", categoryScores),
+                            checkRequired("flagged", flagged),
+                            checkRequired("model", model),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): ModerationResult = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    categories().validate()
+                    categoryAppliedInputTypes().validate()
+                    categoryScores().validate()
+                    flagged()
+                    model()
+                    _type().let {
+                        if (it != JsonValue.from("moderation_result")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (categories.asKnown().getOrNull()?.validity() ?: 0) +
+                        (categoryAppliedInputTypes.asKnown().getOrNull()?.validity() ?: 0) +
+                        (categoryScores.asKnown().getOrNull()?.validity() ?: 0) +
+                        (if (flagged.asKnown().isPresent) 1 else 0) +
+                        (if (model.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("moderation_result")) 1 else 0 }
+
+                /**
+                 * A dictionary of moderation categories to booleans, True if the input is flagged
+                 * under this category.
+                 */
+                class Categories
+                @JsonCreator
+                private constructor(
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    private val additionalProperties: Map<String, JsonValue>
+                ) {
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of [Categories].
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [Categories]. */
+                    class Builder internal constructor() {
+
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(categories: Categories) = apply {
+                            additionalProperties = categories.additionalProperties.toMutableMap()
+                        }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [Categories].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         */
+                        fun build(): Categories = Categories(additionalProperties.toImmutable())
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): Categories = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        additionalProperties.count { (_, value) ->
+                            !value.isNull() && !value.isMissing()
+                        }
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Categories &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "Categories{additionalProperties=$additionalProperties}"
+                }
+
+                /** Which modalities of input are reflected by the score for each category. */
+                class CategoryAppliedInputTypes
+                @JsonCreator
+                private constructor(
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    private val additionalProperties: Map<String, JsonValue>
+                ) {
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of
+                         * [CategoryAppliedInputTypes].
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [CategoryAppliedInputTypes]. */
+                    class Builder internal constructor() {
+
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(categoryAppliedInputTypes: CategoryAppliedInputTypes) =
+                            apply {
+                                additionalProperties =
+                                    categoryAppliedInputTypes.additionalProperties.toMutableMap()
+                            }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [CategoryAppliedInputTypes].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         */
+                        fun build(): CategoryAppliedInputTypes =
+                            CategoryAppliedInputTypes(additionalProperties.toImmutable())
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): CategoryAppliedInputTypes = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        additionalProperties.count { (_, value) ->
+                            !value.isNull() && !value.isMissing()
+                        }
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is CategoryAppliedInputTypes &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "CategoryAppliedInputTypes{additionalProperties=$additionalProperties}"
+                }
+
+                /** A dictionary of moderation categories to scores. */
+                class CategoryScores
+                @JsonCreator
+                private constructor(
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    private val additionalProperties: Map<String, JsonValue>
+                ) {
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of
+                         * [CategoryScores].
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [CategoryScores]. */
+                    class Builder internal constructor() {
+
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(categoryScores: CategoryScores) = apply {
+                            additionalProperties =
+                                categoryScores.additionalProperties.toMutableMap()
+                        }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [CategoryScores].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         */
+                        fun build(): CategoryScores =
+                            CategoryScores(additionalProperties.toImmutable())
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): CategoryScores = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        additionalProperties.count { (_, value) ->
+                            !value.isNull() && !value.isMissing()
+                        }
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is CategoryScores &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "CategoryScores{additionalProperties=$additionalProperties}"
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is ModerationResult &&
+                        categories == other.categories &&
+                        categoryAppliedInputTypes == other.categoryAppliedInputTypes &&
+                        categoryScores == other.categoryScores &&
+                        flagged == other.flagged &&
+                        model == other.model &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(
+                        categories,
+                        categoryAppliedInputTypes,
+                        categoryScores,
+                        flagged,
+                        model,
+                        type,
+                        additionalProperties,
+                    )
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "ModerationResult{categories=$categories, categoryAppliedInputTypes=$categoryAppliedInputTypes, categoryScores=$categoryScores, flagged=$flagged, model=$model, type=$type, additionalProperties=$additionalProperties}"
+            }
+
+            /** An error produced while attempting moderation for the response input or output. */
+            class Error
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val code: JsonField<String>,
+                private val message: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("code")
+                    @ExcludeMissing
+                    code: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("message")
+                    @ExcludeMissing
+                    message: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(code, message, type, mutableMapOf())
+
+                /**
+                 * The error code.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun code(): String = code.getRequired("code")
+
+                /**
+                 * The error message.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun message(): String = message.getRequired("message")
+
+                /**
+                 * The object type, which was always `error` for moderation failures.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("error")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [code].
+                 *
+                 * Unlike [code], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<String> = code
+
+                /**
+                 * Returns the raw JSON value of [message].
+                 *
+                 * Unlike [message], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("message") @ExcludeMissing fun _message(): JsonField<String> = message
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Error].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .code()
+                     * .message()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Error]. */
+                class Builder internal constructor() {
+
+                    private var code: JsonField<String>? = null
+                    private var message: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("error")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(error: Error) = apply {
+                        code = error.code
+                        message = error.message
+                        type = error.type
+                        additionalProperties = error.additionalProperties.toMutableMap()
+                    }
+
+                    /** The error code. */
+                    fun code(code: String) = code(JsonField.of(code))
+
+                    /**
+                     * Sets [Builder.code] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.code] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun code(code: JsonField<String>) = apply { this.code = code }
+
+                    /** The error message. */
+                    fun message(message: String) = message(JsonField.of(message))
+
+                    /**
+                     * Sets [Builder.message] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.message] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun message(message: JsonField<String>) = apply { this.message = message }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("error")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Error].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .code()
+                     * .message()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Error =
+                        Error(
+                            checkRequired("code", code),
+                            checkRequired("message", message),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Error = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    code()
+                    message()
+                    _type().let {
+                        if (it != JsonValue.from("error")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (code.asKnown().isPresent) 1 else 0) +
+                        (if (message.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("error")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Error &&
+                        code == other.code &&
+                        message == other.message &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(code, message, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Error{code=$code, message=$message, type=$type, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        /** Moderation for the response output. */
+        @JsonDeserialize(using = Output.Deserializer::class)
+        @JsonSerialize(using = Output.Serializer::class)
+        class Output
+        private constructor(
+            private val moderationResult: ModerationResult? = null,
+            private val error: Error? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /** A moderation result produced for the response input or output. */
+            fun moderationResult(): Optional<ModerationResult> =
+                Optional.ofNullable(moderationResult)
+
+            /** An error produced while attempting moderation for the response input or output. */
+            fun error(): Optional<Error> = Optional.ofNullable(error)
+
+            fun isModerationResult(): Boolean = moderationResult != null
+
+            fun isError(): Boolean = error != null
+
+            /** A moderation result produced for the response input or output. */
+            fun asModerationResult(): ModerationResult =
+                moderationResult.getOrThrow("moderationResult")
+
+            /** An error produced while attempting moderation for the response input or output. */
+            fun asError(): Error = error.getOrThrow("error")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = output.accept(new Output.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitModerationResult(ModerationResult moderationResult) {
+             *         return Optional.of(moderationResult.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    moderationResult != null -> visitor.visitModerationResult(moderationResult)
+                    error != null -> visitor.visitError(error)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Output = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitModerationResult(moderationResult: ModerationResult) {
+                            moderationResult.validate()
+                        }
+
+                        override fun visitError(error: Error) {
+                            error.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitModerationResult(moderationResult: ModerationResult) =
+                            moderationResult.validity()
+
+                        override fun visitError(error: Error) = error.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Output &&
+                    moderationResult == other.moderationResult &&
+                    error == other.error
+            }
+
+            override fun hashCode(): Int = Objects.hash(moderationResult, error)
+
+            override fun toString(): String =
+                when {
+                    moderationResult != null -> "Output{moderationResult=$moderationResult}"
+                    error != null -> "Output{error=$error}"
+                    _json != null -> "Output{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Output")
+                }
+
+            companion object {
+
+                /** A moderation result produced for the response input or output. */
+                @JvmStatic
+                fun ofModerationResult(moderationResult: ModerationResult) =
+                    Output(moderationResult = moderationResult)
+
+                /**
+                 * An error produced while attempting moderation for the response input or output.
+                 */
+                @JvmStatic fun ofError(error: Error) = Output(error = error)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Output] to a value of type [T].
+             */
+            interface Visitor<out T> {
+
+                /** A moderation result produced for the response input or output. */
+                fun visitModerationResult(moderationResult: ModerationResult): T
+
+                /**
+                 * An error produced while attempting moderation for the response input or output.
+                 */
+                fun visitError(error: Error): T
+
+                /**
+                 * Maps an unknown variant of [Output] to a value of type [T].
+                 *
+                 * An instance of [Output] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Output: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Output>(Output::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Output {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "moderation_result" -> {
+                            return tryDeserialize(node, jacksonTypeRef<ModerationResult>())?.let {
+                                Output(moderationResult = it, _json = json)
+                            } ?: Output(_json = json)
+                        }
+                        "error" -> {
+                            return tryDeserialize(node, jacksonTypeRef<Error>())?.let {
+                                Output(error = it, _json = json)
+                            } ?: Output(_json = json)
+                        }
+                    }
+
+                    return Output(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Output>(Output::class) {
+
+                override fun serialize(
+                    value: Output,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.moderationResult != null ->
+                            generator.writeObject(value.moderationResult)
+                        value.error != null -> generator.writeObject(value.error)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Output")
+                    }
+                }
+            }
+
+            /** A moderation result produced for the response input or output. */
+            class ModerationResult
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val categories: JsonField<Categories>,
+                private val categoryAppliedInputTypes: JsonField<CategoryAppliedInputTypes>,
+                private val categoryScores: JsonField<CategoryScores>,
+                private val flagged: JsonField<Boolean>,
+                private val model: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("categories")
+                    @ExcludeMissing
+                    categories: JsonField<Categories> = JsonMissing.of(),
+                    @JsonProperty("category_applied_input_types")
+                    @ExcludeMissing
+                    categoryAppliedInputTypes: JsonField<CategoryAppliedInputTypes> =
+                        JsonMissing.of(),
+                    @JsonProperty("category_scores")
+                    @ExcludeMissing
+                    categoryScores: JsonField<CategoryScores> = JsonMissing.of(),
+                    @JsonProperty("flagged")
+                    @ExcludeMissing
+                    flagged: JsonField<Boolean> = JsonMissing.of(),
+                    @JsonProperty("model")
+                    @ExcludeMissing
+                    model: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(
+                    categories,
+                    categoryAppliedInputTypes,
+                    categoryScores,
+                    flagged,
+                    model,
+                    type,
+                    mutableMapOf(),
+                )
+
+                /**
+                 * A dictionary of moderation categories to booleans, True if the input is flagged
+                 * under this category.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun categories(): Categories = categories.getRequired("categories")
+
+                /**
+                 * Which modalities of input are reflected by the score for each category.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun categoryAppliedInputTypes(): CategoryAppliedInputTypes =
+                    categoryAppliedInputTypes.getRequired("category_applied_input_types")
+
+                /**
+                 * A dictionary of moderation categories to scores.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun categoryScores(): CategoryScores = categoryScores.getRequired("category_scores")
+
+                /**
+                 * A boolean indicating whether the content was flagged by any category.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun flagged(): Boolean = flagged.getRequired("flagged")
+
+                /**
+                 * The moderation model that produced this result.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun model(): String = model.getRequired("model")
+
+                /**
+                 * The object type, which was always `moderation_result` for successful moderation
+                 * results.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("moderation_result")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [categories].
+                 *
+                 * Unlike [categories], this method doesn't throw if the JSON field has an
+                 * unexpected type.
+                 */
+                @JsonProperty("categories")
+                @ExcludeMissing
+                fun _categories(): JsonField<Categories> = categories
+
+                /**
+                 * Returns the raw JSON value of [categoryAppliedInputTypes].
+                 *
+                 * Unlike [categoryAppliedInputTypes], this method doesn't throw if the JSON field
+                 * has an unexpected type.
+                 */
+                @JsonProperty("category_applied_input_types")
+                @ExcludeMissing
+                fun _categoryAppliedInputTypes(): JsonField<CategoryAppliedInputTypes> =
+                    categoryAppliedInputTypes
+
+                /**
+                 * Returns the raw JSON value of [categoryScores].
+                 *
+                 * Unlike [categoryScores], this method doesn't throw if the JSON field has an
+                 * unexpected type.
+                 */
+                @JsonProperty("category_scores")
+                @ExcludeMissing
+                fun _categoryScores(): JsonField<CategoryScores> = categoryScores
+
+                /**
+                 * Returns the raw JSON value of [flagged].
+                 *
+                 * Unlike [flagged], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("flagged")
+                @ExcludeMissing
+                fun _flagged(): JsonField<Boolean> = flagged
+
+                /**
+                 * Returns the raw JSON value of [model].
+                 *
+                 * Unlike [model], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("model") @ExcludeMissing fun _model(): JsonField<String> = model
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [ModerationResult].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .categories()
+                     * .categoryAppliedInputTypes()
+                     * .categoryScores()
+                     * .flagged()
+                     * .model()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [ModerationResult]. */
+                class Builder internal constructor() {
+
+                    private var categories: JsonField<Categories>? = null
+                    private var categoryAppliedInputTypes: JsonField<CategoryAppliedInputTypes>? =
+                        null
+                    private var categoryScores: JsonField<CategoryScores>? = null
+                    private var flagged: JsonField<Boolean>? = null
+                    private var model: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("moderation_result")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(moderationResult: ModerationResult) = apply {
+                        categories = moderationResult.categories
+                        categoryAppliedInputTypes = moderationResult.categoryAppliedInputTypes
+                        categoryScores = moderationResult.categoryScores
+                        flagged = moderationResult.flagged
+                        model = moderationResult.model
+                        type = moderationResult.type
+                        additionalProperties = moderationResult.additionalProperties.toMutableMap()
+                    }
+
+                    /**
+                     * A dictionary of moderation categories to booleans, True if the input is
+                     * flagged under this category.
+                     */
+                    fun categories(categories: Categories) = categories(JsonField.of(categories))
+
+                    /**
+                     * Sets [Builder.categories] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.categories] with a well-typed [Categories]
+                     * value instead. This method is primarily for setting the field to an
+                     * undocumented or not yet supported value.
+                     */
+                    fun categories(categories: JsonField<Categories>) = apply {
+                        this.categories = categories
+                    }
+
+                    /** Which modalities of input are reflected by the score for each category. */
+                    fun categoryAppliedInputTypes(
+                        categoryAppliedInputTypes: CategoryAppliedInputTypes
+                    ) = categoryAppliedInputTypes(JsonField.of(categoryAppliedInputTypes))
+
+                    /**
+                     * Sets [Builder.categoryAppliedInputTypes] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.categoryAppliedInputTypes] with a well-typed
+                     * [CategoryAppliedInputTypes] value instead. This method is primarily for
+                     * setting the field to an undocumented or not yet supported value.
+                     */
+                    fun categoryAppliedInputTypes(
+                        categoryAppliedInputTypes: JsonField<CategoryAppliedInputTypes>
+                    ) = apply { this.categoryAppliedInputTypes = categoryAppliedInputTypes }
+
+                    /** A dictionary of moderation categories to scores. */
+                    fun categoryScores(categoryScores: CategoryScores) =
+                        categoryScores(JsonField.of(categoryScores))
+
+                    /**
+                     * Sets [Builder.categoryScores] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.categoryScores] with a well-typed
+                     * [CategoryScores] value instead. This method is primarily for setting the
+                     * field to an undocumented or not yet supported value.
+                     */
+                    fun categoryScores(categoryScores: JsonField<CategoryScores>) = apply {
+                        this.categoryScores = categoryScores
+                    }
+
+                    /** A boolean indicating whether the content was flagged by any category. */
+                    fun flagged(flagged: Boolean) = flagged(JsonField.of(flagged))
+
+                    /**
+                     * Sets [Builder.flagged] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.flagged] with a well-typed [Boolean] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun flagged(flagged: JsonField<Boolean>) = apply { this.flagged = flagged }
+
+                    /** The moderation model that produced this result. */
+                    fun model(model: String) = model(JsonField.of(model))
+
+                    /**
+                     * Sets [Builder.model] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.model] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun model(model: JsonField<String>) = apply { this.model = model }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("moderation_result")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [ModerationResult].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .categories()
+                     * .categoryAppliedInputTypes()
+                     * .categoryScores()
+                     * .flagged()
+                     * .model()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): ModerationResult =
+                        ModerationResult(
+                            checkRequired("categories", categories),
+                            checkRequired("categoryAppliedInputTypes", categoryAppliedInputTypes),
+                            checkRequired("categoryScores", categoryScores),
+                            checkRequired("flagged", flagged),
+                            checkRequired("model", model),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): ModerationResult = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    categories().validate()
+                    categoryAppliedInputTypes().validate()
+                    categoryScores().validate()
+                    flagged()
+                    model()
+                    _type().let {
+                        if (it != JsonValue.from("moderation_result")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (categories.asKnown().getOrNull()?.validity() ?: 0) +
+                        (categoryAppliedInputTypes.asKnown().getOrNull()?.validity() ?: 0) +
+                        (categoryScores.asKnown().getOrNull()?.validity() ?: 0) +
+                        (if (flagged.asKnown().isPresent) 1 else 0) +
+                        (if (model.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("moderation_result")) 1 else 0 }
+
+                /**
+                 * A dictionary of moderation categories to booleans, True if the input is flagged
+                 * under this category.
+                 */
+                class Categories
+                @JsonCreator
+                private constructor(
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    private val additionalProperties: Map<String, JsonValue>
+                ) {
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of [Categories].
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [Categories]. */
+                    class Builder internal constructor() {
+
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(categories: Categories) = apply {
+                            additionalProperties = categories.additionalProperties.toMutableMap()
+                        }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [Categories].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         */
+                        fun build(): Categories = Categories(additionalProperties.toImmutable())
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): Categories = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        additionalProperties.count { (_, value) ->
+                            !value.isNull() && !value.isMissing()
+                        }
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Categories &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "Categories{additionalProperties=$additionalProperties}"
+                }
+
+                /** Which modalities of input are reflected by the score for each category. */
+                class CategoryAppliedInputTypes
+                @JsonCreator
+                private constructor(
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    private val additionalProperties: Map<String, JsonValue>
+                ) {
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of
+                         * [CategoryAppliedInputTypes].
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [CategoryAppliedInputTypes]. */
+                    class Builder internal constructor() {
+
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(categoryAppliedInputTypes: CategoryAppliedInputTypes) =
+                            apply {
+                                additionalProperties =
+                                    categoryAppliedInputTypes.additionalProperties.toMutableMap()
+                            }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [CategoryAppliedInputTypes].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         */
+                        fun build(): CategoryAppliedInputTypes =
+                            CategoryAppliedInputTypes(additionalProperties.toImmutable())
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): CategoryAppliedInputTypes = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        additionalProperties.count { (_, value) ->
+                            !value.isNull() && !value.isMissing()
+                        }
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is CategoryAppliedInputTypes &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "CategoryAppliedInputTypes{additionalProperties=$additionalProperties}"
+                }
+
+                /** A dictionary of moderation categories to scores. */
+                class CategoryScores
+                @JsonCreator
+                private constructor(
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    private val additionalProperties: Map<String, JsonValue>
+                ) {
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of
+                         * [CategoryScores].
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [CategoryScores]. */
+                    class Builder internal constructor() {
+
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(categoryScores: CategoryScores) = apply {
+                            additionalProperties =
+                                categoryScores.additionalProperties.toMutableMap()
+                        }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [CategoryScores].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         */
+                        fun build(): CategoryScores =
+                            CategoryScores(additionalProperties.toImmutable())
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): CategoryScores = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        additionalProperties.count { (_, value) ->
+                            !value.isNull() && !value.isMissing()
+                        }
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is CategoryScores &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "CategoryScores{additionalProperties=$additionalProperties}"
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is ModerationResult &&
+                        categories == other.categories &&
+                        categoryAppliedInputTypes == other.categoryAppliedInputTypes &&
+                        categoryScores == other.categoryScores &&
+                        flagged == other.flagged &&
+                        model == other.model &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(
+                        categories,
+                        categoryAppliedInputTypes,
+                        categoryScores,
+                        flagged,
+                        model,
+                        type,
+                        additionalProperties,
+                    )
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "ModerationResult{categories=$categories, categoryAppliedInputTypes=$categoryAppliedInputTypes, categoryScores=$categoryScores, flagged=$flagged, model=$model, type=$type, additionalProperties=$additionalProperties}"
+            }
+
+            /** An error produced while attempting moderation for the response input or output. */
+            class Error
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val code: JsonField<String>,
+                private val message: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("code")
+                    @ExcludeMissing
+                    code: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("message")
+                    @ExcludeMissing
+                    message: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(code, message, type, mutableMapOf())
+
+                /**
+                 * The error code.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun code(): String = code.getRequired("code")
+
+                /**
+                 * The error message.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun message(): String = message.getRequired("message")
+
+                /**
+                 * The object type, which was always `error` for moderation failures.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("error")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [code].
+                 *
+                 * Unlike [code], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<String> = code
+
+                /**
+                 * Returns the raw JSON value of [message].
+                 *
+                 * Unlike [message], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("message") @ExcludeMissing fun _message(): JsonField<String> = message
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Error].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .code()
+                     * .message()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Error]. */
+                class Builder internal constructor() {
+
+                    private var code: JsonField<String>? = null
+                    private var message: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("error")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(error: Error) = apply {
+                        code = error.code
+                        message = error.message
+                        type = error.type
+                        additionalProperties = error.additionalProperties.toMutableMap()
+                    }
+
+                    /** The error code. */
+                    fun code(code: String) = code(JsonField.of(code))
+
+                    /**
+                     * Sets [Builder.code] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.code] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun code(code: JsonField<String>) = apply { this.code = code }
+
+                    /** The error message. */
+                    fun message(message: String) = message(JsonField.of(message))
+
+                    /**
+                     * Sets [Builder.message] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.message] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun message(message: JsonField<String>) = apply { this.message = message }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("error")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Error].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .code()
+                     * .message()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Error =
+                        Error(
+                            checkRequired("code", code),
+                            checkRequired("message", message),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Error = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    code()
+                    message()
+                    _type().let {
+                        if (it != JsonValue.from("error")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (code.asKnown().isPresent) 1 else 0) +
+                        (if (message.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("error")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Error &&
+                        code == other.code &&
+                        message == other.message &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(code, message, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Error{code=$code, message=$message, type=$type, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Moderation &&
+                input == other.input &&
+                output == other.output &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(input, output, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Moderation{input=$input, output=$output, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * The prompt-caching options that were applied to the response. Supported for `gpt-5.6` and
+     * later models.
+     */
+    class PromptCacheOptions
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonField<Mode>,
+        private val ttl: JsonField<Ttl>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of(),
+            @JsonProperty("ttl") @ExcludeMissing ttl: JsonField<Ttl> = JsonMissing.of(),
+        ) : this(mode, ttl, mutableMapOf())
+
+        /**
+         * Whether implicit prompt-cache breakpoints were enabled.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun mode(): Mode = mode.getRequired("mode")
+
+        /**
+         * The minimum lifetime applied to each cache breakpoint.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun ttl(): Ttl = ttl.getRequired("ttl")
+
+        /**
+         * Returns the raw JSON value of [mode].
+         *
+         * Unlike [mode], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+        /**
+         * Returns the raw JSON value of [ttl].
+         *
+         * Unlike [ttl], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("ttl") @ExcludeMissing fun _ttl(): JsonField<Ttl> = ttl
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheOptions].
+             *
+             * The following fields are required:
+             * ```java
+             * .mode()
+             * .ttl()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheOptions]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonField<Mode>? = null
+            private var ttl: JsonField<Ttl>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheOptions: PromptCacheOptions) = apply {
+                mode = promptCacheOptions.mode
+                ttl = promptCacheOptions.ttl
+                additionalProperties = promptCacheOptions.additionalProperties.toMutableMap()
+            }
+
+            /** Whether implicit prompt-cache breakpoints were enabled. */
+            fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+            /**
+             * Sets [Builder.mode] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.mode] with a well-typed [Mode] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+            /** The minimum lifetime applied to each cache breakpoint. */
+            fun ttl(ttl: Ttl) = ttl(JsonField.of(ttl))
+
+            /**
+             * Sets [Builder.ttl] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.ttl] with a well-typed [Ttl] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun ttl(ttl: JsonField<Ttl>) = apply { this.ttl = ttl }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheOptions].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .mode()
+             * .ttl()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): PromptCacheOptions =
+                PromptCacheOptions(
+                    checkRequired("mode", mode),
+                    checkRequired("ttl", ttl),
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheOptions = apply {
+            if (validated) {
+                return@apply
+            }
+
+            mode().validate()
+            ttl().validate()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (mode.asKnown().getOrNull()?.validity() ?: 0) +
+                (ttl.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** Whether implicit prompt-cache breakpoints were enabled. */
+        class Mode @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IMPLICIT = of("implicit")
+
+                @JvmField val EXPLICIT = of("explicit")
+
+                @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+            }
+
+            /** An enum containing [Mode]'s known values. */
+            enum class Known {
+                IMPLICIT,
+                EXPLICIT,
+            }
+
+            /**
+             * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Mode] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IMPLICIT,
+                EXPLICIT,
+                /** An enum member indicating that [Mode] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IMPLICIT -> Value.IMPLICIT
+                    EXPLICIT -> Value.EXPLICIT
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IMPLICIT -> Known.IMPLICIT
+                    EXPLICIT -> Known.EXPLICIT
+                    else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Mode = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Mode && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The minimum lifetime applied to each cache breakpoint. */
+        class Ttl @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val _30M = of("30m")
+
+                @JvmStatic fun of(value: String) = Ttl(JsonField.of(value))
+            }
+
+            /** An enum containing [Ttl]'s known values. */
+            enum class Known {
+                _30M
+            }
+
+            /**
+             * An enum containing [Ttl]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Ttl] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                _30M,
+                /** An enum member indicating that [Ttl] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    _30M -> Value._30M
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    _30M -> Known._30M
+                    else -> throw OpenAIInvalidDataException("Unknown Ttl: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Ttl = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Ttl && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheOptions &&
+                mode == other.mode &&
+                ttl == other.ttl &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, ttl, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheOptions{mode=$mode, ttl=$ttl, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Deprecated. Use `prompt_cache_options.ttl` instead.
+     *
+     * The retention policy for the prompt cache. Set to `24h` to enable extended prompt caching,
+     * which keeps cached prefixes active for longer, up to a maximum of 24 hours.
+     * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+     * This field expresses a maximum retention policy, while `prompt_cache_options.ttl` expresses a
+     * minimum cache lifetime. The two fields are independent and do not interact. For `gpt-5.5`,
+     * `gpt-5.5-pro`, and future models, only `24h` is supported.
+     *
+     * For older models that support both `in_memory` and `24h`, the default depends on your
+     * organization's data retention policy:
+     * - Organizations without ZDR enabled default to `24h`.
+     * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is not
+     *   specified.
+     */
+    @Deprecated("deprecated")
+    class PromptCacheRetention
+    @JsonCreator
+    private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_MEMORY = of("in_memory")
+
+            @JvmField val _24H = of("24h")
+
+            @JvmStatic fun of(value: String) = PromptCacheRetention(JsonField.of(value))
+        }
+
+        /** An enum containing [PromptCacheRetention]'s known values. */
+        enum class Known {
+            IN_MEMORY,
+            _24H,
+        }
+
+        /**
+         * An enum containing [PromptCacheRetention]'s known values, as well as an [_UNKNOWN]
+         * member.
+         *
+         * An instance of [PromptCacheRetention] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_MEMORY,
+            _24H,
+            /**
+             * An enum member indicating that [PromptCacheRetention] was instantiated with an
+             * unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_MEMORY -> Value.IN_MEMORY
+                _24H -> Value._24H
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_MEMORY -> Known.IN_MEMORY
+                _24H -> Known._24H
+                else -> throw OpenAIInvalidDataException("Unknown PromptCacheRetention: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheRetention = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheRetention && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /**
+     * **gpt-5 and o-series models only**
+     *
+     * Configuration options for
+     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+     */
+    class Reasoning
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val context: JsonField<Context>,
+        private val effort: JsonField<Effort>,
+        private val generateSummary: JsonField<GenerateSummary>,
+        private val mode: JsonField<Mode>,
+        private val summary: JsonField<Summary>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("context") @ExcludeMissing context: JsonField<Context> = JsonMissing.of(),
+            @JsonProperty("effort") @ExcludeMissing effort: JsonField<Effort> = JsonMissing.of(),
+            @JsonProperty("generate_summary")
+            @ExcludeMissing
+            generateSummary: JsonField<GenerateSummary> = JsonMissing.of(),
+            @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of(),
+            @JsonProperty("summary") @ExcludeMissing summary: JsonField<Summary> = JsonMissing.of(),
+        ) : this(context, effort, generateSummary, mode, summary, mutableMapOf())
+
+        /**
+         * Controls which reasoning items are rendered back to the model on later turns. When
+         * returned on a response, this is the effective reasoning context mode used for the
+         * response.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun context(): Optional<Context> = context.getOptional("context")
+
+        /**
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun effort(): Optional<Effort> = effort.getOptional("effort")
+
+        /**
+         * **Deprecated:** use `summary` instead.
+         *
+         * A summary of the reasoning performed by the model. This can be useful for debugging and
+         * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        @Deprecated("deprecated")
+        fun generateSummary(): Optional<GenerateSummary> =
+            generateSummary.getOptional("generate_summary")
+
+        /**
+         * Controls the reasoning execution mode for the request.
+         *
+         * When returned on a response, this is the effective execution mode.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun mode(): Optional<Mode> = mode.getOptional("mode")
+
+        /**
+         * A summary of the reasoning performed by the model. This can be useful for debugging and
+         * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
+         *
+         * `concise` is supported for `computer-use-preview` models and all reasoning models after
+         * `gpt-5`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun summary(): Optional<Summary> = summary.getOptional("summary")
+
+        /**
+         * Returns the raw JSON value of [context].
+         *
+         * Unlike [context], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("context") @ExcludeMissing fun _context(): JsonField<Context> = context
+
+        /**
+         * Returns the raw JSON value of [effort].
+         *
+         * Unlike [effort], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("effort") @ExcludeMissing fun _effort(): JsonField<Effort> = effort
+
+        /**
+         * Returns the raw JSON value of [generateSummary].
+         *
+         * Unlike [generateSummary], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @Deprecated("deprecated")
+        @JsonProperty("generate_summary")
+        @ExcludeMissing
+        fun _generateSummary(): JsonField<GenerateSummary> = generateSummary
+
+        /**
+         * Returns the raw JSON value of [mode].
+         *
+         * Unlike [mode], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+        /**
+         * Returns the raw JSON value of [summary].
+         *
+         * Unlike [summary], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("summary") @ExcludeMissing fun _summary(): JsonField<Summary> = summary
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Reasoning]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Reasoning]. */
+        class Builder internal constructor() {
+
+            private var context: JsonField<Context> = JsonMissing.of()
+            private var effort: JsonField<Effort> = JsonMissing.of()
+            private var generateSummary: JsonField<GenerateSummary> = JsonMissing.of()
+            private var mode: JsonField<Mode> = JsonMissing.of()
+            private var summary: JsonField<Summary> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(reasoning: Reasoning) = apply {
+                context = reasoning.context
+                effort = reasoning.effort
+                generateSummary = reasoning.generateSummary
+                mode = reasoning.mode
+                summary = reasoning.summary
+                additionalProperties = reasoning.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Controls which reasoning items are rendered back to the model on later turns. When
+             * returned on a response, this is the effective reasoning context mode used for the
+             * response.
+             */
+            fun context(context: Context?) = context(JsonField.ofNullable(context))
+
+            /** Alias for calling [Builder.context] with `context.orElse(null)`. */
+            fun context(context: Optional<Context>) = context(context.getOrNull())
+
+            /**
+             * Sets [Builder.context] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.context] with a well-typed [Context] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun context(context: JsonField<Context>) = apply { this.context = context }
+
+            /**
+             * Constrains effort on reasoning for reasoning models. Currently supported values are
+             * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning
+             * effort can result in faster responses and fewer tokens used on reasoning in a
+             * response. Not all reasoning models support every value. See the
+             * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+             * model-specific support.
+             */
+            fun effort(effort: Effort?) = effort(JsonField.ofNullable(effort))
+
+            /** Alias for calling [Builder.effort] with `effort.orElse(null)`. */
+            fun effort(effort: Optional<Effort>) = effort(effort.getOrNull())
+
+            /**
+             * Sets [Builder.effort] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.effort] with a well-typed [Effort] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun effort(effort: JsonField<Effort>) = apply { this.effort = effort }
+
+            /**
+             * **Deprecated:** use `summary` instead.
+             *
+             * A summary of the reasoning performed by the model. This can be useful for debugging
+             * and understanding the model's reasoning process. One of `auto`, `concise`, or
+             * `detailed`.
+             */
+            @Deprecated("deprecated")
+            fun generateSummary(generateSummary: GenerateSummary?) =
+                generateSummary(JsonField.ofNullable(generateSummary))
+
+            /** Alias for calling [Builder.generateSummary] with `generateSummary.orElse(null)`. */
+            @Deprecated("deprecated")
+            fun generateSummary(generateSummary: Optional<GenerateSummary>) =
+                generateSummary(generateSummary.getOrNull())
+
+            /**
+             * Sets [Builder.generateSummary] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.generateSummary] with a well-typed [GenerateSummary]
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            @Deprecated("deprecated")
+            fun generateSummary(generateSummary: JsonField<GenerateSummary>) = apply {
+                this.generateSummary = generateSummary
+            }
+
+            /**
+             * Controls the reasoning execution mode for the request.
+             *
+             * When returned on a response, this is the effective execution mode.
+             */
+            fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+            /**
+             * Sets [Builder.mode] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.mode] with a well-typed [Mode] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+            /**
+             * Sets [mode] to an arbitrary [String].
+             *
+             * You should usually call [mode] with a well-typed [Mode] constant instead. This method
+             * is primarily for setting the field to an undocumented or not yet supported value.
+             */
+            fun mode(value: String) = mode(Mode.of(value))
+
+            /**
+             * A summary of the reasoning performed by the model. This can be useful for debugging
+             * and understanding the model's reasoning process. One of `auto`, `concise`, or
+             * `detailed`.
+             *
+             * `concise` is supported for `computer-use-preview` models and all reasoning models
+             * after `gpt-5`.
+             */
+            fun summary(summary: Summary?) = summary(JsonField.ofNullable(summary))
+
+            /** Alias for calling [Builder.summary] with `summary.orElse(null)`. */
+            fun summary(summary: Optional<Summary>) = summary(summary.getOrNull())
+
+            /**
+             * Sets [Builder.summary] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.summary] with a well-typed [Summary] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun summary(summary: JsonField<Summary>) = apply { this.summary = summary }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Reasoning].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Reasoning =
+                Reasoning(
+                    context,
+                    effort,
+                    generateSummary,
+                    mode,
+                    summary,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Reasoning = apply {
+            if (validated) {
+                return@apply
+            }
+
+            context().ifPresent { it.validate() }
+            effort().ifPresent { it.validate() }
+            generateSummary().ifPresent { it.validate() }
+            mode()
+            summary().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (context.asKnown().getOrNull()?.validity() ?: 0) +
+                (effort.asKnown().getOrNull()?.validity() ?: 0) +
+                (generateSummary.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (mode.asKnown().isPresent) 1 else 0) +
+                (summary.asKnown().getOrNull()?.validity() ?: 0)
+
+        /**
+         * Controls which reasoning items are rendered back to the model on later turns. When
+         * returned on a response, this is the effective reasoning context mode used for the
+         * response.
+         */
+        class Context @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmField val CURRENT_TURN = of("current_turn")
+
+                @JvmField val ALL_TURNS = of("all_turns")
+
+                @JvmStatic fun of(value: String) = Context(JsonField.of(value))
+            }
+
+            /** An enum containing [Context]'s known values. */
+            enum class Known {
+                AUTO,
+                CURRENT_TURN,
+                ALL_TURNS,
+            }
+
+            /**
+             * An enum containing [Context]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Context] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                AUTO,
+                CURRENT_TURN,
+                ALL_TURNS,
+                /**
+                 * An enum member indicating that [Context] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    AUTO -> Value.AUTO
+                    CURRENT_TURN -> Value.CURRENT_TURN
+                    ALL_TURNS -> Value.ALL_TURNS
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    AUTO -> Known.AUTO
+                    CURRENT_TURN -> Known.CURRENT_TURN
+                    ALL_TURNS -> Known.ALL_TURNS
+                    else -> throw OpenAIInvalidDataException("Unknown Context: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Context = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Context && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
+         */
+        class Effort @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val NONE = of("none")
+
+                @JvmField val MINIMAL = of("minimal")
+
+                @JvmField val LOW = of("low")
+
+                @JvmField val MEDIUM = of("medium")
+
+                @JvmField val HIGH = of("high")
+
+                @JvmField val XHIGH = of("xhigh")
+
+                @JvmField val MAX = of("max")
+
+                @JvmStatic fun of(value: String) = Effort(JsonField.of(value))
+            }
+
+            /** An enum containing [Effort]'s known values. */
+            enum class Known {
+                NONE,
+                MINIMAL,
+                LOW,
+                MEDIUM,
+                HIGH,
+                XHIGH,
+                MAX,
+            }
+
+            /**
+             * An enum containing [Effort]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Effort] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                NONE,
+                MINIMAL,
+                LOW,
+                MEDIUM,
+                HIGH,
+                XHIGH,
+                MAX,
+                /**
+                 * An enum member indicating that [Effort] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    NONE -> Value.NONE
+                    MINIMAL -> Value.MINIMAL
+                    LOW -> Value.LOW
+                    MEDIUM -> Value.MEDIUM
+                    HIGH -> Value.HIGH
+                    XHIGH -> Value.XHIGH
+                    MAX -> Value.MAX
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    NONE -> Known.NONE
+                    MINIMAL -> Known.MINIMAL
+                    LOW -> Known.LOW
+                    MEDIUM -> Known.MEDIUM
+                    HIGH -> Known.HIGH
+                    XHIGH -> Known.XHIGH
+                    MAX -> Known.MAX
+                    else -> throw OpenAIInvalidDataException("Unknown Effort: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Effort = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Effort && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * **Deprecated:** use `summary` instead.
+         *
+         * A summary of the reasoning performed by the model. This can be useful for debugging and
+         * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
+         */
+        @Deprecated("deprecated")
+        class GenerateSummary
+        @JsonCreator
+        private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmField val CONCISE = of("concise")
+
+                @JvmField val DETAILED = of("detailed")
+
+                @JvmStatic fun of(value: String) = GenerateSummary(JsonField.of(value))
+            }
+
+            /** An enum containing [GenerateSummary]'s known values. */
+            enum class Known {
+                AUTO,
+                CONCISE,
+                DETAILED,
+            }
+
+            /**
+             * An enum containing [GenerateSummary]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [GenerateSummary] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                AUTO,
+                CONCISE,
+                DETAILED,
+                /**
+                 * An enum member indicating that [GenerateSummary] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    AUTO -> Value.AUTO
+                    CONCISE -> Value.CONCISE
+                    DETAILED -> Value.DETAILED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    AUTO -> Known.AUTO
+                    CONCISE -> Known.CONCISE
+                    DETAILED -> Known.DETAILED
+                    else -> throw OpenAIInvalidDataException("Unknown GenerateSummary: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): GenerateSummary = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is GenerateSummary && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * Controls the reasoning execution mode for the request.
+         *
+         * When returned on a response, this is the effective execution mode.
+         */
+        class Mode @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val STANDARD = of("standard")
+
+                @JvmField val PRO = of("pro")
+
+                @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+            }
+
+            /** An enum containing [Mode]'s known values. */
+            enum class Known {
+                STANDARD,
+                PRO,
+            }
+
+            /**
+             * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Mode] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                STANDARD,
+                PRO,
+                /** An enum member indicating that [Mode] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    STANDARD -> Value.STANDARD
+                    PRO -> Value.PRO
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    STANDARD -> Known.STANDARD
+                    PRO -> Known.PRO
+                    else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Mode = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Mode && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * A summary of the reasoning performed by the model. This can be useful for debugging and
+         * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
+         *
+         * `concise` is supported for `computer-use-preview` models and all reasoning models after
+         * `gpt-5`.
+         */
+        class Summary @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmField val CONCISE = of("concise")
+
+                @JvmField val DETAILED = of("detailed")
+
+                @JvmStatic fun of(value: String) = Summary(JsonField.of(value))
+            }
+
+            /** An enum containing [Summary]'s known values. */
+            enum class Known {
+                AUTO,
+                CONCISE,
+                DETAILED,
+            }
+
+            /**
+             * An enum containing [Summary]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Summary] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                AUTO,
+                CONCISE,
+                DETAILED,
+                /**
+                 * An enum member indicating that [Summary] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    AUTO -> Value.AUTO
+                    CONCISE -> Value.CONCISE
+                    DETAILED -> Value.DETAILED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    AUTO -> Known.AUTO
+                    CONCISE -> Known.CONCISE
+                    DETAILED -> Known.DETAILED
+                    else -> throw OpenAIInvalidDataException("Unknown Summary: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Summary = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Summary && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Reasoning &&
+                context == other.context &&
+                effort == other.effort &&
+                generateSummary == other.generateSummary &&
+                mode == other.mode &&
+                summary == other.summary &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(context, effort, generateSummary, mode, summary, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Reasoning{context=$context, effort=$effort, generateSummary=$generateSummary, mode=$mode, summary=$summary, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Specifies the processing type used for serving the request.
+     * - If set to 'auto', then the request will be processed with the service tier configured in
+     *   the Project settings. Unless otherwise configured, the Project will use 'default'.
+     * - If set to 'default', then the request will be processed with the standard pricing and
+     *   performance for the selected model.
+     * - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
+     *   '[priority](https://openai.com/api-priority-processing/)', then the request will be
+     *   processed with the corresponding service tier.
+     * - When not set, the default behavior is 'auto'.
+     *
+     *   When the `service_tier` parameter is set, the response body will include the `service_tier`
+     *   value based on the processing mode actually used to serve the request. This response value
+     *   may be different from the value set in the parameter.
+     */
+    class ServiceTier @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val AUTO = of("auto")
+
+            @JvmField val DEFAULT = of("default")
+
+            @JvmField val FLEX = of("flex")
+
+            @JvmField val SCALE = of("scale")
+
+            @JvmField val PRIORITY = of("priority")
+
+            @JvmStatic fun of(value: String) = ServiceTier(JsonField.of(value))
+        }
+
+        /** An enum containing [ServiceTier]'s known values. */
+        enum class Known {
+            AUTO,
+            DEFAULT,
+            FLEX,
+            SCALE,
+            PRIORITY,
+        }
+
+        /**
+         * An enum containing [ServiceTier]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [ServiceTier] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            AUTO,
+            DEFAULT,
+            FLEX,
+            SCALE,
+            PRIORITY,
+            /**
+             * An enum member indicating that [ServiceTier] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                AUTO -> Value.AUTO
+                DEFAULT -> Value.DEFAULT
+                FLEX -> Value.FLEX
+                SCALE -> Value.SCALE
+                PRIORITY -> Value.PRIORITY
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                AUTO -> Known.AUTO
+                DEFAULT -> Known.DEFAULT
+                FLEX -> Known.FLEX
+                SCALE -> Known.SCALE
+                PRIORITY -> Known.PRIORITY
+                else -> throw OpenAIInvalidDataException("Unknown ServiceTier: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ServiceTier = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ServiceTier && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /**
+     * The truncation strategy to use for the model response.
+     * - `auto`: If the input to this Response exceeds the model's context window size, the model
+     *   will truncate the response to fit the context window by dropping items from the beginning
+     *   of the conversation.
+     * - `disabled` (default): If the input size will exceed the context window size for a model,
+     *   the request will fail with a 400 error.
+     */
+    class Truncation @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val AUTO = of("auto")
+
+            @JvmField val DISABLED = of("disabled")
+
+            @JvmStatic fun of(value: String) = Truncation(JsonField.of(value))
+        }
+
+        /** An enum containing [Truncation]'s known values. */
+        enum class Known {
+            AUTO,
+            DISABLED,
+        }
+
+        /**
+         * An enum containing [Truncation]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Truncation] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            AUTO,
+            DISABLED,
+            /**
+             * An enum member indicating that [Truncation] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                AUTO -> Value.AUTO
+                DISABLED -> Value.DISABLED
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                AUTO -> Known.AUTO
+                DISABLED -> Known.DISABLED
+                else -> throw OpenAIInvalidDataException("Unknown Truncation: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Truncation = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Truncation && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponse &&
+            id == other.id &&
+            createdAt == other.createdAt &&
+            error == other.error &&
+            incompleteDetails == other.incompleteDetails &&
+            instructions == other.instructions &&
+            metadata == other.metadata &&
+            model == other.model &&
+            object_ == other.object_ &&
+            output == other.output &&
+            parallelToolCalls == other.parallelToolCalls &&
+            temperature == other.temperature &&
+            toolChoice == other.toolChoice &&
+            tools == other.tools &&
+            topP == other.topP &&
+            background == other.background &&
+            completedAt == other.completedAt &&
+            conversation == other.conversation &&
+            maxOutputTokens == other.maxOutputTokens &&
+            maxToolCalls == other.maxToolCalls &&
+            moderation == other.moderation &&
+            previousResponseId == other.previousResponseId &&
+            prompt == other.prompt &&
+            promptCacheKey == other.promptCacheKey &&
+            promptCacheOptions == other.promptCacheOptions &&
+            promptCacheRetention == other.promptCacheRetention &&
+            reasoning == other.reasoning &&
+            safetyIdentifier == other.safetyIdentifier &&
+            serviceTier == other.serviceTier &&
+            status == other.status &&
+            text == other.text &&
+            topLogprobs == other.topLogprobs &&
+            truncation == other.truncation &&
+            usage == other.usage &&
+            user == other.user &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            id,
+            createdAt,
+            error,
+            incompleteDetails,
+            instructions,
+            metadata,
+            model,
+            object_,
+            output,
+            parallelToolCalls,
+            temperature,
+            toolChoice,
+            tools,
+            topP,
+            background,
+            completedAt,
+            conversation,
+            maxOutputTokens,
+            maxToolCalls,
+            moderation,
+            previousResponseId,
+            prompt,
+            promptCacheKey,
+            promptCacheOptions,
+            promptCacheRetention,
+            reasoning,
+            safetyIdentifier,
+            serviceTier,
+            status,
+            text,
+            topLogprobs,
+            truncation,
+            usage,
+            user,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponse{id=$id, createdAt=$createdAt, error=$error, incompleteDetails=$incompleteDetails, instructions=$instructions, metadata=$metadata, model=$model, object_=$object_, output=$output, parallelToolCalls=$parallelToolCalls, temperature=$temperature, toolChoice=$toolChoice, tools=$tools, topP=$topP, background=$background, completedAt=$completedAt, conversation=$conversation, maxOutputTokens=$maxOutputTokens, maxToolCalls=$maxToolCalls, moderation=$moderation, previousResponseId=$previousResponseId, prompt=$prompt, promptCacheKey=$promptCacheKey, promptCacheOptions=$promptCacheOptions, promptCacheRetention=$promptCacheRetention, reasoning=$reasoning, safetyIdentifier=$safetyIdentifier, serviceTier=$serviceTier, status=$status, text=$text, topLogprobs=$topLogprobs, truncation=$truncation, usage=$usage, user=$user, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseApplyPatchToolCall.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseApplyPatchToolCall.kt
new file mode 100644
index 000000000..2e60e727e
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseApplyPatchToolCall.kt
@@ -0,0 +1,2209 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** A tool call that applies file diffs by creating, deleting, or updating files. */
+class BetaResponseApplyPatchToolCall
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val callId: JsonField<String>,
+    private val operation: JsonField<Operation>,
+    private val status: JsonField<Status>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val caller: JsonField<Caller>,
+    private val createdBy: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("operation")
+        @ExcludeMissing
+        operation: JsonField<Operation> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+        @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
+    ) : this(id, callId, operation, status, type, agent, caller, createdBy, mutableMapOf())
+
+    /**
+     * The unique ID of the apply patch tool call. Populated when this item is returned via API.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * The unique ID of the apply patch tool call generated by the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun callId(): String = callId.getRequired("call_id")
+
+    /**
+     * One of the create_file, delete_file, or update_file operations applied via apply_patch.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun operation(): Operation = operation.getRequired("operation")
+
+    /**
+     * The status of the apply patch tool call. One of `in_progress` or `completed`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun status(): Status = status.getRequired("status")
+
+    /**
+     * The type of the item. Always `apply_patch_call`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("apply_patch_call")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<Caller> = caller.getOptional("caller")
+
+    /**
+     * The ID of the entity that created this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdBy(): Optional<String> = createdBy.getOptional("created_by")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [callId].
+     *
+     * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+    /**
+     * Returns the raw JSON value of [operation].
+     *
+     * Unlike [operation], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("operation") @ExcludeMissing fun _operation(): JsonField<Operation> = operation
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
+    /**
+     * Returns the raw JSON value of [createdBy].
+     *
+     * Unlike [createdBy], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_by") @ExcludeMissing fun _createdBy(): JsonField<String> = createdBy
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseApplyPatchToolCall].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .callId()
+         * .operation()
+         * .status()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseApplyPatchToolCall]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var callId: JsonField<String>? = null
+        private var operation: JsonField<Operation>? = null
+        private var status: JsonField<Status>? = null
+        private var type: JsonValue = JsonValue.from("apply_patch_call")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var caller: JsonField<Caller> = JsonMissing.of()
+        private var createdBy: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseApplyPatchToolCall: BetaResponseApplyPatchToolCall) = apply {
+            id = betaResponseApplyPatchToolCall.id
+            callId = betaResponseApplyPatchToolCall.callId
+            operation = betaResponseApplyPatchToolCall.operation
+            status = betaResponseApplyPatchToolCall.status
+            type = betaResponseApplyPatchToolCall.type
+            agent = betaResponseApplyPatchToolCall.agent
+            caller = betaResponseApplyPatchToolCall.caller
+            createdBy = betaResponseApplyPatchToolCall.createdBy
+            additionalProperties =
+                betaResponseApplyPatchToolCall.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * The unique ID of the apply patch tool call. Populated when this item is returned via API.
+         */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The unique ID of the apply patch tool call generated by the model. */
+        fun callId(callId: String) = callId(JsonField.of(callId))
+
+        /**
+         * Sets [Builder.callId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.callId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+        /**
+         * One of the create_file, delete_file, or update_file operations applied via apply_patch.
+         */
+        fun operation(operation: Operation) = operation(JsonField.of(operation))
+
+        /**
+         * Sets [Builder.operation] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.operation] with a well-typed [Operation] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun operation(operation: JsonField<Operation>) = apply { this.operation = operation }
+
+        /** Alias for calling [operation] with `Operation.ofCreateFile(createFile)`. */
+        fun operation(createFile: Operation.CreateFile) =
+            operation(Operation.ofCreateFile(createFile))
+
+        /** Alias for calling [operation] with `Operation.ofDeleteFile(deleteFile)`. */
+        fun operation(deleteFile: Operation.DeleteFile) =
+            operation(Operation.ofDeleteFile(deleteFile))
+
+        /**
+         * Alias for calling [operation] with the following:
+         * ```java
+         * Operation.DeleteFile.builder()
+         *     .path(path)
+         *     .build()
+         * ```
+         */
+        fun deleteFileOperation(path: String) =
+            operation(Operation.DeleteFile.builder().path(path).build())
+
+        /** Alias for calling [operation] with `Operation.ofUpdateFile(updateFile)`. */
+        fun operation(updateFile: Operation.UpdateFile) =
+            operation(Operation.ofUpdateFile(updateFile))
+
+        /** The status of the apply patch tool call. One of `in_progress` or `completed`. */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("apply_patch_call")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /** The execution context that produced this tool call. */
+        fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed [Caller] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+        /** Alias for calling [caller] with `Caller.ofDirect()`. */
+        fun callerDirect() = caller(Caller.ofDirect())
+
+        /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+        fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(Caller.Program.builder().callerId(callerId).build())
+
+        /** The ID of the entity that created this tool call. */
+        fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
+
+        /**
+         * Sets [Builder.createdBy] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdBy] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun createdBy(createdBy: JsonField<String>) = apply { this.createdBy = createdBy }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseApplyPatchToolCall].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .callId()
+         * .operation()
+         * .status()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseApplyPatchToolCall =
+            BetaResponseApplyPatchToolCall(
+                checkRequired("id", id),
+                checkRequired("callId", callId),
+                checkRequired("operation", operation),
+                checkRequired("status", status),
+                type,
+                agent,
+                caller,
+                createdBy,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseApplyPatchToolCall = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        callId()
+        operation().validate()
+        status().validate()
+        _type().let {
+            if (it != JsonValue.from("apply_patch_call")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        caller().ifPresent { it.validate() }
+        createdBy()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (if (callId.asKnown().isPresent) 1 else 0) +
+            (operation.asKnown().getOrNull()?.validity() ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("apply_patch_call")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (createdBy.asKnown().isPresent) 1 else 0)
+
+    /** One of the create_file, delete_file, or update_file operations applied via apply_patch. */
+    @JsonDeserialize(using = Operation.Deserializer::class)
+    @JsonSerialize(using = Operation.Serializer::class)
+    class Operation
+    private constructor(
+        private val createFile: CreateFile? = null,
+        private val deleteFile: DeleteFile? = null,
+        private val updateFile: UpdateFile? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** Instruction describing how to create a file via the apply_patch tool. */
+        fun createFile(): Optional<CreateFile> = Optional.ofNullable(createFile)
+
+        /** Instruction describing how to delete a file via the apply_patch tool. */
+        fun deleteFile(): Optional<DeleteFile> = Optional.ofNullable(deleteFile)
+
+        /** Instruction describing how to update a file via the apply_patch tool. */
+        fun updateFile(): Optional<UpdateFile> = Optional.ofNullable(updateFile)
+
+        fun isCreateFile(): Boolean = createFile != null
+
+        fun isDeleteFile(): Boolean = deleteFile != null
+
+        fun isUpdateFile(): Boolean = updateFile != null
+
+        /** Instruction describing how to create a file via the apply_patch tool. */
+        fun asCreateFile(): CreateFile = createFile.getOrThrow("createFile")
+
+        /** Instruction describing how to delete a file via the apply_patch tool. */
+        fun asDeleteFile(): DeleteFile = deleteFile.getOrThrow("deleteFile")
+
+        /** Instruction describing how to update a file via the apply_patch tool. */
+        fun asUpdateFile(): UpdateFile = updateFile.getOrThrow("updateFile")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = operation.accept(new Operation.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitCreateFile(CreateFile createFile) {
+         *         return Optional.of(createFile.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                createFile != null -> visitor.visitCreateFile(createFile)
+                deleteFile != null -> visitor.visitDeleteFile(deleteFile)
+                updateFile != null -> visitor.visitUpdateFile(updateFile)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Operation = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitCreateFile(createFile: CreateFile) {
+                        createFile.validate()
+                    }
+
+                    override fun visitDeleteFile(deleteFile: DeleteFile) {
+                        deleteFile.validate()
+                    }
+
+                    override fun visitUpdateFile(updateFile: UpdateFile) {
+                        updateFile.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitCreateFile(createFile: CreateFile) = createFile.validity()
+
+                    override fun visitDeleteFile(deleteFile: DeleteFile) = deleteFile.validity()
+
+                    override fun visitUpdateFile(updateFile: UpdateFile) = updateFile.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Operation &&
+                createFile == other.createFile &&
+                deleteFile == other.deleteFile &&
+                updateFile == other.updateFile
+        }
+
+        override fun hashCode(): Int = Objects.hash(createFile, deleteFile, updateFile)
+
+        override fun toString(): String =
+            when {
+                createFile != null -> "Operation{createFile=$createFile}"
+                deleteFile != null -> "Operation{deleteFile=$deleteFile}"
+                updateFile != null -> "Operation{updateFile=$updateFile}"
+                _json != null -> "Operation{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Operation")
+            }
+
+        companion object {
+
+            /** Instruction describing how to create a file via the apply_patch tool. */
+            @JvmStatic fun ofCreateFile(createFile: CreateFile) = Operation(createFile = createFile)
+
+            /** Instruction describing how to delete a file via the apply_patch tool. */
+            @JvmStatic fun ofDeleteFile(deleteFile: DeleteFile) = Operation(deleteFile = deleteFile)
+
+            /** Instruction describing how to update a file via the apply_patch tool. */
+            @JvmStatic fun ofUpdateFile(updateFile: UpdateFile) = Operation(updateFile = updateFile)
+        }
+
+        /**
+         * An interface that defines how to map each variant of [Operation] to a value of type [T].
+         */
+        interface Visitor<out T> {
+
+            /** Instruction describing how to create a file via the apply_patch tool. */
+            fun visitCreateFile(createFile: CreateFile): T
+
+            /** Instruction describing how to delete a file via the apply_patch tool. */
+            fun visitDeleteFile(deleteFile: DeleteFile): T
+
+            /** Instruction describing how to update a file via the apply_patch tool. */
+            fun visitUpdateFile(updateFile: UpdateFile): T
+
+            /**
+             * Maps an unknown variant of [Operation] to a value of type [T].
+             *
+             * An instance of [Operation] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Operation: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Operation>(Operation::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Operation {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "create_file" -> {
+                        return tryDeserialize(node, jacksonTypeRef<CreateFile>())?.let {
+                            Operation(createFile = it, _json = json)
+                        } ?: Operation(_json = json)
+                    }
+                    "delete_file" -> {
+                        return tryDeserialize(node, jacksonTypeRef<DeleteFile>())?.let {
+                            Operation(deleteFile = it, _json = json)
+                        } ?: Operation(_json = json)
+                    }
+                    "update_file" -> {
+                        return tryDeserialize(node, jacksonTypeRef<UpdateFile>())?.let {
+                            Operation(updateFile = it, _json = json)
+                        } ?: Operation(_json = json)
+                    }
+                }
+
+                return Operation(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Operation>(Operation::class) {
+
+            override fun serialize(
+                value: Operation,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.createFile != null -> generator.writeObject(value.createFile)
+                    value.deleteFile != null -> generator.writeObject(value.deleteFile)
+                    value.updateFile != null -> generator.writeObject(value.updateFile)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Operation")
+                }
+            }
+        }
+
+        /** Instruction describing how to create a file via the apply_patch tool. */
+        class CreateFile
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val diff: JsonField<String>,
+            private val path: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("diff") @ExcludeMissing diff: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("path") @ExcludeMissing path: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(diff, path, type, mutableMapOf())
+
+            /**
+             * Diff to apply.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun diff(): String = diff.getRequired("diff")
+
+            /**
+             * Path of the file to create.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun path(): String = path.getRequired("path")
+
+            /**
+             * Create a new file with the provided diff.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("create_file")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [diff].
+             *
+             * Unlike [diff], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("diff") @ExcludeMissing fun _diff(): JsonField<String> = diff
+
+            /**
+             * Returns the raw JSON value of [path].
+             *
+             * Unlike [path], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("path") @ExcludeMissing fun _path(): JsonField<String> = path
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [CreateFile].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .diff()
+                 * .path()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [CreateFile]. */
+            class Builder internal constructor() {
+
+                private var diff: JsonField<String>? = null
+                private var path: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("create_file")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(createFile: CreateFile) = apply {
+                    diff = createFile.diff
+                    path = createFile.path
+                    type = createFile.type
+                    additionalProperties = createFile.additionalProperties.toMutableMap()
+                }
+
+                /** Diff to apply. */
+                fun diff(diff: String) = diff(JsonField.of(diff))
+
+                /**
+                 * Sets [Builder.diff] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.diff] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun diff(diff: JsonField<String>) = apply { this.diff = diff }
+
+                /** Path of the file to create. */
+                fun path(path: String) = path(JsonField.of(path))
+
+                /**
+                 * Sets [Builder.path] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.path] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun path(path: JsonField<String>) = apply { this.path = path }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("create_file")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [CreateFile].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .diff()
+                 * .path()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): CreateFile =
+                    CreateFile(
+                        checkRequired("diff", diff),
+                        checkRequired("path", path),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): CreateFile = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                diff()
+                path()
+                _type().let {
+                    if (it != JsonValue.from("create_file")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (diff.asKnown().isPresent) 1 else 0) +
+                    (if (path.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("create_file")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is CreateFile &&
+                    diff == other.diff &&
+                    path == other.path &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(diff, path, type, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "CreateFile{diff=$diff, path=$path, type=$type, additionalProperties=$additionalProperties}"
+        }
+
+        /** Instruction describing how to delete a file via the apply_patch tool. */
+        class DeleteFile
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val path: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("path") @ExcludeMissing path: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(path, type, mutableMapOf())
+
+            /**
+             * Path of the file to delete.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun path(): String = path.getRequired("path")
+
+            /**
+             * Delete the specified file.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("delete_file")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [path].
+             *
+             * Unlike [path], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("path") @ExcludeMissing fun _path(): JsonField<String> = path
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [DeleteFile].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .path()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [DeleteFile]. */
+            class Builder internal constructor() {
+
+                private var path: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("delete_file")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(deleteFile: DeleteFile) = apply {
+                    path = deleteFile.path
+                    type = deleteFile.type
+                    additionalProperties = deleteFile.additionalProperties.toMutableMap()
+                }
+
+                /** Path of the file to delete. */
+                fun path(path: String) = path(JsonField.of(path))
+
+                /**
+                 * Sets [Builder.path] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.path] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun path(path: JsonField<String>) = apply { this.path = path }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("delete_file")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [DeleteFile].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .path()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): DeleteFile =
+                    DeleteFile(
+                        checkRequired("path", path),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): DeleteFile = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                path()
+                _type().let {
+                    if (it != JsonValue.from("delete_file")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (path.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("delete_file")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is DeleteFile &&
+                    path == other.path &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(path, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "DeleteFile{path=$path, type=$type, additionalProperties=$additionalProperties}"
+        }
+
+        /** Instruction describing how to update a file via the apply_patch tool. */
+        class UpdateFile
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val diff: JsonField<String>,
+            private val path: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("diff") @ExcludeMissing diff: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("path") @ExcludeMissing path: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(diff, path, type, mutableMapOf())
+
+            /**
+             * Diff to apply.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun diff(): String = diff.getRequired("diff")
+
+            /**
+             * Path of the file to update.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun path(): String = path.getRequired("path")
+
+            /**
+             * Update an existing file with the provided diff.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("update_file")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [diff].
+             *
+             * Unlike [diff], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("diff") @ExcludeMissing fun _diff(): JsonField<String> = diff
+
+            /**
+             * Returns the raw JSON value of [path].
+             *
+             * Unlike [path], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("path") @ExcludeMissing fun _path(): JsonField<String> = path
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [UpdateFile].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .diff()
+                 * .path()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [UpdateFile]. */
+            class Builder internal constructor() {
+
+                private var diff: JsonField<String>? = null
+                private var path: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("update_file")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(updateFile: UpdateFile) = apply {
+                    diff = updateFile.diff
+                    path = updateFile.path
+                    type = updateFile.type
+                    additionalProperties = updateFile.additionalProperties.toMutableMap()
+                }
+
+                /** Diff to apply. */
+                fun diff(diff: String) = diff(JsonField.of(diff))
+
+                /**
+                 * Sets [Builder.diff] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.diff] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun diff(diff: JsonField<String>) = apply { this.diff = diff }
+
+                /** Path of the file to update. */
+                fun path(path: String) = path(JsonField.of(path))
+
+                /**
+                 * Sets [Builder.path] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.path] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun path(path: JsonField<String>) = apply { this.path = path }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("update_file")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [UpdateFile].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .diff()
+                 * .path()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): UpdateFile =
+                    UpdateFile(
+                        checkRequired("diff", diff),
+                        checkRequired("path", path),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): UpdateFile = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                diff()
+                path()
+                _type().let {
+                    if (it != JsonValue.from("update_file")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (diff.asKnown().isPresent) 1 else 0) +
+                    (if (path.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("update_file")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is UpdateFile &&
+                    diff == other.diff &&
+                    path == other.path &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(diff, path, type, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "UpdateFile{diff=$diff, path=$path, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    /** The status of the apply patch tool call. One of `in_progress` or `completed`. */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            COMPLETED,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            COMPLETED,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                COMPLETED -> Value.COMPLETED
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                COMPLETED -> Known.COMPLETED
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    /** The execution context that produced this tool call. */
+    @JsonDeserialize(using = Caller.Deserializer::class)
+    @JsonSerialize(using = Caller.Serializer::class)
+    class Caller
+    private constructor(
+        private val direct: JsonValue? = null,
+        private val program: Program? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+        fun program(): Optional<Program> = Optional.ofNullable(program)
+
+        fun isDirect(): Boolean = direct != null
+
+        fun isProgram(): Boolean = program != null
+
+        fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+        fun asProgram(): Program = program.getOrThrow("program")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDirect(JsonValue direct) {
+         *         return Optional.of(direct.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                direct != null -> visitor.visitDirect(direct)
+                program != null -> visitor.visitProgram(program)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Caller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDirect(direct: JsonValue) {
+                        direct.let {
+                            if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'direct' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitProgram(program: Program) {
+                        program.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDirect(direct: JsonValue) =
+                        direct.let { if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0 }
+
+                    override fun visitProgram(program: Program) = program.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Caller && direct == other.direct && program == other.program
+        }
+
+        override fun hashCode(): Int = Objects.hash(direct, program)
+
+        override fun toString(): String =
+            when {
+                direct != null -> "Caller{direct=$direct}"
+                program != null -> "Caller{program=$program}"
+                _json != null -> "Caller{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Caller")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+            @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+        }
+
+        /** An interface that defines how to map each variant of [Caller] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitDirect(direct: JsonValue): T
+
+            fun visitProgram(program: Program): T
+
+            /**
+             * Maps an unknown variant of [Caller] to a value of type [T].
+             *
+             * An instance of [Caller] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Caller: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "direct" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Caller(direct = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                    }
+                    "program" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                            Caller(program = it, _json = json)
+                        } ?: Caller(_json = json)
+                    }
+                }
+
+                return Caller(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+            override fun serialize(
+                value: Caller,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.direct != null -> generator.writeObject(value.direct)
+                    value.program != null -> generator.writeObject(value.program)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+            }
+        }
+
+        class Program
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val callerId: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                callerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(callerId, type, mutableMapOf())
+
+            /**
+             * The call ID of the program item that produced this tool call.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun callerId(): String = callerId.getRequired("caller_id")
+
+            /**
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [callerId].
+             *
+             * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("caller_id") @ExcludeMissing fun _callerId(): JsonField<String> = callerId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Program].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Program]. */
+            class Builder internal constructor() {
+
+                private var callerId: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("program")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(program: Program) = apply {
+                    callerId = program.callerId
+                    type = program.type
+                    additionalProperties = program.additionalProperties.toMutableMap()
+                }
+
+                /** The call ID of the program item that produced this tool call. */
+                fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                /**
+                 * Sets [Builder.callerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.callerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Program].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Program =
+                    Program(
+                        checkRequired("callerId", callerId),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Program = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                callerId()
+                _type().let {
+                    if (it != JsonValue.from("program")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (callerId.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Program &&
+                    callerId == other.callerId &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(callerId, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseApplyPatchToolCall &&
+            id == other.id &&
+            callId == other.callId &&
+            operation == other.operation &&
+            status == other.status &&
+            type == other.type &&
+            agent == other.agent &&
+            caller == other.caller &&
+            createdBy == other.createdBy &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            id,
+            callId,
+            operation,
+            status,
+            type,
+            agent,
+            caller,
+            createdBy,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseApplyPatchToolCall{id=$id, callId=$callId, operation=$operation, status=$status, type=$type, agent=$agent, caller=$caller, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseApplyPatchToolCallOutput.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseApplyPatchToolCallOutput.kt
new file mode 100644
index 000000000..19619f818
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseApplyPatchToolCallOutput.kt
@@ -0,0 +1,1216 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** The output emitted by an apply patch tool call. */
+class BetaResponseApplyPatchToolCallOutput
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val callId: JsonField<String>,
+    private val status: JsonField<Status>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val caller: JsonField<Caller>,
+    private val createdBy: JsonField<String>,
+    private val output: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+        @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output") @ExcludeMissing output: JsonField<String> = JsonMissing.of(),
+    ) : this(id, callId, status, type, agent, caller, createdBy, output, mutableMapOf())
+
+    /**
+     * The unique ID of the apply patch tool call output. Populated when this item is returned via
+     * API.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * The unique ID of the apply patch tool call generated by the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun callId(): String = callId.getRequired("call_id")
+
+    /**
+     * The status of the apply patch tool call output. One of `completed` or `failed`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun status(): Status = status.getRequired("status")
+
+    /**
+     * The type of the item. Always `apply_patch_call_output`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("apply_patch_call_output")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<Caller> = caller.getOptional("caller")
+
+    /**
+     * The ID of the entity that created this tool call output.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdBy(): Optional<String> = createdBy.getOptional("created_by")
+
+    /**
+     * Optional textual output returned by the apply patch tool.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun output(): Optional<String> = output.getOptional("output")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [callId].
+     *
+     * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
+    /**
+     * Returns the raw JSON value of [createdBy].
+     *
+     * Unlike [createdBy], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_by") @ExcludeMissing fun _createdBy(): JsonField<String> = createdBy
+
+    /**
+     * Returns the raw JSON value of [output].
+     *
+     * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<String> = output
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseApplyPatchToolCallOutput].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .callId()
+         * .status()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseApplyPatchToolCallOutput]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var callId: JsonField<String>? = null
+        private var status: JsonField<Status>? = null
+        private var type: JsonValue = JsonValue.from("apply_patch_call_output")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var caller: JsonField<Caller> = JsonMissing.of()
+        private var createdBy: JsonField<String> = JsonMissing.of()
+        private var output: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseApplyPatchToolCallOutput: BetaResponseApplyPatchToolCallOutput
+        ) = apply {
+            id = betaResponseApplyPatchToolCallOutput.id
+            callId = betaResponseApplyPatchToolCallOutput.callId
+            status = betaResponseApplyPatchToolCallOutput.status
+            type = betaResponseApplyPatchToolCallOutput.type
+            agent = betaResponseApplyPatchToolCallOutput.agent
+            caller = betaResponseApplyPatchToolCallOutput.caller
+            createdBy = betaResponseApplyPatchToolCallOutput.createdBy
+            output = betaResponseApplyPatchToolCallOutput.output
+            additionalProperties =
+                betaResponseApplyPatchToolCallOutput.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * The unique ID of the apply patch tool call output. Populated when this item is returned
+         * via API.
+         */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The unique ID of the apply patch tool call generated by the model. */
+        fun callId(callId: String) = callId(JsonField.of(callId))
+
+        /**
+         * Sets [Builder.callId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.callId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+        /** The status of the apply patch tool call output. One of `completed` or `failed`. */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("apply_patch_call_output")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /** The execution context that produced this tool call. */
+        fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed [Caller] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+        /** Alias for calling [caller] with `Caller.ofDirect()`. */
+        fun callerDirect() = caller(Caller.ofDirect())
+
+        /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+        fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(Caller.Program.builder().callerId(callerId).build())
+
+        /** The ID of the entity that created this tool call output. */
+        fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
+
+        /**
+         * Sets [Builder.createdBy] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdBy] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun createdBy(createdBy: JsonField<String>) = apply { this.createdBy = createdBy }
+
+        /** Optional textual output returned by the apply patch tool. */
+        fun output(output: String?) = output(JsonField.ofNullable(output))
+
+        /** Alias for calling [Builder.output] with `output.orElse(null)`. */
+        fun output(output: Optional<String>) = output(output.getOrNull())
+
+        /**
+         * Sets [Builder.output] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.output] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun output(output: JsonField<String>) = apply { this.output = output }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseApplyPatchToolCallOutput].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .callId()
+         * .status()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseApplyPatchToolCallOutput =
+            BetaResponseApplyPatchToolCallOutput(
+                checkRequired("id", id),
+                checkRequired("callId", callId),
+                checkRequired("status", status),
+                type,
+                agent,
+                caller,
+                createdBy,
+                output,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseApplyPatchToolCallOutput = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        callId()
+        status().validate()
+        _type().let {
+            if (it != JsonValue.from("apply_patch_call_output")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        caller().ifPresent { it.validate() }
+        createdBy()
+        output()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (if (callId.asKnown().isPresent) 1 else 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("apply_patch_call_output")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (createdBy.asKnown().isPresent) 1 else 0) +
+            (if (output.asKnown().isPresent) 1 else 0)
+
+    /** The status of the apply patch tool call output. One of `completed` or `failed`. */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val FAILED = of("failed")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            COMPLETED,
+            FAILED,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            COMPLETED,
+            FAILED,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                COMPLETED -> Value.COMPLETED
+                FAILED -> Value.FAILED
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                COMPLETED -> Known.COMPLETED
+                FAILED -> Known.FAILED
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    /** The execution context that produced this tool call. */
+    @JsonDeserialize(using = Caller.Deserializer::class)
+    @JsonSerialize(using = Caller.Serializer::class)
+    class Caller
+    private constructor(
+        private val direct: JsonValue? = null,
+        private val program: Program? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+        fun program(): Optional<Program> = Optional.ofNullable(program)
+
+        fun isDirect(): Boolean = direct != null
+
+        fun isProgram(): Boolean = program != null
+
+        fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+        fun asProgram(): Program = program.getOrThrow("program")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDirect(JsonValue direct) {
+         *         return Optional.of(direct.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                direct != null -> visitor.visitDirect(direct)
+                program != null -> visitor.visitProgram(program)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Caller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDirect(direct: JsonValue) {
+                        direct.let {
+                            if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'direct' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitProgram(program: Program) {
+                        program.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDirect(direct: JsonValue) =
+                        direct.let { if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0 }
+
+                    override fun visitProgram(program: Program) = program.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Caller && direct == other.direct && program == other.program
+        }
+
+        override fun hashCode(): Int = Objects.hash(direct, program)
+
+        override fun toString(): String =
+            when {
+                direct != null -> "Caller{direct=$direct}"
+                program != null -> "Caller{program=$program}"
+                _json != null -> "Caller{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Caller")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+            @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+        }
+
+        /** An interface that defines how to map each variant of [Caller] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitDirect(direct: JsonValue): T
+
+            fun visitProgram(program: Program): T
+
+            /**
+             * Maps an unknown variant of [Caller] to a value of type [T].
+             *
+             * An instance of [Caller] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Caller: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "direct" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Caller(direct = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                    }
+                    "program" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                            Caller(program = it, _json = json)
+                        } ?: Caller(_json = json)
+                    }
+                }
+
+                return Caller(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+            override fun serialize(
+                value: Caller,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.direct != null -> generator.writeObject(value.direct)
+                    value.program != null -> generator.writeObject(value.program)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+            }
+        }
+
+        class Program
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val callerId: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                callerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(callerId, type, mutableMapOf())
+
+            /**
+             * The call ID of the program item that produced this tool call.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun callerId(): String = callerId.getRequired("caller_id")
+
+            /**
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [callerId].
+             *
+             * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("caller_id") @ExcludeMissing fun _callerId(): JsonField<String> = callerId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Program].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Program]. */
+            class Builder internal constructor() {
+
+                private var callerId: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("program")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(program: Program) = apply {
+                    callerId = program.callerId
+                    type = program.type
+                    additionalProperties = program.additionalProperties.toMutableMap()
+                }
+
+                /** The call ID of the program item that produced this tool call. */
+                fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                /**
+                 * Sets [Builder.callerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.callerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Program].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Program =
+                    Program(
+                        checkRequired("callerId", callerId),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Program = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                callerId()
+                _type().let {
+                    if (it != JsonValue.from("program")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (callerId.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Program &&
+                    callerId == other.callerId &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(callerId, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseApplyPatchToolCallOutput &&
+            id == other.id &&
+            callId == other.callId &&
+            status == other.status &&
+            type == other.type &&
+            agent == other.agent &&
+            caller == other.caller &&
+            createdBy == other.createdBy &&
+            output == other.output &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            id,
+            callId,
+            status,
+            type,
+            agent,
+            caller,
+            createdBy,
+            output,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseApplyPatchToolCallOutput{id=$id, callId=$callId, status=$status, type=$type, agent=$agent, caller=$caller, createdBy=$createdBy, output=$output, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseAudioDeltaEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseAudioDeltaEvent.kt
new file mode 100644
index 000000000..3bc5ec180
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseAudioDeltaEvent.kt
@@ -0,0 +1,475 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when there is a partial audio response. */
+class BetaResponseAudioDeltaEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val delta: JsonField<String>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("delta") @ExcludeMissing delta: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(delta, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * A chunk of Base64 encoded response audio bytes.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun delta(): String = delta.getRequired("delta")
+
+    /**
+     * A sequence number for this chunk of the stream response.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.audio.delta`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.audio.delta")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [delta].
+     *
+     * Unlike [delta], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("delta") @ExcludeMissing fun _delta(): JsonField<String> = delta
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseAudioDeltaEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .delta()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseAudioDeltaEvent]. */
+    class Builder internal constructor() {
+
+        private var delta: JsonField<String>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.audio.delta")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseAudioDeltaEvent: BetaResponseAudioDeltaEvent) = apply {
+            delta = betaResponseAudioDeltaEvent.delta
+            sequenceNumber = betaResponseAudioDeltaEvent.sequenceNumber
+            type = betaResponseAudioDeltaEvent.type
+            agent = betaResponseAudioDeltaEvent.agent
+            additionalProperties = betaResponseAudioDeltaEvent.additionalProperties.toMutableMap()
+        }
+
+        /** A chunk of Base64 encoded response audio bytes. */
+        fun delta(delta: String) = delta(JsonField.of(delta))
+
+        /**
+         * Sets [Builder.delta] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.delta] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun delta(delta: JsonField<String>) = apply { this.delta = delta }
+
+        /** A sequence number for this chunk of the stream response. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.audio.delta")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseAudioDeltaEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .delta()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseAudioDeltaEvent =
+            BetaResponseAudioDeltaEvent(
+                checkRequired("delta", delta),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseAudioDeltaEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        delta()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.audio.delta")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (delta.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.audio.delta")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseAudioDeltaEvent &&
+            delta == other.delta &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(delta, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseAudioDeltaEvent{delta=$delta, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseAudioDoneEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseAudioDoneEvent.kt
new file mode 100644
index 000000000..e6dbd1131
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseAudioDoneEvent.kt
@@ -0,0 +1,439 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when the audio response is complete. */
+class BetaResponseAudioDoneEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The sequence number of the delta.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.audio.done`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.audio.done")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseAudioDoneEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseAudioDoneEvent]. */
+    class Builder internal constructor() {
+
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.audio.done")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseAudioDoneEvent: BetaResponseAudioDoneEvent) = apply {
+            sequenceNumber = betaResponseAudioDoneEvent.sequenceNumber
+            type = betaResponseAudioDoneEvent.type
+            agent = betaResponseAudioDoneEvent.agent
+            additionalProperties = betaResponseAudioDoneEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The sequence number of the delta. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.audio.done")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseAudioDoneEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseAudioDoneEvent =
+            BetaResponseAudioDoneEvent(
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseAudioDoneEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.audio.done")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.audio.done")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseAudioDoneEvent &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseAudioDoneEvent{sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseAudioTranscriptDeltaEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseAudioTranscriptDeltaEvent.kt
new file mode 100644
index 000000000..590f84404
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseAudioTranscriptDeltaEvent.kt
@@ -0,0 +1,479 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when there is a partial transcript of audio. */
+class BetaResponseAudioTranscriptDeltaEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val delta: JsonField<String>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("delta") @ExcludeMissing delta: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(delta, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The partial transcript of the audio response.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun delta(): String = delta.getRequired("delta")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.audio.transcript.delta`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.audio.transcript.delta")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [delta].
+     *
+     * Unlike [delta], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("delta") @ExcludeMissing fun _delta(): JsonField<String> = delta
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseAudioTranscriptDeltaEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .delta()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseAudioTranscriptDeltaEvent]. */
+    class Builder internal constructor() {
+
+        private var delta: JsonField<String>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.audio.transcript.delta")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseAudioTranscriptDeltaEvent: BetaResponseAudioTranscriptDeltaEvent
+        ) = apply {
+            delta = betaResponseAudioTranscriptDeltaEvent.delta
+            sequenceNumber = betaResponseAudioTranscriptDeltaEvent.sequenceNumber
+            type = betaResponseAudioTranscriptDeltaEvent.type
+            agent = betaResponseAudioTranscriptDeltaEvent.agent
+            additionalProperties =
+                betaResponseAudioTranscriptDeltaEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The partial transcript of the audio response. */
+        fun delta(delta: String) = delta(JsonField.of(delta))
+
+        /**
+         * Sets [Builder.delta] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.delta] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun delta(delta: JsonField<String>) = apply { this.delta = delta }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.audio.transcript.delta")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseAudioTranscriptDeltaEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .delta()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseAudioTranscriptDeltaEvent =
+            BetaResponseAudioTranscriptDeltaEvent(
+                checkRequired("delta", delta),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseAudioTranscriptDeltaEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        delta()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.audio.transcript.delta")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (delta.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.audio.transcript.delta")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseAudioTranscriptDeltaEvent &&
+            delta == other.delta &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(delta, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseAudioTranscriptDeltaEvent{delta=$delta, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseAudioTranscriptDoneEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseAudioTranscriptDoneEvent.kt
new file mode 100644
index 000000000..1a9997141
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseAudioTranscriptDoneEvent.kt
@@ -0,0 +1,443 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when the full audio transcript is completed. */
+class BetaResponseAudioTranscriptDoneEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.audio.transcript.done`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.audio.transcript.done")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseAudioTranscriptDoneEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseAudioTranscriptDoneEvent]. */
+    class Builder internal constructor() {
+
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.audio.transcript.done")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseAudioTranscriptDoneEvent: BetaResponseAudioTranscriptDoneEvent
+        ) = apply {
+            sequenceNumber = betaResponseAudioTranscriptDoneEvent.sequenceNumber
+            type = betaResponseAudioTranscriptDoneEvent.type
+            agent = betaResponseAudioTranscriptDoneEvent.agent
+            additionalProperties =
+                betaResponseAudioTranscriptDoneEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.audio.transcript.done")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseAudioTranscriptDoneEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseAudioTranscriptDoneEvent =
+            BetaResponseAudioTranscriptDoneEvent(
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseAudioTranscriptDoneEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.audio.transcript.done")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.audio.transcript.done")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseAudioTranscriptDoneEvent &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseAudioTranscriptDoneEvent{sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCodeDeltaEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCodeDeltaEvent.kt
new file mode 100644
index 000000000..72ca8c0ba
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCodeDeltaEvent.kt
@@ -0,0 +1,557 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a partial code snippet is streamed by the code interpreter. */
+class BetaResponseCodeInterpreterCallCodeDeltaEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val delta: JsonField<String>,
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("delta") @ExcludeMissing delta: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(delta, itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The partial code snippet being streamed by the code interpreter.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun delta(): String = delta.getRequired("delta")
+
+    /**
+     * The unique identifier of the code interpreter tool call item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item in the response for which the code is being streamed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event, used to order streaming events.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.code_interpreter_call_code.delta`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.code_interpreter_call_code.delta")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [delta].
+     *
+     * Unlike [delta], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("delta") @ExcludeMissing fun _delta(): JsonField<String> = delta
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseCodeInterpreterCallCodeDeltaEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .delta()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseCodeInterpreterCallCodeDeltaEvent]. */
+    class Builder internal constructor() {
+
+        private var delta: JsonField<String>? = null
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.code_interpreter_call_code.delta")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseCodeInterpreterCallCodeDeltaEvent:
+                BetaResponseCodeInterpreterCallCodeDeltaEvent
+        ) = apply {
+            delta = betaResponseCodeInterpreterCallCodeDeltaEvent.delta
+            itemId = betaResponseCodeInterpreterCallCodeDeltaEvent.itemId
+            outputIndex = betaResponseCodeInterpreterCallCodeDeltaEvent.outputIndex
+            sequenceNumber = betaResponseCodeInterpreterCallCodeDeltaEvent.sequenceNumber
+            type = betaResponseCodeInterpreterCallCodeDeltaEvent.type
+            agent = betaResponseCodeInterpreterCallCodeDeltaEvent.agent
+            additionalProperties =
+                betaResponseCodeInterpreterCallCodeDeltaEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The partial code snippet being streamed by the code interpreter. */
+        fun delta(delta: String) = delta(JsonField.of(delta))
+
+        /**
+         * Sets [Builder.delta] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.delta] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun delta(delta: JsonField<String>) = apply { this.delta = delta }
+
+        /** The unique identifier of the code interpreter tool call item. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item in the response for which the code is being streamed. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event, used to order streaming events. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.code_interpreter_call_code.delta")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseCodeInterpreterCallCodeDeltaEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .delta()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseCodeInterpreterCallCodeDeltaEvent =
+            BetaResponseCodeInterpreterCallCodeDeltaEvent(
+                checkRequired("delta", delta),
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseCodeInterpreterCallCodeDeltaEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        delta()
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.code_interpreter_call_code.delta")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (delta.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.code_interpreter_call_code.delta")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseCodeInterpreterCallCodeDeltaEvent &&
+            delta == other.delta &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(delta, itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseCodeInterpreterCallCodeDeltaEvent{delta=$delta, itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCodeDoneEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCodeDoneEvent.kt
new file mode 100644
index 000000000..1c603e529
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCodeDoneEvent.kt
@@ -0,0 +1,557 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when the code snippet is finalized by the code interpreter. */
+class BetaResponseCodeInterpreterCallCodeDoneEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val code: JsonField<String>,
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("code") @ExcludeMissing code: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(code, itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The final code snippet output by the code interpreter.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun code(): String = code.getRequired("code")
+
+    /**
+     * The unique identifier of the code interpreter tool call item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item in the response for which the code is finalized.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event, used to order streaming events.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.code_interpreter_call_code.done`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.code_interpreter_call_code.done")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [code].
+     *
+     * Unlike [code], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<String> = code
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseCodeInterpreterCallCodeDoneEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .code()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseCodeInterpreterCallCodeDoneEvent]. */
+    class Builder internal constructor() {
+
+        private var code: JsonField<String>? = null
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.code_interpreter_call_code.done")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseCodeInterpreterCallCodeDoneEvent:
+                BetaResponseCodeInterpreterCallCodeDoneEvent
+        ) = apply {
+            code = betaResponseCodeInterpreterCallCodeDoneEvent.code
+            itemId = betaResponseCodeInterpreterCallCodeDoneEvent.itemId
+            outputIndex = betaResponseCodeInterpreterCallCodeDoneEvent.outputIndex
+            sequenceNumber = betaResponseCodeInterpreterCallCodeDoneEvent.sequenceNumber
+            type = betaResponseCodeInterpreterCallCodeDoneEvent.type
+            agent = betaResponseCodeInterpreterCallCodeDoneEvent.agent
+            additionalProperties =
+                betaResponseCodeInterpreterCallCodeDoneEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The final code snippet output by the code interpreter. */
+        fun code(code: String) = code(JsonField.of(code))
+
+        /**
+         * Sets [Builder.code] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.code] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun code(code: JsonField<String>) = apply { this.code = code }
+
+        /** The unique identifier of the code interpreter tool call item. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item in the response for which the code is finalized. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event, used to order streaming events. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.code_interpreter_call_code.done")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseCodeInterpreterCallCodeDoneEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .code()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseCodeInterpreterCallCodeDoneEvent =
+            BetaResponseCodeInterpreterCallCodeDoneEvent(
+                checkRequired("code", code),
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseCodeInterpreterCallCodeDoneEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        code()
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.code_interpreter_call_code.done")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (code.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.code_interpreter_call_code.done")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseCodeInterpreterCallCodeDoneEvent &&
+            code == other.code &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(code, itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseCodeInterpreterCallCodeDoneEvent{code=$code, itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCompletedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCompletedEvent.kt
new file mode 100644
index 000000000..d1cdca574
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCompletedEvent.kt
@@ -0,0 +1,525 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when the code interpreter call is completed. */
+class BetaResponseCodeInterpreterCallCompletedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The unique identifier of the code interpreter tool call item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item in the response for which the code interpreter call is
+     * completed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event, used to order streaming events.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.code_interpreter_call.completed`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.code_interpreter_call.completed")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseCodeInterpreterCallCompletedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseCodeInterpreterCallCompletedEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.code_interpreter_call.completed")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseCodeInterpreterCallCompletedEvent:
+                BetaResponseCodeInterpreterCallCompletedEvent
+        ) = apply {
+            itemId = betaResponseCodeInterpreterCallCompletedEvent.itemId
+            outputIndex = betaResponseCodeInterpreterCallCompletedEvent.outputIndex
+            sequenceNumber = betaResponseCodeInterpreterCallCompletedEvent.sequenceNumber
+            type = betaResponseCodeInterpreterCallCompletedEvent.type
+            agent = betaResponseCodeInterpreterCallCompletedEvent.agent
+            additionalProperties =
+                betaResponseCodeInterpreterCallCompletedEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The unique identifier of the code interpreter tool call item. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /**
+         * The index of the output item in the response for which the code interpreter call is
+         * completed.
+         */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event, used to order streaming events. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.code_interpreter_call.completed")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseCodeInterpreterCallCompletedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseCodeInterpreterCallCompletedEvent =
+            BetaResponseCodeInterpreterCallCompletedEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseCodeInterpreterCallCompletedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.code_interpreter_call.completed")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.code_interpreter_call.completed")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseCodeInterpreterCallCompletedEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseCodeInterpreterCallCompletedEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallInProgressEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallInProgressEvent.kt
new file mode 100644
index 000000000..857c377e4
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallInProgressEvent.kt
@@ -0,0 +1,525 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a code interpreter call is in progress. */
+class BetaResponseCodeInterpreterCallInProgressEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The unique identifier of the code interpreter tool call item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item in the response for which the code interpreter call is in
+     * progress.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event, used to order streaming events.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.code_interpreter_call.in_progress`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.code_interpreter_call.in_progress")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseCodeInterpreterCallInProgressEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseCodeInterpreterCallInProgressEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.code_interpreter_call.in_progress")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseCodeInterpreterCallInProgressEvent:
+                BetaResponseCodeInterpreterCallInProgressEvent
+        ) = apply {
+            itemId = betaResponseCodeInterpreterCallInProgressEvent.itemId
+            outputIndex = betaResponseCodeInterpreterCallInProgressEvent.outputIndex
+            sequenceNumber = betaResponseCodeInterpreterCallInProgressEvent.sequenceNumber
+            type = betaResponseCodeInterpreterCallInProgressEvent.type
+            agent = betaResponseCodeInterpreterCallInProgressEvent.agent
+            additionalProperties =
+                betaResponseCodeInterpreterCallInProgressEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The unique identifier of the code interpreter tool call item. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /**
+         * The index of the output item in the response for which the code interpreter call is in
+         * progress.
+         */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event, used to order streaming events. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.code_interpreter_call.in_progress")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseCodeInterpreterCallInProgressEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseCodeInterpreterCallInProgressEvent =
+            BetaResponseCodeInterpreterCallInProgressEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseCodeInterpreterCallInProgressEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.code_interpreter_call.in_progress")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.code_interpreter_call.in_progress")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseCodeInterpreterCallInProgressEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseCodeInterpreterCallInProgressEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallInterpretingEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallInterpretingEvent.kt
new file mode 100644
index 000000000..012f12f9a
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallInterpretingEvent.kt
@@ -0,0 +1,525 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when the code interpreter is actively interpreting the code snippet. */
+class BetaResponseCodeInterpreterCallInterpretingEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The unique identifier of the code interpreter tool call item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item in the response for which the code interpreter is interpreting
+     * code.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event, used to order streaming events.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.code_interpreter_call.interpreting`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.code_interpreter_call.interpreting")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseCodeInterpreterCallInterpretingEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseCodeInterpreterCallInterpretingEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.code_interpreter_call.interpreting")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseCodeInterpreterCallInterpretingEvent:
+                BetaResponseCodeInterpreterCallInterpretingEvent
+        ) = apply {
+            itemId = betaResponseCodeInterpreterCallInterpretingEvent.itemId
+            outputIndex = betaResponseCodeInterpreterCallInterpretingEvent.outputIndex
+            sequenceNumber = betaResponseCodeInterpreterCallInterpretingEvent.sequenceNumber
+            type = betaResponseCodeInterpreterCallInterpretingEvent.type
+            agent = betaResponseCodeInterpreterCallInterpretingEvent.agent
+            additionalProperties =
+                betaResponseCodeInterpreterCallInterpretingEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The unique identifier of the code interpreter tool call item. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /**
+         * The index of the output item in the response for which the code interpreter is
+         * interpreting code.
+         */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event, used to order streaming events. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.code_interpreter_call.interpreting")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseCodeInterpreterCallInterpretingEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseCodeInterpreterCallInterpretingEvent =
+            BetaResponseCodeInterpreterCallInterpretingEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseCodeInterpreterCallInterpretingEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.code_interpreter_call.interpreting")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.code_interpreter_call.interpreting")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseCodeInterpreterCallInterpretingEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseCodeInterpreterCallInterpretingEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterToolCall.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterToolCall.kt
new file mode 100644
index 000000000..8656ba757
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterToolCall.kt
@@ -0,0 +1,1444 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** A tool call to run code. */
+class BetaResponseCodeInterpreterToolCall
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val code: JsonField<String>,
+    private val containerId: JsonField<String>,
+    private val outputs: JsonField<List<Output>>,
+    private val status: JsonField<Status>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("code") @ExcludeMissing code: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("container_id")
+        @ExcludeMissing
+        containerId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("outputs")
+        @ExcludeMissing
+        outputs: JsonField<List<Output>> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(id, code, containerId, outputs, status, type, agent, mutableMapOf())
+
+    /**
+     * The unique ID of the code interpreter tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * The code to run, or null if not available.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun code(): Optional<String> = code.getOptional("code")
+
+    /**
+     * The ID of the container used to run the code.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun containerId(): String = containerId.getRequired("container_id")
+
+    /**
+     * The outputs generated by the code interpreter, such as logs or images. Can be null if no
+     * outputs are available.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun outputs(): Optional<List<Output>> = outputs.getOptional("outputs")
+
+    /**
+     * The status of the code interpreter tool call. Valid values are `in_progress`, `completed`,
+     * `incomplete`, `interpreting`, and `failed`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun status(): Status = status.getRequired("status")
+
+    /**
+     * The type of the code interpreter tool call. Always `code_interpreter_call`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("code_interpreter_call")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [code].
+     *
+     * Unlike [code], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<String> = code
+
+    /**
+     * Returns the raw JSON value of [containerId].
+     *
+     * Unlike [containerId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("container_id")
+    @ExcludeMissing
+    fun _containerId(): JsonField<String> = containerId
+
+    /**
+     * Returns the raw JSON value of [outputs].
+     *
+     * Unlike [outputs], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("outputs") @ExcludeMissing fun _outputs(): JsonField<List<Output>> = outputs
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseCodeInterpreterToolCall].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .code()
+         * .containerId()
+         * .outputs()
+         * .status()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseCodeInterpreterToolCall]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var code: JsonField<String>? = null
+        private var containerId: JsonField<String>? = null
+        private var outputs: JsonField<MutableList<Output>>? = null
+        private var status: JsonField<Status>? = null
+        private var type: JsonValue = JsonValue.from("code_interpreter_call")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseCodeInterpreterToolCall: BetaResponseCodeInterpreterToolCall
+        ) = apply {
+            id = betaResponseCodeInterpreterToolCall.id
+            code = betaResponseCodeInterpreterToolCall.code
+            containerId = betaResponseCodeInterpreterToolCall.containerId
+            outputs = betaResponseCodeInterpreterToolCall.outputs.map { it.toMutableList() }
+            status = betaResponseCodeInterpreterToolCall.status
+            type = betaResponseCodeInterpreterToolCall.type
+            agent = betaResponseCodeInterpreterToolCall.agent
+            additionalProperties =
+                betaResponseCodeInterpreterToolCall.additionalProperties.toMutableMap()
+        }
+
+        /** The unique ID of the code interpreter tool call. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The code to run, or null if not available. */
+        fun code(code: String?) = code(JsonField.ofNullable(code))
+
+        /** Alias for calling [Builder.code] with `code.orElse(null)`. */
+        fun code(code: Optional<String>) = code(code.getOrNull())
+
+        /**
+         * Sets [Builder.code] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.code] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun code(code: JsonField<String>) = apply { this.code = code }
+
+        /** The ID of the container used to run the code. */
+        fun containerId(containerId: String) = containerId(JsonField.of(containerId))
+
+        /**
+         * Sets [Builder.containerId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.containerId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun containerId(containerId: JsonField<String>) = apply { this.containerId = containerId }
+
+        /**
+         * The outputs generated by the code interpreter, such as logs or images. Can be null if no
+         * outputs are available.
+         */
+        fun outputs(outputs: List<Output>?) = outputs(JsonField.ofNullable(outputs))
+
+        /** Alias for calling [Builder.outputs] with `outputs.orElse(null)`. */
+        fun outputs(outputs: Optional<List<Output>>) = outputs(outputs.getOrNull())
+
+        /**
+         * Sets [Builder.outputs] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputs] with a well-typed `List<Output>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputs(outputs: JsonField<List<Output>>) = apply {
+            this.outputs = outputs.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Output] to [outputs].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addOutput(output: Output) = apply {
+            outputs =
+                (outputs ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("outputs", it).add(output)
+                }
+        }
+
+        /** Alias for calling [addOutput] with `Output.ofLogs(logs)`. */
+        fun addOutput(logs: Output.Logs) = addOutput(Output.ofLogs(logs))
+
+        /**
+         * Alias for calling [addOutput] with the following:
+         * ```java
+         * Output.Logs.builder()
+         *     .logs(logs)
+         *     .build()
+         * ```
+         */
+        fun addLogsOutput(logs: String) = addOutput(Output.Logs.builder().logs(logs).build())
+
+        /** Alias for calling [addOutput] with `Output.ofImage(image)`. */
+        fun addOutput(image: Output.Image) = addOutput(Output.ofImage(image))
+
+        /**
+         * Alias for calling [addOutput] with the following:
+         * ```java
+         * Output.Image.builder()
+         *     .url(url)
+         *     .build()
+         * ```
+         */
+        fun addImageOutput(url: String) = addOutput(Output.Image.builder().url(url).build())
+
+        /**
+         * The status of the code interpreter tool call. Valid values are `in_progress`,
+         * `completed`, `incomplete`, `interpreting`, and `failed`.
+         */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("code_interpreter_call")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseCodeInterpreterToolCall].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .code()
+         * .containerId()
+         * .outputs()
+         * .status()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseCodeInterpreterToolCall =
+            BetaResponseCodeInterpreterToolCall(
+                checkRequired("id", id),
+                checkRequired("code", code),
+                checkRequired("containerId", containerId),
+                checkRequired("outputs", outputs).map { it.toImmutable() },
+                checkRequired("status", status),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseCodeInterpreterToolCall = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        code()
+        containerId()
+        outputs().ifPresent { it.forEach { it.validate() } }
+        status().validate()
+        _type().let {
+            if (it != JsonValue.from("code_interpreter_call")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (if (code.asKnown().isPresent) 1 else 0) +
+            (if (containerId.asKnown().isPresent) 1 else 0) +
+            (outputs.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("code_interpreter_call")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The logs output from the code interpreter. */
+    @JsonDeserialize(using = Output.Deserializer::class)
+    @JsonSerialize(using = Output.Serializer::class)
+    class Output
+    private constructor(
+        private val logs: Logs? = null,
+        private val image: Image? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** The logs output from the code interpreter. */
+        fun logs(): Optional<Logs> = Optional.ofNullable(logs)
+
+        /** The image output from the code interpreter. */
+        fun image(): Optional<Image> = Optional.ofNullable(image)
+
+        fun isLogs(): Boolean = logs != null
+
+        fun isImage(): Boolean = image != null
+
+        /** The logs output from the code interpreter. */
+        fun asLogs(): Logs = logs.getOrThrow("logs")
+
+        /** The image output from the code interpreter. */
+        fun asImage(): Image = image.getOrThrow("image")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = output.accept(new Output.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitLogs(Logs logs) {
+         *         return Optional.of(logs.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                logs != null -> visitor.visitLogs(logs)
+                image != null -> visitor.visitImage(image)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Output = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitLogs(logs: Logs) {
+                        logs.validate()
+                    }
+
+                    override fun visitImage(image: Image) {
+                        image.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitLogs(logs: Logs) = logs.validity()
+
+                    override fun visitImage(image: Image) = image.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Output && logs == other.logs && image == other.image
+        }
+
+        override fun hashCode(): Int = Objects.hash(logs, image)
+
+        override fun toString(): String =
+            when {
+                logs != null -> "Output{logs=$logs}"
+                image != null -> "Output{image=$image}"
+                _json != null -> "Output{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Output")
+            }
+
+        companion object {
+
+            /** The logs output from the code interpreter. */
+            @JvmStatic fun ofLogs(logs: Logs) = Output(logs = logs)
+
+            /** The image output from the code interpreter. */
+            @JvmStatic fun ofImage(image: Image) = Output(image = image)
+        }
+
+        /** An interface that defines how to map each variant of [Output] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            /** The logs output from the code interpreter. */
+            fun visitLogs(logs: Logs): T
+
+            /** The image output from the code interpreter. */
+            fun visitImage(image: Image): T
+
+            /**
+             * Maps an unknown variant of [Output] to a value of type [T].
+             *
+             * An instance of [Output] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Output: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Output>(Output::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Output {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "logs" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Logs>())?.let {
+                            Output(logs = it, _json = json)
+                        } ?: Output(_json = json)
+                    }
+                    "image" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Image>())?.let {
+                            Output(image = it, _json = json)
+                        } ?: Output(_json = json)
+                    }
+                }
+
+                return Output(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Output>(Output::class) {
+
+            override fun serialize(
+                value: Output,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.logs != null -> generator.writeObject(value.logs)
+                    value.image != null -> generator.writeObject(value.image)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Output")
+                }
+            }
+        }
+
+        /** The logs output from the code interpreter. */
+        class Logs
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val logs: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("logs") @ExcludeMissing logs: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(logs, type, mutableMapOf())
+
+            /**
+             * The logs output from the code interpreter.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun logs(): String = logs.getRequired("logs")
+
+            /**
+             * The type of the output. Always `logs`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("logs")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [logs].
+             *
+             * Unlike [logs], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("logs") @ExcludeMissing fun _logs(): JsonField<String> = logs
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Logs].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .logs()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Logs]. */
+            class Builder internal constructor() {
+
+                private var logs: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("logs")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(logs: Logs) = apply {
+                    this.logs = logs.logs
+                    type = logs.type
+                    additionalProperties = logs.additionalProperties.toMutableMap()
+                }
+
+                /** The logs output from the code interpreter. */
+                fun logs(logs: String) = logs(JsonField.of(logs))
+
+                /**
+                 * Sets [Builder.logs] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.logs] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun logs(logs: JsonField<String>) = apply { this.logs = logs }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("logs")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Logs].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .logs()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Logs =
+                    Logs(checkRequired("logs", logs), type, additionalProperties.toMutableMap())
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Logs = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                logs()
+                _type().let {
+                    if (it != JsonValue.from("logs")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (logs.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("logs")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Logs &&
+                    logs == other.logs &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(logs, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Logs{logs=$logs, type=$type, additionalProperties=$additionalProperties}"
+        }
+
+        /** The image output from the code interpreter. */
+        class Image
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val type: JsonValue,
+            private val url: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                @JsonProperty("url") @ExcludeMissing url: JsonField<String> = JsonMissing.of(),
+            ) : this(type, url, mutableMapOf())
+
+            /**
+             * The type of the output. Always `image`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("image")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * The URL of the image output from the code interpreter.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun url(): String = url.getRequired("url")
+
+            /**
+             * Returns the raw JSON value of [url].
+             *
+             * Unlike [url], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("url") @ExcludeMissing fun _url(): JsonField<String> = url
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Image].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .url()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Image]. */
+            class Builder internal constructor() {
+
+                private var type: JsonValue = JsonValue.from("image")
+                private var url: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(image: Image) = apply {
+                    type = image.type
+                    url = image.url
+                    additionalProperties = image.additionalProperties.toMutableMap()
+                }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("image")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                /** The URL of the image output from the code interpreter. */
+                fun url(url: String) = url(JsonField.of(url))
+
+                /**
+                 * Sets [Builder.url] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.url] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun url(url: JsonField<String>) = apply { this.url = url }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Image].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .url()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Image =
+                    Image(type, checkRequired("url", url), additionalProperties.toMutableMap())
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Image = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                _type().let {
+                    if (it != JsonValue.from("image")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                url()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                type.let { if (it == JsonValue.from("image")) 1 else 0 } +
+                    (if (url.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Image &&
+                    type == other.type &&
+                    url == other.url &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(type, url, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Image{type=$type, url=$url, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    /**
+     * The status of the code interpreter tool call. Valid values are `in_progress`, `completed`,
+     * `incomplete`, `interpreting`, and `failed`.
+     */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmField val INTERPRETING = of("interpreting")
+
+            @JvmField val FAILED = of("failed")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+            INTERPRETING,
+            FAILED,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+            INTERPRETING,
+            FAILED,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                INTERPRETING -> Value.INTERPRETING
+                FAILED -> Value.FAILED
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                INTERPRETING -> Known.INTERPRETING
+                FAILED -> Known.FAILED
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseCodeInterpreterToolCall &&
+            id == other.id &&
+            code == other.code &&
+            containerId == other.containerId &&
+            outputs == other.outputs &&
+            status == other.status &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(id, code, containerId, outputs, status, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseCodeInterpreterToolCall{id=$id, code=$code, containerId=$containerId, outputs=$outputs, status=$status, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCompactionItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCompactionItem.kt
new file mode 100644
index 000000000..082a92b67
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCompactionItem.kt
@@ -0,0 +1,512 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * A compaction item generated by the
+ * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+ */
+class BetaResponseCompactionItem
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val encryptedContent: JsonField<String>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val createdBy: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("encrypted_content")
+        @ExcludeMissing
+        encryptedContent: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
+    ) : this(id, encryptedContent, type, agent, createdBy, mutableMapOf())
+
+    /**
+     * The unique ID of the compaction item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * The encrypted content that was produced by compaction.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun encryptedContent(): String = encryptedContent.getRequired("encrypted_content")
+
+    /**
+     * The type of the item. Always `compaction`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("compaction")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * The identifier of the actor that created the item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdBy(): Optional<String> = createdBy.getOptional("created_by")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [encryptedContent].
+     *
+     * Unlike [encryptedContent], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("encrypted_content")
+    @ExcludeMissing
+    fun _encryptedContent(): JsonField<String> = encryptedContent
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [createdBy].
+     *
+     * Unlike [createdBy], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_by") @ExcludeMissing fun _createdBy(): JsonField<String> = createdBy
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseCompactionItem].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .encryptedContent()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseCompactionItem]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var encryptedContent: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("compaction")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var createdBy: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseCompactionItem: BetaResponseCompactionItem) = apply {
+            id = betaResponseCompactionItem.id
+            encryptedContent = betaResponseCompactionItem.encryptedContent
+            type = betaResponseCompactionItem.type
+            agent = betaResponseCompactionItem.agent
+            createdBy = betaResponseCompactionItem.createdBy
+            additionalProperties = betaResponseCompactionItem.additionalProperties.toMutableMap()
+        }
+
+        /** The unique ID of the compaction item. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The encrypted content that was produced by compaction. */
+        fun encryptedContent(encryptedContent: String) =
+            encryptedContent(JsonField.of(encryptedContent))
+
+        /**
+         * Sets [Builder.encryptedContent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.encryptedContent] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun encryptedContent(encryptedContent: JsonField<String>) = apply {
+            this.encryptedContent = encryptedContent
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("compaction")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /** The identifier of the actor that created the item. */
+        fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
+
+        /**
+         * Sets [Builder.createdBy] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdBy] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun createdBy(createdBy: JsonField<String>) = apply { this.createdBy = createdBy }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseCompactionItem].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .encryptedContent()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseCompactionItem =
+            BetaResponseCompactionItem(
+                checkRequired("id", id),
+                checkRequired("encryptedContent", encryptedContent),
+                type,
+                agent,
+                createdBy,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseCompactionItem = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        encryptedContent()
+        _type().let {
+            if (it != JsonValue.from("compaction")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        createdBy()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (if (encryptedContent.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("compaction")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (createdBy.asKnown().isPresent) 1 else 0)
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseCompactionItem &&
+            id == other.id &&
+            encryptedContent == other.encryptedContent &&
+            type == other.type &&
+            agent == other.agent &&
+            createdBy == other.createdBy &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(id, encryptedContent, type, agent, createdBy, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseCompactionItem{id=$id, encryptedContent=$encryptedContent, type=$type, agent=$agent, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCompactionItemParam.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCompactionItemParam.kt
new file mode 100644
index 000000000..988c07979
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCompactionItemParam.kt
@@ -0,0 +1,484 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * A compaction item generated by the
+ * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+ */
+class BetaResponseCompactionItemParam
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val encryptedContent: JsonField<String>,
+    private val type: JsonValue,
+    private val id: JsonField<String>,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("encrypted_content")
+        @ExcludeMissing
+        encryptedContent: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(encryptedContent, type, id, agent, mutableMapOf())
+
+    /**
+     * The encrypted content of the compaction summary.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun encryptedContent(): String = encryptedContent.getRequired("encrypted_content")
+
+    /**
+     * The type of the item. Always `compaction`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("compaction")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The ID of the compaction item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun id(): Optional<String> = id.getOptional("id")
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [encryptedContent].
+     *
+     * Unlike [encryptedContent], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("encrypted_content")
+    @ExcludeMissing
+    fun _encryptedContent(): JsonField<String> = encryptedContent
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseCompactionItemParam].
+         *
+         * The following fields are required:
+         * ```java
+         * .encryptedContent()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseCompactionItemParam]. */
+    class Builder internal constructor() {
+
+        private var encryptedContent: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("compaction")
+        private var id: JsonField<String> = JsonMissing.of()
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseCompactionItemParam: BetaResponseCompactionItemParam) =
+            apply {
+                encryptedContent = betaResponseCompactionItemParam.encryptedContent
+                type = betaResponseCompactionItemParam.type
+                id = betaResponseCompactionItemParam.id
+                agent = betaResponseCompactionItemParam.agent
+                additionalProperties =
+                    betaResponseCompactionItemParam.additionalProperties.toMutableMap()
+            }
+
+        /** The encrypted content of the compaction summary. */
+        fun encryptedContent(encryptedContent: String) =
+            encryptedContent(JsonField.of(encryptedContent))
+
+        /**
+         * Sets [Builder.encryptedContent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.encryptedContent] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun encryptedContent(encryptedContent: JsonField<String>) = apply {
+            this.encryptedContent = encryptedContent
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("compaction")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The ID of the compaction item. */
+        fun id(id: String?) = id(JsonField.ofNullable(id))
+
+        /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+        fun id(id: Optional<String>) = id(id.getOrNull())
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseCompactionItemParam].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .encryptedContent()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseCompactionItemParam =
+            BetaResponseCompactionItemParam(
+                checkRequired("encryptedContent", encryptedContent),
+                type,
+                id,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseCompactionItemParam = apply {
+        if (validated) {
+            return@apply
+        }
+
+        encryptedContent()
+        _type().let {
+            if (it != JsonValue.from("compaction")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        id()
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (encryptedContent.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("compaction")) 1 else 0 } +
+            (if (id.asKnown().isPresent) 1 else 0) +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseCompactionItemParam &&
+            encryptedContent == other.encryptedContent &&
+            type == other.type &&
+            id == other.id &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(encryptedContent, type, id, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseCompactionItemParam{encryptedContent=$encryptedContent, type=$type, id=$id, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCompletedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCompletedEvent.kt
new file mode 100644
index 000000000..04e1cfe2d
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCompletedEvent.kt
@@ -0,0 +1,478 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when the model response is complete. */
+class BetaResponseCompletedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val response: JsonField<BetaResponse>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("response")
+        @ExcludeMissing
+        response: JsonField<BetaResponse> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(response, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * Properties of the completed response.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun response(): BetaResponse = response.getRequired("response")
+
+    /**
+     * The sequence number for this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.completed`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.completed")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [response].
+     *
+     * Unlike [response], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("response") @ExcludeMissing fun _response(): JsonField<BetaResponse> = response
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseCompletedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .response()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseCompletedEvent]. */
+    class Builder internal constructor() {
+
+        private var response: JsonField<BetaResponse>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.completed")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseCompletedEvent: BetaResponseCompletedEvent) = apply {
+            response = betaResponseCompletedEvent.response
+            sequenceNumber = betaResponseCompletedEvent.sequenceNumber
+            type = betaResponseCompletedEvent.type
+            agent = betaResponseCompletedEvent.agent
+            additionalProperties = betaResponseCompletedEvent.additionalProperties.toMutableMap()
+        }
+
+        /** Properties of the completed response. */
+        fun response(response: BetaResponse) = response(JsonField.of(response))
+
+        /**
+         * Sets [Builder.response] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.response] with a well-typed [BetaResponse] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun response(response: JsonField<BetaResponse>) = apply { this.response = response }
+
+        /** The sequence number for this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.completed")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseCompletedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .response()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseCompletedEvent =
+            BetaResponseCompletedEvent(
+                checkRequired("response", response),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseCompletedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        response().validate()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.completed")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (response.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.completed")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseCompletedEvent &&
+            response == other.response &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(response, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseCompletedEvent{response=$response, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCall.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCall.kt
new file mode 100644
index 000000000..c36ce1a46
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCall.kt
@@ -0,0 +1,1320 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * A tool call to a computer use tool. See the
+ * [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more
+ * information.
+ */
+class BetaResponseComputerToolCall
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val callId: JsonField<String>,
+    private val pendingSafetyChecks: JsonField<List<PendingSafetyCheck>>,
+    private val status: JsonField<Status>,
+    private val type: JsonField<Type>,
+    private val action: JsonField<BetaComputerAction>,
+    private val actions: JsonField<List<BetaComputerAction>>,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("pending_safety_checks")
+        @ExcludeMissing
+        pendingSafetyChecks: JsonField<List<PendingSafetyCheck>> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
+        @JsonProperty("action")
+        @ExcludeMissing
+        action: JsonField<BetaComputerAction> = JsonMissing.of(),
+        @JsonProperty("actions")
+        @ExcludeMissing
+        actions: JsonField<List<BetaComputerAction>> = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(id, callId, pendingSafetyChecks, status, type, action, actions, agent, mutableMapOf())
+
+    /**
+     * The unique ID of the computer call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * An identifier used when responding to the tool call with output.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun callId(): String = callId.getRequired("call_id")
+
+    /**
+     * The pending safety checks for the computer call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun pendingSafetyChecks(): List<PendingSafetyCheck> =
+        pendingSafetyChecks.getRequired("pending_safety_checks")
+
+    /**
+     * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+     * items are returned via API.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun status(): Status = status.getRequired("status")
+
+    /**
+     * The type of the computer call. Always `computer_call`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun type(): Type = type.getRequired("type")
+
+    /**
+     * A click action.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun action(): Optional<BetaComputerAction> = action.getOptional("action")
+
+    /**
+     * Flattened batched actions for `computer_use`. Each action includes an `type` discriminator
+     * and action-specific fields.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun actions(): Optional<List<BetaComputerAction>> = actions.getOptional("actions")
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [callId].
+     *
+     * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+    /**
+     * Returns the raw JSON value of [pendingSafetyChecks].
+     *
+     * Unlike [pendingSafetyChecks], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("pending_safety_checks")
+    @ExcludeMissing
+    fun _pendingSafetyChecks(): JsonField<List<PendingSafetyCheck>> = pendingSafetyChecks
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    /**
+     * Returns the raw JSON value of [type].
+     *
+     * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+
+    /**
+     * Returns the raw JSON value of [action].
+     *
+     * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<BetaComputerAction> = action
+
+    /**
+     * Returns the raw JSON value of [actions].
+     *
+     * Unlike [actions], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("actions")
+    @ExcludeMissing
+    fun _actions(): JsonField<List<BetaComputerAction>> = actions
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseComputerToolCall].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .callId()
+         * .pendingSafetyChecks()
+         * .status()
+         * .type()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseComputerToolCall]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var callId: JsonField<String>? = null
+        private var pendingSafetyChecks: JsonField<MutableList<PendingSafetyCheck>>? = null
+        private var status: JsonField<Status>? = null
+        private var type: JsonField<Type>? = null
+        private var action: JsonField<BetaComputerAction> = JsonMissing.of()
+        private var actions: JsonField<MutableList<BetaComputerAction>>? = null
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseComputerToolCall: BetaResponseComputerToolCall) = apply {
+            id = betaResponseComputerToolCall.id
+            callId = betaResponseComputerToolCall.callId
+            pendingSafetyChecks =
+                betaResponseComputerToolCall.pendingSafetyChecks.map { it.toMutableList() }
+            status = betaResponseComputerToolCall.status
+            type = betaResponseComputerToolCall.type
+            action = betaResponseComputerToolCall.action
+            actions = betaResponseComputerToolCall.actions.map { it.toMutableList() }
+            agent = betaResponseComputerToolCall.agent
+            additionalProperties = betaResponseComputerToolCall.additionalProperties.toMutableMap()
+        }
+
+        /** The unique ID of the computer call. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** An identifier used when responding to the tool call with output. */
+        fun callId(callId: String) = callId(JsonField.of(callId))
+
+        /**
+         * Sets [Builder.callId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.callId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+        /** The pending safety checks for the computer call. */
+        fun pendingSafetyChecks(pendingSafetyChecks: List<PendingSafetyCheck>) =
+            pendingSafetyChecks(JsonField.of(pendingSafetyChecks))
+
+        /**
+         * Sets [Builder.pendingSafetyChecks] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.pendingSafetyChecks] with a well-typed
+         * `List<PendingSafetyCheck>` value instead. This method is primarily for setting the field
+         * to an undocumented or not yet supported value.
+         */
+        fun pendingSafetyChecks(pendingSafetyChecks: JsonField<List<PendingSafetyCheck>>) = apply {
+            this.pendingSafetyChecks = pendingSafetyChecks.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [PendingSafetyCheck] to [pendingSafetyChecks].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addPendingSafetyCheck(pendingSafetyCheck: PendingSafetyCheck) = apply {
+            pendingSafetyChecks =
+                (pendingSafetyChecks ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("pendingSafetyChecks", it).add(pendingSafetyCheck)
+                }
+        }
+
+        /**
+         * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated
+         * when items are returned via API.
+         */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        /** The type of the computer call. Always `computer_call`. */
+        fun type(type: Type) = type(JsonField.of(type))
+
+        /**
+         * Sets [Builder.type] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.type] with a well-typed [Type] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun type(type: JsonField<Type>) = apply { this.type = type }
+
+        /** A click action. */
+        fun action(action: BetaComputerAction) = action(JsonField.of(action))
+
+        /**
+         * Sets [Builder.action] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.action] with a well-typed [BetaComputerAction] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun action(action: JsonField<BetaComputerAction>) = apply { this.action = action }
+
+        /** Alias for calling [action] with `BetaComputerAction.ofClick(click)`. */
+        fun action(click: BetaComputerAction.Click) = action(BetaComputerAction.ofClick(click))
+
+        /** Alias for calling [action] with `BetaComputerAction.ofDoubleClick(doubleClick)`. */
+        fun action(doubleClick: BetaComputerAction.DoubleClick) =
+            action(BetaComputerAction.ofDoubleClick(doubleClick))
+
+        /** Alias for calling [action] with `BetaComputerAction.ofDrag(drag)`. */
+        fun action(drag: BetaComputerAction.Drag) = action(BetaComputerAction.ofDrag(drag))
+
+        /**
+         * Alias for calling [action] with the following:
+         * ```java
+         * BetaComputerAction.Drag.builder()
+         *     .path(path)
+         *     .build()
+         * ```
+         */
+        fun dragAction(path: List<BetaComputerAction.Drag.Path>) =
+            action(BetaComputerAction.Drag.builder().path(path).build())
+
+        /** Alias for calling [action] with `BetaComputerAction.ofKeypress(keypress)`. */
+        fun action(keypress: BetaComputerAction.Keypress) =
+            action(BetaComputerAction.ofKeypress(keypress))
+
+        /**
+         * Alias for calling [action] with the following:
+         * ```java
+         * BetaComputerAction.Keypress.builder()
+         *     .keys(keys)
+         *     .build()
+         * ```
+         */
+        fun keypressAction(keys: List<String>) =
+            action(BetaComputerAction.Keypress.builder().keys(keys).build())
+
+        /** Alias for calling [action] with `BetaComputerAction.ofMove(move)`. */
+        fun action(move: BetaComputerAction.Move) = action(BetaComputerAction.ofMove(move))
+
+        /** Alias for calling [action] with `BetaComputerAction.ofScreenshot()`. */
+        fun actionScreenshot() = action(BetaComputerAction.ofScreenshot())
+
+        /** Alias for calling [action] with `BetaComputerAction.ofScroll(scroll)`. */
+        fun action(scroll: BetaComputerAction.Scroll) = action(BetaComputerAction.ofScroll(scroll))
+
+        /** Alias for calling [action] with `BetaComputerAction.ofType(type)`. */
+        fun action(type: BetaComputerAction.Type) = action(BetaComputerAction.ofType(type))
+
+        /**
+         * Alias for calling [action] with the following:
+         * ```java
+         * BetaComputerAction.Type.builder()
+         *     .text(text)
+         *     .build()
+         * ```
+         */
+        fun typeAction(text: String) = action(BetaComputerAction.Type.builder().text(text).build())
+
+        /** Alias for calling [action] with `BetaComputerAction.ofWait()`. */
+        fun actionWait() = action(BetaComputerAction.ofWait())
+
+        /**
+         * Flattened batched actions for `computer_use`. Each action includes an `type`
+         * discriminator and action-specific fields.
+         */
+        fun actions(actions: List<BetaComputerAction>) = actions(JsonField.of(actions))
+
+        /**
+         * Sets [Builder.actions] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.actions] with a well-typed `List<BetaComputerAction>`
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun actions(actions: JsonField<List<BetaComputerAction>>) = apply {
+            this.actions = actions.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [BetaComputerAction] to [actions].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addAction(action: BetaComputerAction) = apply {
+            actions =
+                (actions ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("actions", it).add(action)
+                }
+        }
+
+        /** Alias for calling [addAction] with `BetaComputerAction.ofClick(click)`. */
+        fun addAction(click: BetaComputerAction.Click) =
+            addAction(BetaComputerAction.ofClick(click))
+
+        /** Alias for calling [addAction] with `BetaComputerAction.ofDoubleClick(doubleClick)`. */
+        fun addAction(doubleClick: BetaComputerAction.DoubleClick) =
+            addAction(BetaComputerAction.ofDoubleClick(doubleClick))
+
+        /** Alias for calling [addAction] with `BetaComputerAction.ofDrag(drag)`. */
+        fun addAction(drag: BetaComputerAction.Drag) = addAction(BetaComputerAction.ofDrag(drag))
+
+        /**
+         * Alias for calling [addAction] with the following:
+         * ```java
+         * BetaComputerAction.Drag.builder()
+         *     .path(path)
+         *     .build()
+         * ```
+         */
+        fun addDragAction(path: List<BetaComputerAction.Drag.Path>) =
+            addAction(BetaComputerAction.Drag.builder().path(path).build())
+
+        /** Alias for calling [addAction] with `BetaComputerAction.ofKeypress(keypress)`. */
+        fun addAction(keypress: BetaComputerAction.Keypress) =
+            addAction(BetaComputerAction.ofKeypress(keypress))
+
+        /**
+         * Alias for calling [addAction] with the following:
+         * ```java
+         * BetaComputerAction.Keypress.builder()
+         *     .keys(keys)
+         *     .build()
+         * ```
+         */
+        fun addKeypressAction(keys: List<String>) =
+            addAction(BetaComputerAction.Keypress.builder().keys(keys).build())
+
+        /** Alias for calling [addAction] with `BetaComputerAction.ofMove(move)`. */
+        fun addAction(move: BetaComputerAction.Move) = addAction(BetaComputerAction.ofMove(move))
+
+        /** Alias for calling [addAction] with `BetaComputerAction.ofScreenshot()`. */
+        fun addActionScreenshot() = addAction(BetaComputerAction.ofScreenshot())
+
+        /** Alias for calling [addAction] with `BetaComputerAction.ofScroll(scroll)`. */
+        fun addAction(scroll: BetaComputerAction.Scroll) =
+            addAction(BetaComputerAction.ofScroll(scroll))
+
+        /** Alias for calling [addAction] with `BetaComputerAction.ofType(type)`. */
+        fun addAction(type: BetaComputerAction.Type) = addAction(BetaComputerAction.ofType(type))
+
+        /**
+         * Alias for calling [addAction] with the following:
+         * ```java
+         * BetaComputerAction.Type.builder()
+         *     .text(text)
+         *     .build()
+         * ```
+         */
+        fun addTypeAction(text: String) =
+            addAction(BetaComputerAction.Type.builder().text(text).build())
+
+        /** Alias for calling [addAction] with `BetaComputerAction.ofWait()`. */
+        fun addActionWait() = addAction(BetaComputerAction.ofWait())
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseComputerToolCall].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .callId()
+         * .pendingSafetyChecks()
+         * .status()
+         * .type()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseComputerToolCall =
+            BetaResponseComputerToolCall(
+                checkRequired("id", id),
+                checkRequired("callId", callId),
+                checkRequired("pendingSafetyChecks", pendingSafetyChecks).map { it.toImmutable() },
+                checkRequired("status", status),
+                checkRequired("type", type),
+                action,
+                (actions ?: JsonMissing.of()).map { it.toImmutable() },
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseComputerToolCall = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        callId()
+        pendingSafetyChecks().forEach { it.validate() }
+        status().validate()
+        type().validate()
+        action().ifPresent { it.validate() }
+        actions().ifPresent { it.forEach { it.validate() } }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (if (callId.asKnown().isPresent) 1 else 0) +
+            (pendingSafetyChecks.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            (type.asKnown().getOrNull()?.validity() ?: 0) +
+            (action.asKnown().getOrNull()?.validity() ?: 0) +
+            (actions.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** A pending safety check for the computer call. */
+    class PendingSafetyCheck
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val code: JsonField<String>,
+        private val message: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("code") @ExcludeMissing code: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("message") @ExcludeMissing message: JsonField<String> = JsonMissing.of(),
+        ) : this(id, code, message, mutableMapOf())
+
+        /**
+         * The ID of the pending safety check.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The type of the pending safety check.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun code(): Optional<String> = code.getOptional("code")
+
+        /**
+         * Details about the pending safety check.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun message(): Optional<String> = message.getOptional("message")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [code].
+         *
+         * Unlike [code], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<String> = code
+
+        /**
+         * Returns the raw JSON value of [message].
+         *
+         * Unlike [message], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("message") @ExcludeMissing fun _message(): JsonField<String> = message
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PendingSafetyCheck].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PendingSafetyCheck]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var code: JsonField<String> = JsonMissing.of()
+            private var message: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(pendingSafetyCheck: PendingSafetyCheck) = apply {
+                id = pendingSafetyCheck.id
+                code = pendingSafetyCheck.code
+                message = pendingSafetyCheck.message
+                additionalProperties = pendingSafetyCheck.additionalProperties.toMutableMap()
+            }
+
+            /** The ID of the pending safety check. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The type of the pending safety check. */
+            fun code(code: String?) = code(JsonField.ofNullable(code))
+
+            /** Alias for calling [Builder.code] with `code.orElse(null)`. */
+            fun code(code: Optional<String>) = code(code.getOrNull())
+
+            /**
+             * Sets [Builder.code] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.code] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun code(code: JsonField<String>) = apply { this.code = code }
+
+            /** Details about the pending safety check. */
+            fun message(message: String?) = message(JsonField.ofNullable(message))
+
+            /** Alias for calling [Builder.message] with `message.orElse(null)`. */
+            fun message(message: Optional<String>) = message(message.getOrNull())
+
+            /**
+             * Sets [Builder.message] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.message] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun message(message: JsonField<String>) = apply { this.message = message }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PendingSafetyCheck].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): PendingSafetyCheck =
+                PendingSafetyCheck(
+                    checkRequired("id", id),
+                    code,
+                    message,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PendingSafetyCheck = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            code()
+            message()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (code.asKnown().isPresent) 1 else 0) +
+                (if (message.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PendingSafetyCheck &&
+                id == other.id &&
+                code == other.code &&
+                message == other.message &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(id, code, message, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PendingSafetyCheck{id=$id, code=$code, message=$message, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+     * items are returned via API.
+     */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The type of the computer call. Always `computer_call`. */
+    class Type @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val COMPUTER_CALL = of("computer_call")
+
+            @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+        }
+
+        /** An enum containing [Type]'s known values. */
+        enum class Known {
+            COMPUTER_CALL
+        }
+
+        /**
+         * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Type] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            COMPUTER_CALL,
+            /** An enum member indicating that [Type] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                COMPUTER_CALL -> Value.COMPUTER_CALL
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                COMPUTER_CALL -> Known.COMPUTER_CALL
+                else -> throw OpenAIInvalidDataException("Unknown Type: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Type = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Type && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseComputerToolCall &&
+            id == other.id &&
+            callId == other.callId &&
+            pendingSafetyChecks == other.pendingSafetyChecks &&
+            status == other.status &&
+            type == other.type &&
+            action == other.action &&
+            actions == other.actions &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            id,
+            callId,
+            pendingSafetyChecks,
+            status,
+            type,
+            action,
+            actions,
+            agent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseComputerToolCall{id=$id, callId=$callId, pendingSafetyChecks=$pendingSafetyChecks, status=$status, type=$type, action=$action, actions=$actions, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallOutputItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallOutputItem.kt
new file mode 100644
index 000000000..48ffb7383
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallOutputItem.kt
@@ -0,0 +1,1073 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class BetaResponseComputerToolCallOutputItem
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val callId: JsonField<String>,
+    private val output: JsonField<BetaResponseComputerToolCallOutputScreenshot>,
+    private val status: JsonField<Status>,
+    private val type: JsonValue,
+    private val acknowledgedSafetyChecks: JsonField<List<AcknowledgedSafetyCheck>>,
+    private val agent: JsonField<Agent>,
+    private val createdBy: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output")
+        @ExcludeMissing
+        output: JsonField<BetaResponseComputerToolCallOutputScreenshot> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("acknowledged_safety_checks")
+        @ExcludeMissing
+        acknowledgedSafetyChecks: JsonField<List<AcknowledgedSafetyCheck>> = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
+    ) : this(
+        id,
+        callId,
+        output,
+        status,
+        type,
+        acknowledgedSafetyChecks,
+        agent,
+        createdBy,
+        mutableMapOf(),
+    )
+
+    /**
+     * The unique ID of the computer call tool output.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * The ID of the computer tool call that produced the output.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun callId(): String = callId.getRequired("call_id")
+
+    /**
+     * A computer screenshot image used with the computer use tool.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun output(): BetaResponseComputerToolCallOutputScreenshot = output.getRequired("output")
+
+    /**
+     * The status of the message input. One of `in_progress`, `completed`, or `incomplete`.
+     * Populated when input items are returned via API.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun status(): Status = status.getRequired("status")
+
+    /**
+     * The type of the computer tool call output. Always `computer_call_output`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("computer_call_output")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The safety checks reported by the API that have been acknowledged by the developer.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun acknowledgedSafetyChecks(): Optional<List<AcknowledgedSafetyCheck>> =
+        acknowledgedSafetyChecks.getOptional("acknowledged_safety_checks")
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * The identifier of the actor that created the item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdBy(): Optional<String> = createdBy.getOptional("created_by")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [callId].
+     *
+     * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+    /**
+     * Returns the raw JSON value of [output].
+     *
+     * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output")
+    @ExcludeMissing
+    fun _output(): JsonField<BetaResponseComputerToolCallOutputScreenshot> = output
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    /**
+     * Returns the raw JSON value of [acknowledgedSafetyChecks].
+     *
+     * Unlike [acknowledgedSafetyChecks], this method doesn't throw if the JSON field has an
+     * unexpected type.
+     */
+    @JsonProperty("acknowledged_safety_checks")
+    @ExcludeMissing
+    fun _acknowledgedSafetyChecks(): JsonField<List<AcknowledgedSafetyCheck>> =
+        acknowledgedSafetyChecks
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [createdBy].
+     *
+     * Unlike [createdBy], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_by") @ExcludeMissing fun _createdBy(): JsonField<String> = createdBy
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseComputerToolCallOutputItem].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .callId()
+         * .output()
+         * .status()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseComputerToolCallOutputItem]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var callId: JsonField<String>? = null
+        private var output: JsonField<BetaResponseComputerToolCallOutputScreenshot>? = null
+        private var status: JsonField<Status>? = null
+        private var type: JsonValue = JsonValue.from("computer_call_output")
+        private var acknowledgedSafetyChecks: JsonField<MutableList<AcknowledgedSafetyCheck>>? =
+            null
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var createdBy: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseComputerToolCallOutputItem: BetaResponseComputerToolCallOutputItem
+        ) = apply {
+            id = betaResponseComputerToolCallOutputItem.id
+            callId = betaResponseComputerToolCallOutputItem.callId
+            output = betaResponseComputerToolCallOutputItem.output
+            status = betaResponseComputerToolCallOutputItem.status
+            type = betaResponseComputerToolCallOutputItem.type
+            acknowledgedSafetyChecks =
+                betaResponseComputerToolCallOutputItem.acknowledgedSafetyChecks.map {
+                    it.toMutableList()
+                }
+            agent = betaResponseComputerToolCallOutputItem.agent
+            createdBy = betaResponseComputerToolCallOutputItem.createdBy
+            additionalProperties =
+                betaResponseComputerToolCallOutputItem.additionalProperties.toMutableMap()
+        }
+
+        /** The unique ID of the computer call tool output. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The ID of the computer tool call that produced the output. */
+        fun callId(callId: String) = callId(JsonField.of(callId))
+
+        /**
+         * Sets [Builder.callId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.callId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+        /** A computer screenshot image used with the computer use tool. */
+        fun output(output: BetaResponseComputerToolCallOutputScreenshot) =
+            output(JsonField.of(output))
+
+        /**
+         * Sets [Builder.output] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.output] with a well-typed
+         * [BetaResponseComputerToolCallOutputScreenshot] value instead. This method is primarily
+         * for setting the field to an undocumented or not yet supported value.
+         */
+        fun output(output: JsonField<BetaResponseComputerToolCallOutputScreenshot>) = apply {
+            this.output = output
+        }
+
+        /**
+         * The status of the message input. One of `in_progress`, `completed`, or `incomplete`.
+         * Populated when input items are returned via API.
+         */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("computer_call_output")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The safety checks reported by the API that have been acknowledged by the developer. */
+        fun acknowledgedSafetyChecks(acknowledgedSafetyChecks: List<AcknowledgedSafetyCheck>) =
+            acknowledgedSafetyChecks(JsonField.of(acknowledgedSafetyChecks))
+
+        /**
+         * Sets [Builder.acknowledgedSafetyChecks] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.acknowledgedSafetyChecks] with a well-typed
+         * `List<AcknowledgedSafetyCheck>` value instead. This method is primarily for setting the
+         * field to an undocumented or not yet supported value.
+         */
+        fun acknowledgedSafetyChecks(
+            acknowledgedSafetyChecks: JsonField<List<AcknowledgedSafetyCheck>>
+        ) = apply {
+            this.acknowledgedSafetyChecks = acknowledgedSafetyChecks.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [AcknowledgedSafetyCheck] to [acknowledgedSafetyChecks].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addAcknowledgedSafetyCheck(acknowledgedSafetyCheck: AcknowledgedSafetyCheck) = apply {
+            acknowledgedSafetyChecks =
+                (acknowledgedSafetyChecks ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("acknowledgedSafetyChecks", it).add(acknowledgedSafetyCheck)
+                }
+        }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /** The identifier of the actor that created the item. */
+        fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
+
+        /**
+         * Sets [Builder.createdBy] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdBy] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun createdBy(createdBy: JsonField<String>) = apply { this.createdBy = createdBy }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseComputerToolCallOutputItem].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .callId()
+         * .output()
+         * .status()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseComputerToolCallOutputItem =
+            BetaResponseComputerToolCallOutputItem(
+                checkRequired("id", id),
+                checkRequired("callId", callId),
+                checkRequired("output", output),
+                checkRequired("status", status),
+                type,
+                (acknowledgedSafetyChecks ?: JsonMissing.of()).map { it.toImmutable() },
+                agent,
+                createdBy,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseComputerToolCallOutputItem = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        callId()
+        output().validate()
+        status().validate()
+        _type().let {
+            if (it != JsonValue.from("computer_call_output")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        acknowledgedSafetyChecks().ifPresent { it.forEach { it.validate() } }
+        agent().ifPresent { it.validate() }
+        createdBy()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (if (callId.asKnown().isPresent) 1 else 0) +
+            (output.asKnown().getOrNull()?.validity() ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("computer_call_output")) 1 else 0 } +
+            (acknowledgedSafetyChecks.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (createdBy.asKnown().isPresent) 1 else 0)
+
+    /**
+     * The status of the message input. One of `in_progress`, `completed`, or `incomplete`.
+     * Populated when input items are returned via API.
+     */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmField val FAILED = of("failed")
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            COMPLETED,
+            INCOMPLETE,
+            FAILED,
+            IN_PROGRESS,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            COMPLETED,
+            INCOMPLETE,
+            FAILED,
+            IN_PROGRESS,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                FAILED -> Value.FAILED
+                IN_PROGRESS -> Value.IN_PROGRESS
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                FAILED -> Known.FAILED
+                IN_PROGRESS -> Known.IN_PROGRESS
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** A pending safety check for the computer call. */
+    class AcknowledgedSafetyCheck
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val code: JsonField<String>,
+        private val message: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("code") @ExcludeMissing code: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("message") @ExcludeMissing message: JsonField<String> = JsonMissing.of(),
+        ) : this(id, code, message, mutableMapOf())
+
+        /**
+         * The ID of the pending safety check.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The type of the pending safety check.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun code(): Optional<String> = code.getOptional("code")
+
+        /**
+         * Details about the pending safety check.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun message(): Optional<String> = message.getOptional("message")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [code].
+         *
+         * Unlike [code], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<String> = code
+
+        /**
+         * Returns the raw JSON value of [message].
+         *
+         * Unlike [message], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("message") @ExcludeMissing fun _message(): JsonField<String> = message
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [AcknowledgedSafetyCheck].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [AcknowledgedSafetyCheck]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var code: JsonField<String> = JsonMissing.of()
+            private var message: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(acknowledgedSafetyCheck: AcknowledgedSafetyCheck) = apply {
+                id = acknowledgedSafetyCheck.id
+                code = acknowledgedSafetyCheck.code
+                message = acknowledgedSafetyCheck.message
+                additionalProperties = acknowledgedSafetyCheck.additionalProperties.toMutableMap()
+            }
+
+            /** The ID of the pending safety check. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The type of the pending safety check. */
+            fun code(code: String?) = code(JsonField.ofNullable(code))
+
+            /** Alias for calling [Builder.code] with `code.orElse(null)`. */
+            fun code(code: Optional<String>) = code(code.getOrNull())
+
+            /**
+             * Sets [Builder.code] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.code] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun code(code: JsonField<String>) = apply { this.code = code }
+
+            /** Details about the pending safety check. */
+            fun message(message: String?) = message(JsonField.ofNullable(message))
+
+            /** Alias for calling [Builder.message] with `message.orElse(null)`. */
+            fun message(message: Optional<String>) = message(message.getOrNull())
+
+            /**
+             * Sets [Builder.message] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.message] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun message(message: JsonField<String>) = apply { this.message = message }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [AcknowledgedSafetyCheck].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): AcknowledgedSafetyCheck =
+                AcknowledgedSafetyCheck(
+                    checkRequired("id", id),
+                    code,
+                    message,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): AcknowledgedSafetyCheck = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            code()
+            message()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (code.asKnown().isPresent) 1 else 0) +
+                (if (message.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AcknowledgedSafetyCheck &&
+                id == other.id &&
+                code == other.code &&
+                message == other.message &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(id, code, message, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "AcknowledgedSafetyCheck{id=$id, code=$code, message=$message, additionalProperties=$additionalProperties}"
+    }
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseComputerToolCallOutputItem &&
+            id == other.id &&
+            callId == other.callId &&
+            output == other.output &&
+            status == other.status &&
+            type == other.type &&
+            acknowledgedSafetyChecks == other.acknowledgedSafetyChecks &&
+            agent == other.agent &&
+            createdBy == other.createdBy &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            id,
+            callId,
+            output,
+            status,
+            type,
+            acknowledgedSafetyChecks,
+            agent,
+            createdBy,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseComputerToolCallOutputItem{id=$id, callId=$callId, output=$output, status=$status, type=$type, acknowledgedSafetyChecks=$acknowledgedSafetyChecks, agent=$agent, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallOutputScreenshot.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallOutputScreenshot.kt
new file mode 100644
index 000000000..932707749
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallOutputScreenshot.kt
@@ -0,0 +1,251 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+
+/** A computer screenshot image used with the computer use tool. */
+class BetaResponseComputerToolCallOutputScreenshot
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonValue,
+    private val fileId: JsonField<String>,
+    private val imageUrl: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("file_id") @ExcludeMissing fileId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("image_url") @ExcludeMissing imageUrl: JsonField<String> = JsonMissing.of(),
+    ) : this(type, fileId, imageUrl, mutableMapOf())
+
+    /**
+     * Specifies the event type. For a computer screenshot, this property is always set to
+     * `computer_screenshot`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("computer_screenshot")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The identifier of an uploaded file that contains the screenshot.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun fileId(): Optional<String> = fileId.getOptional("file_id")
+
+    /**
+     * The URL of the screenshot image.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun imageUrl(): Optional<String> = imageUrl.getOptional("image_url")
+
+    /**
+     * Returns the raw JSON value of [fileId].
+     *
+     * Unlike [fileId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("file_id") @ExcludeMissing fun _fileId(): JsonField<String> = fileId
+
+    /**
+     * Returns the raw JSON value of [imageUrl].
+     *
+     * Unlike [imageUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("image_url") @ExcludeMissing fun _imageUrl(): JsonField<String> = imageUrl
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseComputerToolCallOutputScreenshot].
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseComputerToolCallOutputScreenshot]. */
+    class Builder internal constructor() {
+
+        private var type: JsonValue = JsonValue.from("computer_screenshot")
+        private var fileId: JsonField<String> = JsonMissing.of()
+        private var imageUrl: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseComputerToolCallOutputScreenshot:
+                BetaResponseComputerToolCallOutputScreenshot
+        ) = apply {
+            type = betaResponseComputerToolCallOutputScreenshot.type
+            fileId = betaResponseComputerToolCallOutputScreenshot.fileId
+            imageUrl = betaResponseComputerToolCallOutputScreenshot.imageUrl
+            additionalProperties =
+                betaResponseComputerToolCallOutputScreenshot.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("computer_screenshot")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The identifier of an uploaded file that contains the screenshot. */
+        fun fileId(fileId: String) = fileId(JsonField.of(fileId))
+
+        /**
+         * Sets [Builder.fileId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.fileId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun fileId(fileId: JsonField<String>) = apply { this.fileId = fileId }
+
+        /** The URL of the screenshot image. */
+        fun imageUrl(imageUrl: String) = imageUrl(JsonField.of(imageUrl))
+
+        /**
+         * Sets [Builder.imageUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.imageUrl] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun imageUrl(imageUrl: JsonField<String>) = apply { this.imageUrl = imageUrl }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseComputerToolCallOutputScreenshot].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): BetaResponseComputerToolCallOutputScreenshot =
+            BetaResponseComputerToolCallOutputScreenshot(
+                type,
+                fileId,
+                imageUrl,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseComputerToolCallOutputScreenshot = apply {
+        if (validated) {
+            return@apply
+        }
+
+        _type().let {
+            if (it != JsonValue.from("computer_screenshot")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        fileId()
+        imageUrl()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        type.let { if (it == JsonValue.from("computer_screenshot")) 1 else 0 } +
+            (if (fileId.asKnown().isPresent) 1 else 0) +
+            (if (imageUrl.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseComputerToolCallOutputScreenshot &&
+            type == other.type &&
+            fileId == other.fileId &&
+            imageUrl == other.imageUrl &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(type, fileId, imageUrl, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseComputerToolCallOutputScreenshot{type=$type, fileId=$fileId, imageUrl=$imageUrl, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseContainerReference.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseContainerReference.kt
new file mode 100644
index 000000000..c3c7c456e
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseContainerReference.kt
@@ -0,0 +1,227 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+
+/** Represents a container created with /v1/containers. */
+class BetaResponseContainerReference
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val containerId: JsonField<String>,
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("container_id")
+        @ExcludeMissing
+        containerId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+    ) : this(containerId, type, mutableMapOf())
+
+    /**
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun containerId(): String = containerId.getRequired("container_id")
+
+    /**
+     * The environment type. Always `container_reference`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("container_reference")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Returns the raw JSON value of [containerId].
+     *
+     * Unlike [containerId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("container_id")
+    @ExcludeMissing
+    fun _containerId(): JsonField<String> = containerId
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseContainerReference].
+         *
+         * The following fields are required:
+         * ```java
+         * .containerId()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseContainerReference]. */
+    class Builder internal constructor() {
+
+        private var containerId: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("container_reference")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseContainerReference: BetaResponseContainerReference) = apply {
+            containerId = betaResponseContainerReference.containerId
+            type = betaResponseContainerReference.type
+            additionalProperties =
+                betaResponseContainerReference.additionalProperties.toMutableMap()
+        }
+
+        fun containerId(containerId: String) = containerId(JsonField.of(containerId))
+
+        /**
+         * Sets [Builder.containerId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.containerId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun containerId(containerId: JsonField<String>) = apply { this.containerId = containerId }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("container_reference")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseContainerReference].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .containerId()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseContainerReference =
+            BetaResponseContainerReference(
+                checkRequired("containerId", containerId),
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseContainerReference = apply {
+        if (validated) {
+            return@apply
+        }
+
+        containerId()
+        _type().let {
+            if (it != JsonValue.from("container_reference")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (containerId.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("container_reference")) 1 else 0 }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseContainerReference &&
+            containerId == other.containerId &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(containerId, type, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseContainerReference{containerId=$containerId, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseContent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseContent.kt
new file mode 100644
index 000000000..06983d841
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseContent.kt
@@ -0,0 +1,600 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.allMaxBy
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+
+/** Multi-modal input and output contents. */
+@JsonDeserialize(using = BetaResponseContent.Deserializer::class)
+@JsonSerialize(using = BetaResponseContent.Serializer::class)
+class BetaResponseContent
+private constructor(
+    private val inputText: BetaResponseInputText? = null,
+    private val inputImage: BetaResponseInputImage? = null,
+    private val inputFile: BetaResponseInputFile? = null,
+    private val outputText: BetaResponseOutputText? = null,
+    private val outputRefusal: BetaResponseOutputRefusal? = null,
+    private val reasoningText: ReasoningText? = null,
+    private val _json: JsonValue? = null,
+) {
+
+    /** A text input to the model. */
+    fun inputText(): Optional<BetaResponseInputText> = Optional.ofNullable(inputText)
+
+    /**
+     * An image input to the model. Learn about
+     * [image inputs](https://platform.openai.com/docs/guides/vision).
+     */
+    fun inputImage(): Optional<BetaResponseInputImage> = Optional.ofNullable(inputImage)
+
+    /** A file input to the model. */
+    fun inputFile(): Optional<BetaResponseInputFile> = Optional.ofNullable(inputFile)
+
+    /** A text output from the model. */
+    fun outputText(): Optional<BetaResponseOutputText> = Optional.ofNullable(outputText)
+
+    /** A refusal from the model. */
+    fun outputRefusal(): Optional<BetaResponseOutputRefusal> = Optional.ofNullable(outputRefusal)
+
+    /** Reasoning text from the model. */
+    fun reasoningText(): Optional<ReasoningText> = Optional.ofNullable(reasoningText)
+
+    fun isInputText(): Boolean = inputText != null
+
+    fun isInputImage(): Boolean = inputImage != null
+
+    fun isInputFile(): Boolean = inputFile != null
+
+    fun isOutputText(): Boolean = outputText != null
+
+    fun isOutputRefusal(): Boolean = outputRefusal != null
+
+    fun isReasoningText(): Boolean = reasoningText != null
+
+    /** A text input to the model. */
+    fun asInputText(): BetaResponseInputText = inputText.getOrThrow("inputText")
+
+    /**
+     * An image input to the model. Learn about
+     * [image inputs](https://platform.openai.com/docs/guides/vision).
+     */
+    fun asInputImage(): BetaResponseInputImage = inputImage.getOrThrow("inputImage")
+
+    /** A file input to the model. */
+    fun asInputFile(): BetaResponseInputFile = inputFile.getOrThrow("inputFile")
+
+    /** A text output from the model. */
+    fun asOutputText(): BetaResponseOutputText = outputText.getOrThrow("outputText")
+
+    /** A refusal from the model. */
+    fun asOutputRefusal(): BetaResponseOutputRefusal = outputRefusal.getOrThrow("outputRefusal")
+
+    /** Reasoning text from the model. */
+    fun asReasoningText(): ReasoningText = reasoningText.getOrThrow("reasoningText")
+
+    fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+    /**
+     * Maps this instance's current variant to a value of type [T] using the given [visitor].
+     *
+     * Note that this method is _not_ forwards compatible with new variants from the API, unless
+     * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of the
+     * SDK gracefully, consider overriding [Visitor.unknown]:
+     * ```java
+     * import com.openai.core.JsonValue;
+     * import java.util.Optional;
+     *
+     * Optional<String> result = betaResponseContent.accept(new BetaResponseContent.Visitor<Optional<String>>() {
+     *     @Override
+     *     public Optional<String> visitInputText(BetaResponseInputText inputText) {
+     *         return Optional.of(inputText.toString());
+     *     }
+     *
+     *     // ...
+     *
+     *     @Override
+     *     public Optional<String> unknown(JsonValue json) {
+     *         // Or inspect the `json`.
+     *         return Optional.empty();
+     *     }
+     * });
+     * ```
+     *
+     * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor] and
+     *   the current variant is unknown.
+     */
+    fun <T> accept(visitor: Visitor<T>): T =
+        when {
+            inputText != null -> visitor.visitInputText(inputText)
+            inputImage != null -> visitor.visitInputImage(inputImage)
+            inputFile != null -> visitor.visitInputFile(inputFile)
+            outputText != null -> visitor.visitOutputText(outputText)
+            outputRefusal != null -> visitor.visitOutputRefusal(outputRefusal)
+            reasoningText != null -> visitor.visitReasoningText(reasoningText)
+            else -> visitor.unknown(_json)
+        }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseContent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        accept(
+            object : Visitor<Unit> {
+                override fun visitInputText(inputText: BetaResponseInputText) {
+                    inputText.validate()
+                }
+
+                override fun visitInputImage(inputImage: BetaResponseInputImage) {
+                    inputImage.validate()
+                }
+
+                override fun visitInputFile(inputFile: BetaResponseInputFile) {
+                    inputFile.validate()
+                }
+
+                override fun visitOutputText(outputText: BetaResponseOutputText) {
+                    outputText.validate()
+                }
+
+                override fun visitOutputRefusal(outputRefusal: BetaResponseOutputRefusal) {
+                    outputRefusal.validate()
+                }
+
+                override fun visitReasoningText(reasoningText: ReasoningText) {
+                    reasoningText.validate()
+                }
+            }
+        )
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        accept(
+            object : Visitor<Int> {
+                override fun visitInputText(inputText: BetaResponseInputText) = inputText.validity()
+
+                override fun visitInputImage(inputImage: BetaResponseInputImage) =
+                    inputImage.validity()
+
+                override fun visitInputFile(inputFile: BetaResponseInputFile) = inputFile.validity()
+
+                override fun visitOutputText(outputText: BetaResponseOutputText) =
+                    outputText.validity()
+
+                override fun visitOutputRefusal(outputRefusal: BetaResponseOutputRefusal) =
+                    outputRefusal.validity()
+
+                override fun visitReasoningText(reasoningText: ReasoningText) =
+                    reasoningText.validity()
+
+                override fun unknown(json: JsonValue?) = 0
+            }
+        )
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseContent &&
+            inputText == other.inputText &&
+            inputImage == other.inputImage &&
+            inputFile == other.inputFile &&
+            outputText == other.outputText &&
+            outputRefusal == other.outputRefusal &&
+            reasoningText == other.reasoningText
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(inputText, inputImage, inputFile, outputText, outputRefusal, reasoningText)
+
+    override fun toString(): String =
+        when {
+            inputText != null -> "BetaResponseContent{inputText=$inputText}"
+            inputImage != null -> "BetaResponseContent{inputImage=$inputImage}"
+            inputFile != null -> "BetaResponseContent{inputFile=$inputFile}"
+            outputText != null -> "BetaResponseContent{outputText=$outputText}"
+            outputRefusal != null -> "BetaResponseContent{outputRefusal=$outputRefusal}"
+            reasoningText != null -> "BetaResponseContent{reasoningText=$reasoningText}"
+            _json != null -> "BetaResponseContent{_unknown=$_json}"
+            else -> throw IllegalStateException("Invalid BetaResponseContent")
+        }
+
+    companion object {
+
+        /** A text input to the model. */
+        @JvmStatic
+        fun ofInputText(inputText: BetaResponseInputText) =
+            BetaResponseContent(inputText = inputText)
+
+        /**
+         * An image input to the model. Learn about
+         * [image inputs](https://platform.openai.com/docs/guides/vision).
+         */
+        @JvmStatic
+        fun ofInputImage(inputImage: BetaResponseInputImage) =
+            BetaResponseContent(inputImage = inputImage)
+
+        /** A file input to the model. */
+        @JvmStatic
+        fun ofInputFile(inputFile: BetaResponseInputFile) =
+            BetaResponseContent(inputFile = inputFile)
+
+        /** A text output from the model. */
+        @JvmStatic
+        fun ofOutputText(outputText: BetaResponseOutputText) =
+            BetaResponseContent(outputText = outputText)
+
+        /** A refusal from the model. */
+        @JvmStatic
+        fun ofOutputRefusal(outputRefusal: BetaResponseOutputRefusal) =
+            BetaResponseContent(outputRefusal = outputRefusal)
+
+        /** Reasoning text from the model. */
+        @JvmStatic
+        fun ofReasoningText(reasoningText: ReasoningText) =
+            BetaResponseContent(reasoningText = reasoningText)
+    }
+
+    /**
+     * An interface that defines how to map each variant of [BetaResponseContent] to a value of type
+     * [T].
+     */
+    interface Visitor<out T> {
+
+        /** A text input to the model. */
+        fun visitInputText(inputText: BetaResponseInputText): T
+
+        /**
+         * An image input to the model. Learn about
+         * [image inputs](https://platform.openai.com/docs/guides/vision).
+         */
+        fun visitInputImage(inputImage: BetaResponseInputImage): T
+
+        /** A file input to the model. */
+        fun visitInputFile(inputFile: BetaResponseInputFile): T
+
+        /** A text output from the model. */
+        fun visitOutputText(outputText: BetaResponseOutputText): T
+
+        /** A refusal from the model. */
+        fun visitOutputRefusal(outputRefusal: BetaResponseOutputRefusal): T
+
+        /** Reasoning text from the model. */
+        fun visitReasoningText(reasoningText: ReasoningText): T
+
+        /**
+         * Maps an unknown variant of [BetaResponseContent] to a value of type [T].
+         *
+         * An instance of [BetaResponseContent] can contain an unknown variant if it was
+         * deserialized from data that doesn't match any known variant. For example, if the SDK is
+         * on an older version than the API, then the API may respond with new variants that the SDK
+         * is unaware of.
+         *
+         * @throws OpenAIInvalidDataException in the default implementation.
+         */
+        fun unknown(json: JsonValue?): T {
+            throw OpenAIInvalidDataException("Unknown BetaResponseContent: $json")
+        }
+    }
+
+    internal class Deserializer :
+        BaseDeserializer<BetaResponseContent>(BetaResponseContent::class) {
+
+        override fun ObjectCodec.deserialize(node: JsonNode): BetaResponseContent {
+            val json = JsonValue.fromJsonNode(node)
+
+            val bestMatches =
+                sequenceOf(
+                        tryDeserialize(node, jacksonTypeRef<BetaResponseInputText>())?.let {
+                            BetaResponseContent(inputText = it, _json = json)
+                        },
+                        tryDeserialize(node, jacksonTypeRef<BetaResponseInputImage>())?.let {
+                            BetaResponseContent(inputImage = it, _json = json)
+                        },
+                        tryDeserialize(node, jacksonTypeRef<BetaResponseInputFile>())?.let {
+                            BetaResponseContent(inputFile = it, _json = json)
+                        },
+                        tryDeserialize(node, jacksonTypeRef<BetaResponseOutputText>())?.let {
+                            BetaResponseContent(outputText = it, _json = json)
+                        },
+                        tryDeserialize(node, jacksonTypeRef<BetaResponseOutputRefusal>())?.let {
+                            BetaResponseContent(outputRefusal = it, _json = json)
+                        },
+                        tryDeserialize(node, jacksonTypeRef<ReasoningText>())?.let {
+                            BetaResponseContent(reasoningText = it, _json = json)
+                        },
+                    )
+                    .filterNotNull()
+                    .allMaxBy { it.validity() }
+                    .toList()
+            return when (bestMatches.size) {
+                // This can happen if what we're deserializing is completely incompatible with all
+                // the possible variants (e.g. deserializing from boolean).
+                0 -> BetaResponseContent(_json = json)
+                1 -> bestMatches.single()
+                // If there's more than one match with the highest validity, then use the first
+                // completely valid match, or simply the first match if none are completely valid.
+                else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+            }
+        }
+    }
+
+    internal class Serializer : BaseSerializer<BetaResponseContent>(BetaResponseContent::class) {
+
+        override fun serialize(
+            value: BetaResponseContent,
+            generator: JsonGenerator,
+            provider: SerializerProvider,
+        ) {
+            when {
+                value.inputText != null -> generator.writeObject(value.inputText)
+                value.inputImage != null -> generator.writeObject(value.inputImage)
+                value.inputFile != null -> generator.writeObject(value.inputFile)
+                value.outputText != null -> generator.writeObject(value.outputText)
+                value.outputRefusal != null -> generator.writeObject(value.outputRefusal)
+                value.reasoningText != null -> generator.writeObject(value.reasoningText)
+                value._json != null -> generator.writeObject(value._json)
+                else -> throw IllegalStateException("Invalid BetaResponseContent")
+            }
+        }
+    }
+
+    /** Reasoning text from the model. */
+    class ReasoningText
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val text: JsonField<String>,
+        private val type: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(text, type, mutableMapOf())
+
+        /**
+         * The reasoning text from the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun text(): String = text.getRequired("text")
+
+        /**
+         * The type of the reasoning text. Always `reasoning_text`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("reasoning_text")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Returns the raw JSON value of [text].
+         *
+         * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ReasoningText].
+             *
+             * The following fields are required:
+             * ```java
+             * .text()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ReasoningText]. */
+        class Builder internal constructor() {
+
+            private var text: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("reasoning_text")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(reasoningText: ReasoningText) = apply {
+                text = reasoningText.text
+                type = reasoningText.type
+                additionalProperties = reasoningText.additionalProperties.toMutableMap()
+            }
+
+            /** The reasoning text from the model. */
+            fun text(text: String) = text(JsonField.of(text))
+
+            /**
+             * Sets [Builder.text] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.text] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun text(text: JsonField<String>) = apply { this.text = text }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("reasoning_text")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ReasoningText].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .text()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ReasoningText =
+                ReasoningText(
+                    checkRequired("text", text),
+                    type,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ReasoningText = apply {
+            if (validated) {
+                return@apply
+            }
+
+            text()
+            _type().let {
+                if (it != JsonValue.from("reasoning_text")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (text.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("reasoning_text")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ReasoningText &&
+                text == other.text &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ReasoningText{text=$text, type=$type, additionalProperties=$additionalProperties}"
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseContentPartAddedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseContentPartAddedEvent.kt
new file mode 100644
index 000000000..cfd54e24f
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseContentPartAddedEvent.kt
@@ -0,0 +1,1104 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a new content part is added. */
+class BetaResponseContentPartAddedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val contentIndex: JsonField<Long>,
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val part: JsonField<Part>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("content_index")
+        @ExcludeMissing
+        contentIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("part") @ExcludeMissing part: JsonField<Part> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(contentIndex, itemId, outputIndex, part, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The index of the content part that was added.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun contentIndex(): Long = contentIndex.getRequired("content_index")
+
+    /**
+     * The ID of the output item that the content part was added to.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item that the content part was added to.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The content part that was added.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun part(): Part = part.getRequired("part")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.content_part.added`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.content_part.added")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [contentIndex].
+     *
+     * Unlike [contentIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("content_index")
+    @ExcludeMissing
+    fun _contentIndex(): JsonField<Long> = contentIndex
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [part].
+     *
+     * Unlike [part], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("part") @ExcludeMissing fun _part(): JsonField<Part> = part
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseContentPartAddedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .contentIndex()
+         * .itemId()
+         * .outputIndex()
+         * .part()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseContentPartAddedEvent]. */
+    class Builder internal constructor() {
+
+        private var contentIndex: JsonField<Long>? = null
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var part: JsonField<Part>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.content_part.added")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseContentPartAddedEvent: BetaResponseContentPartAddedEvent) =
+            apply {
+                contentIndex = betaResponseContentPartAddedEvent.contentIndex
+                itemId = betaResponseContentPartAddedEvent.itemId
+                outputIndex = betaResponseContentPartAddedEvent.outputIndex
+                part = betaResponseContentPartAddedEvent.part
+                sequenceNumber = betaResponseContentPartAddedEvent.sequenceNumber
+                type = betaResponseContentPartAddedEvent.type
+                agent = betaResponseContentPartAddedEvent.agent
+                additionalProperties =
+                    betaResponseContentPartAddedEvent.additionalProperties.toMutableMap()
+            }
+
+        /** The index of the content part that was added. */
+        fun contentIndex(contentIndex: Long) = contentIndex(JsonField.of(contentIndex))
+
+        /**
+         * Sets [Builder.contentIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.contentIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun contentIndex(contentIndex: JsonField<Long>) = apply { this.contentIndex = contentIndex }
+
+        /** The ID of the output item that the content part was added to. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item that the content part was added to. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The content part that was added. */
+        fun part(part: Part) = part(JsonField.of(part))
+
+        /**
+         * Sets [Builder.part] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.part] with a well-typed [Part] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun part(part: JsonField<Part>) = apply { this.part = part }
+
+        /** Alias for calling [part] with `Part.ofOutputText(outputText)`. */
+        fun part(outputText: BetaResponseOutputText) = part(Part.ofOutputText(outputText))
+
+        /** Alias for calling [part] with `Part.ofRefusal(refusal)`. */
+        fun part(refusal: BetaResponseOutputRefusal) = part(Part.ofRefusal(refusal))
+
+        /**
+         * Alias for calling [part] with the following:
+         * ```java
+         * BetaResponseOutputRefusal.builder()
+         *     .refusal(refusal)
+         *     .build()
+         * ```
+         */
+        fun refusalPart(refusal: String) =
+            part(BetaResponseOutputRefusal.builder().refusal(refusal).build())
+
+        /** Alias for calling [part] with `Part.ofReasoningText(reasoningText)`. */
+        fun part(reasoningText: Part.ReasoningText) = part(Part.ofReasoningText(reasoningText))
+
+        /**
+         * Alias for calling [part] with the following:
+         * ```java
+         * Part.ReasoningText.builder()
+         *     .text(text)
+         *     .build()
+         * ```
+         */
+        fun reasoningTextPart(text: String) = part(Part.ReasoningText.builder().text(text).build())
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.content_part.added")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseContentPartAddedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .contentIndex()
+         * .itemId()
+         * .outputIndex()
+         * .part()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseContentPartAddedEvent =
+            BetaResponseContentPartAddedEvent(
+                checkRequired("contentIndex", contentIndex),
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("part", part),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseContentPartAddedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        contentIndex()
+        itemId()
+        outputIndex()
+        part().validate()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.content_part.added")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (contentIndex.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (part.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.content_part.added")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The content part that was added. */
+    @JsonDeserialize(using = Part.Deserializer::class)
+    @JsonSerialize(using = Part.Serializer::class)
+    class Part
+    private constructor(
+        private val outputText: BetaResponseOutputText? = null,
+        private val refusal: BetaResponseOutputRefusal? = null,
+        private val reasoningText: ReasoningText? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** A text output from the model. */
+        fun outputText(): Optional<BetaResponseOutputText> = Optional.ofNullable(outputText)
+
+        /** A refusal from the model. */
+        fun refusal(): Optional<BetaResponseOutputRefusal> = Optional.ofNullable(refusal)
+
+        /** Reasoning text from the model. */
+        fun reasoningText(): Optional<ReasoningText> = Optional.ofNullable(reasoningText)
+
+        fun isOutputText(): Boolean = outputText != null
+
+        fun isRefusal(): Boolean = refusal != null
+
+        fun isReasoningText(): Boolean = reasoningText != null
+
+        /** A text output from the model. */
+        fun asOutputText(): BetaResponseOutputText = outputText.getOrThrow("outputText")
+
+        /** A refusal from the model. */
+        fun asRefusal(): BetaResponseOutputRefusal = refusal.getOrThrow("refusal")
+
+        /** Reasoning text from the model. */
+        fun asReasoningText(): ReasoningText = reasoningText.getOrThrow("reasoningText")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = part.accept(new Part.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitOutputText(BetaResponseOutputText outputText) {
+         *         return Optional.of(outputText.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                outputText != null -> visitor.visitOutputText(outputText)
+                refusal != null -> visitor.visitRefusal(refusal)
+                reasoningText != null -> visitor.visitReasoningText(reasoningText)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Part = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitOutputText(outputText: BetaResponseOutputText) {
+                        outputText.validate()
+                    }
+
+                    override fun visitRefusal(refusal: BetaResponseOutputRefusal) {
+                        refusal.validate()
+                    }
+
+                    override fun visitReasoningText(reasoningText: ReasoningText) {
+                        reasoningText.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitOutputText(outputText: BetaResponseOutputText) =
+                        outputText.validity()
+
+                    override fun visitRefusal(refusal: BetaResponseOutputRefusal) =
+                        refusal.validity()
+
+                    override fun visitReasoningText(reasoningText: ReasoningText) =
+                        reasoningText.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Part &&
+                outputText == other.outputText &&
+                refusal == other.refusal &&
+                reasoningText == other.reasoningText
+        }
+
+        override fun hashCode(): Int = Objects.hash(outputText, refusal, reasoningText)
+
+        override fun toString(): String =
+            when {
+                outputText != null -> "Part{outputText=$outputText}"
+                refusal != null -> "Part{refusal=$refusal}"
+                reasoningText != null -> "Part{reasoningText=$reasoningText}"
+                _json != null -> "Part{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Part")
+            }
+
+        companion object {
+
+            /** A text output from the model. */
+            @JvmStatic
+            fun ofOutputText(outputText: BetaResponseOutputText) = Part(outputText = outputText)
+
+            /** A refusal from the model. */
+            @JvmStatic fun ofRefusal(refusal: BetaResponseOutputRefusal) = Part(refusal = refusal)
+
+            /** Reasoning text from the model. */
+            @JvmStatic
+            fun ofReasoningText(reasoningText: ReasoningText) = Part(reasoningText = reasoningText)
+        }
+
+        /** An interface that defines how to map each variant of [Part] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            /** A text output from the model. */
+            fun visitOutputText(outputText: BetaResponseOutputText): T
+
+            /** A refusal from the model. */
+            fun visitRefusal(refusal: BetaResponseOutputRefusal): T
+
+            /** Reasoning text from the model. */
+            fun visitReasoningText(reasoningText: ReasoningText): T
+
+            /**
+             * Maps an unknown variant of [Part] to a value of type [T].
+             *
+             * An instance of [Part] can contain an unknown variant if it was deserialized from data
+             * that doesn't match any known variant. For example, if the SDK is on an older version
+             * than the API, then the API may respond with new variants that the SDK is unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Part: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Part>(Part::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Part {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "output_text" -> {
+                        return tryDeserialize(node, jacksonTypeRef<BetaResponseOutputText>())?.let {
+                            Part(outputText = it, _json = json)
+                        } ?: Part(_json = json)
+                    }
+                    "refusal" -> {
+                        return tryDeserialize(node, jacksonTypeRef<BetaResponseOutputRefusal>())
+                            ?.let { Part(refusal = it, _json = json) } ?: Part(_json = json)
+                    }
+                    "reasoning_text" -> {
+                        return tryDeserialize(node, jacksonTypeRef<ReasoningText>())?.let {
+                            Part(reasoningText = it, _json = json)
+                        } ?: Part(_json = json)
+                    }
+                }
+
+                return Part(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Part>(Part::class) {
+
+            override fun serialize(
+                value: Part,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.outputText != null -> generator.writeObject(value.outputText)
+                    value.refusal != null -> generator.writeObject(value.refusal)
+                    value.reasoningText != null -> generator.writeObject(value.reasoningText)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Part")
+                }
+            }
+        }
+
+        /** Reasoning text from the model. */
+        class ReasoningText
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val text: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(text, type, mutableMapOf())
+
+            /**
+             * The reasoning text from the model.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun text(): String = text.getRequired("text")
+
+            /**
+             * The type of the reasoning text. Always `reasoning_text`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("reasoning_text")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [text].
+             *
+             * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [ReasoningText].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .text()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [ReasoningText]. */
+            class Builder internal constructor() {
+
+                private var text: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("reasoning_text")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(reasoningText: ReasoningText) = apply {
+                    text = reasoningText.text
+                    type = reasoningText.type
+                    additionalProperties = reasoningText.additionalProperties.toMutableMap()
+                }
+
+                /** The reasoning text from the model. */
+                fun text(text: String) = text(JsonField.of(text))
+
+                /**
+                 * Sets [Builder.text] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.text] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun text(text: JsonField<String>) = apply { this.text = text }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("reasoning_text")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [ReasoningText].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .text()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): ReasoningText =
+                    ReasoningText(
+                        checkRequired("text", text),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): ReasoningText = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                text()
+                _type().let {
+                    if (it != JsonValue.from("reasoning_text")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (text.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("reasoning_text")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is ReasoningText &&
+                    text == other.text &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "ReasoningText{text=$text, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseContentPartAddedEvent &&
+            contentIndex == other.contentIndex &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            part == other.part &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            contentIndex,
+            itemId,
+            outputIndex,
+            part,
+            sequenceNumber,
+            type,
+            agent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseContentPartAddedEvent{contentIndex=$contentIndex, itemId=$itemId, outputIndex=$outputIndex, part=$part, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseContentPartDoneEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseContentPartDoneEvent.kt
new file mode 100644
index 000000000..ecabde794
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseContentPartDoneEvent.kt
@@ -0,0 +1,1104 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a content part is done. */
+class BetaResponseContentPartDoneEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val contentIndex: JsonField<Long>,
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val part: JsonField<Part>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("content_index")
+        @ExcludeMissing
+        contentIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("part") @ExcludeMissing part: JsonField<Part> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(contentIndex, itemId, outputIndex, part, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The index of the content part that is done.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun contentIndex(): Long = contentIndex.getRequired("content_index")
+
+    /**
+     * The ID of the output item that the content part was added to.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item that the content part was added to.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The content part that is done.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun part(): Part = part.getRequired("part")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.content_part.done`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.content_part.done")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [contentIndex].
+     *
+     * Unlike [contentIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("content_index")
+    @ExcludeMissing
+    fun _contentIndex(): JsonField<Long> = contentIndex
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [part].
+     *
+     * Unlike [part], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("part") @ExcludeMissing fun _part(): JsonField<Part> = part
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseContentPartDoneEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .contentIndex()
+         * .itemId()
+         * .outputIndex()
+         * .part()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseContentPartDoneEvent]. */
+    class Builder internal constructor() {
+
+        private var contentIndex: JsonField<Long>? = null
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var part: JsonField<Part>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.content_part.done")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseContentPartDoneEvent: BetaResponseContentPartDoneEvent) =
+            apply {
+                contentIndex = betaResponseContentPartDoneEvent.contentIndex
+                itemId = betaResponseContentPartDoneEvent.itemId
+                outputIndex = betaResponseContentPartDoneEvent.outputIndex
+                part = betaResponseContentPartDoneEvent.part
+                sequenceNumber = betaResponseContentPartDoneEvent.sequenceNumber
+                type = betaResponseContentPartDoneEvent.type
+                agent = betaResponseContentPartDoneEvent.agent
+                additionalProperties =
+                    betaResponseContentPartDoneEvent.additionalProperties.toMutableMap()
+            }
+
+        /** The index of the content part that is done. */
+        fun contentIndex(contentIndex: Long) = contentIndex(JsonField.of(contentIndex))
+
+        /**
+         * Sets [Builder.contentIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.contentIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun contentIndex(contentIndex: JsonField<Long>) = apply { this.contentIndex = contentIndex }
+
+        /** The ID of the output item that the content part was added to. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item that the content part was added to. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The content part that is done. */
+        fun part(part: Part) = part(JsonField.of(part))
+
+        /**
+         * Sets [Builder.part] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.part] with a well-typed [Part] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun part(part: JsonField<Part>) = apply { this.part = part }
+
+        /** Alias for calling [part] with `Part.ofOutputText(outputText)`. */
+        fun part(outputText: BetaResponseOutputText) = part(Part.ofOutputText(outputText))
+
+        /** Alias for calling [part] with `Part.ofRefusal(refusal)`. */
+        fun part(refusal: BetaResponseOutputRefusal) = part(Part.ofRefusal(refusal))
+
+        /**
+         * Alias for calling [part] with the following:
+         * ```java
+         * BetaResponseOutputRefusal.builder()
+         *     .refusal(refusal)
+         *     .build()
+         * ```
+         */
+        fun refusalPart(refusal: String) =
+            part(BetaResponseOutputRefusal.builder().refusal(refusal).build())
+
+        /** Alias for calling [part] with `Part.ofReasoningText(reasoningText)`. */
+        fun part(reasoningText: Part.ReasoningText) = part(Part.ofReasoningText(reasoningText))
+
+        /**
+         * Alias for calling [part] with the following:
+         * ```java
+         * Part.ReasoningText.builder()
+         *     .text(text)
+         *     .build()
+         * ```
+         */
+        fun reasoningTextPart(text: String) = part(Part.ReasoningText.builder().text(text).build())
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.content_part.done")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseContentPartDoneEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .contentIndex()
+         * .itemId()
+         * .outputIndex()
+         * .part()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseContentPartDoneEvent =
+            BetaResponseContentPartDoneEvent(
+                checkRequired("contentIndex", contentIndex),
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("part", part),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseContentPartDoneEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        contentIndex()
+        itemId()
+        outputIndex()
+        part().validate()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.content_part.done")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (contentIndex.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (part.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.content_part.done")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The content part that is done. */
+    @JsonDeserialize(using = Part.Deserializer::class)
+    @JsonSerialize(using = Part.Serializer::class)
+    class Part
+    private constructor(
+        private val outputText: BetaResponseOutputText? = null,
+        private val refusal: BetaResponseOutputRefusal? = null,
+        private val reasoningText: ReasoningText? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** A text output from the model. */
+        fun outputText(): Optional<BetaResponseOutputText> = Optional.ofNullable(outputText)
+
+        /** A refusal from the model. */
+        fun refusal(): Optional<BetaResponseOutputRefusal> = Optional.ofNullable(refusal)
+
+        /** Reasoning text from the model. */
+        fun reasoningText(): Optional<ReasoningText> = Optional.ofNullable(reasoningText)
+
+        fun isOutputText(): Boolean = outputText != null
+
+        fun isRefusal(): Boolean = refusal != null
+
+        fun isReasoningText(): Boolean = reasoningText != null
+
+        /** A text output from the model. */
+        fun asOutputText(): BetaResponseOutputText = outputText.getOrThrow("outputText")
+
+        /** A refusal from the model. */
+        fun asRefusal(): BetaResponseOutputRefusal = refusal.getOrThrow("refusal")
+
+        /** Reasoning text from the model. */
+        fun asReasoningText(): ReasoningText = reasoningText.getOrThrow("reasoningText")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = part.accept(new Part.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitOutputText(BetaResponseOutputText outputText) {
+         *         return Optional.of(outputText.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                outputText != null -> visitor.visitOutputText(outputText)
+                refusal != null -> visitor.visitRefusal(refusal)
+                reasoningText != null -> visitor.visitReasoningText(reasoningText)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Part = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitOutputText(outputText: BetaResponseOutputText) {
+                        outputText.validate()
+                    }
+
+                    override fun visitRefusal(refusal: BetaResponseOutputRefusal) {
+                        refusal.validate()
+                    }
+
+                    override fun visitReasoningText(reasoningText: ReasoningText) {
+                        reasoningText.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitOutputText(outputText: BetaResponseOutputText) =
+                        outputText.validity()
+
+                    override fun visitRefusal(refusal: BetaResponseOutputRefusal) =
+                        refusal.validity()
+
+                    override fun visitReasoningText(reasoningText: ReasoningText) =
+                        reasoningText.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Part &&
+                outputText == other.outputText &&
+                refusal == other.refusal &&
+                reasoningText == other.reasoningText
+        }
+
+        override fun hashCode(): Int = Objects.hash(outputText, refusal, reasoningText)
+
+        override fun toString(): String =
+            when {
+                outputText != null -> "Part{outputText=$outputText}"
+                refusal != null -> "Part{refusal=$refusal}"
+                reasoningText != null -> "Part{reasoningText=$reasoningText}"
+                _json != null -> "Part{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Part")
+            }
+
+        companion object {
+
+            /** A text output from the model. */
+            @JvmStatic
+            fun ofOutputText(outputText: BetaResponseOutputText) = Part(outputText = outputText)
+
+            /** A refusal from the model. */
+            @JvmStatic fun ofRefusal(refusal: BetaResponseOutputRefusal) = Part(refusal = refusal)
+
+            /** Reasoning text from the model. */
+            @JvmStatic
+            fun ofReasoningText(reasoningText: ReasoningText) = Part(reasoningText = reasoningText)
+        }
+
+        /** An interface that defines how to map each variant of [Part] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            /** A text output from the model. */
+            fun visitOutputText(outputText: BetaResponseOutputText): T
+
+            /** A refusal from the model. */
+            fun visitRefusal(refusal: BetaResponseOutputRefusal): T
+
+            /** Reasoning text from the model. */
+            fun visitReasoningText(reasoningText: ReasoningText): T
+
+            /**
+             * Maps an unknown variant of [Part] to a value of type [T].
+             *
+             * An instance of [Part] can contain an unknown variant if it was deserialized from data
+             * that doesn't match any known variant. For example, if the SDK is on an older version
+             * than the API, then the API may respond with new variants that the SDK is unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Part: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Part>(Part::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Part {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "output_text" -> {
+                        return tryDeserialize(node, jacksonTypeRef<BetaResponseOutputText>())?.let {
+                            Part(outputText = it, _json = json)
+                        } ?: Part(_json = json)
+                    }
+                    "refusal" -> {
+                        return tryDeserialize(node, jacksonTypeRef<BetaResponseOutputRefusal>())
+                            ?.let { Part(refusal = it, _json = json) } ?: Part(_json = json)
+                    }
+                    "reasoning_text" -> {
+                        return tryDeserialize(node, jacksonTypeRef<ReasoningText>())?.let {
+                            Part(reasoningText = it, _json = json)
+                        } ?: Part(_json = json)
+                    }
+                }
+
+                return Part(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Part>(Part::class) {
+
+            override fun serialize(
+                value: Part,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.outputText != null -> generator.writeObject(value.outputText)
+                    value.refusal != null -> generator.writeObject(value.refusal)
+                    value.reasoningText != null -> generator.writeObject(value.reasoningText)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Part")
+                }
+            }
+        }
+
+        /** Reasoning text from the model. */
+        class ReasoningText
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val text: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(text, type, mutableMapOf())
+
+            /**
+             * The reasoning text from the model.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun text(): String = text.getRequired("text")
+
+            /**
+             * The type of the reasoning text. Always `reasoning_text`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("reasoning_text")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [text].
+             *
+             * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [ReasoningText].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .text()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [ReasoningText]. */
+            class Builder internal constructor() {
+
+                private var text: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("reasoning_text")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(reasoningText: ReasoningText) = apply {
+                    text = reasoningText.text
+                    type = reasoningText.type
+                    additionalProperties = reasoningText.additionalProperties.toMutableMap()
+                }
+
+                /** The reasoning text from the model. */
+                fun text(text: String) = text(JsonField.of(text))
+
+                /**
+                 * Sets [Builder.text] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.text] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun text(text: JsonField<String>) = apply { this.text = text }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("reasoning_text")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [ReasoningText].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .text()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): ReasoningText =
+                    ReasoningText(
+                        checkRequired("text", text),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): ReasoningText = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                text()
+                _type().let {
+                    if (it != JsonValue.from("reasoning_text")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (text.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("reasoning_text")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is ReasoningText &&
+                    text == other.text &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "ReasoningText{text=$text, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseContentPartDoneEvent &&
+            contentIndex == other.contentIndex &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            part == other.part &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            contentIndex,
+            itemId,
+            outputIndex,
+            part,
+            sequenceNumber,
+            type,
+            agent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseContentPartDoneEvent{contentIndex=$contentIndex, itemId=$itemId, outputIndex=$outputIndex, part=$part, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseConversationParam.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseConversationParam.kt
new file mode 100644
index 000000000..fce9b7f5e
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseConversationParam.kt
@@ -0,0 +1,183 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+
+/** The conversation that this response belongs to. */
+class BetaResponseConversationParam
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of()
+    ) : this(id, mutableMapOf())
+
+    /**
+     * The unique ID of the conversation.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseConversationParam].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseConversationParam]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseConversationParam: BetaResponseConversationParam) = apply {
+            id = betaResponseConversationParam.id
+            additionalProperties = betaResponseConversationParam.additionalProperties.toMutableMap()
+        }
+
+        /** The unique ID of the conversation. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseConversationParam].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseConversationParam =
+            BetaResponseConversationParam(
+                checkRequired("id", id),
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseConversationParam = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic internal fun validity(): Int = (if (id.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseConversationParam &&
+            id == other.id &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(id, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseConversationParam{id=$id, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCreatedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCreatedEvent.kt
new file mode 100644
index 000000000..d722db927
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCreatedEvent.kt
@@ -0,0 +1,478 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** An event that is emitted when a response is created. */
+class BetaResponseCreatedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val response: JsonField<BetaResponse>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("response")
+        @ExcludeMissing
+        response: JsonField<BetaResponse> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(response, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The response that was created.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun response(): BetaResponse = response.getRequired("response")
+
+    /**
+     * The sequence number for this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.created`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.created")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [response].
+     *
+     * Unlike [response], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("response") @ExcludeMissing fun _response(): JsonField<BetaResponse> = response
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseCreatedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .response()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseCreatedEvent]. */
+    class Builder internal constructor() {
+
+        private var response: JsonField<BetaResponse>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.created")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseCreatedEvent: BetaResponseCreatedEvent) = apply {
+            response = betaResponseCreatedEvent.response
+            sequenceNumber = betaResponseCreatedEvent.sequenceNumber
+            type = betaResponseCreatedEvent.type
+            agent = betaResponseCreatedEvent.agent
+            additionalProperties = betaResponseCreatedEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The response that was created. */
+        fun response(response: BetaResponse) = response(JsonField.of(response))
+
+        /**
+         * Sets [Builder.response] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.response] with a well-typed [BetaResponse] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun response(response: JsonField<BetaResponse>) = apply { this.response = response }
+
+        /** The sequence number for this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.created")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseCreatedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .response()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseCreatedEvent =
+            BetaResponseCreatedEvent(
+                checkRequired("response", response),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseCreatedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        response().validate()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.created")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (response.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.created")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseCreatedEvent &&
+            response == other.response &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(response, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseCreatedEvent{response=$response, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCall.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCall.kt
new file mode 100644
index 000000000..4a75c8dcb
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCall.kt
@@ -0,0 +1,1062 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** A call to a custom tool created by the model. */
+class BetaResponseCustomToolCall
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val callId: JsonField<String>,
+    private val input: JsonField<String>,
+    private val name: JsonField<String>,
+    private val type: JsonValue,
+    private val id: JsonField<String>,
+    private val agent: JsonField<Agent>,
+    private val caller: JsonField<Caller>,
+    private val namespace: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("input") @ExcludeMissing input: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+        @JsonProperty("namespace") @ExcludeMissing namespace: JsonField<String> = JsonMissing.of(),
+    ) : this(callId, input, name, type, id, agent, caller, namespace, mutableMapOf())
+
+    /**
+     * An identifier used to map this custom tool call to a tool call output.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun callId(): String = callId.getRequired("call_id")
+
+    /**
+     * The input for the custom tool call generated by the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun input(): String = input.getRequired("input")
+
+    /**
+     * The name of the custom tool being called.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun name(): String = name.getRequired("name")
+
+    /**
+     * The type of the custom tool call. Always `custom_tool_call`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("custom_tool_call")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The unique ID of the custom tool call in the OpenAI platform.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun id(): Optional<String> = id.getOptional("id")
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<Caller> = caller.getOptional("caller")
+
+    /**
+     * The namespace of the custom tool being called.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun namespace(): Optional<String> = namespace.getOptional("namespace")
+
+    /**
+     * Returns the raw JSON value of [callId].
+     *
+     * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+    /**
+     * Returns the raw JSON value of [input].
+     *
+     * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("input") @ExcludeMissing fun _input(): JsonField<String> = input
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
+    /**
+     * Returns the raw JSON value of [namespace].
+     *
+     * Unlike [namespace], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("namespace") @ExcludeMissing fun _namespace(): JsonField<String> = namespace
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseCustomToolCall].
+         *
+         * The following fields are required:
+         * ```java
+         * .callId()
+         * .input()
+         * .name()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseCustomToolCall]. */
+    class Builder internal constructor() {
+
+        private var callId: JsonField<String>? = null
+        private var input: JsonField<String>? = null
+        private var name: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("custom_tool_call")
+        private var id: JsonField<String> = JsonMissing.of()
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var caller: JsonField<Caller> = JsonMissing.of()
+        private var namespace: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseCustomToolCall: BetaResponseCustomToolCall) = apply {
+            callId = betaResponseCustomToolCall.callId
+            input = betaResponseCustomToolCall.input
+            name = betaResponseCustomToolCall.name
+            type = betaResponseCustomToolCall.type
+            id = betaResponseCustomToolCall.id
+            agent = betaResponseCustomToolCall.agent
+            caller = betaResponseCustomToolCall.caller
+            namespace = betaResponseCustomToolCall.namespace
+            additionalProperties = betaResponseCustomToolCall.additionalProperties.toMutableMap()
+        }
+
+        /** An identifier used to map this custom tool call to a tool call output. */
+        fun callId(callId: String) = callId(JsonField.of(callId))
+
+        /**
+         * Sets [Builder.callId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.callId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+        /** The input for the custom tool call generated by the model. */
+        fun input(input: String) = input(JsonField.of(input))
+
+        /**
+         * Sets [Builder.input] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.input] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun input(input: JsonField<String>) = apply { this.input = input }
+
+        /** The name of the custom tool being called. */
+        fun name(name: String) = name(JsonField.of(name))
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("custom_tool_call")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The unique ID of the custom tool call in the OpenAI platform. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /** The execution context that produced this tool call. */
+        fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed [Caller] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+        /** Alias for calling [caller] with `Caller.ofDirect()`. */
+        fun callerDirect() = caller(Caller.ofDirect())
+
+        /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+        fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(Caller.Program.builder().callerId(callerId).build())
+
+        /** The namespace of the custom tool being called. */
+        fun namespace(namespace: String) = namespace(JsonField.of(namespace))
+
+        /**
+         * Sets [Builder.namespace] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.namespace] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun namespace(namespace: JsonField<String>) = apply { this.namespace = namespace }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseCustomToolCall].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .callId()
+         * .input()
+         * .name()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseCustomToolCall =
+            BetaResponseCustomToolCall(
+                checkRequired("callId", callId),
+                checkRequired("input", input),
+                checkRequired("name", name),
+                type,
+                id,
+                agent,
+                caller,
+                namespace,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseCustomToolCall = apply {
+        if (validated) {
+            return@apply
+        }
+
+        callId()
+        input()
+        name()
+        _type().let {
+            if (it != JsonValue.from("custom_tool_call")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        id()
+        agent().ifPresent { it.validate() }
+        caller().ifPresent { it.validate() }
+        namespace()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (callId.asKnown().isPresent) 1 else 0) +
+            (if (input.asKnown().isPresent) 1 else 0) +
+            (if (name.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("custom_tool_call")) 1 else 0 } +
+            (if (id.asKnown().isPresent) 1 else 0) +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (namespace.asKnown().isPresent) 1 else 0)
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    /** The execution context that produced this tool call. */
+    @JsonDeserialize(using = Caller.Deserializer::class)
+    @JsonSerialize(using = Caller.Serializer::class)
+    class Caller
+    private constructor(
+        private val direct: JsonValue? = null,
+        private val program: Program? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+        fun program(): Optional<Program> = Optional.ofNullable(program)
+
+        fun isDirect(): Boolean = direct != null
+
+        fun isProgram(): Boolean = program != null
+
+        fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+        fun asProgram(): Program = program.getOrThrow("program")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDirect(JsonValue direct) {
+         *         return Optional.of(direct.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                direct != null -> visitor.visitDirect(direct)
+                program != null -> visitor.visitProgram(program)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Caller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDirect(direct: JsonValue) {
+                        direct.let {
+                            if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'direct' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitProgram(program: Program) {
+                        program.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDirect(direct: JsonValue) =
+                        direct.let { if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0 }
+
+                    override fun visitProgram(program: Program) = program.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Caller && direct == other.direct && program == other.program
+        }
+
+        override fun hashCode(): Int = Objects.hash(direct, program)
+
+        override fun toString(): String =
+            when {
+                direct != null -> "Caller{direct=$direct}"
+                program != null -> "Caller{program=$program}"
+                _json != null -> "Caller{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Caller")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+            @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+        }
+
+        /** An interface that defines how to map each variant of [Caller] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitDirect(direct: JsonValue): T
+
+            fun visitProgram(program: Program): T
+
+            /**
+             * Maps an unknown variant of [Caller] to a value of type [T].
+             *
+             * An instance of [Caller] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Caller: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "direct" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Caller(direct = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                    }
+                    "program" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                            Caller(program = it, _json = json)
+                        } ?: Caller(_json = json)
+                    }
+                }
+
+                return Caller(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+            override fun serialize(
+                value: Caller,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.direct != null -> generator.writeObject(value.direct)
+                    value.program != null -> generator.writeObject(value.program)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+            }
+        }
+
+        class Program
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val callerId: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                callerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(callerId, type, mutableMapOf())
+
+            /**
+             * The call ID of the program item that produced this tool call.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun callerId(): String = callerId.getRequired("caller_id")
+
+            /**
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [callerId].
+             *
+             * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("caller_id") @ExcludeMissing fun _callerId(): JsonField<String> = callerId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Program].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Program]. */
+            class Builder internal constructor() {
+
+                private var callerId: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("program")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(program: Program) = apply {
+                    callerId = program.callerId
+                    type = program.type
+                    additionalProperties = program.additionalProperties.toMutableMap()
+                }
+
+                /** The call ID of the program item that produced this tool call. */
+                fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                /**
+                 * Sets [Builder.callerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.callerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Program].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Program =
+                    Program(
+                        checkRequired("callerId", callerId),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Program = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                callerId()
+                _type().let {
+                    if (it != JsonValue.from("program")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (callerId.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Program &&
+                    callerId == other.callerId &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(callerId, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseCustomToolCall &&
+            callId == other.callId &&
+            input == other.input &&
+            name == other.name &&
+            type == other.type &&
+            id == other.id &&
+            agent == other.agent &&
+            caller == other.caller &&
+            namespace == other.namespace &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(callId, input, name, type, id, agent, caller, namespace, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseCustomToolCall{callId=$callId, input=$input, name=$name, type=$type, id=$id, agent=$agent, caller=$caller, namespace=$namespace, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallInputDeltaEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallInputDeltaEvent.kt
new file mode 100644
index 000000000..209ea8c21
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallInputDeltaEvent.kt
@@ -0,0 +1,556 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Event representing a delta (partial update) to the input of a custom tool call. */
+class BetaResponseCustomToolCallInputDeltaEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val delta: JsonField<String>,
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("delta") @ExcludeMissing delta: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(delta, itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The incremental input data (delta) for the custom tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun delta(): String = delta.getRequired("delta")
+
+    /**
+     * Unique identifier for the API item associated with this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output this delta applies to.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The event type identifier.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.custom_tool_call_input.delta")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [delta].
+     *
+     * Unlike [delta], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("delta") @ExcludeMissing fun _delta(): JsonField<String> = delta
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseCustomToolCallInputDeltaEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .delta()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseCustomToolCallInputDeltaEvent]. */
+    class Builder internal constructor() {
+
+        private var delta: JsonField<String>? = null
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.custom_tool_call_input.delta")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseCustomToolCallInputDeltaEvent: BetaResponseCustomToolCallInputDeltaEvent
+        ) = apply {
+            delta = betaResponseCustomToolCallInputDeltaEvent.delta
+            itemId = betaResponseCustomToolCallInputDeltaEvent.itemId
+            outputIndex = betaResponseCustomToolCallInputDeltaEvent.outputIndex
+            sequenceNumber = betaResponseCustomToolCallInputDeltaEvent.sequenceNumber
+            type = betaResponseCustomToolCallInputDeltaEvent.type
+            agent = betaResponseCustomToolCallInputDeltaEvent.agent
+            additionalProperties =
+                betaResponseCustomToolCallInputDeltaEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The incremental input data (delta) for the custom tool call. */
+        fun delta(delta: String) = delta(JsonField.of(delta))
+
+        /**
+         * Sets [Builder.delta] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.delta] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun delta(delta: JsonField<String>) = apply { this.delta = delta }
+
+        /** Unique identifier for the API item associated with this event. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output this delta applies to. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.custom_tool_call_input.delta")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseCustomToolCallInputDeltaEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .delta()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseCustomToolCallInputDeltaEvent =
+            BetaResponseCustomToolCallInputDeltaEvent(
+                checkRequired("delta", delta),
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseCustomToolCallInputDeltaEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        delta()
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.custom_tool_call_input.delta")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (delta.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.custom_tool_call_input.delta")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseCustomToolCallInputDeltaEvent &&
+            delta == other.delta &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(delta, itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseCustomToolCallInputDeltaEvent{delta=$delta, itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallInputDoneEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallInputDoneEvent.kt
new file mode 100644
index 000000000..d3ce502f0
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallInputDoneEvent.kt
@@ -0,0 +1,556 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Event indicating that input for a custom tool call is complete. */
+class BetaResponseCustomToolCallInputDoneEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val input: JsonField<String>,
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("input") @ExcludeMissing input: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(input, itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The complete input data for the custom tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun input(): String = input.getRequired("input")
+
+    /**
+     * Unique identifier for the API item associated with this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output this event applies to.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The event type identifier.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.custom_tool_call_input.done")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [input].
+     *
+     * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("input") @ExcludeMissing fun _input(): JsonField<String> = input
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseCustomToolCallInputDoneEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .input()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseCustomToolCallInputDoneEvent]. */
+    class Builder internal constructor() {
+
+        private var input: JsonField<String>? = null
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.custom_tool_call_input.done")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseCustomToolCallInputDoneEvent: BetaResponseCustomToolCallInputDoneEvent
+        ) = apply {
+            input = betaResponseCustomToolCallInputDoneEvent.input
+            itemId = betaResponseCustomToolCallInputDoneEvent.itemId
+            outputIndex = betaResponseCustomToolCallInputDoneEvent.outputIndex
+            sequenceNumber = betaResponseCustomToolCallInputDoneEvent.sequenceNumber
+            type = betaResponseCustomToolCallInputDoneEvent.type
+            agent = betaResponseCustomToolCallInputDoneEvent.agent
+            additionalProperties =
+                betaResponseCustomToolCallInputDoneEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The complete input data for the custom tool call. */
+        fun input(input: String) = input(JsonField.of(input))
+
+        /**
+         * Sets [Builder.input] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.input] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun input(input: JsonField<String>) = apply { this.input = input }
+
+        /** Unique identifier for the API item associated with this event. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output this event applies to. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.custom_tool_call_input.done")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseCustomToolCallInputDoneEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .input()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseCustomToolCallInputDoneEvent =
+            BetaResponseCustomToolCallInputDoneEvent(
+                checkRequired("input", input),
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseCustomToolCallInputDoneEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        input()
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.custom_tool_call_input.done")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (input.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.custom_tool_call_input.done")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseCustomToolCallInputDoneEvent &&
+            input == other.input &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(input, itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseCustomToolCallInputDoneEvent{input=$input, itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallItem.kt
new file mode 100644
index 000000000..1f7e6de00
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallItem.kt
@@ -0,0 +1,733 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** A call to a custom tool created by the model. */
+class BetaResponseCustomToolCallItem
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val callId: JsonField<String>,
+    private val input: JsonField<String>,
+    private val name: JsonField<String>,
+    private val type: JsonValue,
+    private val id: JsonField<String>,
+    private val agent: JsonField<BetaResponseCustomToolCall.Agent>,
+    private val caller: JsonField<BetaResponseCustomToolCall.Caller>,
+    private val namespace: JsonField<String>,
+    private val status: JsonField<Status>,
+    private val createdBy: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("input") @ExcludeMissing input: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("agent")
+        @ExcludeMissing
+        agent: JsonField<BetaResponseCustomToolCall.Agent> = JsonMissing.of(),
+        @JsonProperty("caller")
+        @ExcludeMissing
+        caller: JsonField<BetaResponseCustomToolCall.Caller> = JsonMissing.of(),
+        @JsonProperty("namespace") @ExcludeMissing namespace: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
+    ) : this(
+        callId,
+        input,
+        name,
+        type,
+        id,
+        agent,
+        caller,
+        namespace,
+        status,
+        createdBy,
+        mutableMapOf(),
+    )
+
+    fun toBetaResponseCustomToolCall(): BetaResponseCustomToolCall =
+        BetaResponseCustomToolCall.builder()
+            .callId(callId)
+            .input(input)
+            .name(name)
+            .type(type)
+            .id(id)
+            .agent(agent)
+            .caller(caller)
+            .namespace(namespace)
+            .build()
+
+    /**
+     * An identifier used to map this custom tool call to a tool call output.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun callId(): String = callId.getRequired("call_id")
+
+    /**
+     * The input for the custom tool call generated by the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun input(): String = input.getRequired("input")
+
+    /**
+     * The name of the custom tool being called.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun name(): String = name.getRequired("name")
+
+    /**
+     * The type of the custom tool call. Always `custom_tool_call`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("custom_tool_call")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The unique ID of the custom tool call in the OpenAI platform.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun id(): Optional<String> = id.getOptional("id")
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<BetaResponseCustomToolCall.Agent> = agent.getOptional("agent")
+
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<BetaResponseCustomToolCall.Caller> = caller.getOptional("caller")
+
+    /**
+     * The namespace of the custom tool being called.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun namespace(): Optional<String> = namespace.getOptional("namespace")
+
+    /**
+     * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+     * items are returned via API.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun status(): Status = status.getRequired("status")
+
+    /**
+     * The identifier of the actor that created the item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdBy(): Optional<String> = createdBy.getOptional("created_by")
+
+    /**
+     * Returns the raw JSON value of [callId].
+     *
+     * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+    /**
+     * Returns the raw JSON value of [input].
+     *
+     * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("input") @ExcludeMissing fun _input(): JsonField<String> = input
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent")
+    @ExcludeMissing
+    fun _agent(): JsonField<BetaResponseCustomToolCall.Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller")
+    @ExcludeMissing
+    fun _caller(): JsonField<BetaResponseCustomToolCall.Caller> = caller
+
+    /**
+     * Returns the raw JSON value of [namespace].
+     *
+     * Unlike [namespace], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("namespace") @ExcludeMissing fun _namespace(): JsonField<String> = namespace
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    /**
+     * Returns the raw JSON value of [createdBy].
+     *
+     * Unlike [createdBy], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_by") @ExcludeMissing fun _createdBy(): JsonField<String> = createdBy
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseCustomToolCallItem].
+         *
+         * The following fields are required:
+         * ```java
+         * .callId()
+         * .input()
+         * .name()
+         * .status()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseCustomToolCallItem]. */
+    class Builder internal constructor() {
+
+        private var callId: JsonField<String>? = null
+        private var input: JsonField<String>? = null
+        private var name: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("custom_tool_call")
+        private var id: JsonField<String> = JsonMissing.of()
+        private var agent: JsonField<BetaResponseCustomToolCall.Agent> = JsonMissing.of()
+        private var caller: JsonField<BetaResponseCustomToolCall.Caller> = JsonMissing.of()
+        private var namespace: JsonField<String> = JsonMissing.of()
+        private var status: JsonField<Status>? = null
+        private var createdBy: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseCustomToolCallItem: BetaResponseCustomToolCallItem) = apply {
+            callId = betaResponseCustomToolCallItem.callId
+            input = betaResponseCustomToolCallItem.input
+            name = betaResponseCustomToolCallItem.name
+            type = betaResponseCustomToolCallItem.type
+            id = betaResponseCustomToolCallItem.id
+            agent = betaResponseCustomToolCallItem.agent
+            caller = betaResponseCustomToolCallItem.caller
+            namespace = betaResponseCustomToolCallItem.namespace
+            status = betaResponseCustomToolCallItem.status
+            createdBy = betaResponseCustomToolCallItem.createdBy
+            additionalProperties =
+                betaResponseCustomToolCallItem.additionalProperties.toMutableMap()
+        }
+
+        /** An identifier used to map this custom tool call to a tool call output. */
+        fun callId(callId: String) = callId(JsonField.of(callId))
+
+        /**
+         * Sets [Builder.callId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.callId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+        /** The input for the custom tool call generated by the model. */
+        fun input(input: String) = input(JsonField.of(input))
+
+        /**
+         * Sets [Builder.input] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.input] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun input(input: JsonField<String>) = apply { this.input = input }
+
+        /** The name of the custom tool being called. */
+        fun name(name: String) = name(JsonField.of(name))
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("custom_tool_call")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The unique ID of the custom tool call in the OpenAI platform. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The agent that produced this item. */
+        fun agent(agent: BetaResponseCustomToolCall.Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<BetaResponseCustomToolCall.Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed
+         * [BetaResponseCustomToolCall.Agent] value instead. This method is primarily for setting
+         * the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<BetaResponseCustomToolCall.Agent>) = apply { this.agent = agent }
+
+        /** The execution context that produced this tool call. */
+        fun caller(caller: BetaResponseCustomToolCall.Caller?) =
+            caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<BetaResponseCustomToolCall.Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed
+         * [BetaResponseCustomToolCall.Caller] value instead. This method is primarily for setting
+         * the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<BetaResponseCustomToolCall.Caller>) = apply {
+            this.caller = caller
+        }
+
+        /** Alias for calling [caller] with `BetaResponseCustomToolCall.Caller.ofDirect()`. */
+        fun callerDirect() = caller(BetaResponseCustomToolCall.Caller.ofDirect())
+
+        /**
+         * Alias for calling [caller] with `BetaResponseCustomToolCall.Caller.ofProgram(program)`.
+         */
+        fun caller(program: BetaResponseCustomToolCall.Caller.Program) =
+            caller(BetaResponseCustomToolCall.Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * BetaResponseCustomToolCall.Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(BetaResponseCustomToolCall.Caller.Program.builder().callerId(callerId).build())
+
+        /** The namespace of the custom tool being called. */
+        fun namespace(namespace: String) = namespace(JsonField.of(namespace))
+
+        /**
+         * Sets [Builder.namespace] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.namespace] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun namespace(namespace: JsonField<String>) = apply { this.namespace = namespace }
+
+        /**
+         * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated
+         * when items are returned via API.
+         */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        /** The identifier of the actor that created the item. */
+        fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
+
+        /**
+         * Sets [Builder.createdBy] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdBy] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun createdBy(createdBy: JsonField<String>) = apply { this.createdBy = createdBy }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseCustomToolCallItem].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .callId()
+         * .input()
+         * .name()
+         * .status()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseCustomToolCallItem =
+            BetaResponseCustomToolCallItem(
+                checkRequired("callId", callId),
+                checkRequired("input", input),
+                checkRequired("name", name),
+                type,
+                id,
+                agent,
+                caller,
+                namespace,
+                checkRequired("status", status),
+                createdBy,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseCustomToolCallItem = apply {
+        if (validated) {
+            return@apply
+        }
+
+        callId()
+        input()
+        name()
+        _type().let {
+            if (it != JsonValue.from("custom_tool_call")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        id()
+        agent().ifPresent { it.validate() }
+        caller().ifPresent { it.validate() }
+        namespace()
+        status().validate()
+        createdBy()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (callId.asKnown().isPresent) 1 else 0) +
+            (if (input.asKnown().isPresent) 1 else 0) +
+            (if (name.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("custom_tool_call")) 1 else 0 } +
+            (if (id.asKnown().isPresent) 1 else 0) +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (namespace.asKnown().isPresent) 1 else 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (createdBy.asKnown().isPresent) 1 else 0)
+
+    /**
+     * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+     * items are returned via API.
+     */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseCustomToolCallItem &&
+            callId == other.callId &&
+            input == other.input &&
+            name == other.name &&
+            type == other.type &&
+            id == other.id &&
+            agent == other.agent &&
+            caller == other.caller &&
+            namespace == other.namespace &&
+            status == other.status &&
+            createdBy == other.createdBy &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            callId,
+            input,
+            name,
+            type,
+            id,
+            agent,
+            caller,
+            namespace,
+            status,
+            createdBy,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseCustomToolCallItem{callId=$callId, input=$input, name=$name, type=$type, id=$id, agent=$agent, caller=$caller, namespace=$namespace, status=$status, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallOutput.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallOutput.kt
new file mode 100644
index 000000000..8b9dfeadf
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallOutput.kt
@@ -0,0 +1,1535 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.allMaxBy
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** The output of a custom tool call from your code, being sent back to the model. */
+class BetaResponseCustomToolCallOutput
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val callId: JsonField<String>,
+    private val output: JsonField<Output>,
+    private val type: JsonValue,
+    private val id: JsonField<String>,
+    private val agent: JsonField<Agent>,
+    private val caller: JsonField<Caller>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output") @ExcludeMissing output: JsonField<Output> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+    ) : this(callId, output, type, id, agent, caller, mutableMapOf())
+
+    /**
+     * The call ID, used to map this custom tool call output to a custom tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun callId(): String = callId.getRequired("call_id")
+
+    /**
+     * The output from the custom tool call generated by your code. Can be a string or an list of
+     * output content.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun output(): Output = output.getRequired("output")
+
+    /**
+     * The type of the custom tool call output. Always `custom_tool_call_output`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("custom_tool_call_output")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The unique ID of the custom tool call output in the OpenAI platform.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun id(): Optional<String> = id.getOptional("id")
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<Caller> = caller.getOptional("caller")
+
+    /**
+     * Returns the raw JSON value of [callId].
+     *
+     * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+    /**
+     * Returns the raw JSON value of [output].
+     *
+     * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<Output> = output
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseCustomToolCallOutput].
+         *
+         * The following fields are required:
+         * ```java
+         * .callId()
+         * .output()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseCustomToolCallOutput]. */
+    class Builder internal constructor() {
+
+        private var callId: JsonField<String>? = null
+        private var output: JsonField<Output>? = null
+        private var type: JsonValue = JsonValue.from("custom_tool_call_output")
+        private var id: JsonField<String> = JsonMissing.of()
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var caller: JsonField<Caller> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseCustomToolCallOutput: BetaResponseCustomToolCallOutput) =
+            apply {
+                callId = betaResponseCustomToolCallOutput.callId
+                output = betaResponseCustomToolCallOutput.output
+                type = betaResponseCustomToolCallOutput.type
+                id = betaResponseCustomToolCallOutput.id
+                agent = betaResponseCustomToolCallOutput.agent
+                caller = betaResponseCustomToolCallOutput.caller
+                additionalProperties =
+                    betaResponseCustomToolCallOutput.additionalProperties.toMutableMap()
+            }
+
+        /** The call ID, used to map this custom tool call output to a custom tool call. */
+        fun callId(callId: String) = callId(JsonField.of(callId))
+
+        /**
+         * Sets [Builder.callId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.callId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+        /**
+         * The output from the custom tool call generated by your code. Can be a string or an list
+         * of output content.
+         */
+        fun output(output: Output) = output(JsonField.of(output))
+
+        /**
+         * Sets [Builder.output] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.output] with a well-typed [Output] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun output(output: JsonField<Output>) = apply { this.output = output }
+
+        /** Alias for calling [output] with `Output.ofString(string)`. */
+        fun output(string: String) = output(Output.ofString(string))
+
+        /** Alias for calling [output] with `Output.ofContentList(contentList)`. */
+        fun outputOfContentList(contentList: List<Output.BetaFunctionAndCustomToolCallOutput>) =
+            output(Output.ofContentList(contentList))
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("custom_tool_call_output")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The unique ID of the custom tool call output in the OpenAI platform. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /** The execution context that produced this tool call. */
+        fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed [Caller] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+        /** Alias for calling [caller] with `Caller.ofDirect()`. */
+        fun callerDirect() = caller(Caller.ofDirect())
+
+        /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+        fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(Caller.Program.builder().callerId(callerId).build())
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseCustomToolCallOutput].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .callId()
+         * .output()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseCustomToolCallOutput =
+            BetaResponseCustomToolCallOutput(
+                checkRequired("callId", callId),
+                checkRequired("output", output),
+                type,
+                id,
+                agent,
+                caller,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseCustomToolCallOutput = apply {
+        if (validated) {
+            return@apply
+        }
+
+        callId()
+        output().validate()
+        _type().let {
+            if (it != JsonValue.from("custom_tool_call_output")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        id()
+        agent().ifPresent { it.validate() }
+        caller().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (callId.asKnown().isPresent) 1 else 0) +
+            (output.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("custom_tool_call_output")) 1 else 0 } +
+            (if (id.asKnown().isPresent) 1 else 0) +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * The output from the custom tool call generated by your code. Can be a string or an list of
+     * output content.
+     */
+    @JsonDeserialize(using = Output.Deserializer::class)
+    @JsonSerialize(using = Output.Serializer::class)
+    class Output
+    private constructor(
+        private val string: String? = null,
+        private val contentList: List<BetaFunctionAndCustomToolCallOutput>? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** A string of the output of the custom tool call. */
+        fun string(): Optional<String> = Optional.ofNullable(string)
+
+        /** Text, image, or file output of the custom tool call. */
+        fun contentList(): Optional<List<BetaFunctionAndCustomToolCallOutput>> =
+            Optional.ofNullable(contentList)
+
+        fun isString(): Boolean = string != null
+
+        fun isContentList(): Boolean = contentList != null
+
+        /** A string of the output of the custom tool call. */
+        fun asString(): String = string.getOrThrow("string")
+
+        /** Text, image, or file output of the custom tool call. */
+        fun asContentList(): List<BetaFunctionAndCustomToolCallOutput> =
+            contentList.getOrThrow("contentList")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = output.accept(new Output.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitString(String string) {
+         *         return Optional.of(string.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                string != null -> visitor.visitString(string)
+                contentList != null -> visitor.visitContentList(contentList)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Output = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitString(string: String) {}
+
+                    override fun visitContentList(
+                        contentList: List<BetaFunctionAndCustomToolCallOutput>
+                    ) {
+                        contentList.forEach { it.validate() }
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitString(string: String) = 1
+
+                    override fun visitContentList(
+                        contentList: List<BetaFunctionAndCustomToolCallOutput>
+                    ) = contentList.sumOf { it.validity().toInt() }
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Output && string == other.string && contentList == other.contentList
+        }
+
+        override fun hashCode(): Int = Objects.hash(string, contentList)
+
+        override fun toString(): String =
+            when {
+                string != null -> "Output{string=$string}"
+                contentList != null -> "Output{contentList=$contentList}"
+                _json != null -> "Output{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Output")
+            }
+
+        companion object {
+
+            /** A string of the output of the custom tool call. */
+            @JvmStatic fun ofString(string: String) = Output(string = string)
+
+            /** Text, image, or file output of the custom tool call. */
+            @JvmStatic
+            fun ofContentList(contentList: List<BetaFunctionAndCustomToolCallOutput>) =
+                Output(contentList = contentList.toImmutable())
+        }
+
+        /** An interface that defines how to map each variant of [Output] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            /** A string of the output of the custom tool call. */
+            fun visitString(string: String): T
+
+            /** Text, image, or file output of the custom tool call. */
+            fun visitContentList(contentList: List<BetaFunctionAndCustomToolCallOutput>): T
+
+            /**
+             * Maps an unknown variant of [Output] to a value of type [T].
+             *
+             * An instance of [Output] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Output: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Output>(Output::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Output {
+                val json = JsonValue.fromJsonNode(node)
+
+                val bestMatches =
+                    sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                Output(string = it, _json = json)
+                            },
+                            tryDeserialize(
+                                    node,
+                                    jacksonTypeRef<List<BetaFunctionAndCustomToolCallOutput>>(),
+                                )
+                                ?.let { Output(contentList = it, _json = json) },
+                        )
+                        .filterNotNull()
+                        .allMaxBy { it.validity() }
+                        .toList()
+                return when (bestMatches.size) {
+                    // This can happen if what we're deserializing is completely incompatible with
+                    // all the possible variants (e.g. deserializing from boolean).
+                    0 -> Output(_json = json)
+                    1 -> bestMatches.single()
+                    // If there's more than one match with the highest validity, then use the first
+                    // completely valid match, or simply the first match if none are completely
+                    // valid.
+                    else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                }
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Output>(Output::class) {
+
+            override fun serialize(
+                value: Output,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.string != null -> generator.writeObject(value.string)
+                    value.contentList != null -> generator.writeObject(value.contentList)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Output")
+                }
+            }
+        }
+
+        /** A text input to the model. */
+        @JsonDeserialize(using = BetaFunctionAndCustomToolCallOutput.Deserializer::class)
+        @JsonSerialize(using = BetaFunctionAndCustomToolCallOutput.Serializer::class)
+        class BetaFunctionAndCustomToolCallOutput
+        private constructor(
+            private val inputText: BetaResponseInputText? = null,
+            private val inputImage: BetaResponseInputImage? = null,
+            private val inputFile: BetaResponseInputFile? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /** A text input to the model. */
+            fun inputText(): Optional<BetaResponseInputText> = Optional.ofNullable(inputText)
+
+            /**
+             * An image input to the model. Learn about
+             * [image inputs](https://platform.openai.com/docs/guides/vision).
+             */
+            fun inputImage(): Optional<BetaResponseInputImage> = Optional.ofNullable(inputImage)
+
+            /** A file input to the model. */
+            fun inputFile(): Optional<BetaResponseInputFile> = Optional.ofNullable(inputFile)
+
+            fun isInputText(): Boolean = inputText != null
+
+            fun isInputImage(): Boolean = inputImage != null
+
+            fun isInputFile(): Boolean = inputFile != null
+
+            /** A text input to the model. */
+            fun asInputText(): BetaResponseInputText = inputText.getOrThrow("inputText")
+
+            /**
+             * An image input to the model. Learn about
+             * [image inputs](https://platform.openai.com/docs/guides/vision).
+             */
+            fun asInputImage(): BetaResponseInputImage = inputImage.getOrThrow("inputImage")
+
+            /** A file input to the model. */
+            fun asInputFile(): BetaResponseInputFile = inputFile.getOrThrow("inputFile")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = betaFunctionAndCustomToolCallOutput.accept(new BetaFunctionAndCustomToolCallOutput.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitInputText(BetaResponseInputText inputText) {
+             *         return Optional.of(inputText.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    inputText != null -> visitor.visitInputText(inputText)
+                    inputImage != null -> visitor.visitInputImage(inputImage)
+                    inputFile != null -> visitor.visitInputFile(inputFile)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): BetaFunctionAndCustomToolCallOutput = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitInputText(inputText: BetaResponseInputText) {
+                            inputText.validate()
+                        }
+
+                        override fun visitInputImage(inputImage: BetaResponseInputImage) {
+                            inputImage.validate()
+                        }
+
+                        override fun visitInputFile(inputFile: BetaResponseInputFile) {
+                            inputFile.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitInputText(inputText: BetaResponseInputText) =
+                            inputText.validity()
+
+                        override fun visitInputImage(inputImage: BetaResponseInputImage) =
+                            inputImage.validity()
+
+                        override fun visitInputFile(inputFile: BetaResponseInputFile) =
+                            inputFile.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is BetaFunctionAndCustomToolCallOutput &&
+                    inputText == other.inputText &&
+                    inputImage == other.inputImage &&
+                    inputFile == other.inputFile
+            }
+
+            override fun hashCode(): Int = Objects.hash(inputText, inputImage, inputFile)
+
+            override fun toString(): String =
+                when {
+                    inputText != null -> "BetaFunctionAndCustomToolCallOutput{inputText=$inputText}"
+                    inputImage != null ->
+                        "BetaFunctionAndCustomToolCallOutput{inputImage=$inputImage}"
+                    inputFile != null -> "BetaFunctionAndCustomToolCallOutput{inputFile=$inputFile}"
+                    _json != null -> "BetaFunctionAndCustomToolCallOutput{_unknown=$_json}"
+                    else ->
+                        throw IllegalStateException("Invalid BetaFunctionAndCustomToolCallOutput")
+                }
+
+            companion object {
+
+                /** A text input to the model. */
+                @JvmStatic
+                fun ofInputText(inputText: BetaResponseInputText) =
+                    BetaFunctionAndCustomToolCallOutput(inputText = inputText)
+
+                /**
+                 * An image input to the model. Learn about
+                 * [image inputs](https://platform.openai.com/docs/guides/vision).
+                 */
+                @JvmStatic
+                fun ofInputImage(inputImage: BetaResponseInputImage) =
+                    BetaFunctionAndCustomToolCallOutput(inputImage = inputImage)
+
+                /** A file input to the model. */
+                @JvmStatic
+                fun ofInputFile(inputFile: BetaResponseInputFile) =
+                    BetaFunctionAndCustomToolCallOutput(inputFile = inputFile)
+            }
+
+            /**
+             * An interface that defines how to map each variant of
+             * [BetaFunctionAndCustomToolCallOutput] to a value of type [T].
+             */
+            interface Visitor<out T> {
+
+                /** A text input to the model. */
+                fun visitInputText(inputText: BetaResponseInputText): T
+
+                /**
+                 * An image input to the model. Learn about
+                 * [image inputs](https://platform.openai.com/docs/guides/vision).
+                 */
+                fun visitInputImage(inputImage: BetaResponseInputImage): T
+
+                /** A file input to the model. */
+                fun visitInputFile(inputFile: BetaResponseInputFile): T
+
+                /**
+                 * Maps an unknown variant of [BetaFunctionAndCustomToolCallOutput] to a value of
+                 * type [T].
+                 *
+                 * An instance of [BetaFunctionAndCustomToolCallOutput] can contain an unknown
+                 * variant if it was deserialized from data that doesn't match any known variant.
+                 * For example, if the SDK is on an older version than the API, then the API may
+                 * respond with new variants that the SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException(
+                        "Unknown BetaFunctionAndCustomToolCallOutput: $json"
+                    )
+                }
+            }
+
+            internal class Deserializer :
+                BaseDeserializer<BetaFunctionAndCustomToolCallOutput>(
+                    BetaFunctionAndCustomToolCallOutput::class
+                ) {
+
+                override fun ObjectCodec.deserialize(
+                    node: JsonNode
+                ): BetaFunctionAndCustomToolCallOutput {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "input_text" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaResponseInputText>())
+                                ?.let {
+                                    BetaFunctionAndCustomToolCallOutput(
+                                        inputText = it,
+                                        _json = json,
+                                    )
+                                } ?: BetaFunctionAndCustomToolCallOutput(_json = json)
+                        }
+                        "input_image" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaResponseInputImage>())
+                                ?.let {
+                                    BetaFunctionAndCustomToolCallOutput(
+                                        inputImage = it,
+                                        _json = json,
+                                    )
+                                } ?: BetaFunctionAndCustomToolCallOutput(_json = json)
+                        }
+                        "input_file" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaResponseInputFile>())
+                                ?.let {
+                                    BetaFunctionAndCustomToolCallOutput(
+                                        inputFile = it,
+                                        _json = json,
+                                    )
+                                } ?: BetaFunctionAndCustomToolCallOutput(_json = json)
+                        }
+                    }
+
+                    return BetaFunctionAndCustomToolCallOutput(_json = json)
+                }
+            }
+
+            internal class Serializer :
+                BaseSerializer<BetaFunctionAndCustomToolCallOutput>(
+                    BetaFunctionAndCustomToolCallOutput::class
+                ) {
+
+                override fun serialize(
+                    value: BetaFunctionAndCustomToolCallOutput,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.inputText != null -> generator.writeObject(value.inputText)
+                        value.inputImage != null -> generator.writeObject(value.inputImage)
+                        value.inputFile != null -> generator.writeObject(value.inputFile)
+                        value._json != null -> generator.writeObject(value._json)
+                        else ->
+                            throw IllegalStateException(
+                                "Invalid BetaFunctionAndCustomToolCallOutput"
+                            )
+                    }
+                }
+            }
+        }
+    }
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    /** The execution context that produced this tool call. */
+    @JsonDeserialize(using = Caller.Deserializer::class)
+    @JsonSerialize(using = Caller.Serializer::class)
+    class Caller
+    private constructor(
+        private val direct: JsonValue? = null,
+        private val program: Program? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+        fun program(): Optional<Program> = Optional.ofNullable(program)
+
+        fun isDirect(): Boolean = direct != null
+
+        fun isProgram(): Boolean = program != null
+
+        fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+        fun asProgram(): Program = program.getOrThrow("program")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDirect(JsonValue direct) {
+         *         return Optional.of(direct.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                direct != null -> visitor.visitDirect(direct)
+                program != null -> visitor.visitProgram(program)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Caller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDirect(direct: JsonValue) {
+                        direct.let {
+                            if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'direct' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitProgram(program: Program) {
+                        program.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDirect(direct: JsonValue) =
+                        direct.let { if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0 }
+
+                    override fun visitProgram(program: Program) = program.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Caller && direct == other.direct && program == other.program
+        }
+
+        override fun hashCode(): Int = Objects.hash(direct, program)
+
+        override fun toString(): String =
+            when {
+                direct != null -> "Caller{direct=$direct}"
+                program != null -> "Caller{program=$program}"
+                _json != null -> "Caller{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Caller")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+            @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+        }
+
+        /** An interface that defines how to map each variant of [Caller] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitDirect(direct: JsonValue): T
+
+            fun visitProgram(program: Program): T
+
+            /**
+             * Maps an unknown variant of [Caller] to a value of type [T].
+             *
+             * An instance of [Caller] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Caller: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "direct" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Caller(direct = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                    }
+                    "program" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                            Caller(program = it, _json = json)
+                        } ?: Caller(_json = json)
+                    }
+                }
+
+                return Caller(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+            override fun serialize(
+                value: Caller,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.direct != null -> generator.writeObject(value.direct)
+                    value.program != null -> generator.writeObject(value.program)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+            }
+        }
+
+        class Program
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val callerId: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                callerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(callerId, type, mutableMapOf())
+
+            /**
+             * The call ID of the program item that produced this tool call.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun callerId(): String = callerId.getRequired("caller_id")
+
+            /**
+             * The caller type. Always `program`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [callerId].
+             *
+             * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("caller_id") @ExcludeMissing fun _callerId(): JsonField<String> = callerId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Program].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Program]. */
+            class Builder internal constructor() {
+
+                private var callerId: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("program")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(program: Program) = apply {
+                    callerId = program.callerId
+                    type = program.type
+                    additionalProperties = program.additionalProperties.toMutableMap()
+                }
+
+                /** The call ID of the program item that produced this tool call. */
+                fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                /**
+                 * Sets [Builder.callerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.callerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Program].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Program =
+                    Program(
+                        checkRequired("callerId", callerId),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Program = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                callerId()
+                _type().let {
+                    if (it != JsonValue.from("program")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (callerId.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Program &&
+                    callerId == other.callerId &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(callerId, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseCustomToolCallOutput &&
+            callId == other.callId &&
+            output == other.output &&
+            type == other.type &&
+            id == other.id &&
+            agent == other.agent &&
+            caller == other.caller &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(callId, output, type, id, agent, caller, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseCustomToolCallOutput{callId=$callId, output=$output, type=$type, id=$id, agent=$agent, caller=$caller, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallOutputItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallOutputItem.kt
new file mode 100644
index 000000000..dd11204bd
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallOutputItem.kt
@@ -0,0 +1,683 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** The output of a custom tool call from your code, being sent back to the model. */
+class BetaResponseCustomToolCallOutputItem
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val callId: JsonField<String>,
+    private val output: JsonField<BetaResponseCustomToolCallOutput.Output>,
+    private val type: JsonValue,
+    private val id: JsonField<String>,
+    private val agent: JsonField<BetaResponseCustomToolCallOutput.Agent>,
+    private val caller: JsonField<BetaResponseCustomToolCallOutput.Caller>,
+    private val status: JsonField<Status>,
+    private val createdBy: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output")
+        @ExcludeMissing
+        output: JsonField<BetaResponseCustomToolCallOutput.Output> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("agent")
+        @ExcludeMissing
+        agent: JsonField<BetaResponseCustomToolCallOutput.Agent> = JsonMissing.of(),
+        @JsonProperty("caller")
+        @ExcludeMissing
+        caller: JsonField<BetaResponseCustomToolCallOutput.Caller> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
+    ) : this(callId, output, type, id, agent, caller, status, createdBy, mutableMapOf())
+
+    fun toBetaResponseCustomToolCallOutput(): BetaResponseCustomToolCallOutput =
+        BetaResponseCustomToolCallOutput.builder()
+            .callId(callId)
+            .output(output)
+            .type(type)
+            .id(id)
+            .agent(agent)
+            .caller(caller)
+            .build()
+
+    /**
+     * The call ID, used to map this custom tool call output to a custom tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun callId(): String = callId.getRequired("call_id")
+
+    /**
+     * The output from the custom tool call generated by your code. Can be a string or an list of
+     * output content.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun output(): BetaResponseCustomToolCallOutput.Output = output.getRequired("output")
+
+    /**
+     * The type of the custom tool call output. Always `custom_tool_call_output`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("custom_tool_call_output")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The unique ID of the custom tool call output in the OpenAI platform.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun id(): Optional<String> = id.getOptional("id")
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<BetaResponseCustomToolCallOutput.Agent> = agent.getOptional("agent")
+
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<BetaResponseCustomToolCallOutput.Caller> = caller.getOptional("caller")
+
+    /**
+     * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+     * items are returned via API.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun status(): Status = status.getRequired("status")
+
+    /**
+     * The identifier of the actor that created the item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdBy(): Optional<String> = createdBy.getOptional("created_by")
+
+    /**
+     * Returns the raw JSON value of [callId].
+     *
+     * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+    /**
+     * Returns the raw JSON value of [output].
+     *
+     * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output")
+    @ExcludeMissing
+    fun _output(): JsonField<BetaResponseCustomToolCallOutput.Output> = output
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent")
+    @ExcludeMissing
+    fun _agent(): JsonField<BetaResponseCustomToolCallOutput.Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller")
+    @ExcludeMissing
+    fun _caller(): JsonField<BetaResponseCustomToolCallOutput.Caller> = caller
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    /**
+     * Returns the raw JSON value of [createdBy].
+     *
+     * Unlike [createdBy], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_by") @ExcludeMissing fun _createdBy(): JsonField<String> = createdBy
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseCustomToolCallOutputItem].
+         *
+         * The following fields are required:
+         * ```java
+         * .callId()
+         * .output()
+         * .status()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseCustomToolCallOutputItem]. */
+    class Builder internal constructor() {
+
+        private var callId: JsonField<String>? = null
+        private var output: JsonField<BetaResponseCustomToolCallOutput.Output>? = null
+        private var type: JsonValue = JsonValue.from("custom_tool_call_output")
+        private var id: JsonField<String> = JsonMissing.of()
+        private var agent: JsonField<BetaResponseCustomToolCallOutput.Agent> = JsonMissing.of()
+        private var caller: JsonField<BetaResponseCustomToolCallOutput.Caller> = JsonMissing.of()
+        private var status: JsonField<Status>? = null
+        private var createdBy: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseCustomToolCallOutputItem: BetaResponseCustomToolCallOutputItem
+        ) = apply {
+            callId = betaResponseCustomToolCallOutputItem.callId
+            output = betaResponseCustomToolCallOutputItem.output
+            type = betaResponseCustomToolCallOutputItem.type
+            id = betaResponseCustomToolCallOutputItem.id
+            agent = betaResponseCustomToolCallOutputItem.agent
+            caller = betaResponseCustomToolCallOutputItem.caller
+            status = betaResponseCustomToolCallOutputItem.status
+            createdBy = betaResponseCustomToolCallOutputItem.createdBy
+            additionalProperties =
+                betaResponseCustomToolCallOutputItem.additionalProperties.toMutableMap()
+        }
+
+        /** The call ID, used to map this custom tool call output to a custom tool call. */
+        fun callId(callId: String) = callId(JsonField.of(callId))
+
+        /**
+         * Sets [Builder.callId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.callId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+        /**
+         * The output from the custom tool call generated by your code. Can be a string or an list
+         * of output content.
+         */
+        fun output(output: BetaResponseCustomToolCallOutput.Output) = output(JsonField.of(output))
+
+        /**
+         * Sets [Builder.output] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.output] with a well-typed
+         * [BetaResponseCustomToolCallOutput.Output] value instead. This method is primarily for
+         * setting the field to an undocumented or not yet supported value.
+         */
+        fun output(output: JsonField<BetaResponseCustomToolCallOutput.Output>) = apply {
+            this.output = output
+        }
+
+        /**
+         * Alias for calling [output] with
+         * `BetaResponseCustomToolCallOutput.Output.ofString(string)`.
+         */
+        fun output(string: String) =
+            output(BetaResponseCustomToolCallOutput.Output.ofString(string))
+
+        /**
+         * Alias for calling [output] with
+         * `BetaResponseCustomToolCallOutput.Output.ofContentList(contentList)`.
+         */
+        fun outputOfContentList(
+            contentList:
+                List<BetaResponseCustomToolCallOutput.Output.BetaFunctionAndCustomToolCallOutput>
+        ) = output(BetaResponseCustomToolCallOutput.Output.ofContentList(contentList))
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("custom_tool_call_output")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The unique ID of the custom tool call output in the OpenAI platform. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The agent that produced this item. */
+        fun agent(agent: BetaResponseCustomToolCallOutput.Agent?) =
+            agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<BetaResponseCustomToolCallOutput.Agent>) =
+            agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed
+         * [BetaResponseCustomToolCallOutput.Agent] value instead. This method is primarily for
+         * setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<BetaResponseCustomToolCallOutput.Agent>) = apply {
+            this.agent = agent
+        }
+
+        /** The execution context that produced this tool call. */
+        fun caller(caller: BetaResponseCustomToolCallOutput.Caller?) =
+            caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<BetaResponseCustomToolCallOutput.Caller>) =
+            caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed
+         * [BetaResponseCustomToolCallOutput.Caller] value instead. This method is primarily for
+         * setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<BetaResponseCustomToolCallOutput.Caller>) = apply {
+            this.caller = caller
+        }
+
+        /** Alias for calling [caller] with `BetaResponseCustomToolCallOutput.Caller.ofDirect()`. */
+        fun callerDirect() = caller(BetaResponseCustomToolCallOutput.Caller.ofDirect())
+
+        /**
+         * Alias for calling [caller] with
+         * `BetaResponseCustomToolCallOutput.Caller.ofProgram(program)`.
+         */
+        fun caller(program: BetaResponseCustomToolCallOutput.Caller.Program) =
+            caller(BetaResponseCustomToolCallOutput.Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * BetaResponseCustomToolCallOutput.Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(
+                BetaResponseCustomToolCallOutput.Caller.Program.builder().callerId(callerId).build()
+            )
+
+        /**
+         * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated
+         * when items are returned via API.
+         */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        /** The identifier of the actor that created the item. */
+        fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
+
+        /**
+         * Sets [Builder.createdBy] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdBy] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun createdBy(createdBy: JsonField<String>) = apply { this.createdBy = createdBy }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseCustomToolCallOutputItem].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .callId()
+         * .output()
+         * .status()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseCustomToolCallOutputItem =
+            BetaResponseCustomToolCallOutputItem(
+                checkRequired("callId", callId),
+                checkRequired("output", output),
+                type,
+                id,
+                agent,
+                caller,
+                checkRequired("status", status),
+                createdBy,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseCustomToolCallOutputItem = apply {
+        if (validated) {
+            return@apply
+        }
+
+        callId()
+        output().validate()
+        _type().let {
+            if (it != JsonValue.from("custom_tool_call_output")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        id()
+        agent().ifPresent { it.validate() }
+        caller().ifPresent { it.validate() }
+        status().validate()
+        createdBy()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (callId.asKnown().isPresent) 1 else 0) +
+            (output.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("custom_tool_call_output")) 1 else 0 } +
+            (if (id.asKnown().isPresent) 1 else 0) +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (createdBy.asKnown().isPresent) 1 else 0)
+
+    /**
+     * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+     * items are returned via API.
+     */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseCustomToolCallOutputItem &&
+            callId == other.callId &&
+            output == other.output &&
+            type == other.type &&
+            id == other.id &&
+            agent == other.agent &&
+            caller == other.caller &&
+            status == other.status &&
+            createdBy == other.createdBy &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            callId,
+            output,
+            type,
+            id,
+            agent,
+            caller,
+            status,
+            createdBy,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseCustomToolCallOutputItem{callId=$callId, output=$output, type=$type, id=$id, agent=$agent, caller=$caller, status=$status, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseError.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseError.kt
new file mode 100644
index 000000000..cb4d0e6c5
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseError.kt
@@ -0,0 +1,458 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import kotlin.jvm.optionals.getOrNull
+
+/** An error object returned when the model fails to generate a Response. */
+class BetaResponseError
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val code: JsonField<Code>,
+    private val message: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("code") @ExcludeMissing code: JsonField<Code> = JsonMissing.of(),
+        @JsonProperty("message") @ExcludeMissing message: JsonField<String> = JsonMissing.of(),
+    ) : this(code, message, mutableMapOf())
+
+    /**
+     * The error code for the response.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun code(): Code = code.getRequired("code")
+
+    /**
+     * A human-readable description of the error.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun message(): String = message.getRequired("message")
+
+    /**
+     * Returns the raw JSON value of [code].
+     *
+     * Unlike [code], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<Code> = code
+
+    /**
+     * Returns the raw JSON value of [message].
+     *
+     * Unlike [message], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("message") @ExcludeMissing fun _message(): JsonField<String> = message
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseError].
+         *
+         * The following fields are required:
+         * ```java
+         * .code()
+         * .message()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseError]. */
+    class Builder internal constructor() {
+
+        private var code: JsonField<Code>? = null
+        private var message: JsonField<String>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseError: BetaResponseError) = apply {
+            code = betaResponseError.code
+            message = betaResponseError.message
+            additionalProperties = betaResponseError.additionalProperties.toMutableMap()
+        }
+
+        /** The error code for the response. */
+        fun code(code: Code) = code(JsonField.of(code))
+
+        /**
+         * Sets [Builder.code] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.code] with a well-typed [Code] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun code(code: JsonField<Code>) = apply { this.code = code }
+
+        /** A human-readable description of the error. */
+        fun message(message: String) = message(JsonField.of(message))
+
+        /**
+         * Sets [Builder.message] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.message] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun message(message: JsonField<String>) = apply { this.message = message }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseError].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .code()
+         * .message()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseError =
+            BetaResponseError(
+                checkRequired("code", code),
+                checkRequired("message", message),
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseError = apply {
+        if (validated) {
+            return@apply
+        }
+
+        code().validate()
+        message()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (code.asKnown().getOrNull()?.validity() ?: 0) + (if (message.asKnown().isPresent) 1 else 0)
+
+    /** The error code for the response. */
+    class Code @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val SERVER_ERROR = of("server_error")
+
+            @JvmField val RATE_LIMIT_EXCEEDED = of("rate_limit_exceeded")
+
+            @JvmField val INVALID_PROMPT = of("invalid_prompt")
+
+            @JvmField val BIO_POLICY = of("bio_policy")
+
+            @JvmField val VECTOR_STORE_TIMEOUT = of("vector_store_timeout")
+
+            @JvmField val INVALID_IMAGE = of("invalid_image")
+
+            @JvmField val INVALID_IMAGE_FORMAT = of("invalid_image_format")
+
+            @JvmField val INVALID_BASE64_IMAGE = of("invalid_base64_image")
+
+            @JvmField val INVALID_IMAGE_URL = of("invalid_image_url")
+
+            @JvmField val IMAGE_TOO_LARGE = of("image_too_large")
+
+            @JvmField val IMAGE_TOO_SMALL = of("image_too_small")
+
+            @JvmField val IMAGE_PARSE_ERROR = of("image_parse_error")
+
+            @JvmField val IMAGE_CONTENT_POLICY_VIOLATION = of("image_content_policy_violation")
+
+            @JvmField val INVALID_IMAGE_MODE = of("invalid_image_mode")
+
+            @JvmField val IMAGE_FILE_TOO_LARGE = of("image_file_too_large")
+
+            @JvmField val UNSUPPORTED_IMAGE_MEDIA_TYPE = of("unsupported_image_media_type")
+
+            @JvmField val EMPTY_IMAGE_FILE = of("empty_image_file")
+
+            @JvmField val FAILED_TO_DOWNLOAD_IMAGE = of("failed_to_download_image")
+
+            @JvmField val IMAGE_FILE_NOT_FOUND = of("image_file_not_found")
+
+            @JvmStatic fun of(value: String) = Code(JsonField.of(value))
+        }
+
+        /** An enum containing [Code]'s known values. */
+        enum class Known {
+            SERVER_ERROR,
+            RATE_LIMIT_EXCEEDED,
+            INVALID_PROMPT,
+            BIO_POLICY,
+            VECTOR_STORE_TIMEOUT,
+            INVALID_IMAGE,
+            INVALID_IMAGE_FORMAT,
+            INVALID_BASE64_IMAGE,
+            INVALID_IMAGE_URL,
+            IMAGE_TOO_LARGE,
+            IMAGE_TOO_SMALL,
+            IMAGE_PARSE_ERROR,
+            IMAGE_CONTENT_POLICY_VIOLATION,
+            INVALID_IMAGE_MODE,
+            IMAGE_FILE_TOO_LARGE,
+            UNSUPPORTED_IMAGE_MEDIA_TYPE,
+            EMPTY_IMAGE_FILE,
+            FAILED_TO_DOWNLOAD_IMAGE,
+            IMAGE_FILE_NOT_FOUND,
+        }
+
+        /**
+         * An enum containing [Code]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Code] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            SERVER_ERROR,
+            RATE_LIMIT_EXCEEDED,
+            INVALID_PROMPT,
+            BIO_POLICY,
+            VECTOR_STORE_TIMEOUT,
+            INVALID_IMAGE,
+            INVALID_IMAGE_FORMAT,
+            INVALID_BASE64_IMAGE,
+            INVALID_IMAGE_URL,
+            IMAGE_TOO_LARGE,
+            IMAGE_TOO_SMALL,
+            IMAGE_PARSE_ERROR,
+            IMAGE_CONTENT_POLICY_VIOLATION,
+            INVALID_IMAGE_MODE,
+            IMAGE_FILE_TOO_LARGE,
+            UNSUPPORTED_IMAGE_MEDIA_TYPE,
+            EMPTY_IMAGE_FILE,
+            FAILED_TO_DOWNLOAD_IMAGE,
+            IMAGE_FILE_NOT_FOUND,
+            /** An enum member indicating that [Code] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                SERVER_ERROR -> Value.SERVER_ERROR
+                RATE_LIMIT_EXCEEDED -> Value.RATE_LIMIT_EXCEEDED
+                INVALID_PROMPT -> Value.INVALID_PROMPT
+                BIO_POLICY -> Value.BIO_POLICY
+                VECTOR_STORE_TIMEOUT -> Value.VECTOR_STORE_TIMEOUT
+                INVALID_IMAGE -> Value.INVALID_IMAGE
+                INVALID_IMAGE_FORMAT -> Value.INVALID_IMAGE_FORMAT
+                INVALID_BASE64_IMAGE -> Value.INVALID_BASE64_IMAGE
+                INVALID_IMAGE_URL -> Value.INVALID_IMAGE_URL
+                IMAGE_TOO_LARGE -> Value.IMAGE_TOO_LARGE
+                IMAGE_TOO_SMALL -> Value.IMAGE_TOO_SMALL
+                IMAGE_PARSE_ERROR -> Value.IMAGE_PARSE_ERROR
+                IMAGE_CONTENT_POLICY_VIOLATION -> Value.IMAGE_CONTENT_POLICY_VIOLATION
+                INVALID_IMAGE_MODE -> Value.INVALID_IMAGE_MODE
+                IMAGE_FILE_TOO_LARGE -> Value.IMAGE_FILE_TOO_LARGE
+                UNSUPPORTED_IMAGE_MEDIA_TYPE -> Value.UNSUPPORTED_IMAGE_MEDIA_TYPE
+                EMPTY_IMAGE_FILE -> Value.EMPTY_IMAGE_FILE
+                FAILED_TO_DOWNLOAD_IMAGE -> Value.FAILED_TO_DOWNLOAD_IMAGE
+                IMAGE_FILE_NOT_FOUND -> Value.IMAGE_FILE_NOT_FOUND
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                SERVER_ERROR -> Known.SERVER_ERROR
+                RATE_LIMIT_EXCEEDED -> Known.RATE_LIMIT_EXCEEDED
+                INVALID_PROMPT -> Known.INVALID_PROMPT
+                BIO_POLICY -> Known.BIO_POLICY
+                VECTOR_STORE_TIMEOUT -> Known.VECTOR_STORE_TIMEOUT
+                INVALID_IMAGE -> Known.INVALID_IMAGE
+                INVALID_IMAGE_FORMAT -> Known.INVALID_IMAGE_FORMAT
+                INVALID_BASE64_IMAGE -> Known.INVALID_BASE64_IMAGE
+                INVALID_IMAGE_URL -> Known.INVALID_IMAGE_URL
+                IMAGE_TOO_LARGE -> Known.IMAGE_TOO_LARGE
+                IMAGE_TOO_SMALL -> Known.IMAGE_TOO_SMALL
+                IMAGE_PARSE_ERROR -> Known.IMAGE_PARSE_ERROR
+                IMAGE_CONTENT_POLICY_VIOLATION -> Known.IMAGE_CONTENT_POLICY_VIOLATION
+                INVALID_IMAGE_MODE -> Known.INVALID_IMAGE_MODE
+                IMAGE_FILE_TOO_LARGE -> Known.IMAGE_FILE_TOO_LARGE
+                UNSUPPORTED_IMAGE_MEDIA_TYPE -> Known.UNSUPPORTED_IMAGE_MEDIA_TYPE
+                EMPTY_IMAGE_FILE -> Known.EMPTY_IMAGE_FILE
+                FAILED_TO_DOWNLOAD_IMAGE -> Known.FAILED_TO_DOWNLOAD_IMAGE
+                IMAGE_FILE_NOT_FOUND -> Known.IMAGE_FILE_NOT_FOUND
+                else -> throw OpenAIInvalidDataException("Unknown Code: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Code = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Code && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseError &&
+            code == other.code &&
+            message == other.message &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(code, message, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseError{code=$code, message=$message, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseErrorEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseErrorEvent.kt
new file mode 100644
index 000000000..7cb4761b7
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseErrorEvent.kt
@@ -0,0 +1,553 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when an error occurs. */
+class BetaResponseErrorEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val code: JsonField<String>,
+    private val message: JsonField<String>,
+    private val param: JsonField<String>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("code") @ExcludeMissing code: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("message") @ExcludeMissing message: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("param") @ExcludeMissing param: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(code, message, param, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The error code.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun code(): Optional<String> = code.getOptional("code")
+
+    /**
+     * The error message.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun message(): String = message.getRequired("message")
+
+    /**
+     * The error parameter.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun param(): Optional<String> = param.getOptional("param")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `error`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("error")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [code].
+     *
+     * Unlike [code], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<String> = code
+
+    /**
+     * Returns the raw JSON value of [message].
+     *
+     * Unlike [message], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("message") @ExcludeMissing fun _message(): JsonField<String> = message
+
+    /**
+     * Returns the raw JSON value of [param].
+     *
+     * Unlike [param], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("param") @ExcludeMissing fun _param(): JsonField<String> = param
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseErrorEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .code()
+         * .message()
+         * .param()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseErrorEvent]. */
+    class Builder internal constructor() {
+
+        private var code: JsonField<String>? = null
+        private var message: JsonField<String>? = null
+        private var param: JsonField<String>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("error")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseErrorEvent: BetaResponseErrorEvent) = apply {
+            code = betaResponseErrorEvent.code
+            message = betaResponseErrorEvent.message
+            param = betaResponseErrorEvent.param
+            sequenceNumber = betaResponseErrorEvent.sequenceNumber
+            type = betaResponseErrorEvent.type
+            agent = betaResponseErrorEvent.agent
+            additionalProperties = betaResponseErrorEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The error code. */
+        fun code(code: String?) = code(JsonField.ofNullable(code))
+
+        /** Alias for calling [Builder.code] with `code.orElse(null)`. */
+        fun code(code: Optional<String>) = code(code.getOrNull())
+
+        /**
+         * Sets [Builder.code] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.code] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun code(code: JsonField<String>) = apply { this.code = code }
+
+        /** The error message. */
+        fun message(message: String) = message(JsonField.of(message))
+
+        /**
+         * Sets [Builder.message] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.message] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun message(message: JsonField<String>) = apply { this.message = message }
+
+        /** The error parameter. */
+        fun param(param: String?) = param(JsonField.ofNullable(param))
+
+        /** Alias for calling [Builder.param] with `param.orElse(null)`. */
+        fun param(param: Optional<String>) = param(param.getOrNull())
+
+        /**
+         * Sets [Builder.param] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.param] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun param(param: JsonField<String>) = apply { this.param = param }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("error")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseErrorEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .code()
+         * .message()
+         * .param()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseErrorEvent =
+            BetaResponseErrorEvent(
+                checkRequired("code", code),
+                checkRequired("message", message),
+                checkRequired("param", param),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseErrorEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        code()
+        message()
+        param()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("error")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (code.asKnown().isPresent) 1 else 0) +
+            (if (message.asKnown().isPresent) 1 else 0) +
+            (if (param.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("error")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseErrorEvent &&
+            code == other.code &&
+            message == other.message &&
+            param == other.param &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(code, message, param, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseErrorEvent{code=$code, message=$message, param=$param, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFailedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFailedEvent.kt
new file mode 100644
index 000000000..cce2f0376
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFailedEvent.kt
@@ -0,0 +1,478 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** An event that is emitted when a response fails. */
+class BetaResponseFailedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val response: JsonField<BetaResponse>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("response")
+        @ExcludeMissing
+        response: JsonField<BetaResponse> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(response, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The response that failed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun response(): BetaResponse = response.getRequired("response")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.failed`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.failed")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [response].
+     *
+     * Unlike [response], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("response") @ExcludeMissing fun _response(): JsonField<BetaResponse> = response
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseFailedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .response()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseFailedEvent]. */
+    class Builder internal constructor() {
+
+        private var response: JsonField<BetaResponse>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.failed")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseFailedEvent: BetaResponseFailedEvent) = apply {
+            response = betaResponseFailedEvent.response
+            sequenceNumber = betaResponseFailedEvent.sequenceNumber
+            type = betaResponseFailedEvent.type
+            agent = betaResponseFailedEvent.agent
+            additionalProperties = betaResponseFailedEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The response that failed. */
+        fun response(response: BetaResponse) = response(JsonField.of(response))
+
+        /**
+         * Sets [Builder.response] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.response] with a well-typed [BetaResponse] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun response(response: JsonField<BetaResponse>) = apply { this.response = response }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.failed")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseFailedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .response()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseFailedEvent =
+            BetaResponseFailedEvent(
+                checkRequired("response", response),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFailedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        response().validate()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.failed")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (response.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.failed")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFailedEvent &&
+            response == other.response &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(response, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseFailedEvent{response=$response, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallCompletedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallCompletedEvent.kt
new file mode 100644
index 000000000..960549c37
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallCompletedEvent.kt
@@ -0,0 +1,518 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a file search call is completed (results found). */
+class BetaResponseFileSearchCallCompletedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The ID of the output item that the file search call is initiated.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item that the file search call is initiated.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.file_search_call.completed`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.file_search_call.completed")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseFileSearchCallCompletedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseFileSearchCallCompletedEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.file_search_call.completed")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseFileSearchCallCompletedEvent: BetaResponseFileSearchCallCompletedEvent
+        ) = apply {
+            itemId = betaResponseFileSearchCallCompletedEvent.itemId
+            outputIndex = betaResponseFileSearchCallCompletedEvent.outputIndex
+            sequenceNumber = betaResponseFileSearchCallCompletedEvent.sequenceNumber
+            type = betaResponseFileSearchCallCompletedEvent.type
+            agent = betaResponseFileSearchCallCompletedEvent.agent
+            additionalProperties =
+                betaResponseFileSearchCallCompletedEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The ID of the output item that the file search call is initiated. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item that the file search call is initiated. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.file_search_call.completed")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseFileSearchCallCompletedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseFileSearchCallCompletedEvent =
+            BetaResponseFileSearchCallCompletedEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFileSearchCallCompletedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.file_search_call.completed")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.file_search_call.completed")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFileSearchCallCompletedEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseFileSearchCallCompletedEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallInProgressEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallInProgressEvent.kt
new file mode 100644
index 000000000..5537f04b5
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallInProgressEvent.kt
@@ -0,0 +1,520 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a file search call is initiated. */
+class BetaResponseFileSearchCallInProgressEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The ID of the output item that the file search call is initiated.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item that the file search call is initiated.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.file_search_call.in_progress`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.file_search_call.in_progress")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseFileSearchCallInProgressEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseFileSearchCallInProgressEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.file_search_call.in_progress")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseFileSearchCallInProgressEvent: BetaResponseFileSearchCallInProgressEvent
+        ) = apply {
+            itemId = betaResponseFileSearchCallInProgressEvent.itemId
+            outputIndex = betaResponseFileSearchCallInProgressEvent.outputIndex
+            sequenceNumber = betaResponseFileSearchCallInProgressEvent.sequenceNumber
+            type = betaResponseFileSearchCallInProgressEvent.type
+            agent = betaResponseFileSearchCallInProgressEvent.agent
+            additionalProperties =
+                betaResponseFileSearchCallInProgressEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The ID of the output item that the file search call is initiated. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item that the file search call is initiated. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.file_search_call.in_progress")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseFileSearchCallInProgressEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseFileSearchCallInProgressEvent =
+            BetaResponseFileSearchCallInProgressEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFileSearchCallInProgressEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.file_search_call.in_progress")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.file_search_call.in_progress")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFileSearchCallInProgressEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseFileSearchCallInProgressEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallSearchingEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallSearchingEvent.kt
new file mode 100644
index 000000000..abd83c22c
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallSearchingEvent.kt
@@ -0,0 +1,518 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a file search is currently searching. */
+class BetaResponseFileSearchCallSearchingEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The ID of the output item that the file search call is initiated.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item that the file search call is searching.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.file_search_call.searching`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.file_search_call.searching")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseFileSearchCallSearchingEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseFileSearchCallSearchingEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.file_search_call.searching")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseFileSearchCallSearchingEvent: BetaResponseFileSearchCallSearchingEvent
+        ) = apply {
+            itemId = betaResponseFileSearchCallSearchingEvent.itemId
+            outputIndex = betaResponseFileSearchCallSearchingEvent.outputIndex
+            sequenceNumber = betaResponseFileSearchCallSearchingEvent.sequenceNumber
+            type = betaResponseFileSearchCallSearchingEvent.type
+            agent = betaResponseFileSearchCallSearchingEvent.agent
+            additionalProperties =
+                betaResponseFileSearchCallSearchingEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The ID of the output item that the file search call is initiated. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item that the file search call is searching. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.file_search_call.searching")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseFileSearchCallSearchingEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseFileSearchCallSearchingEvent =
+            BetaResponseFileSearchCallSearchingEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFileSearchCallSearchingEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.file_search_call.searching")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.file_search_call.searching")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFileSearchCallSearchingEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseFileSearchCallSearchingEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchToolCall.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchToolCall.kt
new file mode 100644
index 000000000..1e828219b
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchToolCall.kt
@@ -0,0 +1,1180 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * The results of a file search tool call. See the
+ * [file search guide](https://platform.openai.com/docs/guides/tools-file-search) for more
+ * information.
+ */
+class BetaResponseFileSearchToolCall
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val queries: JsonField<List<String>>,
+    private val status: JsonField<Status>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val results: JsonField<List<Result>>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("queries")
+        @ExcludeMissing
+        queries: JsonField<List<String>> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("results") @ExcludeMissing results: JsonField<List<Result>> = JsonMissing.of(),
+    ) : this(id, queries, status, type, agent, results, mutableMapOf())
+
+    /**
+     * The unique ID of the file search tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * The queries used to search for files.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun queries(): List<String> = queries.getRequired("queries")
+
+    /**
+     * The status of the file search tool call. One of `in_progress`, `searching`, `incomplete` or
+     * `failed`,
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun status(): Status = status.getRequired("status")
+
+    /**
+     * The type of the file search tool call. Always `file_search_call`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("file_search_call")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * The results of the file search tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun results(): Optional<List<Result>> = results.getOptional("results")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [queries].
+     *
+     * Unlike [queries], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("queries") @ExcludeMissing fun _queries(): JsonField<List<String>> = queries
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [results].
+     *
+     * Unlike [results], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("results") @ExcludeMissing fun _results(): JsonField<List<Result>> = results
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseFileSearchToolCall].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .queries()
+         * .status()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseFileSearchToolCall]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var queries: JsonField<MutableList<String>>? = null
+        private var status: JsonField<Status>? = null
+        private var type: JsonValue = JsonValue.from("file_search_call")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var results: JsonField<MutableList<Result>>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseFileSearchToolCall: BetaResponseFileSearchToolCall) = apply {
+            id = betaResponseFileSearchToolCall.id
+            queries = betaResponseFileSearchToolCall.queries.map { it.toMutableList() }
+            status = betaResponseFileSearchToolCall.status
+            type = betaResponseFileSearchToolCall.type
+            agent = betaResponseFileSearchToolCall.agent
+            results = betaResponseFileSearchToolCall.results.map { it.toMutableList() }
+            additionalProperties =
+                betaResponseFileSearchToolCall.additionalProperties.toMutableMap()
+        }
+
+        /** The unique ID of the file search tool call. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The queries used to search for files. */
+        fun queries(queries: List<String>) = queries(JsonField.of(queries))
+
+        /**
+         * Sets [Builder.queries] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.queries] with a well-typed `List<String>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun queries(queries: JsonField<List<String>>) = apply {
+            this.queries = queries.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [String] to [queries].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addQuery(query: String) = apply {
+            queries =
+                (queries ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("queries", it).add(query)
+                }
+        }
+
+        /**
+         * The status of the file search tool call. One of `in_progress`, `searching`, `incomplete`
+         * or `failed`,
+         */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("file_search_call")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /** The results of the file search tool call. */
+        fun results(results: List<Result>?) = results(JsonField.ofNullable(results))
+
+        /** Alias for calling [Builder.results] with `results.orElse(null)`. */
+        fun results(results: Optional<List<Result>>) = results(results.getOrNull())
+
+        /**
+         * Sets [Builder.results] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.results] with a well-typed `List<Result>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun results(results: JsonField<List<Result>>) = apply {
+            this.results = results.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Result] to [results].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addResult(result: Result) = apply {
+            results =
+                (results ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("results", it).add(result)
+                }
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseFileSearchToolCall].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .queries()
+         * .status()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseFileSearchToolCall =
+            BetaResponseFileSearchToolCall(
+                checkRequired("id", id),
+                checkRequired("queries", queries).map { it.toImmutable() },
+                checkRequired("status", status),
+                type,
+                agent,
+                (results ?: JsonMissing.of()).map { it.toImmutable() },
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFileSearchToolCall = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        queries()
+        status().validate()
+        _type().let {
+            if (it != JsonValue.from("file_search_call")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        results().ifPresent { it.forEach { it.validate() } }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (queries.asKnown().getOrNull()?.size ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("file_search_call")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (results.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+    /**
+     * The status of the file search tool call. One of `in_progress`, `searching`, `incomplete` or
+     * `failed`,
+     */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val SEARCHING = of("searching")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmField val FAILED = of("failed")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            SEARCHING,
+            COMPLETED,
+            INCOMPLETE,
+            FAILED,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            SEARCHING,
+            COMPLETED,
+            INCOMPLETE,
+            FAILED,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                SEARCHING -> Value.SEARCHING
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                FAILED -> Value.FAILED
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                SEARCHING -> Known.SEARCHING
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                FAILED -> Known.FAILED
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    class Result
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val attributes: JsonField<Attributes>,
+        private val fileId: JsonField<String>,
+        private val filename: JsonField<String>,
+        private val score: JsonField<Float>,
+        private val text: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("attributes")
+            @ExcludeMissing
+            attributes: JsonField<Attributes> = JsonMissing.of(),
+            @JsonProperty("file_id") @ExcludeMissing fileId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("filename")
+            @ExcludeMissing
+            filename: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("score") @ExcludeMissing score: JsonField<Float> = JsonMissing.of(),
+            @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+        ) : this(attributes, fileId, filename, score, text, mutableMapOf())
+
+        /**
+         * Set of 16 key-value pairs that can be attached to an object. This can be useful for
+         * storing additional information about the object in a structured format, and querying for
+         * objects via API or the dashboard. Keys are strings with a maximum length of 64
+         * characters. Values are strings with a maximum length of 512 characters, booleans, or
+         * numbers.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun attributes(): Optional<Attributes> = attributes.getOptional("attributes")
+
+        /**
+         * The unique ID of the file.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun fileId(): Optional<String> = fileId.getOptional("file_id")
+
+        /**
+         * The name of the file.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun filename(): Optional<String> = filename.getOptional("filename")
+
+        /**
+         * The relevance score of the file - a value between 0 and 1.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun score(): Optional<Float> = score.getOptional("score")
+
+        /**
+         * The text that was retrieved from the file.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun text(): Optional<String> = text.getOptional("text")
+
+        /**
+         * Returns the raw JSON value of [attributes].
+         *
+         * Unlike [attributes], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("attributes")
+        @ExcludeMissing
+        fun _attributes(): JsonField<Attributes> = attributes
+
+        /**
+         * Returns the raw JSON value of [fileId].
+         *
+         * Unlike [fileId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("file_id") @ExcludeMissing fun _fileId(): JsonField<String> = fileId
+
+        /**
+         * Returns the raw JSON value of [filename].
+         *
+         * Unlike [filename], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("filename") @ExcludeMissing fun _filename(): JsonField<String> = filename
+
+        /**
+         * Returns the raw JSON value of [score].
+         *
+         * Unlike [score], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("score") @ExcludeMissing fun _score(): JsonField<Float> = score
+
+        /**
+         * Returns the raw JSON value of [text].
+         *
+         * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Result]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Result]. */
+        class Builder internal constructor() {
+
+            private var attributes: JsonField<Attributes> = JsonMissing.of()
+            private var fileId: JsonField<String> = JsonMissing.of()
+            private var filename: JsonField<String> = JsonMissing.of()
+            private var score: JsonField<Float> = JsonMissing.of()
+            private var text: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(result: Result) = apply {
+                attributes = result.attributes
+                fileId = result.fileId
+                filename = result.filename
+                score = result.score
+                text = result.text
+                additionalProperties = result.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Set of 16 key-value pairs that can be attached to an object. This can be useful for
+             * storing additional information about the object in a structured format, and querying
+             * for objects via API or the dashboard. Keys are strings with a maximum length of 64
+             * characters. Values are strings with a maximum length of 512 characters, booleans, or
+             * numbers.
+             */
+            fun attributes(attributes: Attributes?) = attributes(JsonField.ofNullable(attributes))
+
+            /** Alias for calling [Builder.attributes] with `attributes.orElse(null)`. */
+            fun attributes(attributes: Optional<Attributes>) = attributes(attributes.getOrNull())
+
+            /**
+             * Sets [Builder.attributes] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.attributes] with a well-typed [Attributes] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun attributes(attributes: JsonField<Attributes>) = apply {
+                this.attributes = attributes
+            }
+
+            /** The unique ID of the file. */
+            fun fileId(fileId: String) = fileId(JsonField.of(fileId))
+
+            /**
+             * Sets [Builder.fileId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.fileId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun fileId(fileId: JsonField<String>) = apply { this.fileId = fileId }
+
+            /** The name of the file. */
+            fun filename(filename: String) = filename(JsonField.of(filename))
+
+            /**
+             * Sets [Builder.filename] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.filename] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun filename(filename: JsonField<String>) = apply { this.filename = filename }
+
+            /** The relevance score of the file - a value between 0 and 1. */
+            fun score(score: Float) = score(JsonField.of(score))
+
+            /**
+             * Sets [Builder.score] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.score] with a well-typed [Float] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun score(score: JsonField<Float>) = apply { this.score = score }
+
+            /** The text that was retrieved from the file. */
+            fun text(text: String) = text(JsonField.of(text))
+
+            /**
+             * Sets [Builder.text] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.text] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun text(text: JsonField<String>) = apply { this.text = text }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Result].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Result =
+                Result(
+                    attributes,
+                    fileId,
+                    filename,
+                    score,
+                    text,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Result = apply {
+            if (validated) {
+                return@apply
+            }
+
+            attributes().ifPresent { it.validate() }
+            fileId()
+            filename()
+            score()
+            text()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (attributes.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (fileId.asKnown().isPresent) 1 else 0) +
+                (if (filename.asKnown().isPresent) 1 else 0) +
+                (if (score.asKnown().isPresent) 1 else 0) +
+                (if (text.asKnown().isPresent) 1 else 0)
+
+        /**
+         * Set of 16 key-value pairs that can be attached to an object. This can be useful for
+         * storing additional information about the object in a structured format, and querying for
+         * objects via API or the dashboard. Keys are strings with a maximum length of 64
+         * characters. Values are strings with a maximum length of 512 characters, booleans, or
+         * numbers.
+         */
+        class Attributes
+        @JsonCreator
+        private constructor(
+            @com.fasterxml.jackson.annotation.JsonValue
+            private val additionalProperties: Map<String, JsonValue>
+        ) {
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /** Returns a mutable builder for constructing an instance of [Attributes]. */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Attributes]. */
+            class Builder internal constructor() {
+
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(attributes: Attributes) = apply {
+                    additionalProperties = attributes.additionalProperties.toMutableMap()
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Attributes].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): Attributes = Attributes(additionalProperties.toImmutable())
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Attributes = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                additionalProperties.count { (_, value) -> !value.isNull() && !value.isMissing() }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Attributes && additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() = "Attributes{additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Result &&
+                attributes == other.attributes &&
+                fileId == other.fileId &&
+                filename == other.filename &&
+                score == other.score &&
+                text == other.text &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(attributes, fileId, filename, score, text, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Result{attributes=$attributes, fileId=$fileId, filename=$filename, score=$score, text=$text, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFileSearchToolCall &&
+            id == other.id &&
+            queries == other.queries &&
+            status == other.status &&
+            type == other.type &&
+            agent == other.agent &&
+            results == other.results &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(id, queries, status, type, agent, results, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseFileSearchToolCall{id=$id, queries=$queries, status=$status, type=$type, agent=$agent, results=$results, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFormatTextConfig.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFormatTextConfig.kt
new file mode 100644
index 000000000..1a04add7a
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFormatTextConfig.kt
@@ -0,0 +1,332 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.JsonValue
+import com.openai.core.getOrThrow
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * An object specifying the format that the model must output.
+ *
+ * Configuring `{ "type": "json_schema" }` enables Structured Outputs, which ensures the model will
+ * match your supplied JSON schema. Learn more in the
+ * [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+ *
+ * The default format is `{ "type": "text" }` with no additional options.
+ *
+ * **Not recommended for gpt-4o and newer models:**
+ *
+ * Setting to `{ "type": "json_object" }` enables the older JSON mode, which ensures the message the
+ * model generates is valid JSON. Using `json_schema` is preferred for models that support it.
+ */
+@JsonDeserialize(using = BetaResponseFormatTextConfig.Deserializer::class)
+@JsonSerialize(using = BetaResponseFormatTextConfig.Serializer::class)
+class BetaResponseFormatTextConfig
+private constructor(
+    private val text: JsonValue? = null,
+    private val jsonSchema: BetaResponseFormatTextJsonSchemaConfig? = null,
+    private val jsonObject: JsonValue? = null,
+    private val _json: JsonValue? = null,
+) {
+
+    /** Default response format. Used to generate text responses. */
+    fun text(): Optional<JsonValue> = Optional.ofNullable(text)
+
+    /**
+     * JSON Schema response format. Used to generate structured JSON responses. Learn more about
+     * [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs).
+     */
+    fun jsonSchema(): Optional<BetaResponseFormatTextJsonSchemaConfig> =
+        Optional.ofNullable(jsonSchema)
+
+    /**
+     * JSON object response format. An older method of generating JSON responses. Using
+     * `json_schema` is recommended for models that support it. Note that the model will not
+     * generate JSON without a system or user message instructing it to do so.
+     */
+    fun jsonObject(): Optional<JsonValue> = Optional.ofNullable(jsonObject)
+
+    fun isText(): Boolean = text != null
+
+    fun isJsonSchema(): Boolean = jsonSchema != null
+
+    fun isJsonObject(): Boolean = jsonObject != null
+
+    /** Default response format. Used to generate text responses. */
+    fun asText(): JsonValue = text.getOrThrow("text")
+
+    /**
+     * JSON Schema response format. Used to generate structured JSON responses. Learn more about
+     * [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs).
+     */
+    fun asJsonSchema(): BetaResponseFormatTextJsonSchemaConfig = jsonSchema.getOrThrow("jsonSchema")
+
+    /**
+     * JSON object response format. An older method of generating JSON responses. Using
+     * `json_schema` is recommended for models that support it. Note that the model will not
+     * generate JSON without a system or user message instructing it to do so.
+     */
+    fun asJsonObject(): JsonValue = jsonObject.getOrThrow("jsonObject")
+
+    fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+    /**
+     * Maps this instance's current variant to a value of type [T] using the given [visitor].
+     *
+     * Note that this method is _not_ forwards compatible with new variants from the API, unless
+     * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of the
+     * SDK gracefully, consider overriding [Visitor.unknown]:
+     * ```java
+     * import com.openai.core.JsonValue;
+     * import java.util.Optional;
+     *
+     * Optional<String> result = betaResponseFormatTextConfig.accept(new BetaResponseFormatTextConfig.Visitor<Optional<String>>() {
+     *     @Override
+     *     public Optional<String> visitText(JsonValue text) {
+     *         return Optional.of(text.toString());
+     *     }
+     *
+     *     // ...
+     *
+     *     @Override
+     *     public Optional<String> unknown(JsonValue json) {
+     *         // Or inspect the `json`.
+     *         return Optional.empty();
+     *     }
+     * });
+     * ```
+     *
+     * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor] and
+     *   the current variant is unknown.
+     */
+    fun <T> accept(visitor: Visitor<T>): T =
+        when {
+            text != null -> visitor.visitText(text)
+            jsonSchema != null -> visitor.visitJsonSchema(jsonSchema)
+            jsonObject != null -> visitor.visitJsonObject(jsonObject)
+            else -> visitor.unknown(_json)
+        }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFormatTextConfig = apply {
+        if (validated) {
+            return@apply
+        }
+
+        accept(
+            object : Visitor<Unit> {
+                override fun visitText(text: JsonValue) {
+                    text.let {
+                        if (it != JsonValue.from(mapOf("type" to "text"))) {
+                            throw OpenAIInvalidDataException("'text' is invalid, received $it")
+                        }
+                    }
+                }
+
+                override fun visitJsonSchema(jsonSchema: BetaResponseFormatTextJsonSchemaConfig) {
+                    jsonSchema.validate()
+                }
+
+                override fun visitJsonObject(jsonObject: JsonValue) {
+                    jsonObject.let {
+                        if (it != JsonValue.from(mapOf("type" to "json_object"))) {
+                            throw OpenAIInvalidDataException(
+                                "'jsonObject' is invalid, received $it"
+                            )
+                        }
+                    }
+                }
+            }
+        )
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        accept(
+            object : Visitor<Int> {
+                override fun visitText(text: JsonValue) =
+                    text.let { if (it == JsonValue.from(mapOf("type" to "text"))) 1 else 0 }
+
+                override fun visitJsonSchema(jsonSchema: BetaResponseFormatTextJsonSchemaConfig) =
+                    jsonSchema.validity()
+
+                override fun visitJsonObject(jsonObject: JsonValue) =
+                    jsonObject.let {
+                        if (it == JsonValue.from(mapOf("type" to "json_object"))) 1 else 0
+                    }
+
+                override fun unknown(json: JsonValue?) = 0
+            }
+        )
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFormatTextConfig &&
+            text == other.text &&
+            jsonSchema == other.jsonSchema &&
+            jsonObject == other.jsonObject
+    }
+
+    override fun hashCode(): Int = Objects.hash(text, jsonSchema, jsonObject)
+
+    override fun toString(): String =
+        when {
+            text != null -> "BetaResponseFormatTextConfig{text=$text}"
+            jsonSchema != null -> "BetaResponseFormatTextConfig{jsonSchema=$jsonSchema}"
+            jsonObject != null -> "BetaResponseFormatTextConfig{jsonObject=$jsonObject}"
+            _json != null -> "BetaResponseFormatTextConfig{_unknown=$_json}"
+            else -> throw IllegalStateException("Invalid BetaResponseFormatTextConfig")
+        }
+
+    companion object {
+
+        /** Default response format. Used to generate text responses. */
+        @JvmStatic
+        fun ofText() = BetaResponseFormatTextConfig(text = JsonValue.from(mapOf("type" to "text")))
+
+        /**
+         * JSON Schema response format. Used to generate structured JSON responses. Learn more about
+         * [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs).
+         */
+        @JvmStatic
+        fun ofJsonSchema(jsonSchema: BetaResponseFormatTextJsonSchemaConfig) =
+            BetaResponseFormatTextConfig(jsonSchema = jsonSchema)
+
+        /**
+         * JSON object response format. An older method of generating JSON responses. Using
+         * `json_schema` is recommended for models that support it. Note that the model will not
+         * generate JSON without a system or user message instructing it to do so.
+         */
+        @JvmStatic
+        fun ofJsonObject() =
+            BetaResponseFormatTextConfig(
+                jsonObject = JsonValue.from(mapOf("type" to "json_object"))
+            )
+    }
+
+    /**
+     * An interface that defines how to map each variant of [BetaResponseFormatTextConfig] to a
+     * value of type [T].
+     */
+    interface Visitor<out T> {
+
+        /** Default response format. Used to generate text responses. */
+        fun visitText(text: JsonValue): T
+
+        /**
+         * JSON Schema response format. Used to generate structured JSON responses. Learn more about
+         * [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs).
+         */
+        fun visitJsonSchema(jsonSchema: BetaResponseFormatTextJsonSchemaConfig): T
+
+        /**
+         * JSON object response format. An older method of generating JSON responses. Using
+         * `json_schema` is recommended for models that support it. Note that the model will not
+         * generate JSON without a system or user message instructing it to do so.
+         */
+        fun visitJsonObject(jsonObject: JsonValue): T
+
+        /**
+         * Maps an unknown variant of [BetaResponseFormatTextConfig] to a value of type [T].
+         *
+         * An instance of [BetaResponseFormatTextConfig] can contain an unknown variant if it was
+         * deserialized from data that doesn't match any known variant. For example, if the SDK is
+         * on an older version than the API, then the API may respond with new variants that the SDK
+         * is unaware of.
+         *
+         * @throws OpenAIInvalidDataException in the default implementation.
+         */
+        fun unknown(json: JsonValue?): T {
+            throw OpenAIInvalidDataException("Unknown BetaResponseFormatTextConfig: $json")
+        }
+    }
+
+    internal class Deserializer :
+        BaseDeserializer<BetaResponseFormatTextConfig>(BetaResponseFormatTextConfig::class) {
+
+        override fun ObjectCodec.deserialize(node: JsonNode): BetaResponseFormatTextConfig {
+            val json = JsonValue.fromJsonNode(node)
+            val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+            when (type) {
+                "text" -> {
+                    return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                        ?.let { BetaResponseFormatTextConfig(text = it, _json = json) }
+                        ?.takeIf { it.isValid() } ?: BetaResponseFormatTextConfig(_json = json)
+                }
+                "json_schema" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseFormatTextJsonSchemaConfig>(),
+                        )
+                        ?.let { BetaResponseFormatTextConfig(jsonSchema = it, _json = json) }
+                        ?: BetaResponseFormatTextConfig(_json = json)
+                }
+                "json_object" -> {
+                    return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                        ?.let { BetaResponseFormatTextConfig(jsonObject = it, _json = json) }
+                        ?.takeIf { it.isValid() } ?: BetaResponseFormatTextConfig(_json = json)
+                }
+            }
+
+            return BetaResponseFormatTextConfig(_json = json)
+        }
+    }
+
+    internal class Serializer :
+        BaseSerializer<BetaResponseFormatTextConfig>(BetaResponseFormatTextConfig::class) {
+
+        override fun serialize(
+            value: BetaResponseFormatTextConfig,
+            generator: JsonGenerator,
+            provider: SerializerProvider,
+        ) {
+            when {
+                value.text != null -> generator.writeObject(value.text)
+                value.jsonSchema != null -> generator.writeObject(value.jsonSchema)
+                value.jsonObject != null -> generator.writeObject(value.jsonObject)
+                value._json != null -> generator.writeObject(value._json)
+                else -> throw IllegalStateException("Invalid BetaResponseFormatTextConfig")
+            }
+        }
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFormatTextJsonSchemaConfig.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFormatTextJsonSchemaConfig.kt
new file mode 100644
index 000000000..80a7bac0e
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFormatTextJsonSchemaConfig.kt
@@ -0,0 +1,484 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * JSON Schema response format. Used to generate structured JSON responses. Learn more about
+ * [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs).
+ */
+class BetaResponseFormatTextJsonSchemaConfig
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val name: JsonField<String>,
+    private val schema: JsonField<Schema>,
+    private val type: JsonValue,
+    private val description: JsonField<String>,
+    private val strict: JsonField<Boolean>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("schema") @ExcludeMissing schema: JsonField<Schema> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("description")
+        @ExcludeMissing
+        description: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("strict") @ExcludeMissing strict: JsonField<Boolean> = JsonMissing.of(),
+    ) : this(name, schema, type, description, strict, mutableMapOf())
+
+    /**
+     * The name of the response format. Must be a-z, A-Z, 0-9, or contain underscores and dashes,
+     * with a maximum length of 64.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun name(): String = name.getRequired("name")
+
+    /**
+     * The schema for the response format, described as a JSON Schema object. Learn how to build
+     * JSON schemas [here](https://json-schema.org/).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun schema(): Schema = schema.getRequired("schema")
+
+    /**
+     * The type of response format being defined. Always `json_schema`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("json_schema")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * A description of what the response format is for, used by the model to determine how to
+     * respond in the format.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun description(): Optional<String> = description.getOptional("description")
+
+    /**
+     * Whether to enable strict schema adherence when generating the output. If set to true, the
+     * model will always follow the exact schema defined in the `schema` field. Only a subset of
+     * JSON Schema is supported when `strict` is `true`. To learn more, read the
+     * [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun strict(): Optional<Boolean> = strict.getOptional("strict")
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    /**
+     * Returns the raw JSON value of [schema].
+     *
+     * Unlike [schema], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("schema") @ExcludeMissing fun _schema(): JsonField<Schema> = schema
+
+    /**
+     * Returns the raw JSON value of [description].
+     *
+     * Unlike [description], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("description") @ExcludeMissing fun _description(): JsonField<String> = description
+
+    /**
+     * Returns the raw JSON value of [strict].
+     *
+     * Unlike [strict], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("strict") @ExcludeMissing fun _strict(): JsonField<Boolean> = strict
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseFormatTextJsonSchemaConfig].
+         *
+         * The following fields are required:
+         * ```java
+         * .name()
+         * .schema()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseFormatTextJsonSchemaConfig]. */
+    class Builder internal constructor() {
+
+        private var name: JsonField<String>? = null
+        private var schema: JsonField<Schema>? = null
+        private var type: JsonValue = JsonValue.from("json_schema")
+        private var description: JsonField<String> = JsonMissing.of()
+        private var strict: JsonField<Boolean> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseFormatTextJsonSchemaConfig: BetaResponseFormatTextJsonSchemaConfig
+        ) = apply {
+            name = betaResponseFormatTextJsonSchemaConfig.name
+            schema = betaResponseFormatTextJsonSchemaConfig.schema
+            type = betaResponseFormatTextJsonSchemaConfig.type
+            description = betaResponseFormatTextJsonSchemaConfig.description
+            strict = betaResponseFormatTextJsonSchemaConfig.strict
+            additionalProperties =
+                betaResponseFormatTextJsonSchemaConfig.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * The name of the response format. Must be a-z, A-Z, 0-9, or contain underscores and
+         * dashes, with a maximum length of 64.
+         */
+        fun name(name: String) = name(JsonField.of(name))
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        /**
+         * The schema for the response format, described as a JSON Schema object. Learn how to build
+         * JSON schemas [here](https://json-schema.org/).
+         */
+        fun schema(schema: Schema) = schema(JsonField.of(schema))
+
+        /**
+         * Sets [Builder.schema] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.schema] with a well-typed [Schema] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun schema(schema: JsonField<Schema>) = apply { this.schema = schema }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("json_schema")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /**
+         * A description of what the response format is for, used by the model to determine how to
+         * respond in the format.
+         */
+        fun description(description: String) = description(JsonField.of(description))
+
+        /**
+         * Sets [Builder.description] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.description] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun description(description: JsonField<String>) = apply { this.description = description }
+
+        /**
+         * Whether to enable strict schema adherence when generating the output. If set to true, the
+         * model will always follow the exact schema defined in the `schema` field. Only a subset of
+         * JSON Schema is supported when `strict` is `true`. To learn more, read the
+         * [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+         */
+        fun strict(strict: Boolean?) = strict(JsonField.ofNullable(strict))
+
+        /**
+         * Alias for [Builder.strict].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun strict(strict: Boolean) = strict(strict as Boolean?)
+
+        /** Alias for calling [Builder.strict] with `strict.orElse(null)`. */
+        fun strict(strict: Optional<Boolean>) = strict(strict.getOrNull())
+
+        /**
+         * Sets [Builder.strict] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.strict] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun strict(strict: JsonField<Boolean>) = apply { this.strict = strict }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseFormatTextJsonSchemaConfig].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .name()
+         * .schema()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseFormatTextJsonSchemaConfig =
+            BetaResponseFormatTextJsonSchemaConfig(
+                checkRequired("name", name),
+                checkRequired("schema", schema),
+                type,
+                description,
+                strict,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFormatTextJsonSchemaConfig = apply {
+        if (validated) {
+            return@apply
+        }
+
+        name()
+        schema().validate()
+        _type().let {
+            if (it != JsonValue.from("json_schema")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        description()
+        strict()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (name.asKnown().isPresent) 1 else 0) +
+            (schema.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("json_schema")) 1 else 0 } +
+            (if (description.asKnown().isPresent) 1 else 0) +
+            (if (strict.asKnown().isPresent) 1 else 0)
+
+    /**
+     * The schema for the response format, described as a JSON Schema object. Learn how to build
+     * JSON schemas [here](https://json-schema.org/).
+     */
+    class Schema
+    @JsonCreator
+    private constructor(
+        @com.fasterxml.jackson.annotation.JsonValue
+        private val additionalProperties: Map<String, JsonValue>
+    ) {
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Schema]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Schema]. */
+        class Builder internal constructor() {
+
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(schema: Schema) = apply {
+                additionalProperties = schema.additionalProperties.toMutableMap()
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Schema].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Schema = Schema(additionalProperties.toImmutable())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Schema = apply {
+            if (validated) {
+                return@apply
+            }
+
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            additionalProperties.count { (_, value) -> !value.isNull() && !value.isMissing() }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Schema && additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() = "Schema{additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFormatTextJsonSchemaConfig &&
+            name == other.name &&
+            schema == other.schema &&
+            type == other.type &&
+            description == other.description &&
+            strict == other.strict &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(name, schema, type, description, strict, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseFormatTextJsonSchemaConfig{name=$name, schema=$schema, type=$type, description=$description, strict=$strict, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallArgumentsDeltaEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallArgumentsDeltaEvent.kt
new file mode 100644
index 000000000..8786309f9
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallArgumentsDeltaEvent.kt
@@ -0,0 +1,556 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when there is a partial function-call arguments delta. */
+class BetaResponseFunctionCallArgumentsDeltaEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val delta: JsonField<String>,
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("delta") @ExcludeMissing delta: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(delta, itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The function-call arguments delta that is added.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun delta(): String = delta.getRequired("delta")
+
+    /**
+     * The ID of the output item that the function-call arguments delta is added to.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item that the function-call arguments delta is added to.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.function_call_arguments.delta`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.function_call_arguments.delta")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [delta].
+     *
+     * Unlike [delta], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("delta") @ExcludeMissing fun _delta(): JsonField<String> = delta
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseFunctionCallArgumentsDeltaEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .delta()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseFunctionCallArgumentsDeltaEvent]. */
+    class Builder internal constructor() {
+
+        private var delta: JsonField<String>? = null
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.function_call_arguments.delta")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseFunctionCallArgumentsDeltaEvent: BetaResponseFunctionCallArgumentsDeltaEvent
+        ) = apply {
+            delta = betaResponseFunctionCallArgumentsDeltaEvent.delta
+            itemId = betaResponseFunctionCallArgumentsDeltaEvent.itemId
+            outputIndex = betaResponseFunctionCallArgumentsDeltaEvent.outputIndex
+            sequenceNumber = betaResponseFunctionCallArgumentsDeltaEvent.sequenceNumber
+            type = betaResponseFunctionCallArgumentsDeltaEvent.type
+            agent = betaResponseFunctionCallArgumentsDeltaEvent.agent
+            additionalProperties =
+                betaResponseFunctionCallArgumentsDeltaEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The function-call arguments delta that is added. */
+        fun delta(delta: String) = delta(JsonField.of(delta))
+
+        /**
+         * Sets [Builder.delta] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.delta] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun delta(delta: JsonField<String>) = apply { this.delta = delta }
+
+        /** The ID of the output item that the function-call arguments delta is added to. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item that the function-call arguments delta is added to. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.function_call_arguments.delta")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseFunctionCallArgumentsDeltaEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .delta()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseFunctionCallArgumentsDeltaEvent =
+            BetaResponseFunctionCallArgumentsDeltaEvent(
+                checkRequired("delta", delta),
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFunctionCallArgumentsDeltaEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        delta()
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.function_call_arguments.delta")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (delta.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.function_call_arguments.delta")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFunctionCallArgumentsDeltaEvent &&
+            delta == other.delta &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(delta, itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseFunctionCallArgumentsDeltaEvent{delta=$delta, itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallArgumentsDoneEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallArgumentsDoneEvent.kt
new file mode 100644
index 000000000..0bff8ebe5
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallArgumentsDoneEvent.kt
@@ -0,0 +1,600 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when function-call arguments are finalized. */
+class BetaResponseFunctionCallArgumentsDoneEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val arguments: JsonField<String>,
+    private val itemId: JsonField<String>,
+    private val name: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("arguments") @ExcludeMissing arguments: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(arguments, itemId, name, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The function-call arguments.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun arguments(): String = arguments.getRequired("arguments")
+
+    /**
+     * The ID of the item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The name of the function that was called.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun name(): String = name.getRequired("name")
+
+    /**
+     * The index of the output item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.function_call_arguments.done")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [arguments].
+     *
+     * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseFunctionCallArgumentsDoneEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .arguments()
+         * .itemId()
+         * .name()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseFunctionCallArgumentsDoneEvent]. */
+    class Builder internal constructor() {
+
+        private var arguments: JsonField<String>? = null
+        private var itemId: JsonField<String>? = null
+        private var name: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.function_call_arguments.done")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseFunctionCallArgumentsDoneEvent: BetaResponseFunctionCallArgumentsDoneEvent
+        ) = apply {
+            arguments = betaResponseFunctionCallArgumentsDoneEvent.arguments
+            itemId = betaResponseFunctionCallArgumentsDoneEvent.itemId
+            name = betaResponseFunctionCallArgumentsDoneEvent.name
+            outputIndex = betaResponseFunctionCallArgumentsDoneEvent.outputIndex
+            sequenceNumber = betaResponseFunctionCallArgumentsDoneEvent.sequenceNumber
+            type = betaResponseFunctionCallArgumentsDoneEvent.type
+            agent = betaResponseFunctionCallArgumentsDoneEvent.agent
+            additionalProperties =
+                betaResponseFunctionCallArgumentsDoneEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The function-call arguments. */
+        fun arguments(arguments: String) = arguments(JsonField.of(arguments))
+
+        /**
+         * Sets [Builder.arguments] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.arguments] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
+
+        /** The ID of the item. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The name of the function that was called. */
+        fun name(name: String) = name(JsonField.of(name))
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        /** The index of the output item. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.function_call_arguments.done")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseFunctionCallArgumentsDoneEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .arguments()
+         * .itemId()
+         * .name()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseFunctionCallArgumentsDoneEvent =
+            BetaResponseFunctionCallArgumentsDoneEvent(
+                checkRequired("arguments", arguments),
+                checkRequired("itemId", itemId),
+                checkRequired("name", name),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFunctionCallArgumentsDoneEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        arguments()
+        itemId()
+        name()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.function_call_arguments.done")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (arguments.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (name.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.function_call_arguments.done")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFunctionCallArgumentsDoneEvent &&
+            arguments == other.arguments &&
+            itemId == other.itemId &&
+            name == other.name &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            arguments,
+            itemId,
+            name,
+            outputIndex,
+            sequenceNumber,
+            type,
+            agent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseFunctionCallArgumentsDoneEvent{arguments=$arguments, itemId=$itemId, name=$name, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallOutputItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallOutputItem.kt
new file mode 100644
index 000000000..0c1ca265b
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallOutputItem.kt
@@ -0,0 +1,290 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.JsonValue
+import com.openai.core.getOrThrow
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** A piece of message content, such as text, an image, or a file. */
+@JsonDeserialize(using = BetaResponseFunctionCallOutputItem.Deserializer::class)
+@JsonSerialize(using = BetaResponseFunctionCallOutputItem.Serializer::class)
+class BetaResponseFunctionCallOutputItem
+private constructor(
+    private val inputText: BetaResponseInputTextContent? = null,
+    private val inputImage: BetaResponseInputImageContent? = null,
+    private val inputFile: BetaResponseInputFileContent? = null,
+    private val _json: JsonValue? = null,
+) {
+
+    /** A text input to the model. */
+    fun inputText(): Optional<BetaResponseInputTextContent> = Optional.ofNullable(inputText)
+
+    /**
+     * An image input to the model. Learn about
+     * [image inputs](https://platform.openai.com/docs/guides/vision)
+     */
+    fun inputImage(): Optional<BetaResponseInputImageContent> = Optional.ofNullable(inputImage)
+
+    /** A file input to the model. */
+    fun inputFile(): Optional<BetaResponseInputFileContent> = Optional.ofNullable(inputFile)
+
+    fun isInputText(): Boolean = inputText != null
+
+    fun isInputImage(): Boolean = inputImage != null
+
+    fun isInputFile(): Boolean = inputFile != null
+
+    /** A text input to the model. */
+    fun asInputText(): BetaResponseInputTextContent = inputText.getOrThrow("inputText")
+
+    /**
+     * An image input to the model. Learn about
+     * [image inputs](https://platform.openai.com/docs/guides/vision)
+     */
+    fun asInputImage(): BetaResponseInputImageContent = inputImage.getOrThrow("inputImage")
+
+    /** A file input to the model. */
+    fun asInputFile(): BetaResponseInputFileContent = inputFile.getOrThrow("inputFile")
+
+    fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+    /**
+     * Maps this instance's current variant to a value of type [T] using the given [visitor].
+     *
+     * Note that this method is _not_ forwards compatible with new variants from the API, unless
+     * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of the
+     * SDK gracefully, consider overriding [Visitor.unknown]:
+     * ```java
+     * import com.openai.core.JsonValue;
+     * import java.util.Optional;
+     *
+     * Optional<String> result = betaResponseFunctionCallOutputItem.accept(new BetaResponseFunctionCallOutputItem.Visitor<Optional<String>>() {
+     *     @Override
+     *     public Optional<String> visitInputText(BetaResponseInputTextContent inputText) {
+     *         return Optional.of(inputText.toString());
+     *     }
+     *
+     *     // ...
+     *
+     *     @Override
+     *     public Optional<String> unknown(JsonValue json) {
+     *         // Or inspect the `json`.
+     *         return Optional.empty();
+     *     }
+     * });
+     * ```
+     *
+     * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor] and
+     *   the current variant is unknown.
+     */
+    fun <T> accept(visitor: Visitor<T>): T =
+        when {
+            inputText != null -> visitor.visitInputText(inputText)
+            inputImage != null -> visitor.visitInputImage(inputImage)
+            inputFile != null -> visitor.visitInputFile(inputFile)
+            else -> visitor.unknown(_json)
+        }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFunctionCallOutputItem = apply {
+        if (validated) {
+            return@apply
+        }
+
+        accept(
+            object : Visitor<Unit> {
+                override fun visitInputText(inputText: BetaResponseInputTextContent) {
+                    inputText.validate()
+                }
+
+                override fun visitInputImage(inputImage: BetaResponseInputImageContent) {
+                    inputImage.validate()
+                }
+
+                override fun visitInputFile(inputFile: BetaResponseInputFileContent) {
+                    inputFile.validate()
+                }
+            }
+        )
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        accept(
+            object : Visitor<Int> {
+                override fun visitInputText(inputText: BetaResponseInputTextContent) =
+                    inputText.validity()
+
+                override fun visitInputImage(inputImage: BetaResponseInputImageContent) =
+                    inputImage.validity()
+
+                override fun visitInputFile(inputFile: BetaResponseInputFileContent) =
+                    inputFile.validity()
+
+                override fun unknown(json: JsonValue?) = 0
+            }
+        )
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFunctionCallOutputItem &&
+            inputText == other.inputText &&
+            inputImage == other.inputImage &&
+            inputFile == other.inputFile
+    }
+
+    override fun hashCode(): Int = Objects.hash(inputText, inputImage, inputFile)
+
+    override fun toString(): String =
+        when {
+            inputText != null -> "BetaResponseFunctionCallOutputItem{inputText=$inputText}"
+            inputImage != null -> "BetaResponseFunctionCallOutputItem{inputImage=$inputImage}"
+            inputFile != null -> "BetaResponseFunctionCallOutputItem{inputFile=$inputFile}"
+            _json != null -> "BetaResponseFunctionCallOutputItem{_unknown=$_json}"
+            else -> throw IllegalStateException("Invalid BetaResponseFunctionCallOutputItem")
+        }
+
+    companion object {
+
+        /** A text input to the model. */
+        @JvmStatic
+        fun ofInputText(inputText: BetaResponseInputTextContent) =
+            BetaResponseFunctionCallOutputItem(inputText = inputText)
+
+        /**
+         * An image input to the model. Learn about
+         * [image inputs](https://platform.openai.com/docs/guides/vision)
+         */
+        @JvmStatic
+        fun ofInputImage(inputImage: BetaResponseInputImageContent) =
+            BetaResponseFunctionCallOutputItem(inputImage = inputImage)
+
+        /** A file input to the model. */
+        @JvmStatic
+        fun ofInputFile(inputFile: BetaResponseInputFileContent) =
+            BetaResponseFunctionCallOutputItem(inputFile = inputFile)
+    }
+
+    /**
+     * An interface that defines how to map each variant of [BetaResponseFunctionCallOutputItem] to
+     * a value of type [T].
+     */
+    interface Visitor<out T> {
+
+        /** A text input to the model. */
+        fun visitInputText(inputText: BetaResponseInputTextContent): T
+
+        /**
+         * An image input to the model. Learn about
+         * [image inputs](https://platform.openai.com/docs/guides/vision)
+         */
+        fun visitInputImage(inputImage: BetaResponseInputImageContent): T
+
+        /** A file input to the model. */
+        fun visitInputFile(inputFile: BetaResponseInputFileContent): T
+
+        /**
+         * Maps an unknown variant of [BetaResponseFunctionCallOutputItem] to a value of type [T].
+         *
+         * An instance of [BetaResponseFunctionCallOutputItem] can contain an unknown variant if it
+         * was deserialized from data that doesn't match any known variant. For example, if the SDK
+         * is on an older version than the API, then the API may respond with new variants that the
+         * SDK is unaware of.
+         *
+         * @throws OpenAIInvalidDataException in the default implementation.
+         */
+        fun unknown(json: JsonValue?): T {
+            throw OpenAIInvalidDataException("Unknown BetaResponseFunctionCallOutputItem: $json")
+        }
+    }
+
+    internal class Deserializer :
+        BaseDeserializer<BetaResponseFunctionCallOutputItem>(
+            BetaResponseFunctionCallOutputItem::class
+        ) {
+
+        override fun ObjectCodec.deserialize(node: JsonNode): BetaResponseFunctionCallOutputItem {
+            val json = JsonValue.fromJsonNode(node)
+            val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+            when (type) {
+                "input_text" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseInputTextContent>())
+                        ?.let { BetaResponseFunctionCallOutputItem(inputText = it, _json = json) }
+                        ?: BetaResponseFunctionCallOutputItem(_json = json)
+                }
+                "input_image" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseInputImageContent>())
+                        ?.let { BetaResponseFunctionCallOutputItem(inputImage = it, _json = json) }
+                        ?: BetaResponseFunctionCallOutputItem(_json = json)
+                }
+                "input_file" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseInputFileContent>())
+                        ?.let { BetaResponseFunctionCallOutputItem(inputFile = it, _json = json) }
+                        ?: BetaResponseFunctionCallOutputItem(_json = json)
+                }
+            }
+
+            return BetaResponseFunctionCallOutputItem(_json = json)
+        }
+    }
+
+    internal class Serializer :
+        BaseSerializer<BetaResponseFunctionCallOutputItem>(
+            BetaResponseFunctionCallOutputItem::class
+        ) {
+
+        override fun serialize(
+            value: BetaResponseFunctionCallOutputItem,
+            generator: JsonGenerator,
+            provider: SerializerProvider,
+        ) {
+            when {
+                value.inputText != null -> generator.writeObject(value.inputText)
+                value.inputImage != null -> generator.writeObject(value.inputImage)
+                value.inputFile != null -> generator.writeObject(value.inputFile)
+                value._json != null -> generator.writeObject(value._json)
+                else -> throw IllegalStateException("Invalid BetaResponseFunctionCallOutputItem")
+            }
+        }
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellCallOutputContent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellCallOutputContent.kt
new file mode 100644
index 000000000..426993ef9
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellCallOutputContent.kt
@@ -0,0 +1,731 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Captured stdout and stderr for a portion of a shell tool call output. */
+class BetaResponseFunctionShellCallOutputContent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val outcome: JsonField<Outcome>,
+    private val stderr: JsonField<String>,
+    private val stdout: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("outcome") @ExcludeMissing outcome: JsonField<Outcome> = JsonMissing.of(),
+        @JsonProperty("stderr") @ExcludeMissing stderr: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("stdout") @ExcludeMissing stdout: JsonField<String> = JsonMissing.of(),
+    ) : this(outcome, stderr, stdout, mutableMapOf())
+
+    /**
+     * The exit or timeout outcome associated with this shell call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outcome(): Outcome = outcome.getRequired("outcome")
+
+    /**
+     * Captured stderr output for the shell call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun stderr(): String = stderr.getRequired("stderr")
+
+    /**
+     * Captured stdout output for the shell call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun stdout(): String = stdout.getRequired("stdout")
+
+    /**
+     * Returns the raw JSON value of [outcome].
+     *
+     * Unlike [outcome], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("outcome") @ExcludeMissing fun _outcome(): JsonField<Outcome> = outcome
+
+    /**
+     * Returns the raw JSON value of [stderr].
+     *
+     * Unlike [stderr], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("stderr") @ExcludeMissing fun _stderr(): JsonField<String> = stderr
+
+    /**
+     * Returns the raw JSON value of [stdout].
+     *
+     * Unlike [stdout], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("stdout") @ExcludeMissing fun _stdout(): JsonField<String> = stdout
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseFunctionShellCallOutputContent].
+         *
+         * The following fields are required:
+         * ```java
+         * .outcome()
+         * .stderr()
+         * .stdout()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseFunctionShellCallOutputContent]. */
+    class Builder internal constructor() {
+
+        private var outcome: JsonField<Outcome>? = null
+        private var stderr: JsonField<String>? = null
+        private var stdout: JsonField<String>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseFunctionShellCallOutputContent: BetaResponseFunctionShellCallOutputContent
+        ) = apply {
+            outcome = betaResponseFunctionShellCallOutputContent.outcome
+            stderr = betaResponseFunctionShellCallOutputContent.stderr
+            stdout = betaResponseFunctionShellCallOutputContent.stdout
+            additionalProperties =
+                betaResponseFunctionShellCallOutputContent.additionalProperties.toMutableMap()
+        }
+
+        /** The exit or timeout outcome associated with this shell call. */
+        fun outcome(outcome: Outcome) = outcome(JsonField.of(outcome))
+
+        /**
+         * Sets [Builder.outcome] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outcome] with a well-typed [Outcome] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun outcome(outcome: JsonField<Outcome>) = apply { this.outcome = outcome }
+
+        /** Alias for calling [outcome] with `Outcome.ofTimeout()`. */
+        fun outcomeTimeout() = outcome(Outcome.ofTimeout())
+
+        /** Alias for calling [outcome] with `Outcome.ofExit(exit)`. */
+        fun outcome(exit: Outcome.Exit) = outcome(Outcome.ofExit(exit))
+
+        /**
+         * Alias for calling [outcome] with the following:
+         * ```java
+         * Outcome.Exit.builder()
+         *     .exitCode(exitCode)
+         *     .build()
+         * ```
+         */
+        fun exitOutcome(exitCode: Long) = outcome(Outcome.Exit.builder().exitCode(exitCode).build())
+
+        /** Captured stderr output for the shell call. */
+        fun stderr(stderr: String) = stderr(JsonField.of(stderr))
+
+        /**
+         * Sets [Builder.stderr] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.stderr] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun stderr(stderr: JsonField<String>) = apply { this.stderr = stderr }
+
+        /** Captured stdout output for the shell call. */
+        fun stdout(stdout: String) = stdout(JsonField.of(stdout))
+
+        /**
+         * Sets [Builder.stdout] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.stdout] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun stdout(stdout: JsonField<String>) = apply { this.stdout = stdout }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseFunctionShellCallOutputContent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .outcome()
+         * .stderr()
+         * .stdout()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseFunctionShellCallOutputContent =
+            BetaResponseFunctionShellCallOutputContent(
+                checkRequired("outcome", outcome),
+                checkRequired("stderr", stderr),
+                checkRequired("stdout", stdout),
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFunctionShellCallOutputContent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        outcome().validate()
+        stderr()
+        stdout()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (outcome.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (stderr.asKnown().isPresent) 1 else 0) +
+            (if (stdout.asKnown().isPresent) 1 else 0)
+
+    /** The exit or timeout outcome associated with this shell call. */
+    @JsonDeserialize(using = Outcome.Deserializer::class)
+    @JsonSerialize(using = Outcome.Serializer::class)
+    class Outcome
+    private constructor(
+        private val timeout: JsonValue? = null,
+        private val exit: Exit? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** Indicates that the shell call exceeded its configured time limit. */
+        fun timeout(): Optional<JsonValue> = Optional.ofNullable(timeout)
+
+        /** Indicates that the shell commands finished and returned an exit code. */
+        fun exit(): Optional<Exit> = Optional.ofNullable(exit)
+
+        fun isTimeout(): Boolean = timeout != null
+
+        fun isExit(): Boolean = exit != null
+
+        /** Indicates that the shell call exceeded its configured time limit. */
+        fun asTimeout(): JsonValue = timeout.getOrThrow("timeout")
+
+        /** Indicates that the shell commands finished and returned an exit code. */
+        fun asExit(): Exit = exit.getOrThrow("exit")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = outcome.accept(new Outcome.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitTimeout(JsonValue timeout) {
+         *         return Optional.of(timeout.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                timeout != null -> visitor.visitTimeout(timeout)
+                exit != null -> visitor.visitExit(exit)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Outcome = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitTimeout(timeout: JsonValue) {
+                        timeout.let {
+                            if (it != JsonValue.from(mapOf("type" to "timeout"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'timeout' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitExit(exit: Exit) {
+                        exit.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitTimeout(timeout: JsonValue) =
+                        timeout.let {
+                            if (it == JsonValue.from(mapOf("type" to "timeout"))) 1 else 0
+                        }
+
+                    override fun visitExit(exit: Exit) = exit.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Outcome && timeout == other.timeout && exit == other.exit
+        }
+
+        override fun hashCode(): Int = Objects.hash(timeout, exit)
+
+        override fun toString(): String =
+            when {
+                timeout != null -> "Outcome{timeout=$timeout}"
+                exit != null -> "Outcome{exit=$exit}"
+                _json != null -> "Outcome{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Outcome")
+            }
+
+        companion object {
+
+            /** Indicates that the shell call exceeded its configured time limit. */
+            @JvmStatic
+            fun ofTimeout() = Outcome(timeout = JsonValue.from(mapOf("type" to "timeout")))
+
+            /** Indicates that the shell commands finished and returned an exit code. */
+            @JvmStatic fun ofExit(exit: Exit) = Outcome(exit = exit)
+        }
+
+        /**
+         * An interface that defines how to map each variant of [Outcome] to a value of type [T].
+         */
+        interface Visitor<out T> {
+
+            /** Indicates that the shell call exceeded its configured time limit. */
+            fun visitTimeout(timeout: JsonValue): T
+
+            /** Indicates that the shell commands finished and returned an exit code. */
+            fun visitExit(exit: Exit): T
+
+            /**
+             * Maps an unknown variant of [Outcome] to a value of type [T].
+             *
+             * An instance of [Outcome] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Outcome: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Outcome>(Outcome::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Outcome {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "timeout" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Outcome(timeout = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Outcome(_json = json)
+                    }
+                    "exit" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Exit>())?.let {
+                            Outcome(exit = it, _json = json)
+                        } ?: Outcome(_json = json)
+                    }
+                }
+
+                return Outcome(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Outcome>(Outcome::class) {
+
+            override fun serialize(
+                value: Outcome,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.timeout != null -> generator.writeObject(value.timeout)
+                    value.exit != null -> generator.writeObject(value.exit)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Outcome")
+                }
+            }
+        }
+
+        /** Indicates that the shell commands finished and returned an exit code. */
+        class Exit
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val exitCode: JsonField<Long>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("exit_code")
+                @ExcludeMissing
+                exitCode: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(exitCode, type, mutableMapOf())
+
+            /**
+             * The exit code returned by the shell process.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun exitCode(): Long = exitCode.getRequired("exit_code")
+
+            /**
+             * The outcome type. Always `exit`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("exit")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [exitCode].
+             *
+             * Unlike [exitCode], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("exit_code") @ExcludeMissing fun _exitCode(): JsonField<Long> = exitCode
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Exit].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .exitCode()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Exit]. */
+            class Builder internal constructor() {
+
+                private var exitCode: JsonField<Long>? = null
+                private var type: JsonValue = JsonValue.from("exit")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(exit: Exit) = apply {
+                    exitCode = exit.exitCode
+                    type = exit.type
+                    additionalProperties = exit.additionalProperties.toMutableMap()
+                }
+
+                /** The exit code returned by the shell process. */
+                fun exitCode(exitCode: Long) = exitCode(JsonField.of(exitCode))
+
+                /**
+                 * Sets [Builder.exitCode] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.exitCode] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun exitCode(exitCode: JsonField<Long>) = apply { this.exitCode = exitCode }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("exit")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Exit].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .exitCode()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Exit =
+                    Exit(
+                        checkRequired("exitCode", exitCode),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Exit = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                exitCode()
+                _type().let {
+                    if (it != JsonValue.from("exit")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (exitCode.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("exit")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Exit &&
+                    exitCode == other.exitCode &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(exitCode, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Exit{exitCode=$exitCode, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFunctionShellCallOutputContent &&
+            outcome == other.outcome &&
+            stderr == other.stderr &&
+            stdout == other.stdout &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(outcome, stderr, stdout, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseFunctionShellCallOutputContent{outcome=$outcome, stderr=$stderr, stdout=$stdout, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellToolCall.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellToolCall.kt
new file mode 100644
index 000000000..6c8940b88
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellToolCall.kt
@@ -0,0 +1,1819 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** A tool call that executes one or more shell commands in a managed environment. */
+class BetaResponseFunctionShellToolCall
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val action: JsonField<Action>,
+    private val callId: JsonField<String>,
+    private val environment: JsonField<Environment>,
+    private val status: JsonField<Status>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val caller: JsonField<Caller>,
+    private val createdBy: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
+        @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("environment")
+        @ExcludeMissing
+        environment: JsonField<Environment> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+        @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
+    ) : this(
+        id,
+        action,
+        callId,
+        environment,
+        status,
+        type,
+        agent,
+        caller,
+        createdBy,
+        mutableMapOf(),
+    )
+
+    /**
+     * The unique ID of the shell tool call. Populated when this item is returned via API.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * The shell commands and limits that describe how to run the tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun action(): Action = action.getRequired("action")
+
+    /**
+     * The unique ID of the shell tool call generated by the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun callId(): String = callId.getRequired("call_id")
+
+    /**
+     * Represents the use of a local environment to perform shell actions.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun environment(): Optional<Environment> = environment.getOptional("environment")
+
+    /**
+     * The status of the shell call. One of `in_progress`, `completed`, or `incomplete`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun status(): Status = status.getRequired("status")
+
+    /**
+     * The type of the item. Always `shell_call`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("shell_call")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<Caller> = caller.getOptional("caller")
+
+    /**
+     * The ID of the entity that created this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdBy(): Optional<String> = createdBy.getOptional("created_by")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [action].
+     *
+     * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+
+    /**
+     * Returns the raw JSON value of [callId].
+     *
+     * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+    /**
+     * Returns the raw JSON value of [environment].
+     *
+     * Unlike [environment], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("environment")
+    @ExcludeMissing
+    fun _environment(): JsonField<Environment> = environment
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
+    /**
+     * Returns the raw JSON value of [createdBy].
+     *
+     * Unlike [createdBy], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_by") @ExcludeMissing fun _createdBy(): JsonField<String> = createdBy
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseFunctionShellToolCall].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .action()
+         * .callId()
+         * .environment()
+         * .status()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseFunctionShellToolCall]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var action: JsonField<Action>? = null
+        private var callId: JsonField<String>? = null
+        private var environment: JsonField<Environment>? = null
+        private var status: JsonField<Status>? = null
+        private var type: JsonValue = JsonValue.from("shell_call")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var caller: JsonField<Caller> = JsonMissing.of()
+        private var createdBy: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseFunctionShellToolCall: BetaResponseFunctionShellToolCall) =
+            apply {
+                id = betaResponseFunctionShellToolCall.id
+                action = betaResponseFunctionShellToolCall.action
+                callId = betaResponseFunctionShellToolCall.callId
+                environment = betaResponseFunctionShellToolCall.environment
+                status = betaResponseFunctionShellToolCall.status
+                type = betaResponseFunctionShellToolCall.type
+                agent = betaResponseFunctionShellToolCall.agent
+                caller = betaResponseFunctionShellToolCall.caller
+                createdBy = betaResponseFunctionShellToolCall.createdBy
+                additionalProperties =
+                    betaResponseFunctionShellToolCall.additionalProperties.toMutableMap()
+            }
+
+        /** The unique ID of the shell tool call. Populated when this item is returned via API. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The shell commands and limits that describe how to run the tool call. */
+        fun action(action: Action) = action(JsonField.of(action))
+
+        /**
+         * Sets [Builder.action] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.action] with a well-typed [Action] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun action(action: JsonField<Action>) = apply { this.action = action }
+
+        /** The unique ID of the shell tool call generated by the model. */
+        fun callId(callId: String) = callId(JsonField.of(callId))
+
+        /**
+         * Sets [Builder.callId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.callId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+        /** Represents the use of a local environment to perform shell actions. */
+        fun environment(environment: Environment?) = environment(JsonField.ofNullable(environment))
+
+        /** Alias for calling [Builder.environment] with `environment.orElse(null)`. */
+        fun environment(environment: Optional<Environment>) = environment(environment.getOrNull())
+
+        /**
+         * Sets [Builder.environment] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.environment] with a well-typed [Environment] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun environment(environment: JsonField<Environment>) = apply {
+            this.environment = environment
+        }
+
+        /** Alias for calling [environment] with `Environment.ofLocal(local)`. */
+        fun environment(local: BetaResponseLocalEnvironment) =
+            environment(Environment.ofLocal(local))
+
+        /**
+         * Alias for calling [environment] with
+         * `Environment.ofContainerReference(containerReference)`.
+         */
+        fun environment(containerReference: BetaResponseContainerReference) =
+            environment(Environment.ofContainerReference(containerReference))
+
+        /**
+         * Alias for calling [environment] with the following:
+         * ```java
+         * BetaResponseContainerReference.builder()
+         *     .containerId(containerId)
+         *     .build()
+         * ```
+         */
+        fun containerReferenceEnvironment(containerId: String) =
+            environment(BetaResponseContainerReference.builder().containerId(containerId).build())
+
+        /** The status of the shell call. One of `in_progress`, `completed`, or `incomplete`. */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("shell_call")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /** The execution context that produced this tool call. */
+        fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed [Caller] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+        /** Alias for calling [caller] with `Caller.ofDirect()`. */
+        fun callerDirect() = caller(Caller.ofDirect())
+
+        /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+        fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(Caller.Program.builder().callerId(callerId).build())
+
+        /** The ID of the entity that created this tool call. */
+        fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
+
+        /**
+         * Sets [Builder.createdBy] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdBy] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun createdBy(createdBy: JsonField<String>) = apply { this.createdBy = createdBy }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseFunctionShellToolCall].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .action()
+         * .callId()
+         * .environment()
+         * .status()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseFunctionShellToolCall =
+            BetaResponseFunctionShellToolCall(
+                checkRequired("id", id),
+                checkRequired("action", action),
+                checkRequired("callId", callId),
+                checkRequired("environment", environment),
+                checkRequired("status", status),
+                type,
+                agent,
+                caller,
+                createdBy,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFunctionShellToolCall = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        action().validate()
+        callId()
+        environment().ifPresent { it.validate() }
+        status().validate()
+        _type().let {
+            if (it != JsonValue.from("shell_call")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        caller().ifPresent { it.validate() }
+        createdBy()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (action.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (callId.asKnown().isPresent) 1 else 0) +
+            (environment.asKnown().getOrNull()?.validity() ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("shell_call")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (createdBy.asKnown().isPresent) 1 else 0)
+
+    /** The shell commands and limits that describe how to run the tool call. */
+    class Action
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val commands: JsonField<List<String>>,
+        private val maxOutputLength: JsonField<Long>,
+        private val timeoutMs: JsonField<Long>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("commands")
+            @ExcludeMissing
+            commands: JsonField<List<String>> = JsonMissing.of(),
+            @JsonProperty("max_output_length")
+            @ExcludeMissing
+            maxOutputLength: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("timeout_ms")
+            @ExcludeMissing
+            timeoutMs: JsonField<Long> = JsonMissing.of(),
+        ) : this(commands, maxOutputLength, timeoutMs, mutableMapOf())
+
+        /**
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun commands(): List<String> = commands.getRequired("commands")
+
+        /**
+         * Optional maximum number of characters to return from each command.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun maxOutputLength(): Optional<Long> = maxOutputLength.getOptional("max_output_length")
+
+        /**
+         * Optional timeout in milliseconds for the commands.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun timeoutMs(): Optional<Long> = timeoutMs.getOptional("timeout_ms")
+
+        /**
+         * Returns the raw JSON value of [commands].
+         *
+         * Unlike [commands], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("commands")
+        @ExcludeMissing
+        fun _commands(): JsonField<List<String>> = commands
+
+        /**
+         * Returns the raw JSON value of [maxOutputLength].
+         *
+         * Unlike [maxOutputLength], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("max_output_length")
+        @ExcludeMissing
+        fun _maxOutputLength(): JsonField<Long> = maxOutputLength
+
+        /**
+         * Returns the raw JSON value of [timeoutMs].
+         *
+         * Unlike [timeoutMs], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("timeout_ms") @ExcludeMissing fun _timeoutMs(): JsonField<Long> = timeoutMs
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Action].
+             *
+             * The following fields are required:
+             * ```java
+             * .commands()
+             * .maxOutputLength()
+             * .timeoutMs()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Action]. */
+        class Builder internal constructor() {
+
+            private var commands: JsonField<MutableList<String>>? = null
+            private var maxOutputLength: JsonField<Long>? = null
+            private var timeoutMs: JsonField<Long>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(action: Action) = apply {
+                commands = action.commands.map { it.toMutableList() }
+                maxOutputLength = action.maxOutputLength
+                timeoutMs = action.timeoutMs
+                additionalProperties = action.additionalProperties.toMutableMap()
+            }
+
+            fun commands(commands: List<String>) = commands(JsonField.of(commands))
+
+            /**
+             * Sets [Builder.commands] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.commands] with a well-typed `List<String>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun commands(commands: JsonField<List<String>>) = apply {
+                this.commands = commands.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [String] to [commands].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addCommand(command: String) = apply {
+                commands =
+                    (commands ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("commands", it).add(command)
+                    }
+            }
+
+            /** Optional maximum number of characters to return from each command. */
+            fun maxOutputLength(maxOutputLength: Long?) =
+                maxOutputLength(JsonField.ofNullable(maxOutputLength))
+
+            /**
+             * Alias for [Builder.maxOutputLength].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun maxOutputLength(maxOutputLength: Long) = maxOutputLength(maxOutputLength as Long?)
+
+            /** Alias for calling [Builder.maxOutputLength] with `maxOutputLength.orElse(null)`. */
+            fun maxOutputLength(maxOutputLength: Optional<Long>) =
+                maxOutputLength(maxOutputLength.getOrNull())
+
+            /**
+             * Sets [Builder.maxOutputLength] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.maxOutputLength] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun maxOutputLength(maxOutputLength: JsonField<Long>) = apply {
+                this.maxOutputLength = maxOutputLength
+            }
+
+            /** Optional timeout in milliseconds for the commands. */
+            fun timeoutMs(timeoutMs: Long?) = timeoutMs(JsonField.ofNullable(timeoutMs))
+
+            /**
+             * Alias for [Builder.timeoutMs].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun timeoutMs(timeoutMs: Long) = timeoutMs(timeoutMs as Long?)
+
+            /** Alias for calling [Builder.timeoutMs] with `timeoutMs.orElse(null)`. */
+            fun timeoutMs(timeoutMs: Optional<Long>) = timeoutMs(timeoutMs.getOrNull())
+
+            /**
+             * Sets [Builder.timeoutMs] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.timeoutMs] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun timeoutMs(timeoutMs: JsonField<Long>) = apply { this.timeoutMs = timeoutMs }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Action].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .commands()
+             * .maxOutputLength()
+             * .timeoutMs()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Action =
+                Action(
+                    checkRequired("commands", commands).map { it.toImmutable() },
+                    checkRequired("maxOutputLength", maxOutputLength),
+                    checkRequired("timeoutMs", timeoutMs),
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Action = apply {
+            if (validated) {
+                return@apply
+            }
+
+            commands()
+            maxOutputLength()
+            timeoutMs()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (commands.asKnown().getOrNull()?.size ?: 0) +
+                (if (maxOutputLength.asKnown().isPresent) 1 else 0) +
+                (if (timeoutMs.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Action &&
+                commands == other.commands &&
+                maxOutputLength == other.maxOutputLength &&
+                timeoutMs == other.timeoutMs &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(commands, maxOutputLength, timeoutMs, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Action{commands=$commands, maxOutputLength=$maxOutputLength, timeoutMs=$timeoutMs, additionalProperties=$additionalProperties}"
+    }
+
+    /** Represents the use of a local environment to perform shell actions. */
+    @JsonDeserialize(using = Environment.Deserializer::class)
+    @JsonSerialize(using = Environment.Serializer::class)
+    class Environment
+    private constructor(
+        private val local: BetaResponseLocalEnvironment? = null,
+        private val containerReference: BetaResponseContainerReference? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** Represents the use of a local environment to perform shell actions. */
+        fun local(): Optional<BetaResponseLocalEnvironment> = Optional.ofNullable(local)
+
+        /** Represents a container created with /v1/containers. */
+        fun containerReference(): Optional<BetaResponseContainerReference> =
+            Optional.ofNullable(containerReference)
+
+        fun isLocal(): Boolean = local != null
+
+        fun isContainerReference(): Boolean = containerReference != null
+
+        /** Represents the use of a local environment to perform shell actions. */
+        fun asLocal(): BetaResponseLocalEnvironment = local.getOrThrow("local")
+
+        /** Represents a container created with /v1/containers. */
+        fun asContainerReference(): BetaResponseContainerReference =
+            containerReference.getOrThrow("containerReference")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = environment.accept(new Environment.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitLocal(BetaResponseLocalEnvironment local) {
+         *         return Optional.of(local.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                local != null -> visitor.visitLocal(local)
+                containerReference != null -> visitor.visitContainerReference(containerReference)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Environment = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitLocal(local: BetaResponseLocalEnvironment) {
+                        local.validate()
+                    }
+
+                    override fun visitContainerReference(
+                        containerReference: BetaResponseContainerReference
+                    ) {
+                        containerReference.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitLocal(local: BetaResponseLocalEnvironment) = local.validity()
+
+                    override fun visitContainerReference(
+                        containerReference: BetaResponseContainerReference
+                    ) = containerReference.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Environment &&
+                local == other.local &&
+                containerReference == other.containerReference
+        }
+
+        override fun hashCode(): Int = Objects.hash(local, containerReference)
+
+        override fun toString(): String =
+            when {
+                local != null -> "Environment{local=$local}"
+                containerReference != null -> "Environment{containerReference=$containerReference}"
+                _json != null -> "Environment{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Environment")
+            }
+
+        companion object {
+
+            /** Represents the use of a local environment to perform shell actions. */
+            @JvmStatic fun ofLocal(local: BetaResponseLocalEnvironment) = Environment(local = local)
+
+            /** Represents a container created with /v1/containers. */
+            @JvmStatic
+            fun ofContainerReference(containerReference: BetaResponseContainerReference) =
+                Environment(containerReference = containerReference)
+        }
+
+        /**
+         * An interface that defines how to map each variant of [Environment] to a value of type
+         * [T].
+         */
+        interface Visitor<out T> {
+
+            /** Represents the use of a local environment to perform shell actions. */
+            fun visitLocal(local: BetaResponseLocalEnvironment): T
+
+            /** Represents a container created with /v1/containers. */
+            fun visitContainerReference(containerReference: BetaResponseContainerReference): T
+
+            /**
+             * Maps an unknown variant of [Environment] to a value of type [T].
+             *
+             * An instance of [Environment] can contain an unknown variant if it was deserialized
+             * from data that doesn't match any known variant. For example, if the SDK is on an
+             * older version than the API, then the API may respond with new variants that the SDK
+             * is unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Environment: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Environment>(Environment::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Environment {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "local" -> {
+                        return tryDeserialize(node, jacksonTypeRef<BetaResponseLocalEnvironment>())
+                            ?.let { Environment(local = it, _json = json) }
+                            ?: Environment(_json = json)
+                    }
+                    "container_reference" -> {
+                        return tryDeserialize(
+                                node,
+                                jacksonTypeRef<BetaResponseContainerReference>(),
+                            )
+                            ?.let { Environment(containerReference = it, _json = json) }
+                            ?: Environment(_json = json)
+                    }
+                }
+
+                return Environment(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Environment>(Environment::class) {
+
+            override fun serialize(
+                value: Environment,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.local != null -> generator.writeObject(value.local)
+                    value.containerReference != null ->
+                        generator.writeObject(value.containerReference)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Environment")
+                }
+            }
+        }
+    }
+
+    /** The status of the shell call. One of `in_progress`, `completed`, or `incomplete`. */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    /** The execution context that produced this tool call. */
+    @JsonDeserialize(using = Caller.Deserializer::class)
+    @JsonSerialize(using = Caller.Serializer::class)
+    class Caller
+    private constructor(
+        private val direct: JsonValue? = null,
+        private val program: Program? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+        fun program(): Optional<Program> = Optional.ofNullable(program)
+
+        fun isDirect(): Boolean = direct != null
+
+        fun isProgram(): Boolean = program != null
+
+        fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+        fun asProgram(): Program = program.getOrThrow("program")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDirect(JsonValue direct) {
+         *         return Optional.of(direct.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                direct != null -> visitor.visitDirect(direct)
+                program != null -> visitor.visitProgram(program)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Caller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDirect(direct: JsonValue) {
+                        direct.let {
+                            if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'direct' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitProgram(program: Program) {
+                        program.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDirect(direct: JsonValue) =
+                        direct.let { if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0 }
+
+                    override fun visitProgram(program: Program) = program.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Caller && direct == other.direct && program == other.program
+        }
+
+        override fun hashCode(): Int = Objects.hash(direct, program)
+
+        override fun toString(): String =
+            when {
+                direct != null -> "Caller{direct=$direct}"
+                program != null -> "Caller{program=$program}"
+                _json != null -> "Caller{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Caller")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+            @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+        }
+
+        /** An interface that defines how to map each variant of [Caller] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitDirect(direct: JsonValue): T
+
+            fun visitProgram(program: Program): T
+
+            /**
+             * Maps an unknown variant of [Caller] to a value of type [T].
+             *
+             * An instance of [Caller] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Caller: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "direct" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Caller(direct = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                    }
+                    "program" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                            Caller(program = it, _json = json)
+                        } ?: Caller(_json = json)
+                    }
+                }
+
+                return Caller(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+            override fun serialize(
+                value: Caller,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.direct != null -> generator.writeObject(value.direct)
+                    value.program != null -> generator.writeObject(value.program)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+            }
+        }
+
+        class Program
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val callerId: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                callerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(callerId, type, mutableMapOf())
+
+            /**
+             * The call ID of the program item that produced this tool call.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun callerId(): String = callerId.getRequired("caller_id")
+
+            /**
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [callerId].
+             *
+             * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("caller_id") @ExcludeMissing fun _callerId(): JsonField<String> = callerId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Program].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Program]. */
+            class Builder internal constructor() {
+
+                private var callerId: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("program")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(program: Program) = apply {
+                    callerId = program.callerId
+                    type = program.type
+                    additionalProperties = program.additionalProperties.toMutableMap()
+                }
+
+                /** The call ID of the program item that produced this tool call. */
+                fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                /**
+                 * Sets [Builder.callerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.callerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Program].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Program =
+                    Program(
+                        checkRequired("callerId", callerId),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Program = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                callerId()
+                _type().let {
+                    if (it != JsonValue.from("program")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (callerId.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Program &&
+                    callerId == other.callerId &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(callerId, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFunctionShellToolCall &&
+            id == other.id &&
+            action == other.action &&
+            callId == other.callId &&
+            environment == other.environment &&
+            status == other.status &&
+            type == other.type &&
+            agent == other.agent &&
+            caller == other.caller &&
+            createdBy == other.createdBy &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            id,
+            action,
+            callId,
+            environment,
+            status,
+            type,
+            agent,
+            caller,
+            createdBy,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseFunctionShellToolCall{id=$id, action=$action, callId=$callId, environment=$environment, status=$status, type=$type, agent=$agent, caller=$caller, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellToolCallOutput.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellToolCallOutput.kt
new file mode 100644
index 000000000..efdaafad1
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellToolCallOutput.kt
@@ -0,0 +1,2063 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** The output of a shell tool call that was emitted. */
+class BetaResponseFunctionShellToolCallOutput
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val callId: JsonField<String>,
+    private val maxOutputLength: JsonField<Long>,
+    private val output: JsonField<List<Output>>,
+    private val status: JsonField<Status>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val caller: JsonField<Caller>,
+    private val createdBy: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("max_output_length")
+        @ExcludeMissing
+        maxOutputLength: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("output") @ExcludeMissing output: JsonField<List<Output>> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+        @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
+    ) : this(
+        id,
+        callId,
+        maxOutputLength,
+        output,
+        status,
+        type,
+        agent,
+        caller,
+        createdBy,
+        mutableMapOf(),
+    )
+
+    /**
+     * The unique ID of the shell call output. Populated when this item is returned via API.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * The unique ID of the shell tool call generated by the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun callId(): String = callId.getRequired("call_id")
+
+    /**
+     * The maximum length of the shell command output. This is generated by the model and should be
+     * passed back with the raw output.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun maxOutputLength(): Optional<Long> = maxOutputLength.getOptional("max_output_length")
+
+    /**
+     * An array of shell call output contents
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun output(): List<Output> = output.getRequired("output")
+
+    /**
+     * The status of the shell call output. One of `in_progress`, `completed`, or `incomplete`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun status(): Status = status.getRequired("status")
+
+    /**
+     * The type of the shell call output. Always `shell_call_output`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("shell_call_output")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<Caller> = caller.getOptional("caller")
+
+    /**
+     * The identifier of the actor that created the item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdBy(): Optional<String> = createdBy.getOptional("created_by")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [callId].
+     *
+     * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+    /**
+     * Returns the raw JSON value of [maxOutputLength].
+     *
+     * Unlike [maxOutputLength], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("max_output_length")
+    @ExcludeMissing
+    fun _maxOutputLength(): JsonField<Long> = maxOutputLength
+
+    /**
+     * Returns the raw JSON value of [output].
+     *
+     * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<List<Output>> = output
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
+    /**
+     * Returns the raw JSON value of [createdBy].
+     *
+     * Unlike [createdBy], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_by") @ExcludeMissing fun _createdBy(): JsonField<String> = createdBy
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseFunctionShellToolCallOutput].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .callId()
+         * .maxOutputLength()
+         * .output()
+         * .status()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseFunctionShellToolCallOutput]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var callId: JsonField<String>? = null
+        private var maxOutputLength: JsonField<Long>? = null
+        private var output: JsonField<MutableList<Output>>? = null
+        private var status: JsonField<Status>? = null
+        private var type: JsonValue = JsonValue.from("shell_call_output")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var caller: JsonField<Caller> = JsonMissing.of()
+        private var createdBy: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseFunctionShellToolCallOutput: BetaResponseFunctionShellToolCallOutput
+        ) = apply {
+            id = betaResponseFunctionShellToolCallOutput.id
+            callId = betaResponseFunctionShellToolCallOutput.callId
+            maxOutputLength = betaResponseFunctionShellToolCallOutput.maxOutputLength
+            output = betaResponseFunctionShellToolCallOutput.output.map { it.toMutableList() }
+            status = betaResponseFunctionShellToolCallOutput.status
+            type = betaResponseFunctionShellToolCallOutput.type
+            agent = betaResponseFunctionShellToolCallOutput.agent
+            caller = betaResponseFunctionShellToolCallOutput.caller
+            createdBy = betaResponseFunctionShellToolCallOutput.createdBy
+            additionalProperties =
+                betaResponseFunctionShellToolCallOutput.additionalProperties.toMutableMap()
+        }
+
+        /** The unique ID of the shell call output. Populated when this item is returned via API. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The unique ID of the shell tool call generated by the model. */
+        fun callId(callId: String) = callId(JsonField.of(callId))
+
+        /**
+         * Sets [Builder.callId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.callId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+        /**
+         * The maximum length of the shell command output. This is generated by the model and should
+         * be passed back with the raw output.
+         */
+        fun maxOutputLength(maxOutputLength: Long?) =
+            maxOutputLength(JsonField.ofNullable(maxOutputLength))
+
+        /**
+         * Alias for [Builder.maxOutputLength].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun maxOutputLength(maxOutputLength: Long) = maxOutputLength(maxOutputLength as Long?)
+
+        /** Alias for calling [Builder.maxOutputLength] with `maxOutputLength.orElse(null)`. */
+        fun maxOutputLength(maxOutputLength: Optional<Long>) =
+            maxOutputLength(maxOutputLength.getOrNull())
+
+        /**
+         * Sets [Builder.maxOutputLength] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.maxOutputLength] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun maxOutputLength(maxOutputLength: JsonField<Long>) = apply {
+            this.maxOutputLength = maxOutputLength
+        }
+
+        /** An array of shell call output contents */
+        fun output(output: List<Output>) = output(JsonField.of(output))
+
+        /**
+         * Sets [Builder.output] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.output] with a well-typed `List<Output>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun output(output: JsonField<List<Output>>) = apply {
+            this.output = output.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Output] to [Builder.output].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addOutput(output: Output) = apply {
+            this.output =
+                (this.output ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("output", it).add(output)
+                }
+        }
+
+        /**
+         * The status of the shell call output. One of `in_progress`, `completed`, or `incomplete`.
+         */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("shell_call_output")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /** The execution context that produced this tool call. */
+        fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed [Caller] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+        /** Alias for calling [caller] with `Caller.ofDirect()`. */
+        fun callerDirect() = caller(Caller.ofDirect())
+
+        /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+        fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(Caller.Program.builder().callerId(callerId).build())
+
+        /** The identifier of the actor that created the item. */
+        fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
+
+        /**
+         * Sets [Builder.createdBy] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdBy] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun createdBy(createdBy: JsonField<String>) = apply { this.createdBy = createdBy }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseFunctionShellToolCallOutput].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .callId()
+         * .maxOutputLength()
+         * .output()
+         * .status()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseFunctionShellToolCallOutput =
+            BetaResponseFunctionShellToolCallOutput(
+                checkRequired("id", id),
+                checkRequired("callId", callId),
+                checkRequired("maxOutputLength", maxOutputLength),
+                checkRequired("output", output).map { it.toImmutable() },
+                checkRequired("status", status),
+                type,
+                agent,
+                caller,
+                createdBy,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFunctionShellToolCallOutput = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        callId()
+        maxOutputLength()
+        output().forEach { it.validate() }
+        status().validate()
+        _type().let {
+            if (it != JsonValue.from("shell_call_output")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        caller().ifPresent { it.validate() }
+        createdBy()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (if (callId.asKnown().isPresent) 1 else 0) +
+            (if (maxOutputLength.asKnown().isPresent) 1 else 0) +
+            (output.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("shell_call_output")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (createdBy.asKnown().isPresent) 1 else 0)
+
+    /** The content of a shell tool call output that was emitted. */
+    class Output
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val outcome: JsonField<Outcome>,
+        private val stderr: JsonField<String>,
+        private val stdout: JsonField<String>,
+        private val createdBy: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("outcome") @ExcludeMissing outcome: JsonField<Outcome> = JsonMissing.of(),
+            @JsonProperty("stderr") @ExcludeMissing stderr: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("stdout") @ExcludeMissing stdout: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("created_by")
+            @ExcludeMissing
+            createdBy: JsonField<String> = JsonMissing.of(),
+        ) : this(outcome, stderr, stdout, createdBy, mutableMapOf())
+
+        /**
+         * Represents either an exit outcome (with an exit code) or a timeout outcome for a shell
+         * call output chunk.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun outcome(): Outcome = outcome.getRequired("outcome")
+
+        /**
+         * The standard error output that was captured.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun stderr(): String = stderr.getRequired("stderr")
+
+        /**
+         * The standard output that was captured.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun stdout(): String = stdout.getRequired("stdout")
+
+        /**
+         * The identifier of the actor that created the item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun createdBy(): Optional<String> = createdBy.getOptional("created_by")
+
+        /**
+         * Returns the raw JSON value of [outcome].
+         *
+         * Unlike [outcome], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("outcome") @ExcludeMissing fun _outcome(): JsonField<Outcome> = outcome
+
+        /**
+         * Returns the raw JSON value of [stderr].
+         *
+         * Unlike [stderr], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("stderr") @ExcludeMissing fun _stderr(): JsonField<String> = stderr
+
+        /**
+         * Returns the raw JSON value of [stdout].
+         *
+         * Unlike [stdout], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("stdout") @ExcludeMissing fun _stdout(): JsonField<String> = stdout
+
+        /**
+         * Returns the raw JSON value of [createdBy].
+         *
+         * Unlike [createdBy], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("created_by") @ExcludeMissing fun _createdBy(): JsonField<String> = createdBy
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Output].
+             *
+             * The following fields are required:
+             * ```java
+             * .outcome()
+             * .stderr()
+             * .stdout()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Output]. */
+        class Builder internal constructor() {
+
+            private var outcome: JsonField<Outcome>? = null
+            private var stderr: JsonField<String>? = null
+            private var stdout: JsonField<String>? = null
+            private var createdBy: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(output: Output) = apply {
+                outcome = output.outcome
+                stderr = output.stderr
+                stdout = output.stdout
+                createdBy = output.createdBy
+                additionalProperties = output.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Represents either an exit outcome (with an exit code) or a timeout outcome for a
+             * shell call output chunk.
+             */
+            fun outcome(outcome: Outcome) = outcome(JsonField.of(outcome))
+
+            /**
+             * Sets [Builder.outcome] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.outcome] with a well-typed [Outcome] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun outcome(outcome: JsonField<Outcome>) = apply { this.outcome = outcome }
+
+            /** Alias for calling [outcome] with `Outcome.ofTimeout()`. */
+            fun outcomeTimeout() = outcome(Outcome.ofTimeout())
+
+            /** Alias for calling [outcome] with `Outcome.ofExit(exit)`. */
+            fun outcome(exit: Outcome.Exit) = outcome(Outcome.ofExit(exit))
+
+            /**
+             * Alias for calling [outcome] with the following:
+             * ```java
+             * Outcome.Exit.builder()
+             *     .exitCode(exitCode)
+             *     .build()
+             * ```
+             */
+            fun exitOutcome(exitCode: Long) =
+                outcome(Outcome.Exit.builder().exitCode(exitCode).build())
+
+            /** The standard error output that was captured. */
+            fun stderr(stderr: String) = stderr(JsonField.of(stderr))
+
+            /**
+             * Sets [Builder.stderr] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.stderr] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun stderr(stderr: JsonField<String>) = apply { this.stderr = stderr }
+
+            /** The standard output that was captured. */
+            fun stdout(stdout: String) = stdout(JsonField.of(stdout))
+
+            /**
+             * Sets [Builder.stdout] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.stdout] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun stdout(stdout: JsonField<String>) = apply { this.stdout = stdout }
+
+            /** The identifier of the actor that created the item. */
+            fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
+
+            /**
+             * Sets [Builder.createdBy] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.createdBy] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun createdBy(createdBy: JsonField<String>) = apply { this.createdBy = createdBy }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Output].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .outcome()
+             * .stderr()
+             * .stdout()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Output =
+                Output(
+                    checkRequired("outcome", outcome),
+                    checkRequired("stderr", stderr),
+                    checkRequired("stdout", stdout),
+                    createdBy,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Output = apply {
+            if (validated) {
+                return@apply
+            }
+
+            outcome().validate()
+            stderr()
+            stdout()
+            createdBy()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (outcome.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (stderr.asKnown().isPresent) 1 else 0) +
+                (if (stdout.asKnown().isPresent) 1 else 0) +
+                (if (createdBy.asKnown().isPresent) 1 else 0)
+
+        /**
+         * Represents either an exit outcome (with an exit code) or a timeout outcome for a shell
+         * call output chunk.
+         */
+        @JsonDeserialize(using = Outcome.Deserializer::class)
+        @JsonSerialize(using = Outcome.Serializer::class)
+        class Outcome
+        private constructor(
+            private val timeout: JsonValue? = null,
+            private val exit: Exit? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /** Indicates that the shell call exceeded its configured time limit. */
+            fun timeout(): Optional<JsonValue> = Optional.ofNullable(timeout)
+
+            /** Indicates that the shell commands finished and returned an exit code. */
+            fun exit(): Optional<Exit> = Optional.ofNullable(exit)
+
+            fun isTimeout(): Boolean = timeout != null
+
+            fun isExit(): Boolean = exit != null
+
+            /** Indicates that the shell call exceeded its configured time limit. */
+            fun asTimeout(): JsonValue = timeout.getOrThrow("timeout")
+
+            /** Indicates that the shell commands finished and returned an exit code. */
+            fun asExit(): Exit = exit.getOrThrow("exit")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = outcome.accept(new Outcome.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitTimeout(JsonValue timeout) {
+             *         return Optional.of(timeout.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    timeout != null -> visitor.visitTimeout(timeout)
+                    exit != null -> visitor.visitExit(exit)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Outcome = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitTimeout(timeout: JsonValue) {
+                            timeout.let {
+                                if (it != JsonValue.from(mapOf("type" to "timeout"))) {
+                                    throw OpenAIInvalidDataException(
+                                        "'timeout' is invalid, received $it"
+                                    )
+                                }
+                            }
+                        }
+
+                        override fun visitExit(exit: Exit) {
+                            exit.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitTimeout(timeout: JsonValue) =
+                            timeout.let {
+                                if (it == JsonValue.from(mapOf("type" to "timeout"))) 1 else 0
+                            }
+
+                        override fun visitExit(exit: Exit) = exit.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Outcome && timeout == other.timeout && exit == other.exit
+            }
+
+            override fun hashCode(): Int = Objects.hash(timeout, exit)
+
+            override fun toString(): String =
+                when {
+                    timeout != null -> "Outcome{timeout=$timeout}"
+                    exit != null -> "Outcome{exit=$exit}"
+                    _json != null -> "Outcome{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Outcome")
+                }
+
+            companion object {
+
+                /** Indicates that the shell call exceeded its configured time limit. */
+                @JvmStatic
+                fun ofTimeout() = Outcome(timeout = JsonValue.from(mapOf("type" to "timeout")))
+
+                /** Indicates that the shell commands finished and returned an exit code. */
+                @JvmStatic fun ofExit(exit: Exit) = Outcome(exit = exit)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Outcome] to a value of type
+             * [T].
+             */
+            interface Visitor<out T> {
+
+                /** Indicates that the shell call exceeded its configured time limit. */
+                fun visitTimeout(timeout: JsonValue): T
+
+                /** Indicates that the shell commands finished and returned an exit code. */
+                fun visitExit(exit: Exit): T
+
+                /**
+                 * Maps an unknown variant of [Outcome] to a value of type [T].
+                 *
+                 * An instance of [Outcome] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Outcome: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Outcome>(Outcome::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Outcome {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "timeout" -> {
+                            return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let { Outcome(timeout = it, _json = json) }
+                                ?.takeIf { it.isValid() } ?: Outcome(_json = json)
+                        }
+                        "exit" -> {
+                            return tryDeserialize(node, jacksonTypeRef<Exit>())?.let {
+                                Outcome(exit = it, _json = json)
+                            } ?: Outcome(_json = json)
+                        }
+                    }
+
+                    return Outcome(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Outcome>(Outcome::class) {
+
+                override fun serialize(
+                    value: Outcome,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.timeout != null -> generator.writeObject(value.timeout)
+                        value.exit != null -> generator.writeObject(value.exit)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Outcome")
+                    }
+                }
+            }
+
+            /** Indicates that the shell commands finished and returned an exit code. */
+            class Exit
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val exitCode: JsonField<Long>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("exit_code")
+                    @ExcludeMissing
+                    exitCode: JsonField<Long> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(exitCode, type, mutableMapOf())
+
+                /**
+                 * Exit code from the shell process.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun exitCode(): Long = exitCode.getRequired("exit_code")
+
+                /**
+                 * The outcome type. Always `exit`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("exit")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [exitCode].
+                 *
+                 * Unlike [exitCode], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("exit_code")
+                @ExcludeMissing
+                fun _exitCode(): JsonField<Long> = exitCode
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Exit].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .exitCode()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Exit]. */
+                class Builder internal constructor() {
+
+                    private var exitCode: JsonField<Long>? = null
+                    private var type: JsonValue = JsonValue.from("exit")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(exit: Exit) = apply {
+                        exitCode = exit.exitCode
+                        type = exit.type
+                        additionalProperties = exit.additionalProperties.toMutableMap()
+                    }
+
+                    /** Exit code from the shell process. */
+                    fun exitCode(exitCode: Long) = exitCode(JsonField.of(exitCode))
+
+                    /**
+                     * Sets [Builder.exitCode] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.exitCode] with a well-typed [Long] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun exitCode(exitCode: JsonField<Long>) = apply { this.exitCode = exitCode }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("exit")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Exit].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .exitCode()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Exit =
+                        Exit(
+                            checkRequired("exitCode", exitCode),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Exit = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    exitCode()
+                    _type().let {
+                        if (it != JsonValue.from("exit")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (exitCode.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("exit")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Exit &&
+                        exitCode == other.exitCode &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(exitCode, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Exit{exitCode=$exitCode, type=$type, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Output &&
+                outcome == other.outcome &&
+                stderr == other.stderr &&
+                stdout == other.stdout &&
+                createdBy == other.createdBy &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(outcome, stderr, stdout, createdBy, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Output{outcome=$outcome, stderr=$stderr, stdout=$stdout, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+    }
+
+    /** The status of the shell call output. One of `in_progress`, `completed`, or `incomplete`. */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    /** The execution context that produced this tool call. */
+    @JsonDeserialize(using = Caller.Deserializer::class)
+    @JsonSerialize(using = Caller.Serializer::class)
+    class Caller
+    private constructor(
+        private val direct: JsonValue? = null,
+        private val program: Program? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+        fun program(): Optional<Program> = Optional.ofNullable(program)
+
+        fun isDirect(): Boolean = direct != null
+
+        fun isProgram(): Boolean = program != null
+
+        fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+        fun asProgram(): Program = program.getOrThrow("program")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDirect(JsonValue direct) {
+         *         return Optional.of(direct.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                direct != null -> visitor.visitDirect(direct)
+                program != null -> visitor.visitProgram(program)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Caller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDirect(direct: JsonValue) {
+                        direct.let {
+                            if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'direct' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitProgram(program: Program) {
+                        program.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDirect(direct: JsonValue) =
+                        direct.let { if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0 }
+
+                    override fun visitProgram(program: Program) = program.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Caller && direct == other.direct && program == other.program
+        }
+
+        override fun hashCode(): Int = Objects.hash(direct, program)
+
+        override fun toString(): String =
+            when {
+                direct != null -> "Caller{direct=$direct}"
+                program != null -> "Caller{program=$program}"
+                _json != null -> "Caller{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Caller")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+            @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+        }
+
+        /** An interface that defines how to map each variant of [Caller] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitDirect(direct: JsonValue): T
+
+            fun visitProgram(program: Program): T
+
+            /**
+             * Maps an unknown variant of [Caller] to a value of type [T].
+             *
+             * An instance of [Caller] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Caller: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "direct" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Caller(direct = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                    }
+                    "program" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                            Caller(program = it, _json = json)
+                        } ?: Caller(_json = json)
+                    }
+                }
+
+                return Caller(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+            override fun serialize(
+                value: Caller,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.direct != null -> generator.writeObject(value.direct)
+                    value.program != null -> generator.writeObject(value.program)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+            }
+        }
+
+        class Program
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val callerId: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                callerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(callerId, type, mutableMapOf())
+
+            /**
+             * The call ID of the program item that produced this tool call.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun callerId(): String = callerId.getRequired("caller_id")
+
+            /**
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [callerId].
+             *
+             * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("caller_id") @ExcludeMissing fun _callerId(): JsonField<String> = callerId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Program].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Program]. */
+            class Builder internal constructor() {
+
+                private var callerId: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("program")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(program: Program) = apply {
+                    callerId = program.callerId
+                    type = program.type
+                    additionalProperties = program.additionalProperties.toMutableMap()
+                }
+
+                /** The call ID of the program item that produced this tool call. */
+                fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                /**
+                 * Sets [Builder.callerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.callerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Program].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Program =
+                    Program(
+                        checkRequired("callerId", callerId),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Program = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                callerId()
+                _type().let {
+                    if (it != JsonValue.from("program")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (callerId.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Program &&
+                    callerId == other.callerId &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(callerId, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFunctionShellToolCallOutput &&
+            id == other.id &&
+            callId == other.callId &&
+            maxOutputLength == other.maxOutputLength &&
+            output == other.output &&
+            status == other.status &&
+            type == other.type &&
+            agent == other.agent &&
+            caller == other.caller &&
+            createdBy == other.createdBy &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            id,
+            callId,
+            maxOutputLength,
+            output,
+            status,
+            type,
+            agent,
+            caller,
+            createdBy,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseFunctionShellToolCallOutput{id=$id, callId=$callId, maxOutputLength=$maxOutputLength, output=$output, status=$status, type=$type, agent=$agent, caller=$caller, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCall.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCall.kt
new file mode 100644
index 000000000..c11dc31e9
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCall.kt
@@ -0,0 +1,1261 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * A tool call to run a function. See the
+ * [function calling guide](https://platform.openai.com/docs/guides/function-calling) for more
+ * information.
+ */
+class BetaResponseFunctionToolCall
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val arguments: JsonField<String>,
+    private val callId: JsonField<String>,
+    private val name: JsonField<String>,
+    private val type: JsonValue,
+    private val id: JsonField<String>,
+    private val agent: JsonField<Agent>,
+    private val caller: JsonField<Caller>,
+    private val namespace: JsonField<String>,
+    private val status: JsonField<Status>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("arguments") @ExcludeMissing arguments: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+        @JsonProperty("namespace") @ExcludeMissing namespace: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+    ) : this(arguments, callId, name, type, id, agent, caller, namespace, status, mutableMapOf())
+
+    /**
+     * A JSON string of the arguments to pass to the function.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun arguments(): String = arguments.getRequired("arguments")
+
+    /**
+     * The unique ID of the function tool call generated by the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun callId(): String = callId.getRequired("call_id")
+
+    /**
+     * The name of the function to run.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun name(): String = name.getRequired("name")
+
+    /**
+     * The type of the function tool call. Always `function_call`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("function_call")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The unique ID of the function tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun id(): Optional<String> = id.getOptional("id")
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<Caller> = caller.getOptional("caller")
+
+    /**
+     * The namespace of the function to run.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun namespace(): Optional<String> = namespace.getOptional("namespace")
+
+    /**
+     * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+     * items are returned via API.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun status(): Optional<Status> = status.getOptional("status")
+
+    /**
+     * Returns the raw JSON value of [arguments].
+     *
+     * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
+
+    /**
+     * Returns the raw JSON value of [callId].
+     *
+     * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
+    /**
+     * Returns the raw JSON value of [namespace].
+     *
+     * Unlike [namespace], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("namespace") @ExcludeMissing fun _namespace(): JsonField<String> = namespace
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseFunctionToolCall].
+         *
+         * The following fields are required:
+         * ```java
+         * .arguments()
+         * .callId()
+         * .name()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseFunctionToolCall]. */
+    class Builder internal constructor() {
+
+        private var arguments: JsonField<String>? = null
+        private var callId: JsonField<String>? = null
+        private var name: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("function_call")
+        private var id: JsonField<String> = JsonMissing.of()
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var caller: JsonField<Caller> = JsonMissing.of()
+        private var namespace: JsonField<String> = JsonMissing.of()
+        private var status: JsonField<Status> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseFunctionToolCall: BetaResponseFunctionToolCall) = apply {
+            arguments = betaResponseFunctionToolCall.arguments
+            callId = betaResponseFunctionToolCall.callId
+            name = betaResponseFunctionToolCall.name
+            type = betaResponseFunctionToolCall.type
+            id = betaResponseFunctionToolCall.id
+            agent = betaResponseFunctionToolCall.agent
+            caller = betaResponseFunctionToolCall.caller
+            namespace = betaResponseFunctionToolCall.namespace
+            status = betaResponseFunctionToolCall.status
+            additionalProperties = betaResponseFunctionToolCall.additionalProperties.toMutableMap()
+        }
+
+        /** A JSON string of the arguments to pass to the function. */
+        fun arguments(arguments: String) = arguments(JsonField.of(arguments))
+
+        /**
+         * Sets [Builder.arguments] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.arguments] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
+
+        /** The unique ID of the function tool call generated by the model. */
+        fun callId(callId: String) = callId(JsonField.of(callId))
+
+        /**
+         * Sets [Builder.callId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.callId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+        /** The name of the function to run. */
+        fun name(name: String) = name(JsonField.of(name))
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("function_call")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The unique ID of the function tool call. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /** The execution context that produced this tool call. */
+        fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed [Caller] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+        /** Alias for calling [caller] with `Caller.ofDirect()`. */
+        fun callerDirect() = caller(Caller.ofDirect())
+
+        /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+        fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(Caller.Program.builder().callerId(callerId).build())
+
+        /** The namespace of the function to run. */
+        fun namespace(namespace: String) = namespace(JsonField.of(namespace))
+
+        /**
+         * Sets [Builder.namespace] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.namespace] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun namespace(namespace: JsonField<String>) = apply { this.namespace = namespace }
+
+        /**
+         * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated
+         * when items are returned via API.
+         */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseFunctionToolCall].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .arguments()
+         * .callId()
+         * .name()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseFunctionToolCall =
+            BetaResponseFunctionToolCall(
+                checkRequired("arguments", arguments),
+                checkRequired("callId", callId),
+                checkRequired("name", name),
+                type,
+                id,
+                agent,
+                caller,
+                namespace,
+                status,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFunctionToolCall = apply {
+        if (validated) {
+            return@apply
+        }
+
+        arguments()
+        callId()
+        name()
+        _type().let {
+            if (it != JsonValue.from("function_call")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        id()
+        agent().ifPresent { it.validate() }
+        caller().ifPresent { it.validate() }
+        namespace()
+        status().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (arguments.asKnown().isPresent) 1 else 0) +
+            (if (callId.asKnown().isPresent) 1 else 0) +
+            (if (name.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("function_call")) 1 else 0 } +
+            (if (id.asKnown().isPresent) 1 else 0) +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (namespace.asKnown().isPresent) 1 else 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    /** The execution context that produced this tool call. */
+    @JsonDeserialize(using = Caller.Deserializer::class)
+    @JsonSerialize(using = Caller.Serializer::class)
+    class Caller
+    private constructor(
+        private val direct: JsonValue? = null,
+        private val program: Program? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+        fun program(): Optional<Program> = Optional.ofNullable(program)
+
+        fun isDirect(): Boolean = direct != null
+
+        fun isProgram(): Boolean = program != null
+
+        fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+        fun asProgram(): Program = program.getOrThrow("program")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDirect(JsonValue direct) {
+         *         return Optional.of(direct.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                direct != null -> visitor.visitDirect(direct)
+                program != null -> visitor.visitProgram(program)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Caller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDirect(direct: JsonValue) {
+                        direct.let {
+                            if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'direct' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitProgram(program: Program) {
+                        program.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDirect(direct: JsonValue) =
+                        direct.let { if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0 }
+
+                    override fun visitProgram(program: Program) = program.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Caller && direct == other.direct && program == other.program
+        }
+
+        override fun hashCode(): Int = Objects.hash(direct, program)
+
+        override fun toString(): String =
+            when {
+                direct != null -> "Caller{direct=$direct}"
+                program != null -> "Caller{program=$program}"
+                _json != null -> "Caller{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Caller")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+            @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+        }
+
+        /** An interface that defines how to map each variant of [Caller] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitDirect(direct: JsonValue): T
+
+            fun visitProgram(program: Program): T
+
+            /**
+             * Maps an unknown variant of [Caller] to a value of type [T].
+             *
+             * An instance of [Caller] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Caller: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "direct" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Caller(direct = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                    }
+                    "program" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                            Caller(program = it, _json = json)
+                        } ?: Caller(_json = json)
+                    }
+                }
+
+                return Caller(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+            override fun serialize(
+                value: Caller,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.direct != null -> generator.writeObject(value.direct)
+                    value.program != null -> generator.writeObject(value.program)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+            }
+        }
+
+        class Program
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val callerId: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                callerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(callerId, type, mutableMapOf())
+
+            /**
+             * The call ID of the program item that produced this tool call.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun callerId(): String = callerId.getRequired("caller_id")
+
+            /**
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [callerId].
+             *
+             * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("caller_id") @ExcludeMissing fun _callerId(): JsonField<String> = callerId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Program].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Program]. */
+            class Builder internal constructor() {
+
+                private var callerId: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("program")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(program: Program) = apply {
+                    callerId = program.callerId
+                    type = program.type
+                    additionalProperties = program.additionalProperties.toMutableMap()
+                }
+
+                /** The call ID of the program item that produced this tool call. */
+                fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                /**
+                 * Sets [Builder.callerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.callerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Program].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Program =
+                    Program(
+                        checkRequired("callerId", callerId),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Program = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                callerId()
+                _type().let {
+                    if (it != JsonValue.from("program")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (callerId.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Program &&
+                    callerId == other.callerId &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(callerId, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    /**
+     * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+     * items are returned via API.
+     */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFunctionToolCall &&
+            arguments == other.arguments &&
+            callId == other.callId &&
+            name == other.name &&
+            type == other.type &&
+            id == other.id &&
+            agent == other.agent &&
+            caller == other.caller &&
+            namespace == other.namespace &&
+            status == other.status &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            arguments,
+            callId,
+            name,
+            type,
+            id,
+            agent,
+            caller,
+            namespace,
+            status,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseFunctionToolCall{arguments=$arguments, callId=$callId, name=$name, type=$type, id=$id, agent=$agent, caller=$caller, namespace=$namespace, status=$status, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallItem.kt
new file mode 100644
index 000000000..18e945181
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallItem.kt
@@ -0,0 +1,748 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * A tool call to run a function. See the
+ * [function calling guide](https://platform.openai.com/docs/guides/function-calling) for more
+ * information.
+ */
+class BetaResponseFunctionToolCallItem
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val arguments: JsonField<String>,
+    private val callId: JsonField<String>,
+    private val name: JsonField<String>,
+    private val type: JsonValue,
+    private val id: JsonField<String>,
+    private val agent: JsonField<BetaResponseFunctionToolCall.Agent>,
+    private val caller: JsonField<BetaResponseFunctionToolCall.Caller>,
+    private val namespace: JsonField<String>,
+    private val status: JsonField<BetaResponseFunctionToolCall.Status>,
+    private val createdBy: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("arguments") @ExcludeMissing arguments: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("agent")
+        @ExcludeMissing
+        agent: JsonField<BetaResponseFunctionToolCall.Agent> = JsonMissing.of(),
+        @JsonProperty("caller")
+        @ExcludeMissing
+        caller: JsonField<BetaResponseFunctionToolCall.Caller> = JsonMissing.of(),
+        @JsonProperty("namespace") @ExcludeMissing namespace: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("status")
+        @ExcludeMissing
+        status: JsonField<BetaResponseFunctionToolCall.Status> = JsonMissing.of(),
+        @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
+    ) : this(
+        arguments,
+        callId,
+        name,
+        type,
+        id,
+        agent,
+        caller,
+        namespace,
+        status,
+        createdBy,
+        mutableMapOf(),
+    )
+
+    fun toBetaResponseFunctionToolCall(): BetaResponseFunctionToolCall =
+        BetaResponseFunctionToolCall.builder()
+            .arguments(arguments)
+            .callId(callId)
+            .name(name)
+            .type(type)
+            .id(id)
+            .agent(agent)
+            .caller(caller)
+            .namespace(namespace)
+            .status(status)
+            .build()
+
+    /**
+     * A JSON string of the arguments to pass to the function.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun arguments(): String = arguments.getRequired("arguments")
+
+    /**
+     * The unique ID of the function tool call generated by the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun callId(): String = callId.getRequired("call_id")
+
+    /**
+     * The name of the function to run.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun name(): String = name.getRequired("name")
+
+    /**
+     * The type of the function tool call. Always `function_call`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("function_call")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The unique ID of the function tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun id(): Optional<String> = id.getOptional("id")
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<BetaResponseFunctionToolCall.Agent> = agent.getOptional("agent")
+
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<BetaResponseFunctionToolCall.Caller> = caller.getOptional("caller")
+
+    /**
+     * The namespace of the function to run.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun namespace(): Optional<String> = namespace.getOptional("namespace")
+
+    /**
+     * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+     * items are returned via API.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun status(): Optional<BetaResponseFunctionToolCall.Status> = status.getOptional("status")
+
+    /**
+     * The identifier of the actor that created the item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdBy(): Optional<String> = createdBy.getOptional("created_by")
+
+    /**
+     * Returns the raw JSON value of [arguments].
+     *
+     * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
+
+    /**
+     * Returns the raw JSON value of [callId].
+     *
+     * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent")
+    @ExcludeMissing
+    fun _agent(): JsonField<BetaResponseFunctionToolCall.Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller")
+    @ExcludeMissing
+    fun _caller(): JsonField<BetaResponseFunctionToolCall.Caller> = caller
+
+    /**
+     * Returns the raw JSON value of [namespace].
+     *
+     * Unlike [namespace], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("namespace") @ExcludeMissing fun _namespace(): JsonField<String> = namespace
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status")
+    @ExcludeMissing
+    fun _status(): JsonField<BetaResponseFunctionToolCall.Status> = status
+
+    /**
+     * Returns the raw JSON value of [createdBy].
+     *
+     * Unlike [createdBy], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_by") @ExcludeMissing fun _createdBy(): JsonField<String> = createdBy
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseFunctionToolCallItem].
+         *
+         * The following fields are required:
+         * ```java
+         * .arguments()
+         * .callId()
+         * .name()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseFunctionToolCallItem]. */
+    class Builder internal constructor() {
+
+        private var arguments: JsonField<String>? = null
+        private var callId: JsonField<String>? = null
+        private var name: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("function_call")
+        private var id: JsonField<String> = JsonMissing.of()
+        private var agent: JsonField<BetaResponseFunctionToolCall.Agent> = JsonMissing.of()
+        private var caller: JsonField<BetaResponseFunctionToolCall.Caller> = JsonMissing.of()
+        private var namespace: JsonField<String> = JsonMissing.of()
+        private var status: JsonField<BetaResponseFunctionToolCall.Status> = JsonMissing.of()
+        private var createdBy: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseFunctionToolCallItem: BetaResponseFunctionToolCallItem) =
+            apply {
+                arguments = betaResponseFunctionToolCallItem.arguments
+                callId = betaResponseFunctionToolCallItem.callId
+                name = betaResponseFunctionToolCallItem.name
+                type = betaResponseFunctionToolCallItem.type
+                id = betaResponseFunctionToolCallItem.id
+                agent = betaResponseFunctionToolCallItem.agent
+                caller = betaResponseFunctionToolCallItem.caller
+                namespace = betaResponseFunctionToolCallItem.namespace
+                status = betaResponseFunctionToolCallItem.status
+                createdBy = betaResponseFunctionToolCallItem.createdBy
+                additionalProperties =
+                    betaResponseFunctionToolCallItem.additionalProperties.toMutableMap()
+            }
+
+        /** A JSON string of the arguments to pass to the function. */
+        fun arguments(arguments: String) = arguments(JsonField.of(arguments))
+
+        /**
+         * Sets [Builder.arguments] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.arguments] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
+
+        /** The unique ID of the function tool call generated by the model. */
+        fun callId(callId: String) = callId(JsonField.of(callId))
+
+        /**
+         * Sets [Builder.callId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.callId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+        /** The name of the function to run. */
+        fun name(name: String) = name(JsonField.of(name))
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("function_call")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The unique ID of the function tool call. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The agent that produced this item. */
+        fun agent(agent: BetaResponseFunctionToolCall.Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<BetaResponseFunctionToolCall.Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed
+         * [BetaResponseFunctionToolCall.Agent] value instead. This method is primarily for setting
+         * the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<BetaResponseFunctionToolCall.Agent>) = apply {
+            this.agent = agent
+        }
+
+        /** The execution context that produced this tool call. */
+        fun caller(caller: BetaResponseFunctionToolCall.Caller?) =
+            caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<BetaResponseFunctionToolCall.Caller>) =
+            caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed
+         * [BetaResponseFunctionToolCall.Caller] value instead. This method is primarily for setting
+         * the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<BetaResponseFunctionToolCall.Caller>) = apply {
+            this.caller = caller
+        }
+
+        /** Alias for calling [caller] with `BetaResponseFunctionToolCall.Caller.ofDirect()`. */
+        fun callerDirect() = caller(BetaResponseFunctionToolCall.Caller.ofDirect())
+
+        /**
+         * Alias for calling [caller] with `BetaResponseFunctionToolCall.Caller.ofProgram(program)`.
+         */
+        fun caller(program: BetaResponseFunctionToolCall.Caller.Program) =
+            caller(BetaResponseFunctionToolCall.Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * BetaResponseFunctionToolCall.Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(BetaResponseFunctionToolCall.Caller.Program.builder().callerId(callerId).build())
+
+        /** The namespace of the function to run. */
+        fun namespace(namespace: String) = namespace(JsonField.of(namespace))
+
+        /**
+         * Sets [Builder.namespace] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.namespace] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun namespace(namespace: JsonField<String>) = apply { this.namespace = namespace }
+
+        /**
+         * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated
+         * when items are returned via API.
+         */
+        fun status(status: BetaResponseFunctionToolCall.Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed
+         * [BetaResponseFunctionToolCall.Status] value instead. This method is primarily for setting
+         * the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<BetaResponseFunctionToolCall.Status>) = apply {
+            this.status = status
+        }
+
+        /** The identifier of the actor that created the item. */
+        fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
+
+        /**
+         * Sets [Builder.createdBy] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdBy] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun createdBy(createdBy: JsonField<String>) = apply { this.createdBy = createdBy }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseFunctionToolCallItem].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .arguments()
+         * .callId()
+         * .name()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseFunctionToolCallItem =
+            BetaResponseFunctionToolCallItem(
+                checkRequired("arguments", arguments),
+                checkRequired("callId", callId),
+                checkRequired("name", name),
+                type,
+                id,
+                agent,
+                caller,
+                namespace,
+                status,
+                createdBy,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFunctionToolCallItem = apply {
+        if (validated) {
+            return@apply
+        }
+
+        arguments()
+        callId()
+        name()
+        _type().let {
+            if (it != JsonValue.from("function_call")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        id()
+        agent().ifPresent { it.validate() }
+        caller().ifPresent { it.validate() }
+        namespace()
+        status().ifPresent { it.validate() }
+        createdBy()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (arguments.asKnown().isPresent) 1 else 0) +
+            (if (callId.asKnown().isPresent) 1 else 0) +
+            (if (name.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("function_call")) 1 else 0 } +
+            (if (id.asKnown().isPresent) 1 else 0) +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (namespace.asKnown().isPresent) 1 else 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (createdBy.asKnown().isPresent) 1 else 0)
+
+    /**
+     * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+     * items are returned via API.
+     */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFunctionToolCallItem &&
+            arguments == other.arguments &&
+            callId == other.callId &&
+            name == other.name &&
+            type == other.type &&
+            id == other.id &&
+            agent == other.agent &&
+            caller == other.caller &&
+            namespace == other.namespace &&
+            status == other.status &&
+            createdBy == other.createdBy &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            arguments,
+            callId,
+            name,
+            type,
+            id,
+            agent,
+            caller,
+            namespace,
+            status,
+            createdBy,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseFunctionToolCallItem{arguments=$arguments, callId=$callId, name=$name, type=$type, id=$id, agent=$agent, caller=$caller, namespace=$namespace, status=$status, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallOutputItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallOutputItem.kt
new file mode 100644
index 000000000..591494216
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallOutputItem.kt
@@ -0,0 +1,1767 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.allMaxBy
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class BetaResponseFunctionToolCallOutputItem
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val callId: JsonField<String>,
+    private val output: JsonField<Output>,
+    private val status: JsonField<Status>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val caller: JsonField<Caller>,
+    private val createdBy: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output") @ExcludeMissing output: JsonField<Output> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+        @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
+    ) : this(id, callId, output, status, type, agent, caller, createdBy, mutableMapOf())
+
+    /**
+     * The unique ID of the function call tool output.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * The unique ID of the function tool call generated by the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun callId(): String = callId.getRequired("call_id")
+
+    /**
+     * The output from the function call generated by your code. Can be a string or an list of
+     * output content.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun output(): Output = output.getRequired("output")
+
+    /**
+     * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+     * items are returned via API.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun status(): Status = status.getRequired("status")
+
+    /**
+     * The type of the function tool call output. Always `function_call_output`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("function_call_output")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<Caller> = caller.getOptional("caller")
+
+    /**
+     * The identifier of the actor that created the item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdBy(): Optional<String> = createdBy.getOptional("created_by")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [callId].
+     *
+     * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+    /**
+     * Returns the raw JSON value of [output].
+     *
+     * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<Output> = output
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
+    /**
+     * Returns the raw JSON value of [createdBy].
+     *
+     * Unlike [createdBy], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_by") @ExcludeMissing fun _createdBy(): JsonField<String> = createdBy
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseFunctionToolCallOutputItem].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .callId()
+         * .output()
+         * .status()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseFunctionToolCallOutputItem]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var callId: JsonField<String>? = null
+        private var output: JsonField<Output>? = null
+        private var status: JsonField<Status>? = null
+        private var type: JsonValue = JsonValue.from("function_call_output")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var caller: JsonField<Caller> = JsonMissing.of()
+        private var createdBy: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseFunctionToolCallOutputItem: BetaResponseFunctionToolCallOutputItem
+        ) = apply {
+            id = betaResponseFunctionToolCallOutputItem.id
+            callId = betaResponseFunctionToolCallOutputItem.callId
+            output = betaResponseFunctionToolCallOutputItem.output
+            status = betaResponseFunctionToolCallOutputItem.status
+            type = betaResponseFunctionToolCallOutputItem.type
+            agent = betaResponseFunctionToolCallOutputItem.agent
+            caller = betaResponseFunctionToolCallOutputItem.caller
+            createdBy = betaResponseFunctionToolCallOutputItem.createdBy
+            additionalProperties =
+                betaResponseFunctionToolCallOutputItem.additionalProperties.toMutableMap()
+        }
+
+        /** The unique ID of the function call tool output. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The unique ID of the function tool call generated by the model. */
+        fun callId(callId: String) = callId(JsonField.of(callId))
+
+        /**
+         * Sets [Builder.callId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.callId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+        /**
+         * The output from the function call generated by your code. Can be a string or an list of
+         * output content.
+         */
+        fun output(output: Output) = output(JsonField.of(output))
+
+        /**
+         * Sets [Builder.output] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.output] with a well-typed [Output] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun output(output: JsonField<Output>) = apply { this.output = output }
+
+        /** Alias for calling [output] with `Output.ofString(string)`. */
+        fun output(string: String) = output(Output.ofString(string))
+
+        /** Alias for calling [output] with `Output.ofContentList(contentList)`. */
+        fun outputOfContentList(contentList: List<Output.BetaFunctionAndCustomToolCallOutput>) =
+            output(Output.ofContentList(contentList))
+
+        /**
+         * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated
+         * when items are returned via API.
+         */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("function_call_output")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /** The execution context that produced this tool call. */
+        fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed [Caller] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+        /** Alias for calling [caller] with `Caller.ofDirect()`. */
+        fun callerDirect() = caller(Caller.ofDirect())
+
+        /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+        fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(Caller.Program.builder().callerId(callerId).build())
+
+        /** The identifier of the actor that created the item. */
+        fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
+
+        /**
+         * Sets [Builder.createdBy] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdBy] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun createdBy(createdBy: JsonField<String>) = apply { this.createdBy = createdBy }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseFunctionToolCallOutputItem].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .callId()
+         * .output()
+         * .status()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseFunctionToolCallOutputItem =
+            BetaResponseFunctionToolCallOutputItem(
+                checkRequired("id", id),
+                checkRequired("callId", callId),
+                checkRequired("output", output),
+                checkRequired("status", status),
+                type,
+                agent,
+                caller,
+                createdBy,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFunctionToolCallOutputItem = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        callId()
+        output().validate()
+        status().validate()
+        _type().let {
+            if (it != JsonValue.from("function_call_output")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        caller().ifPresent { it.validate() }
+        createdBy()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (if (callId.asKnown().isPresent) 1 else 0) +
+            (output.asKnown().getOrNull()?.validity() ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("function_call_output")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (createdBy.asKnown().isPresent) 1 else 0)
+
+    /**
+     * The output from the function call generated by your code. Can be a string or an list of
+     * output content.
+     */
+    @JsonDeserialize(using = Output.Deserializer::class)
+    @JsonSerialize(using = Output.Serializer::class)
+    class Output
+    private constructor(
+        private val string: String? = null,
+        private val contentList: List<BetaFunctionAndCustomToolCallOutput>? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** A string of the output of the function call. */
+        fun string(): Optional<String> = Optional.ofNullable(string)
+
+        /** Text, image, or file output of the function call. */
+        fun contentList(): Optional<List<BetaFunctionAndCustomToolCallOutput>> =
+            Optional.ofNullable(contentList)
+
+        fun isString(): Boolean = string != null
+
+        fun isContentList(): Boolean = contentList != null
+
+        /** A string of the output of the function call. */
+        fun asString(): String = string.getOrThrow("string")
+
+        /** Text, image, or file output of the function call. */
+        fun asContentList(): List<BetaFunctionAndCustomToolCallOutput> =
+            contentList.getOrThrow("contentList")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = output.accept(new Output.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitString(String string) {
+         *         return Optional.of(string.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                string != null -> visitor.visitString(string)
+                contentList != null -> visitor.visitContentList(contentList)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Output = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitString(string: String) {}
+
+                    override fun visitContentList(
+                        contentList: List<BetaFunctionAndCustomToolCallOutput>
+                    ) {
+                        contentList.forEach { it.validate() }
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitString(string: String) = 1
+
+                    override fun visitContentList(
+                        contentList: List<BetaFunctionAndCustomToolCallOutput>
+                    ) = contentList.sumOf { it.validity().toInt() }
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Output && string == other.string && contentList == other.contentList
+        }
+
+        override fun hashCode(): Int = Objects.hash(string, contentList)
+
+        override fun toString(): String =
+            when {
+                string != null -> "Output{string=$string}"
+                contentList != null -> "Output{contentList=$contentList}"
+                _json != null -> "Output{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Output")
+            }
+
+        companion object {
+
+            /** A string of the output of the function call. */
+            @JvmStatic fun ofString(string: String) = Output(string = string)
+
+            /** Text, image, or file output of the function call. */
+            @JvmStatic
+            fun ofContentList(contentList: List<BetaFunctionAndCustomToolCallOutput>) =
+                Output(contentList = contentList.toImmutable())
+        }
+
+        /** An interface that defines how to map each variant of [Output] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            /** A string of the output of the function call. */
+            fun visitString(string: String): T
+
+            /** Text, image, or file output of the function call. */
+            fun visitContentList(contentList: List<BetaFunctionAndCustomToolCallOutput>): T
+
+            /**
+             * Maps an unknown variant of [Output] to a value of type [T].
+             *
+             * An instance of [Output] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Output: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Output>(Output::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Output {
+                val json = JsonValue.fromJsonNode(node)
+
+                val bestMatches =
+                    sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                Output(string = it, _json = json)
+                            },
+                            tryDeserialize(
+                                    node,
+                                    jacksonTypeRef<List<BetaFunctionAndCustomToolCallOutput>>(),
+                                )
+                                ?.let { Output(contentList = it, _json = json) },
+                        )
+                        .filterNotNull()
+                        .allMaxBy { it.validity() }
+                        .toList()
+                return when (bestMatches.size) {
+                    // This can happen if what we're deserializing is completely incompatible with
+                    // all the possible variants (e.g. deserializing from boolean).
+                    0 -> Output(_json = json)
+                    1 -> bestMatches.single()
+                    // If there's more than one match with the highest validity, then use the first
+                    // completely valid match, or simply the first match if none are completely
+                    // valid.
+                    else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                }
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Output>(Output::class) {
+
+            override fun serialize(
+                value: Output,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.string != null -> generator.writeObject(value.string)
+                    value.contentList != null -> generator.writeObject(value.contentList)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Output")
+                }
+            }
+        }
+
+        /** A text input to the model. */
+        @JsonDeserialize(using = BetaFunctionAndCustomToolCallOutput.Deserializer::class)
+        @JsonSerialize(using = BetaFunctionAndCustomToolCallOutput.Serializer::class)
+        class BetaFunctionAndCustomToolCallOutput
+        private constructor(
+            private val inputText: BetaResponseInputText? = null,
+            private val inputImage: BetaResponseInputImage? = null,
+            private val inputFile: BetaResponseInputFile? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /** A text input to the model. */
+            fun inputText(): Optional<BetaResponseInputText> = Optional.ofNullable(inputText)
+
+            /**
+             * An image input to the model. Learn about
+             * [image inputs](https://platform.openai.com/docs/guides/vision).
+             */
+            fun inputImage(): Optional<BetaResponseInputImage> = Optional.ofNullable(inputImage)
+
+            /** A file input to the model. */
+            fun inputFile(): Optional<BetaResponseInputFile> = Optional.ofNullable(inputFile)
+
+            fun isInputText(): Boolean = inputText != null
+
+            fun isInputImage(): Boolean = inputImage != null
+
+            fun isInputFile(): Boolean = inputFile != null
+
+            /** A text input to the model. */
+            fun asInputText(): BetaResponseInputText = inputText.getOrThrow("inputText")
+
+            /**
+             * An image input to the model. Learn about
+             * [image inputs](https://platform.openai.com/docs/guides/vision).
+             */
+            fun asInputImage(): BetaResponseInputImage = inputImage.getOrThrow("inputImage")
+
+            /** A file input to the model. */
+            fun asInputFile(): BetaResponseInputFile = inputFile.getOrThrow("inputFile")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = betaFunctionAndCustomToolCallOutput.accept(new BetaFunctionAndCustomToolCallOutput.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitInputText(BetaResponseInputText inputText) {
+             *         return Optional.of(inputText.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    inputText != null -> visitor.visitInputText(inputText)
+                    inputImage != null -> visitor.visitInputImage(inputImage)
+                    inputFile != null -> visitor.visitInputFile(inputFile)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): BetaFunctionAndCustomToolCallOutput = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitInputText(inputText: BetaResponseInputText) {
+                            inputText.validate()
+                        }
+
+                        override fun visitInputImage(inputImage: BetaResponseInputImage) {
+                            inputImage.validate()
+                        }
+
+                        override fun visitInputFile(inputFile: BetaResponseInputFile) {
+                            inputFile.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitInputText(inputText: BetaResponseInputText) =
+                            inputText.validity()
+
+                        override fun visitInputImage(inputImage: BetaResponseInputImage) =
+                            inputImage.validity()
+
+                        override fun visitInputFile(inputFile: BetaResponseInputFile) =
+                            inputFile.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is BetaFunctionAndCustomToolCallOutput &&
+                    inputText == other.inputText &&
+                    inputImage == other.inputImage &&
+                    inputFile == other.inputFile
+            }
+
+            override fun hashCode(): Int = Objects.hash(inputText, inputImage, inputFile)
+
+            override fun toString(): String =
+                when {
+                    inputText != null -> "BetaFunctionAndCustomToolCallOutput{inputText=$inputText}"
+                    inputImage != null ->
+                        "BetaFunctionAndCustomToolCallOutput{inputImage=$inputImage}"
+                    inputFile != null -> "BetaFunctionAndCustomToolCallOutput{inputFile=$inputFile}"
+                    _json != null -> "BetaFunctionAndCustomToolCallOutput{_unknown=$_json}"
+                    else ->
+                        throw IllegalStateException("Invalid BetaFunctionAndCustomToolCallOutput")
+                }
+
+            companion object {
+
+                /** A text input to the model. */
+                @JvmStatic
+                fun ofInputText(inputText: BetaResponseInputText) =
+                    BetaFunctionAndCustomToolCallOutput(inputText = inputText)
+
+                /**
+                 * An image input to the model. Learn about
+                 * [image inputs](https://platform.openai.com/docs/guides/vision).
+                 */
+                @JvmStatic
+                fun ofInputImage(inputImage: BetaResponseInputImage) =
+                    BetaFunctionAndCustomToolCallOutput(inputImage = inputImage)
+
+                /** A file input to the model. */
+                @JvmStatic
+                fun ofInputFile(inputFile: BetaResponseInputFile) =
+                    BetaFunctionAndCustomToolCallOutput(inputFile = inputFile)
+            }
+
+            /**
+             * An interface that defines how to map each variant of
+             * [BetaFunctionAndCustomToolCallOutput] to a value of type [T].
+             */
+            interface Visitor<out T> {
+
+                /** A text input to the model. */
+                fun visitInputText(inputText: BetaResponseInputText): T
+
+                /**
+                 * An image input to the model. Learn about
+                 * [image inputs](https://platform.openai.com/docs/guides/vision).
+                 */
+                fun visitInputImage(inputImage: BetaResponseInputImage): T
+
+                /** A file input to the model. */
+                fun visitInputFile(inputFile: BetaResponseInputFile): T
+
+                /**
+                 * Maps an unknown variant of [BetaFunctionAndCustomToolCallOutput] to a value of
+                 * type [T].
+                 *
+                 * An instance of [BetaFunctionAndCustomToolCallOutput] can contain an unknown
+                 * variant if it was deserialized from data that doesn't match any known variant.
+                 * For example, if the SDK is on an older version than the API, then the API may
+                 * respond with new variants that the SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException(
+                        "Unknown BetaFunctionAndCustomToolCallOutput: $json"
+                    )
+                }
+            }
+
+            internal class Deserializer :
+                BaseDeserializer<BetaFunctionAndCustomToolCallOutput>(
+                    BetaFunctionAndCustomToolCallOutput::class
+                ) {
+
+                override fun ObjectCodec.deserialize(
+                    node: JsonNode
+                ): BetaFunctionAndCustomToolCallOutput {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "input_text" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaResponseInputText>())
+                                ?.let {
+                                    BetaFunctionAndCustomToolCallOutput(
+                                        inputText = it,
+                                        _json = json,
+                                    )
+                                } ?: BetaFunctionAndCustomToolCallOutput(_json = json)
+                        }
+                        "input_image" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaResponseInputImage>())
+                                ?.let {
+                                    BetaFunctionAndCustomToolCallOutput(
+                                        inputImage = it,
+                                        _json = json,
+                                    )
+                                } ?: BetaFunctionAndCustomToolCallOutput(_json = json)
+                        }
+                        "input_file" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaResponseInputFile>())
+                                ?.let {
+                                    BetaFunctionAndCustomToolCallOutput(
+                                        inputFile = it,
+                                        _json = json,
+                                    )
+                                } ?: BetaFunctionAndCustomToolCallOutput(_json = json)
+                        }
+                    }
+
+                    return BetaFunctionAndCustomToolCallOutput(_json = json)
+                }
+            }
+
+            internal class Serializer :
+                BaseSerializer<BetaFunctionAndCustomToolCallOutput>(
+                    BetaFunctionAndCustomToolCallOutput::class
+                ) {
+
+                override fun serialize(
+                    value: BetaFunctionAndCustomToolCallOutput,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.inputText != null -> generator.writeObject(value.inputText)
+                        value.inputImage != null -> generator.writeObject(value.inputImage)
+                        value.inputFile != null -> generator.writeObject(value.inputFile)
+                        value._json != null -> generator.writeObject(value._json)
+                        else ->
+                            throw IllegalStateException(
+                                "Invalid BetaFunctionAndCustomToolCallOutput"
+                            )
+                    }
+                }
+            }
+        }
+    }
+
+    /**
+     * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+     * items are returned via API.
+     */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    /** The execution context that produced this tool call. */
+    @JsonDeserialize(using = Caller.Deserializer::class)
+    @JsonSerialize(using = Caller.Serializer::class)
+    class Caller
+    private constructor(
+        private val direct: JsonValue? = null,
+        private val program: Program? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+        fun program(): Optional<Program> = Optional.ofNullable(program)
+
+        fun isDirect(): Boolean = direct != null
+
+        fun isProgram(): Boolean = program != null
+
+        fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+        fun asProgram(): Program = program.getOrThrow("program")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDirect(JsonValue direct) {
+         *         return Optional.of(direct.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                direct != null -> visitor.visitDirect(direct)
+                program != null -> visitor.visitProgram(program)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Caller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDirect(direct: JsonValue) {
+                        direct.let {
+                            if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'direct' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitProgram(program: Program) {
+                        program.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDirect(direct: JsonValue) =
+                        direct.let { if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0 }
+
+                    override fun visitProgram(program: Program) = program.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Caller && direct == other.direct && program == other.program
+        }
+
+        override fun hashCode(): Int = Objects.hash(direct, program)
+
+        override fun toString(): String =
+            when {
+                direct != null -> "Caller{direct=$direct}"
+                program != null -> "Caller{program=$program}"
+                _json != null -> "Caller{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Caller")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+            @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+        }
+
+        /** An interface that defines how to map each variant of [Caller] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitDirect(direct: JsonValue): T
+
+            fun visitProgram(program: Program): T
+
+            /**
+             * Maps an unknown variant of [Caller] to a value of type [T].
+             *
+             * An instance of [Caller] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Caller: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "direct" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Caller(direct = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                    }
+                    "program" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                            Caller(program = it, _json = json)
+                        } ?: Caller(_json = json)
+                    }
+                }
+
+                return Caller(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+            override fun serialize(
+                value: Caller,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.direct != null -> generator.writeObject(value.direct)
+                    value.program != null -> generator.writeObject(value.program)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+            }
+        }
+
+        class Program
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val callerId: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                callerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(callerId, type, mutableMapOf())
+
+            /**
+             * The call ID of the program item that produced this tool call.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun callerId(): String = callerId.getRequired("caller_id")
+
+            /**
+             * The caller type. Always `program`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [callerId].
+             *
+             * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("caller_id") @ExcludeMissing fun _callerId(): JsonField<String> = callerId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Program].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Program]. */
+            class Builder internal constructor() {
+
+                private var callerId: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("program")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(program: Program) = apply {
+                    callerId = program.callerId
+                    type = program.type
+                    additionalProperties = program.additionalProperties.toMutableMap()
+                }
+
+                /** The call ID of the program item that produced this tool call. */
+                fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                /**
+                 * Sets [Builder.callerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.callerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Program].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Program =
+                    Program(
+                        checkRequired("callerId", callerId),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Program = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                callerId()
+                _type().let {
+                    if (it != JsonValue.from("program")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (callerId.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Program &&
+                    callerId == other.callerId &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(callerId, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFunctionToolCallOutputItem &&
+            id == other.id &&
+            callId == other.callId &&
+            output == other.output &&
+            status == other.status &&
+            type == other.type &&
+            agent == other.agent &&
+            caller == other.caller &&
+            createdBy == other.createdBy &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            id,
+            callId,
+            output,
+            status,
+            type,
+            agent,
+            caller,
+            createdBy,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseFunctionToolCallOutputItem{id=$id, callId=$callId, output=$output, status=$status, type=$type, agent=$agent, caller=$caller, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionWebSearch.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionWebSearch.kt
new file mode 100644
index 000000000..0bc1f6a8a
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseFunctionWebSearch.kt
@@ -0,0 +1,1906 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * The results of a web search tool call. See the
+ * [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more
+ * information.
+ */
+class BetaResponseFunctionWebSearch
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val action: JsonField<Action>,
+    private val status: JsonField<Status>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(id, action, status, type, agent, mutableMapOf())
+
+    /**
+     * The unique ID of the web search tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * An object describing the specific action taken in this web search call. Includes details on
+     * how the model used the web (search, open_page, find_in_page).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun action(): Action = action.getRequired("action")
+
+    /**
+     * The status of the web search tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun status(): Status = status.getRequired("status")
+
+    /**
+     * The type of the web search tool call. Always `web_search_call`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("web_search_call")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [action].
+     *
+     * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseFunctionWebSearch].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .action()
+         * .status()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseFunctionWebSearch]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var action: JsonField<Action>? = null
+        private var status: JsonField<Status>? = null
+        private var type: JsonValue = JsonValue.from("web_search_call")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseFunctionWebSearch: BetaResponseFunctionWebSearch) = apply {
+            id = betaResponseFunctionWebSearch.id
+            action = betaResponseFunctionWebSearch.action
+            status = betaResponseFunctionWebSearch.status
+            type = betaResponseFunctionWebSearch.type
+            agent = betaResponseFunctionWebSearch.agent
+            additionalProperties = betaResponseFunctionWebSearch.additionalProperties.toMutableMap()
+        }
+
+        /** The unique ID of the web search tool call. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /**
+         * An object describing the specific action taken in this web search call. Includes details
+         * on how the model used the web (search, open_page, find_in_page).
+         */
+        fun action(action: Action) = action(JsonField.of(action))
+
+        /**
+         * Sets [Builder.action] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.action] with a well-typed [Action] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun action(action: JsonField<Action>) = apply { this.action = action }
+
+        /** Alias for calling [action] with `Action.ofSearch(search)`. */
+        fun action(search: Action.Search) = action(Action.ofSearch(search))
+
+        /** Alias for calling [action] with `Action.ofOpenPage(openPage)`. */
+        fun action(openPage: Action.OpenPage) = action(Action.ofOpenPage(openPage))
+
+        /** Alias for calling [action] with `Action.ofFindInPage(findInPage)`. */
+        fun action(findInPage: Action.FindInPage) = action(Action.ofFindInPage(findInPage))
+
+        /** The status of the web search tool call. */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("web_search_call")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseFunctionWebSearch].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .action()
+         * .status()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseFunctionWebSearch =
+            BetaResponseFunctionWebSearch(
+                checkRequired("id", id),
+                checkRequired("action", action),
+                checkRequired("status", status),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseFunctionWebSearch = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        action().validate()
+        status().validate()
+        _type().let {
+            if (it != JsonValue.from("web_search_call")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (action.asKnown().getOrNull()?.validity() ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("web_search_call")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * An object describing the specific action taken in this web search call. Includes details on
+     * how the model used the web (search, open_page, find_in_page).
+     */
+    @JsonDeserialize(using = Action.Deserializer::class)
+    @JsonSerialize(using = Action.Serializer::class)
+    class Action
+    private constructor(
+        private val search: Search? = null,
+        private val openPage: OpenPage? = null,
+        private val findInPage: FindInPage? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** Action type "search" - Performs a web search query. */
+        fun search(): Optional<Search> = Optional.ofNullable(search)
+
+        /** Action type "open_page" - Opens a specific URL from search results. */
+        fun openPage(): Optional<OpenPage> = Optional.ofNullable(openPage)
+
+        /** Action type "find_in_page": Searches for a pattern within a loaded page. */
+        fun findInPage(): Optional<FindInPage> = Optional.ofNullable(findInPage)
+
+        fun isSearch(): Boolean = search != null
+
+        fun isOpenPage(): Boolean = openPage != null
+
+        fun isFindInPage(): Boolean = findInPage != null
+
+        /** Action type "search" - Performs a web search query. */
+        fun asSearch(): Search = search.getOrThrow("search")
+
+        /** Action type "open_page" - Opens a specific URL from search results. */
+        fun asOpenPage(): OpenPage = openPage.getOrThrow("openPage")
+
+        /** Action type "find_in_page": Searches for a pattern within a loaded page. */
+        fun asFindInPage(): FindInPage = findInPage.getOrThrow("findInPage")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = action.accept(new Action.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitSearch(Search search) {
+         *         return Optional.of(search.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                search != null -> visitor.visitSearch(search)
+                openPage != null -> visitor.visitOpenPage(openPage)
+                findInPage != null -> visitor.visitFindInPage(findInPage)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Action = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitSearch(search: Search) {
+                        search.validate()
+                    }
+
+                    override fun visitOpenPage(openPage: OpenPage) {
+                        openPage.validate()
+                    }
+
+                    override fun visitFindInPage(findInPage: FindInPage) {
+                        findInPage.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitSearch(search: Search) = search.validity()
+
+                    override fun visitOpenPage(openPage: OpenPage) = openPage.validity()
+
+                    override fun visitFindInPage(findInPage: FindInPage) = findInPage.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Action &&
+                search == other.search &&
+                openPage == other.openPage &&
+                findInPage == other.findInPage
+        }
+
+        override fun hashCode(): Int = Objects.hash(search, openPage, findInPage)
+
+        override fun toString(): String =
+            when {
+                search != null -> "Action{search=$search}"
+                openPage != null -> "Action{openPage=$openPage}"
+                findInPage != null -> "Action{findInPage=$findInPage}"
+                _json != null -> "Action{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Action")
+            }
+
+        companion object {
+
+            /** Action type "search" - Performs a web search query. */
+            @JvmStatic fun ofSearch(search: Search) = Action(search = search)
+
+            /** Action type "open_page" - Opens a specific URL from search results. */
+            @JvmStatic fun ofOpenPage(openPage: OpenPage) = Action(openPage = openPage)
+
+            /** Action type "find_in_page": Searches for a pattern within a loaded page. */
+            @JvmStatic fun ofFindInPage(findInPage: FindInPage) = Action(findInPage = findInPage)
+        }
+
+        /** An interface that defines how to map each variant of [Action] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            /** Action type "search" - Performs a web search query. */
+            fun visitSearch(search: Search): T
+
+            /** Action type "open_page" - Opens a specific URL from search results. */
+            fun visitOpenPage(openPage: OpenPage): T
+
+            /** Action type "find_in_page": Searches for a pattern within a loaded page. */
+            fun visitFindInPage(findInPage: FindInPage): T
+
+            /**
+             * Maps an unknown variant of [Action] to a value of type [T].
+             *
+             * An instance of [Action] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Action: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Action>(Action::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Action {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "search" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Search>())?.let {
+                            Action(search = it, _json = json)
+                        } ?: Action(_json = json)
+                    }
+                    "open_page" -> {
+                        return tryDeserialize(node, jacksonTypeRef<OpenPage>())?.let {
+                            Action(openPage = it, _json = json)
+                        } ?: Action(_json = json)
+                    }
+                    "find_in_page" -> {
+                        return tryDeserialize(node, jacksonTypeRef<FindInPage>())?.let {
+                            Action(findInPage = it, _json = json)
+                        } ?: Action(_json = json)
+                    }
+                }
+
+                return Action(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Action>(Action::class) {
+
+            override fun serialize(
+                value: Action,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.search != null -> generator.writeObject(value.search)
+                    value.openPage != null -> generator.writeObject(value.openPage)
+                    value.findInPage != null -> generator.writeObject(value.findInPage)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Action")
+                }
+            }
+        }
+
+        /** Action type "search" - Performs a web search query. */
+        class Search
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val type: JsonValue,
+            private val queries: JsonField<List<String>>,
+            private val query: JsonField<String>,
+            private val sources: JsonField<List<Source>>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                @JsonProperty("queries")
+                @ExcludeMissing
+                queries: JsonField<List<String>> = JsonMissing.of(),
+                @JsonProperty("query") @ExcludeMissing query: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("sources")
+                @ExcludeMissing
+                sources: JsonField<List<Source>> = JsonMissing.of(),
+            ) : this(type, queries, query, sources, mutableMapOf())
+
+            /**
+             * The action type.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("search")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * The search queries.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun queries(): Optional<List<String>> = queries.getOptional("queries")
+
+            /**
+             * The search query.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            @Deprecated("deprecated") fun query(): Optional<String> = query.getOptional("query")
+
+            /**
+             * The sources used in the search.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun sources(): Optional<List<Source>> = sources.getOptional("sources")
+
+            /**
+             * Returns the raw JSON value of [queries].
+             *
+             * Unlike [queries], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("queries")
+            @ExcludeMissing
+            fun _queries(): JsonField<List<String>> = queries
+
+            /**
+             * Returns the raw JSON value of [query].
+             *
+             * Unlike [query], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @Deprecated("deprecated")
+            @JsonProperty("query")
+            @ExcludeMissing
+            fun _query(): JsonField<String> = query
+
+            /**
+             * Returns the raw JSON value of [sources].
+             *
+             * Unlike [sources], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("sources")
+            @ExcludeMissing
+            fun _sources(): JsonField<List<Source>> = sources
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /** Returns a mutable builder for constructing an instance of [Search]. */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Search]. */
+            class Builder internal constructor() {
+
+                private var type: JsonValue = JsonValue.from("search")
+                private var queries: JsonField<MutableList<String>>? = null
+                private var query: JsonField<String> = JsonMissing.of()
+                private var sources: JsonField<MutableList<Source>>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(search: Search) = apply {
+                    type = search.type
+                    queries = search.queries.map { it.toMutableList() }
+                    query = search.query
+                    sources = search.sources.map { it.toMutableList() }
+                    additionalProperties = search.additionalProperties.toMutableMap()
+                }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("search")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                /** The search queries. */
+                fun queries(queries: List<String>) = queries(JsonField.of(queries))
+
+                /**
+                 * Sets [Builder.queries] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.queries] with a well-typed `List<String>` value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun queries(queries: JsonField<List<String>>) = apply {
+                    this.queries = queries.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [String] to [queries].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addQuery(query: String) = apply {
+                    queries =
+                        (queries ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("queries", it).add(query)
+                        }
+                }
+
+                /** The search query. */
+                @Deprecated("deprecated") fun query(query: String) = query(JsonField.of(query))
+
+                /**
+                 * Sets [Builder.query] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.query] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                @Deprecated("deprecated")
+                fun query(query: JsonField<String>) = apply { this.query = query }
+
+                /** The sources used in the search. */
+                fun sources(sources: List<Source>) = sources(JsonField.of(sources))
+
+                /**
+                 * Sets [Builder.sources] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.sources] with a well-typed `List<Source>` value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun sources(sources: JsonField<List<Source>>) = apply {
+                    this.sources = sources.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [Source] to [sources].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addSource(source: Source) = apply {
+                    sources =
+                        (sources ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("sources", it).add(source)
+                        }
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Search].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): Search =
+                    Search(
+                        type,
+                        (queries ?: JsonMissing.of()).map { it.toImmutable() },
+                        query,
+                        (sources ?: JsonMissing.of()).map { it.toImmutable() },
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Search = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                _type().let {
+                    if (it != JsonValue.from("search")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                queries()
+                query()
+                sources().ifPresent { it.forEach { it.validate() } }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                type.let { if (it == JsonValue.from("search")) 1 else 0 } +
+                    (queries.asKnown().getOrNull()?.size ?: 0) +
+                    (if (query.asKnown().isPresent) 1 else 0) +
+                    (sources.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+            /** A source used in the search. */
+            class Source
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val type: JsonValue,
+                private val url: JsonField<String>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                    @JsonProperty("url") @ExcludeMissing url: JsonField<String> = JsonMissing.of(),
+                ) : this(type, url, mutableMapOf())
+
+                /**
+                 * The type of source. Always `url`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("url")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * The URL of the source.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun url(): String = url.getRequired("url")
+
+                /**
+                 * Returns the raw JSON value of [url].
+                 *
+                 * Unlike [url], this method doesn't throw if the JSON field has an unexpected type.
+                 */
+                @JsonProperty("url") @ExcludeMissing fun _url(): JsonField<String> = url
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Source].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .url()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Source]. */
+                class Builder internal constructor() {
+
+                    private var type: JsonValue = JsonValue.from("url")
+                    private var url: JsonField<String>? = null
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(source: Source) = apply {
+                        type = source.type
+                        url = source.url
+                        additionalProperties = source.additionalProperties.toMutableMap()
+                    }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("url")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    /** The URL of the source. */
+                    fun url(url: String) = url(JsonField.of(url))
+
+                    /**
+                     * Sets [Builder.url] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.url] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun url(url: JsonField<String>) = apply { this.url = url }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Source].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .url()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Source =
+                        Source(type, checkRequired("url", url), additionalProperties.toMutableMap())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Source = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    _type().let {
+                        if (it != JsonValue.from("url")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    url()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    type.let { if (it == JsonValue.from("url")) 1 else 0 } +
+                        (if (url.asKnown().isPresent) 1 else 0)
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Source &&
+                        type == other.type &&
+                        url == other.url &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(type, url, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Source{type=$type, url=$url, additionalProperties=$additionalProperties}"
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Search &&
+                    type == other.type &&
+                    queries == other.queries &&
+                    query == other.query &&
+                    sources == other.sources &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(type, queries, query, sources, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Search{type=$type, queries=$queries, query=$query, sources=$sources, additionalProperties=$additionalProperties}"
+        }
+
+        /** Action type "open_page" - Opens a specific URL from search results. */
+        class OpenPage
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val type: JsonValue,
+            private val url: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                @JsonProperty("url") @ExcludeMissing url: JsonField<String> = JsonMissing.of(),
+            ) : this(type, url, mutableMapOf())
+
+            /**
+             * The action type.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("open_page")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * The URL opened by the model.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun url(): Optional<String> = url.getOptional("url")
+
+            /**
+             * Returns the raw JSON value of [url].
+             *
+             * Unlike [url], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("url") @ExcludeMissing fun _url(): JsonField<String> = url
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /** Returns a mutable builder for constructing an instance of [OpenPage]. */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [OpenPage]. */
+            class Builder internal constructor() {
+
+                private var type: JsonValue = JsonValue.from("open_page")
+                private var url: JsonField<String> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(openPage: OpenPage) = apply {
+                    type = openPage.type
+                    url = openPage.url
+                    additionalProperties = openPage.additionalProperties.toMutableMap()
+                }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("open_page")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                /** The URL opened by the model. */
+                fun url(url: String?) = url(JsonField.ofNullable(url))
+
+                /** Alias for calling [Builder.url] with `url.orElse(null)`. */
+                fun url(url: Optional<String>) = url(url.getOrNull())
+
+                /**
+                 * Sets [Builder.url] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.url] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun url(url: JsonField<String>) = apply { this.url = url }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [OpenPage].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): OpenPage = OpenPage(type, url, additionalProperties.toMutableMap())
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): OpenPage = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                _type().let {
+                    if (it != JsonValue.from("open_page")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                url()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                type.let { if (it == JsonValue.from("open_page")) 1 else 0 } +
+                    (if (url.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is OpenPage &&
+                    type == other.type &&
+                    url == other.url &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(type, url, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "OpenPage{type=$type, url=$url, additionalProperties=$additionalProperties}"
+        }
+
+        /** Action type "find_in_page": Searches for a pattern within a loaded page. */
+        class FindInPage
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val pattern: JsonField<String>,
+            private val type: JsonValue,
+            private val url: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("pattern")
+                @ExcludeMissing
+                pattern: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                @JsonProperty("url") @ExcludeMissing url: JsonField<String> = JsonMissing.of(),
+            ) : this(pattern, type, url, mutableMapOf())
+
+            /**
+             * The pattern or text to search for within the page.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun pattern(): String = pattern.getRequired("pattern")
+
+            /**
+             * The action type.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("find_in_page")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * The URL of the page searched for the pattern.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun url(): String = url.getRequired("url")
+
+            /**
+             * Returns the raw JSON value of [pattern].
+             *
+             * Unlike [pattern], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("pattern") @ExcludeMissing fun _pattern(): JsonField<String> = pattern
+
+            /**
+             * Returns the raw JSON value of [url].
+             *
+             * Unlike [url], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("url") @ExcludeMissing fun _url(): JsonField<String> = url
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [FindInPage].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .pattern()
+                 * .url()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [FindInPage]. */
+            class Builder internal constructor() {
+
+                private var pattern: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("find_in_page")
+                private var url: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(findInPage: FindInPage) = apply {
+                    pattern = findInPage.pattern
+                    type = findInPage.type
+                    url = findInPage.url
+                    additionalProperties = findInPage.additionalProperties.toMutableMap()
+                }
+
+                /** The pattern or text to search for within the page. */
+                fun pattern(pattern: String) = pattern(JsonField.of(pattern))
+
+                /**
+                 * Sets [Builder.pattern] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.pattern] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun pattern(pattern: JsonField<String>) = apply { this.pattern = pattern }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("find_in_page")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                /** The URL of the page searched for the pattern. */
+                fun url(url: String) = url(JsonField.of(url))
+
+                /**
+                 * Sets [Builder.url] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.url] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun url(url: JsonField<String>) = apply { this.url = url }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [FindInPage].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .pattern()
+                 * .url()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): FindInPage =
+                    FindInPage(
+                        checkRequired("pattern", pattern),
+                        type,
+                        checkRequired("url", url),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): FindInPage = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                pattern()
+                _type().let {
+                    if (it != JsonValue.from("find_in_page")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                url()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (pattern.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("find_in_page")) 1 else 0 } +
+                    (if (url.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is FindInPage &&
+                    pattern == other.pattern &&
+                    type == other.type &&
+                    url == other.url &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(pattern, type, url, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "FindInPage{pattern=$pattern, type=$type, url=$url, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    /** The status of the web search tool call. */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val SEARCHING = of("searching")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val FAILED = of("failed")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            SEARCHING,
+            COMPLETED,
+            FAILED,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            SEARCHING,
+            COMPLETED,
+            FAILED,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                SEARCHING -> Value.SEARCHING
+                COMPLETED -> Value.COMPLETED
+                FAILED -> Value.FAILED
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                SEARCHING -> Known.SEARCHING
+                COMPLETED -> Known.COMPLETED
+                FAILED -> Known.FAILED
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseFunctionWebSearch &&
+            id == other.id &&
+            action == other.action &&
+            status == other.status &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(id, action, status, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseFunctionWebSearch{id=$id, action=$action, status=$status, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallCompletedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallCompletedEvent.kt
new file mode 100644
index 000000000..d487818e2
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallCompletedEvent.kt
@@ -0,0 +1,520 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when an image generation tool call has completed and the final image is available. */
+class BetaResponseImageGenCallCompletedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The unique identifier of the image generation item being processed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item in the response's output array.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always 'response.image_generation_call.completed'.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.image_generation_call.completed")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseImageGenCallCompletedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseImageGenCallCompletedEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.image_generation_call.completed")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseImageGenCallCompletedEvent: BetaResponseImageGenCallCompletedEvent
+        ) = apply {
+            itemId = betaResponseImageGenCallCompletedEvent.itemId
+            outputIndex = betaResponseImageGenCallCompletedEvent.outputIndex
+            sequenceNumber = betaResponseImageGenCallCompletedEvent.sequenceNumber
+            type = betaResponseImageGenCallCompletedEvent.type
+            agent = betaResponseImageGenCallCompletedEvent.agent
+            additionalProperties =
+                betaResponseImageGenCallCompletedEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The unique identifier of the image generation item being processed. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item in the response's output array. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.image_generation_call.completed")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseImageGenCallCompletedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseImageGenCallCompletedEvent =
+            BetaResponseImageGenCallCompletedEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseImageGenCallCompletedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.image_generation_call.completed")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.image_generation_call.completed")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseImageGenCallCompletedEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseImageGenCallCompletedEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallGeneratingEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallGeneratingEvent.kt
new file mode 100644
index 000000000..817dd0ee9
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallGeneratingEvent.kt
@@ -0,0 +1,522 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Emitted when an image generation tool call is actively generating an image (intermediate state).
+ */
+class BetaResponseImageGenCallGeneratingEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The unique identifier of the image generation item being processed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item in the response's output array.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of the image generation item being processed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always 'response.image_generation_call.generating'.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.image_generation_call.generating")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseImageGenCallGeneratingEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseImageGenCallGeneratingEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.image_generation_call.generating")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseImageGenCallGeneratingEvent: BetaResponseImageGenCallGeneratingEvent
+        ) = apply {
+            itemId = betaResponseImageGenCallGeneratingEvent.itemId
+            outputIndex = betaResponseImageGenCallGeneratingEvent.outputIndex
+            sequenceNumber = betaResponseImageGenCallGeneratingEvent.sequenceNumber
+            type = betaResponseImageGenCallGeneratingEvent.type
+            agent = betaResponseImageGenCallGeneratingEvent.agent
+            additionalProperties =
+                betaResponseImageGenCallGeneratingEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The unique identifier of the image generation item being processed. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item in the response's output array. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of the image generation item being processed. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.image_generation_call.generating")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseImageGenCallGeneratingEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseImageGenCallGeneratingEvent =
+            BetaResponseImageGenCallGeneratingEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseImageGenCallGeneratingEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.image_generation_call.generating")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.image_generation_call.generating")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseImageGenCallGeneratingEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseImageGenCallGeneratingEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallInProgressEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallInProgressEvent.kt
new file mode 100644
index 000000000..0c8554ec1
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallInProgressEvent.kt
@@ -0,0 +1,520 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when an image generation tool call is in progress. */
+class BetaResponseImageGenCallInProgressEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The unique identifier of the image generation item being processed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item in the response's output array.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of the image generation item being processed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always 'response.image_generation_call.in_progress'.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.image_generation_call.in_progress")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseImageGenCallInProgressEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseImageGenCallInProgressEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.image_generation_call.in_progress")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseImageGenCallInProgressEvent: BetaResponseImageGenCallInProgressEvent
+        ) = apply {
+            itemId = betaResponseImageGenCallInProgressEvent.itemId
+            outputIndex = betaResponseImageGenCallInProgressEvent.outputIndex
+            sequenceNumber = betaResponseImageGenCallInProgressEvent.sequenceNumber
+            type = betaResponseImageGenCallInProgressEvent.type
+            agent = betaResponseImageGenCallInProgressEvent.agent
+            additionalProperties =
+                betaResponseImageGenCallInProgressEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The unique identifier of the image generation item being processed. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item in the response's output array. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of the image generation item being processed. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.image_generation_call.in_progress")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseImageGenCallInProgressEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseImageGenCallInProgressEvent =
+            BetaResponseImageGenCallInProgressEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseImageGenCallInProgressEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.image_generation_call.in_progress")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.image_generation_call.in_progress")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseImageGenCallInProgressEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseImageGenCallInProgressEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallPartialImageEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallPartialImageEvent.kt
new file mode 100644
index 000000000..d25e3a156
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallPartialImageEvent.kt
@@ -0,0 +1,630 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a partial image is available during image generation streaming. */
+class BetaResponseImageGenCallPartialImageEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val partialImageB64: JsonField<String>,
+    private val partialImageIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("partial_image_b64")
+        @ExcludeMissing
+        partialImageB64: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("partial_image_index")
+        @ExcludeMissing
+        partialImageIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(
+        itemId,
+        outputIndex,
+        partialImageB64,
+        partialImageIndex,
+        sequenceNumber,
+        type,
+        agent,
+        mutableMapOf(),
+    )
+
+    /**
+     * The unique identifier of the image generation item being processed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item in the response's output array.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * Base64-encoded partial image data, suitable for rendering as an image.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun partialImageB64(): String = partialImageB64.getRequired("partial_image_b64")
+
+    /**
+     * 0-based index for the partial image (backend is 1-based, but this is 0-based for the user).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun partialImageIndex(): Long = partialImageIndex.getRequired("partial_image_index")
+
+    /**
+     * The sequence number of the image generation item being processed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always 'response.image_generation_call.partial_image'.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.image_generation_call.partial_image")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [partialImageB64].
+     *
+     * Unlike [partialImageB64], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("partial_image_b64")
+    @ExcludeMissing
+    fun _partialImageB64(): JsonField<String> = partialImageB64
+
+    /**
+     * Returns the raw JSON value of [partialImageIndex].
+     *
+     * Unlike [partialImageIndex], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("partial_image_index")
+    @ExcludeMissing
+    fun _partialImageIndex(): JsonField<Long> = partialImageIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseImageGenCallPartialImageEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .partialImageB64()
+         * .partialImageIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseImageGenCallPartialImageEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var partialImageB64: JsonField<String>? = null
+        private var partialImageIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.image_generation_call.partial_image")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseImageGenCallPartialImageEvent: BetaResponseImageGenCallPartialImageEvent
+        ) = apply {
+            itemId = betaResponseImageGenCallPartialImageEvent.itemId
+            outputIndex = betaResponseImageGenCallPartialImageEvent.outputIndex
+            partialImageB64 = betaResponseImageGenCallPartialImageEvent.partialImageB64
+            partialImageIndex = betaResponseImageGenCallPartialImageEvent.partialImageIndex
+            sequenceNumber = betaResponseImageGenCallPartialImageEvent.sequenceNumber
+            type = betaResponseImageGenCallPartialImageEvent.type
+            agent = betaResponseImageGenCallPartialImageEvent.agent
+            additionalProperties =
+                betaResponseImageGenCallPartialImageEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The unique identifier of the image generation item being processed. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item in the response's output array. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** Base64-encoded partial image data, suitable for rendering as an image. */
+        fun partialImageB64(partialImageB64: String) =
+            partialImageB64(JsonField.of(partialImageB64))
+
+        /**
+         * Sets [Builder.partialImageB64] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.partialImageB64] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun partialImageB64(partialImageB64: JsonField<String>) = apply {
+            this.partialImageB64 = partialImageB64
+        }
+
+        /**
+         * 0-based index for the partial image (backend is 1-based, but this is 0-based for the
+         * user).
+         */
+        fun partialImageIndex(partialImageIndex: Long) =
+            partialImageIndex(JsonField.of(partialImageIndex))
+
+        /**
+         * Sets [Builder.partialImageIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.partialImageIndex] with a well-typed [Long] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun partialImageIndex(partialImageIndex: JsonField<Long>) = apply {
+            this.partialImageIndex = partialImageIndex
+        }
+
+        /** The sequence number of the image generation item being processed. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.image_generation_call.partial_image")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseImageGenCallPartialImageEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .partialImageB64()
+         * .partialImageIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseImageGenCallPartialImageEvent =
+            BetaResponseImageGenCallPartialImageEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("partialImageB64", partialImageB64),
+                checkRequired("partialImageIndex", partialImageIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseImageGenCallPartialImageEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        partialImageB64()
+        partialImageIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.image_generation_call.partial_image")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (partialImageB64.asKnown().isPresent) 1 else 0) +
+            (if (partialImageIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.image_generation_call.partial_image")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseImageGenCallPartialImageEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            partialImageB64 == other.partialImageB64 &&
+            partialImageIndex == other.partialImageIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            itemId,
+            outputIndex,
+            partialImageB64,
+            partialImageIndex,
+            sequenceNumber,
+            type,
+            agent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseImageGenCallPartialImageEvent{itemId=$itemId, outputIndex=$outputIndex, partialImageB64=$partialImageB64, partialImageIndex=$partialImageIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInProgressEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInProgressEvent.kt
new file mode 100644
index 000000000..2929ba3be
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInProgressEvent.kt
@@ -0,0 +1,478 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when the response is in progress. */
+class BetaResponseInProgressEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val response: JsonField<BetaResponse>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("response")
+        @ExcludeMissing
+        response: JsonField<BetaResponse> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(response, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The response that is in progress.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun response(): BetaResponse = response.getRequired("response")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.in_progress`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.in_progress")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [response].
+     *
+     * Unlike [response], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("response") @ExcludeMissing fun _response(): JsonField<BetaResponse> = response
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseInProgressEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .response()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseInProgressEvent]. */
+    class Builder internal constructor() {
+
+        private var response: JsonField<BetaResponse>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.in_progress")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseInProgressEvent: BetaResponseInProgressEvent) = apply {
+            response = betaResponseInProgressEvent.response
+            sequenceNumber = betaResponseInProgressEvent.sequenceNumber
+            type = betaResponseInProgressEvent.type
+            agent = betaResponseInProgressEvent.agent
+            additionalProperties = betaResponseInProgressEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The response that is in progress. */
+        fun response(response: BetaResponse) = response(JsonField.of(response))
+
+        /**
+         * Sets [Builder.response] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.response] with a well-typed [BetaResponse] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun response(response: JsonField<BetaResponse>) = apply { this.response = response }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.in_progress")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseInProgressEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .response()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseInProgressEvent =
+            BetaResponseInProgressEvent(
+                checkRequired("response", response),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseInProgressEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        response().validate()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.in_progress")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (response.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.in_progress")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseInProgressEvent &&
+            response == other.response &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(response, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseInProgressEvent{response=$response, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseIncludable.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseIncludable.kt
new file mode 100644
index 000000000..af7331b68
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseIncludable.kt
@@ -0,0 +1,195 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.openai.core.Enum
+import com.openai.core.JsonField
+import com.openai.errors.OpenAIInvalidDataException
+
+/**
+ * Specify additional output data to include in the model response. Currently supported values are:
+ * - `web_search_call.results`: Include the search results of the web search tool call.
+ * - `web_search_call.action.sources`: Include the sources of the web search tool call.
+ * - `code_interpreter_call.outputs`: Includes the outputs of python code execution in code
+ *   interpreter tool call items.
+ * - `computer_call_output.output.image_url`: Include image urls from the computer call output.
+ * - `file_search_call.results`: Include the search results of the file search tool call.
+ * - `message.input_image.image_url`: Include image urls from the input message.
+ * - `message.output_text.logprobs`: Include logprobs with assistant messages.
+ * - `reasoning.encrypted_content`: Includes an encrypted version of reasoning tokens in reasoning
+ *   item outputs. This enables reasoning items to be used in multi-turn conversations when using
+ *   the Responses API statelessly (like when the `store` parameter is set to `false`, or when an
+ *   organization is enrolled in the zero data retention program).
+ */
+class BetaResponseIncludable
+@JsonCreator
+private constructor(private val value: JsonField<String>) : Enum {
+
+    /**
+     * Returns this class instance's raw value.
+     *
+     * This is usually only useful if this instance was deserialized from data that doesn't match
+     * any known member, and you want to know that value. For example, if the SDK is on an older
+     * version than the API, then the API may respond with new members that the SDK is unaware of.
+     */
+    @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+    companion object {
+
+        @JvmField val FILE_SEARCH_CALL_RESULTS = of("file_search_call.results")
+
+        @JvmField val WEB_SEARCH_CALL_RESULTS = of("web_search_call.results")
+
+        @JvmField val WEB_SEARCH_CALL_ACTION_SOURCES = of("web_search_call.action.sources")
+
+        @JvmField val MESSAGE_INPUT_IMAGE_IMAGE_URL = of("message.input_image.image_url")
+
+        @JvmField
+        val COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL = of("computer_call_output.output.image_url")
+
+        @JvmField val CODE_INTERPRETER_CALL_OUTPUTS = of("code_interpreter_call.outputs")
+
+        @JvmField val REASONING_ENCRYPTED_CONTENT = of("reasoning.encrypted_content")
+
+        @JvmField val MESSAGE_OUTPUT_TEXT_LOGPROBS = of("message.output_text.logprobs")
+
+        @JvmStatic fun of(value: String) = BetaResponseIncludable(JsonField.of(value))
+    }
+
+    /** An enum containing [BetaResponseIncludable]'s known values. */
+    enum class Known {
+        FILE_SEARCH_CALL_RESULTS,
+        WEB_SEARCH_CALL_RESULTS,
+        WEB_SEARCH_CALL_ACTION_SOURCES,
+        MESSAGE_INPUT_IMAGE_IMAGE_URL,
+        COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL,
+        CODE_INTERPRETER_CALL_OUTPUTS,
+        REASONING_ENCRYPTED_CONTENT,
+        MESSAGE_OUTPUT_TEXT_LOGPROBS,
+    }
+
+    /**
+     * An enum containing [BetaResponseIncludable]'s known values, as well as an [_UNKNOWN] member.
+     *
+     * An instance of [BetaResponseIncludable] can contain an unknown value in a couple of cases:
+     * - It was deserialized from data that doesn't match any known member. For example, if the SDK
+     *   is on an older version than the API, then the API may respond with new members that the SDK
+     *   is unaware of.
+     * - It was constructed with an arbitrary value using the [of] method.
+     */
+    enum class Value {
+        FILE_SEARCH_CALL_RESULTS,
+        WEB_SEARCH_CALL_RESULTS,
+        WEB_SEARCH_CALL_ACTION_SOURCES,
+        MESSAGE_INPUT_IMAGE_IMAGE_URL,
+        COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL,
+        CODE_INTERPRETER_CALL_OUTPUTS,
+        REASONING_ENCRYPTED_CONTENT,
+        MESSAGE_OUTPUT_TEXT_LOGPROBS,
+        /**
+         * An enum member indicating that [BetaResponseIncludable] was instantiated with an unknown
+         * value.
+         */
+        _UNKNOWN,
+    }
+
+    /**
+     * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN] if
+     * the class was instantiated with an unknown value.
+     *
+     * Use the [known] method instead if you're certain the value is always known or if you want to
+     * throw for the unknown case.
+     */
+    fun value(): Value =
+        when (this) {
+            FILE_SEARCH_CALL_RESULTS -> Value.FILE_SEARCH_CALL_RESULTS
+            WEB_SEARCH_CALL_RESULTS -> Value.WEB_SEARCH_CALL_RESULTS
+            WEB_SEARCH_CALL_ACTION_SOURCES -> Value.WEB_SEARCH_CALL_ACTION_SOURCES
+            MESSAGE_INPUT_IMAGE_IMAGE_URL -> Value.MESSAGE_INPUT_IMAGE_IMAGE_URL
+            COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL -> Value.COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL
+            CODE_INTERPRETER_CALL_OUTPUTS -> Value.CODE_INTERPRETER_CALL_OUTPUTS
+            REASONING_ENCRYPTED_CONTENT -> Value.REASONING_ENCRYPTED_CONTENT
+            MESSAGE_OUTPUT_TEXT_LOGPROBS -> Value.MESSAGE_OUTPUT_TEXT_LOGPROBS
+            else -> Value._UNKNOWN
+        }
+
+    /**
+     * Returns an enum member corresponding to this class instance's value.
+     *
+     * Use the [value] method instead if you're uncertain the value is always known and don't want
+     * to throw for the unknown case.
+     *
+     * @throws OpenAIInvalidDataException if this class instance's value is a not a known member.
+     */
+    fun known(): Known =
+        when (this) {
+            FILE_SEARCH_CALL_RESULTS -> Known.FILE_SEARCH_CALL_RESULTS
+            WEB_SEARCH_CALL_RESULTS -> Known.WEB_SEARCH_CALL_RESULTS
+            WEB_SEARCH_CALL_ACTION_SOURCES -> Known.WEB_SEARCH_CALL_ACTION_SOURCES
+            MESSAGE_INPUT_IMAGE_IMAGE_URL -> Known.MESSAGE_INPUT_IMAGE_IMAGE_URL
+            COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL -> Known.COMPUTER_CALL_OUTPUT_OUTPUT_IMAGE_URL
+            CODE_INTERPRETER_CALL_OUTPUTS -> Known.CODE_INTERPRETER_CALL_OUTPUTS
+            REASONING_ENCRYPTED_CONTENT -> Known.REASONING_ENCRYPTED_CONTENT
+            MESSAGE_OUTPUT_TEXT_LOGPROBS -> Known.MESSAGE_OUTPUT_TEXT_LOGPROBS
+            else -> throw OpenAIInvalidDataException("Unknown BetaResponseIncludable: $value")
+        }
+
+    /**
+     * Returns this class instance's primitive wire representation.
+     *
+     * This differs from the [toString] method because that method is primarily for debugging and
+     * generally doesn't throw.
+     *
+     * @throws OpenAIInvalidDataException if this class instance's value does not have the expected
+     *   primitive type.
+     */
+    fun asString(): String =
+        _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseIncludable = apply {
+        if (validated) {
+            return@apply
+        }
+
+        known()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseIncludable && value == other.value
+    }
+
+    override fun hashCode() = value.hashCode()
+
+    override fun toString() = value.toString()
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseIncompleteEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseIncompleteEvent.kt
new file mode 100644
index 000000000..9be891f41
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseIncompleteEvent.kt
@@ -0,0 +1,478 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** An event that is emitted when a response finishes as incomplete. */
+class BetaResponseIncompleteEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val response: JsonField<BetaResponse>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("response")
+        @ExcludeMissing
+        response: JsonField<BetaResponse> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(response, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The response that was incomplete.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun response(): BetaResponse = response.getRequired("response")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.incomplete`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.incomplete")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [response].
+     *
+     * Unlike [response], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("response") @ExcludeMissing fun _response(): JsonField<BetaResponse> = response
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseIncompleteEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .response()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseIncompleteEvent]. */
+    class Builder internal constructor() {
+
+        private var response: JsonField<BetaResponse>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.incomplete")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseIncompleteEvent: BetaResponseIncompleteEvent) = apply {
+            response = betaResponseIncompleteEvent.response
+            sequenceNumber = betaResponseIncompleteEvent.sequenceNumber
+            type = betaResponseIncompleteEvent.type
+            agent = betaResponseIncompleteEvent.agent
+            additionalProperties = betaResponseIncompleteEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The response that was incomplete. */
+        fun response(response: BetaResponse) = response(JsonField.of(response))
+
+        /**
+         * Sets [Builder.response] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.response] with a well-typed [BetaResponse] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun response(response: JsonField<BetaResponse>) = apply { this.response = response }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.incomplete")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseIncompleteEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .response()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseIncompleteEvent =
+            BetaResponseIncompleteEvent(
+                checkRequired("response", response),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseIncompleteEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        response().validate()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.incomplete")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (response.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.incomplete")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseIncompleteEvent &&
+            response == other.response &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(response, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseIncompleteEvent{response=$response, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInjectCreatedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInjectCreatedEvent.kt
new file mode 100644
index 000000000..c73b3cfed
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInjectCreatedEvent.kt
@@ -0,0 +1,312 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+
+/** Emitted when all injected input items were validated and committed to the active response. */
+class BetaResponseInjectCreatedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val responseId: JsonField<String>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val streamId: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("response_id")
+        @ExcludeMissing
+        responseId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("stream_id") @ExcludeMissing streamId: JsonField<String> = JsonMissing.of(),
+    ) : this(responseId, sequenceNumber, type, streamId, mutableMapOf())
+
+    /**
+     * The ID of the response that accepted the input.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun responseId(): String = responseId.getRequired("response_id")
+
+    /**
+     * The sequence number for this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The event discriminator. Always `response.inject.created`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.inject.created")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The multiplexed WebSocket stream that emitted the event. This field is present only when
+     * WebSocket multiplexing is enabled separately.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun streamId(): Optional<String> = streamId.getOptional("stream_id")
+
+    /**
+     * Returns the raw JSON value of [responseId].
+     *
+     * Unlike [responseId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("response_id") @ExcludeMissing fun _responseId(): JsonField<String> = responseId
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [streamId].
+     *
+     * Unlike [streamId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("stream_id") @ExcludeMissing fun _streamId(): JsonField<String> = streamId
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseInjectCreatedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .responseId()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseInjectCreatedEvent]. */
+    class Builder internal constructor() {
+
+        private var responseId: JsonField<String>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.inject.created")
+        private var streamId: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseInjectCreatedEvent: BetaResponseInjectCreatedEvent) = apply {
+            responseId = betaResponseInjectCreatedEvent.responseId
+            sequenceNumber = betaResponseInjectCreatedEvent.sequenceNumber
+            type = betaResponseInjectCreatedEvent.type
+            streamId = betaResponseInjectCreatedEvent.streamId
+            additionalProperties =
+                betaResponseInjectCreatedEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The ID of the response that accepted the input. */
+        fun responseId(responseId: String) = responseId(JsonField.of(responseId))
+
+        /**
+         * Sets [Builder.responseId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.responseId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun responseId(responseId: JsonField<String>) = apply { this.responseId = responseId }
+
+        /** The sequence number for this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.inject.created")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /**
+         * The multiplexed WebSocket stream that emitted the event. This field is present only when
+         * WebSocket multiplexing is enabled separately.
+         */
+        fun streamId(streamId: String) = streamId(JsonField.of(streamId))
+
+        /**
+         * Sets [Builder.streamId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.streamId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun streamId(streamId: JsonField<String>) = apply { this.streamId = streamId }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseInjectCreatedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .responseId()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseInjectCreatedEvent =
+            BetaResponseInjectCreatedEvent(
+                checkRequired("responseId", responseId),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                streamId,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseInjectCreatedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        responseId()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.inject.created")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        streamId()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (responseId.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.inject.created")) 1 else 0 } +
+            (if (streamId.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseInjectCreatedEvent &&
+            responseId == other.responseId &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            streamId == other.streamId &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(responseId, sequenceNumber, type, streamId, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseInjectCreatedEvent{responseId=$responseId, sequenceNumber=$sequenceNumber, type=$type, streamId=$streamId, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInjectEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInjectEvent.kt
new file mode 100644
index 000000000..85127e313
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInjectEvent.kt
@@ -0,0 +1,573 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Injects input items into an active response over a WebSocket connection. The items are validated
+ * and committed atomically. Currently, the server accepts client-owned tool outputs that resume a
+ * waiting agent.
+ */
+class BetaResponseInjectEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val input: JsonField<List<BetaResponseInputItem>>,
+    private val responseId: JsonField<String>,
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("input")
+        @ExcludeMissing
+        input: JsonField<List<BetaResponseInputItem>> = JsonMissing.of(),
+        @JsonProperty("response_id")
+        @ExcludeMissing
+        responseId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+    ) : this(input, responseId, type, mutableMapOf())
+
+    /**
+     * Input items to inject into the active response.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun input(): List<BetaResponseInputItem> = input.getRequired("input")
+
+    /**
+     * The ID of the active response that should receive the input.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun responseId(): String = responseId.getRequired("response_id")
+
+    /**
+     * The event discriminator. Always `response.inject`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.inject")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Returns the raw JSON value of [input].
+     *
+     * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("input")
+    @ExcludeMissing
+    fun _input(): JsonField<List<BetaResponseInputItem>> = input
+
+    /**
+     * Returns the raw JSON value of [responseId].
+     *
+     * Unlike [responseId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("response_id") @ExcludeMissing fun _responseId(): JsonField<String> = responseId
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseInjectEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .input()
+         * .responseId()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseInjectEvent]. */
+    class Builder internal constructor() {
+
+        private var input: JsonField<MutableList<BetaResponseInputItem>>? = null
+        private var responseId: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("response.inject")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseInjectEvent: BetaResponseInjectEvent) = apply {
+            input = betaResponseInjectEvent.input.map { it.toMutableList() }
+            responseId = betaResponseInjectEvent.responseId
+            type = betaResponseInjectEvent.type
+            additionalProperties = betaResponseInjectEvent.additionalProperties.toMutableMap()
+        }
+
+        /** Input items to inject into the active response. */
+        fun input(input: List<BetaResponseInputItem>) = input(JsonField.of(input))
+
+        /**
+         * Sets [Builder.input] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.input] with a well-typed `List<BetaResponseInputItem>`
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun input(input: JsonField<List<BetaResponseInputItem>>) = apply {
+            this.input = input.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [BetaResponseInputItem] to [Builder.input].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addInput(input: BetaResponseInputItem) = apply {
+            this.input =
+                (this.input ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("input", it).add(input)
+                }
+        }
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofBetaEasyInputMessage(betaEasyInputMessage)`.
+         */
+        fun addInput(betaEasyInputMessage: BetaEasyInputMessage) =
+            addInput(BetaResponseInputItem.ofBetaEasyInputMessage(betaEasyInputMessage))
+
+        /** Alias for calling [addInput] with `BetaResponseInputItem.ofMessage(message)`. */
+        fun addInput(message: BetaResponseInputItem.Message) =
+            addInput(BetaResponseInputItem.ofMessage(message))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofBetaResponseOutputMessage(betaResponseOutputMessage)`.
+         */
+        fun addInput(betaResponseOutputMessage: BetaResponseOutputMessage) =
+            addInput(BetaResponseInputItem.ofBetaResponseOutputMessage(betaResponseOutputMessage))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofFileSearchCall(fileSearchCall)`.
+         */
+        fun addInput(fileSearchCall: BetaResponseFileSearchToolCall) =
+            addInput(BetaResponseInputItem.ofFileSearchCall(fileSearchCall))
+
+        /**
+         * Alias for calling [addInput] with `BetaResponseInputItem.ofComputerCall(computerCall)`.
+         */
+        fun addInput(computerCall: BetaResponseComputerToolCall) =
+            addInput(BetaResponseInputItem.ofComputerCall(computerCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofComputerCallOutput(computerCallOutput)`.
+         */
+        fun addInput(computerCallOutput: BetaResponseInputItem.ComputerCallOutput) =
+            addInput(BetaResponseInputItem.ofComputerCallOutput(computerCallOutput))
+
+        /**
+         * Alias for calling [addInput] with `BetaResponseInputItem.ofWebSearchCall(webSearchCall)`.
+         */
+        fun addInput(webSearchCall: BetaResponseFunctionWebSearch) =
+            addInput(BetaResponseInputItem.ofWebSearchCall(webSearchCall))
+
+        /**
+         * Alias for calling [addInput] with `BetaResponseInputItem.ofFunctionCall(functionCall)`.
+         */
+        fun addInput(functionCall: BetaResponseFunctionToolCall) =
+            addInput(BetaResponseInputItem.ofFunctionCall(functionCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofFunctionCallOutput(functionCallOutput)`.
+         */
+        fun addInput(functionCallOutput: BetaResponseInputItem.FunctionCallOutput) =
+            addInput(BetaResponseInputItem.ofFunctionCallOutput(functionCallOutput))
+
+        /**
+         * Alias for calling [addInput] with `BetaResponseInputItem.ofAgentMessage(agentMessage)`.
+         */
+        fun addInput(agentMessage: BetaResponseInputItem.AgentMessage) =
+            addInput(BetaResponseInputItem.ofAgentMessage(agentMessage))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofMultiAgentCall(multiAgentCall)`.
+         */
+        fun addInput(multiAgentCall: BetaResponseInputItem.MultiAgentCall) =
+            addInput(BetaResponseInputItem.ofMultiAgentCall(multiAgentCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofMultiAgentCallOutput(multiAgentCallOutput)`.
+         */
+        fun addInput(multiAgentCallOutput: BetaResponseInputItem.MultiAgentCallOutput) =
+            addInput(BetaResponseInputItem.ofMultiAgentCallOutput(multiAgentCallOutput))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofToolSearchCall(toolSearchCall)`.
+         */
+        fun addInput(toolSearchCall: BetaResponseInputItem.ToolSearchCall) =
+            addInput(BetaResponseInputItem.ofToolSearchCall(toolSearchCall))
+
+        /**
+         * Alias for calling [addInput] with the following:
+         * ```java
+         * BetaResponseInputItem.ToolSearchCall.builder()
+         *     .arguments(arguments)
+         *     .build()
+         * ```
+         */
+        fun addToolSearchCallInput(arguments: JsonValue) =
+            addInput(BetaResponseInputItem.ToolSearchCall.builder().arguments(arguments).build())
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofToolSearchOutput(toolSearchOutput)`.
+         */
+        fun addInput(toolSearchOutput: BetaResponseToolSearchOutputItemParam) =
+            addInput(BetaResponseInputItem.ofToolSearchOutput(toolSearchOutput))
+
+        /**
+         * Alias for calling [addInput] with the following:
+         * ```java
+         * BetaResponseToolSearchOutputItemParam.builder()
+         *     .tools(tools)
+         *     .build()
+         * ```
+         */
+        fun addToolSearchOutputInput(tools: List<BetaTool>) =
+            addInput(BetaResponseToolSearchOutputItemParam.builder().tools(tools).build())
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofAdditionalTools(additionalTools)`.
+         */
+        fun addInput(additionalTools: BetaResponseInputItem.AdditionalTools) =
+            addInput(BetaResponseInputItem.ofAdditionalTools(additionalTools))
+
+        /**
+         * Alias for calling [addInput] with the following:
+         * ```java
+         * BetaResponseInputItem.AdditionalTools.builder()
+         *     .tools(tools)
+         *     .build()
+         * ```
+         */
+        fun addAdditionalToolsInput(tools: List<BetaTool>) =
+            addInput(BetaResponseInputItem.AdditionalTools.builder().tools(tools).build())
+
+        /** Alias for calling [addInput] with `BetaResponseInputItem.ofReasoning(reasoning)`. */
+        fun addInput(reasoning: BetaResponseReasoningItem) =
+            addInput(BetaResponseInputItem.ofReasoning(reasoning))
+
+        /** Alias for calling [addInput] with `BetaResponseInputItem.ofCompaction(compaction)`. */
+        fun addInput(compaction: BetaResponseCompactionItemParam) =
+            addInput(BetaResponseInputItem.ofCompaction(compaction))
+
+        /**
+         * Alias for calling [addInput] with the following:
+         * ```java
+         * BetaResponseCompactionItemParam.builder()
+         *     .encryptedContent(encryptedContent)
+         *     .build()
+         * ```
+         */
+        fun addCompactionInput(encryptedContent: String) =
+            addInput(
+                BetaResponseCompactionItemParam.builder().encryptedContent(encryptedContent).build()
+            )
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofImageGenerationCall(imageGenerationCall)`.
+         */
+        fun addInput(imageGenerationCall: BetaResponseInputItem.ImageGenerationCall) =
+            addInput(BetaResponseInputItem.ofImageGenerationCall(imageGenerationCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofCodeInterpreterCall(codeInterpreterCall)`.
+         */
+        fun addInput(codeInterpreterCall: BetaResponseCodeInterpreterToolCall) =
+            addInput(BetaResponseInputItem.ofCodeInterpreterCall(codeInterpreterCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofLocalShellCall(localShellCall)`.
+         */
+        fun addInput(localShellCall: BetaResponseInputItem.LocalShellCall) =
+            addInput(BetaResponseInputItem.ofLocalShellCall(localShellCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofLocalShellCallOutput(localShellCallOutput)`.
+         */
+        fun addInput(localShellCallOutput: BetaResponseInputItem.LocalShellCallOutput) =
+            addInput(BetaResponseInputItem.ofLocalShellCallOutput(localShellCallOutput))
+
+        /** Alias for calling [addInput] with `BetaResponseInputItem.ofShellCall(shellCall)`. */
+        fun addInput(shellCall: BetaResponseInputItem.ShellCall) =
+            addInput(BetaResponseInputItem.ofShellCall(shellCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofShellCallOutput(shellCallOutput)`.
+         */
+        fun addInput(shellCallOutput: BetaResponseInputItem.ShellCallOutput) =
+            addInput(BetaResponseInputItem.ofShellCallOutput(shellCallOutput))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofApplyPatchCall(applyPatchCall)`.
+         */
+        fun addInput(applyPatchCall: BetaResponseInputItem.ApplyPatchCall) =
+            addInput(BetaResponseInputItem.ofApplyPatchCall(applyPatchCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofApplyPatchCallOutput(applyPatchCallOutput)`.
+         */
+        fun addInput(applyPatchCallOutput: BetaResponseInputItem.ApplyPatchCallOutput) =
+            addInput(BetaResponseInputItem.ofApplyPatchCallOutput(applyPatchCallOutput))
+
+        /**
+         * Alias for calling [addInput] with `BetaResponseInputItem.ofMcpListTools(mcpListTools)`.
+         */
+        fun addInput(mcpListTools: BetaResponseInputItem.McpListTools) =
+            addInput(BetaResponseInputItem.ofMcpListTools(mcpListTools))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofMcpApprovalRequest(mcpApprovalRequest)`.
+         */
+        fun addInput(mcpApprovalRequest: BetaResponseInputItem.McpApprovalRequest) =
+            addInput(BetaResponseInputItem.ofMcpApprovalRequest(mcpApprovalRequest))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofMcpApprovalResponse(mcpApprovalResponse)`.
+         */
+        fun addInput(mcpApprovalResponse: BetaResponseInputItem.McpApprovalResponse) =
+            addInput(BetaResponseInputItem.ofMcpApprovalResponse(mcpApprovalResponse))
+
+        /** Alias for calling [addInput] with `BetaResponseInputItem.ofMcpCall(mcpCall)`. */
+        fun addInput(mcpCall: BetaResponseInputItem.McpCall) =
+            addInput(BetaResponseInputItem.ofMcpCall(mcpCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofCustomToolCallOutput(customToolCallOutput)`.
+         */
+        fun addInput(customToolCallOutput: BetaResponseCustomToolCallOutput) =
+            addInput(BetaResponseInputItem.ofCustomToolCallOutput(customToolCallOutput))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofCustomToolCall(customToolCall)`.
+         */
+        fun addInput(customToolCall: BetaResponseCustomToolCall) =
+            addInput(BetaResponseInputItem.ofCustomToolCall(customToolCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofCompactionTrigger(compactionTrigger)`.
+         */
+        fun addInput(compactionTrigger: BetaResponseInputItem.CompactionTrigger) =
+            addInput(BetaResponseInputItem.ofCompactionTrigger(compactionTrigger))
+
+        /**
+         * Alias for calling [addInput] with `BetaResponseInputItem.ofItemReference(itemReference)`.
+         */
+        fun addInput(itemReference: BetaResponseInputItem.ItemReference) =
+            addInput(BetaResponseInputItem.ofItemReference(itemReference))
+
+        /**
+         * Alias for calling [addInput] with the following:
+         * ```java
+         * BetaResponseInputItem.ItemReference.builder()
+         *     .type(BetaResponseInputItem.ItemReference.Type.ITEM_REFERENCE)
+         *     .id(id)
+         *     .build()
+         * ```
+         */
+        fun addItemReferenceInput(id: String) =
+            addInput(
+                BetaResponseInputItem.ItemReference.builder()
+                    .type(BetaResponseInputItem.ItemReference.Type.ITEM_REFERENCE)
+                    .id(id)
+                    .build()
+            )
+
+        /** Alias for calling [addInput] with `BetaResponseInputItem.ofProgram(program)`. */
+        fun addInput(program: BetaResponseInputItem.Program) =
+            addInput(BetaResponseInputItem.ofProgram(program))
+
+        /**
+         * Alias for calling [addInput] with `BetaResponseInputItem.ofProgramOutput(programOutput)`.
+         */
+        fun addInput(programOutput: BetaResponseInputItem.ProgramOutput) =
+            addInput(BetaResponseInputItem.ofProgramOutput(programOutput))
+
+        /** The ID of the active response that should receive the input. */
+        fun responseId(responseId: String) = responseId(JsonField.of(responseId))
+
+        /**
+         * Sets [Builder.responseId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.responseId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun responseId(responseId: JsonField<String>) = apply { this.responseId = responseId }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.inject")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseInjectEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .input()
+         * .responseId()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseInjectEvent =
+            BetaResponseInjectEvent(
+                checkRequired("input", input).map { it.toImmutable() },
+                checkRequired("responseId", responseId),
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseInjectEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        input().forEach { it.validate() }
+        responseId()
+        _type().let {
+            if (it != JsonValue.from("response.inject")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (input.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (if (responseId.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.inject")) 1 else 0 }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseInjectEvent &&
+            input == other.input &&
+            responseId == other.responseId &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(input, responseId, type, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseInjectEvent{input=$input, responseId=$responseId, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInjectFailedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInjectFailedEvent.kt
new file mode 100644
index 000000000..c474452da
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInjectFailedEvent.kt
@@ -0,0 +1,1038 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Emitted when injected input could not be committed to a response. The event returns the
+ * uncommitted raw input so the client can retry it in another response when appropriate.
+ */
+class BetaResponseInjectFailedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val error: JsonField<Error>,
+    private val input: JsonField<List<BetaResponseInputItem>>,
+    private val responseId: JsonField<String>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val streamId: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("error") @ExcludeMissing error: JsonField<Error> = JsonMissing.of(),
+        @JsonProperty("input")
+        @ExcludeMissing
+        input: JsonField<List<BetaResponseInputItem>> = JsonMissing.of(),
+        @JsonProperty("response_id")
+        @ExcludeMissing
+        responseId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("stream_id") @ExcludeMissing streamId: JsonField<String> = JsonMissing.of(),
+    ) : this(error, input, responseId, sequenceNumber, type, streamId, mutableMapOf())
+
+    /**
+     * Information about why the input was not committed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun error(): Error = error.getRequired("error")
+
+    /**
+     * The raw input items that were not committed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun input(): List<BetaResponseInputItem> = input.getRequired("input")
+
+    /**
+     * The ID of the response that rejected the input.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun responseId(): String = responseId.getRequired("response_id")
+
+    /**
+     * The sequence number for this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The event discriminator. Always `response.inject.failed`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.inject.failed")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The multiplexed WebSocket stream that emitted the event. This field is present only when
+     * WebSocket multiplexing is enabled separately.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun streamId(): Optional<String> = streamId.getOptional("stream_id")
+
+    /**
+     * Returns the raw JSON value of [error].
+     *
+     * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<Error> = error
+
+    /**
+     * Returns the raw JSON value of [input].
+     *
+     * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("input")
+    @ExcludeMissing
+    fun _input(): JsonField<List<BetaResponseInputItem>> = input
+
+    /**
+     * Returns the raw JSON value of [responseId].
+     *
+     * Unlike [responseId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("response_id") @ExcludeMissing fun _responseId(): JsonField<String> = responseId
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [streamId].
+     *
+     * Unlike [streamId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("stream_id") @ExcludeMissing fun _streamId(): JsonField<String> = streamId
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseInjectFailedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .error()
+         * .input()
+         * .responseId()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseInjectFailedEvent]. */
+    class Builder internal constructor() {
+
+        private var error: JsonField<Error>? = null
+        private var input: JsonField<MutableList<BetaResponseInputItem>>? = null
+        private var responseId: JsonField<String>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.inject.failed")
+        private var streamId: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseInjectFailedEvent: BetaResponseInjectFailedEvent) = apply {
+            error = betaResponseInjectFailedEvent.error
+            input = betaResponseInjectFailedEvent.input.map { it.toMutableList() }
+            responseId = betaResponseInjectFailedEvent.responseId
+            sequenceNumber = betaResponseInjectFailedEvent.sequenceNumber
+            type = betaResponseInjectFailedEvent.type
+            streamId = betaResponseInjectFailedEvent.streamId
+            additionalProperties = betaResponseInjectFailedEvent.additionalProperties.toMutableMap()
+        }
+
+        /** Information about why the input was not committed. */
+        fun error(error: Error) = error(JsonField.of(error))
+
+        /**
+         * Sets [Builder.error] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.error] with a well-typed [Error] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun error(error: JsonField<Error>) = apply { this.error = error }
+
+        /** The raw input items that were not committed. */
+        fun input(input: List<BetaResponseInputItem>) = input(JsonField.of(input))
+
+        /**
+         * Sets [Builder.input] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.input] with a well-typed `List<BetaResponseInputItem>`
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun input(input: JsonField<List<BetaResponseInputItem>>) = apply {
+            this.input = input.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [BetaResponseInputItem] to [Builder.input].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addInput(input: BetaResponseInputItem) = apply {
+            this.input =
+                (this.input ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("input", it).add(input)
+                }
+        }
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofBetaEasyInputMessage(betaEasyInputMessage)`.
+         */
+        fun addInput(betaEasyInputMessage: BetaEasyInputMessage) =
+            addInput(BetaResponseInputItem.ofBetaEasyInputMessage(betaEasyInputMessage))
+
+        /** Alias for calling [addInput] with `BetaResponseInputItem.ofMessage(message)`. */
+        fun addInput(message: BetaResponseInputItem.Message) =
+            addInput(BetaResponseInputItem.ofMessage(message))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofBetaResponseOutputMessage(betaResponseOutputMessage)`.
+         */
+        fun addInput(betaResponseOutputMessage: BetaResponseOutputMessage) =
+            addInput(BetaResponseInputItem.ofBetaResponseOutputMessage(betaResponseOutputMessage))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofFileSearchCall(fileSearchCall)`.
+         */
+        fun addInput(fileSearchCall: BetaResponseFileSearchToolCall) =
+            addInput(BetaResponseInputItem.ofFileSearchCall(fileSearchCall))
+
+        /**
+         * Alias for calling [addInput] with `BetaResponseInputItem.ofComputerCall(computerCall)`.
+         */
+        fun addInput(computerCall: BetaResponseComputerToolCall) =
+            addInput(BetaResponseInputItem.ofComputerCall(computerCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofComputerCallOutput(computerCallOutput)`.
+         */
+        fun addInput(computerCallOutput: BetaResponseInputItem.ComputerCallOutput) =
+            addInput(BetaResponseInputItem.ofComputerCallOutput(computerCallOutput))
+
+        /**
+         * Alias for calling [addInput] with `BetaResponseInputItem.ofWebSearchCall(webSearchCall)`.
+         */
+        fun addInput(webSearchCall: BetaResponseFunctionWebSearch) =
+            addInput(BetaResponseInputItem.ofWebSearchCall(webSearchCall))
+
+        /**
+         * Alias for calling [addInput] with `BetaResponseInputItem.ofFunctionCall(functionCall)`.
+         */
+        fun addInput(functionCall: BetaResponseFunctionToolCall) =
+            addInput(BetaResponseInputItem.ofFunctionCall(functionCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofFunctionCallOutput(functionCallOutput)`.
+         */
+        fun addInput(functionCallOutput: BetaResponseInputItem.FunctionCallOutput) =
+            addInput(BetaResponseInputItem.ofFunctionCallOutput(functionCallOutput))
+
+        /**
+         * Alias for calling [addInput] with `BetaResponseInputItem.ofAgentMessage(agentMessage)`.
+         */
+        fun addInput(agentMessage: BetaResponseInputItem.AgentMessage) =
+            addInput(BetaResponseInputItem.ofAgentMessage(agentMessage))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofMultiAgentCall(multiAgentCall)`.
+         */
+        fun addInput(multiAgentCall: BetaResponseInputItem.MultiAgentCall) =
+            addInput(BetaResponseInputItem.ofMultiAgentCall(multiAgentCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofMultiAgentCallOutput(multiAgentCallOutput)`.
+         */
+        fun addInput(multiAgentCallOutput: BetaResponseInputItem.MultiAgentCallOutput) =
+            addInput(BetaResponseInputItem.ofMultiAgentCallOutput(multiAgentCallOutput))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofToolSearchCall(toolSearchCall)`.
+         */
+        fun addInput(toolSearchCall: BetaResponseInputItem.ToolSearchCall) =
+            addInput(BetaResponseInputItem.ofToolSearchCall(toolSearchCall))
+
+        /**
+         * Alias for calling [addInput] with the following:
+         * ```java
+         * BetaResponseInputItem.ToolSearchCall.builder()
+         *     .arguments(arguments)
+         *     .build()
+         * ```
+         */
+        fun addToolSearchCallInput(arguments: JsonValue) =
+            addInput(BetaResponseInputItem.ToolSearchCall.builder().arguments(arguments).build())
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofToolSearchOutput(toolSearchOutput)`.
+         */
+        fun addInput(toolSearchOutput: BetaResponseToolSearchOutputItemParam) =
+            addInput(BetaResponseInputItem.ofToolSearchOutput(toolSearchOutput))
+
+        /**
+         * Alias for calling [addInput] with the following:
+         * ```java
+         * BetaResponseToolSearchOutputItemParam.builder()
+         *     .tools(tools)
+         *     .build()
+         * ```
+         */
+        fun addToolSearchOutputInput(tools: List<BetaTool>) =
+            addInput(BetaResponseToolSearchOutputItemParam.builder().tools(tools).build())
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofAdditionalTools(additionalTools)`.
+         */
+        fun addInput(additionalTools: BetaResponseInputItem.AdditionalTools) =
+            addInput(BetaResponseInputItem.ofAdditionalTools(additionalTools))
+
+        /**
+         * Alias for calling [addInput] with the following:
+         * ```java
+         * BetaResponseInputItem.AdditionalTools.builder()
+         *     .tools(tools)
+         *     .build()
+         * ```
+         */
+        fun addAdditionalToolsInput(tools: List<BetaTool>) =
+            addInput(BetaResponseInputItem.AdditionalTools.builder().tools(tools).build())
+
+        /** Alias for calling [addInput] with `BetaResponseInputItem.ofReasoning(reasoning)`. */
+        fun addInput(reasoning: BetaResponseReasoningItem) =
+            addInput(BetaResponseInputItem.ofReasoning(reasoning))
+
+        /** Alias for calling [addInput] with `BetaResponseInputItem.ofCompaction(compaction)`. */
+        fun addInput(compaction: BetaResponseCompactionItemParam) =
+            addInput(BetaResponseInputItem.ofCompaction(compaction))
+
+        /**
+         * Alias for calling [addInput] with the following:
+         * ```java
+         * BetaResponseCompactionItemParam.builder()
+         *     .encryptedContent(encryptedContent)
+         *     .build()
+         * ```
+         */
+        fun addCompactionInput(encryptedContent: String) =
+            addInput(
+                BetaResponseCompactionItemParam.builder().encryptedContent(encryptedContent).build()
+            )
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofImageGenerationCall(imageGenerationCall)`.
+         */
+        fun addInput(imageGenerationCall: BetaResponseInputItem.ImageGenerationCall) =
+            addInput(BetaResponseInputItem.ofImageGenerationCall(imageGenerationCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofCodeInterpreterCall(codeInterpreterCall)`.
+         */
+        fun addInput(codeInterpreterCall: BetaResponseCodeInterpreterToolCall) =
+            addInput(BetaResponseInputItem.ofCodeInterpreterCall(codeInterpreterCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofLocalShellCall(localShellCall)`.
+         */
+        fun addInput(localShellCall: BetaResponseInputItem.LocalShellCall) =
+            addInput(BetaResponseInputItem.ofLocalShellCall(localShellCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofLocalShellCallOutput(localShellCallOutput)`.
+         */
+        fun addInput(localShellCallOutput: BetaResponseInputItem.LocalShellCallOutput) =
+            addInput(BetaResponseInputItem.ofLocalShellCallOutput(localShellCallOutput))
+
+        /** Alias for calling [addInput] with `BetaResponseInputItem.ofShellCall(shellCall)`. */
+        fun addInput(shellCall: BetaResponseInputItem.ShellCall) =
+            addInput(BetaResponseInputItem.ofShellCall(shellCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofShellCallOutput(shellCallOutput)`.
+         */
+        fun addInput(shellCallOutput: BetaResponseInputItem.ShellCallOutput) =
+            addInput(BetaResponseInputItem.ofShellCallOutput(shellCallOutput))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofApplyPatchCall(applyPatchCall)`.
+         */
+        fun addInput(applyPatchCall: BetaResponseInputItem.ApplyPatchCall) =
+            addInput(BetaResponseInputItem.ofApplyPatchCall(applyPatchCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofApplyPatchCallOutput(applyPatchCallOutput)`.
+         */
+        fun addInput(applyPatchCallOutput: BetaResponseInputItem.ApplyPatchCallOutput) =
+            addInput(BetaResponseInputItem.ofApplyPatchCallOutput(applyPatchCallOutput))
+
+        /**
+         * Alias for calling [addInput] with `BetaResponseInputItem.ofMcpListTools(mcpListTools)`.
+         */
+        fun addInput(mcpListTools: BetaResponseInputItem.McpListTools) =
+            addInput(BetaResponseInputItem.ofMcpListTools(mcpListTools))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofMcpApprovalRequest(mcpApprovalRequest)`.
+         */
+        fun addInput(mcpApprovalRequest: BetaResponseInputItem.McpApprovalRequest) =
+            addInput(BetaResponseInputItem.ofMcpApprovalRequest(mcpApprovalRequest))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofMcpApprovalResponse(mcpApprovalResponse)`.
+         */
+        fun addInput(mcpApprovalResponse: BetaResponseInputItem.McpApprovalResponse) =
+            addInput(BetaResponseInputItem.ofMcpApprovalResponse(mcpApprovalResponse))
+
+        /** Alias for calling [addInput] with `BetaResponseInputItem.ofMcpCall(mcpCall)`. */
+        fun addInput(mcpCall: BetaResponseInputItem.McpCall) =
+            addInput(BetaResponseInputItem.ofMcpCall(mcpCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofCustomToolCallOutput(customToolCallOutput)`.
+         */
+        fun addInput(customToolCallOutput: BetaResponseCustomToolCallOutput) =
+            addInput(BetaResponseInputItem.ofCustomToolCallOutput(customToolCallOutput))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofCustomToolCall(customToolCall)`.
+         */
+        fun addInput(customToolCall: BetaResponseCustomToolCall) =
+            addInput(BetaResponseInputItem.ofCustomToolCall(customToolCall))
+
+        /**
+         * Alias for calling [addInput] with
+         * `BetaResponseInputItem.ofCompactionTrigger(compactionTrigger)`.
+         */
+        fun addInput(compactionTrigger: BetaResponseInputItem.CompactionTrigger) =
+            addInput(BetaResponseInputItem.ofCompactionTrigger(compactionTrigger))
+
+        /**
+         * Alias for calling [addInput] with `BetaResponseInputItem.ofItemReference(itemReference)`.
+         */
+        fun addInput(itemReference: BetaResponseInputItem.ItemReference) =
+            addInput(BetaResponseInputItem.ofItemReference(itemReference))
+
+        /**
+         * Alias for calling [addInput] with the following:
+         * ```java
+         * BetaResponseInputItem.ItemReference.builder()
+         *     .type(BetaResponseInputItem.ItemReference.Type.ITEM_REFERENCE)
+         *     .id(id)
+         *     .build()
+         * ```
+         */
+        fun addItemReferenceInput(id: String) =
+            addInput(
+                BetaResponseInputItem.ItemReference.builder()
+                    .type(BetaResponseInputItem.ItemReference.Type.ITEM_REFERENCE)
+                    .id(id)
+                    .build()
+            )
+
+        /** Alias for calling [addInput] with `BetaResponseInputItem.ofProgram(program)`. */
+        fun addInput(program: BetaResponseInputItem.Program) =
+            addInput(BetaResponseInputItem.ofProgram(program))
+
+        /**
+         * Alias for calling [addInput] with `BetaResponseInputItem.ofProgramOutput(programOutput)`.
+         */
+        fun addInput(programOutput: BetaResponseInputItem.ProgramOutput) =
+            addInput(BetaResponseInputItem.ofProgramOutput(programOutput))
+
+        /** The ID of the response that rejected the input. */
+        fun responseId(responseId: String) = responseId(JsonField.of(responseId))
+
+        /**
+         * Sets [Builder.responseId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.responseId] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun responseId(responseId: JsonField<String>) = apply { this.responseId = responseId }
+
+        /** The sequence number for this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.inject.failed")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /**
+         * The multiplexed WebSocket stream that emitted the event. This field is present only when
+         * WebSocket multiplexing is enabled separately.
+         */
+        fun streamId(streamId: String) = streamId(JsonField.of(streamId))
+
+        /**
+         * Sets [Builder.streamId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.streamId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun streamId(streamId: JsonField<String>) = apply { this.streamId = streamId }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseInjectFailedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .error()
+         * .input()
+         * .responseId()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseInjectFailedEvent =
+            BetaResponseInjectFailedEvent(
+                checkRequired("error", error),
+                checkRequired("input", input).map { it.toImmutable() },
+                checkRequired("responseId", responseId),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                streamId,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseInjectFailedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        error().validate()
+        input().forEach { it.validate() }
+        responseId()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.inject.failed")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        streamId()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (error.asKnown().getOrNull()?.validity() ?: 0) +
+            (input.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (if (responseId.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.inject.failed")) 1 else 0 } +
+            (if (streamId.asKnown().isPresent) 1 else 0)
+
+    /** Information about why the input was not committed. */
+    class Error
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val code: JsonField<Code>,
+        private val message: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("code") @ExcludeMissing code: JsonField<Code> = JsonMissing.of(),
+            @JsonProperty("message") @ExcludeMissing message: JsonField<String> = JsonMissing.of(),
+        ) : this(code, message, mutableMapOf())
+
+        /**
+         * A machine-readable error code.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun code(): Code = code.getRequired("code")
+
+        /**
+         * A human-readable description of the error.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun message(): String = message.getRequired("message")
+
+        /**
+         * Returns the raw JSON value of [code].
+         *
+         * Unlike [code], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<Code> = code
+
+        /**
+         * Returns the raw JSON value of [message].
+         *
+         * Unlike [message], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("message") @ExcludeMissing fun _message(): JsonField<String> = message
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Error].
+             *
+             * The following fields are required:
+             * ```java
+             * .code()
+             * .message()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Error]. */
+        class Builder internal constructor() {
+
+            private var code: JsonField<Code>? = null
+            private var message: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(error: Error) = apply {
+                code = error.code
+                message = error.message
+                additionalProperties = error.additionalProperties.toMutableMap()
+            }
+
+            /** A machine-readable error code. */
+            fun code(code: Code) = code(JsonField.of(code))
+
+            /**
+             * Sets [Builder.code] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.code] with a well-typed [Code] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun code(code: JsonField<Code>) = apply { this.code = code }
+
+            /** A human-readable description of the error. */
+            fun message(message: String) = message(JsonField.of(message))
+
+            /**
+             * Sets [Builder.message] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.message] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun message(message: JsonField<String>) = apply { this.message = message }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Error].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .code()
+             * .message()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Error =
+                Error(
+                    checkRequired("code", code),
+                    checkRequired("message", message),
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Error = apply {
+            if (validated) {
+                return@apply
+            }
+
+            code().validate()
+            message()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (code.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (message.asKnown().isPresent) 1 else 0)
+
+        /** A machine-readable error code. */
+        class Code @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val RESPONSE_ALREADY_COMPLETED = of("response_already_completed")
+
+                @JvmField val RESPONSE_NOT_FOUND = of("response_not_found")
+
+                @JvmStatic fun of(value: String) = Code(JsonField.of(value))
+            }
+
+            /** An enum containing [Code]'s known values. */
+            enum class Known {
+                RESPONSE_ALREADY_COMPLETED,
+                RESPONSE_NOT_FOUND,
+            }
+
+            /**
+             * An enum containing [Code]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Code] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                RESPONSE_ALREADY_COMPLETED,
+                RESPONSE_NOT_FOUND,
+                /** An enum member indicating that [Code] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    RESPONSE_ALREADY_COMPLETED -> Value.RESPONSE_ALREADY_COMPLETED
+                    RESPONSE_NOT_FOUND -> Value.RESPONSE_NOT_FOUND
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    RESPONSE_ALREADY_COMPLETED -> Known.RESPONSE_ALREADY_COMPLETED
+                    RESPONSE_NOT_FOUND -> Known.RESPONSE_NOT_FOUND
+                    else -> throw OpenAIInvalidDataException("Unknown Code: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Code = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Code && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Error &&
+                code == other.code &&
+                message == other.message &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(code, message, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Error{code=$code, message=$message, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseInjectFailedEvent &&
+            error == other.error &&
+            input == other.input &&
+            responseId == other.responseId &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            streamId == other.streamId &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(error, input, responseId, sequenceNumber, type, streamId, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseInjectFailedEvent{error=$error, input=$input, responseId=$responseId, sequenceNumber=$sequenceNumber, type=$type, streamId=$streamId, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputAudio.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputAudio.kt
new file mode 100644
index 000000000..b0463cf63
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputAudio.kt
@@ -0,0 +1,574 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import kotlin.jvm.optionals.getOrNull
+
+/** An audio input to the model. */
+class BetaResponseInputAudio
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val inputAudio: JsonField<InputAudio>,
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("input_audio")
+        @ExcludeMissing
+        inputAudio: JsonField<InputAudio> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+    ) : this(inputAudio, type, mutableMapOf())
+
+    /**
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun inputAudio(): InputAudio = inputAudio.getRequired("input_audio")
+
+    /**
+     * The type of the input item. Always `input_audio`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("input_audio")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Returns the raw JSON value of [inputAudio].
+     *
+     * Unlike [inputAudio], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("input_audio")
+    @ExcludeMissing
+    fun _inputAudio(): JsonField<InputAudio> = inputAudio
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseInputAudio].
+         *
+         * The following fields are required:
+         * ```java
+         * .inputAudio()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseInputAudio]. */
+    class Builder internal constructor() {
+
+        private var inputAudio: JsonField<InputAudio>? = null
+        private var type: JsonValue = JsonValue.from("input_audio")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseInputAudio: BetaResponseInputAudio) = apply {
+            inputAudio = betaResponseInputAudio.inputAudio
+            type = betaResponseInputAudio.type
+            additionalProperties = betaResponseInputAudio.additionalProperties.toMutableMap()
+        }
+
+        fun inputAudio(inputAudio: InputAudio) = inputAudio(JsonField.of(inputAudio))
+
+        /**
+         * Sets [Builder.inputAudio] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.inputAudio] with a well-typed [InputAudio] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun inputAudio(inputAudio: JsonField<InputAudio>) = apply { this.inputAudio = inputAudio }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("input_audio")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseInputAudio].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .inputAudio()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseInputAudio =
+            BetaResponseInputAudio(
+                checkRequired("inputAudio", inputAudio),
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseInputAudio = apply {
+        if (validated) {
+            return@apply
+        }
+
+        inputAudio().validate()
+        _type().let {
+            if (it != JsonValue.from("input_audio")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (inputAudio.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("input_audio")) 1 else 0 }
+
+    class InputAudio
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val data: JsonField<String>,
+        private val format: JsonField<Format>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("data") @ExcludeMissing data: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("format") @ExcludeMissing format: JsonField<Format> = JsonMissing.of(),
+        ) : this(data, format, mutableMapOf())
+
+        /**
+         * Base64-encoded audio data.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun data(): String = data.getRequired("data")
+
+        /**
+         * The format of the audio data. Currently supported formats are `mp3` and `wav`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun format(): Format = format.getRequired("format")
+
+        /**
+         * Returns the raw JSON value of [data].
+         *
+         * Unlike [data], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("data") @ExcludeMissing fun _data(): JsonField<String> = data
+
+        /**
+         * Returns the raw JSON value of [format].
+         *
+         * Unlike [format], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("format") @ExcludeMissing fun _format(): JsonField<Format> = format
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [InputAudio].
+             *
+             * The following fields are required:
+             * ```java
+             * .data()
+             * .format()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [InputAudio]. */
+        class Builder internal constructor() {
+
+            private var data: JsonField<String>? = null
+            private var format: JsonField<Format>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(inputAudio: InputAudio) = apply {
+                data = inputAudio.data
+                format = inputAudio.format
+                additionalProperties = inputAudio.additionalProperties.toMutableMap()
+            }
+
+            /** Base64-encoded audio data. */
+            fun data(data: String) = data(JsonField.of(data))
+
+            /**
+             * Sets [Builder.data] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.data] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun data(data: JsonField<String>) = apply { this.data = data }
+
+            /** The format of the audio data. Currently supported formats are `mp3` and `wav`. */
+            fun format(format: Format) = format(JsonField.of(format))
+
+            /**
+             * Sets [Builder.format] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.format] with a well-typed [Format] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun format(format: JsonField<Format>) = apply { this.format = format }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [InputAudio].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .data()
+             * .format()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): InputAudio =
+                InputAudio(
+                    checkRequired("data", data),
+                    checkRequired("format", format),
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): InputAudio = apply {
+            if (validated) {
+                return@apply
+            }
+
+            data()
+            format().validate()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (data.asKnown().isPresent) 1 else 0) +
+                (format.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The format of the audio data. Currently supported formats are `mp3` and `wav`. */
+        class Format @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val MP3 = of("mp3")
+
+                @JvmField val WAV = of("wav")
+
+                @JvmStatic fun of(value: String) = Format(JsonField.of(value))
+            }
+
+            /** An enum containing [Format]'s known values. */
+            enum class Known {
+                MP3,
+                WAV,
+            }
+
+            /**
+             * An enum containing [Format]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Format] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                MP3,
+                WAV,
+                /**
+                 * An enum member indicating that [Format] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    MP3 -> Value.MP3
+                    WAV -> Value.WAV
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    MP3 -> Known.MP3
+                    WAV -> Known.WAV
+                    else -> throw OpenAIInvalidDataException("Unknown Format: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Format = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Format && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is InputAudio &&
+                data == other.data &&
+                format == other.format &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(data, format, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "InputAudio{data=$data, format=$format, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseInputAudio &&
+            inputAudio == other.inputAudio &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(inputAudio, type, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseInputAudio{inputAudio=$inputAudio, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputContent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputContent.kt
new file mode 100644
index 000000000..4f33fdc78
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputContent.kt
@@ -0,0 +1,284 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.JsonValue
+import com.openai.core.getOrThrow
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** A text input to the model. */
+@JsonDeserialize(using = BetaResponseInputContent.Deserializer::class)
+@JsonSerialize(using = BetaResponseInputContent.Serializer::class)
+class BetaResponseInputContent
+private constructor(
+    private val inputText: BetaResponseInputText? = null,
+    private val inputImage: BetaResponseInputImage? = null,
+    private val inputFile: BetaResponseInputFile? = null,
+    private val _json: JsonValue? = null,
+) {
+
+    /** A text input to the model. */
+    fun inputText(): Optional<BetaResponseInputText> = Optional.ofNullable(inputText)
+
+    /**
+     * An image input to the model. Learn about
+     * [image inputs](https://platform.openai.com/docs/guides/vision).
+     */
+    fun inputImage(): Optional<BetaResponseInputImage> = Optional.ofNullable(inputImage)
+
+    /** A file input to the model. */
+    fun inputFile(): Optional<BetaResponseInputFile> = Optional.ofNullable(inputFile)
+
+    fun isInputText(): Boolean = inputText != null
+
+    fun isInputImage(): Boolean = inputImage != null
+
+    fun isInputFile(): Boolean = inputFile != null
+
+    /** A text input to the model. */
+    fun asInputText(): BetaResponseInputText = inputText.getOrThrow("inputText")
+
+    /**
+     * An image input to the model. Learn about
+     * [image inputs](https://platform.openai.com/docs/guides/vision).
+     */
+    fun asInputImage(): BetaResponseInputImage = inputImage.getOrThrow("inputImage")
+
+    /** A file input to the model. */
+    fun asInputFile(): BetaResponseInputFile = inputFile.getOrThrow("inputFile")
+
+    fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+    /**
+     * Maps this instance's current variant to a value of type [T] using the given [visitor].
+     *
+     * Note that this method is _not_ forwards compatible with new variants from the API, unless
+     * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of the
+     * SDK gracefully, consider overriding [Visitor.unknown]:
+     * ```java
+     * import com.openai.core.JsonValue;
+     * import java.util.Optional;
+     *
+     * Optional<String> result = betaResponseInputContent.accept(new BetaResponseInputContent.Visitor<Optional<String>>() {
+     *     @Override
+     *     public Optional<String> visitInputText(BetaResponseInputText inputText) {
+     *         return Optional.of(inputText.toString());
+     *     }
+     *
+     *     // ...
+     *
+     *     @Override
+     *     public Optional<String> unknown(JsonValue json) {
+     *         // Or inspect the `json`.
+     *         return Optional.empty();
+     *     }
+     * });
+     * ```
+     *
+     * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor] and
+     *   the current variant is unknown.
+     */
+    fun <T> accept(visitor: Visitor<T>): T =
+        when {
+            inputText != null -> visitor.visitInputText(inputText)
+            inputImage != null -> visitor.visitInputImage(inputImage)
+            inputFile != null -> visitor.visitInputFile(inputFile)
+            else -> visitor.unknown(_json)
+        }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseInputContent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        accept(
+            object : Visitor<Unit> {
+                override fun visitInputText(inputText: BetaResponseInputText) {
+                    inputText.validate()
+                }
+
+                override fun visitInputImage(inputImage: BetaResponseInputImage) {
+                    inputImage.validate()
+                }
+
+                override fun visitInputFile(inputFile: BetaResponseInputFile) {
+                    inputFile.validate()
+                }
+            }
+        )
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        accept(
+            object : Visitor<Int> {
+                override fun visitInputText(inputText: BetaResponseInputText) = inputText.validity()
+
+                override fun visitInputImage(inputImage: BetaResponseInputImage) =
+                    inputImage.validity()
+
+                override fun visitInputFile(inputFile: BetaResponseInputFile) = inputFile.validity()
+
+                override fun unknown(json: JsonValue?) = 0
+            }
+        )
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseInputContent &&
+            inputText == other.inputText &&
+            inputImage == other.inputImage &&
+            inputFile == other.inputFile
+    }
+
+    override fun hashCode(): Int = Objects.hash(inputText, inputImage, inputFile)
+
+    override fun toString(): String =
+        when {
+            inputText != null -> "BetaResponseInputContent{inputText=$inputText}"
+            inputImage != null -> "BetaResponseInputContent{inputImage=$inputImage}"
+            inputFile != null -> "BetaResponseInputContent{inputFile=$inputFile}"
+            _json != null -> "BetaResponseInputContent{_unknown=$_json}"
+            else -> throw IllegalStateException("Invalid BetaResponseInputContent")
+        }
+
+    companion object {
+
+        /** A text input to the model. */
+        @JvmStatic
+        fun ofInputText(inputText: BetaResponseInputText) =
+            BetaResponseInputContent(inputText = inputText)
+
+        /**
+         * An image input to the model. Learn about
+         * [image inputs](https://platform.openai.com/docs/guides/vision).
+         */
+        @JvmStatic
+        fun ofInputImage(inputImage: BetaResponseInputImage) =
+            BetaResponseInputContent(inputImage = inputImage)
+
+        /** A file input to the model. */
+        @JvmStatic
+        fun ofInputFile(inputFile: BetaResponseInputFile) =
+            BetaResponseInputContent(inputFile = inputFile)
+    }
+
+    /**
+     * An interface that defines how to map each variant of [BetaResponseInputContent] to a value of
+     * type [T].
+     */
+    interface Visitor<out T> {
+
+        /** A text input to the model. */
+        fun visitInputText(inputText: BetaResponseInputText): T
+
+        /**
+         * An image input to the model. Learn about
+         * [image inputs](https://platform.openai.com/docs/guides/vision).
+         */
+        fun visitInputImage(inputImage: BetaResponseInputImage): T
+
+        /** A file input to the model. */
+        fun visitInputFile(inputFile: BetaResponseInputFile): T
+
+        /**
+         * Maps an unknown variant of [BetaResponseInputContent] to a value of type [T].
+         *
+         * An instance of [BetaResponseInputContent] can contain an unknown variant if it was
+         * deserialized from data that doesn't match any known variant. For example, if the SDK is
+         * on an older version than the API, then the API may respond with new variants that the SDK
+         * is unaware of.
+         *
+         * @throws OpenAIInvalidDataException in the default implementation.
+         */
+        fun unknown(json: JsonValue?): T {
+            throw OpenAIInvalidDataException("Unknown BetaResponseInputContent: $json")
+        }
+    }
+
+    internal class Deserializer :
+        BaseDeserializer<BetaResponseInputContent>(BetaResponseInputContent::class) {
+
+        override fun ObjectCodec.deserialize(node: JsonNode): BetaResponseInputContent {
+            val json = JsonValue.fromJsonNode(node)
+            val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+            when (type) {
+                "input_text" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseInputText>())?.let {
+                        BetaResponseInputContent(inputText = it, _json = json)
+                    } ?: BetaResponseInputContent(_json = json)
+                }
+                "input_image" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseInputImage>())?.let {
+                        BetaResponseInputContent(inputImage = it, _json = json)
+                    } ?: BetaResponseInputContent(_json = json)
+                }
+                "input_file" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseInputFile>())?.let {
+                        BetaResponseInputContent(inputFile = it, _json = json)
+                    } ?: BetaResponseInputContent(_json = json)
+                }
+            }
+
+            return BetaResponseInputContent(_json = json)
+        }
+    }
+
+    internal class Serializer :
+        BaseSerializer<BetaResponseInputContent>(BetaResponseInputContent::class) {
+
+        override fun serialize(
+            value: BetaResponseInputContent,
+            generator: JsonGenerator,
+            provider: SerializerProvider,
+        ) {
+            when {
+                value.inputText != null -> generator.writeObject(value.inputText)
+                value.inputImage != null -> generator.writeObject(value.inputImage)
+                value.inputFile != null -> generator.writeObject(value.inputFile)
+                value._json != null -> generator.writeObject(value._json)
+                else -> throw IllegalStateException("Invalid BetaResponseInputContent")
+            }
+        }
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputFile.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputFile.kt
new file mode 100644
index 000000000..c4aad671e
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputFile.kt
@@ -0,0 +1,734 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** A file input to the model. */
+class BetaResponseInputFile
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonValue,
+    private val detail: JsonField<Detail>,
+    private val fileData: JsonField<String>,
+    private val fileId: JsonField<String>,
+    private val fileUrl: JsonField<String>,
+    private val filename: JsonField<String>,
+    private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("detail") @ExcludeMissing detail: JsonField<Detail> = JsonMissing.of(),
+        @JsonProperty("file_data") @ExcludeMissing fileData: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("file_id") @ExcludeMissing fileId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("file_url") @ExcludeMissing fileUrl: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("filename") @ExcludeMissing filename: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+    ) : this(
+        type,
+        detail,
+        fileData,
+        fileId,
+        fileUrl,
+        filename,
+        promptCacheBreakpoint,
+        mutableMapOf(),
+    )
+
+    /**
+     * The type of the input item. Always `input_file`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("input_file")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The detail level of the file to be sent to the model. Use `auto` to let the system select the
+     * detail level; for GPT-5.6 and later models, `auto` uses high-quality rendering, which may
+     * increase input token usage. Use `low` for lower-cost rendering, or `high` to render the file
+     * at higher quality. Defaults to `auto`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun detail(): Optional<Detail> = detail.getOptional("detail")
+
+    /**
+     * The content of the file to be sent to the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun fileData(): Optional<String> = fileData.getOptional("file_data")
+
+    /**
+     * The ID of the file to be sent to the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun fileId(): Optional<String> = fileId.getOptional("file_id")
+
+    /**
+     * The URL of the file to be sent to the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun fileUrl(): Optional<String> = fileUrl.getOptional("file_url")
+
+    /**
+     * The name of the file to be sent to the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun filename(): Optional<String> = filename.getOptional("filename")
+
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+        promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
+    /**
+     * Returns the raw JSON value of [detail].
+     *
+     * Unlike [detail], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("detail") @ExcludeMissing fun _detail(): JsonField<Detail> = detail
+
+    /**
+     * Returns the raw JSON value of [fileData].
+     *
+     * Unlike [fileData], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("file_data") @ExcludeMissing fun _fileData(): JsonField<String> = fileData
+
+    /**
+     * Returns the raw JSON value of [fileId].
+     *
+     * Unlike [fileId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("file_id") @ExcludeMissing fun _fileId(): JsonField<String> = fileId
+
+    /**
+     * Returns the raw JSON value of [fileUrl].
+     *
+     * Unlike [fileUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("file_url") @ExcludeMissing fun _fileUrl(): JsonField<String> = fileUrl
+
+    /**
+     * Returns the raw JSON value of [filename].
+     *
+     * Unlike [filename], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("filename") @ExcludeMissing fun _filename(): JsonField<String> = filename
+
+    /**
+     * Returns the raw JSON value of [promptCacheBreakpoint].
+     *
+     * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_breakpoint")
+    @ExcludeMissing
+    fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [BetaResponseInputFile]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseInputFile]. */
+    class Builder internal constructor() {
+
+        private var type: JsonValue = JsonValue.from("input_file")
+        private var detail: JsonField<Detail> = JsonMissing.of()
+        private var fileData: JsonField<String> = JsonMissing.of()
+        private var fileId: JsonField<String> = JsonMissing.of()
+        private var fileUrl: JsonField<String> = JsonMissing.of()
+        private var filename: JsonField<String> = JsonMissing.of()
+        private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseInputFile: BetaResponseInputFile) = apply {
+            type = betaResponseInputFile.type
+            detail = betaResponseInputFile.detail
+            fileData = betaResponseInputFile.fileData
+            fileId = betaResponseInputFile.fileId
+            fileUrl = betaResponseInputFile.fileUrl
+            filename = betaResponseInputFile.filename
+            promptCacheBreakpoint = betaResponseInputFile.promptCacheBreakpoint
+            additionalProperties = betaResponseInputFile.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("input_file")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /**
+         * The detail level of the file to be sent to the model. Use `auto` to let the system select
+         * the detail level; for GPT-5.6 and later models, `auto` uses high-quality rendering, which
+         * may increase input token usage. Use `low` for lower-cost rendering, or `high` to render
+         * the file at higher quality. Defaults to `auto`.
+         */
+        fun detail(detail: Detail) = detail(JsonField.of(detail))
+
+        /**
+         * Sets [Builder.detail] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.detail] with a well-typed [Detail] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun detail(detail: JsonField<Detail>) = apply { this.detail = detail }
+
+        /** The content of the file to be sent to the model. */
+        fun fileData(fileData: String) = fileData(JsonField.of(fileData))
+
+        /**
+         * Sets [Builder.fileData] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.fileData] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun fileData(fileData: JsonField<String>) = apply { this.fileData = fileData }
+
+        /** The ID of the file to be sent to the model. */
+        fun fileId(fileId: String?) = fileId(JsonField.ofNullable(fileId))
+
+        /** Alias for calling [Builder.fileId] with `fileId.orElse(null)`. */
+        fun fileId(fileId: Optional<String>) = fileId(fileId.getOrNull())
+
+        /**
+         * Sets [Builder.fileId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.fileId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun fileId(fileId: JsonField<String>) = apply { this.fileId = fileId }
+
+        /** The URL of the file to be sent to the model. */
+        fun fileUrl(fileUrl: String) = fileUrl(JsonField.of(fileUrl))
+
+        /**
+         * Sets [Builder.fileUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.fileUrl] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun fileUrl(fileUrl: JsonField<String>) = apply { this.fileUrl = fileUrl }
+
+        /** The name of the file to be sent to the model. */
+        fun filename(filename: String) = filename(JsonField.of(filename))
+
+        /**
+         * Sets [Builder.filename] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.filename] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun filename(filename: JsonField<String>) = apply { this.filename = filename }
+
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint) =
+            promptCacheBreakpoint(JsonField.of(promptCacheBreakpoint))
+
+        /**
+         * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+         * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) = apply {
+            this.promptCacheBreakpoint = promptCacheBreakpoint
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseInputFile].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): BetaResponseInputFile =
+            BetaResponseInputFile(
+                type,
+                detail,
+                fileData,
+                fileId,
+                fileUrl,
+                filename,
+                promptCacheBreakpoint,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseInputFile = apply {
+        if (validated) {
+            return@apply
+        }
+
+        _type().let {
+            if (it != JsonValue.from("input_file")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        detail().ifPresent { it.validate() }
+        fileData()
+        fileId()
+        fileUrl()
+        filename()
+        promptCacheBreakpoint().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        type.let { if (it == JsonValue.from("input_file")) 1 else 0 } +
+            (detail.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (fileData.asKnown().isPresent) 1 else 0) +
+            (if (fileId.asKnown().isPresent) 1 else 0) +
+            (if (fileUrl.asKnown().isPresent) 1 else 0) +
+            (if (filename.asKnown().isPresent) 1 else 0) +
+            (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * The detail level of the file to be sent to the model. Use `auto` to let the system select the
+     * detail level; for GPT-5.6 and later models, `auto` uses high-quality rendering, which may
+     * increase input token usage. Use `low` for lower-cost rendering, or `high` to render the file
+     * at higher quality. Defaults to `auto`.
+     */
+    class Detail @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val AUTO = of("auto")
+
+            @JvmField val LOW = of("low")
+
+            @JvmField val HIGH = of("high")
+
+            @JvmStatic fun of(value: String) = Detail(JsonField.of(value))
+        }
+
+        /** An enum containing [Detail]'s known values. */
+        enum class Known {
+            AUTO,
+            LOW,
+            HIGH,
+        }
+
+        /**
+         * An enum containing [Detail]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Detail] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            AUTO,
+            LOW,
+            HIGH,
+            /** An enum member indicating that [Detail] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                AUTO -> Value.AUTO
+                LOW -> Value.LOW
+                HIGH -> Value.HIGH
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                AUTO -> Known.AUTO
+                LOW -> Known.LOW
+                HIGH -> Known.HIGH
+                else -> throw OpenAIInvalidDataException("Unknown Detail: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Detail = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Detail && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     */
+    class PromptCacheBreakpoint
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+        ) : this(mode, mutableMapOf())
+
+        /**
+         * The breakpoint mode. Always `explicit`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("explicit")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheBreakpoint].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheBreakpoint]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonValue = JsonValue.from("explicit")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                mode = promptCacheBreakpoint.mode
+                additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheBreakpoint].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheBreakpoint =
+                PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheBreakpoint = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _mode().let {
+                if (it != JsonValue.from("explicit")) {
+                    throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheBreakpoint &&
+                mode == other.mode &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseInputFile &&
+            type == other.type &&
+            detail == other.detail &&
+            fileData == other.fileData &&
+            fileId == other.fileId &&
+            fileUrl == other.fileUrl &&
+            filename == other.filename &&
+            promptCacheBreakpoint == other.promptCacheBreakpoint &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            type,
+            detail,
+            fileData,
+            fileId,
+            fileUrl,
+            filename,
+            promptCacheBreakpoint,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseInputFile{type=$type, detail=$detail, fileData=$fileData, fileId=$fileId, fileUrl=$fileUrl, filename=$filename, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputFileContent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputFileContent.kt
new file mode 100644
index 000000000..e494c32a7
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputFileContent.kt
@@ -0,0 +1,752 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** A file input to the model. */
+class BetaResponseInputFileContent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonValue,
+    private val detail: JsonField<Detail>,
+    private val fileData: JsonField<String>,
+    private val fileId: JsonField<String>,
+    private val fileUrl: JsonField<String>,
+    private val filename: JsonField<String>,
+    private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("detail") @ExcludeMissing detail: JsonField<Detail> = JsonMissing.of(),
+        @JsonProperty("file_data") @ExcludeMissing fileData: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("file_id") @ExcludeMissing fileId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("file_url") @ExcludeMissing fileUrl: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("filename") @ExcludeMissing filename: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+    ) : this(
+        type,
+        detail,
+        fileData,
+        fileId,
+        fileUrl,
+        filename,
+        promptCacheBreakpoint,
+        mutableMapOf(),
+    )
+
+    /**
+     * The type of the input item. Always `input_file`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("input_file")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The detail level of the file to be sent to the model. Use `auto` to let the system select the
+     * detail level; for GPT-5.6 and later models, `auto` uses high-quality rendering, which may
+     * increase input token usage. Use `low` for lower-cost rendering, or `high` to render the file
+     * at higher quality. Defaults to `auto`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun detail(): Optional<Detail> = detail.getOptional("detail")
+
+    /**
+     * The base64-encoded data of the file to be sent to the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun fileData(): Optional<String> = fileData.getOptional("file_data")
+
+    /**
+     * The ID of the file to be sent to the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun fileId(): Optional<String> = fileId.getOptional("file_id")
+
+    /**
+     * The URL of the file to be sent to the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun fileUrl(): Optional<String> = fileUrl.getOptional("file_url")
+
+    /**
+     * The name of the file to be sent to the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun filename(): Optional<String> = filename.getOptional("filename")
+
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+        promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
+    /**
+     * Returns the raw JSON value of [detail].
+     *
+     * Unlike [detail], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("detail") @ExcludeMissing fun _detail(): JsonField<Detail> = detail
+
+    /**
+     * Returns the raw JSON value of [fileData].
+     *
+     * Unlike [fileData], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("file_data") @ExcludeMissing fun _fileData(): JsonField<String> = fileData
+
+    /**
+     * Returns the raw JSON value of [fileId].
+     *
+     * Unlike [fileId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("file_id") @ExcludeMissing fun _fileId(): JsonField<String> = fileId
+
+    /**
+     * Returns the raw JSON value of [fileUrl].
+     *
+     * Unlike [fileUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("file_url") @ExcludeMissing fun _fileUrl(): JsonField<String> = fileUrl
+
+    /**
+     * Returns the raw JSON value of [filename].
+     *
+     * Unlike [filename], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("filename") @ExcludeMissing fun _filename(): JsonField<String> = filename
+
+    /**
+     * Returns the raw JSON value of [promptCacheBreakpoint].
+     *
+     * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_breakpoint")
+    @ExcludeMissing
+    fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseInputFileContent].
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseInputFileContent]. */
+    class Builder internal constructor() {
+
+        private var type: JsonValue = JsonValue.from("input_file")
+        private var detail: JsonField<Detail> = JsonMissing.of()
+        private var fileData: JsonField<String> = JsonMissing.of()
+        private var fileId: JsonField<String> = JsonMissing.of()
+        private var fileUrl: JsonField<String> = JsonMissing.of()
+        private var filename: JsonField<String> = JsonMissing.of()
+        private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseInputFileContent: BetaResponseInputFileContent) = apply {
+            type = betaResponseInputFileContent.type
+            detail = betaResponseInputFileContent.detail
+            fileData = betaResponseInputFileContent.fileData
+            fileId = betaResponseInputFileContent.fileId
+            fileUrl = betaResponseInputFileContent.fileUrl
+            filename = betaResponseInputFileContent.filename
+            promptCacheBreakpoint = betaResponseInputFileContent.promptCacheBreakpoint
+            additionalProperties = betaResponseInputFileContent.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("input_file")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /**
+         * The detail level of the file to be sent to the model. Use `auto` to let the system select
+         * the detail level; for GPT-5.6 and later models, `auto` uses high-quality rendering, which
+         * may increase input token usage. Use `low` for lower-cost rendering, or `high` to render
+         * the file at higher quality. Defaults to `auto`.
+         */
+        fun detail(detail: Detail) = detail(JsonField.of(detail))
+
+        /**
+         * Sets [Builder.detail] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.detail] with a well-typed [Detail] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun detail(detail: JsonField<Detail>) = apply { this.detail = detail }
+
+        /** The base64-encoded data of the file to be sent to the model. */
+        fun fileData(fileData: String?) = fileData(JsonField.ofNullable(fileData))
+
+        /** Alias for calling [Builder.fileData] with `fileData.orElse(null)`. */
+        fun fileData(fileData: Optional<String>) = fileData(fileData.getOrNull())
+
+        /**
+         * Sets [Builder.fileData] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.fileData] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun fileData(fileData: JsonField<String>) = apply { this.fileData = fileData }
+
+        /** The ID of the file to be sent to the model. */
+        fun fileId(fileId: String?) = fileId(JsonField.ofNullable(fileId))
+
+        /** Alias for calling [Builder.fileId] with `fileId.orElse(null)`. */
+        fun fileId(fileId: Optional<String>) = fileId(fileId.getOrNull())
+
+        /**
+         * Sets [Builder.fileId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.fileId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun fileId(fileId: JsonField<String>) = apply { this.fileId = fileId }
+
+        /** The URL of the file to be sent to the model. */
+        fun fileUrl(fileUrl: String?) = fileUrl(JsonField.ofNullable(fileUrl))
+
+        /** Alias for calling [Builder.fileUrl] with `fileUrl.orElse(null)`. */
+        fun fileUrl(fileUrl: Optional<String>) = fileUrl(fileUrl.getOrNull())
+
+        /**
+         * Sets [Builder.fileUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.fileUrl] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun fileUrl(fileUrl: JsonField<String>) = apply { this.fileUrl = fileUrl }
+
+        /** The name of the file to be sent to the model. */
+        fun filename(filename: String?) = filename(JsonField.ofNullable(filename))
+
+        /** Alias for calling [Builder.filename] with `filename.orElse(null)`. */
+        fun filename(filename: Optional<String>) = filename(filename.getOrNull())
+
+        /**
+         * Sets [Builder.filename] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.filename] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun filename(filename: JsonField<String>) = apply { this.filename = filename }
+
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint?) =
+            promptCacheBreakpoint(JsonField.ofNullable(promptCacheBreakpoint))
+
+        /**
+         * Alias for calling [Builder.promptCacheBreakpoint] with
+         * `promptCacheBreakpoint.orElse(null)`.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: Optional<PromptCacheBreakpoint>) =
+            promptCacheBreakpoint(promptCacheBreakpoint.getOrNull())
+
+        /**
+         * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+         * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) = apply {
+            this.promptCacheBreakpoint = promptCacheBreakpoint
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseInputFileContent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): BetaResponseInputFileContent =
+            BetaResponseInputFileContent(
+                type,
+                detail,
+                fileData,
+                fileId,
+                fileUrl,
+                filename,
+                promptCacheBreakpoint,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseInputFileContent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        _type().let {
+            if (it != JsonValue.from("input_file")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        detail().ifPresent { it.validate() }
+        fileData()
+        fileId()
+        fileUrl()
+        filename()
+        promptCacheBreakpoint().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        type.let { if (it == JsonValue.from("input_file")) 1 else 0 } +
+            (detail.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (fileData.asKnown().isPresent) 1 else 0) +
+            (if (fileId.asKnown().isPresent) 1 else 0) +
+            (if (fileUrl.asKnown().isPresent) 1 else 0) +
+            (if (filename.asKnown().isPresent) 1 else 0) +
+            (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * The detail level of the file to be sent to the model. Use `auto` to let the system select the
+     * detail level; for GPT-5.6 and later models, `auto` uses high-quality rendering, which may
+     * increase input token usage. Use `low` for lower-cost rendering, or `high` to render the file
+     * at higher quality. Defaults to `auto`.
+     */
+    class Detail @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val AUTO = of("auto")
+
+            @JvmField val LOW = of("low")
+
+            @JvmField val HIGH = of("high")
+
+            @JvmStatic fun of(value: String) = Detail(JsonField.of(value))
+        }
+
+        /** An enum containing [Detail]'s known values. */
+        enum class Known {
+            AUTO,
+            LOW,
+            HIGH,
+        }
+
+        /**
+         * An enum containing [Detail]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Detail] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            AUTO,
+            LOW,
+            HIGH,
+            /** An enum member indicating that [Detail] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                AUTO -> Value.AUTO
+                LOW -> Value.LOW
+                HIGH -> Value.HIGH
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                AUTO -> Known.AUTO
+                LOW -> Known.LOW
+                HIGH -> Known.HIGH
+                else -> throw OpenAIInvalidDataException("Unknown Detail: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Detail = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Detail && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     */
+    class PromptCacheBreakpoint
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+        ) : this(mode, mutableMapOf())
+
+        /**
+         * The breakpoint mode. Always `explicit`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("explicit")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheBreakpoint].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheBreakpoint]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonValue = JsonValue.from("explicit")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                mode = promptCacheBreakpoint.mode
+                additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheBreakpoint].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheBreakpoint =
+                PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheBreakpoint = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _mode().let {
+                if (it != JsonValue.from("explicit")) {
+                    throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheBreakpoint &&
+                mode == other.mode &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseInputFileContent &&
+            type == other.type &&
+            detail == other.detail &&
+            fileData == other.fileData &&
+            fileId == other.fileId &&
+            fileUrl == other.fileUrl &&
+            filename == other.filename &&
+            promptCacheBreakpoint == other.promptCacheBreakpoint &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            type,
+            detail,
+            fileData,
+            fileId,
+            fileUrl,
+            filename,
+            promptCacheBreakpoint,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseInputFileContent{type=$type, detail=$detail, fileData=$fileData, fileId=$fileId, fileUrl=$fileUrl, filename=$filename, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputImage.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputImage.kt
new file mode 100644
index 000000000..2905a065e
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputImage.kt
@@ -0,0 +1,673 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * An image input to the model. Learn about
+ * [image inputs](https://platform.openai.com/docs/guides/vision).
+ */
+class BetaResponseInputImage
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val detail: JsonField<Detail>,
+    private val type: JsonValue,
+    private val fileId: JsonField<String>,
+    private val imageUrl: JsonField<String>,
+    private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("detail") @ExcludeMissing detail: JsonField<Detail> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("file_id") @ExcludeMissing fileId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("image_url") @ExcludeMissing imageUrl: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+    ) : this(detail, type, fileId, imageUrl, promptCacheBreakpoint, mutableMapOf())
+
+    /**
+     * The detail level of the image to be sent to the model. One of `high`, `low`, `auto`, or
+     * `original`. Defaults to `auto`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun detail(): Detail = detail.getRequired("detail")
+
+    /**
+     * The type of the input item. Always `input_image`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("input_image")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The ID of the file to be sent to the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun fileId(): Optional<String> = fileId.getOptional("file_id")
+
+    /**
+     * The URL of the image to be sent to the model. A fully qualified URL or base64 encoded image
+     * in a data URL.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun imageUrl(): Optional<String> = imageUrl.getOptional("image_url")
+
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+        promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
+    /**
+     * Returns the raw JSON value of [detail].
+     *
+     * Unlike [detail], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("detail") @ExcludeMissing fun _detail(): JsonField<Detail> = detail
+
+    /**
+     * Returns the raw JSON value of [fileId].
+     *
+     * Unlike [fileId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("file_id") @ExcludeMissing fun _fileId(): JsonField<String> = fileId
+
+    /**
+     * Returns the raw JSON value of [imageUrl].
+     *
+     * Unlike [imageUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("image_url") @ExcludeMissing fun _imageUrl(): JsonField<String> = imageUrl
+
+    /**
+     * Returns the raw JSON value of [promptCacheBreakpoint].
+     *
+     * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_breakpoint")
+    @ExcludeMissing
+    fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseInputImage].
+         *
+         * The following fields are required:
+         * ```java
+         * .detail()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseInputImage]. */
+    class Builder internal constructor() {
+
+        private var detail: JsonField<Detail>? = null
+        private var type: JsonValue = JsonValue.from("input_image")
+        private var fileId: JsonField<String> = JsonMissing.of()
+        private var imageUrl: JsonField<String> = JsonMissing.of()
+        private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseInputImage: BetaResponseInputImage) = apply {
+            detail = betaResponseInputImage.detail
+            type = betaResponseInputImage.type
+            fileId = betaResponseInputImage.fileId
+            imageUrl = betaResponseInputImage.imageUrl
+            promptCacheBreakpoint = betaResponseInputImage.promptCacheBreakpoint
+            additionalProperties = betaResponseInputImage.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * The detail level of the image to be sent to the model. One of `high`, `low`, `auto`, or
+         * `original`. Defaults to `auto`.
+         */
+        fun detail(detail: Detail) = detail(JsonField.of(detail))
+
+        /**
+         * Sets [Builder.detail] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.detail] with a well-typed [Detail] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun detail(detail: JsonField<Detail>) = apply { this.detail = detail }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("input_image")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The ID of the file to be sent to the model. */
+        fun fileId(fileId: String?) = fileId(JsonField.ofNullable(fileId))
+
+        /** Alias for calling [Builder.fileId] with `fileId.orElse(null)`. */
+        fun fileId(fileId: Optional<String>) = fileId(fileId.getOrNull())
+
+        /**
+         * Sets [Builder.fileId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.fileId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun fileId(fileId: JsonField<String>) = apply { this.fileId = fileId }
+
+        /**
+         * The URL of the image to be sent to the model. A fully qualified URL or base64 encoded
+         * image in a data URL.
+         */
+        fun imageUrl(imageUrl: String?) = imageUrl(JsonField.ofNullable(imageUrl))
+
+        /** Alias for calling [Builder.imageUrl] with `imageUrl.orElse(null)`. */
+        fun imageUrl(imageUrl: Optional<String>) = imageUrl(imageUrl.getOrNull())
+
+        /**
+         * Sets [Builder.imageUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.imageUrl] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun imageUrl(imageUrl: JsonField<String>) = apply { this.imageUrl = imageUrl }
+
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint) =
+            promptCacheBreakpoint(JsonField.of(promptCacheBreakpoint))
+
+        /**
+         * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+         * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) = apply {
+            this.promptCacheBreakpoint = promptCacheBreakpoint
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseInputImage].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .detail()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseInputImage =
+            BetaResponseInputImage(
+                checkRequired("detail", detail),
+                type,
+                fileId,
+                imageUrl,
+                promptCacheBreakpoint,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseInputImage = apply {
+        if (validated) {
+            return@apply
+        }
+
+        detail().validate()
+        _type().let {
+            if (it != JsonValue.from("input_image")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        fileId()
+        imageUrl()
+        promptCacheBreakpoint().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (detail.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("input_image")) 1 else 0 } +
+            (if (fileId.asKnown().isPresent) 1 else 0) +
+            (if (imageUrl.asKnown().isPresent) 1 else 0) +
+            (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * The detail level of the image to be sent to the model. One of `high`, `low`, `auto`, or
+     * `original`. Defaults to `auto`.
+     */
+    class Detail @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val LOW = of("low")
+
+            @JvmField val HIGH = of("high")
+
+            @JvmField val AUTO = of("auto")
+
+            @JvmField val ORIGINAL = of("original")
+
+            @JvmStatic fun of(value: String) = Detail(JsonField.of(value))
+        }
+
+        /** An enum containing [Detail]'s known values. */
+        enum class Known {
+            LOW,
+            HIGH,
+            AUTO,
+            ORIGINAL,
+        }
+
+        /**
+         * An enum containing [Detail]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Detail] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            LOW,
+            HIGH,
+            AUTO,
+            ORIGINAL,
+            /** An enum member indicating that [Detail] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                LOW -> Value.LOW
+                HIGH -> Value.HIGH
+                AUTO -> Value.AUTO
+                ORIGINAL -> Value.ORIGINAL
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                LOW -> Known.LOW
+                HIGH -> Known.HIGH
+                AUTO -> Known.AUTO
+                ORIGINAL -> Known.ORIGINAL
+                else -> throw OpenAIInvalidDataException("Unknown Detail: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Detail = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Detail && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     */
+    class PromptCacheBreakpoint
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+        ) : this(mode, mutableMapOf())
+
+        /**
+         * The breakpoint mode. Always `explicit`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("explicit")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheBreakpoint].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheBreakpoint]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonValue = JsonValue.from("explicit")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                mode = promptCacheBreakpoint.mode
+                additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheBreakpoint].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheBreakpoint =
+                PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheBreakpoint = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _mode().let {
+                if (it != JsonValue.from("explicit")) {
+                    throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheBreakpoint &&
+                mode == other.mode &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseInputImage &&
+            detail == other.detail &&
+            type == other.type &&
+            fileId == other.fileId &&
+            imageUrl == other.imageUrl &&
+            promptCacheBreakpoint == other.promptCacheBreakpoint &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(detail, type, fileId, imageUrl, promptCacheBreakpoint, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseInputImage{detail=$detail, type=$type, fileId=$fileId, imageUrl=$imageUrl, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputImageContent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputImageContent.kt
new file mode 100644
index 000000000..5b86be6b4
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputImageContent.kt
@@ -0,0 +1,671 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * An image input to the model. Learn about
+ * [image inputs](https://platform.openai.com/docs/guides/vision)
+ */
+class BetaResponseInputImageContent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonValue,
+    private val detail: JsonField<Detail>,
+    private val fileId: JsonField<String>,
+    private val imageUrl: JsonField<String>,
+    private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("detail") @ExcludeMissing detail: JsonField<Detail> = JsonMissing.of(),
+        @JsonProperty("file_id") @ExcludeMissing fileId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("image_url") @ExcludeMissing imageUrl: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+    ) : this(type, detail, fileId, imageUrl, promptCacheBreakpoint, mutableMapOf())
+
+    /**
+     * The type of the input item. Always `input_image`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("input_image")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The detail level of the image to be sent to the model. One of `high`, `low`, `auto`, or
+     * `original`. Defaults to `auto`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun detail(): Optional<Detail> = detail.getOptional("detail")
+
+    /**
+     * The ID of the file to be sent to the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun fileId(): Optional<String> = fileId.getOptional("file_id")
+
+    /**
+     * The URL of the image to be sent to the model. A fully qualified URL or base64 encoded image
+     * in a data URL.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun imageUrl(): Optional<String> = imageUrl.getOptional("image_url")
+
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+        promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
+    /**
+     * Returns the raw JSON value of [detail].
+     *
+     * Unlike [detail], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("detail") @ExcludeMissing fun _detail(): JsonField<Detail> = detail
+
+    /**
+     * Returns the raw JSON value of [fileId].
+     *
+     * Unlike [fileId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("file_id") @ExcludeMissing fun _fileId(): JsonField<String> = fileId
+
+    /**
+     * Returns the raw JSON value of [imageUrl].
+     *
+     * Unlike [imageUrl], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("image_url") @ExcludeMissing fun _imageUrl(): JsonField<String> = imageUrl
+
+    /**
+     * Returns the raw JSON value of [promptCacheBreakpoint].
+     *
+     * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_breakpoint")
+    @ExcludeMissing
+    fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseInputImageContent].
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseInputImageContent]. */
+    class Builder internal constructor() {
+
+        private var type: JsonValue = JsonValue.from("input_image")
+        private var detail: JsonField<Detail> = JsonMissing.of()
+        private var fileId: JsonField<String> = JsonMissing.of()
+        private var imageUrl: JsonField<String> = JsonMissing.of()
+        private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseInputImageContent: BetaResponseInputImageContent) = apply {
+            type = betaResponseInputImageContent.type
+            detail = betaResponseInputImageContent.detail
+            fileId = betaResponseInputImageContent.fileId
+            imageUrl = betaResponseInputImageContent.imageUrl
+            promptCacheBreakpoint = betaResponseInputImageContent.promptCacheBreakpoint
+            additionalProperties = betaResponseInputImageContent.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("input_image")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /**
+         * The detail level of the image to be sent to the model. One of `high`, `low`, `auto`, or
+         * `original`. Defaults to `auto`.
+         */
+        fun detail(detail: Detail?) = detail(JsonField.ofNullable(detail))
+
+        /** Alias for calling [Builder.detail] with `detail.orElse(null)`. */
+        fun detail(detail: Optional<Detail>) = detail(detail.getOrNull())
+
+        /**
+         * Sets [Builder.detail] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.detail] with a well-typed [Detail] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun detail(detail: JsonField<Detail>) = apply { this.detail = detail }
+
+        /** The ID of the file to be sent to the model. */
+        fun fileId(fileId: String?) = fileId(JsonField.ofNullable(fileId))
+
+        /** Alias for calling [Builder.fileId] with `fileId.orElse(null)`. */
+        fun fileId(fileId: Optional<String>) = fileId(fileId.getOrNull())
+
+        /**
+         * Sets [Builder.fileId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.fileId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun fileId(fileId: JsonField<String>) = apply { this.fileId = fileId }
+
+        /**
+         * The URL of the image to be sent to the model. A fully qualified URL or base64 encoded
+         * image in a data URL.
+         */
+        fun imageUrl(imageUrl: String?) = imageUrl(JsonField.ofNullable(imageUrl))
+
+        /** Alias for calling [Builder.imageUrl] with `imageUrl.orElse(null)`. */
+        fun imageUrl(imageUrl: Optional<String>) = imageUrl(imageUrl.getOrNull())
+
+        /**
+         * Sets [Builder.imageUrl] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.imageUrl] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun imageUrl(imageUrl: JsonField<String>) = apply { this.imageUrl = imageUrl }
+
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint?) =
+            promptCacheBreakpoint(JsonField.ofNullable(promptCacheBreakpoint))
+
+        /**
+         * Alias for calling [Builder.promptCacheBreakpoint] with
+         * `promptCacheBreakpoint.orElse(null)`.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: Optional<PromptCacheBreakpoint>) =
+            promptCacheBreakpoint(promptCacheBreakpoint.getOrNull())
+
+        /**
+         * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+         * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) = apply {
+            this.promptCacheBreakpoint = promptCacheBreakpoint
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseInputImageContent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): BetaResponseInputImageContent =
+            BetaResponseInputImageContent(
+                type,
+                detail,
+                fileId,
+                imageUrl,
+                promptCacheBreakpoint,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseInputImageContent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        _type().let {
+            if (it != JsonValue.from("input_image")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        detail().ifPresent { it.validate() }
+        fileId()
+        imageUrl()
+        promptCacheBreakpoint().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        type.let { if (it == JsonValue.from("input_image")) 1 else 0 } +
+            (detail.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (fileId.asKnown().isPresent) 1 else 0) +
+            (if (imageUrl.asKnown().isPresent) 1 else 0) +
+            (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * The detail level of the image to be sent to the model. One of `high`, `low`, `auto`, or
+     * `original`. Defaults to `auto`.
+     */
+    class Detail @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val LOW = of("low")
+
+            @JvmField val HIGH = of("high")
+
+            @JvmField val AUTO = of("auto")
+
+            @JvmField val ORIGINAL = of("original")
+
+            @JvmStatic fun of(value: String) = Detail(JsonField.of(value))
+        }
+
+        /** An enum containing [Detail]'s known values. */
+        enum class Known {
+            LOW,
+            HIGH,
+            AUTO,
+            ORIGINAL,
+        }
+
+        /**
+         * An enum containing [Detail]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Detail] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            LOW,
+            HIGH,
+            AUTO,
+            ORIGINAL,
+            /** An enum member indicating that [Detail] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                LOW -> Value.LOW
+                HIGH -> Value.HIGH
+                AUTO -> Value.AUTO
+                ORIGINAL -> Value.ORIGINAL
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                LOW -> Known.LOW
+                HIGH -> Known.HIGH
+                AUTO -> Known.AUTO
+                ORIGINAL -> Known.ORIGINAL
+                else -> throw OpenAIInvalidDataException("Unknown Detail: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Detail = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Detail && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     */
+    class PromptCacheBreakpoint
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+        ) : this(mode, mutableMapOf())
+
+        /**
+         * The breakpoint mode. Always `explicit`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("explicit")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheBreakpoint].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheBreakpoint]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonValue = JsonValue.from("explicit")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                mode = promptCacheBreakpoint.mode
+                additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheBreakpoint].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheBreakpoint =
+                PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheBreakpoint = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _mode().let {
+                if (it != JsonValue.from("explicit")) {
+                    throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheBreakpoint &&
+                mode == other.mode &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseInputImageContent &&
+            type == other.type &&
+            detail == other.detail &&
+            fileId == other.fileId &&
+            imageUrl == other.imageUrl &&
+            promptCacheBreakpoint == other.promptCacheBreakpoint &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(type, detail, fileId, imageUrl, promptCacheBreakpoint, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseInputImageContent{type=$type, detail=$detail, fileId=$fileId, imageUrl=$imageUrl, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputItem.kt
new file mode 100644
index 000000000..9c0240999
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputItem.kt
@@ -0,0 +1,24772 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.allMaxBy
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * A message input to the model with a role indicating instruction following hierarchy. Instructions
+ * given with the `developer` or `system` role take precedence over instructions given with the
+ * `user` role. Messages with the `assistant` role are presumed to have been generated by the model
+ * in previous interactions.
+ */
+@JsonDeserialize(using = BetaResponseInputItem.Deserializer::class)
+@JsonSerialize(using = BetaResponseInputItem.Serializer::class)
+class BetaResponseInputItem
+private constructor(
+    private val betaEasyInputMessage: BetaEasyInputMessage? = null,
+    private val message: Message? = null,
+    private val betaResponseOutputMessage: BetaResponseOutputMessage? = null,
+    private val fileSearchCall: BetaResponseFileSearchToolCall? = null,
+    private val computerCall: BetaResponseComputerToolCall? = null,
+    private val computerCallOutput: ComputerCallOutput? = null,
+    private val webSearchCall: BetaResponseFunctionWebSearch? = null,
+    private val functionCall: BetaResponseFunctionToolCall? = null,
+    private val functionCallOutput: FunctionCallOutput? = null,
+    private val agentMessage: AgentMessage? = null,
+    private val multiAgentCall: MultiAgentCall? = null,
+    private val multiAgentCallOutput: MultiAgentCallOutput? = null,
+    private val toolSearchCall: ToolSearchCall? = null,
+    private val toolSearchOutput: BetaResponseToolSearchOutputItemParam? = null,
+    private val additionalTools: AdditionalTools? = null,
+    private val reasoning: BetaResponseReasoningItem? = null,
+    private val compaction: BetaResponseCompactionItemParam? = null,
+    private val imageGenerationCall: ImageGenerationCall? = null,
+    private val codeInterpreterCall: BetaResponseCodeInterpreterToolCall? = null,
+    private val localShellCall: LocalShellCall? = null,
+    private val localShellCallOutput: LocalShellCallOutput? = null,
+    private val shellCall: ShellCall? = null,
+    private val shellCallOutput: ShellCallOutput? = null,
+    private val applyPatchCall: ApplyPatchCall? = null,
+    private val applyPatchCallOutput: ApplyPatchCallOutput? = null,
+    private val mcpListTools: McpListTools? = null,
+    private val mcpApprovalRequest: McpApprovalRequest? = null,
+    private val mcpApprovalResponse: McpApprovalResponse? = null,
+    private val mcpCall: McpCall? = null,
+    private val customToolCallOutput: BetaResponseCustomToolCallOutput? = null,
+    private val customToolCall: BetaResponseCustomToolCall? = null,
+    private val compactionTrigger: CompactionTrigger? = null,
+    private val itemReference: ItemReference? = null,
+    private val program: Program? = null,
+    private val programOutput: ProgramOutput? = null,
+    private val _json: JsonValue? = null,
+) {
+
+    /**
+     * A message input to the model with a role indicating instruction following hierarchy.
+     * Instructions given with the `developer` or `system` role take precedence over instructions
+     * given with the `user` role. Messages with the `assistant` role are presumed to have been
+     * generated by the model in previous interactions.
+     */
+    fun betaEasyInputMessage(): Optional<BetaEasyInputMessage> =
+        Optional.ofNullable(betaEasyInputMessage)
+
+    /**
+     * A message input to the model with a role indicating instruction following hierarchy.
+     * Instructions given with the `developer` or `system` role take precedence over instructions
+     * given with the `user` role.
+     */
+    fun message(): Optional<Message> = Optional.ofNullable(message)
+
+    /** An output message from the model. */
+    fun betaResponseOutputMessage(): Optional<BetaResponseOutputMessage> =
+        Optional.ofNullable(betaResponseOutputMessage)
+
+    /**
+     * The results of a file search tool call. See the
+     * [file search guide](https://platform.openai.com/docs/guides/tools-file-search) for more
+     * information.
+     */
+    fun fileSearchCall(): Optional<BetaResponseFileSearchToolCall> =
+        Optional.ofNullable(fileSearchCall)
+
+    /**
+     * A tool call to a computer use tool. See the
+     * [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more
+     * information.
+     */
+    fun computerCall(): Optional<BetaResponseComputerToolCall> = Optional.ofNullable(computerCall)
+
+    /** The output of a computer tool call. */
+    fun computerCallOutput(): Optional<ComputerCallOutput> = Optional.ofNullable(computerCallOutput)
+
+    /**
+     * The results of a web search tool call. See the
+     * [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more
+     * information.
+     */
+    fun webSearchCall(): Optional<BetaResponseFunctionWebSearch> =
+        Optional.ofNullable(webSearchCall)
+
+    /**
+     * A tool call to run a function. See the
+     * [function calling guide](https://platform.openai.com/docs/guides/function-calling) for more
+     * information.
+     */
+    fun functionCall(): Optional<BetaResponseFunctionToolCall> = Optional.ofNullable(functionCall)
+
+    /** The output of a function tool call. */
+    fun functionCallOutput(): Optional<FunctionCallOutput> = Optional.ofNullable(functionCallOutput)
+
+    /** A message routed between agents. */
+    fun agentMessage(): Optional<AgentMessage> = Optional.ofNullable(agentMessage)
+
+    fun multiAgentCall(): Optional<MultiAgentCall> = Optional.ofNullable(multiAgentCall)
+
+    fun multiAgentCallOutput(): Optional<MultiAgentCallOutput> =
+        Optional.ofNullable(multiAgentCallOutput)
+
+    fun toolSearchCall(): Optional<ToolSearchCall> = Optional.ofNullable(toolSearchCall)
+
+    fun toolSearchOutput(): Optional<BetaResponseToolSearchOutputItemParam> =
+        Optional.ofNullable(toolSearchOutput)
+
+    fun additionalTools(): Optional<AdditionalTools> = Optional.ofNullable(additionalTools)
+
+    /**
+     * A description of the chain of thought used by a reasoning model while generating a response.
+     * Be sure to include these items in your `input` to the Responses API for subsequent turns of a
+     * conversation if you are manually
+     * [managing context](https://platform.openai.com/docs/guides/conversation-state).
+     */
+    fun reasoning(): Optional<BetaResponseReasoningItem> = Optional.ofNullable(reasoning)
+
+    /**
+     * A compaction item generated by the
+     * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+     */
+    fun compaction(): Optional<BetaResponseCompactionItemParam> = Optional.ofNullable(compaction)
+
+    /** An image generation request made by the model. */
+    fun imageGenerationCall(): Optional<ImageGenerationCall> =
+        Optional.ofNullable(imageGenerationCall)
+
+    /** A tool call to run code. */
+    fun codeInterpreterCall(): Optional<BetaResponseCodeInterpreterToolCall> =
+        Optional.ofNullable(codeInterpreterCall)
+
+    /** A tool call to run a command on the local shell. */
+    fun localShellCall(): Optional<LocalShellCall> = Optional.ofNullable(localShellCall)
+
+    /** The output of a local shell tool call. */
+    fun localShellCallOutput(): Optional<LocalShellCallOutput> =
+        Optional.ofNullable(localShellCallOutput)
+
+    /** A tool representing a request to execute one or more shell commands. */
+    fun shellCall(): Optional<ShellCall> = Optional.ofNullable(shellCall)
+
+    /** The streamed output items emitted by a shell tool call. */
+    fun shellCallOutput(): Optional<ShellCallOutput> = Optional.ofNullable(shellCallOutput)
+
+    /** A tool call representing a request to create, delete, or update files using diff patches. */
+    fun applyPatchCall(): Optional<ApplyPatchCall> = Optional.ofNullable(applyPatchCall)
+
+    /** The streamed output emitted by an apply patch tool call. */
+    fun applyPatchCallOutput(): Optional<ApplyPatchCallOutput> =
+        Optional.ofNullable(applyPatchCallOutput)
+
+    /** A list of tools available on an MCP server. */
+    fun mcpListTools(): Optional<McpListTools> = Optional.ofNullable(mcpListTools)
+
+    /** A request for human approval of a tool invocation. */
+    fun mcpApprovalRequest(): Optional<McpApprovalRequest> = Optional.ofNullable(mcpApprovalRequest)
+
+    /** A response to an MCP approval request. */
+    fun mcpApprovalResponse(): Optional<McpApprovalResponse> =
+        Optional.ofNullable(mcpApprovalResponse)
+
+    /** An invocation of a tool on an MCP server. */
+    fun mcpCall(): Optional<McpCall> = Optional.ofNullable(mcpCall)
+
+    /** The output of a custom tool call from your code, being sent back to the model. */
+    fun customToolCallOutput(): Optional<BetaResponseCustomToolCallOutput> =
+        Optional.ofNullable(customToolCallOutput)
+
+    /** A call to a custom tool created by the model. */
+    fun customToolCall(): Optional<BetaResponseCustomToolCall> = Optional.ofNullable(customToolCall)
+
+    /** Compacts the current context. Must be the final input item. */
+    fun compactionTrigger(): Optional<CompactionTrigger> = Optional.ofNullable(compactionTrigger)
+
+    /** An internal identifier for an item to reference. */
+    fun itemReference(): Optional<ItemReference> = Optional.ofNullable(itemReference)
+
+    fun program(): Optional<Program> = Optional.ofNullable(program)
+
+    fun programOutput(): Optional<ProgramOutput> = Optional.ofNullable(programOutput)
+
+    fun isBetaEasyInputMessage(): Boolean = betaEasyInputMessage != null
+
+    fun isMessage(): Boolean = message != null
+
+    fun isBetaResponseOutputMessage(): Boolean = betaResponseOutputMessage != null
+
+    fun isFileSearchCall(): Boolean = fileSearchCall != null
+
+    fun isComputerCall(): Boolean = computerCall != null
+
+    fun isComputerCallOutput(): Boolean = computerCallOutput != null
+
+    fun isWebSearchCall(): Boolean = webSearchCall != null
+
+    fun isFunctionCall(): Boolean = functionCall != null
+
+    fun isFunctionCallOutput(): Boolean = functionCallOutput != null
+
+    fun isAgentMessage(): Boolean = agentMessage != null
+
+    fun isMultiAgentCall(): Boolean = multiAgentCall != null
+
+    fun isMultiAgentCallOutput(): Boolean = multiAgentCallOutput != null
+
+    fun isToolSearchCall(): Boolean = toolSearchCall != null
+
+    fun isToolSearchOutput(): Boolean = toolSearchOutput != null
+
+    fun isAdditionalTools(): Boolean = additionalTools != null
+
+    fun isReasoning(): Boolean = reasoning != null
+
+    fun isCompaction(): Boolean = compaction != null
+
+    fun isImageGenerationCall(): Boolean = imageGenerationCall != null
+
+    fun isCodeInterpreterCall(): Boolean = codeInterpreterCall != null
+
+    fun isLocalShellCall(): Boolean = localShellCall != null
+
+    fun isLocalShellCallOutput(): Boolean = localShellCallOutput != null
+
+    fun isShellCall(): Boolean = shellCall != null
+
+    fun isShellCallOutput(): Boolean = shellCallOutput != null
+
+    fun isApplyPatchCall(): Boolean = applyPatchCall != null
+
+    fun isApplyPatchCallOutput(): Boolean = applyPatchCallOutput != null
+
+    fun isMcpListTools(): Boolean = mcpListTools != null
+
+    fun isMcpApprovalRequest(): Boolean = mcpApprovalRequest != null
+
+    fun isMcpApprovalResponse(): Boolean = mcpApprovalResponse != null
+
+    fun isMcpCall(): Boolean = mcpCall != null
+
+    fun isCustomToolCallOutput(): Boolean = customToolCallOutput != null
+
+    fun isCustomToolCall(): Boolean = customToolCall != null
+
+    fun isCompactionTrigger(): Boolean = compactionTrigger != null
+
+    fun isItemReference(): Boolean = itemReference != null
+
+    fun isProgram(): Boolean = program != null
+
+    fun isProgramOutput(): Boolean = programOutput != null
+
+    /**
+     * A message input to the model with a role indicating instruction following hierarchy.
+     * Instructions given with the `developer` or `system` role take precedence over instructions
+     * given with the `user` role. Messages with the `assistant` role are presumed to have been
+     * generated by the model in previous interactions.
+     */
+    fun asBetaEasyInputMessage(): BetaEasyInputMessage =
+        betaEasyInputMessage.getOrThrow("betaEasyInputMessage")
+
+    /**
+     * A message input to the model with a role indicating instruction following hierarchy.
+     * Instructions given with the `developer` or `system` role take precedence over instructions
+     * given with the `user` role.
+     */
+    fun asMessage(): Message = message.getOrThrow("message")
+
+    /** An output message from the model. */
+    fun asBetaResponseOutputMessage(): BetaResponseOutputMessage =
+        betaResponseOutputMessage.getOrThrow("betaResponseOutputMessage")
+
+    /**
+     * The results of a file search tool call. See the
+     * [file search guide](https://platform.openai.com/docs/guides/tools-file-search) for more
+     * information.
+     */
+    fun asFileSearchCall(): BetaResponseFileSearchToolCall =
+        fileSearchCall.getOrThrow("fileSearchCall")
+
+    /**
+     * A tool call to a computer use tool. See the
+     * [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more
+     * information.
+     */
+    fun asComputerCall(): BetaResponseComputerToolCall = computerCall.getOrThrow("computerCall")
+
+    /** The output of a computer tool call. */
+    fun asComputerCallOutput(): ComputerCallOutput =
+        computerCallOutput.getOrThrow("computerCallOutput")
+
+    /**
+     * The results of a web search tool call. See the
+     * [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more
+     * information.
+     */
+    fun asWebSearchCall(): BetaResponseFunctionWebSearch = webSearchCall.getOrThrow("webSearchCall")
+
+    /**
+     * A tool call to run a function. See the
+     * [function calling guide](https://platform.openai.com/docs/guides/function-calling) for more
+     * information.
+     */
+    fun asFunctionCall(): BetaResponseFunctionToolCall = functionCall.getOrThrow("functionCall")
+
+    /** The output of a function tool call. */
+    fun asFunctionCallOutput(): FunctionCallOutput =
+        functionCallOutput.getOrThrow("functionCallOutput")
+
+    /** A message routed between agents. */
+    fun asAgentMessage(): AgentMessage = agentMessage.getOrThrow("agentMessage")
+
+    fun asMultiAgentCall(): MultiAgentCall = multiAgentCall.getOrThrow("multiAgentCall")
+
+    fun asMultiAgentCallOutput(): MultiAgentCallOutput =
+        multiAgentCallOutput.getOrThrow("multiAgentCallOutput")
+
+    fun asToolSearchCall(): ToolSearchCall = toolSearchCall.getOrThrow("toolSearchCall")
+
+    fun asToolSearchOutput(): BetaResponseToolSearchOutputItemParam =
+        toolSearchOutput.getOrThrow("toolSearchOutput")
+
+    fun asAdditionalTools(): AdditionalTools = additionalTools.getOrThrow("additionalTools")
+
+    /**
+     * A description of the chain of thought used by a reasoning model while generating a response.
+     * Be sure to include these items in your `input` to the Responses API for subsequent turns of a
+     * conversation if you are manually
+     * [managing context](https://platform.openai.com/docs/guides/conversation-state).
+     */
+    fun asReasoning(): BetaResponseReasoningItem = reasoning.getOrThrow("reasoning")
+
+    /**
+     * A compaction item generated by the
+     * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+     */
+    fun asCompaction(): BetaResponseCompactionItemParam = compaction.getOrThrow("compaction")
+
+    /** An image generation request made by the model. */
+    fun asImageGenerationCall(): ImageGenerationCall =
+        imageGenerationCall.getOrThrow("imageGenerationCall")
+
+    /** A tool call to run code. */
+    fun asCodeInterpreterCall(): BetaResponseCodeInterpreterToolCall =
+        codeInterpreterCall.getOrThrow("codeInterpreterCall")
+
+    /** A tool call to run a command on the local shell. */
+    fun asLocalShellCall(): LocalShellCall = localShellCall.getOrThrow("localShellCall")
+
+    /** The output of a local shell tool call. */
+    fun asLocalShellCallOutput(): LocalShellCallOutput =
+        localShellCallOutput.getOrThrow("localShellCallOutput")
+
+    /** A tool representing a request to execute one or more shell commands. */
+    fun asShellCall(): ShellCall = shellCall.getOrThrow("shellCall")
+
+    /** The streamed output items emitted by a shell tool call. */
+    fun asShellCallOutput(): ShellCallOutput = shellCallOutput.getOrThrow("shellCallOutput")
+
+    /** A tool call representing a request to create, delete, or update files using diff patches. */
+    fun asApplyPatchCall(): ApplyPatchCall = applyPatchCall.getOrThrow("applyPatchCall")
+
+    /** The streamed output emitted by an apply patch tool call. */
+    fun asApplyPatchCallOutput(): ApplyPatchCallOutput =
+        applyPatchCallOutput.getOrThrow("applyPatchCallOutput")
+
+    /** A list of tools available on an MCP server. */
+    fun asMcpListTools(): McpListTools = mcpListTools.getOrThrow("mcpListTools")
+
+    /** A request for human approval of a tool invocation. */
+    fun asMcpApprovalRequest(): McpApprovalRequest =
+        mcpApprovalRequest.getOrThrow("mcpApprovalRequest")
+
+    /** A response to an MCP approval request. */
+    fun asMcpApprovalResponse(): McpApprovalResponse =
+        mcpApprovalResponse.getOrThrow("mcpApprovalResponse")
+
+    /** An invocation of a tool on an MCP server. */
+    fun asMcpCall(): McpCall = mcpCall.getOrThrow("mcpCall")
+
+    /** The output of a custom tool call from your code, being sent back to the model. */
+    fun asCustomToolCallOutput(): BetaResponseCustomToolCallOutput =
+        customToolCallOutput.getOrThrow("customToolCallOutput")
+
+    /** A call to a custom tool created by the model. */
+    fun asCustomToolCall(): BetaResponseCustomToolCall = customToolCall.getOrThrow("customToolCall")
+
+    /** Compacts the current context. Must be the final input item. */
+    fun asCompactionTrigger(): CompactionTrigger = compactionTrigger.getOrThrow("compactionTrigger")
+
+    /** An internal identifier for an item to reference. */
+    fun asItemReference(): ItemReference = itemReference.getOrThrow("itemReference")
+
+    fun asProgram(): Program = program.getOrThrow("program")
+
+    fun asProgramOutput(): ProgramOutput = programOutput.getOrThrow("programOutput")
+
+    fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+    /**
+     * Maps this instance's current variant to a value of type [T] using the given [visitor].
+     *
+     * Note that this method is _not_ forwards compatible with new variants from the API, unless
+     * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of the
+     * SDK gracefully, consider overriding [Visitor.unknown]:
+     * ```java
+     * import com.openai.core.JsonValue;
+     * import java.util.Optional;
+     *
+     * Optional<String> result = betaResponseInputItem.accept(new BetaResponseInputItem.Visitor<Optional<String>>() {
+     *     @Override
+     *     public Optional<String> visitBetaEasyInputMessage(BetaEasyInputMessage betaEasyInputMessage) {
+     *         return Optional.of(betaEasyInputMessage.toString());
+     *     }
+     *
+     *     // ...
+     *
+     *     @Override
+     *     public Optional<String> unknown(JsonValue json) {
+     *         // Or inspect the `json`.
+     *         return Optional.empty();
+     *     }
+     * });
+     * ```
+     *
+     * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor] and
+     *   the current variant is unknown.
+     */
+    fun <T> accept(visitor: Visitor<T>): T =
+        when {
+            betaEasyInputMessage != null -> visitor.visitBetaEasyInputMessage(betaEasyInputMessage)
+            message != null -> visitor.visitMessage(message)
+            betaResponseOutputMessage != null ->
+                visitor.visitBetaResponseOutputMessage(betaResponseOutputMessage)
+            fileSearchCall != null -> visitor.visitFileSearchCall(fileSearchCall)
+            computerCall != null -> visitor.visitComputerCall(computerCall)
+            computerCallOutput != null -> visitor.visitComputerCallOutput(computerCallOutput)
+            webSearchCall != null -> visitor.visitWebSearchCall(webSearchCall)
+            functionCall != null -> visitor.visitFunctionCall(functionCall)
+            functionCallOutput != null -> visitor.visitFunctionCallOutput(functionCallOutput)
+            agentMessage != null -> visitor.visitAgentMessage(agentMessage)
+            multiAgentCall != null -> visitor.visitMultiAgentCall(multiAgentCall)
+            multiAgentCallOutput != null -> visitor.visitMultiAgentCallOutput(multiAgentCallOutput)
+            toolSearchCall != null -> visitor.visitToolSearchCall(toolSearchCall)
+            toolSearchOutput != null -> visitor.visitToolSearchOutput(toolSearchOutput)
+            additionalTools != null -> visitor.visitAdditionalTools(additionalTools)
+            reasoning != null -> visitor.visitReasoning(reasoning)
+            compaction != null -> visitor.visitCompaction(compaction)
+            imageGenerationCall != null -> visitor.visitImageGenerationCall(imageGenerationCall)
+            codeInterpreterCall != null -> visitor.visitCodeInterpreterCall(codeInterpreterCall)
+            localShellCall != null -> visitor.visitLocalShellCall(localShellCall)
+            localShellCallOutput != null -> visitor.visitLocalShellCallOutput(localShellCallOutput)
+            shellCall != null -> visitor.visitShellCall(shellCall)
+            shellCallOutput != null -> visitor.visitShellCallOutput(shellCallOutput)
+            applyPatchCall != null -> visitor.visitApplyPatchCall(applyPatchCall)
+            applyPatchCallOutput != null -> visitor.visitApplyPatchCallOutput(applyPatchCallOutput)
+            mcpListTools != null -> visitor.visitMcpListTools(mcpListTools)
+            mcpApprovalRequest != null -> visitor.visitMcpApprovalRequest(mcpApprovalRequest)
+            mcpApprovalResponse != null -> visitor.visitMcpApprovalResponse(mcpApprovalResponse)
+            mcpCall != null -> visitor.visitMcpCall(mcpCall)
+            customToolCallOutput != null -> visitor.visitCustomToolCallOutput(customToolCallOutput)
+            customToolCall != null -> visitor.visitCustomToolCall(customToolCall)
+            compactionTrigger != null -> visitor.visitCompactionTrigger(compactionTrigger)
+            itemReference != null -> visitor.visitItemReference(itemReference)
+            program != null -> visitor.visitProgram(program)
+            programOutput != null -> visitor.visitProgramOutput(programOutput)
+            else -> visitor.unknown(_json)
+        }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseInputItem = apply {
+        if (validated) {
+            return@apply
+        }
+
+        accept(
+            object : Visitor<Unit> {
+                override fun visitBetaEasyInputMessage(betaEasyInputMessage: BetaEasyInputMessage) {
+                    betaEasyInputMessage.validate()
+                }
+
+                override fun visitMessage(message: Message) {
+                    message.validate()
+                }
+
+                override fun visitBetaResponseOutputMessage(
+                    betaResponseOutputMessage: BetaResponseOutputMessage
+                ) {
+                    betaResponseOutputMessage.validate()
+                }
+
+                override fun visitFileSearchCall(fileSearchCall: BetaResponseFileSearchToolCall) {
+                    fileSearchCall.validate()
+                }
+
+                override fun visitComputerCall(computerCall: BetaResponseComputerToolCall) {
+                    computerCall.validate()
+                }
+
+                override fun visitComputerCallOutput(computerCallOutput: ComputerCallOutput) {
+                    computerCallOutput.validate()
+                }
+
+                override fun visitWebSearchCall(webSearchCall: BetaResponseFunctionWebSearch) {
+                    webSearchCall.validate()
+                }
+
+                override fun visitFunctionCall(functionCall: BetaResponseFunctionToolCall) {
+                    functionCall.validate()
+                }
+
+                override fun visitFunctionCallOutput(functionCallOutput: FunctionCallOutput) {
+                    functionCallOutput.validate()
+                }
+
+                override fun visitAgentMessage(agentMessage: AgentMessage) {
+                    agentMessage.validate()
+                }
+
+                override fun visitMultiAgentCall(multiAgentCall: MultiAgentCall) {
+                    multiAgentCall.validate()
+                }
+
+                override fun visitMultiAgentCallOutput(multiAgentCallOutput: MultiAgentCallOutput) {
+                    multiAgentCallOutput.validate()
+                }
+
+                override fun visitToolSearchCall(toolSearchCall: ToolSearchCall) {
+                    toolSearchCall.validate()
+                }
+
+                override fun visitToolSearchOutput(
+                    toolSearchOutput: BetaResponseToolSearchOutputItemParam
+                ) {
+                    toolSearchOutput.validate()
+                }
+
+                override fun visitAdditionalTools(additionalTools: AdditionalTools) {
+                    additionalTools.validate()
+                }
+
+                override fun visitReasoning(reasoning: BetaResponseReasoningItem) {
+                    reasoning.validate()
+                }
+
+                override fun visitCompaction(compaction: BetaResponseCompactionItemParam) {
+                    compaction.validate()
+                }
+
+                override fun visitImageGenerationCall(imageGenerationCall: ImageGenerationCall) {
+                    imageGenerationCall.validate()
+                }
+
+                override fun visitCodeInterpreterCall(
+                    codeInterpreterCall: BetaResponseCodeInterpreterToolCall
+                ) {
+                    codeInterpreterCall.validate()
+                }
+
+                override fun visitLocalShellCall(localShellCall: LocalShellCall) {
+                    localShellCall.validate()
+                }
+
+                override fun visitLocalShellCallOutput(localShellCallOutput: LocalShellCallOutput) {
+                    localShellCallOutput.validate()
+                }
+
+                override fun visitShellCall(shellCall: ShellCall) {
+                    shellCall.validate()
+                }
+
+                override fun visitShellCallOutput(shellCallOutput: ShellCallOutput) {
+                    shellCallOutput.validate()
+                }
+
+                override fun visitApplyPatchCall(applyPatchCall: ApplyPatchCall) {
+                    applyPatchCall.validate()
+                }
+
+                override fun visitApplyPatchCallOutput(applyPatchCallOutput: ApplyPatchCallOutput) {
+                    applyPatchCallOutput.validate()
+                }
+
+                override fun visitMcpListTools(mcpListTools: McpListTools) {
+                    mcpListTools.validate()
+                }
+
+                override fun visitMcpApprovalRequest(mcpApprovalRequest: McpApprovalRequest) {
+                    mcpApprovalRequest.validate()
+                }
+
+                override fun visitMcpApprovalResponse(mcpApprovalResponse: McpApprovalResponse) {
+                    mcpApprovalResponse.validate()
+                }
+
+                override fun visitMcpCall(mcpCall: McpCall) {
+                    mcpCall.validate()
+                }
+
+                override fun visitCustomToolCallOutput(
+                    customToolCallOutput: BetaResponseCustomToolCallOutput
+                ) {
+                    customToolCallOutput.validate()
+                }
+
+                override fun visitCustomToolCall(customToolCall: BetaResponseCustomToolCall) {
+                    customToolCall.validate()
+                }
+
+                override fun visitCompactionTrigger(compactionTrigger: CompactionTrigger) {
+                    compactionTrigger.validate()
+                }
+
+                override fun visitItemReference(itemReference: ItemReference) {
+                    itemReference.validate()
+                }
+
+                override fun visitProgram(program: Program) {
+                    program.validate()
+                }
+
+                override fun visitProgramOutput(programOutput: ProgramOutput) {
+                    programOutput.validate()
+                }
+            }
+        )
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        accept(
+            object : Visitor<Int> {
+                override fun visitBetaEasyInputMessage(betaEasyInputMessage: BetaEasyInputMessage) =
+                    betaEasyInputMessage.validity()
+
+                override fun visitMessage(message: Message) = message.validity()
+
+                override fun visitBetaResponseOutputMessage(
+                    betaResponseOutputMessage: BetaResponseOutputMessage
+                ) = betaResponseOutputMessage.validity()
+
+                override fun visitFileSearchCall(fileSearchCall: BetaResponseFileSearchToolCall) =
+                    fileSearchCall.validity()
+
+                override fun visitComputerCall(computerCall: BetaResponseComputerToolCall) =
+                    computerCall.validity()
+
+                override fun visitComputerCallOutput(computerCallOutput: ComputerCallOutput) =
+                    computerCallOutput.validity()
+
+                override fun visitWebSearchCall(webSearchCall: BetaResponseFunctionWebSearch) =
+                    webSearchCall.validity()
+
+                override fun visitFunctionCall(functionCall: BetaResponseFunctionToolCall) =
+                    functionCall.validity()
+
+                override fun visitFunctionCallOutput(functionCallOutput: FunctionCallOutput) =
+                    functionCallOutput.validity()
+
+                override fun visitAgentMessage(agentMessage: AgentMessage) = agentMessage.validity()
+
+                override fun visitMultiAgentCall(multiAgentCall: MultiAgentCall) =
+                    multiAgentCall.validity()
+
+                override fun visitMultiAgentCallOutput(multiAgentCallOutput: MultiAgentCallOutput) =
+                    multiAgentCallOutput.validity()
+
+                override fun visitToolSearchCall(toolSearchCall: ToolSearchCall) =
+                    toolSearchCall.validity()
+
+                override fun visitToolSearchOutput(
+                    toolSearchOutput: BetaResponseToolSearchOutputItemParam
+                ) = toolSearchOutput.validity()
+
+                override fun visitAdditionalTools(additionalTools: AdditionalTools) =
+                    additionalTools.validity()
+
+                override fun visitReasoning(reasoning: BetaResponseReasoningItem) =
+                    reasoning.validity()
+
+                override fun visitCompaction(compaction: BetaResponseCompactionItemParam) =
+                    compaction.validity()
+
+                override fun visitImageGenerationCall(imageGenerationCall: ImageGenerationCall) =
+                    imageGenerationCall.validity()
+
+                override fun visitCodeInterpreterCall(
+                    codeInterpreterCall: BetaResponseCodeInterpreterToolCall
+                ) = codeInterpreterCall.validity()
+
+                override fun visitLocalShellCall(localShellCall: LocalShellCall) =
+                    localShellCall.validity()
+
+                override fun visitLocalShellCallOutput(localShellCallOutput: LocalShellCallOutput) =
+                    localShellCallOutput.validity()
+
+                override fun visitShellCall(shellCall: ShellCall) = shellCall.validity()
+
+                override fun visitShellCallOutput(shellCallOutput: ShellCallOutput) =
+                    shellCallOutput.validity()
+
+                override fun visitApplyPatchCall(applyPatchCall: ApplyPatchCall) =
+                    applyPatchCall.validity()
+
+                override fun visitApplyPatchCallOutput(applyPatchCallOutput: ApplyPatchCallOutput) =
+                    applyPatchCallOutput.validity()
+
+                override fun visitMcpListTools(mcpListTools: McpListTools) = mcpListTools.validity()
+
+                override fun visitMcpApprovalRequest(mcpApprovalRequest: McpApprovalRequest) =
+                    mcpApprovalRequest.validity()
+
+                override fun visitMcpApprovalResponse(mcpApprovalResponse: McpApprovalResponse) =
+                    mcpApprovalResponse.validity()
+
+                override fun visitMcpCall(mcpCall: McpCall) = mcpCall.validity()
+
+                override fun visitCustomToolCallOutput(
+                    customToolCallOutput: BetaResponseCustomToolCallOutput
+                ) = customToolCallOutput.validity()
+
+                override fun visitCustomToolCall(customToolCall: BetaResponseCustomToolCall) =
+                    customToolCall.validity()
+
+                override fun visitCompactionTrigger(compactionTrigger: CompactionTrigger) =
+                    compactionTrigger.validity()
+
+                override fun visitItemReference(itemReference: ItemReference) =
+                    itemReference.validity()
+
+                override fun visitProgram(program: Program) = program.validity()
+
+                override fun visitProgramOutput(programOutput: ProgramOutput) =
+                    programOutput.validity()
+
+                override fun unknown(json: JsonValue?) = 0
+            }
+        )
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseInputItem &&
+            betaEasyInputMessage == other.betaEasyInputMessage &&
+            message == other.message &&
+            betaResponseOutputMessage == other.betaResponseOutputMessage &&
+            fileSearchCall == other.fileSearchCall &&
+            computerCall == other.computerCall &&
+            computerCallOutput == other.computerCallOutput &&
+            webSearchCall == other.webSearchCall &&
+            functionCall == other.functionCall &&
+            functionCallOutput == other.functionCallOutput &&
+            agentMessage == other.agentMessage &&
+            multiAgentCall == other.multiAgentCall &&
+            multiAgentCallOutput == other.multiAgentCallOutput &&
+            toolSearchCall == other.toolSearchCall &&
+            toolSearchOutput == other.toolSearchOutput &&
+            additionalTools == other.additionalTools &&
+            reasoning == other.reasoning &&
+            compaction == other.compaction &&
+            imageGenerationCall == other.imageGenerationCall &&
+            codeInterpreterCall == other.codeInterpreterCall &&
+            localShellCall == other.localShellCall &&
+            localShellCallOutput == other.localShellCallOutput &&
+            shellCall == other.shellCall &&
+            shellCallOutput == other.shellCallOutput &&
+            applyPatchCall == other.applyPatchCall &&
+            applyPatchCallOutput == other.applyPatchCallOutput &&
+            mcpListTools == other.mcpListTools &&
+            mcpApprovalRequest == other.mcpApprovalRequest &&
+            mcpApprovalResponse == other.mcpApprovalResponse &&
+            mcpCall == other.mcpCall &&
+            customToolCallOutput == other.customToolCallOutput &&
+            customToolCall == other.customToolCall &&
+            compactionTrigger == other.compactionTrigger &&
+            itemReference == other.itemReference &&
+            program == other.program &&
+            programOutput == other.programOutput
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(
+            betaEasyInputMessage,
+            message,
+            betaResponseOutputMessage,
+            fileSearchCall,
+            computerCall,
+            computerCallOutput,
+            webSearchCall,
+            functionCall,
+            functionCallOutput,
+            agentMessage,
+            multiAgentCall,
+            multiAgentCallOutput,
+            toolSearchCall,
+            toolSearchOutput,
+            additionalTools,
+            reasoning,
+            compaction,
+            imageGenerationCall,
+            codeInterpreterCall,
+            localShellCall,
+            localShellCallOutput,
+            shellCall,
+            shellCallOutput,
+            applyPatchCall,
+            applyPatchCallOutput,
+            mcpListTools,
+            mcpApprovalRequest,
+            mcpApprovalResponse,
+            mcpCall,
+            customToolCallOutput,
+            customToolCall,
+            compactionTrigger,
+            itemReference,
+            program,
+            programOutput,
+        )
+
+    override fun toString(): String =
+        when {
+            betaEasyInputMessage != null ->
+                "BetaResponseInputItem{betaEasyInputMessage=$betaEasyInputMessage}"
+            message != null -> "BetaResponseInputItem{message=$message}"
+            betaResponseOutputMessage != null ->
+                "BetaResponseInputItem{betaResponseOutputMessage=$betaResponseOutputMessage}"
+            fileSearchCall != null -> "BetaResponseInputItem{fileSearchCall=$fileSearchCall}"
+            computerCall != null -> "BetaResponseInputItem{computerCall=$computerCall}"
+            computerCallOutput != null ->
+                "BetaResponseInputItem{computerCallOutput=$computerCallOutput}"
+            webSearchCall != null -> "BetaResponseInputItem{webSearchCall=$webSearchCall}"
+            functionCall != null -> "BetaResponseInputItem{functionCall=$functionCall}"
+            functionCallOutput != null ->
+                "BetaResponseInputItem{functionCallOutput=$functionCallOutput}"
+            agentMessage != null -> "BetaResponseInputItem{agentMessage=$agentMessage}"
+            multiAgentCall != null -> "BetaResponseInputItem{multiAgentCall=$multiAgentCall}"
+            multiAgentCallOutput != null ->
+                "BetaResponseInputItem{multiAgentCallOutput=$multiAgentCallOutput}"
+            toolSearchCall != null -> "BetaResponseInputItem{toolSearchCall=$toolSearchCall}"
+            toolSearchOutput != null -> "BetaResponseInputItem{toolSearchOutput=$toolSearchOutput}"
+            additionalTools != null -> "BetaResponseInputItem{additionalTools=$additionalTools}"
+            reasoning != null -> "BetaResponseInputItem{reasoning=$reasoning}"
+            compaction != null -> "BetaResponseInputItem{compaction=$compaction}"
+            imageGenerationCall != null ->
+                "BetaResponseInputItem{imageGenerationCall=$imageGenerationCall}"
+            codeInterpreterCall != null ->
+                "BetaResponseInputItem{codeInterpreterCall=$codeInterpreterCall}"
+            localShellCall != null -> "BetaResponseInputItem{localShellCall=$localShellCall}"
+            localShellCallOutput != null ->
+                "BetaResponseInputItem{localShellCallOutput=$localShellCallOutput}"
+            shellCall != null -> "BetaResponseInputItem{shellCall=$shellCall}"
+            shellCallOutput != null -> "BetaResponseInputItem{shellCallOutput=$shellCallOutput}"
+            applyPatchCall != null -> "BetaResponseInputItem{applyPatchCall=$applyPatchCall}"
+            applyPatchCallOutput != null ->
+                "BetaResponseInputItem{applyPatchCallOutput=$applyPatchCallOutput}"
+            mcpListTools != null -> "BetaResponseInputItem{mcpListTools=$mcpListTools}"
+            mcpApprovalRequest != null ->
+                "BetaResponseInputItem{mcpApprovalRequest=$mcpApprovalRequest}"
+            mcpApprovalResponse != null ->
+                "BetaResponseInputItem{mcpApprovalResponse=$mcpApprovalResponse}"
+            mcpCall != null -> "BetaResponseInputItem{mcpCall=$mcpCall}"
+            customToolCallOutput != null ->
+                "BetaResponseInputItem{customToolCallOutput=$customToolCallOutput}"
+            customToolCall != null -> "BetaResponseInputItem{customToolCall=$customToolCall}"
+            compactionTrigger != null ->
+                "BetaResponseInputItem{compactionTrigger=$compactionTrigger}"
+            itemReference != null -> "BetaResponseInputItem{itemReference=$itemReference}"
+            program != null -> "BetaResponseInputItem{program=$program}"
+            programOutput != null -> "BetaResponseInputItem{programOutput=$programOutput}"
+            _json != null -> "BetaResponseInputItem{_unknown=$_json}"
+            else -> throw IllegalStateException("Invalid BetaResponseInputItem")
+        }
+
+    companion object {
+
+        /**
+         * A message input to the model with a role indicating instruction following hierarchy.
+         * Instructions given with the `developer` or `system` role take precedence over
+         * instructions given with the `user` role. Messages with the `assistant` role are presumed
+         * to have been generated by the model in previous interactions.
+         */
+        @JvmStatic
+        fun ofBetaEasyInputMessage(betaEasyInputMessage: BetaEasyInputMessage) =
+            BetaResponseInputItem(betaEasyInputMessage = betaEasyInputMessage)
+
+        /**
+         * A message input to the model with a role indicating instruction following hierarchy.
+         * Instructions given with the `developer` or `system` role take precedence over
+         * instructions given with the `user` role.
+         */
+        @JvmStatic fun ofMessage(message: Message) = BetaResponseInputItem(message = message)
+
+        /** An output message from the model. */
+        @JvmStatic
+        fun ofBetaResponseOutputMessage(betaResponseOutputMessage: BetaResponseOutputMessage) =
+            BetaResponseInputItem(betaResponseOutputMessage = betaResponseOutputMessage)
+
+        /**
+         * The results of a file search tool call. See the
+         * [file search guide](https://platform.openai.com/docs/guides/tools-file-search) for more
+         * information.
+         */
+        @JvmStatic
+        fun ofFileSearchCall(fileSearchCall: BetaResponseFileSearchToolCall) =
+            BetaResponseInputItem(fileSearchCall = fileSearchCall)
+
+        /**
+         * A tool call to a computer use tool. See the
+         * [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more
+         * information.
+         */
+        @JvmStatic
+        fun ofComputerCall(computerCall: BetaResponseComputerToolCall) =
+            BetaResponseInputItem(computerCall = computerCall)
+
+        /** The output of a computer tool call. */
+        @JvmStatic
+        fun ofComputerCallOutput(computerCallOutput: ComputerCallOutput) =
+            BetaResponseInputItem(computerCallOutput = computerCallOutput)
+
+        /**
+         * The results of a web search tool call. See the
+         * [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more
+         * information.
+         */
+        @JvmStatic
+        fun ofWebSearchCall(webSearchCall: BetaResponseFunctionWebSearch) =
+            BetaResponseInputItem(webSearchCall = webSearchCall)
+
+        /**
+         * A tool call to run a function. See the
+         * [function calling guide](https://platform.openai.com/docs/guides/function-calling) for
+         * more information.
+         */
+        @JvmStatic
+        fun ofFunctionCall(functionCall: BetaResponseFunctionToolCall) =
+            BetaResponseInputItem(functionCall = functionCall)
+
+        /** The output of a function tool call. */
+        @JvmStatic
+        fun ofFunctionCallOutput(functionCallOutput: FunctionCallOutput) =
+            BetaResponseInputItem(functionCallOutput = functionCallOutput)
+
+        /** A message routed between agents. */
+        @JvmStatic
+        fun ofAgentMessage(agentMessage: AgentMessage) =
+            BetaResponseInputItem(agentMessage = agentMessage)
+
+        @JvmStatic
+        fun ofMultiAgentCall(multiAgentCall: MultiAgentCall) =
+            BetaResponseInputItem(multiAgentCall = multiAgentCall)
+
+        @JvmStatic
+        fun ofMultiAgentCallOutput(multiAgentCallOutput: MultiAgentCallOutput) =
+            BetaResponseInputItem(multiAgentCallOutput = multiAgentCallOutput)
+
+        @JvmStatic
+        fun ofToolSearchCall(toolSearchCall: ToolSearchCall) =
+            BetaResponseInputItem(toolSearchCall = toolSearchCall)
+
+        @JvmStatic
+        fun ofToolSearchOutput(toolSearchOutput: BetaResponseToolSearchOutputItemParam) =
+            BetaResponseInputItem(toolSearchOutput = toolSearchOutput)
+
+        @JvmStatic
+        fun ofAdditionalTools(additionalTools: AdditionalTools) =
+            BetaResponseInputItem(additionalTools = additionalTools)
+
+        /**
+         * A description of the chain of thought used by a reasoning model while generating a
+         * response. Be sure to include these items in your `input` to the Responses API for
+         * subsequent turns of a conversation if you are manually
+         * [managing context](https://platform.openai.com/docs/guides/conversation-state).
+         */
+        @JvmStatic
+        fun ofReasoning(reasoning: BetaResponseReasoningItem) =
+            BetaResponseInputItem(reasoning = reasoning)
+
+        /**
+         * A compaction item generated by the
+         * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+         */
+        @JvmStatic
+        fun ofCompaction(compaction: BetaResponseCompactionItemParam) =
+            BetaResponseInputItem(compaction = compaction)
+
+        /** An image generation request made by the model. */
+        @JvmStatic
+        fun ofImageGenerationCall(imageGenerationCall: ImageGenerationCall) =
+            BetaResponseInputItem(imageGenerationCall = imageGenerationCall)
+
+        /** A tool call to run code. */
+        @JvmStatic
+        fun ofCodeInterpreterCall(codeInterpreterCall: BetaResponseCodeInterpreterToolCall) =
+            BetaResponseInputItem(codeInterpreterCall = codeInterpreterCall)
+
+        /** A tool call to run a command on the local shell. */
+        @JvmStatic
+        fun ofLocalShellCall(localShellCall: LocalShellCall) =
+            BetaResponseInputItem(localShellCall = localShellCall)
+
+        /** The output of a local shell tool call. */
+        @JvmStatic
+        fun ofLocalShellCallOutput(localShellCallOutput: LocalShellCallOutput) =
+            BetaResponseInputItem(localShellCallOutput = localShellCallOutput)
+
+        /** A tool representing a request to execute one or more shell commands. */
+        @JvmStatic
+        fun ofShellCall(shellCall: ShellCall) = BetaResponseInputItem(shellCall = shellCall)
+
+        /** The streamed output items emitted by a shell tool call. */
+        @JvmStatic
+        fun ofShellCallOutput(shellCallOutput: ShellCallOutput) =
+            BetaResponseInputItem(shellCallOutput = shellCallOutput)
+
+        /**
+         * A tool call representing a request to create, delete, or update files using diff patches.
+         */
+        @JvmStatic
+        fun ofApplyPatchCall(applyPatchCall: ApplyPatchCall) =
+            BetaResponseInputItem(applyPatchCall = applyPatchCall)
+
+        /** The streamed output emitted by an apply patch tool call. */
+        @JvmStatic
+        fun ofApplyPatchCallOutput(applyPatchCallOutput: ApplyPatchCallOutput) =
+            BetaResponseInputItem(applyPatchCallOutput = applyPatchCallOutput)
+
+        /** A list of tools available on an MCP server. */
+        @JvmStatic
+        fun ofMcpListTools(mcpListTools: McpListTools) =
+            BetaResponseInputItem(mcpListTools = mcpListTools)
+
+        /** A request for human approval of a tool invocation. */
+        @JvmStatic
+        fun ofMcpApprovalRequest(mcpApprovalRequest: McpApprovalRequest) =
+            BetaResponseInputItem(mcpApprovalRequest = mcpApprovalRequest)
+
+        /** A response to an MCP approval request. */
+        @JvmStatic
+        fun ofMcpApprovalResponse(mcpApprovalResponse: McpApprovalResponse) =
+            BetaResponseInputItem(mcpApprovalResponse = mcpApprovalResponse)
+
+        /** An invocation of a tool on an MCP server. */
+        @JvmStatic fun ofMcpCall(mcpCall: McpCall) = BetaResponseInputItem(mcpCall = mcpCall)
+
+        /** The output of a custom tool call from your code, being sent back to the model. */
+        @JvmStatic
+        fun ofCustomToolCallOutput(customToolCallOutput: BetaResponseCustomToolCallOutput) =
+            BetaResponseInputItem(customToolCallOutput = customToolCallOutput)
+
+        /** A call to a custom tool created by the model. */
+        @JvmStatic
+        fun ofCustomToolCall(customToolCall: BetaResponseCustomToolCall) =
+            BetaResponseInputItem(customToolCall = customToolCall)
+
+        /** Compacts the current context. Must be the final input item. */
+        @JvmStatic
+        fun ofCompactionTrigger(compactionTrigger: CompactionTrigger) =
+            BetaResponseInputItem(compactionTrigger = compactionTrigger)
+
+        /** An internal identifier for an item to reference. */
+        @JvmStatic
+        fun ofItemReference(itemReference: ItemReference) =
+            BetaResponseInputItem(itemReference = itemReference)
+
+        @JvmStatic fun ofProgram(program: Program) = BetaResponseInputItem(program = program)
+
+        @JvmStatic
+        fun ofProgramOutput(programOutput: ProgramOutput) =
+            BetaResponseInputItem(programOutput = programOutput)
+    }
+
+    /**
+     * An interface that defines how to map each variant of [BetaResponseInputItem] to a value of
+     * type [T].
+     */
+    interface Visitor<out T> {
+
+        /**
+         * A message input to the model with a role indicating instruction following hierarchy.
+         * Instructions given with the `developer` or `system` role take precedence over
+         * instructions given with the `user` role. Messages with the `assistant` role are presumed
+         * to have been generated by the model in previous interactions.
+         */
+        fun visitBetaEasyInputMessage(betaEasyInputMessage: BetaEasyInputMessage): T
+
+        /**
+         * A message input to the model with a role indicating instruction following hierarchy.
+         * Instructions given with the `developer` or `system` role take precedence over
+         * instructions given with the `user` role.
+         */
+        fun visitMessage(message: Message): T
+
+        /** An output message from the model. */
+        fun visitBetaResponseOutputMessage(betaResponseOutputMessage: BetaResponseOutputMessage): T
+
+        /**
+         * The results of a file search tool call. See the
+         * [file search guide](https://platform.openai.com/docs/guides/tools-file-search) for more
+         * information.
+         */
+        fun visitFileSearchCall(fileSearchCall: BetaResponseFileSearchToolCall): T
+
+        /**
+         * A tool call to a computer use tool. See the
+         * [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more
+         * information.
+         */
+        fun visitComputerCall(computerCall: BetaResponseComputerToolCall): T
+
+        /** The output of a computer tool call. */
+        fun visitComputerCallOutput(computerCallOutput: ComputerCallOutput): T
+
+        /**
+         * The results of a web search tool call. See the
+         * [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more
+         * information.
+         */
+        fun visitWebSearchCall(webSearchCall: BetaResponseFunctionWebSearch): T
+
+        /**
+         * A tool call to run a function. See the
+         * [function calling guide](https://platform.openai.com/docs/guides/function-calling) for
+         * more information.
+         */
+        fun visitFunctionCall(functionCall: BetaResponseFunctionToolCall): T
+
+        /** The output of a function tool call. */
+        fun visitFunctionCallOutput(functionCallOutput: FunctionCallOutput): T
+
+        /** A message routed between agents. */
+        fun visitAgentMessage(agentMessage: AgentMessage): T
+
+        fun visitMultiAgentCall(multiAgentCall: MultiAgentCall): T
+
+        fun visitMultiAgentCallOutput(multiAgentCallOutput: MultiAgentCallOutput): T
+
+        fun visitToolSearchCall(toolSearchCall: ToolSearchCall): T
+
+        fun visitToolSearchOutput(toolSearchOutput: BetaResponseToolSearchOutputItemParam): T
+
+        fun visitAdditionalTools(additionalTools: AdditionalTools): T
+
+        /**
+         * A description of the chain of thought used by a reasoning model while generating a
+         * response. Be sure to include these items in your `input` to the Responses API for
+         * subsequent turns of a conversation if you are manually
+         * [managing context](https://platform.openai.com/docs/guides/conversation-state).
+         */
+        fun visitReasoning(reasoning: BetaResponseReasoningItem): T
+
+        /**
+         * A compaction item generated by the
+         * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+         */
+        fun visitCompaction(compaction: BetaResponseCompactionItemParam): T
+
+        /** An image generation request made by the model. */
+        fun visitImageGenerationCall(imageGenerationCall: ImageGenerationCall): T
+
+        /** A tool call to run code. */
+        fun visitCodeInterpreterCall(codeInterpreterCall: BetaResponseCodeInterpreterToolCall): T
+
+        /** A tool call to run a command on the local shell. */
+        fun visitLocalShellCall(localShellCall: LocalShellCall): T
+
+        /** The output of a local shell tool call. */
+        fun visitLocalShellCallOutput(localShellCallOutput: LocalShellCallOutput): T
+
+        /** A tool representing a request to execute one or more shell commands. */
+        fun visitShellCall(shellCall: ShellCall): T
+
+        /** The streamed output items emitted by a shell tool call. */
+        fun visitShellCallOutput(shellCallOutput: ShellCallOutput): T
+
+        /**
+         * A tool call representing a request to create, delete, or update files using diff patches.
+         */
+        fun visitApplyPatchCall(applyPatchCall: ApplyPatchCall): T
+
+        /** The streamed output emitted by an apply patch tool call. */
+        fun visitApplyPatchCallOutput(applyPatchCallOutput: ApplyPatchCallOutput): T
+
+        /** A list of tools available on an MCP server. */
+        fun visitMcpListTools(mcpListTools: McpListTools): T
+
+        /** A request for human approval of a tool invocation. */
+        fun visitMcpApprovalRequest(mcpApprovalRequest: McpApprovalRequest): T
+
+        /** A response to an MCP approval request. */
+        fun visitMcpApprovalResponse(mcpApprovalResponse: McpApprovalResponse): T
+
+        /** An invocation of a tool on an MCP server. */
+        fun visitMcpCall(mcpCall: McpCall): T
+
+        /** The output of a custom tool call from your code, being sent back to the model. */
+        fun visitCustomToolCallOutput(customToolCallOutput: BetaResponseCustomToolCallOutput): T
+
+        /** A call to a custom tool created by the model. */
+        fun visitCustomToolCall(customToolCall: BetaResponseCustomToolCall): T
+
+        /** Compacts the current context. Must be the final input item. */
+        fun visitCompactionTrigger(compactionTrigger: CompactionTrigger): T
+
+        /** An internal identifier for an item to reference. */
+        fun visitItemReference(itemReference: ItemReference): T
+
+        fun visitProgram(program: Program): T
+
+        fun visitProgramOutput(programOutput: ProgramOutput): T
+
+        /**
+         * Maps an unknown variant of [BetaResponseInputItem] to a value of type [T].
+         *
+         * An instance of [BetaResponseInputItem] can contain an unknown variant if it was
+         * deserialized from data that doesn't match any known variant. For example, if the SDK is
+         * on an older version than the API, then the API may respond with new variants that the SDK
+         * is unaware of.
+         *
+         * @throws OpenAIInvalidDataException in the default implementation.
+         */
+        fun unknown(json: JsonValue?): T {
+            throw OpenAIInvalidDataException("Unknown BetaResponseInputItem: $json")
+        }
+    }
+
+    internal class Deserializer :
+        BaseDeserializer<BetaResponseInputItem>(BetaResponseInputItem::class) {
+
+        override fun ObjectCodec.deserialize(node: JsonNode): BetaResponseInputItem {
+            val json = JsonValue.fromJsonNode(node)
+            val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+            when (type) {
+                "message" -> {
+                    val bestMatches =
+                        sequenceOf(
+                                tryDeserialize(node, jacksonTypeRef<BetaEasyInputMessage>())?.let {
+                                    BetaResponseInputItem(betaEasyInputMessage = it, _json = json)
+                                },
+                                tryDeserialize(node, jacksonTypeRef<Message>())?.let {
+                                    BetaResponseInputItem(message = it, _json = json)
+                                },
+                                tryDeserialize(node, jacksonTypeRef<BetaResponseOutputMessage>())
+                                    ?.let {
+                                        BetaResponseInputItem(
+                                            betaResponseOutputMessage = it,
+                                            _json = json,
+                                        )
+                                    },
+                            )
+                            .filterNotNull()
+                            .allMaxBy { it.validity() }
+                            .toList()
+                    return when (bestMatches.size) {
+                        // This can happen if what we're deserializing is completely incompatible
+                        // with all the possible variants (e.g. deserializing from boolean).
+                        0 -> BetaResponseInputItem(_json = json)
+                        1 -> bestMatches.single()
+                        // If there's more than one match with the highest validity, then use the
+                        // first completely valid match, or simply the first match if none are
+                        // completely valid.
+                        else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                    }
+                }
+                "file_search_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseFileSearchToolCall>())
+                        ?.let { BetaResponseInputItem(fileSearchCall = it, _json = json) }
+                        ?: BetaResponseInputItem(_json = json)
+                }
+                "computer_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseComputerToolCall>())
+                        ?.let { BetaResponseInputItem(computerCall = it, _json = json) }
+                        ?: BetaResponseInputItem(_json = json)
+                }
+                "computer_call_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ComputerCallOutput>())?.let {
+                        BetaResponseInputItem(computerCallOutput = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "web_search_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseFunctionWebSearch>())
+                        ?.let { BetaResponseInputItem(webSearchCall = it, _json = json) }
+                        ?: BetaResponseInputItem(_json = json)
+                }
+                "function_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseFunctionToolCall>())
+                        ?.let { BetaResponseInputItem(functionCall = it, _json = json) }
+                        ?: BetaResponseInputItem(_json = json)
+                }
+                "function_call_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<FunctionCallOutput>())?.let {
+                        BetaResponseInputItem(functionCallOutput = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "agent_message" -> {
+                    return tryDeserialize(node, jacksonTypeRef<AgentMessage>())?.let {
+                        BetaResponseInputItem(agentMessage = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "multi_agent_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<MultiAgentCall>())?.let {
+                        BetaResponseInputItem(multiAgentCall = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "multi_agent_call_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<MultiAgentCallOutput>())?.let {
+                        BetaResponseInputItem(multiAgentCallOutput = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "tool_search_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ToolSearchCall>())?.let {
+                        BetaResponseInputItem(toolSearchCall = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "tool_search_output" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseToolSearchOutputItemParam>(),
+                        )
+                        ?.let { BetaResponseInputItem(toolSearchOutput = it, _json = json) }
+                        ?: BetaResponseInputItem(_json = json)
+                }
+                "additional_tools" -> {
+                    return tryDeserialize(node, jacksonTypeRef<AdditionalTools>())?.let {
+                        BetaResponseInputItem(additionalTools = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "reasoning" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseReasoningItem>())?.let {
+                        BetaResponseInputItem(reasoning = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "compaction" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseCompactionItemParam>())
+                        ?.let { BetaResponseInputItem(compaction = it, _json = json) }
+                        ?: BetaResponseInputItem(_json = json)
+                }
+                "image_generation_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ImageGenerationCall>())?.let {
+                        BetaResponseInputItem(imageGenerationCall = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "code_interpreter_call" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCodeInterpreterToolCall>(),
+                        )
+                        ?.let { BetaResponseInputItem(codeInterpreterCall = it, _json = json) }
+                        ?: BetaResponseInputItem(_json = json)
+                }
+                "local_shell_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<LocalShellCall>())?.let {
+                        BetaResponseInputItem(localShellCall = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "local_shell_call_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<LocalShellCallOutput>())?.let {
+                        BetaResponseInputItem(localShellCallOutput = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "shell_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ShellCall>())?.let {
+                        BetaResponseInputItem(shellCall = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "shell_call_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ShellCallOutput>())?.let {
+                        BetaResponseInputItem(shellCallOutput = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "apply_patch_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ApplyPatchCall>())?.let {
+                        BetaResponseInputItem(applyPatchCall = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "apply_patch_call_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ApplyPatchCallOutput>())?.let {
+                        BetaResponseInputItem(applyPatchCallOutput = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "mcp_list_tools" -> {
+                    return tryDeserialize(node, jacksonTypeRef<McpListTools>())?.let {
+                        BetaResponseInputItem(mcpListTools = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "mcp_approval_request" -> {
+                    return tryDeserialize(node, jacksonTypeRef<McpApprovalRequest>())?.let {
+                        BetaResponseInputItem(mcpApprovalRequest = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "mcp_approval_response" -> {
+                    return tryDeserialize(node, jacksonTypeRef<McpApprovalResponse>())?.let {
+                        BetaResponseInputItem(mcpApprovalResponse = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "mcp_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<McpCall>())?.let {
+                        BetaResponseInputItem(mcpCall = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "custom_tool_call_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseCustomToolCallOutput>())
+                        ?.let { BetaResponseInputItem(customToolCallOutput = it, _json = json) }
+                        ?: BetaResponseInputItem(_json = json)
+                }
+                "custom_tool_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseCustomToolCall>())?.let {
+                        BetaResponseInputItem(customToolCall = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "compaction_trigger" -> {
+                    return tryDeserialize(node, jacksonTypeRef<CompactionTrigger>())?.let {
+                        BetaResponseInputItem(compactionTrigger = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "item_reference" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ItemReference>())?.let {
+                        BetaResponseInputItem(itemReference = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "program" -> {
+                    return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                        BetaResponseInputItem(program = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+                "program_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ProgramOutput>())?.let {
+                        BetaResponseInputItem(programOutput = it, _json = json)
+                    } ?: BetaResponseInputItem(_json = json)
+                }
+            }
+
+            return BetaResponseInputItem(_json = json)
+        }
+    }
+
+    internal class Serializer :
+        BaseSerializer<BetaResponseInputItem>(BetaResponseInputItem::class) {
+
+        override fun serialize(
+            value: BetaResponseInputItem,
+            generator: JsonGenerator,
+            provider: SerializerProvider,
+        ) {
+            when {
+                value.betaEasyInputMessage != null ->
+                    generator.writeObject(value.betaEasyInputMessage)
+                value.message != null -> generator.writeObject(value.message)
+                value.betaResponseOutputMessage != null ->
+                    generator.writeObject(value.betaResponseOutputMessage)
+                value.fileSearchCall != null -> generator.writeObject(value.fileSearchCall)
+                value.computerCall != null -> generator.writeObject(value.computerCall)
+                value.computerCallOutput != null -> generator.writeObject(value.computerCallOutput)
+                value.webSearchCall != null -> generator.writeObject(value.webSearchCall)
+                value.functionCall != null -> generator.writeObject(value.functionCall)
+                value.functionCallOutput != null -> generator.writeObject(value.functionCallOutput)
+                value.agentMessage != null -> generator.writeObject(value.agentMessage)
+                value.multiAgentCall != null -> generator.writeObject(value.multiAgentCall)
+                value.multiAgentCallOutput != null ->
+                    generator.writeObject(value.multiAgentCallOutput)
+                value.toolSearchCall != null -> generator.writeObject(value.toolSearchCall)
+                value.toolSearchOutput != null -> generator.writeObject(value.toolSearchOutput)
+                value.additionalTools != null -> generator.writeObject(value.additionalTools)
+                value.reasoning != null -> generator.writeObject(value.reasoning)
+                value.compaction != null -> generator.writeObject(value.compaction)
+                value.imageGenerationCall != null ->
+                    generator.writeObject(value.imageGenerationCall)
+                value.codeInterpreterCall != null ->
+                    generator.writeObject(value.codeInterpreterCall)
+                value.localShellCall != null -> generator.writeObject(value.localShellCall)
+                value.localShellCallOutput != null ->
+                    generator.writeObject(value.localShellCallOutput)
+                value.shellCall != null -> generator.writeObject(value.shellCall)
+                value.shellCallOutput != null -> generator.writeObject(value.shellCallOutput)
+                value.applyPatchCall != null -> generator.writeObject(value.applyPatchCall)
+                value.applyPatchCallOutput != null ->
+                    generator.writeObject(value.applyPatchCallOutput)
+                value.mcpListTools != null -> generator.writeObject(value.mcpListTools)
+                value.mcpApprovalRequest != null -> generator.writeObject(value.mcpApprovalRequest)
+                value.mcpApprovalResponse != null ->
+                    generator.writeObject(value.mcpApprovalResponse)
+                value.mcpCall != null -> generator.writeObject(value.mcpCall)
+                value.customToolCallOutput != null ->
+                    generator.writeObject(value.customToolCallOutput)
+                value.customToolCall != null -> generator.writeObject(value.customToolCall)
+                value.compactionTrigger != null -> generator.writeObject(value.compactionTrigger)
+                value.itemReference != null -> generator.writeObject(value.itemReference)
+                value.program != null -> generator.writeObject(value.program)
+                value.programOutput != null -> generator.writeObject(value.programOutput)
+                value._json != null -> generator.writeObject(value._json)
+                else -> throw IllegalStateException("Invalid BetaResponseInputItem")
+            }
+        }
+    }
+
+    /**
+     * A message input to the model with a role indicating instruction following hierarchy.
+     * Instructions given with the `developer` or `system` role take precedence over instructions
+     * given with the `user` role.
+     */
+    class Message
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val content: JsonField<List<BetaResponseInputContent>>,
+        private val role: JsonField<Role>,
+        private val agent: JsonField<Agent>,
+        private val status: JsonField<Status>,
+        private val type: JsonField<Type>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("content")
+            @ExcludeMissing
+            content: JsonField<List<BetaResponseInputContent>> = JsonMissing.of(),
+            @JsonProperty("role") @ExcludeMissing role: JsonField<Role> = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
+        ) : this(content, role, agent, status, type, mutableMapOf())
+
+        /**
+         * A list of one or many input items to the model, containing different content types.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun content(): List<BetaResponseInputContent> = content.getRequired("content")
+
+        /**
+         * The role of the message input. One of `user`, `system`, or `developer`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun role(): Role = role.getRequired("role")
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * The status of item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+         * items are returned via API.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun status(): Optional<Status> = status.getOptional("status")
+
+        /**
+         * The type of the message input. Always set to `message`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun type(): Optional<Type> = type.getOptional("type")
+
+        /**
+         * Returns the raw JSON value of [content].
+         *
+         * Unlike [content], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("content")
+        @ExcludeMissing
+        fun _content(): JsonField<List<BetaResponseInputContent>> = content
+
+        /**
+         * Returns the raw JSON value of [role].
+         *
+         * Unlike [role], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("role") @ExcludeMissing fun _role(): JsonField<Role> = role
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        /**
+         * Returns the raw JSON value of [type].
+         *
+         * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Message].
+             *
+             * The following fields are required:
+             * ```java
+             * .content()
+             * .role()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Message]. */
+        class Builder internal constructor() {
+
+            private var content: JsonField<MutableList<BetaResponseInputContent>>? = null
+            private var role: JsonField<Role>? = null
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var status: JsonField<Status> = JsonMissing.of()
+            private var type: JsonField<Type> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(message: Message) = apply {
+                content = message.content.map { it.toMutableList() }
+                role = message.role
+                agent = message.agent
+                status = message.status
+                type = message.type
+                additionalProperties = message.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * A list of one or many input items to the model, containing different content types.
+             */
+            fun content(content: List<BetaResponseInputContent>) = content(JsonField.of(content))
+
+            /**
+             * Sets [Builder.content] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.content] with a well-typed
+             * `List<BetaResponseInputContent>` value instead. This method is primarily for setting
+             * the field to an undocumented or not yet supported value.
+             */
+            fun content(content: JsonField<List<BetaResponseInputContent>>) = apply {
+                this.content = content.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [BetaResponseInputContent] to [Builder.content].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addContent(content: BetaResponseInputContent) = apply {
+                this.content =
+                    (this.content ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("content", it).add(content)
+                    }
+            }
+
+            /**
+             * Alias for calling [addContent] with
+             * `BetaResponseInputContent.ofInputText(inputText)`.
+             */
+            fun addContent(inputText: BetaResponseInputText) =
+                addContent(BetaResponseInputContent.ofInputText(inputText))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * BetaResponseInputText.builder()
+             *     .text(text)
+             *     .build()
+             * ```
+             */
+            fun addInputTextContent(text: String) =
+                addContent(BetaResponseInputText.builder().text(text).build())
+
+            /**
+             * Alias for calling [addContent] with
+             * `BetaResponseInputContent.ofInputImage(inputImage)`.
+             */
+            fun addContent(inputImage: BetaResponseInputImage) =
+                addContent(BetaResponseInputContent.ofInputImage(inputImage))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * BetaResponseInputImage.builder()
+             *     .detail(detail)
+             *     .build()
+             * ```
+             */
+            fun addInputImageContent(detail: BetaResponseInputImage.Detail) =
+                addContent(BetaResponseInputImage.builder().detail(detail).build())
+
+            /**
+             * Alias for calling [addContent] with
+             * `BetaResponseInputContent.ofInputFile(inputFile)`.
+             */
+            fun addContent(inputFile: BetaResponseInputFile) =
+                addContent(BetaResponseInputContent.ofInputFile(inputFile))
+
+            /** The role of the message input. One of `user`, `system`, or `developer`. */
+            fun role(role: Role) = role(JsonField.of(role))
+
+            /**
+             * Sets [Builder.role] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.role] with a well-typed [Role] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun role(role: JsonField<Role>) = apply { this.role = role }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /**
+             * The status of item. One of `in_progress`, `completed`, or `incomplete`. Populated
+             * when items are returned via API.
+             */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /** The type of the message input. Always set to `message`. */
+            fun type(type: Type) = type(JsonField.of(type))
+
+            /**
+             * Sets [Builder.type] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.type] with a well-typed [Type] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun type(type: JsonField<Type>) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Message].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .content()
+             * .role()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Message =
+                Message(
+                    checkRequired("content", content).map { it.toImmutable() },
+                    checkRequired("role", role),
+                    agent,
+                    status,
+                    type,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Message = apply {
+            if (validated) {
+                return@apply
+            }
+
+            content().forEach { it.validate() }
+            role().validate()
+            agent().ifPresent { it.validate() }
+            status().ifPresent { it.validate() }
+            type().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (content.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (role.asKnown().getOrNull()?.validity() ?: 0) +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                (type.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The role of the message input. One of `user`, `system`, or `developer`. */
+        class Role @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val USER = of("user")
+
+                @JvmField val SYSTEM = of("system")
+
+                @JvmField val DEVELOPER = of("developer")
+
+                @JvmStatic fun of(value: String) = Role(JsonField.of(value))
+            }
+
+            /** An enum containing [Role]'s known values. */
+            enum class Known {
+                USER,
+                SYSTEM,
+                DEVELOPER,
+            }
+
+            /**
+             * An enum containing [Role]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Role] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                USER,
+                SYSTEM,
+                DEVELOPER,
+                /** An enum member indicating that [Role] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    USER -> Value.USER
+                    SYSTEM -> Value.SYSTEM
+                    DEVELOPER -> Value.DEVELOPER
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    USER -> Known.USER
+                    SYSTEM -> Known.SYSTEM
+                    DEVELOPER -> Known.DEVELOPER
+                    else -> throw OpenAIInvalidDataException("Unknown Role: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Role = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Role && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        /**
+         * The status of item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+         * items are returned via API.
+         */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The type of the message input. Always set to `message`. */
+        class Type @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val MESSAGE = of("message")
+
+                @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+            }
+
+            /** An enum containing [Type]'s known values. */
+            enum class Known {
+                MESSAGE
+            }
+
+            /**
+             * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Type] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                MESSAGE,
+                /** An enum member indicating that [Type] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    MESSAGE -> Value.MESSAGE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    MESSAGE -> Known.MESSAGE
+                    else -> throw OpenAIInvalidDataException("Unknown Type: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Type = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Type && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Message &&
+                content == other.content &&
+                role == other.role &&
+                agent == other.agent &&
+                status == other.status &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(content, role, agent, status, type, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Message{content=$content, role=$role, agent=$agent, status=$status, type=$type, additionalProperties=$additionalProperties}"
+    }
+
+    /** The output of a computer tool call. */
+    class ComputerCallOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val callId: JsonField<String>,
+        private val output: JsonField<BetaResponseComputerToolCallOutputScreenshot>,
+        private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val acknowledgedSafetyChecks: JsonField<List<AcknowledgedSafetyCheck>>,
+        private val agent: JsonField<Agent>,
+        private val status: JsonField<Status>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("output")
+            @ExcludeMissing
+            output: JsonField<BetaResponseComputerToolCallOutputScreenshot> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("acknowledged_safety_checks")
+            @ExcludeMissing
+            acknowledgedSafetyChecks: JsonField<List<AcknowledgedSafetyCheck>> = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        ) : this(callId, output, type, id, acknowledgedSafetyChecks, agent, status, mutableMapOf())
+
+        /**
+         * The ID of the computer tool call that produced the output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * A computer screenshot image used with the computer use tool.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun output(): BetaResponseComputerToolCallOutputScreenshot = output.getRequired("output")
+
+        /**
+         * The type of the computer tool call output. Always `computer_call_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("computer_call_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The ID of the computer tool call output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun id(): Optional<String> = id.getOptional("id")
+
+        /**
+         * The safety checks reported by the API that have been acknowledged by the developer.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun acknowledgedSafetyChecks(): Optional<List<AcknowledgedSafetyCheck>> =
+            acknowledgedSafetyChecks.getOptional("acknowledged_safety_checks")
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * The status of the message input. One of `in_progress`, `completed`, or `incomplete`.
+         * Populated when input items are returned via API.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun status(): Optional<Status> = status.getOptional("status")
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output")
+        @ExcludeMissing
+        fun _output(): JsonField<BetaResponseComputerToolCallOutputScreenshot> = output
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [acknowledgedSafetyChecks].
+         *
+         * Unlike [acknowledgedSafetyChecks], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @JsonProperty("acknowledged_safety_checks")
+        @ExcludeMissing
+        fun _acknowledgedSafetyChecks(): JsonField<List<AcknowledgedSafetyCheck>> =
+            acknowledgedSafetyChecks
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ComputerCallOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .callId()
+             * .output()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ComputerCallOutput]. */
+        class Builder internal constructor() {
+
+            private var callId: JsonField<String>? = null
+            private var output: JsonField<BetaResponseComputerToolCallOutputScreenshot>? = null
+            private var type: JsonValue = JsonValue.from("computer_call_output")
+            private var id: JsonField<String> = JsonMissing.of()
+            private var acknowledgedSafetyChecks: JsonField<MutableList<AcknowledgedSafetyCheck>>? =
+                null
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var status: JsonField<Status> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(computerCallOutput: ComputerCallOutput) = apply {
+                callId = computerCallOutput.callId
+                output = computerCallOutput.output
+                type = computerCallOutput.type
+                id = computerCallOutput.id
+                acknowledgedSafetyChecks =
+                    computerCallOutput.acknowledgedSafetyChecks.map { it.toMutableList() }
+                agent = computerCallOutput.agent
+                status = computerCallOutput.status
+                additionalProperties = computerCallOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The ID of the computer tool call that produced the output. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** A computer screenshot image used with the computer use tool. */
+            fun output(output: BetaResponseComputerToolCallOutputScreenshot) =
+                output(JsonField.of(output))
+
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed
+             * [BetaResponseComputerToolCallOutputScreenshot] value instead. This method is
+             * primarily for setting the field to an undocumented or not yet supported value.
+             */
+            fun output(output: JsonField<BetaResponseComputerToolCallOutputScreenshot>) = apply {
+                this.output = output
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("computer_call_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The ID of the computer tool call output. */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /**
+             * The safety checks reported by the API that have been acknowledged by the developer.
+             */
+            fun acknowledgedSafetyChecks(acknowledgedSafetyChecks: List<AcknowledgedSafetyCheck>?) =
+                acknowledgedSafetyChecks(JsonField.ofNullable(acknowledgedSafetyChecks))
+
+            /**
+             * Alias for calling [Builder.acknowledgedSafetyChecks] with
+             * `acknowledgedSafetyChecks.orElse(null)`.
+             */
+            fun acknowledgedSafetyChecks(
+                acknowledgedSafetyChecks: Optional<List<AcknowledgedSafetyCheck>>
+            ) = acknowledgedSafetyChecks(acknowledgedSafetyChecks.getOrNull())
+
+            /**
+             * Sets [Builder.acknowledgedSafetyChecks] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.acknowledgedSafetyChecks] with a well-typed
+             * `List<AcknowledgedSafetyCheck>` value instead. This method is primarily for setting
+             * the field to an undocumented or not yet supported value.
+             */
+            fun acknowledgedSafetyChecks(
+                acknowledgedSafetyChecks: JsonField<List<AcknowledgedSafetyCheck>>
+            ) = apply {
+                this.acknowledgedSafetyChecks = acknowledgedSafetyChecks.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [AcknowledgedSafetyCheck] to [acknowledgedSafetyChecks].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addAcknowledgedSafetyCheck(acknowledgedSafetyCheck: AcknowledgedSafetyCheck) =
+                apply {
+                    acknowledgedSafetyChecks =
+                        (acknowledgedSafetyChecks ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("acknowledgedSafetyChecks", it).add(acknowledgedSafetyCheck)
+                        }
+                }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /**
+             * The status of the message input. One of `in_progress`, `completed`, or `incomplete`.
+             * Populated when input items are returned via API.
+             */
+            fun status(status: Status?) = status(JsonField.ofNullable(status))
+
+            /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+            fun status(status: Optional<Status>) = status(status.getOrNull())
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ComputerCallOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .callId()
+             * .output()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ComputerCallOutput =
+                ComputerCallOutput(
+                    checkRequired("callId", callId),
+                    checkRequired("output", output),
+                    type,
+                    id,
+                    (acknowledgedSafetyChecks ?: JsonMissing.of()).map { it.toImmutable() },
+                    agent,
+                    status,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ComputerCallOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            callId()
+            output().validate()
+            _type().let {
+                if (it != JsonValue.from("computer_call_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            id()
+            acknowledgedSafetyChecks().ifPresent { it.forEach { it.validate() } }
+            agent().ifPresent { it.validate() }
+            status().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (callId.asKnown().isPresent) 1 else 0) +
+                (output.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("computer_call_output")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (acknowledgedSafetyChecks.asKnown().getOrNull()?.sumOf { it.validity().toInt() }
+                    ?: 0) +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** A pending safety check for the computer call. */
+        class AcknowledgedSafetyCheck
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val id: JsonField<String>,
+            private val code: JsonField<String>,
+            private val message: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("code") @ExcludeMissing code: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("message")
+                @ExcludeMissing
+                message: JsonField<String> = JsonMissing.of(),
+            ) : this(id, code, message, mutableMapOf())
+
+            /**
+             * The ID of the pending safety check.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun id(): String = id.getRequired("id")
+
+            /**
+             * The type of the pending safety check.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun code(): Optional<String> = code.getOptional("code")
+
+            /**
+             * Details about the pending safety check.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun message(): Optional<String> = message.getOptional("message")
+
+            /**
+             * Returns the raw JSON value of [id].
+             *
+             * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+            /**
+             * Returns the raw JSON value of [code].
+             *
+             * Unlike [code], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<String> = code
+
+            /**
+             * Returns the raw JSON value of [message].
+             *
+             * Unlike [message], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("message") @ExcludeMissing fun _message(): JsonField<String> = message
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of
+                 * [AcknowledgedSafetyCheck].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .id()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [AcknowledgedSafetyCheck]. */
+            class Builder internal constructor() {
+
+                private var id: JsonField<String>? = null
+                private var code: JsonField<String> = JsonMissing.of()
+                private var message: JsonField<String> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(acknowledgedSafetyCheck: AcknowledgedSafetyCheck) = apply {
+                    id = acknowledgedSafetyCheck.id
+                    code = acknowledgedSafetyCheck.code
+                    message = acknowledgedSafetyCheck.message
+                    additionalProperties =
+                        acknowledgedSafetyCheck.additionalProperties.toMutableMap()
+                }
+
+                /** The ID of the pending safety check. */
+                fun id(id: String) = id(JsonField.of(id))
+
+                /**
+                 * Sets [Builder.id] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.id] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun id(id: JsonField<String>) = apply { this.id = id }
+
+                /** The type of the pending safety check. */
+                fun code(code: String?) = code(JsonField.ofNullable(code))
+
+                /** Alias for calling [Builder.code] with `code.orElse(null)`. */
+                fun code(code: Optional<String>) = code(code.getOrNull())
+
+                /**
+                 * Sets [Builder.code] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.code] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun code(code: JsonField<String>) = apply { this.code = code }
+
+                /** Details about the pending safety check. */
+                fun message(message: String?) = message(JsonField.ofNullable(message))
+
+                /** Alias for calling [Builder.message] with `message.orElse(null)`. */
+                fun message(message: Optional<String>) = message(message.getOrNull())
+
+                /**
+                 * Sets [Builder.message] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.message] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun message(message: JsonField<String>) = apply { this.message = message }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [AcknowledgedSafetyCheck].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .id()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): AcknowledgedSafetyCheck =
+                    AcknowledgedSafetyCheck(
+                        checkRequired("id", id),
+                        code,
+                        message,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): AcknowledgedSafetyCheck = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                id()
+                code()
+                message()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (id.asKnown().isPresent) 1 else 0) +
+                    (if (code.asKnown().isPresent) 1 else 0) +
+                    (if (message.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is AcknowledgedSafetyCheck &&
+                    id == other.id &&
+                    code == other.code &&
+                    message == other.message &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(id, code, message, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "AcknowledgedSafetyCheck{id=$id, code=$code, message=$message, additionalProperties=$additionalProperties}"
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        /**
+         * The status of the message input. One of `in_progress`, `completed`, or `incomplete`.
+         * Populated when input items are returned via API.
+         */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ComputerCallOutput &&
+                callId == other.callId &&
+                output == other.output &&
+                type == other.type &&
+                id == other.id &&
+                acknowledgedSafetyChecks == other.acknowledgedSafetyChecks &&
+                agent == other.agent &&
+                status == other.status &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                callId,
+                output,
+                type,
+                id,
+                acknowledgedSafetyChecks,
+                agent,
+                status,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ComputerCallOutput{callId=$callId, output=$output, type=$type, id=$id, acknowledgedSafetyChecks=$acknowledgedSafetyChecks, agent=$agent, status=$status, additionalProperties=$additionalProperties}"
+    }
+
+    /** The output of a function tool call. */
+    class FunctionCallOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val callId: JsonField<String>,
+        private val output: JsonField<Output>,
+        private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val agent: JsonField<Agent>,
+        private val caller: JsonField<Caller>,
+        private val status: JsonField<Status>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("output") @ExcludeMissing output: JsonField<Output> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        ) : this(callId, output, type, id, agent, caller, status, mutableMapOf())
+
+        /**
+         * The unique ID of the function tool call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * Text, image, or file output of the function tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun output(): Output = output.getRequired("output")
+
+        /**
+         * The type of the function tool call output. Always `function_call_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("function_call_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The unique ID of the function tool call output. Populated when this item is returned via
+         * API.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun id(): Optional<String> = id.getOptional("id")
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * The execution context that produced this tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun caller(): Optional<Caller> = caller.getOptional("caller")
+
+        /**
+         * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated
+         * when items are returned via API.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun status(): Optional<Status> = status.getOptional("status")
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<Output> = output
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [caller].
+         *
+         * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [FunctionCallOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .callId()
+             * .output()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [FunctionCallOutput]. */
+        class Builder internal constructor() {
+
+            private var callId: JsonField<String>? = null
+            private var output: JsonField<Output>? = null
+            private var type: JsonValue = JsonValue.from("function_call_output")
+            private var id: JsonField<String> = JsonMissing.of()
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var caller: JsonField<Caller> = JsonMissing.of()
+            private var status: JsonField<Status> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(functionCallOutput: FunctionCallOutput) = apply {
+                callId = functionCallOutput.callId
+                output = functionCallOutput.output
+                type = functionCallOutput.type
+                id = functionCallOutput.id
+                agent = functionCallOutput.agent
+                caller = functionCallOutput.caller
+                status = functionCallOutput.status
+                additionalProperties = functionCallOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the function tool call generated by the model. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** Text, image, or file output of the function tool call. */
+            fun output(output: Output) = output(JsonField.of(output))
+
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed [Output] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun output(output: JsonField<Output>) = apply { this.output = output }
+
+            /** Alias for calling [output] with `Output.ofString(string)`. */
+            fun output(string: String) = output(Output.ofString(string))
+
+            /**
+             * Alias for calling [output] with
+             * `Output.ofBetaResponseFunctionCallOutputItemList(betaResponseFunctionCallOutputItemList)`.
+             */
+            fun outputOfBetaResponseFunctionCallOutputItemList(
+                betaResponseFunctionCallOutputItemList: List<BetaResponseFunctionCallOutputItem>
+            ) =
+                output(
+                    Output.ofBetaResponseFunctionCallOutputItemList(
+                        betaResponseFunctionCallOutputItemList
+                    )
+                )
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("function_call_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /**
+             * The unique ID of the function tool call output. Populated when this item is returned
+             * via API.
+             */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /** The execution context that produced this tool call. */
+            fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+            /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+            fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+            /**
+             * Sets [Builder.caller] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.caller] with a well-typed [Caller] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+            /** Alias for calling [caller] with `Caller.ofDirect()`. */
+            fun callerDirect() = caller(Caller.ofDirect())
+
+            /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+            fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+            /**
+             * Alias for calling [caller] with the following:
+             * ```java
+             * Caller.Program.builder()
+             *     .callerId(callerId)
+             *     .build()
+             * ```
+             */
+            fun programCaller(callerId: String) =
+                caller(Caller.Program.builder().callerId(callerId).build())
+
+            /**
+             * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated
+             * when items are returned via API.
+             */
+            fun status(status: Status?) = status(JsonField.ofNullable(status))
+
+            /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+            fun status(status: Optional<Status>) = status(status.getOrNull())
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [FunctionCallOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .callId()
+             * .output()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): FunctionCallOutput =
+                FunctionCallOutput(
+                    checkRequired("callId", callId),
+                    checkRequired("output", output),
+                    type,
+                    id,
+                    agent,
+                    caller,
+                    status,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): FunctionCallOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            callId()
+            output().validate()
+            _type().let {
+                if (it != JsonValue.from("function_call_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            id()
+            agent().ifPresent { it.validate() }
+            caller().ifPresent { it.validate() }
+            status().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (callId.asKnown().isPresent) 1 else 0) +
+                (output.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("function_call_output")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (caller.asKnown().getOrNull()?.validity() ?: 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** Text, image, or file output of the function tool call. */
+        @JsonDeserialize(using = Output.Deserializer::class)
+        @JsonSerialize(using = Output.Serializer::class)
+        class Output
+        private constructor(
+            private val string: String? = null,
+            private val betaResponseFunctionCallOutputItemList:
+                List<BetaResponseFunctionCallOutputItem>? =
+                null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /** A JSON string of the output of the function tool call. */
+            fun string(): Optional<String> = Optional.ofNullable(string)
+
+            /** An array of content outputs (text, image, file) for the function tool call. */
+            fun betaResponseFunctionCallOutputItemList():
+                Optional<List<BetaResponseFunctionCallOutputItem>> =
+                Optional.ofNullable(betaResponseFunctionCallOutputItemList)
+
+            fun isString(): Boolean = string != null
+
+            fun isBetaResponseFunctionCallOutputItemList(): Boolean =
+                betaResponseFunctionCallOutputItemList != null
+
+            /** A JSON string of the output of the function tool call. */
+            fun asString(): String = string.getOrThrow("string")
+
+            /** An array of content outputs (text, image, file) for the function tool call. */
+            fun asBetaResponseFunctionCallOutputItemList():
+                List<BetaResponseFunctionCallOutputItem> =
+                betaResponseFunctionCallOutputItemList.getOrThrow(
+                    "betaResponseFunctionCallOutputItemList"
+                )
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = output.accept(new Output.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitString(String string) {
+             *         return Optional.of(string.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    string != null -> visitor.visitString(string)
+                    betaResponseFunctionCallOutputItemList != null ->
+                        visitor.visitBetaResponseFunctionCallOutputItemList(
+                            betaResponseFunctionCallOutputItemList
+                        )
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Output = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitString(string: String) {}
+
+                        override fun visitBetaResponseFunctionCallOutputItemList(
+                            betaResponseFunctionCallOutputItemList:
+                                List<BetaResponseFunctionCallOutputItem>
+                        ) {
+                            betaResponseFunctionCallOutputItemList.forEach { it.validate() }
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitString(string: String) = 1
+
+                        override fun visitBetaResponseFunctionCallOutputItemList(
+                            betaResponseFunctionCallOutputItemList:
+                                List<BetaResponseFunctionCallOutputItem>
+                        ) = betaResponseFunctionCallOutputItemList.sumOf { it.validity().toInt() }
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Output &&
+                    string == other.string &&
+                    betaResponseFunctionCallOutputItemList ==
+                        other.betaResponseFunctionCallOutputItemList
+            }
+
+            override fun hashCode(): Int =
+                Objects.hash(string, betaResponseFunctionCallOutputItemList)
+
+            override fun toString(): String =
+                when {
+                    string != null -> "Output{string=$string}"
+                    betaResponseFunctionCallOutputItemList != null ->
+                        "Output{betaResponseFunctionCallOutputItemList=$betaResponseFunctionCallOutputItemList}"
+                    _json != null -> "Output{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Output")
+                }
+
+            companion object {
+
+                /** A JSON string of the output of the function tool call. */
+                @JvmStatic fun ofString(string: String) = Output(string = string)
+
+                /** An array of content outputs (text, image, file) for the function tool call. */
+                @JvmStatic
+                fun ofBetaResponseFunctionCallOutputItemList(
+                    betaResponseFunctionCallOutputItemList: List<BetaResponseFunctionCallOutputItem>
+                ) =
+                    Output(
+                        betaResponseFunctionCallOutputItemList =
+                            betaResponseFunctionCallOutputItemList.toImmutable()
+                    )
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Output] to a value of type [T].
+             */
+            interface Visitor<out T> {
+
+                /** A JSON string of the output of the function tool call. */
+                fun visitString(string: String): T
+
+                /** An array of content outputs (text, image, file) for the function tool call. */
+                fun visitBetaResponseFunctionCallOutputItemList(
+                    betaResponseFunctionCallOutputItemList: List<BetaResponseFunctionCallOutputItem>
+                ): T
+
+                /**
+                 * Maps an unknown variant of [Output] to a value of type [T].
+                 *
+                 * An instance of [Output] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Output: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Output>(Output::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Output {
+                    val json = JsonValue.fromJsonNode(node)
+
+                    val bestMatches =
+                        sequenceOf(
+                                tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                    Output(string = it, _json = json)
+                                },
+                                tryDeserialize(
+                                        node,
+                                        jacksonTypeRef<List<BetaResponseFunctionCallOutputItem>>(),
+                                    )
+                                    ?.let {
+                                        Output(
+                                            betaResponseFunctionCallOutputItemList = it,
+                                            _json = json,
+                                        )
+                                    },
+                            )
+                            .filterNotNull()
+                            .allMaxBy { it.validity() }
+                            .toList()
+                    return when (bestMatches.size) {
+                        // This can happen if what we're deserializing is completely incompatible
+                        // with all the possible variants (e.g. deserializing from boolean).
+                        0 -> Output(_json = json)
+                        1 -> bestMatches.single()
+                        // If there's more than one match with the highest validity, then use the
+                        // first completely valid match, or simply the first match if none are
+                        // completely valid.
+                        else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                    }
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Output>(Output::class) {
+
+                override fun serialize(
+                    value: Output,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.string != null -> generator.writeObject(value.string)
+                        value.betaResponseFunctionCallOutputItemList != null ->
+                            generator.writeObject(value.betaResponseFunctionCallOutputItemList)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Output")
+                    }
+                }
+            }
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        /** The execution context that produced this tool call. */
+        @JsonDeserialize(using = Caller.Deserializer::class)
+        @JsonSerialize(using = Caller.Serializer::class)
+        class Caller
+        private constructor(
+            private val direct: JsonValue? = null,
+            private val program: Program? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+            fun program(): Optional<Program> = Optional.ofNullable(program)
+
+            fun isDirect(): Boolean = direct != null
+
+            fun isProgram(): Boolean = program != null
+
+            fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+            fun asProgram(): Program = program.getOrThrow("program")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitDirect(JsonValue direct) {
+             *         return Optional.of(direct.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    direct != null -> visitor.visitDirect(direct)
+                    program != null -> visitor.visitProgram(program)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Caller = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitDirect(direct: JsonValue) {
+                            direct.let {
+                                if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                    throw OpenAIInvalidDataException(
+                                        "'direct' is invalid, received $it"
+                                    )
+                                }
+                            }
+                        }
+
+                        override fun visitProgram(program: Program) {
+                            program.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitDirect(direct: JsonValue) =
+                            direct.let {
+                                if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0
+                            }
+
+                        override fun visitProgram(program: Program) = program.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Caller && direct == other.direct && program == other.program
+            }
+
+            override fun hashCode(): Int = Objects.hash(direct, program)
+
+            override fun toString(): String =
+                when {
+                    direct != null -> "Caller{direct=$direct}"
+                    program != null -> "Caller{program=$program}"
+                    _json != null -> "Caller{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+
+            companion object {
+
+                @JvmStatic
+                fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+                @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Caller] to a value of type [T].
+             */
+            interface Visitor<out T> {
+
+                fun visitDirect(direct: JsonValue): T
+
+                fun visitProgram(program: Program): T
+
+                /**
+                 * Maps an unknown variant of [Caller] to a value of type [T].
+                 *
+                 * An instance of [Caller] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Caller: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "direct" -> {
+                            return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let { Caller(direct = it, _json = json) }
+                                ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                        }
+                        "program" -> {
+                            return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                                Caller(program = it, _json = json)
+                            } ?: Caller(_json = json)
+                        }
+                    }
+
+                    return Caller(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+                override fun serialize(
+                    value: Caller,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.direct != null -> generator.writeObject(value.direct)
+                        value.program != null -> generator.writeObject(value.program)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Caller")
+                    }
+                }
+            }
+
+            class Program
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val callerId: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("caller_id")
+                    @ExcludeMissing
+                    callerId: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(callerId, type, mutableMapOf())
+
+                /**
+                 * The call ID of the program item that produced this tool call.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun callerId(): String = callerId.getRequired("caller_id")
+
+                /**
+                 * The caller type. Always `program`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [callerId].
+                 *
+                 * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                fun _callerId(): JsonField<String> = callerId
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Program].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Program]. */
+                class Builder internal constructor() {
+
+                    private var callerId: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("program")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(program: Program) = apply {
+                        callerId = program.callerId
+                        type = program.type
+                        additionalProperties = program.additionalProperties.toMutableMap()
+                    }
+
+                    /** The call ID of the program item that produced this tool call. */
+                    fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                    /**
+                     * Sets [Builder.callerId] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.callerId] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("program")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Program].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Program =
+                        Program(
+                            checkRequired("callerId", callerId),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Program = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    callerId()
+                    _type().let {
+                        if (it != JsonValue.from("program")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (callerId.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Program &&
+                        callerId == other.callerId &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(callerId, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        /**
+         * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated
+         * when items are returned via API.
+         */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is FunctionCallOutput &&
+                callId == other.callId &&
+                output == other.output &&
+                type == other.type &&
+                id == other.id &&
+                agent == other.agent &&
+                caller == other.caller &&
+                status == other.status &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(callId, output, type, id, agent, caller, status, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "FunctionCallOutput{callId=$callId, output=$output, type=$type, id=$id, agent=$agent, caller=$caller, status=$status, additionalProperties=$additionalProperties}"
+    }
+
+    /** A message routed between agents. */
+    class AgentMessage
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val author: JsonField<String>,
+        private val content: JsonField<List<Content>>,
+        private val recipient: JsonField<String>,
+        private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("author") @ExcludeMissing author: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("content")
+            @ExcludeMissing
+            content: JsonField<List<Content>> = JsonMissing.of(),
+            @JsonProperty("recipient")
+            @ExcludeMissing
+            recipient: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(author, content, recipient, type, id, agent, mutableMapOf())
+
+        /**
+         * The sending agent identity.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun author(): String = author.getRequired("author")
+
+        /**
+         * Plaintext, image, or encrypted content sent between agents.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun content(): List<Content> = content.getRequired("content")
+
+        /**
+         * The destination agent identity.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun recipient(): String = recipient.getRequired("recipient")
+
+        /**
+         * The item type. Always `agent_message`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("agent_message")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The unique ID of this agent message item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun id(): Optional<String> = id.getOptional("id")
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [author].
+         *
+         * Unlike [author], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("author") @ExcludeMissing fun _author(): JsonField<String> = author
+
+        /**
+         * Returns the raw JSON value of [content].
+         *
+         * Unlike [content], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("content") @ExcludeMissing fun _content(): JsonField<List<Content>> = content
+
+        /**
+         * Returns the raw JSON value of [recipient].
+         *
+         * Unlike [recipient], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("recipient") @ExcludeMissing fun _recipient(): JsonField<String> = recipient
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [AgentMessage].
+             *
+             * The following fields are required:
+             * ```java
+             * .author()
+             * .content()
+             * .recipient()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [AgentMessage]. */
+        class Builder internal constructor() {
+
+            private var author: JsonField<String>? = null
+            private var content: JsonField<MutableList<Content>>? = null
+            private var recipient: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("agent_message")
+            private var id: JsonField<String> = JsonMissing.of()
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agentMessage: AgentMessage) = apply {
+                author = agentMessage.author
+                content = agentMessage.content.map { it.toMutableList() }
+                recipient = agentMessage.recipient
+                type = agentMessage.type
+                id = agentMessage.id
+                agent = agentMessage.agent
+                additionalProperties = agentMessage.additionalProperties.toMutableMap()
+            }
+
+            /** The sending agent identity. */
+            fun author(author: String) = author(JsonField.of(author))
+
+            /**
+             * Sets [Builder.author] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.author] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun author(author: JsonField<String>) = apply { this.author = author }
+
+            /** Plaintext, image, or encrypted content sent between agents. */
+            fun content(content: List<Content>) = content(JsonField.of(content))
+
+            /**
+             * Sets [Builder.content] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.content] with a well-typed `List<Content>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun content(content: JsonField<List<Content>>) = apply {
+                this.content = content.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [Content] to [Builder.content].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addContent(content: Content) = apply {
+                this.content =
+                    (this.content ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("content", it).add(content)
+                    }
+            }
+
+            /** Alias for calling [addContent] with `Content.ofInputText(inputText)`. */
+            fun addContent(inputText: BetaResponseInputTextContent) =
+                addContent(Content.ofInputText(inputText))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * BetaResponseInputTextContent.builder()
+             *     .text(text)
+             *     .build()
+             * ```
+             */
+            fun addInputTextContent(text: String) =
+                addContent(BetaResponseInputTextContent.builder().text(text).build())
+
+            /** Alias for calling [addContent] with `Content.ofInputImage(inputImage)`. */
+            fun addContent(inputImage: BetaResponseInputImageContent) =
+                addContent(Content.ofInputImage(inputImage))
+
+            /** Alias for calling [addContent] with `Content.ofEncrypted(encrypted)`. */
+            fun addContent(encrypted: Content.EncryptedContent) =
+                addContent(Content.ofEncrypted(encrypted))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * Content.EncryptedContent.builder()
+             *     .encryptedContent(encryptedContent)
+             *     .build()
+             * ```
+             */
+            fun addEncryptedContent(encryptedContent: String) =
+                addContent(
+                    Content.EncryptedContent.builder().encryptedContent(encryptedContent).build()
+                )
+
+            /** The destination agent identity. */
+            fun recipient(recipient: String) = recipient(JsonField.of(recipient))
+
+            /**
+             * Sets [Builder.recipient] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.recipient] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun recipient(recipient: JsonField<String>) = apply { this.recipient = recipient }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("agent_message")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The unique ID of this agent message item. */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [AgentMessage].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .author()
+             * .content()
+             * .recipient()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): AgentMessage =
+                AgentMessage(
+                    checkRequired("author", author),
+                    checkRequired("content", content).map { it.toImmutable() },
+                    checkRequired("recipient", recipient),
+                    type,
+                    id,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): AgentMessage = apply {
+            if (validated) {
+                return@apply
+            }
+
+            author()
+            content().forEach { it.validate() }
+            recipient()
+            _type().let {
+                if (it != JsonValue.from("agent_message")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            id()
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (author.asKnown().isPresent) 1 else 0) +
+                (content.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (if (recipient.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("agent_message")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** A plaintext, image, or encrypted agent message content part. */
+        @JsonDeserialize(using = Content.Deserializer::class)
+        @JsonSerialize(using = Content.Serializer::class)
+        class Content
+        private constructor(
+            private val inputText: BetaResponseInputTextContent? = null,
+            private val inputImage: BetaResponseInputImageContent? = null,
+            private val encrypted: EncryptedContent? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /** A text input to the model. */
+            fun inputText(): Optional<BetaResponseInputTextContent> = Optional.ofNullable(inputText)
+
+            /**
+             * An image input to the model. Learn about
+             * [image inputs](https://platform.openai.com/docs/guides/vision)
+             */
+            fun inputImage(): Optional<BetaResponseInputImageContent> =
+                Optional.ofNullable(inputImage)
+
+            /**
+             * Opaque encrypted content that Responses API decrypts inside trusted model execution.
+             */
+            fun encrypted(): Optional<EncryptedContent> = Optional.ofNullable(encrypted)
+
+            fun isInputText(): Boolean = inputText != null
+
+            fun isInputImage(): Boolean = inputImage != null
+
+            fun isEncrypted(): Boolean = encrypted != null
+
+            /** A text input to the model. */
+            fun asInputText(): BetaResponseInputTextContent = inputText.getOrThrow("inputText")
+
+            /**
+             * An image input to the model. Learn about
+             * [image inputs](https://platform.openai.com/docs/guides/vision)
+             */
+            fun asInputImage(): BetaResponseInputImageContent = inputImage.getOrThrow("inputImage")
+
+            /**
+             * Opaque encrypted content that Responses API decrypts inside trusted model execution.
+             */
+            fun asEncrypted(): EncryptedContent = encrypted.getOrThrow("encrypted")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = content.accept(new Content.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitInputText(BetaResponseInputTextContent inputText) {
+             *         return Optional.of(inputText.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    inputText != null -> visitor.visitInputText(inputText)
+                    inputImage != null -> visitor.visitInputImage(inputImage)
+                    encrypted != null -> visitor.visitEncrypted(encrypted)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Content = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitInputText(inputText: BetaResponseInputTextContent) {
+                            inputText.validate()
+                        }
+
+                        override fun visitInputImage(inputImage: BetaResponseInputImageContent) {
+                            inputImage.validate()
+                        }
+
+                        override fun visitEncrypted(encrypted: EncryptedContent) {
+                            encrypted.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitInputText(inputText: BetaResponseInputTextContent) =
+                            inputText.validity()
+
+                        override fun visitInputImage(inputImage: BetaResponseInputImageContent) =
+                            inputImage.validity()
+
+                        override fun visitEncrypted(encrypted: EncryptedContent) =
+                            encrypted.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Content &&
+                    inputText == other.inputText &&
+                    inputImage == other.inputImage &&
+                    encrypted == other.encrypted
+            }
+
+            override fun hashCode(): Int = Objects.hash(inputText, inputImage, encrypted)
+
+            override fun toString(): String =
+                when {
+                    inputText != null -> "Content{inputText=$inputText}"
+                    inputImage != null -> "Content{inputImage=$inputImage}"
+                    encrypted != null -> "Content{encrypted=$encrypted}"
+                    _json != null -> "Content{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Content")
+                }
+
+            companion object {
+
+                /** A text input to the model. */
+                @JvmStatic
+                fun ofInputText(inputText: BetaResponseInputTextContent) =
+                    Content(inputText = inputText)
+
+                /**
+                 * An image input to the model. Learn about
+                 * [image inputs](https://platform.openai.com/docs/guides/vision)
+                 */
+                @JvmStatic
+                fun ofInputImage(inputImage: BetaResponseInputImageContent) =
+                    Content(inputImage = inputImage)
+
+                /**
+                 * Opaque encrypted content that Responses API decrypts inside trusted model
+                 * execution.
+                 */
+                @JvmStatic
+                fun ofEncrypted(encrypted: EncryptedContent) = Content(encrypted = encrypted)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Content] to a value of type
+             * [T].
+             */
+            interface Visitor<out T> {
+
+                /** A text input to the model. */
+                fun visitInputText(inputText: BetaResponseInputTextContent): T
+
+                /**
+                 * An image input to the model. Learn about
+                 * [image inputs](https://platform.openai.com/docs/guides/vision)
+                 */
+                fun visitInputImage(inputImage: BetaResponseInputImageContent): T
+
+                /**
+                 * Opaque encrypted content that Responses API decrypts inside trusted model
+                 * execution.
+                 */
+                fun visitEncrypted(encrypted: EncryptedContent): T
+
+                /**
+                 * Maps an unknown variant of [Content] to a value of type [T].
+                 *
+                 * An instance of [Content] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Content: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Content>(Content::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Content {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "input_text" -> {
+                            return tryDeserialize(
+                                    node,
+                                    jacksonTypeRef<BetaResponseInputTextContent>(),
+                                )
+                                ?.let { Content(inputText = it, _json = json) }
+                                ?: Content(_json = json)
+                        }
+                        "input_image" -> {
+                            return tryDeserialize(
+                                    node,
+                                    jacksonTypeRef<BetaResponseInputImageContent>(),
+                                )
+                                ?.let { Content(inputImage = it, _json = json) }
+                                ?: Content(_json = json)
+                        }
+                        "encrypted_content" -> {
+                            return tryDeserialize(node, jacksonTypeRef<EncryptedContent>())?.let {
+                                Content(encrypted = it, _json = json)
+                            } ?: Content(_json = json)
+                        }
+                    }
+
+                    return Content(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Content>(Content::class) {
+
+                override fun serialize(
+                    value: Content,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.inputText != null -> generator.writeObject(value.inputText)
+                        value.inputImage != null -> generator.writeObject(value.inputImage)
+                        value.encrypted != null -> generator.writeObject(value.encrypted)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Content")
+                    }
+                }
+            }
+
+            /**
+             * Opaque encrypted content that Responses API decrypts inside trusted model execution.
+             */
+            class EncryptedContent
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val encryptedContent: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("encrypted_content")
+                    @ExcludeMissing
+                    encryptedContent: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(encryptedContent, type, mutableMapOf())
+
+                /**
+                 * Opaque encrypted content.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun encryptedContent(): String = encryptedContent.getRequired("encrypted_content")
+
+                /**
+                 * The type of the input item. Always `encrypted_content`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("encrypted_content")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [encryptedContent].
+                 *
+                 * Unlike [encryptedContent], this method doesn't throw if the JSON field has an
+                 * unexpected type.
+                 */
+                @JsonProperty("encrypted_content")
+                @ExcludeMissing
+                fun _encryptedContent(): JsonField<String> = encryptedContent
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [EncryptedContent].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .encryptedContent()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [EncryptedContent]. */
+                class Builder internal constructor() {
+
+                    private var encryptedContent: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("encrypted_content")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(encryptedContent: EncryptedContent) = apply {
+                        this.encryptedContent = encryptedContent.encryptedContent
+                        type = encryptedContent.type
+                        additionalProperties = encryptedContent.additionalProperties.toMutableMap()
+                    }
+
+                    /** Opaque encrypted content. */
+                    fun encryptedContent(encryptedContent: String) =
+                        encryptedContent(JsonField.of(encryptedContent))
+
+                    /**
+                     * Sets [Builder.encryptedContent] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.encryptedContent] with a well-typed [String]
+                     * value instead. This method is primarily for setting the field to an
+                     * undocumented or not yet supported value.
+                     */
+                    fun encryptedContent(encryptedContent: JsonField<String>) = apply {
+                        this.encryptedContent = encryptedContent
+                    }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("encrypted_content")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [EncryptedContent].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .encryptedContent()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): EncryptedContent =
+                        EncryptedContent(
+                            checkRequired("encryptedContent", encryptedContent),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): EncryptedContent = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    encryptedContent()
+                    _type().let {
+                        if (it != JsonValue.from("encrypted_content")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (encryptedContent.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("encrypted_content")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is EncryptedContent &&
+                        encryptedContent == other.encryptedContent &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(encryptedContent, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "EncryptedContent{encryptedContent=$encryptedContent, type=$type, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AgentMessage &&
+                author == other.author &&
+                content == other.content &&
+                recipient == other.recipient &&
+                type == other.type &&
+                id == other.id &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(author, content, recipient, type, id, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "AgentMessage{author=$author, content=$content, recipient=$recipient, type=$type, id=$id, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    class MultiAgentCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val action: JsonField<Action>,
+        private val arguments: JsonField<String>,
+        private val callId: JsonField<String>,
+        private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
+            @JsonProperty("arguments")
+            @ExcludeMissing
+            arguments: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(action, arguments, callId, type, id, agent, mutableMapOf())
+
+        /**
+         * The multi-agent action that was executed.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun action(): Action = action.getRequired("action")
+
+        /**
+         * The action arguments as a JSON string.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun arguments(): String = arguments.getRequired("arguments")
+
+        /**
+         * The unique ID linking this call to its output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The item type. Always `multi_agent_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("multi_agent_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The unique ID of this multi-agent call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun id(): Optional<String> = id.getOptional("id")
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [action].
+         *
+         * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+
+        /**
+         * Returns the raw JSON value of [arguments].
+         *
+         * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [MultiAgentCall].
+             *
+             * The following fields are required:
+             * ```java
+             * .action()
+             * .arguments()
+             * .callId()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [MultiAgentCall]. */
+        class Builder internal constructor() {
+
+            private var action: JsonField<Action>? = null
+            private var arguments: JsonField<String>? = null
+            private var callId: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("multi_agent_call")
+            private var id: JsonField<String> = JsonMissing.of()
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(multiAgentCall: MultiAgentCall) = apply {
+                action = multiAgentCall.action
+                arguments = multiAgentCall.arguments
+                callId = multiAgentCall.callId
+                type = multiAgentCall.type
+                id = multiAgentCall.id
+                agent = multiAgentCall.agent
+                additionalProperties = multiAgentCall.additionalProperties.toMutableMap()
+            }
+
+            /** The multi-agent action that was executed. */
+            fun action(action: Action) = action(JsonField.of(action))
+
+            /**
+             * Sets [Builder.action] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.action] with a well-typed [Action] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun action(action: JsonField<Action>) = apply { this.action = action }
+
+            /** The action arguments as a JSON string. */
+            fun arguments(arguments: String) = arguments(JsonField.of(arguments))
+
+            /**
+             * Sets [Builder.arguments] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.arguments] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
+
+            /** The unique ID linking this call to its output. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("multi_agent_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The unique ID of this multi-agent call. */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [MultiAgentCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .action()
+             * .arguments()
+             * .callId()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): MultiAgentCall =
+                MultiAgentCall(
+                    checkRequired("action", action),
+                    checkRequired("arguments", arguments),
+                    checkRequired("callId", callId),
+                    type,
+                    id,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): MultiAgentCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            action().validate()
+            arguments()
+            callId()
+            _type().let {
+                if (it != JsonValue.from("multi_agent_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            id()
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (action.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (arguments.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("multi_agent_call")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The multi-agent action that was executed. */
+        class Action @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val SPAWN_AGENT = of("spawn_agent")
+
+                @JvmField val INTERRUPT_AGENT = of("interrupt_agent")
+
+                @JvmField val LIST_AGENTS = of("list_agents")
+
+                @JvmField val SEND_MESSAGE = of("send_message")
+
+                @JvmField val FOLLOWUP_TASK = of("followup_task")
+
+                @JvmField val WAIT_AGENT = of("wait_agent")
+
+                @JvmStatic fun of(value: String) = Action(JsonField.of(value))
+            }
+
+            /** An enum containing [Action]'s known values. */
+            enum class Known {
+                SPAWN_AGENT,
+                INTERRUPT_AGENT,
+                LIST_AGENTS,
+                SEND_MESSAGE,
+                FOLLOWUP_TASK,
+                WAIT_AGENT,
+            }
+
+            /**
+             * An enum containing [Action]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Action] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                SPAWN_AGENT,
+                INTERRUPT_AGENT,
+                LIST_AGENTS,
+                SEND_MESSAGE,
+                FOLLOWUP_TASK,
+                WAIT_AGENT,
+                /**
+                 * An enum member indicating that [Action] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    SPAWN_AGENT -> Value.SPAWN_AGENT
+                    INTERRUPT_AGENT -> Value.INTERRUPT_AGENT
+                    LIST_AGENTS -> Value.LIST_AGENTS
+                    SEND_MESSAGE -> Value.SEND_MESSAGE
+                    FOLLOWUP_TASK -> Value.FOLLOWUP_TASK
+                    WAIT_AGENT -> Value.WAIT_AGENT
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    SPAWN_AGENT -> Known.SPAWN_AGENT
+                    INTERRUPT_AGENT -> Known.INTERRUPT_AGENT
+                    LIST_AGENTS -> Known.LIST_AGENTS
+                    SEND_MESSAGE -> Known.SEND_MESSAGE
+                    FOLLOWUP_TASK -> Known.FOLLOWUP_TASK
+                    WAIT_AGENT -> Known.WAIT_AGENT
+                    else -> throw OpenAIInvalidDataException("Unknown Action: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Action = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Action && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is MultiAgentCall &&
+                action == other.action &&
+                arguments == other.arguments &&
+                callId == other.callId &&
+                type == other.type &&
+                id == other.id &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(action, arguments, callId, type, id, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "MultiAgentCall{action=$action, arguments=$arguments, callId=$callId, type=$type, id=$id, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    class MultiAgentCallOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val action: JsonField<Action>,
+        private val callId: JsonField<String>,
+        private val output: JsonField<List<Output>>,
+        private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("output")
+            @ExcludeMissing
+            output: JsonField<List<Output>> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(action, callId, output, type, id, agent, mutableMapOf())
+
+        /**
+         * The multi-agent action that produced this result.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun action(): Action = action.getRequired("action")
+
+        /**
+         * The unique ID of the multi-agent call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * Text output returned by the multi-agent action.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun output(): List<Output> = output.getRequired("output")
+
+        /**
+         * The item type. Always `multi_agent_call_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("multi_agent_call_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The unique ID of this multi-agent call output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun id(): Optional<String> = id.getOptional("id")
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [action].
+         *
+         * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<List<Output>> = output
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [MultiAgentCallOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .action()
+             * .callId()
+             * .output()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [MultiAgentCallOutput]. */
+        class Builder internal constructor() {
+
+            private var action: JsonField<Action>? = null
+            private var callId: JsonField<String>? = null
+            private var output: JsonField<MutableList<Output>>? = null
+            private var type: JsonValue = JsonValue.from("multi_agent_call_output")
+            private var id: JsonField<String> = JsonMissing.of()
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(multiAgentCallOutput: MultiAgentCallOutput) = apply {
+                action = multiAgentCallOutput.action
+                callId = multiAgentCallOutput.callId
+                output = multiAgentCallOutput.output.map { it.toMutableList() }
+                type = multiAgentCallOutput.type
+                id = multiAgentCallOutput.id
+                agent = multiAgentCallOutput.agent
+                additionalProperties = multiAgentCallOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The multi-agent action that produced this result. */
+            fun action(action: Action) = action(JsonField.of(action))
+
+            /**
+             * Sets [Builder.action] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.action] with a well-typed [Action] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun action(action: JsonField<Action>) = apply { this.action = action }
+
+            /** The unique ID of the multi-agent call. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** Text output returned by the multi-agent action. */
+            fun output(output: List<Output>) = output(JsonField.of(output))
+
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed `List<Output>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun output(output: JsonField<List<Output>>) = apply {
+                this.output = output.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [Output] to [Builder.output].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addOutput(output: Output) = apply {
+                this.output =
+                    (this.output ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("output", it).add(output)
+                    }
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("multi_agent_call_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The unique ID of this multi-agent call output. */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [MultiAgentCallOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .action()
+             * .callId()
+             * .output()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): MultiAgentCallOutput =
+                MultiAgentCallOutput(
+                    checkRequired("action", action),
+                    checkRequired("callId", callId),
+                    checkRequired("output", output).map { it.toImmutable() },
+                    type,
+                    id,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): MultiAgentCallOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            action().validate()
+            callId()
+            output().forEach { it.validate() }
+            _type().let {
+                if (it != JsonValue.from("multi_agent_call_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            id()
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (action.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (output.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                type.let { if (it == JsonValue.from("multi_agent_call_output")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The multi-agent action that produced this result. */
+        class Action @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val SPAWN_AGENT = of("spawn_agent")
+
+                @JvmField val INTERRUPT_AGENT = of("interrupt_agent")
+
+                @JvmField val LIST_AGENTS = of("list_agents")
+
+                @JvmField val SEND_MESSAGE = of("send_message")
+
+                @JvmField val FOLLOWUP_TASK = of("followup_task")
+
+                @JvmField val WAIT_AGENT = of("wait_agent")
+
+                @JvmStatic fun of(value: String) = Action(JsonField.of(value))
+            }
+
+            /** An enum containing [Action]'s known values. */
+            enum class Known {
+                SPAWN_AGENT,
+                INTERRUPT_AGENT,
+                LIST_AGENTS,
+                SEND_MESSAGE,
+                FOLLOWUP_TASK,
+                WAIT_AGENT,
+            }
+
+            /**
+             * An enum containing [Action]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Action] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                SPAWN_AGENT,
+                INTERRUPT_AGENT,
+                LIST_AGENTS,
+                SEND_MESSAGE,
+                FOLLOWUP_TASK,
+                WAIT_AGENT,
+                /**
+                 * An enum member indicating that [Action] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    SPAWN_AGENT -> Value.SPAWN_AGENT
+                    INTERRUPT_AGENT -> Value.INTERRUPT_AGENT
+                    LIST_AGENTS -> Value.LIST_AGENTS
+                    SEND_MESSAGE -> Value.SEND_MESSAGE
+                    FOLLOWUP_TASK -> Value.FOLLOWUP_TASK
+                    WAIT_AGENT -> Value.WAIT_AGENT
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    SPAWN_AGENT -> Known.SPAWN_AGENT
+                    INTERRUPT_AGENT -> Known.INTERRUPT_AGENT
+                    LIST_AGENTS -> Known.LIST_AGENTS
+                    SEND_MESSAGE -> Known.SEND_MESSAGE
+                    FOLLOWUP_TASK -> Known.FOLLOWUP_TASK
+                    WAIT_AGENT -> Known.WAIT_AGENT
+                    else -> throw OpenAIInvalidDataException("Unknown Action: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Action = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Action && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        class Output
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val text: JsonField<String>,
+            private val type: JsonValue,
+            private val annotations: JsonField<Annotations>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                @JsonProperty("annotations")
+                @ExcludeMissing
+                annotations: JsonField<Annotations> = JsonMissing.of(),
+            ) : this(text, type, annotations, mutableMapOf())
+
+            /**
+             * The text content.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun text(): String = text.getRequired("text")
+
+            /**
+             * The content type. Always `output_text`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("output_text")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Citations associated with the text content.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun annotations(): Optional<Annotations> = annotations.getOptional("annotations")
+
+            /**
+             * Returns the raw JSON value of [text].
+             *
+             * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+            /**
+             * Returns the raw JSON value of [annotations].
+             *
+             * Unlike [annotations], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("annotations")
+            @ExcludeMissing
+            fun _annotations(): JsonField<Annotations> = annotations
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Output].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .text()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Output]. */
+            class Builder internal constructor() {
+
+                private var text: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("output_text")
+                private var annotations: JsonField<Annotations> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(output: Output) = apply {
+                    text = output.text
+                    type = output.type
+                    annotations = output.annotations
+                    additionalProperties = output.additionalProperties.toMutableMap()
+                }
+
+                /** The text content. */
+                fun text(text: String) = text(JsonField.of(text))
+
+                /**
+                 * Sets [Builder.text] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.text] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun text(text: JsonField<String>) = apply { this.text = text }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("output_text")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                /** Citations associated with the text content. */
+                fun annotations(annotations: Annotations) = annotations(JsonField.of(annotations))
+
+                /**
+                 * Sets [Builder.annotations] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.annotations] with a well-typed [Annotations]
+                 * value instead. This method is primarily for setting the field to an undocumented
+                 * or not yet supported value.
+                 */
+                fun annotations(annotations: JsonField<Annotations>) = apply {
+                    this.annotations = annotations
+                }
+
+                /**
+                 * Alias for calling [annotations] with
+                 * `Annotations.ofBetaFileCitationParams(betaFileCitationParams)`.
+                 */
+                fun annotationsOfBetaFileCitationParams(
+                    betaFileCitationParams: List<Annotations.BetaFileCitationParam>
+                ) = annotations(Annotations.ofBetaFileCitationParams(betaFileCitationParams))
+
+                /**
+                 * Alias for calling [annotations] with
+                 * `Annotations.ofBetaUrlCitationParams(betaUrlCitationParams)`.
+                 */
+                fun annotationsOfBetaUrlCitationParams(
+                    betaUrlCitationParams: List<Annotations.BetaUrlCitationParam>
+                ) = annotations(Annotations.ofBetaUrlCitationParams(betaUrlCitationParams))
+
+                /**
+                 * Alias for calling [annotations] with
+                 * `Annotations.ofBetaContainerFileCitationParams(betaContainerFileCitationParams)`.
+                 */
+                fun annotationsOfBetaContainerFileCitationParams(
+                    betaContainerFileCitationParams:
+                        List<Annotations.BetaContainerFileCitationParam>
+                ) =
+                    annotations(
+                        Annotations.ofBetaContainerFileCitationParams(
+                            betaContainerFileCitationParams
+                        )
+                    )
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Output].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .text()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Output =
+                    Output(
+                        checkRequired("text", text),
+                        type,
+                        annotations,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Output = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                text()
+                _type().let {
+                    if (it != JsonValue.from("output_text")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                annotations().ifPresent { it.validate() }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (text.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("output_text")) 1 else 0 } +
+                    (annotations.asKnown().getOrNull()?.validity() ?: 0)
+
+            /** Citations associated with the text content. */
+            @JsonDeserialize(using = Annotations.Deserializer::class)
+            @JsonSerialize(using = Annotations.Serializer::class)
+            class Annotations
+            private constructor(
+                private val betaFileCitationParams: List<BetaFileCitationParam>? = null,
+                private val betaUrlCitationParams: List<BetaUrlCitationParam>? = null,
+                private val betaContainerFileCitationParams: List<BetaContainerFileCitationParam>? =
+                    null,
+                private val _json: JsonValue? = null,
+            ) {
+
+                fun betaFileCitationParams(): Optional<List<BetaFileCitationParam>> =
+                    Optional.ofNullable(betaFileCitationParams)
+
+                fun betaUrlCitationParams(): Optional<List<BetaUrlCitationParam>> =
+                    Optional.ofNullable(betaUrlCitationParams)
+
+                fun betaContainerFileCitationParams():
+                    Optional<List<BetaContainerFileCitationParam>> =
+                    Optional.ofNullable(betaContainerFileCitationParams)
+
+                fun isBetaFileCitationParams(): Boolean = betaFileCitationParams != null
+
+                fun isBetaUrlCitationParams(): Boolean = betaUrlCitationParams != null
+
+                fun isBetaContainerFileCitationParams(): Boolean =
+                    betaContainerFileCitationParams != null
+
+                fun asBetaFileCitationParams(): List<BetaFileCitationParam> =
+                    betaFileCitationParams.getOrThrow("betaFileCitationParams")
+
+                fun asBetaUrlCitationParams(): List<BetaUrlCitationParam> =
+                    betaUrlCitationParams.getOrThrow("betaUrlCitationParams")
+
+                fun asBetaContainerFileCitationParams(): List<BetaContainerFileCitationParam> =
+                    betaContainerFileCitationParams.getOrThrow("betaContainerFileCitationParams")
+
+                fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+                /**
+                 * Maps this instance's current variant to a value of type [T] using the given
+                 * [visitor].
+                 *
+                 * Note that this method is _not_ forwards compatible with new variants from the
+                 * API, unless [visitor] overrides [Visitor.unknown]. To handle variants not known
+                 * to this version of the SDK gracefully, consider overriding [Visitor.unknown]:
+                 * ```java
+                 * import com.openai.core.JsonValue;
+                 * import java.util.Optional;
+                 *
+                 * Optional<String> result = annotations.accept(new Annotations.Visitor<Optional<String>>() {
+                 *     @Override
+                 *     public Optional<String> visitBetaFileCitationParams(List<BetaFileCitationParam> betaFileCitationParams) {
+                 *         return Optional.of(betaFileCitationParams.toString());
+                 *     }
+                 *
+                 *     // ...
+                 *
+                 *     @Override
+                 *     public Optional<String> unknown(JsonValue json) {
+                 *         // Or inspect the `json`.
+                 *         return Optional.empty();
+                 *     }
+                 * });
+                 * ```
+                 *
+                 * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+                 *   [visitor] and the current variant is unknown.
+                 */
+                fun <T> accept(visitor: Visitor<T>): T =
+                    when {
+                        betaFileCitationParams != null ->
+                            visitor.visitBetaFileCitationParams(betaFileCitationParams)
+                        betaUrlCitationParams != null ->
+                            visitor.visitBetaUrlCitationParams(betaUrlCitationParams)
+                        betaContainerFileCitationParams != null ->
+                            visitor.visitBetaContainerFileCitationParams(
+                                betaContainerFileCitationParams
+                            )
+                        else -> visitor.unknown(_json)
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Annotations = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    accept(
+                        object : Visitor<Unit> {
+                            override fun visitBetaFileCitationParams(
+                                betaFileCitationParams: List<BetaFileCitationParam>
+                            ) {
+                                betaFileCitationParams.forEach { it.validate() }
+                            }
+
+                            override fun visitBetaUrlCitationParams(
+                                betaUrlCitationParams: List<BetaUrlCitationParam>
+                            ) {
+                                betaUrlCitationParams.forEach { it.validate() }
+                            }
+
+                            override fun visitBetaContainerFileCitationParams(
+                                betaContainerFileCitationParams:
+                                    List<BetaContainerFileCitationParam>
+                            ) {
+                                betaContainerFileCitationParams.forEach { it.validate() }
+                            }
+                        }
+                    )
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    accept(
+                        object : Visitor<Int> {
+                            override fun visitBetaFileCitationParams(
+                                betaFileCitationParams: List<BetaFileCitationParam>
+                            ) = betaFileCitationParams.sumOf { it.validity().toInt() }
+
+                            override fun visitBetaUrlCitationParams(
+                                betaUrlCitationParams: List<BetaUrlCitationParam>
+                            ) = betaUrlCitationParams.sumOf { it.validity().toInt() }
+
+                            override fun visitBetaContainerFileCitationParams(
+                                betaContainerFileCitationParams:
+                                    List<BetaContainerFileCitationParam>
+                            ) = betaContainerFileCitationParams.sumOf { it.validity().toInt() }
+
+                            override fun unknown(json: JsonValue?) = 0
+                        }
+                    )
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Annotations &&
+                        betaFileCitationParams == other.betaFileCitationParams &&
+                        betaUrlCitationParams == other.betaUrlCitationParams &&
+                        betaContainerFileCitationParams == other.betaContainerFileCitationParams
+                }
+
+                override fun hashCode(): Int =
+                    Objects.hash(
+                        betaFileCitationParams,
+                        betaUrlCitationParams,
+                        betaContainerFileCitationParams,
+                    )
+
+                override fun toString(): String =
+                    when {
+                        betaFileCitationParams != null ->
+                            "Annotations{betaFileCitationParams=$betaFileCitationParams}"
+                        betaUrlCitationParams != null ->
+                            "Annotations{betaUrlCitationParams=$betaUrlCitationParams}"
+                        betaContainerFileCitationParams != null ->
+                            "Annotations{betaContainerFileCitationParams=$betaContainerFileCitationParams}"
+                        _json != null -> "Annotations{_unknown=$_json}"
+                        else -> throw IllegalStateException("Invalid Annotations")
+                    }
+
+                companion object {
+
+                    @JvmStatic
+                    fun ofBetaFileCitationParams(
+                        betaFileCitationParams: List<BetaFileCitationParam>
+                    ) = Annotations(betaFileCitationParams = betaFileCitationParams.toImmutable())
+
+                    @JvmStatic
+                    fun ofBetaUrlCitationParams(betaUrlCitationParams: List<BetaUrlCitationParam>) =
+                        Annotations(betaUrlCitationParams = betaUrlCitationParams.toImmutable())
+
+                    @JvmStatic
+                    fun ofBetaContainerFileCitationParams(
+                        betaContainerFileCitationParams: List<BetaContainerFileCitationParam>
+                    ) =
+                        Annotations(
+                            betaContainerFileCitationParams =
+                                betaContainerFileCitationParams.toImmutable()
+                        )
+                }
+
+                /**
+                 * An interface that defines how to map each variant of [Annotations] to a value of
+                 * type [T].
+                 */
+                interface Visitor<out T> {
+
+                    fun visitBetaFileCitationParams(
+                        betaFileCitationParams: List<BetaFileCitationParam>
+                    ): T
+
+                    fun visitBetaUrlCitationParams(
+                        betaUrlCitationParams: List<BetaUrlCitationParam>
+                    ): T
+
+                    fun visitBetaContainerFileCitationParams(
+                        betaContainerFileCitationParams: List<BetaContainerFileCitationParam>
+                    ): T
+
+                    /**
+                     * Maps an unknown variant of [Annotations] to a value of type [T].
+                     *
+                     * An instance of [Annotations] can contain an unknown variant if it was
+                     * deserialized from data that doesn't match any known variant. For example, if
+                     * the SDK is on an older version than the API, then the API may respond with
+                     * new variants that the SDK is unaware of.
+                     *
+                     * @throws OpenAIInvalidDataException in the default implementation.
+                     */
+                    fun unknown(json: JsonValue?): T {
+                        throw OpenAIInvalidDataException("Unknown Annotations: $json")
+                    }
+                }
+
+                internal class Deserializer : BaseDeserializer<Annotations>(Annotations::class) {
+
+                    override fun ObjectCodec.deserialize(node: JsonNode): Annotations {
+                        val json = JsonValue.fromJsonNode(node)
+
+                        val bestMatches =
+                            sequenceOf(
+                                    tryDeserialize(
+                                            node,
+                                            jacksonTypeRef<List<BetaFileCitationParam>>(),
+                                        )
+                                        ?.let {
+                                            Annotations(betaFileCitationParams = it, _json = json)
+                                        },
+                                    tryDeserialize(
+                                            node,
+                                            jacksonTypeRef<List<BetaUrlCitationParam>>(),
+                                        )
+                                        ?.let {
+                                            Annotations(betaUrlCitationParams = it, _json = json)
+                                        },
+                                    tryDeserialize(
+                                            node,
+                                            jacksonTypeRef<List<BetaContainerFileCitationParam>>(),
+                                        )
+                                        ?.let {
+                                            Annotations(
+                                                betaContainerFileCitationParams = it,
+                                                _json = json,
+                                            )
+                                        },
+                                )
+                                .filterNotNull()
+                                .allMaxBy { it.validity() }
+                                .toList()
+                        return when (bestMatches.size) {
+                            // This can happen if what we're deserializing is completely
+                            // incompatible with all the possible variants (e.g. deserializing from
+                            // boolean).
+                            0 -> Annotations(_json = json)
+                            1 -> bestMatches.single()
+                            // If there's more than one match with the highest validity, then use
+                            // the first completely valid match, or simply the first match if none
+                            // are completely valid.
+                            else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                        }
+                    }
+                }
+
+                internal class Serializer : BaseSerializer<Annotations>(Annotations::class) {
+
+                    override fun serialize(
+                        value: Annotations,
+                        generator: JsonGenerator,
+                        provider: SerializerProvider,
+                    ) {
+                        when {
+                            value.betaFileCitationParams != null ->
+                                generator.writeObject(value.betaFileCitationParams)
+                            value.betaUrlCitationParams != null ->
+                                generator.writeObject(value.betaUrlCitationParams)
+                            value.betaContainerFileCitationParams != null ->
+                                generator.writeObject(value.betaContainerFileCitationParams)
+                            value._json != null -> generator.writeObject(value._json)
+                            else -> throw IllegalStateException("Invalid Annotations")
+                        }
+                    }
+                }
+
+                class BetaFileCitationParam
+                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+                private constructor(
+                    private val fileId: JsonField<String>,
+                    private val filename: JsonField<String>,
+                    private val index: JsonField<Long>,
+                    private val type: JsonValue,
+                    private val additionalProperties: MutableMap<String, JsonValue>,
+                ) {
+
+                    @JsonCreator
+                    private constructor(
+                        @JsonProperty("file_id")
+                        @ExcludeMissing
+                        fileId: JsonField<String> = JsonMissing.of(),
+                        @JsonProperty("filename")
+                        @ExcludeMissing
+                        filename: JsonField<String> = JsonMissing.of(),
+                        @JsonProperty("index")
+                        @ExcludeMissing
+                        index: JsonField<Long> = JsonMissing.of(),
+                        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                    ) : this(fileId, filename, index, type, mutableMapOf())
+
+                    /**
+                     * The ID of the file.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun fileId(): String = fileId.getRequired("file_id")
+
+                    /**
+                     * The filename of the file cited.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun filename(): String = filename.getRequired("filename")
+
+                    /**
+                     * The index of the file in the list of files.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun index(): Long = index.getRequired("index")
+
+                    /**
+                     * The citation type. Always `file_citation`.
+                     *
+                     * Expected to always return the following:
+                     * ```java
+                     * JsonValue.from("file_citation")
+                     * ```
+                     *
+                     * However, this method can be useful for debugging and logging (e.g. if the
+                     * server responded with an unexpected value).
+                     */
+                    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                    /**
+                     * Returns the raw JSON value of [fileId].
+                     *
+                     * Unlike [fileId], this method doesn't throw if the JSON field has an
+                     * unexpected type.
+                     */
+                    @JsonProperty("file_id")
+                    @ExcludeMissing
+                    fun _fileId(): JsonField<String> = fileId
+
+                    /**
+                     * Returns the raw JSON value of [filename].
+                     *
+                     * Unlike [filename], this method doesn't throw if the JSON field has an
+                     * unexpected type.
+                     */
+                    @JsonProperty("filename")
+                    @ExcludeMissing
+                    fun _filename(): JsonField<String> = filename
+
+                    /**
+                     * Returns the raw JSON value of [index].
+                     *
+                     * Unlike [index], this method doesn't throw if the JSON field has an unexpected
+                     * type.
+                     */
+                    @JsonProperty("index") @ExcludeMissing fun _index(): JsonField<Long> = index
+
+                    @JsonAnySetter
+                    private fun putAdditionalProperty(key: String, value: JsonValue) {
+                        additionalProperties.put(key, value)
+                    }
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> =
+                        Collections.unmodifiableMap(additionalProperties)
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of
+                         * [BetaFileCitationParam].
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .fileId()
+                         * .filename()
+                         * .index()
+                         * ```
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [BetaFileCitationParam]. */
+                    class Builder internal constructor() {
+
+                        private var fileId: JsonField<String>? = null
+                        private var filename: JsonField<String>? = null
+                        private var index: JsonField<Long>? = null
+                        private var type: JsonValue = JsonValue.from("file_citation")
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(betaFileCitationParam: BetaFileCitationParam) = apply {
+                            fileId = betaFileCitationParam.fileId
+                            filename = betaFileCitationParam.filename
+                            index = betaFileCitationParam.index
+                            type = betaFileCitationParam.type
+                            additionalProperties =
+                                betaFileCitationParam.additionalProperties.toMutableMap()
+                        }
+
+                        /** The ID of the file. */
+                        fun fileId(fileId: String) = fileId(JsonField.of(fileId))
+
+                        /**
+                         * Sets [Builder.fileId] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.fileId] with a well-typed [String] value
+                         * instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun fileId(fileId: JsonField<String>) = apply { this.fileId = fileId }
+
+                        /** The filename of the file cited. */
+                        fun filename(filename: String) = filename(JsonField.of(filename))
+
+                        /**
+                         * Sets [Builder.filename] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.filename] with a well-typed [String]
+                         * value instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun filename(filename: JsonField<String>) = apply {
+                            this.filename = filename
+                        }
+
+                        /** The index of the file in the list of files. */
+                        fun index(index: Long) = index(JsonField.of(index))
+
+                        /**
+                         * Sets [Builder.index] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.index] with a well-typed [Long] value
+                         * instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun index(index: JsonField<Long>) = apply { this.index = index }
+
+                        /**
+                         * Sets the field to an arbitrary JSON value.
+                         *
+                         * It is usually unnecessary to call this method because the field defaults
+                         * to the following:
+                         * ```java
+                         * JsonValue.from("file_citation")
+                         * ```
+                         *
+                         * This method is primarily for setting the field to an undocumented or not
+                         * yet supported value.
+                         */
+                        fun type(type: JsonValue) = apply { this.type = type }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [BetaFileCitationParam].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .fileId()
+                         * .filename()
+                         * .index()
+                         * ```
+                         *
+                         * @throws IllegalStateException if any required field is unset.
+                         */
+                        fun build(): BetaFileCitationParam =
+                            BetaFileCitationParam(
+                                checkRequired("fileId", fileId),
+                                checkRequired("filename", filename),
+                                checkRequired("index", index),
+                                type,
+                                additionalProperties.toMutableMap(),
+                            )
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): BetaFileCitationParam = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        fileId()
+                        filename()
+                        index()
+                        _type().let {
+                            if (it != JsonValue.from("file_citation")) {
+                                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                            }
+                        }
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        (if (fileId.asKnown().isPresent) 1 else 0) +
+                            (if (filename.asKnown().isPresent) 1 else 0) +
+                            (if (index.asKnown().isPresent) 1 else 0) +
+                            type.let { if (it == JsonValue.from("file_citation")) 1 else 0 }
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is BetaFileCitationParam &&
+                            fileId == other.fileId &&
+                            filename == other.filename &&
+                            index == other.index &&
+                            type == other.type &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy {
+                        Objects.hash(fileId, filename, index, type, additionalProperties)
+                    }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "BetaFileCitationParam{fileId=$fileId, filename=$filename, index=$index, type=$type, additionalProperties=$additionalProperties}"
+                }
+
+                class BetaUrlCitationParam
+                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+                private constructor(
+                    private val endIndex: JsonField<Long>,
+                    private val startIndex: JsonField<Long>,
+                    private val title: JsonField<String>,
+                    private val type: JsonValue,
+                    private val url: JsonField<String>,
+                    private val additionalProperties: MutableMap<String, JsonValue>,
+                ) {
+
+                    @JsonCreator
+                    private constructor(
+                        @JsonProperty("end_index")
+                        @ExcludeMissing
+                        endIndex: JsonField<Long> = JsonMissing.of(),
+                        @JsonProperty("start_index")
+                        @ExcludeMissing
+                        startIndex: JsonField<Long> = JsonMissing.of(),
+                        @JsonProperty("title")
+                        @ExcludeMissing
+                        title: JsonField<String> = JsonMissing.of(),
+                        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                        @JsonProperty("url")
+                        @ExcludeMissing
+                        url: JsonField<String> = JsonMissing.of(),
+                    ) : this(endIndex, startIndex, title, type, url, mutableMapOf())
+
+                    /**
+                     * The index of the last character of the citation in the message.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun endIndex(): Long = endIndex.getRequired("end_index")
+
+                    /**
+                     * The index of the first character of the citation in the message.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun startIndex(): Long = startIndex.getRequired("start_index")
+
+                    /**
+                     * The title of the cited resource.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun title(): String = title.getRequired("title")
+
+                    /**
+                     * The citation type. Always `url_citation`.
+                     *
+                     * Expected to always return the following:
+                     * ```java
+                     * JsonValue.from("url_citation")
+                     * ```
+                     *
+                     * However, this method can be useful for debugging and logging (e.g. if the
+                     * server responded with an unexpected value).
+                     */
+                    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                    /**
+                     * The URL of the cited resource.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun url(): String = url.getRequired("url")
+
+                    /**
+                     * Returns the raw JSON value of [endIndex].
+                     *
+                     * Unlike [endIndex], this method doesn't throw if the JSON field has an
+                     * unexpected type.
+                     */
+                    @JsonProperty("end_index")
+                    @ExcludeMissing
+                    fun _endIndex(): JsonField<Long> = endIndex
+
+                    /**
+                     * Returns the raw JSON value of [startIndex].
+                     *
+                     * Unlike [startIndex], this method doesn't throw if the JSON field has an
+                     * unexpected type.
+                     */
+                    @JsonProperty("start_index")
+                    @ExcludeMissing
+                    fun _startIndex(): JsonField<Long> = startIndex
+
+                    /**
+                     * Returns the raw JSON value of [title].
+                     *
+                     * Unlike [title], this method doesn't throw if the JSON field has an unexpected
+                     * type.
+                     */
+                    @JsonProperty("title") @ExcludeMissing fun _title(): JsonField<String> = title
+
+                    /**
+                     * Returns the raw JSON value of [url].
+                     *
+                     * Unlike [url], this method doesn't throw if the JSON field has an unexpected
+                     * type.
+                     */
+                    @JsonProperty("url") @ExcludeMissing fun _url(): JsonField<String> = url
+
+                    @JsonAnySetter
+                    private fun putAdditionalProperty(key: String, value: JsonValue) {
+                        additionalProperties.put(key, value)
+                    }
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> =
+                        Collections.unmodifiableMap(additionalProperties)
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of
+                         * [BetaUrlCitationParam].
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .endIndex()
+                         * .startIndex()
+                         * .title()
+                         * .url()
+                         * ```
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [BetaUrlCitationParam]. */
+                    class Builder internal constructor() {
+
+                        private var endIndex: JsonField<Long>? = null
+                        private var startIndex: JsonField<Long>? = null
+                        private var title: JsonField<String>? = null
+                        private var type: JsonValue = JsonValue.from("url_citation")
+                        private var url: JsonField<String>? = null
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(betaUrlCitationParam: BetaUrlCitationParam) = apply {
+                            endIndex = betaUrlCitationParam.endIndex
+                            startIndex = betaUrlCitationParam.startIndex
+                            title = betaUrlCitationParam.title
+                            type = betaUrlCitationParam.type
+                            url = betaUrlCitationParam.url
+                            additionalProperties =
+                                betaUrlCitationParam.additionalProperties.toMutableMap()
+                        }
+
+                        /** The index of the last character of the citation in the message. */
+                        fun endIndex(endIndex: Long) = endIndex(JsonField.of(endIndex))
+
+                        /**
+                         * Sets [Builder.endIndex] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.endIndex] with a well-typed [Long] value
+                         * instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun endIndex(endIndex: JsonField<Long>) = apply { this.endIndex = endIndex }
+
+                        /** The index of the first character of the citation in the message. */
+                        fun startIndex(startIndex: Long) = startIndex(JsonField.of(startIndex))
+
+                        /**
+                         * Sets [Builder.startIndex] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.startIndex] with a well-typed [Long]
+                         * value instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun startIndex(startIndex: JsonField<Long>) = apply {
+                            this.startIndex = startIndex
+                        }
+
+                        /** The title of the cited resource. */
+                        fun title(title: String) = title(JsonField.of(title))
+
+                        /**
+                         * Sets [Builder.title] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.title] with a well-typed [String] value
+                         * instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun title(title: JsonField<String>) = apply { this.title = title }
+
+                        /**
+                         * Sets the field to an arbitrary JSON value.
+                         *
+                         * It is usually unnecessary to call this method because the field defaults
+                         * to the following:
+                         * ```java
+                         * JsonValue.from("url_citation")
+                         * ```
+                         *
+                         * This method is primarily for setting the field to an undocumented or not
+                         * yet supported value.
+                         */
+                        fun type(type: JsonValue) = apply { this.type = type }
+
+                        /** The URL of the cited resource. */
+                        fun url(url: String) = url(JsonField.of(url))
+
+                        /**
+                         * Sets [Builder.url] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.url] with a well-typed [String] value
+                         * instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun url(url: JsonField<String>) = apply { this.url = url }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [BetaUrlCitationParam].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .endIndex()
+                         * .startIndex()
+                         * .title()
+                         * .url()
+                         * ```
+                         *
+                         * @throws IllegalStateException if any required field is unset.
+                         */
+                        fun build(): BetaUrlCitationParam =
+                            BetaUrlCitationParam(
+                                checkRequired("endIndex", endIndex),
+                                checkRequired("startIndex", startIndex),
+                                checkRequired("title", title),
+                                type,
+                                checkRequired("url", url),
+                                additionalProperties.toMutableMap(),
+                            )
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): BetaUrlCitationParam = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        endIndex()
+                        startIndex()
+                        title()
+                        _type().let {
+                            if (it != JsonValue.from("url_citation")) {
+                                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                            }
+                        }
+                        url()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        (if (endIndex.asKnown().isPresent) 1 else 0) +
+                            (if (startIndex.asKnown().isPresent) 1 else 0) +
+                            (if (title.asKnown().isPresent) 1 else 0) +
+                            type.let { if (it == JsonValue.from("url_citation")) 1 else 0 } +
+                            (if (url.asKnown().isPresent) 1 else 0)
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is BetaUrlCitationParam &&
+                            endIndex == other.endIndex &&
+                            startIndex == other.startIndex &&
+                            title == other.title &&
+                            type == other.type &&
+                            url == other.url &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy {
+                        Objects.hash(endIndex, startIndex, title, type, url, additionalProperties)
+                    }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "BetaUrlCitationParam{endIndex=$endIndex, startIndex=$startIndex, title=$title, type=$type, url=$url, additionalProperties=$additionalProperties}"
+                }
+
+                class BetaContainerFileCitationParam
+                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+                private constructor(
+                    private val containerId: JsonField<String>,
+                    private val endIndex: JsonField<Long>,
+                    private val fileId: JsonField<String>,
+                    private val filename: JsonField<String>,
+                    private val startIndex: JsonField<Long>,
+                    private val type: JsonValue,
+                    private val additionalProperties: MutableMap<String, JsonValue>,
+                ) {
+
+                    @JsonCreator
+                    private constructor(
+                        @JsonProperty("container_id")
+                        @ExcludeMissing
+                        containerId: JsonField<String> = JsonMissing.of(),
+                        @JsonProperty("end_index")
+                        @ExcludeMissing
+                        endIndex: JsonField<Long> = JsonMissing.of(),
+                        @JsonProperty("file_id")
+                        @ExcludeMissing
+                        fileId: JsonField<String> = JsonMissing.of(),
+                        @JsonProperty("filename")
+                        @ExcludeMissing
+                        filename: JsonField<String> = JsonMissing.of(),
+                        @JsonProperty("start_index")
+                        @ExcludeMissing
+                        startIndex: JsonField<Long> = JsonMissing.of(),
+                        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                    ) : this(
+                        containerId,
+                        endIndex,
+                        fileId,
+                        filename,
+                        startIndex,
+                        type,
+                        mutableMapOf(),
+                    )
+
+                    /**
+                     * The ID of the container.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun containerId(): String = containerId.getRequired("container_id")
+
+                    /**
+                     * The index of the last character of the citation in the message.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun endIndex(): Long = endIndex.getRequired("end_index")
+
+                    /**
+                     * The ID of the container file.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun fileId(): String = fileId.getRequired("file_id")
+
+                    /**
+                     * The filename of the container file cited.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun filename(): String = filename.getRequired("filename")
+
+                    /**
+                     * The index of the first character of the citation in the message.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun startIndex(): Long = startIndex.getRequired("start_index")
+
+                    /**
+                     * The citation type. Always `container_file_citation`.
+                     *
+                     * Expected to always return the following:
+                     * ```java
+                     * JsonValue.from("container_file_citation")
+                     * ```
+                     *
+                     * However, this method can be useful for debugging and logging (e.g. if the
+                     * server responded with an unexpected value).
+                     */
+                    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                    /**
+                     * Returns the raw JSON value of [containerId].
+                     *
+                     * Unlike [containerId], this method doesn't throw if the JSON field has an
+                     * unexpected type.
+                     */
+                    @JsonProperty("container_id")
+                    @ExcludeMissing
+                    fun _containerId(): JsonField<String> = containerId
+
+                    /**
+                     * Returns the raw JSON value of [endIndex].
+                     *
+                     * Unlike [endIndex], this method doesn't throw if the JSON field has an
+                     * unexpected type.
+                     */
+                    @JsonProperty("end_index")
+                    @ExcludeMissing
+                    fun _endIndex(): JsonField<Long> = endIndex
+
+                    /**
+                     * Returns the raw JSON value of [fileId].
+                     *
+                     * Unlike [fileId], this method doesn't throw if the JSON field has an
+                     * unexpected type.
+                     */
+                    @JsonProperty("file_id")
+                    @ExcludeMissing
+                    fun _fileId(): JsonField<String> = fileId
+
+                    /**
+                     * Returns the raw JSON value of [filename].
+                     *
+                     * Unlike [filename], this method doesn't throw if the JSON field has an
+                     * unexpected type.
+                     */
+                    @JsonProperty("filename")
+                    @ExcludeMissing
+                    fun _filename(): JsonField<String> = filename
+
+                    /**
+                     * Returns the raw JSON value of [startIndex].
+                     *
+                     * Unlike [startIndex], this method doesn't throw if the JSON field has an
+                     * unexpected type.
+                     */
+                    @JsonProperty("start_index")
+                    @ExcludeMissing
+                    fun _startIndex(): JsonField<Long> = startIndex
+
+                    @JsonAnySetter
+                    private fun putAdditionalProperty(key: String, value: JsonValue) {
+                        additionalProperties.put(key, value)
+                    }
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> =
+                        Collections.unmodifiableMap(additionalProperties)
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of
+                         * [BetaContainerFileCitationParam].
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .containerId()
+                         * .endIndex()
+                         * .fileId()
+                         * .filename()
+                         * .startIndex()
+                         * ```
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [BetaContainerFileCitationParam]. */
+                    class Builder internal constructor() {
+
+                        private var containerId: JsonField<String>? = null
+                        private var endIndex: JsonField<Long>? = null
+                        private var fileId: JsonField<String>? = null
+                        private var filename: JsonField<String>? = null
+                        private var startIndex: JsonField<Long>? = null
+                        private var type: JsonValue = JsonValue.from("container_file_citation")
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(
+                            betaContainerFileCitationParam: BetaContainerFileCitationParam
+                        ) = apply {
+                            containerId = betaContainerFileCitationParam.containerId
+                            endIndex = betaContainerFileCitationParam.endIndex
+                            fileId = betaContainerFileCitationParam.fileId
+                            filename = betaContainerFileCitationParam.filename
+                            startIndex = betaContainerFileCitationParam.startIndex
+                            type = betaContainerFileCitationParam.type
+                            additionalProperties =
+                                betaContainerFileCitationParam.additionalProperties.toMutableMap()
+                        }
+
+                        /** The ID of the container. */
+                        fun containerId(containerId: String) =
+                            containerId(JsonField.of(containerId))
+
+                        /**
+                         * Sets [Builder.containerId] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.containerId] with a well-typed [String]
+                         * value instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun containerId(containerId: JsonField<String>) = apply {
+                            this.containerId = containerId
+                        }
+
+                        /** The index of the last character of the citation in the message. */
+                        fun endIndex(endIndex: Long) = endIndex(JsonField.of(endIndex))
+
+                        /**
+                         * Sets [Builder.endIndex] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.endIndex] with a well-typed [Long] value
+                         * instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun endIndex(endIndex: JsonField<Long>) = apply { this.endIndex = endIndex }
+
+                        /** The ID of the container file. */
+                        fun fileId(fileId: String) = fileId(JsonField.of(fileId))
+
+                        /**
+                         * Sets [Builder.fileId] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.fileId] with a well-typed [String] value
+                         * instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun fileId(fileId: JsonField<String>) = apply { this.fileId = fileId }
+
+                        /** The filename of the container file cited. */
+                        fun filename(filename: String) = filename(JsonField.of(filename))
+
+                        /**
+                         * Sets [Builder.filename] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.filename] with a well-typed [String]
+                         * value instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun filename(filename: JsonField<String>) = apply {
+                            this.filename = filename
+                        }
+
+                        /** The index of the first character of the citation in the message. */
+                        fun startIndex(startIndex: Long) = startIndex(JsonField.of(startIndex))
+
+                        /**
+                         * Sets [Builder.startIndex] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.startIndex] with a well-typed [Long]
+                         * value instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun startIndex(startIndex: JsonField<Long>) = apply {
+                            this.startIndex = startIndex
+                        }
+
+                        /**
+                         * Sets the field to an arbitrary JSON value.
+                         *
+                         * It is usually unnecessary to call this method because the field defaults
+                         * to the following:
+                         * ```java
+                         * JsonValue.from("container_file_citation")
+                         * ```
+                         *
+                         * This method is primarily for setting the field to an undocumented or not
+                         * yet supported value.
+                         */
+                        fun type(type: JsonValue) = apply { this.type = type }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [BetaContainerFileCitationParam].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .containerId()
+                         * .endIndex()
+                         * .fileId()
+                         * .filename()
+                         * .startIndex()
+                         * ```
+                         *
+                         * @throws IllegalStateException if any required field is unset.
+                         */
+                        fun build(): BetaContainerFileCitationParam =
+                            BetaContainerFileCitationParam(
+                                checkRequired("containerId", containerId),
+                                checkRequired("endIndex", endIndex),
+                                checkRequired("fileId", fileId),
+                                checkRequired("filename", filename),
+                                checkRequired("startIndex", startIndex),
+                                type,
+                                additionalProperties.toMutableMap(),
+                            )
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): BetaContainerFileCitationParam = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        containerId()
+                        endIndex()
+                        fileId()
+                        filename()
+                        startIndex()
+                        _type().let {
+                            if (it != JsonValue.from("container_file_citation")) {
+                                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                            }
+                        }
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        (if (containerId.asKnown().isPresent) 1 else 0) +
+                            (if (endIndex.asKnown().isPresent) 1 else 0) +
+                            (if (fileId.asKnown().isPresent) 1 else 0) +
+                            (if (filename.asKnown().isPresent) 1 else 0) +
+                            (if (startIndex.asKnown().isPresent) 1 else 0) +
+                            type.let {
+                                if (it == JsonValue.from("container_file_citation")) 1 else 0
+                            }
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is BetaContainerFileCitationParam &&
+                            containerId == other.containerId &&
+                            endIndex == other.endIndex &&
+                            fileId == other.fileId &&
+                            filename == other.filename &&
+                            startIndex == other.startIndex &&
+                            type == other.type &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy {
+                        Objects.hash(
+                            containerId,
+                            endIndex,
+                            fileId,
+                            filename,
+                            startIndex,
+                            type,
+                            additionalProperties,
+                        )
+                    }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "BetaContainerFileCitationParam{containerId=$containerId, endIndex=$endIndex, fileId=$fileId, filename=$filename, startIndex=$startIndex, type=$type, additionalProperties=$additionalProperties}"
+                }
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Output &&
+                    text == other.text &&
+                    type == other.type &&
+                    annotations == other.annotations &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(text, type, annotations, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Output{text=$text, type=$type, annotations=$annotations, additionalProperties=$additionalProperties}"
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is MultiAgentCallOutput &&
+                action == other.action &&
+                callId == other.callId &&
+                output == other.output &&
+                type == other.type &&
+                id == other.id &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(action, callId, output, type, id, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "MultiAgentCallOutput{action=$action, callId=$callId, output=$output, type=$type, id=$id, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    class ToolSearchCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val arguments: JsonValue,
+        private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val agent: JsonField<Agent>,
+        private val callId: JsonField<String>,
+        private val execution: JsonField<Execution>,
+        private val status: JsonField<Status>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("arguments") @ExcludeMissing arguments: JsonValue = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("execution")
+            @ExcludeMissing
+            execution: JsonField<Execution> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        ) : this(arguments, type, id, agent, callId, execution, status, mutableMapOf())
+
+        /**
+         * The arguments supplied to the tool search call.
+         *
+         * This arbitrary value can be deserialized into a custom type using the `convert` method:
+         * ```java
+         * MyClass myObject = toolSearchCall.arguments().convert(MyClass.class);
+         * ```
+         */
+        @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonValue = arguments
+
+        /**
+         * The item type. Always `tool_search_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("tool_search_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The unique ID of this tool search call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun id(): Optional<String> = id.getOptional("id")
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * The unique ID of the tool search call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun callId(): Optional<String> = callId.getOptional("call_id")
+
+        /**
+         * Whether tool search was executed by the server or by the client.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun execution(): Optional<Execution> = execution.getOptional("execution")
+
+        /**
+         * The status of the tool search call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun status(): Optional<Status> = status.getOptional("status")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [execution].
+         *
+         * Unlike [execution], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("execution")
+        @ExcludeMissing
+        fun _execution(): JsonField<Execution> = execution
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ToolSearchCall].
+             *
+             * The following fields are required:
+             * ```java
+             * .arguments()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ToolSearchCall]. */
+        class Builder internal constructor() {
+
+            private var arguments: JsonValue? = null
+            private var type: JsonValue = JsonValue.from("tool_search_call")
+            private var id: JsonField<String> = JsonMissing.of()
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var callId: JsonField<String> = JsonMissing.of()
+            private var execution: JsonField<Execution> = JsonMissing.of()
+            private var status: JsonField<Status> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(toolSearchCall: ToolSearchCall) = apply {
+                arguments = toolSearchCall.arguments
+                type = toolSearchCall.type
+                id = toolSearchCall.id
+                agent = toolSearchCall.agent
+                callId = toolSearchCall.callId
+                execution = toolSearchCall.execution
+                status = toolSearchCall.status
+                additionalProperties = toolSearchCall.additionalProperties.toMutableMap()
+            }
+
+            /** The arguments supplied to the tool search call. */
+            fun arguments(arguments: JsonValue) = apply { this.arguments = arguments }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("tool_search_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The unique ID of this tool search call. */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /** The unique ID of the tool search call generated by the model. */
+            fun callId(callId: String?) = callId(JsonField.ofNullable(callId))
+
+            /** Alias for calling [Builder.callId] with `callId.orElse(null)`. */
+            fun callId(callId: Optional<String>) = callId(callId.getOrNull())
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** Whether tool search was executed by the server or by the client. */
+            fun execution(execution: Execution) = execution(JsonField.of(execution))
+
+            /**
+             * Sets [Builder.execution] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.execution] with a well-typed [Execution] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun execution(execution: JsonField<Execution>) = apply { this.execution = execution }
+
+            /** The status of the tool search call. */
+            fun status(status: Status?) = status(JsonField.ofNullable(status))
+
+            /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+            fun status(status: Optional<Status>) = status(status.getOrNull())
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ToolSearchCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .arguments()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ToolSearchCall =
+                ToolSearchCall(
+                    checkRequired("arguments", arguments),
+                    type,
+                    id,
+                    agent,
+                    callId,
+                    execution,
+                    status,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ToolSearchCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _type().let {
+                if (it != JsonValue.from("tool_search_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            id()
+            agent().ifPresent { it.validate() }
+            callId()
+            execution().ifPresent { it.validate() }
+            status().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            type.let { if (it == JsonValue.from("tool_search_call")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (execution.asKnown().getOrNull()?.validity() ?: 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        /** Whether tool search was executed by the server or by the client. */
+        class Execution @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val SERVER = of("server")
+
+                @JvmField val CLIENT = of("client")
+
+                @JvmStatic fun of(value: String) = Execution(JsonField.of(value))
+            }
+
+            /** An enum containing [Execution]'s known values. */
+            enum class Known {
+                SERVER,
+                CLIENT,
+            }
+
+            /**
+             * An enum containing [Execution]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Execution] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                SERVER,
+                CLIENT,
+                /**
+                 * An enum member indicating that [Execution] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    SERVER -> Value.SERVER
+                    CLIENT -> Value.CLIENT
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    SERVER -> Known.SERVER
+                    CLIENT -> Known.CLIENT
+                    else -> throw OpenAIInvalidDataException("Unknown Execution: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Execution = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Execution && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The status of the tool search call. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ToolSearchCall &&
+                arguments == other.arguments &&
+                type == other.type &&
+                id == other.id &&
+                agent == other.agent &&
+                callId == other.callId &&
+                execution == other.execution &&
+                status == other.status &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                arguments,
+                type,
+                id,
+                agent,
+                callId,
+                execution,
+                status,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ToolSearchCall{arguments=$arguments, type=$type, id=$id, agent=$agent, callId=$callId, execution=$execution, status=$status, additionalProperties=$additionalProperties}"
+    }
+
+    class AdditionalTools
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val role: JsonValue,
+        private val tools: JsonField<List<BetaTool>>,
+        private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("role") @ExcludeMissing role: JsonValue = JsonMissing.of(),
+            @JsonProperty("tools")
+            @ExcludeMissing
+            tools: JsonField<List<BetaTool>> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(role, tools, type, id, agent, mutableMapOf())
+
+        /**
+         * The role that provided the additional tools. Only `developer` is supported.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("developer")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("role") @ExcludeMissing fun _role(): JsonValue = role
+
+        /**
+         * A list of additional tools made available at this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun tools(): List<BetaTool> = tools.getRequired("tools")
+
+        /**
+         * The item type. Always `additional_tools`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("additional_tools")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The unique ID of this additional tools item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun id(): Optional<String> = id.getOptional("id")
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [tools].
+         *
+         * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<BetaTool>> = tools
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [AdditionalTools].
+             *
+             * The following fields are required:
+             * ```java
+             * .tools()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [AdditionalTools]. */
+        class Builder internal constructor() {
+
+            private var role: JsonValue = JsonValue.from("developer")
+            private var tools: JsonField<MutableList<BetaTool>>? = null
+            private var type: JsonValue = JsonValue.from("additional_tools")
+            private var id: JsonField<String> = JsonMissing.of()
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(additionalTools: AdditionalTools) = apply {
+                role = additionalTools.role
+                tools = additionalTools.tools.map { it.toMutableList() }
+                type = additionalTools.type
+                id = additionalTools.id
+                agent = additionalTools.agent
+                additionalProperties = additionalTools.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("developer")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun role(role: JsonValue) = apply { this.role = role }
+
+            /** A list of additional tools made available at this item. */
+            fun tools(tools: List<BetaTool>) = tools(JsonField.of(tools))
+
+            /**
+             * Sets [Builder.tools] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.tools] with a well-typed `List<BetaTool>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun tools(tools: JsonField<List<BetaTool>>) = apply {
+                this.tools = tools.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [BetaTool] to [tools].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addTool(tool: BetaTool) = apply {
+                tools =
+                    (tools ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("tools", it).add(tool)
+                    }
+            }
+
+            /** Alias for calling [addTool] with `BetaTool.ofFunction(function)`. */
+            fun addTool(function: BetaFunctionTool) = addTool(BetaTool.ofFunction(function))
+
+            /** Alias for calling [addTool] with `BetaTool.ofFileSearch(fileSearch)`. */
+            fun addTool(fileSearch: BetaFileSearchTool) = addTool(BetaTool.ofFileSearch(fileSearch))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaFileSearchTool.builder()
+             *     .vectorStoreIds(vectorStoreIds)
+             *     .build()
+             * ```
+             */
+            fun addFileSearchTool(vectorStoreIds: List<String>) =
+                addTool(BetaFileSearchTool.builder().vectorStoreIds(vectorStoreIds).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofComputer(computer)`. */
+            fun addTool(computer: BetaComputerTool) = addTool(BetaTool.ofComputer(computer))
+
+            /**
+             * Alias for calling [addTool] with `BetaTool.ofComputerUsePreview(computerUsePreview)`.
+             */
+            fun addTool(computerUsePreview: BetaComputerUsePreviewTool) =
+                addTool(BetaTool.ofComputerUsePreview(computerUsePreview))
+
+            /** Alias for calling [addTool] with `BetaTool.ofWebSearch(webSearch)`. */
+            fun addTool(webSearch: BetaWebSearchTool) = addTool(BetaTool.ofWebSearch(webSearch))
+
+            /** Alias for calling [addTool] with `BetaTool.ofMcp(mcp)`. */
+            fun addTool(mcp: BetaTool.Mcp) = addTool(BetaTool.ofMcp(mcp))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaTool.Mcp.builder()
+             *     .serverLabel(serverLabel)
+             *     .build()
+             * ```
+             */
+            fun addMcpTool(serverLabel: String) =
+                addTool(BetaTool.Mcp.builder().serverLabel(serverLabel).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofCodeInterpreter(codeInterpreter)`. */
+            fun addTool(codeInterpreter: BetaTool.CodeInterpreter) =
+                addTool(BetaTool.ofCodeInterpreter(codeInterpreter))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaTool.CodeInterpreter.builder()
+             *     .container(container)
+             *     .build()
+             * ```
+             */
+            fun addCodeInterpreterTool(container: BetaTool.CodeInterpreter.Container) =
+                addTool(BetaTool.CodeInterpreter.builder().container(container).build())
+
+            /**
+             * Alias for calling [addCodeInterpreterTool] with
+             * `BetaTool.CodeInterpreter.Container.ofString(string)`.
+             */
+            fun addCodeInterpreterTool(string: String) =
+                addCodeInterpreterTool(BetaTool.CodeInterpreter.Container.ofString(string))
+
+            /**
+             * Alias for calling [addCodeInterpreterTool] with
+             * `BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)`.
+             */
+            fun addCodeInterpreterTool(
+                codeInterpreterToolAuto: BetaTool.CodeInterpreter.Container.CodeInterpreterToolAuto
+            ) =
+                addCodeInterpreterTool(
+                    BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(
+                        codeInterpreterToolAuto
+                    )
+                )
+
+            /** Alias for calling [addTool] with `BetaTool.ofProgrammaticToolCalling()`. */
+            fun addToolProgrammaticToolCalling() = addTool(BetaTool.ofProgrammaticToolCalling())
+
+            /** Alias for calling [addTool] with `BetaTool.ofImageGeneration(imageGeneration)`. */
+            fun addTool(imageGeneration: BetaTool.ImageGeneration) =
+                addTool(BetaTool.ofImageGeneration(imageGeneration))
+
+            /** Alias for calling [addTool] with `BetaTool.ofLocalShell()`. */
+            fun addToolLocalShell() = addTool(BetaTool.ofLocalShell())
+
+            /** Alias for calling [addTool] with `BetaTool.ofShell(shell)`. */
+            fun addTool(shell: BetaFunctionShellTool) = addTool(BetaTool.ofShell(shell))
+
+            /** Alias for calling [addTool] with `BetaTool.ofCustom(custom)`. */
+            fun addTool(custom: BetaCustomTool) = addTool(BetaTool.ofCustom(custom))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaCustomTool.builder()
+             *     .name(name)
+             *     .build()
+             * ```
+             */
+            fun addCustomTool(name: String) = addTool(BetaCustomTool.builder().name(name).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofNamespace(namespace)`. */
+            fun addTool(namespace: BetaNamespaceTool) = addTool(BetaTool.ofNamespace(namespace))
+
+            /** Alias for calling [addTool] with `BetaTool.ofToolSearch(toolSearch)`. */
+            fun addTool(toolSearch: BetaToolSearchTool) = addTool(BetaTool.ofToolSearch(toolSearch))
+
+            /** Alias for calling [addTool] with `BetaTool.ofWebSearchPreview(webSearchPreview)`. */
+            fun addTool(webSearchPreview: BetaWebSearchPreviewTool) =
+                addTool(BetaTool.ofWebSearchPreview(webSearchPreview))
+
+            /** Alias for calling [addTool] with `BetaTool.ofApplyPatch(applyPatch)`. */
+            fun addTool(applyPatch: BetaApplyPatchTool) = addTool(BetaTool.ofApplyPatch(applyPatch))
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("additional_tools")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The unique ID of this additional tools item. */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [AdditionalTools].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .tools()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): AdditionalTools =
+                AdditionalTools(
+                    role,
+                    checkRequired("tools", tools).map { it.toImmutable() },
+                    type,
+                    id,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): AdditionalTools = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _role().let {
+                if (it != JsonValue.from("developer")) {
+                    throw OpenAIInvalidDataException("'role' is invalid, received $it")
+                }
+            }
+            tools().forEach { it.validate() }
+            _type().let {
+                if (it != JsonValue.from("additional_tools")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            id()
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            role.let { if (it == JsonValue.from("developer")) 1 else 0 } +
+                (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                type.let { if (it == JsonValue.from("additional_tools")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AdditionalTools &&
+                role == other.role &&
+                tools == other.tools &&
+                type == other.type &&
+                id == other.id &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(role, tools, type, id, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "AdditionalTools{role=$role, tools=$tools, type=$type, id=$id, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    /** An image generation request made by the model. */
+    class ImageGenerationCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val result: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("result") @ExcludeMissing result: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, result, status, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the image generation call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The generated image encoded in base64.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun result(): Optional<String> = result.getOptional("result")
+
+        /**
+         * The status of the image generation call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The type of the image generation call. Always `image_generation_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("image_generation_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [result].
+         *
+         * Unlike [result], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("result") @ExcludeMissing fun _result(): JsonField<String> = result
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ImageGenerationCall].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .result()
+             * .status()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ImageGenerationCall]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var result: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("image_generation_call")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(imageGenerationCall: ImageGenerationCall) = apply {
+                id = imageGenerationCall.id
+                result = imageGenerationCall.result
+                status = imageGenerationCall.status
+                type = imageGenerationCall.type
+                agent = imageGenerationCall.agent
+                additionalProperties = imageGenerationCall.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the image generation call. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The generated image encoded in base64. */
+            fun result(result: String?) = result(JsonField.ofNullable(result))
+
+            /** Alias for calling [Builder.result] with `result.orElse(null)`. */
+            fun result(result: Optional<String>) = result(result.getOrNull())
+
+            /**
+             * Sets [Builder.result] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.result] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun result(result: JsonField<String>) = apply { this.result = result }
+
+            /** The status of the image generation call. */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("image_generation_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ImageGenerationCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .result()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ImageGenerationCall =
+                ImageGenerationCall(
+                    checkRequired("id", id),
+                    checkRequired("result", result),
+                    checkRequired("status", status),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ImageGenerationCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            result()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("image_generation_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (result.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("image_generation_call")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The status of the image generation call. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val GENERATING = of("generating")
+
+                @JvmField val FAILED = of("failed")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                GENERATING,
+                FAILED,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                GENERATING,
+                FAILED,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    GENERATING -> Value.GENERATING
+                    FAILED -> Value.FAILED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    GENERATING -> Known.GENERATING
+                    FAILED -> Known.FAILED
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ImageGenerationCall &&
+                id == other.id &&
+                result == other.result &&
+                status == other.status &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, result, status, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ImageGenerationCall{id=$id, result=$result, status=$status, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    /** A tool call to run a command on the local shell. */
+    class LocalShellCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val action: JsonField<Action>,
+        private val callId: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, action, callId, status, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the local shell call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * Execute a shell command on the server.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun action(): Action = action.getRequired("action")
+
+        /**
+         * The unique ID of the local shell tool call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The status of the local shell call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The type of the local shell call. Always `local_shell_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("local_shell_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [action].
+         *
+         * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [LocalShellCall].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .action()
+             * .callId()
+             * .status()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [LocalShellCall]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var action: JsonField<Action>? = null
+            private var callId: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("local_shell_call")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(localShellCall: LocalShellCall) = apply {
+                id = localShellCall.id
+                action = localShellCall.action
+                callId = localShellCall.callId
+                status = localShellCall.status
+                type = localShellCall.type
+                agent = localShellCall.agent
+                additionalProperties = localShellCall.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the local shell call. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** Execute a shell command on the server. */
+            fun action(action: Action) = action(JsonField.of(action))
+
+            /**
+             * Sets [Builder.action] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.action] with a well-typed [Action] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun action(action: JsonField<Action>) = apply { this.action = action }
+
+            /** The unique ID of the local shell tool call generated by the model. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The status of the local shell call. */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("local_shell_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [LocalShellCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .action()
+             * .callId()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): LocalShellCall =
+                LocalShellCall(
+                    checkRequired("id", id),
+                    checkRequired("action", action),
+                    checkRequired("callId", callId),
+                    checkRequired("status", status),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): LocalShellCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            action().validate()
+            callId()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("local_shell_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (action.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("local_shell_call")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** Execute a shell command on the server. */
+        class Action
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val command: JsonField<List<String>>,
+            private val env: JsonField<Env>,
+            private val type: JsonValue,
+            private val timeoutMs: JsonField<Long>,
+            private val user: JsonField<String>,
+            private val workingDirectory: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("command")
+                @ExcludeMissing
+                command: JsonField<List<String>> = JsonMissing.of(),
+                @JsonProperty("env") @ExcludeMissing env: JsonField<Env> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                @JsonProperty("timeout_ms")
+                @ExcludeMissing
+                timeoutMs: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("user") @ExcludeMissing user: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("working_directory")
+                @ExcludeMissing
+                workingDirectory: JsonField<String> = JsonMissing.of(),
+            ) : this(command, env, type, timeoutMs, user, workingDirectory, mutableMapOf())
+
+            /**
+             * The command to run.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun command(): List<String> = command.getRequired("command")
+
+            /**
+             * Environment variables to set for the command.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun env(): Env = env.getRequired("env")
+
+            /**
+             * The type of the local shell action. Always `exec`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("exec")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Optional timeout in milliseconds for the command.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun timeoutMs(): Optional<Long> = timeoutMs.getOptional("timeout_ms")
+
+            /**
+             * Optional user to run the command as.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun user(): Optional<String> = user.getOptional("user")
+
+            /**
+             * Optional working directory to run the command in.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun workingDirectory(): Optional<String> =
+                workingDirectory.getOptional("working_directory")
+
+            /**
+             * Returns the raw JSON value of [command].
+             *
+             * Unlike [command], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("command")
+            @ExcludeMissing
+            fun _command(): JsonField<List<String>> = command
+
+            /**
+             * Returns the raw JSON value of [env].
+             *
+             * Unlike [env], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("env") @ExcludeMissing fun _env(): JsonField<Env> = env
+
+            /**
+             * Returns the raw JSON value of [timeoutMs].
+             *
+             * Unlike [timeoutMs], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("timeout_ms")
+            @ExcludeMissing
+            fun _timeoutMs(): JsonField<Long> = timeoutMs
+
+            /**
+             * Returns the raw JSON value of [user].
+             *
+             * Unlike [user], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("user") @ExcludeMissing fun _user(): JsonField<String> = user
+
+            /**
+             * Returns the raw JSON value of [workingDirectory].
+             *
+             * Unlike [workingDirectory], this method doesn't throw if the JSON field has an
+             * unexpected type.
+             */
+            @JsonProperty("working_directory")
+            @ExcludeMissing
+            fun _workingDirectory(): JsonField<String> = workingDirectory
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Action].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .command()
+                 * .env()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Action]. */
+            class Builder internal constructor() {
+
+                private var command: JsonField<MutableList<String>>? = null
+                private var env: JsonField<Env>? = null
+                private var type: JsonValue = JsonValue.from("exec")
+                private var timeoutMs: JsonField<Long> = JsonMissing.of()
+                private var user: JsonField<String> = JsonMissing.of()
+                private var workingDirectory: JsonField<String> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(action: Action) = apply {
+                    command = action.command.map { it.toMutableList() }
+                    env = action.env
+                    type = action.type
+                    timeoutMs = action.timeoutMs
+                    user = action.user
+                    workingDirectory = action.workingDirectory
+                    additionalProperties = action.additionalProperties.toMutableMap()
+                }
+
+                /** The command to run. */
+                fun command(command: List<String>) = command(JsonField.of(command))
+
+                /**
+                 * Sets [Builder.command] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.command] with a well-typed `List<String>` value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun command(command: JsonField<List<String>>) = apply {
+                    this.command = command.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [String] to [Builder.command].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addCommand(command: String) = apply {
+                    this.command =
+                        (this.command ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("command", it).add(command)
+                        }
+                }
+
+                /** Environment variables to set for the command. */
+                fun env(env: Env) = env(JsonField.of(env))
+
+                /**
+                 * Sets [Builder.env] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.env] with a well-typed [Env] value instead. This
+                 * method is primarily for setting the field to an undocumented or not yet supported
+                 * value.
+                 */
+                fun env(env: JsonField<Env>) = apply { this.env = env }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("exec")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                /** Optional timeout in milliseconds for the command. */
+                fun timeoutMs(timeoutMs: Long?) = timeoutMs(JsonField.ofNullable(timeoutMs))
+
+                /**
+                 * Alias for [Builder.timeoutMs].
+                 *
+                 * This unboxed primitive overload exists for backwards compatibility.
+                 */
+                fun timeoutMs(timeoutMs: Long) = timeoutMs(timeoutMs as Long?)
+
+                /** Alias for calling [Builder.timeoutMs] with `timeoutMs.orElse(null)`. */
+                fun timeoutMs(timeoutMs: Optional<Long>) = timeoutMs(timeoutMs.getOrNull())
+
+                /**
+                 * Sets [Builder.timeoutMs] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.timeoutMs] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun timeoutMs(timeoutMs: JsonField<Long>) = apply { this.timeoutMs = timeoutMs }
+
+                /** Optional user to run the command as. */
+                fun user(user: String?) = user(JsonField.ofNullable(user))
+
+                /** Alias for calling [Builder.user] with `user.orElse(null)`. */
+                fun user(user: Optional<String>) = user(user.getOrNull())
+
+                /**
+                 * Sets [Builder.user] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.user] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun user(user: JsonField<String>) = apply { this.user = user }
+
+                /** Optional working directory to run the command in. */
+                fun workingDirectory(workingDirectory: String?) =
+                    workingDirectory(JsonField.ofNullable(workingDirectory))
+
+                /**
+                 * Alias for calling [Builder.workingDirectory] with
+                 * `workingDirectory.orElse(null)`.
+                 */
+                fun workingDirectory(workingDirectory: Optional<String>) =
+                    workingDirectory(workingDirectory.getOrNull())
+
+                /**
+                 * Sets [Builder.workingDirectory] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.workingDirectory] with a well-typed [String]
+                 * value instead. This method is primarily for setting the field to an undocumented
+                 * or not yet supported value.
+                 */
+                fun workingDirectory(workingDirectory: JsonField<String>) = apply {
+                    this.workingDirectory = workingDirectory
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Action].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .command()
+                 * .env()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Action =
+                    Action(
+                        checkRequired("command", command).map { it.toImmutable() },
+                        checkRequired("env", env),
+                        type,
+                        timeoutMs,
+                        user,
+                        workingDirectory,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Action = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                command()
+                env().validate()
+                _type().let {
+                    if (it != JsonValue.from("exec")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                timeoutMs()
+                user()
+                workingDirectory()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (command.asKnown().getOrNull()?.size ?: 0) +
+                    (env.asKnown().getOrNull()?.validity() ?: 0) +
+                    type.let { if (it == JsonValue.from("exec")) 1 else 0 } +
+                    (if (timeoutMs.asKnown().isPresent) 1 else 0) +
+                    (if (user.asKnown().isPresent) 1 else 0) +
+                    (if (workingDirectory.asKnown().isPresent) 1 else 0)
+
+            /** Environment variables to set for the command. */
+            class Env
+            @JsonCreator
+            private constructor(
+                @com.fasterxml.jackson.annotation.JsonValue
+                private val additionalProperties: Map<String, JsonValue>
+            ) {
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /** Returns a mutable builder for constructing an instance of [Env]. */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Env]. */
+                class Builder internal constructor() {
+
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(env: Env) = apply {
+                        additionalProperties = env.additionalProperties.toMutableMap()
+                    }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Env].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     */
+                    fun build(): Env = Env(additionalProperties.toImmutable())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Env = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    additionalProperties.count { (_, value) ->
+                        !value.isNull() && !value.isMissing()
+                    }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Env && additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() = "Env{additionalProperties=$additionalProperties}"
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Action &&
+                    command == other.command &&
+                    env == other.env &&
+                    type == other.type &&
+                    timeoutMs == other.timeoutMs &&
+                    user == other.user &&
+                    workingDirectory == other.workingDirectory &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(
+                    command,
+                    env,
+                    type,
+                    timeoutMs,
+                    user,
+                    workingDirectory,
+                    additionalProperties,
+                )
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Action{command=$command, env=$env, type=$type, timeoutMs=$timeoutMs, user=$user, workingDirectory=$workingDirectory, additionalProperties=$additionalProperties}"
+        }
+
+        /** The status of the local shell call. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is LocalShellCall &&
+                id == other.id &&
+                action == other.action &&
+                callId == other.callId &&
+                status == other.status &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, action, callId, status, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "LocalShellCall{id=$id, action=$action, callId=$callId, status=$status, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    /** The output of a local shell tool call. */
+    class LocalShellCallOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val output: JsonField<String>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val status: JsonField<Status>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("output") @ExcludeMissing output: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        ) : this(id, output, type, agent, status, mutableMapOf())
+
+        /**
+         * The unique ID of the local shell tool call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * A JSON string of the output of the local shell tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun output(): String = output.getRequired("output")
+
+        /**
+         * The type of the local shell tool call output. Always `local_shell_call_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("local_shell_call_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun status(): Optional<Status> = status.getOptional("status")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<String> = output
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [LocalShellCallOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .output()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [LocalShellCallOutput]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var output: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("local_shell_call_output")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var status: JsonField<Status> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(localShellCallOutput: LocalShellCallOutput) = apply {
+                id = localShellCallOutput.id
+                output = localShellCallOutput.output
+                type = localShellCallOutput.type
+                agent = localShellCallOutput.agent
+                status = localShellCallOutput.status
+                additionalProperties = localShellCallOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the local shell tool call generated by the model. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** A JSON string of the output of the local shell tool call. */
+            fun output(output: String) = output(JsonField.of(output))
+
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun output(output: JsonField<String>) = apply { this.output = output }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("local_shell_call_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /** The status of the item. One of `in_progress`, `completed`, or `incomplete`. */
+            fun status(status: Status?) = status(JsonField.ofNullable(status))
+
+            /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+            fun status(status: Optional<Status>) = status(status.getOrNull())
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [LocalShellCallOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .output()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): LocalShellCallOutput =
+                LocalShellCallOutput(
+                    checkRequired("id", id),
+                    checkRequired("output", output),
+                    type,
+                    agent,
+                    status,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): LocalShellCallOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            output()
+            _type().let {
+                if (it != JsonValue.from("local_shell_call_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            status().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (output.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("local_shell_call_output")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        /** The status of the item. One of `in_progress`, `completed`, or `incomplete`. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is LocalShellCallOutput &&
+                id == other.id &&
+                output == other.output &&
+                type == other.type &&
+                agent == other.agent &&
+                status == other.status &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, output, type, agent, status, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "LocalShellCallOutput{id=$id, output=$output, type=$type, agent=$agent, status=$status, additionalProperties=$additionalProperties}"
+    }
+
+    /** A tool representing a request to execute one or more shell commands. */
+    class ShellCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val action: JsonField<Action>,
+        private val callId: JsonField<String>,
+        private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val agent: JsonField<Agent>,
+        private val caller: JsonField<Caller>,
+        private val environment: JsonField<Environment>,
+        private val status: JsonField<Status>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+            @JsonProperty("environment")
+            @ExcludeMissing
+            environment: JsonField<Environment> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        ) : this(action, callId, type, id, agent, caller, environment, status, mutableMapOf())
+
+        /**
+         * The shell commands and limits that describe how to run the tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun action(): Action = action.getRequired("action")
+
+        /**
+         * The unique ID of the shell tool call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The type of the item. Always `shell_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("shell_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The unique ID of the shell tool call. Populated when this item is returned via API.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun id(): Optional<String> = id.getOptional("id")
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * The execution context that produced this tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun caller(): Optional<Caller> = caller.getOptional("caller")
+
+        /**
+         * The environment to execute the shell commands in.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun environment(): Optional<Environment> = environment.getOptional("environment")
+
+        /**
+         * The status of the shell call. One of `in_progress`, `completed`, or `incomplete`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun status(): Optional<Status> = status.getOptional("status")
+
+        /**
+         * Returns the raw JSON value of [action].
+         *
+         * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [caller].
+         *
+         * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
+        /**
+         * Returns the raw JSON value of [environment].
+         *
+         * Unlike [environment], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("environment")
+        @ExcludeMissing
+        fun _environment(): JsonField<Environment> = environment
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ShellCall].
+             *
+             * The following fields are required:
+             * ```java
+             * .action()
+             * .callId()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ShellCall]. */
+        class Builder internal constructor() {
+
+            private var action: JsonField<Action>? = null
+            private var callId: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("shell_call")
+            private var id: JsonField<String> = JsonMissing.of()
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var caller: JsonField<Caller> = JsonMissing.of()
+            private var environment: JsonField<Environment> = JsonMissing.of()
+            private var status: JsonField<Status> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(shellCall: ShellCall) = apply {
+                action = shellCall.action
+                callId = shellCall.callId
+                type = shellCall.type
+                id = shellCall.id
+                agent = shellCall.agent
+                caller = shellCall.caller
+                environment = shellCall.environment
+                status = shellCall.status
+                additionalProperties = shellCall.additionalProperties.toMutableMap()
+            }
+
+            /** The shell commands and limits that describe how to run the tool call. */
+            fun action(action: Action) = action(JsonField.of(action))
+
+            /**
+             * Sets [Builder.action] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.action] with a well-typed [Action] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun action(action: JsonField<Action>) = apply { this.action = action }
+
+            /** The unique ID of the shell tool call generated by the model. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("shell_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /**
+             * The unique ID of the shell tool call. Populated when this item is returned via API.
+             */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /** The execution context that produced this tool call. */
+            fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+            /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+            fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+            /**
+             * Sets [Builder.caller] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.caller] with a well-typed [Caller] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+            /** Alias for calling [caller] with `Caller.ofDirect()`. */
+            fun callerDirect() = caller(Caller.ofDirect())
+
+            /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+            fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+            /**
+             * Alias for calling [caller] with the following:
+             * ```java
+             * Caller.Program.builder()
+             *     .callerId(callerId)
+             *     .build()
+             * ```
+             */
+            fun programCaller(callerId: String) =
+                caller(Caller.Program.builder().callerId(callerId).build())
+
+            /** The environment to execute the shell commands in. */
+            fun environment(environment: Environment?) =
+                environment(JsonField.ofNullable(environment))
+
+            /** Alias for calling [Builder.environment] with `environment.orElse(null)`. */
+            fun environment(environment: Optional<Environment>) =
+                environment(environment.getOrNull())
+
+            /**
+             * Sets [Builder.environment] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.environment] with a well-typed [Environment] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun environment(environment: JsonField<Environment>) = apply {
+                this.environment = environment
+            }
+
+            /** Alias for calling [environment] with `Environment.ofLocal(local)`. */
+            fun environment(local: BetaLocalEnvironment) = environment(Environment.ofLocal(local))
+
+            /**
+             * Alias for calling [environment] with
+             * `Environment.ofContainerReference(containerReference)`.
+             */
+            fun environment(containerReference: BetaContainerReference) =
+                environment(Environment.ofContainerReference(containerReference))
+
+            /**
+             * Alias for calling [environment] with the following:
+             * ```java
+             * BetaContainerReference.builder()
+             *     .containerId(containerId)
+             *     .build()
+             * ```
+             */
+            fun containerReferenceEnvironment(containerId: String) =
+                environment(BetaContainerReference.builder().containerId(containerId).build())
+
+            /** The status of the shell call. One of `in_progress`, `completed`, or `incomplete`. */
+            fun status(status: Status?) = status(JsonField.ofNullable(status))
+
+            /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+            fun status(status: Optional<Status>) = status(status.getOrNull())
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ShellCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .action()
+             * .callId()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ShellCall =
+                ShellCall(
+                    checkRequired("action", action),
+                    checkRequired("callId", callId),
+                    type,
+                    id,
+                    agent,
+                    caller,
+                    environment,
+                    status,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ShellCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            action().validate()
+            callId()
+            _type().let {
+                if (it != JsonValue.from("shell_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            id()
+            agent().ifPresent { it.validate() }
+            caller().ifPresent { it.validate() }
+            environment().ifPresent { it.validate() }
+            status().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (action.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("shell_call")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (caller.asKnown().getOrNull()?.validity() ?: 0) +
+                (environment.asKnown().getOrNull()?.validity() ?: 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The shell commands and limits that describe how to run the tool call. */
+        class Action
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val commands: JsonField<List<String>>,
+            private val maxOutputLength: JsonField<Long>,
+            private val timeoutMs: JsonField<Long>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("commands")
+                @ExcludeMissing
+                commands: JsonField<List<String>> = JsonMissing.of(),
+                @JsonProperty("max_output_length")
+                @ExcludeMissing
+                maxOutputLength: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("timeout_ms")
+                @ExcludeMissing
+                timeoutMs: JsonField<Long> = JsonMissing.of(),
+            ) : this(commands, maxOutputLength, timeoutMs, mutableMapOf())
+
+            /**
+             * Ordered shell commands for the execution environment to run.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun commands(): List<String> = commands.getRequired("commands")
+
+            /**
+             * Maximum number of UTF-8 characters to capture from combined stdout and stderr output.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun maxOutputLength(): Optional<Long> = maxOutputLength.getOptional("max_output_length")
+
+            /**
+             * Maximum wall-clock time in milliseconds to allow the shell commands to run.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun timeoutMs(): Optional<Long> = timeoutMs.getOptional("timeout_ms")
+
+            /**
+             * Returns the raw JSON value of [commands].
+             *
+             * Unlike [commands], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("commands")
+            @ExcludeMissing
+            fun _commands(): JsonField<List<String>> = commands
+
+            /**
+             * Returns the raw JSON value of [maxOutputLength].
+             *
+             * Unlike [maxOutputLength], this method doesn't throw if the JSON field has an
+             * unexpected type.
+             */
+            @JsonProperty("max_output_length")
+            @ExcludeMissing
+            fun _maxOutputLength(): JsonField<Long> = maxOutputLength
+
+            /**
+             * Returns the raw JSON value of [timeoutMs].
+             *
+             * Unlike [timeoutMs], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("timeout_ms")
+            @ExcludeMissing
+            fun _timeoutMs(): JsonField<Long> = timeoutMs
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Action].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .commands()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Action]. */
+            class Builder internal constructor() {
+
+                private var commands: JsonField<MutableList<String>>? = null
+                private var maxOutputLength: JsonField<Long> = JsonMissing.of()
+                private var timeoutMs: JsonField<Long> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(action: Action) = apply {
+                    commands = action.commands.map { it.toMutableList() }
+                    maxOutputLength = action.maxOutputLength
+                    timeoutMs = action.timeoutMs
+                    additionalProperties = action.additionalProperties.toMutableMap()
+                }
+
+                /** Ordered shell commands for the execution environment to run. */
+                fun commands(commands: List<String>) = commands(JsonField.of(commands))
+
+                /**
+                 * Sets [Builder.commands] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.commands] with a well-typed `List<String>` value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun commands(commands: JsonField<List<String>>) = apply {
+                    this.commands = commands.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [String] to [commands].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addCommand(command: String) = apply {
+                    commands =
+                        (commands ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("commands", it).add(command)
+                        }
+                }
+
+                /**
+                 * Maximum number of UTF-8 characters to capture from combined stdout and stderr
+                 * output.
+                 */
+                fun maxOutputLength(maxOutputLength: Long?) =
+                    maxOutputLength(JsonField.ofNullable(maxOutputLength))
+
+                /**
+                 * Alias for [Builder.maxOutputLength].
+                 *
+                 * This unboxed primitive overload exists for backwards compatibility.
+                 */
+                fun maxOutputLength(maxOutputLength: Long) =
+                    maxOutputLength(maxOutputLength as Long?)
+
+                /**
+                 * Alias for calling [Builder.maxOutputLength] with `maxOutputLength.orElse(null)`.
+                 */
+                fun maxOutputLength(maxOutputLength: Optional<Long>) =
+                    maxOutputLength(maxOutputLength.getOrNull())
+
+                /**
+                 * Sets [Builder.maxOutputLength] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.maxOutputLength] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun maxOutputLength(maxOutputLength: JsonField<Long>) = apply {
+                    this.maxOutputLength = maxOutputLength
+                }
+
+                /** Maximum wall-clock time in milliseconds to allow the shell commands to run. */
+                fun timeoutMs(timeoutMs: Long?) = timeoutMs(JsonField.ofNullable(timeoutMs))
+
+                /**
+                 * Alias for [Builder.timeoutMs].
+                 *
+                 * This unboxed primitive overload exists for backwards compatibility.
+                 */
+                fun timeoutMs(timeoutMs: Long) = timeoutMs(timeoutMs as Long?)
+
+                /** Alias for calling [Builder.timeoutMs] with `timeoutMs.orElse(null)`. */
+                fun timeoutMs(timeoutMs: Optional<Long>) = timeoutMs(timeoutMs.getOrNull())
+
+                /**
+                 * Sets [Builder.timeoutMs] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.timeoutMs] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun timeoutMs(timeoutMs: JsonField<Long>) = apply { this.timeoutMs = timeoutMs }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Action].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .commands()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Action =
+                    Action(
+                        checkRequired("commands", commands).map { it.toImmutable() },
+                        maxOutputLength,
+                        timeoutMs,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Action = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                commands()
+                maxOutputLength()
+                timeoutMs()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (commands.asKnown().getOrNull()?.size ?: 0) +
+                    (if (maxOutputLength.asKnown().isPresent) 1 else 0) +
+                    (if (timeoutMs.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Action &&
+                    commands == other.commands &&
+                    maxOutputLength == other.maxOutputLength &&
+                    timeoutMs == other.timeoutMs &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(commands, maxOutputLength, timeoutMs, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Action{commands=$commands, maxOutputLength=$maxOutputLength, timeoutMs=$timeoutMs, additionalProperties=$additionalProperties}"
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        /** The execution context that produced this tool call. */
+        @JsonDeserialize(using = Caller.Deserializer::class)
+        @JsonSerialize(using = Caller.Serializer::class)
+        class Caller
+        private constructor(
+            private val direct: JsonValue? = null,
+            private val program: Program? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+            fun program(): Optional<Program> = Optional.ofNullable(program)
+
+            fun isDirect(): Boolean = direct != null
+
+            fun isProgram(): Boolean = program != null
+
+            fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+            fun asProgram(): Program = program.getOrThrow("program")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitDirect(JsonValue direct) {
+             *         return Optional.of(direct.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    direct != null -> visitor.visitDirect(direct)
+                    program != null -> visitor.visitProgram(program)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Caller = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitDirect(direct: JsonValue) {
+                            direct.let {
+                                if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                    throw OpenAIInvalidDataException(
+                                        "'direct' is invalid, received $it"
+                                    )
+                                }
+                            }
+                        }
+
+                        override fun visitProgram(program: Program) {
+                            program.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitDirect(direct: JsonValue) =
+                            direct.let {
+                                if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0
+                            }
+
+                        override fun visitProgram(program: Program) = program.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Caller && direct == other.direct && program == other.program
+            }
+
+            override fun hashCode(): Int = Objects.hash(direct, program)
+
+            override fun toString(): String =
+                when {
+                    direct != null -> "Caller{direct=$direct}"
+                    program != null -> "Caller{program=$program}"
+                    _json != null -> "Caller{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+
+            companion object {
+
+                @JvmStatic
+                fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+                @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Caller] to a value of type [T].
+             */
+            interface Visitor<out T> {
+
+                fun visitDirect(direct: JsonValue): T
+
+                fun visitProgram(program: Program): T
+
+                /**
+                 * Maps an unknown variant of [Caller] to a value of type [T].
+                 *
+                 * An instance of [Caller] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Caller: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "direct" -> {
+                            return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let { Caller(direct = it, _json = json) }
+                                ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                        }
+                        "program" -> {
+                            return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                                Caller(program = it, _json = json)
+                            } ?: Caller(_json = json)
+                        }
+                    }
+
+                    return Caller(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+                override fun serialize(
+                    value: Caller,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.direct != null -> generator.writeObject(value.direct)
+                        value.program != null -> generator.writeObject(value.program)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Caller")
+                    }
+                }
+            }
+
+            class Program
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val callerId: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("caller_id")
+                    @ExcludeMissing
+                    callerId: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(callerId, type, mutableMapOf())
+
+                /**
+                 * The call ID of the program item that produced this tool call.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun callerId(): String = callerId.getRequired("caller_id")
+
+                /**
+                 * The caller type. Always `program`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [callerId].
+                 *
+                 * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                fun _callerId(): JsonField<String> = callerId
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Program].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Program]. */
+                class Builder internal constructor() {
+
+                    private var callerId: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("program")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(program: Program) = apply {
+                        callerId = program.callerId
+                        type = program.type
+                        additionalProperties = program.additionalProperties.toMutableMap()
+                    }
+
+                    /** The call ID of the program item that produced this tool call. */
+                    fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                    /**
+                     * Sets [Builder.callerId] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.callerId] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("program")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Program].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Program =
+                        Program(
+                            checkRequired("callerId", callerId),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Program = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    callerId()
+                    _type().let {
+                        if (it != JsonValue.from("program")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (callerId.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Program &&
+                        callerId == other.callerId &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(callerId, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        /** The environment to execute the shell commands in. */
+        @JsonDeserialize(using = Environment.Deserializer::class)
+        @JsonSerialize(using = Environment.Serializer::class)
+        class Environment
+        private constructor(
+            private val local: BetaLocalEnvironment? = null,
+            private val containerReference: BetaContainerReference? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            fun local(): Optional<BetaLocalEnvironment> = Optional.ofNullable(local)
+
+            fun containerReference(): Optional<BetaContainerReference> =
+                Optional.ofNullable(containerReference)
+
+            fun isLocal(): Boolean = local != null
+
+            fun isContainerReference(): Boolean = containerReference != null
+
+            fun asLocal(): BetaLocalEnvironment = local.getOrThrow("local")
+
+            fun asContainerReference(): BetaContainerReference =
+                containerReference.getOrThrow("containerReference")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = environment.accept(new Environment.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitLocal(BetaLocalEnvironment local) {
+             *         return Optional.of(local.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    local != null -> visitor.visitLocal(local)
+                    containerReference != null ->
+                        visitor.visitContainerReference(containerReference)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Environment = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitLocal(local: BetaLocalEnvironment) {
+                            local.validate()
+                        }
+
+                        override fun visitContainerReference(
+                            containerReference: BetaContainerReference
+                        ) {
+                            containerReference.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitLocal(local: BetaLocalEnvironment) = local.validity()
+
+                        override fun visitContainerReference(
+                            containerReference: BetaContainerReference
+                        ) = containerReference.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Environment &&
+                    local == other.local &&
+                    containerReference == other.containerReference
+            }
+
+            override fun hashCode(): Int = Objects.hash(local, containerReference)
+
+            override fun toString(): String =
+                when {
+                    local != null -> "Environment{local=$local}"
+                    containerReference != null ->
+                        "Environment{containerReference=$containerReference}"
+                    _json != null -> "Environment{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Environment")
+                }
+
+            companion object {
+
+                @JvmStatic fun ofLocal(local: BetaLocalEnvironment) = Environment(local = local)
+
+                @JvmStatic
+                fun ofContainerReference(containerReference: BetaContainerReference) =
+                    Environment(containerReference = containerReference)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Environment] to a value of type
+             * [T].
+             */
+            interface Visitor<out T> {
+
+                fun visitLocal(local: BetaLocalEnvironment): T
+
+                fun visitContainerReference(containerReference: BetaContainerReference): T
+
+                /**
+                 * Maps an unknown variant of [Environment] to a value of type [T].
+                 *
+                 * An instance of [Environment] can contain an unknown variant if it was
+                 * deserialized from data that doesn't match any known variant. For example, if the
+                 * SDK is on an older version than the API, then the API may respond with new
+                 * variants that the SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Environment: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Environment>(Environment::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Environment {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "local" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaLocalEnvironment>())
+                                ?.let { Environment(local = it, _json = json) }
+                                ?: Environment(_json = json)
+                        }
+                        "container_reference" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaContainerReference>())
+                                ?.let { Environment(containerReference = it, _json = json) }
+                                ?: Environment(_json = json)
+                        }
+                    }
+
+                    return Environment(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Environment>(Environment::class) {
+
+                override fun serialize(
+                    value: Environment,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.local != null -> generator.writeObject(value.local)
+                        value.containerReference != null ->
+                            generator.writeObject(value.containerReference)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Environment")
+                    }
+                }
+            }
+        }
+
+        /** The status of the shell call. One of `in_progress`, `completed`, or `incomplete`. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ShellCall &&
+                action == other.action &&
+                callId == other.callId &&
+                type == other.type &&
+                id == other.id &&
+                agent == other.agent &&
+                caller == other.caller &&
+                environment == other.environment &&
+                status == other.status &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                action,
+                callId,
+                type,
+                id,
+                agent,
+                caller,
+                environment,
+                status,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ShellCall{action=$action, callId=$callId, type=$type, id=$id, agent=$agent, caller=$caller, environment=$environment, status=$status, additionalProperties=$additionalProperties}"
+    }
+
+    /** The streamed output items emitted by a shell tool call. */
+    class ShellCallOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val callId: JsonField<String>,
+        private val output: JsonField<List<BetaResponseFunctionShellCallOutputContent>>,
+        private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val agent: JsonField<Agent>,
+        private val caller: JsonField<Caller>,
+        private val maxOutputLength: JsonField<Long>,
+        private val status: JsonField<Status>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("output")
+            @ExcludeMissing
+            output: JsonField<List<BetaResponseFunctionShellCallOutputContent>> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+            @JsonProperty("max_output_length")
+            @ExcludeMissing
+            maxOutputLength: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        ) : this(callId, output, type, id, agent, caller, maxOutputLength, status, mutableMapOf())
+
+        /**
+         * The unique ID of the shell tool call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * Captured chunks of stdout and stderr output, along with their associated outcomes.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun output(): List<BetaResponseFunctionShellCallOutputContent> =
+            output.getRequired("output")
+
+        /**
+         * The type of the item. Always `shell_call_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("shell_call_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The unique ID of the shell tool call output. Populated when this item is returned via
+         * API.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun id(): Optional<String> = id.getOptional("id")
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * The execution context that produced this tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun caller(): Optional<Caller> = caller.getOptional("caller")
+
+        /**
+         * The maximum number of UTF-8 characters captured for this shell call's combined output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun maxOutputLength(): Optional<Long> = maxOutputLength.getOptional("max_output_length")
+
+        /**
+         * The status of the shell call output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun status(): Optional<Status> = status.getOptional("status")
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output")
+        @ExcludeMissing
+        fun _output(): JsonField<List<BetaResponseFunctionShellCallOutputContent>> = output
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [caller].
+         *
+         * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
+        /**
+         * Returns the raw JSON value of [maxOutputLength].
+         *
+         * Unlike [maxOutputLength], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("max_output_length")
+        @ExcludeMissing
+        fun _maxOutputLength(): JsonField<Long> = maxOutputLength
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ShellCallOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .callId()
+             * .output()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ShellCallOutput]. */
+        class Builder internal constructor() {
+
+            private var callId: JsonField<String>? = null
+            private var output:
+                JsonField<MutableList<BetaResponseFunctionShellCallOutputContent>>? =
+                null
+            private var type: JsonValue = JsonValue.from("shell_call_output")
+            private var id: JsonField<String> = JsonMissing.of()
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var caller: JsonField<Caller> = JsonMissing.of()
+            private var maxOutputLength: JsonField<Long> = JsonMissing.of()
+            private var status: JsonField<Status> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(shellCallOutput: ShellCallOutput) = apply {
+                callId = shellCallOutput.callId
+                output = shellCallOutput.output.map { it.toMutableList() }
+                type = shellCallOutput.type
+                id = shellCallOutput.id
+                agent = shellCallOutput.agent
+                caller = shellCallOutput.caller
+                maxOutputLength = shellCallOutput.maxOutputLength
+                status = shellCallOutput.status
+                additionalProperties = shellCallOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the shell tool call generated by the model. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /**
+             * Captured chunks of stdout and stderr output, along with their associated outcomes.
+             */
+            fun output(output: List<BetaResponseFunctionShellCallOutputContent>) =
+                output(JsonField.of(output))
+
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed
+             * `List<BetaResponseFunctionShellCallOutputContent>` value instead. This method is
+             * primarily for setting the field to an undocumented or not yet supported value.
+             */
+            fun output(output: JsonField<List<BetaResponseFunctionShellCallOutputContent>>) =
+                apply {
+                    this.output = output.map { it.toMutableList() }
+                }
+
+            /**
+             * Adds a single [BetaResponseFunctionShellCallOutputContent] to [Builder.output].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addOutput(output: BetaResponseFunctionShellCallOutputContent) = apply {
+                this.output =
+                    (this.output ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("output", it).add(output)
+                    }
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("shell_call_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /**
+             * The unique ID of the shell tool call output. Populated when this item is returned via
+             * API.
+             */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /** The execution context that produced this tool call. */
+            fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+            /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+            fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+            /**
+             * Sets [Builder.caller] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.caller] with a well-typed [Caller] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+            /** Alias for calling [caller] with `Caller.ofDirect()`. */
+            fun callerDirect() = caller(Caller.ofDirect())
+
+            /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+            fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+            /**
+             * Alias for calling [caller] with the following:
+             * ```java
+             * Caller.Program.builder()
+             *     .callerId(callerId)
+             *     .build()
+             * ```
+             */
+            fun programCaller(callerId: String) =
+                caller(Caller.Program.builder().callerId(callerId).build())
+
+            /**
+             * The maximum number of UTF-8 characters captured for this shell call's combined
+             * output.
+             */
+            fun maxOutputLength(maxOutputLength: Long?) =
+                maxOutputLength(JsonField.ofNullable(maxOutputLength))
+
+            /**
+             * Alias for [Builder.maxOutputLength].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun maxOutputLength(maxOutputLength: Long) = maxOutputLength(maxOutputLength as Long?)
+
+            /** Alias for calling [Builder.maxOutputLength] with `maxOutputLength.orElse(null)`. */
+            fun maxOutputLength(maxOutputLength: Optional<Long>) =
+                maxOutputLength(maxOutputLength.getOrNull())
+
+            /**
+             * Sets [Builder.maxOutputLength] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.maxOutputLength] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun maxOutputLength(maxOutputLength: JsonField<Long>) = apply {
+                this.maxOutputLength = maxOutputLength
+            }
+
+            /** The status of the shell call output. */
+            fun status(status: Status?) = status(JsonField.ofNullable(status))
+
+            /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+            fun status(status: Optional<Status>) = status(status.getOrNull())
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ShellCallOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .callId()
+             * .output()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ShellCallOutput =
+                ShellCallOutput(
+                    checkRequired("callId", callId),
+                    checkRequired("output", output).map { it.toImmutable() },
+                    type,
+                    id,
+                    agent,
+                    caller,
+                    maxOutputLength,
+                    status,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ShellCallOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            callId()
+            output().forEach { it.validate() }
+            _type().let {
+                if (it != JsonValue.from("shell_call_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            id()
+            agent().ifPresent { it.validate() }
+            caller().ifPresent { it.validate() }
+            maxOutputLength()
+            status().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (callId.asKnown().isPresent) 1 else 0) +
+                (output.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                type.let { if (it == JsonValue.from("shell_call_output")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (caller.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (maxOutputLength.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        /** The execution context that produced this tool call. */
+        @JsonDeserialize(using = Caller.Deserializer::class)
+        @JsonSerialize(using = Caller.Serializer::class)
+        class Caller
+        private constructor(
+            private val direct: JsonValue? = null,
+            private val program: Program? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+            fun program(): Optional<Program> = Optional.ofNullable(program)
+
+            fun isDirect(): Boolean = direct != null
+
+            fun isProgram(): Boolean = program != null
+
+            fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+            fun asProgram(): Program = program.getOrThrow("program")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitDirect(JsonValue direct) {
+             *         return Optional.of(direct.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    direct != null -> visitor.visitDirect(direct)
+                    program != null -> visitor.visitProgram(program)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Caller = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitDirect(direct: JsonValue) {
+                            direct.let {
+                                if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                    throw OpenAIInvalidDataException(
+                                        "'direct' is invalid, received $it"
+                                    )
+                                }
+                            }
+                        }
+
+                        override fun visitProgram(program: Program) {
+                            program.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitDirect(direct: JsonValue) =
+                            direct.let {
+                                if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0
+                            }
+
+                        override fun visitProgram(program: Program) = program.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Caller && direct == other.direct && program == other.program
+            }
+
+            override fun hashCode(): Int = Objects.hash(direct, program)
+
+            override fun toString(): String =
+                when {
+                    direct != null -> "Caller{direct=$direct}"
+                    program != null -> "Caller{program=$program}"
+                    _json != null -> "Caller{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+
+            companion object {
+
+                @JvmStatic
+                fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+                @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Caller] to a value of type [T].
+             */
+            interface Visitor<out T> {
+
+                fun visitDirect(direct: JsonValue): T
+
+                fun visitProgram(program: Program): T
+
+                /**
+                 * Maps an unknown variant of [Caller] to a value of type [T].
+                 *
+                 * An instance of [Caller] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Caller: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "direct" -> {
+                            return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let { Caller(direct = it, _json = json) }
+                                ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                        }
+                        "program" -> {
+                            return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                                Caller(program = it, _json = json)
+                            } ?: Caller(_json = json)
+                        }
+                    }
+
+                    return Caller(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+                override fun serialize(
+                    value: Caller,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.direct != null -> generator.writeObject(value.direct)
+                        value.program != null -> generator.writeObject(value.program)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Caller")
+                    }
+                }
+            }
+
+            class Program
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val callerId: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("caller_id")
+                    @ExcludeMissing
+                    callerId: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(callerId, type, mutableMapOf())
+
+                /**
+                 * The call ID of the program item that produced this tool call.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun callerId(): String = callerId.getRequired("caller_id")
+
+                /**
+                 * The caller type. Always `program`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [callerId].
+                 *
+                 * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                fun _callerId(): JsonField<String> = callerId
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Program].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Program]. */
+                class Builder internal constructor() {
+
+                    private var callerId: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("program")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(program: Program) = apply {
+                        callerId = program.callerId
+                        type = program.type
+                        additionalProperties = program.additionalProperties.toMutableMap()
+                    }
+
+                    /** The call ID of the program item that produced this tool call. */
+                    fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                    /**
+                     * Sets [Builder.callerId] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.callerId] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("program")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Program].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Program =
+                        Program(
+                            checkRequired("callerId", callerId),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Program = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    callerId()
+                    _type().let {
+                        if (it != JsonValue.from("program")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (callerId.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Program &&
+                        callerId == other.callerId &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(callerId, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        /** The status of the shell call output. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ShellCallOutput &&
+                callId == other.callId &&
+                output == other.output &&
+                type == other.type &&
+                id == other.id &&
+                agent == other.agent &&
+                caller == other.caller &&
+                maxOutputLength == other.maxOutputLength &&
+                status == other.status &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                callId,
+                output,
+                type,
+                id,
+                agent,
+                caller,
+                maxOutputLength,
+                status,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ShellCallOutput{callId=$callId, output=$output, type=$type, id=$id, agent=$agent, caller=$caller, maxOutputLength=$maxOutputLength, status=$status, additionalProperties=$additionalProperties}"
+    }
+
+    /** A tool call representing a request to create, delete, or update files using diff patches. */
+    class ApplyPatchCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val callId: JsonField<String>,
+        private val operation: JsonField<Operation>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val agent: JsonField<Agent>,
+        private val caller: JsonField<Caller>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("operation")
+            @ExcludeMissing
+            operation: JsonField<Operation> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+        ) : this(callId, operation, status, type, id, agent, caller, mutableMapOf())
+
+        /**
+         * The unique ID of the apply patch tool call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The specific create, delete, or update instruction for the apply_patch tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun operation(): Operation = operation.getRequired("operation")
+
+        /**
+         * The status of the apply patch tool call. One of `in_progress` or `completed`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The type of the item. Always `apply_patch_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("apply_patch_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The unique ID of the apply patch tool call. Populated when this item is returned via API.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun id(): Optional<String> = id.getOptional("id")
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * The execution context that produced this tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun caller(): Optional<Caller> = caller.getOptional("caller")
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [operation].
+         *
+         * Unlike [operation], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("operation")
+        @ExcludeMissing
+        fun _operation(): JsonField<Operation> = operation
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [caller].
+         *
+         * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ApplyPatchCall].
+             *
+             * The following fields are required:
+             * ```java
+             * .callId()
+             * .operation()
+             * .status()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ApplyPatchCall]. */
+        class Builder internal constructor() {
+
+            private var callId: JsonField<String>? = null
+            private var operation: JsonField<Operation>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("apply_patch_call")
+            private var id: JsonField<String> = JsonMissing.of()
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var caller: JsonField<Caller> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(applyPatchCall: ApplyPatchCall) = apply {
+                callId = applyPatchCall.callId
+                operation = applyPatchCall.operation
+                status = applyPatchCall.status
+                type = applyPatchCall.type
+                id = applyPatchCall.id
+                agent = applyPatchCall.agent
+                caller = applyPatchCall.caller
+                additionalProperties = applyPatchCall.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the apply patch tool call generated by the model. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The specific create, delete, or update instruction for the apply_patch tool call. */
+            fun operation(operation: Operation) = operation(JsonField.of(operation))
+
+            /**
+             * Sets [Builder.operation] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.operation] with a well-typed [Operation] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun operation(operation: JsonField<Operation>) = apply { this.operation = operation }
+
+            /** Alias for calling [operation] with `Operation.ofCreateFile(createFile)`. */
+            fun operation(createFile: Operation.CreateFile) =
+                operation(Operation.ofCreateFile(createFile))
+
+            /** Alias for calling [operation] with `Operation.ofDeleteFile(deleteFile)`. */
+            fun operation(deleteFile: Operation.DeleteFile) =
+                operation(Operation.ofDeleteFile(deleteFile))
+
+            /**
+             * Alias for calling [operation] with the following:
+             * ```java
+             * Operation.DeleteFile.builder()
+             *     .path(path)
+             *     .build()
+             * ```
+             */
+            fun deleteFileOperation(path: String) =
+                operation(Operation.DeleteFile.builder().path(path).build())
+
+            /** Alias for calling [operation] with `Operation.ofUpdateFile(updateFile)`. */
+            fun operation(updateFile: Operation.UpdateFile) =
+                operation(Operation.ofUpdateFile(updateFile))
+
+            /** The status of the apply patch tool call. One of `in_progress` or `completed`. */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("apply_patch_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /**
+             * The unique ID of the apply patch tool call. Populated when this item is returned via
+             * API.
+             */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /** The execution context that produced this tool call. */
+            fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+            /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+            fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+            /**
+             * Sets [Builder.caller] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.caller] with a well-typed [Caller] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+            /** Alias for calling [caller] with `Caller.ofDirect()`. */
+            fun callerDirect() = caller(Caller.ofDirect())
+
+            /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+            fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+            /**
+             * Alias for calling [caller] with the following:
+             * ```java
+             * Caller.Program.builder()
+             *     .callerId(callerId)
+             *     .build()
+             * ```
+             */
+            fun programCaller(callerId: String) =
+                caller(Caller.Program.builder().callerId(callerId).build())
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ApplyPatchCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .callId()
+             * .operation()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ApplyPatchCall =
+                ApplyPatchCall(
+                    checkRequired("callId", callId),
+                    checkRequired("operation", operation),
+                    checkRequired("status", status),
+                    type,
+                    id,
+                    agent,
+                    caller,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ApplyPatchCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            callId()
+            operation().validate()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("apply_patch_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            id()
+            agent().ifPresent { it.validate() }
+            caller().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (callId.asKnown().isPresent) 1 else 0) +
+                (operation.asKnown().getOrNull()?.validity() ?: 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("apply_patch_call")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (caller.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The specific create, delete, or update instruction for the apply_patch tool call. */
+        @JsonDeserialize(using = Operation.Deserializer::class)
+        @JsonSerialize(using = Operation.Serializer::class)
+        class Operation
+        private constructor(
+            private val createFile: CreateFile? = null,
+            private val deleteFile: DeleteFile? = null,
+            private val updateFile: UpdateFile? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /** Instruction for creating a new file via the apply_patch tool. */
+            fun createFile(): Optional<CreateFile> = Optional.ofNullable(createFile)
+
+            /** Instruction for deleting an existing file via the apply_patch tool. */
+            fun deleteFile(): Optional<DeleteFile> = Optional.ofNullable(deleteFile)
+
+            /** Instruction for updating an existing file via the apply_patch tool. */
+            fun updateFile(): Optional<UpdateFile> = Optional.ofNullable(updateFile)
+
+            fun isCreateFile(): Boolean = createFile != null
+
+            fun isDeleteFile(): Boolean = deleteFile != null
+
+            fun isUpdateFile(): Boolean = updateFile != null
+
+            /** Instruction for creating a new file via the apply_patch tool. */
+            fun asCreateFile(): CreateFile = createFile.getOrThrow("createFile")
+
+            /** Instruction for deleting an existing file via the apply_patch tool. */
+            fun asDeleteFile(): DeleteFile = deleteFile.getOrThrow("deleteFile")
+
+            /** Instruction for updating an existing file via the apply_patch tool. */
+            fun asUpdateFile(): UpdateFile = updateFile.getOrThrow("updateFile")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = operation.accept(new Operation.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitCreateFile(CreateFile createFile) {
+             *         return Optional.of(createFile.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    createFile != null -> visitor.visitCreateFile(createFile)
+                    deleteFile != null -> visitor.visitDeleteFile(deleteFile)
+                    updateFile != null -> visitor.visitUpdateFile(updateFile)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Operation = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitCreateFile(createFile: CreateFile) {
+                            createFile.validate()
+                        }
+
+                        override fun visitDeleteFile(deleteFile: DeleteFile) {
+                            deleteFile.validate()
+                        }
+
+                        override fun visitUpdateFile(updateFile: UpdateFile) {
+                            updateFile.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitCreateFile(createFile: CreateFile) = createFile.validity()
+
+                        override fun visitDeleteFile(deleteFile: DeleteFile) = deleteFile.validity()
+
+                        override fun visitUpdateFile(updateFile: UpdateFile) = updateFile.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Operation &&
+                    createFile == other.createFile &&
+                    deleteFile == other.deleteFile &&
+                    updateFile == other.updateFile
+            }
+
+            override fun hashCode(): Int = Objects.hash(createFile, deleteFile, updateFile)
+
+            override fun toString(): String =
+                when {
+                    createFile != null -> "Operation{createFile=$createFile}"
+                    deleteFile != null -> "Operation{deleteFile=$deleteFile}"
+                    updateFile != null -> "Operation{updateFile=$updateFile}"
+                    _json != null -> "Operation{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Operation")
+                }
+
+            companion object {
+
+                /** Instruction for creating a new file via the apply_patch tool. */
+                @JvmStatic
+                fun ofCreateFile(createFile: CreateFile) = Operation(createFile = createFile)
+
+                /** Instruction for deleting an existing file via the apply_patch tool. */
+                @JvmStatic
+                fun ofDeleteFile(deleteFile: DeleteFile) = Operation(deleteFile = deleteFile)
+
+                /** Instruction for updating an existing file via the apply_patch tool. */
+                @JvmStatic
+                fun ofUpdateFile(updateFile: UpdateFile) = Operation(updateFile = updateFile)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Operation] to a value of type
+             * [T].
+             */
+            interface Visitor<out T> {
+
+                /** Instruction for creating a new file via the apply_patch tool. */
+                fun visitCreateFile(createFile: CreateFile): T
+
+                /** Instruction for deleting an existing file via the apply_patch tool. */
+                fun visitDeleteFile(deleteFile: DeleteFile): T
+
+                /** Instruction for updating an existing file via the apply_patch tool. */
+                fun visitUpdateFile(updateFile: UpdateFile): T
+
+                /**
+                 * Maps an unknown variant of [Operation] to a value of type [T].
+                 *
+                 * An instance of [Operation] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Operation: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Operation>(Operation::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Operation {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "create_file" -> {
+                            return tryDeserialize(node, jacksonTypeRef<CreateFile>())?.let {
+                                Operation(createFile = it, _json = json)
+                            } ?: Operation(_json = json)
+                        }
+                        "delete_file" -> {
+                            return tryDeserialize(node, jacksonTypeRef<DeleteFile>())?.let {
+                                Operation(deleteFile = it, _json = json)
+                            } ?: Operation(_json = json)
+                        }
+                        "update_file" -> {
+                            return tryDeserialize(node, jacksonTypeRef<UpdateFile>())?.let {
+                                Operation(updateFile = it, _json = json)
+                            } ?: Operation(_json = json)
+                        }
+                    }
+
+                    return Operation(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Operation>(Operation::class) {
+
+                override fun serialize(
+                    value: Operation,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.createFile != null -> generator.writeObject(value.createFile)
+                        value.deleteFile != null -> generator.writeObject(value.deleteFile)
+                        value.updateFile != null -> generator.writeObject(value.updateFile)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Operation")
+                    }
+                }
+            }
+
+            /** Instruction for creating a new file via the apply_patch tool. */
+            class CreateFile
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val diff: JsonField<String>,
+                private val path: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("diff")
+                    @ExcludeMissing
+                    diff: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("path")
+                    @ExcludeMissing
+                    path: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(diff, path, type, mutableMapOf())
+
+                /**
+                 * Unified diff content to apply when creating the file.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun diff(): String = diff.getRequired("diff")
+
+                /**
+                 * Path of the file to create relative to the workspace root.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun path(): String = path.getRequired("path")
+
+                /**
+                 * The operation type. Always `create_file`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("create_file")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [diff].
+                 *
+                 * Unlike [diff], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("diff") @ExcludeMissing fun _diff(): JsonField<String> = diff
+
+                /**
+                 * Returns the raw JSON value of [path].
+                 *
+                 * Unlike [path], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("path") @ExcludeMissing fun _path(): JsonField<String> = path
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [CreateFile].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .diff()
+                     * .path()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [CreateFile]. */
+                class Builder internal constructor() {
+
+                    private var diff: JsonField<String>? = null
+                    private var path: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("create_file")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(createFile: CreateFile) = apply {
+                        diff = createFile.diff
+                        path = createFile.path
+                        type = createFile.type
+                        additionalProperties = createFile.additionalProperties.toMutableMap()
+                    }
+
+                    /** Unified diff content to apply when creating the file. */
+                    fun diff(diff: String) = diff(JsonField.of(diff))
+
+                    /**
+                     * Sets [Builder.diff] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.diff] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun diff(diff: JsonField<String>) = apply { this.diff = diff }
+
+                    /** Path of the file to create relative to the workspace root. */
+                    fun path(path: String) = path(JsonField.of(path))
+
+                    /**
+                     * Sets [Builder.path] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.path] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun path(path: JsonField<String>) = apply { this.path = path }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("create_file")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [CreateFile].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .diff()
+                     * .path()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): CreateFile =
+                        CreateFile(
+                            checkRequired("diff", diff),
+                            checkRequired("path", path),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): CreateFile = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    diff()
+                    path()
+                    _type().let {
+                        if (it != JsonValue.from("create_file")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (diff.asKnown().isPresent) 1 else 0) +
+                        (if (path.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("create_file")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is CreateFile &&
+                        diff == other.diff &&
+                        path == other.path &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(diff, path, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "CreateFile{diff=$diff, path=$path, type=$type, additionalProperties=$additionalProperties}"
+            }
+
+            /** Instruction for deleting an existing file via the apply_patch tool. */
+            class DeleteFile
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val path: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("path")
+                    @ExcludeMissing
+                    path: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(path, type, mutableMapOf())
+
+                /**
+                 * Path of the file to delete relative to the workspace root.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun path(): String = path.getRequired("path")
+
+                /**
+                 * The operation type. Always `delete_file`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("delete_file")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [path].
+                 *
+                 * Unlike [path], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("path") @ExcludeMissing fun _path(): JsonField<String> = path
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [DeleteFile].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .path()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [DeleteFile]. */
+                class Builder internal constructor() {
+
+                    private var path: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("delete_file")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(deleteFile: DeleteFile) = apply {
+                        path = deleteFile.path
+                        type = deleteFile.type
+                        additionalProperties = deleteFile.additionalProperties.toMutableMap()
+                    }
+
+                    /** Path of the file to delete relative to the workspace root. */
+                    fun path(path: String) = path(JsonField.of(path))
+
+                    /**
+                     * Sets [Builder.path] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.path] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun path(path: JsonField<String>) = apply { this.path = path }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("delete_file")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [DeleteFile].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .path()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): DeleteFile =
+                        DeleteFile(
+                            checkRequired("path", path),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): DeleteFile = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    path()
+                    _type().let {
+                        if (it != JsonValue.from("delete_file")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (path.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("delete_file")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is DeleteFile &&
+                        path == other.path &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(path, type, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "DeleteFile{path=$path, type=$type, additionalProperties=$additionalProperties}"
+            }
+
+            /** Instruction for updating an existing file via the apply_patch tool. */
+            class UpdateFile
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val diff: JsonField<String>,
+                private val path: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("diff")
+                    @ExcludeMissing
+                    diff: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("path")
+                    @ExcludeMissing
+                    path: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(diff, path, type, mutableMapOf())
+
+                /**
+                 * Unified diff content to apply to the existing file.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun diff(): String = diff.getRequired("diff")
+
+                /**
+                 * Path of the file to update relative to the workspace root.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun path(): String = path.getRequired("path")
+
+                /**
+                 * The operation type. Always `update_file`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("update_file")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [diff].
+                 *
+                 * Unlike [diff], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("diff") @ExcludeMissing fun _diff(): JsonField<String> = diff
+
+                /**
+                 * Returns the raw JSON value of [path].
+                 *
+                 * Unlike [path], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("path") @ExcludeMissing fun _path(): JsonField<String> = path
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [UpdateFile].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .diff()
+                     * .path()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [UpdateFile]. */
+                class Builder internal constructor() {
+
+                    private var diff: JsonField<String>? = null
+                    private var path: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("update_file")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(updateFile: UpdateFile) = apply {
+                        diff = updateFile.diff
+                        path = updateFile.path
+                        type = updateFile.type
+                        additionalProperties = updateFile.additionalProperties.toMutableMap()
+                    }
+
+                    /** Unified diff content to apply to the existing file. */
+                    fun diff(diff: String) = diff(JsonField.of(diff))
+
+                    /**
+                     * Sets [Builder.diff] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.diff] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun diff(diff: JsonField<String>) = apply { this.diff = diff }
+
+                    /** Path of the file to update relative to the workspace root. */
+                    fun path(path: String) = path(JsonField.of(path))
+
+                    /**
+                     * Sets [Builder.path] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.path] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun path(path: JsonField<String>) = apply { this.path = path }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("update_file")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [UpdateFile].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .diff()
+                     * .path()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): UpdateFile =
+                        UpdateFile(
+                            checkRequired("diff", diff),
+                            checkRequired("path", path),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): UpdateFile = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    diff()
+                    path()
+                    _type().let {
+                        if (it != JsonValue.from("update_file")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (diff.asKnown().isPresent) 1 else 0) +
+                        (if (path.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("update_file")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is UpdateFile &&
+                        diff == other.diff &&
+                        path == other.path &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(diff, path, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "UpdateFile{diff=$diff, path=$path, type=$type, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        /** The status of the apply patch tool call. One of `in_progress` or `completed`. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        /** The execution context that produced this tool call. */
+        @JsonDeserialize(using = Caller.Deserializer::class)
+        @JsonSerialize(using = Caller.Serializer::class)
+        class Caller
+        private constructor(
+            private val direct: JsonValue? = null,
+            private val program: Program? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+            fun program(): Optional<Program> = Optional.ofNullable(program)
+
+            fun isDirect(): Boolean = direct != null
+
+            fun isProgram(): Boolean = program != null
+
+            fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+            fun asProgram(): Program = program.getOrThrow("program")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitDirect(JsonValue direct) {
+             *         return Optional.of(direct.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    direct != null -> visitor.visitDirect(direct)
+                    program != null -> visitor.visitProgram(program)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Caller = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitDirect(direct: JsonValue) {
+                            direct.let {
+                                if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                    throw OpenAIInvalidDataException(
+                                        "'direct' is invalid, received $it"
+                                    )
+                                }
+                            }
+                        }
+
+                        override fun visitProgram(program: Program) {
+                            program.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitDirect(direct: JsonValue) =
+                            direct.let {
+                                if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0
+                            }
+
+                        override fun visitProgram(program: Program) = program.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Caller && direct == other.direct && program == other.program
+            }
+
+            override fun hashCode(): Int = Objects.hash(direct, program)
+
+            override fun toString(): String =
+                when {
+                    direct != null -> "Caller{direct=$direct}"
+                    program != null -> "Caller{program=$program}"
+                    _json != null -> "Caller{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+
+            companion object {
+
+                @JvmStatic
+                fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+                @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Caller] to a value of type [T].
+             */
+            interface Visitor<out T> {
+
+                fun visitDirect(direct: JsonValue): T
+
+                fun visitProgram(program: Program): T
+
+                /**
+                 * Maps an unknown variant of [Caller] to a value of type [T].
+                 *
+                 * An instance of [Caller] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Caller: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "direct" -> {
+                            return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let { Caller(direct = it, _json = json) }
+                                ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                        }
+                        "program" -> {
+                            return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                                Caller(program = it, _json = json)
+                            } ?: Caller(_json = json)
+                        }
+                    }
+
+                    return Caller(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+                override fun serialize(
+                    value: Caller,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.direct != null -> generator.writeObject(value.direct)
+                        value.program != null -> generator.writeObject(value.program)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Caller")
+                    }
+                }
+            }
+
+            class Program
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val callerId: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("caller_id")
+                    @ExcludeMissing
+                    callerId: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(callerId, type, mutableMapOf())
+
+                /**
+                 * The call ID of the program item that produced this tool call.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun callerId(): String = callerId.getRequired("caller_id")
+
+                /**
+                 * The caller type. Always `program`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [callerId].
+                 *
+                 * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                fun _callerId(): JsonField<String> = callerId
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Program].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Program]. */
+                class Builder internal constructor() {
+
+                    private var callerId: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("program")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(program: Program) = apply {
+                        callerId = program.callerId
+                        type = program.type
+                        additionalProperties = program.additionalProperties.toMutableMap()
+                    }
+
+                    /** The call ID of the program item that produced this tool call. */
+                    fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                    /**
+                     * Sets [Builder.callerId] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.callerId] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("program")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Program].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Program =
+                        Program(
+                            checkRequired("callerId", callerId),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Program = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    callerId()
+                    _type().let {
+                        if (it != JsonValue.from("program")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (callerId.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Program &&
+                        callerId == other.callerId &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(callerId, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ApplyPatchCall &&
+                callId == other.callId &&
+                operation == other.operation &&
+                status == other.status &&
+                type == other.type &&
+                id == other.id &&
+                agent == other.agent &&
+                caller == other.caller &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(callId, operation, status, type, id, agent, caller, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ApplyPatchCall{callId=$callId, operation=$operation, status=$status, type=$type, id=$id, agent=$agent, caller=$caller, additionalProperties=$additionalProperties}"
+    }
+
+    /** The streamed output emitted by an apply patch tool call. */
+    class ApplyPatchCallOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val callId: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val agent: JsonField<Agent>,
+        private val caller: JsonField<Caller>,
+        private val output: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+            @JsonProperty("output") @ExcludeMissing output: JsonField<String> = JsonMissing.of(),
+        ) : this(callId, status, type, id, agent, caller, output, mutableMapOf())
+
+        /**
+         * The unique ID of the apply patch tool call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The status of the apply patch tool call output. One of `completed` or `failed`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The type of the item. Always `apply_patch_call_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("apply_patch_call_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The unique ID of the apply patch tool call output. Populated when this item is returned
+         * via API.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun id(): Optional<String> = id.getOptional("id")
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * The execution context that produced this tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun caller(): Optional<Caller> = caller.getOptional("caller")
+
+        /**
+         * Optional human-readable log text from the apply patch tool (e.g., patch results or
+         * errors).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun output(): Optional<String> = output.getOptional("output")
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [caller].
+         *
+         * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<String> = output
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ApplyPatchCallOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .callId()
+             * .status()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ApplyPatchCallOutput]. */
+        class Builder internal constructor() {
+
+            private var callId: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("apply_patch_call_output")
+            private var id: JsonField<String> = JsonMissing.of()
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var caller: JsonField<Caller> = JsonMissing.of()
+            private var output: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(applyPatchCallOutput: ApplyPatchCallOutput) = apply {
+                callId = applyPatchCallOutput.callId
+                status = applyPatchCallOutput.status
+                type = applyPatchCallOutput.type
+                id = applyPatchCallOutput.id
+                agent = applyPatchCallOutput.agent
+                caller = applyPatchCallOutput.caller
+                output = applyPatchCallOutput.output
+                additionalProperties = applyPatchCallOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the apply patch tool call generated by the model. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The status of the apply patch tool call output. One of `completed` or `failed`. */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("apply_patch_call_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /**
+             * The unique ID of the apply patch tool call output. Populated when this item is
+             * returned via API.
+             */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /** The execution context that produced this tool call. */
+            fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+            /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+            fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+            /**
+             * Sets [Builder.caller] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.caller] with a well-typed [Caller] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+            /** Alias for calling [caller] with `Caller.ofDirect()`. */
+            fun callerDirect() = caller(Caller.ofDirect())
+
+            /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+            fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+            /**
+             * Alias for calling [caller] with the following:
+             * ```java
+             * Caller.Program.builder()
+             *     .callerId(callerId)
+             *     .build()
+             * ```
+             */
+            fun programCaller(callerId: String) =
+                caller(Caller.Program.builder().callerId(callerId).build())
+
+            /**
+             * Optional human-readable log text from the apply patch tool (e.g., patch results or
+             * errors).
+             */
+            fun output(output: String?) = output(JsonField.ofNullable(output))
+
+            /** Alias for calling [Builder.output] with `output.orElse(null)`. */
+            fun output(output: Optional<String>) = output(output.getOrNull())
+
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun output(output: JsonField<String>) = apply { this.output = output }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ApplyPatchCallOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .callId()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ApplyPatchCallOutput =
+                ApplyPatchCallOutput(
+                    checkRequired("callId", callId),
+                    checkRequired("status", status),
+                    type,
+                    id,
+                    agent,
+                    caller,
+                    output,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ApplyPatchCallOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            callId()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("apply_patch_call_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            id()
+            agent().ifPresent { it.validate() }
+            caller().ifPresent { it.validate() }
+            output()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (callId.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("apply_patch_call_output")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (caller.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (output.asKnown().isPresent) 1 else 0)
+
+        /** The status of the apply patch tool call output. One of `completed` or `failed`. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val FAILED = of("failed")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                COMPLETED,
+                FAILED,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                COMPLETED,
+                FAILED,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    COMPLETED -> Value.COMPLETED
+                    FAILED -> Value.FAILED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    COMPLETED -> Known.COMPLETED
+                    FAILED -> Known.FAILED
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        /** The execution context that produced this tool call. */
+        @JsonDeserialize(using = Caller.Deserializer::class)
+        @JsonSerialize(using = Caller.Serializer::class)
+        class Caller
+        private constructor(
+            private val direct: JsonValue? = null,
+            private val program: Program? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+            fun program(): Optional<Program> = Optional.ofNullable(program)
+
+            fun isDirect(): Boolean = direct != null
+
+            fun isProgram(): Boolean = program != null
+
+            fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+            fun asProgram(): Program = program.getOrThrow("program")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitDirect(JsonValue direct) {
+             *         return Optional.of(direct.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    direct != null -> visitor.visitDirect(direct)
+                    program != null -> visitor.visitProgram(program)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Caller = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitDirect(direct: JsonValue) {
+                            direct.let {
+                                if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                    throw OpenAIInvalidDataException(
+                                        "'direct' is invalid, received $it"
+                                    )
+                                }
+                            }
+                        }
+
+                        override fun visitProgram(program: Program) {
+                            program.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitDirect(direct: JsonValue) =
+                            direct.let {
+                                if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0
+                            }
+
+                        override fun visitProgram(program: Program) = program.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Caller && direct == other.direct && program == other.program
+            }
+
+            override fun hashCode(): Int = Objects.hash(direct, program)
+
+            override fun toString(): String =
+                when {
+                    direct != null -> "Caller{direct=$direct}"
+                    program != null -> "Caller{program=$program}"
+                    _json != null -> "Caller{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+
+            companion object {
+
+                @JvmStatic
+                fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+                @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Caller] to a value of type [T].
+             */
+            interface Visitor<out T> {
+
+                fun visitDirect(direct: JsonValue): T
+
+                fun visitProgram(program: Program): T
+
+                /**
+                 * Maps an unknown variant of [Caller] to a value of type [T].
+                 *
+                 * An instance of [Caller] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Caller: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "direct" -> {
+                            return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let { Caller(direct = it, _json = json) }
+                                ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                        }
+                        "program" -> {
+                            return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                                Caller(program = it, _json = json)
+                            } ?: Caller(_json = json)
+                        }
+                    }
+
+                    return Caller(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+                override fun serialize(
+                    value: Caller,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.direct != null -> generator.writeObject(value.direct)
+                        value.program != null -> generator.writeObject(value.program)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Caller")
+                    }
+                }
+            }
+
+            class Program
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val callerId: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("caller_id")
+                    @ExcludeMissing
+                    callerId: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(callerId, type, mutableMapOf())
+
+                /**
+                 * The call ID of the program item that produced this tool call.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun callerId(): String = callerId.getRequired("caller_id")
+
+                /**
+                 * The caller type. Always `program`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [callerId].
+                 *
+                 * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                fun _callerId(): JsonField<String> = callerId
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Program].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Program]. */
+                class Builder internal constructor() {
+
+                    private var callerId: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("program")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(program: Program) = apply {
+                        callerId = program.callerId
+                        type = program.type
+                        additionalProperties = program.additionalProperties.toMutableMap()
+                    }
+
+                    /** The call ID of the program item that produced this tool call. */
+                    fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                    /**
+                     * Sets [Builder.callerId] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.callerId] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("program")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Program].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Program =
+                        Program(
+                            checkRequired("callerId", callerId),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Program = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    callerId()
+                    _type().let {
+                        if (it != JsonValue.from("program")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (callerId.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Program &&
+                        callerId == other.callerId &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(callerId, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ApplyPatchCallOutput &&
+                callId == other.callId &&
+                status == other.status &&
+                type == other.type &&
+                id == other.id &&
+                agent == other.agent &&
+                caller == other.caller &&
+                output == other.output &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(callId, status, type, id, agent, caller, output, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ApplyPatchCallOutput{callId=$callId, status=$status, type=$type, id=$id, agent=$agent, caller=$caller, output=$output, additionalProperties=$additionalProperties}"
+    }
+
+    /** A list of tools available on an MCP server. */
+    class McpListTools
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val serverLabel: JsonField<String>,
+        private val tools: JsonField<List<Tool>>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val error: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("server_label")
+            @ExcludeMissing
+            serverLabel: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("tools") @ExcludeMissing tools: JsonField<List<Tool>> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("error") @ExcludeMissing error: JsonField<String> = JsonMissing.of(),
+        ) : this(id, serverLabel, tools, type, agent, error, mutableMapOf())
+
+        /**
+         * The unique ID of the list.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The label of the MCP server.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun serverLabel(): String = serverLabel.getRequired("server_label")
+
+        /**
+         * The tools available on the server.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun tools(): List<Tool> = tools.getRequired("tools")
+
+        /**
+         * The type of the item. Always `mcp_list_tools`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("mcp_list_tools")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Error message if the server could not list tools.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun error(): Optional<String> = error.getOptional("error")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [serverLabel].
+         *
+         * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("server_label")
+        @ExcludeMissing
+        fun _serverLabel(): JsonField<String> = serverLabel
+
+        /**
+         * Returns the raw JSON value of [tools].
+         *
+         * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<Tool>> = tools
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [error].
+         *
+         * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<String> = error
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [McpListTools].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .serverLabel()
+             * .tools()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [McpListTools]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var serverLabel: JsonField<String>? = null
+            private var tools: JsonField<MutableList<Tool>>? = null
+            private var type: JsonValue = JsonValue.from("mcp_list_tools")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var error: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(mcpListTools: McpListTools) = apply {
+                id = mcpListTools.id
+                serverLabel = mcpListTools.serverLabel
+                tools = mcpListTools.tools.map { it.toMutableList() }
+                type = mcpListTools.type
+                agent = mcpListTools.agent
+                error = mcpListTools.error
+                additionalProperties = mcpListTools.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the list. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The label of the MCP server. */
+            fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
+
+            /**
+             * Sets [Builder.serverLabel] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serverLabel] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun serverLabel(serverLabel: JsonField<String>) = apply {
+                this.serverLabel = serverLabel
+            }
+
+            /** The tools available on the server. */
+            fun tools(tools: List<Tool>) = tools(JsonField.of(tools))
+
+            /**
+             * Sets [Builder.tools] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.tools] with a well-typed `List<Tool>` value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun tools(tools: JsonField<List<Tool>>) = apply {
+                this.tools = tools.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [Tool] to [tools].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addTool(tool: Tool) = apply {
+                tools =
+                    (tools ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("tools", it).add(tool)
+                    }
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("mcp_list_tools")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /** Error message if the server could not list tools. */
+            fun error(error: String?) = error(JsonField.ofNullable(error))
+
+            /** Alias for calling [Builder.error] with `error.orElse(null)`. */
+            fun error(error: Optional<String>) = error(error.getOrNull())
+
+            /**
+             * Sets [Builder.error] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.error] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun error(error: JsonField<String>) = apply { this.error = error }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [McpListTools].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .serverLabel()
+             * .tools()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): McpListTools =
+                McpListTools(
+                    checkRequired("id", id),
+                    checkRequired("serverLabel", serverLabel),
+                    checkRequired("tools", tools).map { it.toImmutable() },
+                    type,
+                    agent,
+                    error,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): McpListTools = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            serverLabel()
+            tools().forEach { it.validate() }
+            _type().let {
+                if (it != JsonValue.from("mcp_list_tools")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            error()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (serverLabel.asKnown().isPresent) 1 else 0) +
+                (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                type.let { if (it == JsonValue.from("mcp_list_tools")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (error.asKnown().isPresent) 1 else 0)
+
+        /** A tool available on an MCP server. */
+        class Tool
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val inputSchema: JsonValue,
+            private val name: JsonField<String>,
+            private val annotations: JsonValue,
+            private val description: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("input_schema")
+                @ExcludeMissing
+                inputSchema: JsonValue = JsonMissing.of(),
+                @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("annotations")
+                @ExcludeMissing
+                annotations: JsonValue = JsonMissing.of(),
+                @JsonProperty("description")
+                @ExcludeMissing
+                description: JsonField<String> = JsonMissing.of(),
+            ) : this(inputSchema, name, annotations, description, mutableMapOf())
+
+            /**
+             * The JSON schema describing the tool's input.
+             *
+             * This arbitrary value can be deserialized into a custom type using the `convert`
+             * method:
+             * ```java
+             * MyClass myObject = tool.inputSchema().convert(MyClass.class);
+             * ```
+             */
+            @JsonProperty("input_schema")
+            @ExcludeMissing
+            fun _inputSchema(): JsonValue = inputSchema
+
+            /**
+             * The name of the tool.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun name(): String = name.getRequired("name")
+
+            /**
+             * Additional annotations about the tool.
+             *
+             * This arbitrary value can be deserialized into a custom type using the `convert`
+             * method:
+             * ```java
+             * MyClass myObject = tool.annotations().convert(MyClass.class);
+             * ```
+             */
+            @JsonProperty("annotations") @ExcludeMissing fun _annotations(): JsonValue = annotations
+
+            /**
+             * The description of the tool.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun description(): Optional<String> = description.getOptional("description")
+
+            /**
+             * Returns the raw JSON value of [name].
+             *
+             * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+            /**
+             * Returns the raw JSON value of [description].
+             *
+             * Unlike [description], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("description")
+            @ExcludeMissing
+            fun _description(): JsonField<String> = description
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Tool].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .inputSchema()
+                 * .name()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Tool]. */
+            class Builder internal constructor() {
+
+                private var inputSchema: JsonValue? = null
+                private var name: JsonField<String>? = null
+                private var annotations: JsonValue = JsonMissing.of()
+                private var description: JsonField<String> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(tool: Tool) = apply {
+                    inputSchema = tool.inputSchema
+                    name = tool.name
+                    annotations = tool.annotations
+                    description = tool.description
+                    additionalProperties = tool.additionalProperties.toMutableMap()
+                }
+
+                /** The JSON schema describing the tool's input. */
+                fun inputSchema(inputSchema: JsonValue) = apply { this.inputSchema = inputSchema }
+
+                /** The name of the tool. */
+                fun name(name: String) = name(JsonField.of(name))
+
+                /**
+                 * Sets [Builder.name] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.name] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun name(name: JsonField<String>) = apply { this.name = name }
+
+                /** Additional annotations about the tool. */
+                fun annotations(annotations: JsonValue) = apply { this.annotations = annotations }
+
+                /** The description of the tool. */
+                fun description(description: String?) =
+                    description(JsonField.ofNullable(description))
+
+                /** Alias for calling [Builder.description] with `description.orElse(null)`. */
+                fun description(description: Optional<String>) =
+                    description(description.getOrNull())
+
+                /**
+                 * Sets [Builder.description] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.description] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun description(description: JsonField<String>) = apply {
+                    this.description = description
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Tool].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .inputSchema()
+                 * .name()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Tool =
+                    Tool(
+                        checkRequired("inputSchema", inputSchema),
+                        checkRequired("name", name),
+                        annotations,
+                        description,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Tool = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                name()
+                description()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (name.asKnown().isPresent) 1 else 0) +
+                    (if (description.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Tool &&
+                    inputSchema == other.inputSchema &&
+                    name == other.name &&
+                    annotations == other.annotations &&
+                    description == other.description &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(inputSchema, name, annotations, description, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Tool{inputSchema=$inputSchema, name=$name, annotations=$annotations, description=$description, additionalProperties=$additionalProperties}"
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is McpListTools &&
+                id == other.id &&
+                serverLabel == other.serverLabel &&
+                tools == other.tools &&
+                type == other.type &&
+                agent == other.agent &&
+                error == other.error &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, serverLabel, tools, type, agent, error, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "McpListTools{id=$id, serverLabel=$serverLabel, tools=$tools, type=$type, agent=$agent, error=$error, additionalProperties=$additionalProperties}"
+    }
+
+    /** A request for human approval of a tool invocation. */
+    class McpApprovalRequest
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val arguments: JsonField<String>,
+        private val name: JsonField<String>,
+        private val serverLabel: JsonField<String>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("arguments")
+            @ExcludeMissing
+            arguments: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("server_label")
+            @ExcludeMissing
+            serverLabel: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, arguments, name, serverLabel, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the approval request.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * A JSON string of arguments for the tool.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun arguments(): String = arguments.getRequired("arguments")
+
+        /**
+         * The name of the tool to run.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun name(): String = name.getRequired("name")
+
+        /**
+         * The label of the MCP server making the request.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun serverLabel(): String = serverLabel.getRequired("server_label")
+
+        /**
+         * The type of the item. Always `mcp_approval_request`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("mcp_approval_request")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [arguments].
+         *
+         * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
+
+        /**
+         * Returns the raw JSON value of [name].
+         *
+         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+        /**
+         * Returns the raw JSON value of [serverLabel].
+         *
+         * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("server_label")
+        @ExcludeMissing
+        fun _serverLabel(): JsonField<String> = serverLabel
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [McpApprovalRequest].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .arguments()
+             * .name()
+             * .serverLabel()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [McpApprovalRequest]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var arguments: JsonField<String>? = null
+            private var name: JsonField<String>? = null
+            private var serverLabel: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("mcp_approval_request")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(mcpApprovalRequest: McpApprovalRequest) = apply {
+                id = mcpApprovalRequest.id
+                arguments = mcpApprovalRequest.arguments
+                name = mcpApprovalRequest.name
+                serverLabel = mcpApprovalRequest.serverLabel
+                type = mcpApprovalRequest.type
+                agent = mcpApprovalRequest.agent
+                additionalProperties = mcpApprovalRequest.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the approval request. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** A JSON string of arguments for the tool. */
+            fun arguments(arguments: String) = arguments(JsonField.of(arguments))
+
+            /**
+             * Sets [Builder.arguments] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.arguments] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
+
+            /** The name of the tool to run. */
+            fun name(name: String) = name(JsonField.of(name))
+
+            /**
+             * Sets [Builder.name] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.name] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun name(name: JsonField<String>) = apply { this.name = name }
+
+            /** The label of the MCP server making the request. */
+            fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
+
+            /**
+             * Sets [Builder.serverLabel] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serverLabel] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun serverLabel(serverLabel: JsonField<String>) = apply {
+                this.serverLabel = serverLabel
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("mcp_approval_request")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [McpApprovalRequest].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .arguments()
+             * .name()
+             * .serverLabel()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): McpApprovalRequest =
+                McpApprovalRequest(
+                    checkRequired("id", id),
+                    checkRequired("arguments", arguments),
+                    checkRequired("name", name),
+                    checkRequired("serverLabel", serverLabel),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): McpApprovalRequest = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            arguments()
+            name()
+            serverLabel()
+            _type().let {
+                if (it != JsonValue.from("mcp_approval_request")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (arguments.asKnown().isPresent) 1 else 0) +
+                (if (name.asKnown().isPresent) 1 else 0) +
+                (if (serverLabel.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("mcp_approval_request")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is McpApprovalRequest &&
+                id == other.id &&
+                arguments == other.arguments &&
+                name == other.name &&
+                serverLabel == other.serverLabel &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, arguments, name, serverLabel, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "McpApprovalRequest{id=$id, arguments=$arguments, name=$name, serverLabel=$serverLabel, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    /** A response to an MCP approval request. */
+    class McpApprovalResponse
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val approvalRequestId: JsonField<String>,
+        private val approve: JsonField<Boolean>,
+        private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val agent: JsonField<Agent>,
+        private val reason: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("approval_request_id")
+            @ExcludeMissing
+            approvalRequestId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("approve") @ExcludeMissing approve: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("reason") @ExcludeMissing reason: JsonField<String> = JsonMissing.of(),
+        ) : this(approvalRequestId, approve, type, id, agent, reason, mutableMapOf())
+
+        /**
+         * The ID of the approval request being answered.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun approvalRequestId(): String = approvalRequestId.getRequired("approval_request_id")
+
+        /**
+         * Whether the request was approved.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun approve(): Boolean = approve.getRequired("approve")
+
+        /**
+         * The type of the item. Always `mcp_approval_response`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("mcp_approval_response")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The unique ID of the approval response
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun id(): Optional<String> = id.getOptional("id")
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Optional reason for the decision.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun reason(): Optional<String> = reason.getOptional("reason")
+
+        /**
+         * Returns the raw JSON value of [approvalRequestId].
+         *
+         * Unlike [approvalRequestId], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("approval_request_id")
+        @ExcludeMissing
+        fun _approvalRequestId(): JsonField<String> = approvalRequestId
+
+        /**
+         * Returns the raw JSON value of [approve].
+         *
+         * Unlike [approve], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("approve") @ExcludeMissing fun _approve(): JsonField<Boolean> = approve
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [reason].
+         *
+         * Unlike [reason], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("reason") @ExcludeMissing fun _reason(): JsonField<String> = reason
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [McpApprovalResponse].
+             *
+             * The following fields are required:
+             * ```java
+             * .approvalRequestId()
+             * .approve()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [McpApprovalResponse]. */
+        class Builder internal constructor() {
+
+            private var approvalRequestId: JsonField<String>? = null
+            private var approve: JsonField<Boolean>? = null
+            private var type: JsonValue = JsonValue.from("mcp_approval_response")
+            private var id: JsonField<String> = JsonMissing.of()
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var reason: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(mcpApprovalResponse: McpApprovalResponse) = apply {
+                approvalRequestId = mcpApprovalResponse.approvalRequestId
+                approve = mcpApprovalResponse.approve
+                type = mcpApprovalResponse.type
+                id = mcpApprovalResponse.id
+                agent = mcpApprovalResponse.agent
+                reason = mcpApprovalResponse.reason
+                additionalProperties = mcpApprovalResponse.additionalProperties.toMutableMap()
+            }
+
+            /** The ID of the approval request being answered. */
+            fun approvalRequestId(approvalRequestId: String) =
+                approvalRequestId(JsonField.of(approvalRequestId))
+
+            /**
+             * Sets [Builder.approvalRequestId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.approvalRequestId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun approvalRequestId(approvalRequestId: JsonField<String>) = apply {
+                this.approvalRequestId = approvalRequestId
+            }
+
+            /** Whether the request was approved. */
+            fun approve(approve: Boolean) = approve(JsonField.of(approve))
+
+            /**
+             * Sets [Builder.approve] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.approve] with a well-typed [Boolean] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun approve(approve: JsonField<Boolean>) = apply { this.approve = approve }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("mcp_approval_response")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The unique ID of the approval response */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /** Optional reason for the decision. */
+            fun reason(reason: String?) = reason(JsonField.ofNullable(reason))
+
+            /** Alias for calling [Builder.reason] with `reason.orElse(null)`. */
+            fun reason(reason: Optional<String>) = reason(reason.getOrNull())
+
+            /**
+             * Sets [Builder.reason] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.reason] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun reason(reason: JsonField<String>) = apply { this.reason = reason }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [McpApprovalResponse].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .approvalRequestId()
+             * .approve()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): McpApprovalResponse =
+                McpApprovalResponse(
+                    checkRequired("approvalRequestId", approvalRequestId),
+                    checkRequired("approve", approve),
+                    type,
+                    id,
+                    agent,
+                    reason,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): McpApprovalResponse = apply {
+            if (validated) {
+                return@apply
+            }
+
+            approvalRequestId()
+            approve()
+            _type().let {
+                if (it != JsonValue.from("mcp_approval_response")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            id()
+            agent().ifPresent { it.validate() }
+            reason()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (approvalRequestId.asKnown().isPresent) 1 else 0) +
+                (if (approve.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("mcp_approval_response")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (reason.asKnown().isPresent) 1 else 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is McpApprovalResponse &&
+                approvalRequestId == other.approvalRequestId &&
+                approve == other.approve &&
+                type == other.type &&
+                id == other.id &&
+                agent == other.agent &&
+                reason == other.reason &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(approvalRequestId, approve, type, id, agent, reason, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "McpApprovalResponse{approvalRequestId=$approvalRequestId, approve=$approve, type=$type, id=$id, agent=$agent, reason=$reason, additionalProperties=$additionalProperties}"
+    }
+
+    /** An invocation of a tool on an MCP server. */
+    class McpCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val arguments: JsonField<String>,
+        private val name: JsonField<String>,
+        private val serverLabel: JsonField<String>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val approvalRequestId: JsonField<String>,
+        private val error: JsonField<String>,
+        private val output: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("arguments")
+            @ExcludeMissing
+            arguments: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("server_label")
+            @ExcludeMissing
+            serverLabel: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("approval_request_id")
+            @ExcludeMissing
+            approvalRequestId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("error") @ExcludeMissing error: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("output") @ExcludeMissing output: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        ) : this(
+            id,
+            arguments,
+            name,
+            serverLabel,
+            type,
+            agent,
+            approvalRequestId,
+            error,
+            output,
+            status,
+            mutableMapOf(),
+        )
+
+        /**
+         * The unique ID of the tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * A JSON string of the arguments passed to the tool.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun arguments(): String = arguments.getRequired("arguments")
+
+        /**
+         * The name of the tool that was run.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun name(): String = name.getRequired("name")
+
+        /**
+         * The label of the MCP server running the tool.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun serverLabel(): String = serverLabel.getRequired("server_label")
+
+        /**
+         * The type of the item. Always `mcp_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("mcp_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Unique identifier for the MCP tool call approval request. Include this value in a
+         * subsequent `mcp_approval_response` input to approve or reject the corresponding tool
+         * call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun approvalRequestId(): Optional<String> =
+            approvalRequestId.getOptional("approval_request_id")
+
+        /**
+         * The error from the tool call, if any.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun error(): Optional<String> = error.getOptional("error")
+
+        /**
+         * The output from the tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun output(): Optional<String> = output.getOptional("output")
+
+        /**
+         * The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `calling`,
+         * or `failed`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun status(): Optional<Status> = status.getOptional("status")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [arguments].
+         *
+         * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
+
+        /**
+         * Returns the raw JSON value of [name].
+         *
+         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+        /**
+         * Returns the raw JSON value of [serverLabel].
+         *
+         * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("server_label")
+        @ExcludeMissing
+        fun _serverLabel(): JsonField<String> = serverLabel
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [approvalRequestId].
+         *
+         * Unlike [approvalRequestId], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("approval_request_id")
+        @ExcludeMissing
+        fun _approvalRequestId(): JsonField<String> = approvalRequestId
+
+        /**
+         * Returns the raw JSON value of [error].
+         *
+         * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<String> = error
+
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<String> = output
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [McpCall].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .arguments()
+             * .name()
+             * .serverLabel()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [McpCall]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var arguments: JsonField<String>? = null
+            private var name: JsonField<String>? = null
+            private var serverLabel: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("mcp_call")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var approvalRequestId: JsonField<String> = JsonMissing.of()
+            private var error: JsonField<String> = JsonMissing.of()
+            private var output: JsonField<String> = JsonMissing.of()
+            private var status: JsonField<Status> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(mcpCall: McpCall) = apply {
+                id = mcpCall.id
+                arguments = mcpCall.arguments
+                name = mcpCall.name
+                serverLabel = mcpCall.serverLabel
+                type = mcpCall.type
+                agent = mcpCall.agent
+                approvalRequestId = mcpCall.approvalRequestId
+                error = mcpCall.error
+                output = mcpCall.output
+                status = mcpCall.status
+                additionalProperties = mcpCall.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the tool call. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** A JSON string of the arguments passed to the tool. */
+            fun arguments(arguments: String) = arguments(JsonField.of(arguments))
+
+            /**
+             * Sets [Builder.arguments] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.arguments] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
+
+            /** The name of the tool that was run. */
+            fun name(name: String) = name(JsonField.of(name))
+
+            /**
+             * Sets [Builder.name] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.name] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun name(name: JsonField<String>) = apply { this.name = name }
+
+            /** The label of the MCP server running the tool. */
+            fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
+
+            /**
+             * Sets [Builder.serverLabel] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serverLabel] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun serverLabel(serverLabel: JsonField<String>) = apply {
+                this.serverLabel = serverLabel
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("mcp_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /**
+             * Unique identifier for the MCP tool call approval request. Include this value in a
+             * subsequent `mcp_approval_response` input to approve or reject the corresponding tool
+             * call.
+             */
+            fun approvalRequestId(approvalRequestId: String?) =
+                approvalRequestId(JsonField.ofNullable(approvalRequestId))
+
+            /**
+             * Alias for calling [Builder.approvalRequestId] with `approvalRequestId.orElse(null)`.
+             */
+            fun approvalRequestId(approvalRequestId: Optional<String>) =
+                approvalRequestId(approvalRequestId.getOrNull())
+
+            /**
+             * Sets [Builder.approvalRequestId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.approvalRequestId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun approvalRequestId(approvalRequestId: JsonField<String>) = apply {
+                this.approvalRequestId = approvalRequestId
+            }
+
+            /** The error from the tool call, if any. */
+            fun error(error: String?) = error(JsonField.ofNullable(error))
+
+            /** Alias for calling [Builder.error] with `error.orElse(null)`. */
+            fun error(error: Optional<String>) = error(error.getOrNull())
+
+            /**
+             * Sets [Builder.error] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.error] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun error(error: JsonField<String>) = apply { this.error = error }
+
+            /** The output from the tool call. */
+            fun output(output: String?) = output(JsonField.ofNullable(output))
+
+            /** Alias for calling [Builder.output] with `output.orElse(null)`. */
+            fun output(output: Optional<String>) = output(output.getOrNull())
+
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun output(output: JsonField<String>) = apply { this.output = output }
+
+            /**
+             * The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+             * `calling`, or `failed`.
+             */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [McpCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .arguments()
+             * .name()
+             * .serverLabel()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): McpCall =
+                McpCall(
+                    checkRequired("id", id),
+                    checkRequired("arguments", arguments),
+                    checkRequired("name", name),
+                    checkRequired("serverLabel", serverLabel),
+                    type,
+                    agent,
+                    approvalRequestId,
+                    error,
+                    output,
+                    status,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): McpCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            arguments()
+            name()
+            serverLabel()
+            _type().let {
+                if (it != JsonValue.from("mcp_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            approvalRequestId()
+            error()
+            output()
+            status().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (arguments.asKnown().isPresent) 1 else 0) +
+                (if (name.asKnown().isPresent) 1 else 0) +
+                (if (serverLabel.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("mcp_call")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (approvalRequestId.asKnown().isPresent) 1 else 0) +
+                (if (error.asKnown().isPresent) 1 else 0) +
+                (if (output.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        /**
+         * The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `calling`,
+         * or `failed`.
+         */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmField val CALLING = of("calling")
+
+                @JvmField val FAILED = of("failed")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                CALLING,
+                FAILED,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                CALLING,
+                FAILED,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    CALLING -> Value.CALLING
+                    FAILED -> Value.FAILED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    CALLING -> Known.CALLING
+                    FAILED -> Known.FAILED
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is McpCall &&
+                id == other.id &&
+                arguments == other.arguments &&
+                name == other.name &&
+                serverLabel == other.serverLabel &&
+                type == other.type &&
+                agent == other.agent &&
+                approvalRequestId == other.approvalRequestId &&
+                error == other.error &&
+                output == other.output &&
+                status == other.status &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                id,
+                arguments,
+                name,
+                serverLabel,
+                type,
+                agent,
+                approvalRequestId,
+                error,
+                output,
+                status,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "McpCall{id=$id, arguments=$arguments, name=$name, serverLabel=$serverLabel, type=$type, agent=$agent, approvalRequestId=$approvalRequestId, error=$error, output=$output, status=$status, additionalProperties=$additionalProperties}"
+    }
+
+    /** Compacts the current context. Must be the final input item. */
+    class CompactionTrigger
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(type, agent, mutableMapOf())
+
+        /**
+         * The type of the item. Always `compaction_trigger`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("compaction_trigger")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [CompactionTrigger]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [CompactionTrigger]. */
+        class Builder internal constructor() {
+
+            private var type: JsonValue = JsonValue.from("compaction_trigger")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(compactionTrigger: CompactionTrigger) = apply {
+                type = compactionTrigger.type
+                agent = compactionTrigger.agent
+                additionalProperties = compactionTrigger.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("compaction_trigger")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [CompactionTrigger].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): CompactionTrigger =
+                CompactionTrigger(type, agent, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): CompactionTrigger = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _type().let {
+                if (it != JsonValue.from("compaction_trigger")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            type.let { if (it == JsonValue.from("compaction_trigger")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is CompactionTrigger &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(type, agent, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "CompactionTrigger{type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    /** An internal identifier for an item to reference. */
+    class ItemReference
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val agent: JsonField<Agent>,
+        private val type: JsonField<Type>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
+        ) : this(id, agent, type, mutableMapOf())
+
+        /**
+         * The ID of the item to reference.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * The type of item to reference. Always `item_reference`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun type(): Optional<Type> = type.getOptional("type")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [type].
+         *
+         * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ItemReference].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ItemReference]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var type: JsonField<Type> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(itemReference: ItemReference) = apply {
+                id = itemReference.id
+                agent = itemReference.agent
+                type = itemReference.type
+                additionalProperties = itemReference.additionalProperties.toMutableMap()
+            }
+
+            /** The ID of the item to reference. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /** The type of item to reference. Always `item_reference`. */
+            fun type(type: Type?) = type(JsonField.ofNullable(type))
+
+            /** Alias for calling [Builder.type] with `type.orElse(null)`. */
+            fun type(type: Optional<Type>) = type(type.getOrNull())
+
+            /**
+             * Sets [Builder.type] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.type] with a well-typed [Type] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun type(type: JsonField<Type>) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ItemReference].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ItemReference =
+                ItemReference(
+                    checkRequired("id", id),
+                    agent,
+                    type,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ItemReference = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            agent().ifPresent { it.validate() }
+            type().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (type.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        /** The type of item to reference. Always `item_reference`. */
+        class Type @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val ITEM_REFERENCE = of("item_reference")
+
+                @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+            }
+
+            /** An enum containing [Type]'s known values. */
+            enum class Known {
+                ITEM_REFERENCE
+            }
+
+            /**
+             * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Type] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                ITEM_REFERENCE,
+                /** An enum member indicating that [Type] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    ITEM_REFERENCE -> Value.ITEM_REFERENCE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    ITEM_REFERENCE -> Known.ITEM_REFERENCE
+                    else -> throw OpenAIInvalidDataException("Unknown Type: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Type = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Type && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ItemReference &&
+                id == other.id &&
+                agent == other.agent &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(id, agent, type, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ItemReference{id=$id, agent=$agent, type=$type, additionalProperties=$additionalProperties}"
+    }
+
+    class Program
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val callId: JsonField<String>,
+        private val code: JsonField<String>,
+        private val fingerprint: JsonField<String>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("code") @ExcludeMissing code: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("fingerprint")
+            @ExcludeMissing
+            fingerprint: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, callId, code, fingerprint, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of this program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The stable call ID of the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The JavaScript source executed by programmatic tool calling.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun code(): String = code.getRequired("code")
+
+        /**
+         * Opaque program replay fingerprint that must be round-tripped.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun fingerprint(): String = fingerprint.getRequired("fingerprint")
+
+        /**
+         * The item type. Always `program`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("program")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [code].
+         *
+         * Unlike [code], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<String> = code
+
+        /**
+         * Returns the raw JSON value of [fingerprint].
+         *
+         * Unlike [fingerprint], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("fingerprint")
+        @ExcludeMissing
+        fun _fingerprint(): JsonField<String> = fingerprint
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Program].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .code()
+             * .fingerprint()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Program]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var callId: JsonField<String>? = null
+            private var code: JsonField<String>? = null
+            private var fingerprint: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("program")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(program: Program) = apply {
+                id = program.id
+                callId = program.callId
+                code = program.code
+                fingerprint = program.fingerprint
+                type = program.type
+                agent = program.agent
+                additionalProperties = program.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of this program item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The stable call ID of the program item. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The JavaScript source executed by programmatic tool calling. */
+            fun code(code: String) = code(JsonField.of(code))
+
+            /**
+             * Sets [Builder.code] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.code] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun code(code: JsonField<String>) = apply { this.code = code }
+
+            /** Opaque program replay fingerprint that must be round-tripped. */
+            fun fingerprint(fingerprint: String) = fingerprint(JsonField.of(fingerprint))
+
+            /**
+             * Sets [Builder.fingerprint] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.fingerprint] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun fingerprint(fingerprint: JsonField<String>) = apply {
+                this.fingerprint = fingerprint
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Program].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .code()
+             * .fingerprint()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Program =
+                Program(
+                    checkRequired("id", id),
+                    checkRequired("callId", callId),
+                    checkRequired("code", code),
+                    checkRequired("fingerprint", fingerprint),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Program = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            callId()
+            code()
+            fingerprint()
+            _type().let {
+                if (it != JsonValue.from("program")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (if (code.asKnown().isPresent) 1 else 0) +
+                (if (fingerprint.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("program")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Program &&
+                id == other.id &&
+                callId == other.callId &&
+                code == other.code &&
+                fingerprint == other.fingerprint &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, callId, code, fingerprint, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Program{id=$id, callId=$callId, code=$code, fingerprint=$fingerprint, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    class ProgramOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val callId: JsonField<String>,
+        private val result: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("result") @ExcludeMissing result: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, callId, result, status, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of this program output item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The call ID of the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The result produced by the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun result(): String = result.getRequired("result")
+
+        /**
+         * The terminal status of the program output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The item type. Always `program_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("program_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [result].
+         *
+         * Unlike [result], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("result") @ExcludeMissing fun _result(): JsonField<String> = result
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ProgramOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .result()
+             * .status()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ProgramOutput]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var callId: JsonField<String>? = null
+            private var result: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("program_output")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(programOutput: ProgramOutput) = apply {
+                id = programOutput.id
+                callId = programOutput.callId
+                result = programOutput.result
+                status = programOutput.status
+                type = programOutput.type
+                agent = programOutput.agent
+                additionalProperties = programOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of this program output item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The call ID of the program item. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The result produced by the program item. */
+            fun result(result: String) = result(JsonField.of(result))
+
+            /**
+             * Sets [Builder.result] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.result] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun result(result: JsonField<String>) = apply { this.result = result }
+
+            /** The terminal status of the program output. */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("program_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ProgramOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .result()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ProgramOutput =
+                ProgramOutput(
+                    checkRequired("id", id),
+                    checkRequired("callId", callId),
+                    checkRequired("result", result),
+                    checkRequired("status", status),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ProgramOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            callId()
+            result()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("program_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (if (result.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("program_output")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The terminal status of the program output. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ProgramOutput &&
+                id == other.id &&
+                callId == other.callId &&
+                result == other.result &&
+                status == other.status &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, callId, result, status, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ProgramOutput{id=$id, callId=$callId, result=$result, status=$status, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputMessageItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputMessageItem.kt
new file mode 100644
index 000000000..6f9ffffef
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputMessageItem.kt
@@ -0,0 +1,888 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class BetaResponseInputMessageItem
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val content: JsonField<List<BetaResponseInputContent>>,
+    private val role: JsonField<Role>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val status: JsonField<Status>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("content")
+        @ExcludeMissing
+        content: JsonField<List<BetaResponseInputContent>> = JsonMissing.of(),
+        @JsonProperty("role") @ExcludeMissing role: JsonField<Role> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+    ) : this(id, content, role, type, agent, status, mutableMapOf())
+
+    /**
+     * The unique ID of the message input.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * A list of one or many input items to the model, containing different content types.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun content(): List<BetaResponseInputContent> = content.getRequired("content")
+
+    /**
+     * The role of the message input. One of `user`, `system`, or `developer`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun role(): Role = role.getRequired("role")
+
+    /**
+     * The type of the message input. Always set to `message`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("message")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * The status of item. One of `in_progress`, `completed`, or `incomplete`. Populated when items
+     * are returned via API.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun status(): Optional<Status> = status.getOptional("status")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [content].
+     *
+     * Unlike [content], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("content")
+    @ExcludeMissing
+    fun _content(): JsonField<List<BetaResponseInputContent>> = content
+
+    /**
+     * Returns the raw JSON value of [role].
+     *
+     * Unlike [role], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("role") @ExcludeMissing fun _role(): JsonField<Role> = role
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseInputMessageItem].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .content()
+         * .role()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseInputMessageItem]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var content: JsonField<MutableList<BetaResponseInputContent>>? = null
+        private var role: JsonField<Role>? = null
+        private var type: JsonValue = JsonValue.from("message")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var status: JsonField<Status> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseInputMessageItem: BetaResponseInputMessageItem) = apply {
+            id = betaResponseInputMessageItem.id
+            content = betaResponseInputMessageItem.content.map { it.toMutableList() }
+            role = betaResponseInputMessageItem.role
+            type = betaResponseInputMessageItem.type
+            agent = betaResponseInputMessageItem.agent
+            status = betaResponseInputMessageItem.status
+            additionalProperties = betaResponseInputMessageItem.additionalProperties.toMutableMap()
+        }
+
+        /** The unique ID of the message input. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** A list of one or many input items to the model, containing different content types. */
+        fun content(content: List<BetaResponseInputContent>) = content(JsonField.of(content))
+
+        /**
+         * Sets [Builder.content] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.content] with a well-typed
+         * `List<BetaResponseInputContent>` value instead. This method is primarily for setting the
+         * field to an undocumented or not yet supported value.
+         */
+        fun content(content: JsonField<List<BetaResponseInputContent>>) = apply {
+            this.content = content.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [BetaResponseInputContent] to [Builder.content].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addContent(content: BetaResponseInputContent) = apply {
+            this.content =
+                (this.content ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("content", it).add(content)
+                }
+        }
+
+        /**
+         * Alias for calling [addContent] with `BetaResponseInputContent.ofInputText(inputText)`.
+         */
+        fun addContent(inputText: BetaResponseInputText) =
+            addContent(BetaResponseInputContent.ofInputText(inputText))
+
+        /**
+         * Alias for calling [addContent] with the following:
+         * ```java
+         * BetaResponseInputText.builder()
+         *     .text(text)
+         *     .build()
+         * ```
+         */
+        fun addInputTextContent(text: String) =
+            addContent(BetaResponseInputText.builder().text(text).build())
+
+        /**
+         * Alias for calling [addContent] with `BetaResponseInputContent.ofInputImage(inputImage)`.
+         */
+        fun addContent(inputImage: BetaResponseInputImage) =
+            addContent(BetaResponseInputContent.ofInputImage(inputImage))
+
+        /**
+         * Alias for calling [addContent] with the following:
+         * ```java
+         * BetaResponseInputImage.builder()
+         *     .detail(detail)
+         *     .build()
+         * ```
+         */
+        fun addInputImageContent(detail: BetaResponseInputImage.Detail) =
+            addContent(BetaResponseInputImage.builder().detail(detail).build())
+
+        /**
+         * Alias for calling [addContent] with `BetaResponseInputContent.ofInputFile(inputFile)`.
+         */
+        fun addContent(inputFile: BetaResponseInputFile) =
+            addContent(BetaResponseInputContent.ofInputFile(inputFile))
+
+        /** The role of the message input. One of `user`, `system`, or `developer`. */
+        fun role(role: Role) = role(JsonField.of(role))
+
+        /**
+         * Sets [Builder.role] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.role] with a well-typed [Role] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun role(role: JsonField<Role>) = apply { this.role = role }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("message")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /**
+         * The status of item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+         * items are returned via API.
+         */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseInputMessageItem].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .content()
+         * .role()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseInputMessageItem =
+            BetaResponseInputMessageItem(
+                checkRequired("id", id),
+                checkRequired("content", content).map { it.toImmutable() },
+                checkRequired("role", role),
+                type,
+                agent,
+                status,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseInputMessageItem = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        content().forEach { it.validate() }
+        role().validate()
+        _type().let {
+            if (it != JsonValue.from("message")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        status().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (content.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (role.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("message")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The role of the message input. One of `user`, `system`, or `developer`. */
+    class Role @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val USER = of("user")
+
+            @JvmField val SYSTEM = of("system")
+
+            @JvmField val DEVELOPER = of("developer")
+
+            @JvmStatic fun of(value: String) = Role(JsonField.of(value))
+        }
+
+        /** An enum containing [Role]'s known values. */
+        enum class Known {
+            USER,
+            SYSTEM,
+            DEVELOPER,
+        }
+
+        /**
+         * An enum containing [Role]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Role] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            USER,
+            SYSTEM,
+            DEVELOPER,
+            /** An enum member indicating that [Role] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                USER -> Value.USER
+                SYSTEM -> Value.SYSTEM
+                DEVELOPER -> Value.DEVELOPER
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                USER -> Known.USER
+                SYSTEM -> Known.SYSTEM
+                DEVELOPER -> Known.DEVELOPER
+                else -> throw OpenAIInvalidDataException("Unknown Role: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Role = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Role && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * The status of item. One of `in_progress`, `completed`, or `incomplete`. Populated when items
+     * are returned via API.
+     */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseInputMessageItem &&
+            id == other.id &&
+            content == other.content &&
+            role == other.role &&
+            type == other.type &&
+            agent == other.agent &&
+            status == other.status &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(id, content, role, type, agent, status, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseInputMessageItem{id=$id, content=$content, role=$role, type=$type, agent=$agent, status=$status, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputText.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputText.kt
new file mode 100644
index 000000000..bd5f2343b
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputText.kt
@@ -0,0 +1,437 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** A text input to the model. */
+class BetaResponseInputText
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val text: JsonField<String>,
+    private val type: JsonValue,
+    private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+    ) : this(text, type, promptCacheBreakpoint, mutableMapOf())
+
+    /**
+     * The text input to the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun text(): String = text.getRequired("text")
+
+    /**
+     * The type of the input item. Always `input_text`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("input_text")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+        promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
+    /**
+     * Returns the raw JSON value of [text].
+     *
+     * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+    /**
+     * Returns the raw JSON value of [promptCacheBreakpoint].
+     *
+     * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_breakpoint")
+    @ExcludeMissing
+    fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseInputText].
+         *
+         * The following fields are required:
+         * ```java
+         * .text()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseInputText]. */
+    class Builder internal constructor() {
+
+        private var text: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("input_text")
+        private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseInputText: BetaResponseInputText) = apply {
+            text = betaResponseInputText.text
+            type = betaResponseInputText.type
+            promptCacheBreakpoint = betaResponseInputText.promptCacheBreakpoint
+            additionalProperties = betaResponseInputText.additionalProperties.toMutableMap()
+        }
+
+        /** The text input to the model. */
+        fun text(text: String) = text(JsonField.of(text))
+
+        /**
+         * Sets [Builder.text] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.text] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun text(text: JsonField<String>) = apply { this.text = text }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("input_text")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint) =
+            promptCacheBreakpoint(JsonField.of(promptCacheBreakpoint))
+
+        /**
+         * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+         * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) = apply {
+            this.promptCacheBreakpoint = promptCacheBreakpoint
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseInputText].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .text()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseInputText =
+            BetaResponseInputText(
+                checkRequired("text", text),
+                type,
+                promptCacheBreakpoint,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseInputText = apply {
+        if (validated) {
+            return@apply
+        }
+
+        text()
+        _type().let {
+            if (it != JsonValue.from("input_text")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        promptCacheBreakpoint().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (text.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("input_text")) 1 else 0 } +
+            (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     */
+    class PromptCacheBreakpoint
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+        ) : this(mode, mutableMapOf())
+
+        /**
+         * The breakpoint mode. Always `explicit`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("explicit")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheBreakpoint].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheBreakpoint]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonValue = JsonValue.from("explicit")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                mode = promptCacheBreakpoint.mode
+                additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheBreakpoint].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheBreakpoint =
+                PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheBreakpoint = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _mode().let {
+                if (it != JsonValue.from("explicit")) {
+                    throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheBreakpoint &&
+                mode == other.mode &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseInputText &&
+            text == other.text &&
+            type == other.type &&
+            promptCacheBreakpoint == other.promptCacheBreakpoint &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(text, type, promptCacheBreakpoint, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseInputText{text=$text, type=$type, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputTextContent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputTextContent.kt
new file mode 100644
index 000000000..456131a9f
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInputTextContent.kt
@@ -0,0 +1,444 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** A text input to the model. */
+class BetaResponseInputTextContent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val text: JsonField<String>,
+    private val type: JsonValue,
+    private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+    ) : this(text, type, promptCacheBreakpoint, mutableMapOf())
+
+    /**
+     * The text input to the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun text(): String = text.getRequired("text")
+
+    /**
+     * The type of the input item. Always `input_text`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("input_text")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+        promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
+    /**
+     * Returns the raw JSON value of [text].
+     *
+     * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+    /**
+     * Returns the raw JSON value of [promptCacheBreakpoint].
+     *
+     * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_breakpoint")
+    @ExcludeMissing
+    fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseInputTextContent].
+         *
+         * The following fields are required:
+         * ```java
+         * .text()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseInputTextContent]. */
+    class Builder internal constructor() {
+
+        private var text: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("input_text")
+        private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseInputTextContent: BetaResponseInputTextContent) = apply {
+            text = betaResponseInputTextContent.text
+            type = betaResponseInputTextContent.type
+            promptCacheBreakpoint = betaResponseInputTextContent.promptCacheBreakpoint
+            additionalProperties = betaResponseInputTextContent.additionalProperties.toMutableMap()
+        }
+
+        /** The text input to the model. */
+        fun text(text: String) = text(JsonField.of(text))
+
+        /**
+         * Sets [Builder.text] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.text] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun text(text: JsonField<String>) = apply { this.text = text }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("input_text")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint?) =
+            promptCacheBreakpoint(JsonField.ofNullable(promptCacheBreakpoint))
+
+        /**
+         * Alias for calling [Builder.promptCacheBreakpoint] with
+         * `promptCacheBreakpoint.orElse(null)`.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: Optional<PromptCacheBreakpoint>) =
+            promptCacheBreakpoint(promptCacheBreakpoint.getOrNull())
+
+        /**
+         * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+         * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) = apply {
+            this.promptCacheBreakpoint = promptCacheBreakpoint
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseInputTextContent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .text()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseInputTextContent =
+            BetaResponseInputTextContent(
+                checkRequired("text", text),
+                type,
+                promptCacheBreakpoint,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseInputTextContent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        text()
+        _type().let {
+            if (it != JsonValue.from("input_text")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        promptCacheBreakpoint().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (text.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("input_text")) 1 else 0 } +
+            (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     */
+    class PromptCacheBreakpoint
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+        ) : this(mode, mutableMapOf())
+
+        /**
+         * The breakpoint mode. Always `explicit`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("explicit")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheBreakpoint].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheBreakpoint]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonValue = JsonValue.from("explicit")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                mode = promptCacheBreakpoint.mode
+                additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheBreakpoint].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheBreakpoint =
+                PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheBreakpoint = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _mode().let {
+                if (it != JsonValue.from("explicit")) {
+                    throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheBreakpoint &&
+                mode == other.mode &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseInputTextContent &&
+            text == other.text &&
+            type == other.type &&
+            promptCacheBreakpoint == other.promptCacheBreakpoint &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(text, type, promptCacheBreakpoint, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseInputTextContent{text=$text, type=$type, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseItem.kt
new file mode 100644
index 000000000..0fff9dafb
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseItem.kt
@@ -0,0 +1,13038 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.allMaxBy
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Content item used to generate a response. */
+@JsonDeserialize(using = BetaResponseItem.Deserializer::class)
+@JsonSerialize(using = BetaResponseItem.Serializer::class)
+class BetaResponseItem
+private constructor(
+    private val betaResponseInputMessageItem: BetaResponseInputMessageItem? = null,
+    private val betaResponseOutputMessage: BetaResponseOutputMessage? = null,
+    private val fileSearchCall: BetaResponseFileSearchToolCall? = null,
+    private val computerCall: BetaResponseComputerToolCall? = null,
+    private val computerCallOutput: BetaResponseComputerToolCallOutputItem? = null,
+    private val webSearchCall: BetaResponseFunctionWebSearch? = null,
+    private val functionCall: BetaResponseFunctionToolCallItem? = null,
+    private val functionCallOutput: BetaResponseFunctionToolCallOutputItem? = null,
+    private val agentMessage: AgentMessage? = null,
+    private val multiAgentCall: MultiAgentCall? = null,
+    private val multiAgentCallOutput: MultiAgentCallOutput? = null,
+    private val toolSearchCall: BetaResponseToolSearchCall? = null,
+    private val toolSearchOutput: BetaResponseToolSearchOutputItem? = null,
+    private val additionalTools: AdditionalTools? = null,
+    private val reasoning: BetaResponseReasoningItem? = null,
+    private val program: Program? = null,
+    private val programOutput: ProgramOutput? = null,
+    private val compaction: BetaResponseCompactionItem? = null,
+    private val imageGenerationCall: ImageGenerationCall? = null,
+    private val codeInterpreterCall: BetaResponseCodeInterpreterToolCall? = null,
+    private val localShellCall: LocalShellCall? = null,
+    private val localShellCallOutput: LocalShellCallOutput? = null,
+    private val shellCall: BetaResponseFunctionShellToolCall? = null,
+    private val shellCallOutput: BetaResponseFunctionShellToolCallOutput? = null,
+    private val applyPatchCall: BetaResponseApplyPatchToolCall? = null,
+    private val applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput? = null,
+    private val mcpListTools: McpListTools? = null,
+    private val mcpApprovalRequest: McpApprovalRequest? = null,
+    private val mcpApprovalResponse: McpApprovalResponse? = null,
+    private val mcpCall: McpCall? = null,
+    private val customToolCall: BetaResponseCustomToolCallItem? = null,
+    private val customToolCallOutput: BetaResponseCustomToolCallOutputItem? = null,
+    private val _json: JsonValue? = null,
+) {
+
+    fun betaResponseInputMessageItem(): Optional<BetaResponseInputMessageItem> =
+        Optional.ofNullable(betaResponseInputMessageItem)
+
+    /** An output message from the model. */
+    fun betaResponseOutputMessage(): Optional<BetaResponseOutputMessage> =
+        Optional.ofNullable(betaResponseOutputMessage)
+
+    /**
+     * The results of a file search tool call. See the
+     * [file search guide](https://platform.openai.com/docs/guides/tools-file-search) for more
+     * information.
+     */
+    fun fileSearchCall(): Optional<BetaResponseFileSearchToolCall> =
+        Optional.ofNullable(fileSearchCall)
+
+    /**
+     * A tool call to a computer use tool. See the
+     * [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more
+     * information.
+     */
+    fun computerCall(): Optional<BetaResponseComputerToolCall> = Optional.ofNullable(computerCall)
+
+    fun computerCallOutput(): Optional<BetaResponseComputerToolCallOutputItem> =
+        Optional.ofNullable(computerCallOutput)
+
+    /**
+     * The results of a web search tool call. See the
+     * [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more
+     * information.
+     */
+    fun webSearchCall(): Optional<BetaResponseFunctionWebSearch> =
+        Optional.ofNullable(webSearchCall)
+
+    /**
+     * A tool call to run a function. See the
+     * [function calling guide](https://platform.openai.com/docs/guides/function-calling) for more
+     * information.
+     */
+    fun functionCall(): Optional<BetaResponseFunctionToolCallItem> =
+        Optional.ofNullable(functionCall)
+
+    fun functionCallOutput(): Optional<BetaResponseFunctionToolCallOutputItem> =
+        Optional.ofNullable(functionCallOutput)
+
+    fun agentMessage(): Optional<AgentMessage> = Optional.ofNullable(agentMessage)
+
+    fun multiAgentCall(): Optional<MultiAgentCall> = Optional.ofNullable(multiAgentCall)
+
+    fun multiAgentCallOutput(): Optional<MultiAgentCallOutput> =
+        Optional.ofNullable(multiAgentCallOutput)
+
+    fun toolSearchCall(): Optional<BetaResponseToolSearchCall> = Optional.ofNullable(toolSearchCall)
+
+    fun toolSearchOutput(): Optional<BetaResponseToolSearchOutputItem> =
+        Optional.ofNullable(toolSearchOutput)
+
+    fun additionalTools(): Optional<AdditionalTools> = Optional.ofNullable(additionalTools)
+
+    /**
+     * A description of the chain of thought used by a reasoning model while generating a response.
+     * Be sure to include these items in your `input` to the Responses API for subsequent turns of a
+     * conversation if you are manually
+     * [managing context](https://platform.openai.com/docs/guides/conversation-state).
+     */
+    fun reasoning(): Optional<BetaResponseReasoningItem> = Optional.ofNullable(reasoning)
+
+    fun program(): Optional<Program> = Optional.ofNullable(program)
+
+    fun programOutput(): Optional<ProgramOutput> = Optional.ofNullable(programOutput)
+
+    /**
+     * A compaction item generated by the
+     * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+     */
+    fun compaction(): Optional<BetaResponseCompactionItem> = Optional.ofNullable(compaction)
+
+    /** An image generation request made by the model. */
+    fun imageGenerationCall(): Optional<ImageGenerationCall> =
+        Optional.ofNullable(imageGenerationCall)
+
+    /** A tool call to run code. */
+    fun codeInterpreterCall(): Optional<BetaResponseCodeInterpreterToolCall> =
+        Optional.ofNullable(codeInterpreterCall)
+
+    /** A tool call to run a command on the local shell. */
+    fun localShellCall(): Optional<LocalShellCall> = Optional.ofNullable(localShellCall)
+
+    /** The output of a local shell tool call. */
+    fun localShellCallOutput(): Optional<LocalShellCallOutput> =
+        Optional.ofNullable(localShellCallOutput)
+
+    /** A tool call that executes one or more shell commands in a managed environment. */
+    fun shellCall(): Optional<BetaResponseFunctionShellToolCall> = Optional.ofNullable(shellCall)
+
+    /** The output of a shell tool call that was emitted. */
+    fun shellCallOutput(): Optional<BetaResponseFunctionShellToolCallOutput> =
+        Optional.ofNullable(shellCallOutput)
+
+    /** A tool call that applies file diffs by creating, deleting, or updating files. */
+    fun applyPatchCall(): Optional<BetaResponseApplyPatchToolCall> =
+        Optional.ofNullable(applyPatchCall)
+
+    /** The output emitted by an apply patch tool call. */
+    fun applyPatchCallOutput(): Optional<BetaResponseApplyPatchToolCallOutput> =
+        Optional.ofNullable(applyPatchCallOutput)
+
+    /** A list of tools available on an MCP server. */
+    fun mcpListTools(): Optional<McpListTools> = Optional.ofNullable(mcpListTools)
+
+    /** A request for human approval of a tool invocation. */
+    fun mcpApprovalRequest(): Optional<McpApprovalRequest> = Optional.ofNullable(mcpApprovalRequest)
+
+    /** A response to an MCP approval request. */
+    fun mcpApprovalResponse(): Optional<McpApprovalResponse> =
+        Optional.ofNullable(mcpApprovalResponse)
+
+    /** An invocation of a tool on an MCP server. */
+    fun mcpCall(): Optional<McpCall> = Optional.ofNullable(mcpCall)
+
+    /** A call to a custom tool created by the model. */
+    fun customToolCall(): Optional<BetaResponseCustomToolCallItem> =
+        Optional.ofNullable(customToolCall)
+
+    /** The output of a custom tool call from your code, being sent back to the model. */
+    fun customToolCallOutput(): Optional<BetaResponseCustomToolCallOutputItem> =
+        Optional.ofNullable(customToolCallOutput)
+
+    fun isBetaResponseInputMessageItem(): Boolean = betaResponseInputMessageItem != null
+
+    fun isBetaResponseOutputMessage(): Boolean = betaResponseOutputMessage != null
+
+    fun isFileSearchCall(): Boolean = fileSearchCall != null
+
+    fun isComputerCall(): Boolean = computerCall != null
+
+    fun isComputerCallOutput(): Boolean = computerCallOutput != null
+
+    fun isWebSearchCall(): Boolean = webSearchCall != null
+
+    fun isFunctionCall(): Boolean = functionCall != null
+
+    fun isFunctionCallOutput(): Boolean = functionCallOutput != null
+
+    fun isAgentMessage(): Boolean = agentMessage != null
+
+    fun isMultiAgentCall(): Boolean = multiAgentCall != null
+
+    fun isMultiAgentCallOutput(): Boolean = multiAgentCallOutput != null
+
+    fun isToolSearchCall(): Boolean = toolSearchCall != null
+
+    fun isToolSearchOutput(): Boolean = toolSearchOutput != null
+
+    fun isAdditionalTools(): Boolean = additionalTools != null
+
+    fun isReasoning(): Boolean = reasoning != null
+
+    fun isProgram(): Boolean = program != null
+
+    fun isProgramOutput(): Boolean = programOutput != null
+
+    fun isCompaction(): Boolean = compaction != null
+
+    fun isImageGenerationCall(): Boolean = imageGenerationCall != null
+
+    fun isCodeInterpreterCall(): Boolean = codeInterpreterCall != null
+
+    fun isLocalShellCall(): Boolean = localShellCall != null
+
+    fun isLocalShellCallOutput(): Boolean = localShellCallOutput != null
+
+    fun isShellCall(): Boolean = shellCall != null
+
+    fun isShellCallOutput(): Boolean = shellCallOutput != null
+
+    fun isApplyPatchCall(): Boolean = applyPatchCall != null
+
+    fun isApplyPatchCallOutput(): Boolean = applyPatchCallOutput != null
+
+    fun isMcpListTools(): Boolean = mcpListTools != null
+
+    fun isMcpApprovalRequest(): Boolean = mcpApprovalRequest != null
+
+    fun isMcpApprovalResponse(): Boolean = mcpApprovalResponse != null
+
+    fun isMcpCall(): Boolean = mcpCall != null
+
+    fun isCustomToolCall(): Boolean = customToolCall != null
+
+    fun isCustomToolCallOutput(): Boolean = customToolCallOutput != null
+
+    fun asBetaResponseInputMessageItem(): BetaResponseInputMessageItem =
+        betaResponseInputMessageItem.getOrThrow("betaResponseInputMessageItem")
+
+    /** An output message from the model. */
+    fun asBetaResponseOutputMessage(): BetaResponseOutputMessage =
+        betaResponseOutputMessage.getOrThrow("betaResponseOutputMessage")
+
+    /**
+     * The results of a file search tool call. See the
+     * [file search guide](https://platform.openai.com/docs/guides/tools-file-search) for more
+     * information.
+     */
+    fun asFileSearchCall(): BetaResponseFileSearchToolCall =
+        fileSearchCall.getOrThrow("fileSearchCall")
+
+    /**
+     * A tool call to a computer use tool. See the
+     * [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more
+     * information.
+     */
+    fun asComputerCall(): BetaResponseComputerToolCall = computerCall.getOrThrow("computerCall")
+
+    fun asComputerCallOutput(): BetaResponseComputerToolCallOutputItem =
+        computerCallOutput.getOrThrow("computerCallOutput")
+
+    /**
+     * The results of a web search tool call. See the
+     * [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more
+     * information.
+     */
+    fun asWebSearchCall(): BetaResponseFunctionWebSearch = webSearchCall.getOrThrow("webSearchCall")
+
+    /**
+     * A tool call to run a function. See the
+     * [function calling guide](https://platform.openai.com/docs/guides/function-calling) for more
+     * information.
+     */
+    fun asFunctionCall(): BetaResponseFunctionToolCallItem = functionCall.getOrThrow("functionCall")
+
+    fun asFunctionCallOutput(): BetaResponseFunctionToolCallOutputItem =
+        functionCallOutput.getOrThrow("functionCallOutput")
+
+    fun asAgentMessage(): AgentMessage = agentMessage.getOrThrow("agentMessage")
+
+    fun asMultiAgentCall(): MultiAgentCall = multiAgentCall.getOrThrow("multiAgentCall")
+
+    fun asMultiAgentCallOutput(): MultiAgentCallOutput =
+        multiAgentCallOutput.getOrThrow("multiAgentCallOutput")
+
+    fun asToolSearchCall(): BetaResponseToolSearchCall = toolSearchCall.getOrThrow("toolSearchCall")
+
+    fun asToolSearchOutput(): BetaResponseToolSearchOutputItem =
+        toolSearchOutput.getOrThrow("toolSearchOutput")
+
+    fun asAdditionalTools(): AdditionalTools = additionalTools.getOrThrow("additionalTools")
+
+    /**
+     * A description of the chain of thought used by a reasoning model while generating a response.
+     * Be sure to include these items in your `input` to the Responses API for subsequent turns of a
+     * conversation if you are manually
+     * [managing context](https://platform.openai.com/docs/guides/conversation-state).
+     */
+    fun asReasoning(): BetaResponseReasoningItem = reasoning.getOrThrow("reasoning")
+
+    fun asProgram(): Program = program.getOrThrow("program")
+
+    fun asProgramOutput(): ProgramOutput = programOutput.getOrThrow("programOutput")
+
+    /**
+     * A compaction item generated by the
+     * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+     */
+    fun asCompaction(): BetaResponseCompactionItem = compaction.getOrThrow("compaction")
+
+    /** An image generation request made by the model. */
+    fun asImageGenerationCall(): ImageGenerationCall =
+        imageGenerationCall.getOrThrow("imageGenerationCall")
+
+    /** A tool call to run code. */
+    fun asCodeInterpreterCall(): BetaResponseCodeInterpreterToolCall =
+        codeInterpreterCall.getOrThrow("codeInterpreterCall")
+
+    /** A tool call to run a command on the local shell. */
+    fun asLocalShellCall(): LocalShellCall = localShellCall.getOrThrow("localShellCall")
+
+    /** The output of a local shell tool call. */
+    fun asLocalShellCallOutput(): LocalShellCallOutput =
+        localShellCallOutput.getOrThrow("localShellCallOutput")
+
+    /** A tool call that executes one or more shell commands in a managed environment. */
+    fun asShellCall(): BetaResponseFunctionShellToolCall = shellCall.getOrThrow("shellCall")
+
+    /** The output of a shell tool call that was emitted. */
+    fun asShellCallOutput(): BetaResponseFunctionShellToolCallOutput =
+        shellCallOutput.getOrThrow("shellCallOutput")
+
+    /** A tool call that applies file diffs by creating, deleting, or updating files. */
+    fun asApplyPatchCall(): BetaResponseApplyPatchToolCall =
+        applyPatchCall.getOrThrow("applyPatchCall")
+
+    /** The output emitted by an apply patch tool call. */
+    fun asApplyPatchCallOutput(): BetaResponseApplyPatchToolCallOutput =
+        applyPatchCallOutput.getOrThrow("applyPatchCallOutput")
+
+    /** A list of tools available on an MCP server. */
+    fun asMcpListTools(): McpListTools = mcpListTools.getOrThrow("mcpListTools")
+
+    /** A request for human approval of a tool invocation. */
+    fun asMcpApprovalRequest(): McpApprovalRequest =
+        mcpApprovalRequest.getOrThrow("mcpApprovalRequest")
+
+    /** A response to an MCP approval request. */
+    fun asMcpApprovalResponse(): McpApprovalResponse =
+        mcpApprovalResponse.getOrThrow("mcpApprovalResponse")
+
+    /** An invocation of a tool on an MCP server. */
+    fun asMcpCall(): McpCall = mcpCall.getOrThrow("mcpCall")
+
+    /** A call to a custom tool created by the model. */
+    fun asCustomToolCall(): BetaResponseCustomToolCallItem =
+        customToolCall.getOrThrow("customToolCall")
+
+    /** The output of a custom tool call from your code, being sent back to the model. */
+    fun asCustomToolCallOutput(): BetaResponseCustomToolCallOutputItem =
+        customToolCallOutput.getOrThrow("customToolCallOutput")
+
+    fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+    /**
+     * Maps this instance's current variant to a value of type [T] using the given [visitor].
+     *
+     * Note that this method is _not_ forwards compatible with new variants from the API, unless
+     * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of the
+     * SDK gracefully, consider overriding [Visitor.unknown]:
+     * ```java
+     * import com.openai.core.JsonValue;
+     * import java.util.Optional;
+     *
+     * Optional<String> result = betaResponseItem.accept(new BetaResponseItem.Visitor<Optional<String>>() {
+     *     @Override
+     *     public Optional<String> visitBetaResponseInputMessageItem(BetaResponseInputMessageItem betaResponseInputMessageItem) {
+     *         return Optional.of(betaResponseInputMessageItem.toString());
+     *     }
+     *
+     *     // ...
+     *
+     *     @Override
+     *     public Optional<String> unknown(JsonValue json) {
+     *         // Or inspect the `json`.
+     *         return Optional.empty();
+     *     }
+     * });
+     * ```
+     *
+     * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor] and
+     *   the current variant is unknown.
+     */
+    fun <T> accept(visitor: Visitor<T>): T =
+        when {
+            betaResponseInputMessageItem != null ->
+                visitor.visitBetaResponseInputMessageItem(betaResponseInputMessageItem)
+            betaResponseOutputMessage != null ->
+                visitor.visitBetaResponseOutputMessage(betaResponseOutputMessage)
+            fileSearchCall != null -> visitor.visitFileSearchCall(fileSearchCall)
+            computerCall != null -> visitor.visitComputerCall(computerCall)
+            computerCallOutput != null -> visitor.visitComputerCallOutput(computerCallOutput)
+            webSearchCall != null -> visitor.visitWebSearchCall(webSearchCall)
+            functionCall != null -> visitor.visitFunctionCall(functionCall)
+            functionCallOutput != null -> visitor.visitFunctionCallOutput(functionCallOutput)
+            agentMessage != null -> visitor.visitAgentMessage(agentMessage)
+            multiAgentCall != null -> visitor.visitMultiAgentCall(multiAgentCall)
+            multiAgentCallOutput != null -> visitor.visitMultiAgentCallOutput(multiAgentCallOutput)
+            toolSearchCall != null -> visitor.visitToolSearchCall(toolSearchCall)
+            toolSearchOutput != null -> visitor.visitToolSearchOutput(toolSearchOutput)
+            additionalTools != null -> visitor.visitAdditionalTools(additionalTools)
+            reasoning != null -> visitor.visitReasoning(reasoning)
+            program != null -> visitor.visitProgram(program)
+            programOutput != null -> visitor.visitProgramOutput(programOutput)
+            compaction != null -> visitor.visitCompaction(compaction)
+            imageGenerationCall != null -> visitor.visitImageGenerationCall(imageGenerationCall)
+            codeInterpreterCall != null -> visitor.visitCodeInterpreterCall(codeInterpreterCall)
+            localShellCall != null -> visitor.visitLocalShellCall(localShellCall)
+            localShellCallOutput != null -> visitor.visitLocalShellCallOutput(localShellCallOutput)
+            shellCall != null -> visitor.visitShellCall(shellCall)
+            shellCallOutput != null -> visitor.visitShellCallOutput(shellCallOutput)
+            applyPatchCall != null -> visitor.visitApplyPatchCall(applyPatchCall)
+            applyPatchCallOutput != null -> visitor.visitApplyPatchCallOutput(applyPatchCallOutput)
+            mcpListTools != null -> visitor.visitMcpListTools(mcpListTools)
+            mcpApprovalRequest != null -> visitor.visitMcpApprovalRequest(mcpApprovalRequest)
+            mcpApprovalResponse != null -> visitor.visitMcpApprovalResponse(mcpApprovalResponse)
+            mcpCall != null -> visitor.visitMcpCall(mcpCall)
+            customToolCall != null -> visitor.visitCustomToolCall(customToolCall)
+            customToolCallOutput != null -> visitor.visitCustomToolCallOutput(customToolCallOutput)
+            else -> visitor.unknown(_json)
+        }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseItem = apply {
+        if (validated) {
+            return@apply
+        }
+
+        accept(
+            object : Visitor<Unit> {
+                override fun visitBetaResponseInputMessageItem(
+                    betaResponseInputMessageItem: BetaResponseInputMessageItem
+                ) {
+                    betaResponseInputMessageItem.validate()
+                }
+
+                override fun visitBetaResponseOutputMessage(
+                    betaResponseOutputMessage: BetaResponseOutputMessage
+                ) {
+                    betaResponseOutputMessage.validate()
+                }
+
+                override fun visitFileSearchCall(fileSearchCall: BetaResponseFileSearchToolCall) {
+                    fileSearchCall.validate()
+                }
+
+                override fun visitComputerCall(computerCall: BetaResponseComputerToolCall) {
+                    computerCall.validate()
+                }
+
+                override fun visitComputerCallOutput(
+                    computerCallOutput: BetaResponseComputerToolCallOutputItem
+                ) {
+                    computerCallOutput.validate()
+                }
+
+                override fun visitWebSearchCall(webSearchCall: BetaResponseFunctionWebSearch) {
+                    webSearchCall.validate()
+                }
+
+                override fun visitFunctionCall(functionCall: BetaResponseFunctionToolCallItem) {
+                    functionCall.validate()
+                }
+
+                override fun visitFunctionCallOutput(
+                    functionCallOutput: BetaResponseFunctionToolCallOutputItem
+                ) {
+                    functionCallOutput.validate()
+                }
+
+                override fun visitAgentMessage(agentMessage: AgentMessage) {
+                    agentMessage.validate()
+                }
+
+                override fun visitMultiAgentCall(multiAgentCall: MultiAgentCall) {
+                    multiAgentCall.validate()
+                }
+
+                override fun visitMultiAgentCallOutput(multiAgentCallOutput: MultiAgentCallOutput) {
+                    multiAgentCallOutput.validate()
+                }
+
+                override fun visitToolSearchCall(toolSearchCall: BetaResponseToolSearchCall) {
+                    toolSearchCall.validate()
+                }
+
+                override fun visitToolSearchOutput(
+                    toolSearchOutput: BetaResponseToolSearchOutputItem
+                ) {
+                    toolSearchOutput.validate()
+                }
+
+                override fun visitAdditionalTools(additionalTools: AdditionalTools) {
+                    additionalTools.validate()
+                }
+
+                override fun visitReasoning(reasoning: BetaResponseReasoningItem) {
+                    reasoning.validate()
+                }
+
+                override fun visitProgram(program: Program) {
+                    program.validate()
+                }
+
+                override fun visitProgramOutput(programOutput: ProgramOutput) {
+                    programOutput.validate()
+                }
+
+                override fun visitCompaction(compaction: BetaResponseCompactionItem) {
+                    compaction.validate()
+                }
+
+                override fun visitImageGenerationCall(imageGenerationCall: ImageGenerationCall) {
+                    imageGenerationCall.validate()
+                }
+
+                override fun visitCodeInterpreterCall(
+                    codeInterpreterCall: BetaResponseCodeInterpreterToolCall
+                ) {
+                    codeInterpreterCall.validate()
+                }
+
+                override fun visitLocalShellCall(localShellCall: LocalShellCall) {
+                    localShellCall.validate()
+                }
+
+                override fun visitLocalShellCallOutput(localShellCallOutput: LocalShellCallOutput) {
+                    localShellCallOutput.validate()
+                }
+
+                override fun visitShellCall(shellCall: BetaResponseFunctionShellToolCall) {
+                    shellCall.validate()
+                }
+
+                override fun visitShellCallOutput(
+                    shellCallOutput: BetaResponseFunctionShellToolCallOutput
+                ) {
+                    shellCallOutput.validate()
+                }
+
+                override fun visitApplyPatchCall(applyPatchCall: BetaResponseApplyPatchToolCall) {
+                    applyPatchCall.validate()
+                }
+
+                override fun visitApplyPatchCallOutput(
+                    applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput
+                ) {
+                    applyPatchCallOutput.validate()
+                }
+
+                override fun visitMcpListTools(mcpListTools: McpListTools) {
+                    mcpListTools.validate()
+                }
+
+                override fun visitMcpApprovalRequest(mcpApprovalRequest: McpApprovalRequest) {
+                    mcpApprovalRequest.validate()
+                }
+
+                override fun visitMcpApprovalResponse(mcpApprovalResponse: McpApprovalResponse) {
+                    mcpApprovalResponse.validate()
+                }
+
+                override fun visitMcpCall(mcpCall: McpCall) {
+                    mcpCall.validate()
+                }
+
+                override fun visitCustomToolCall(customToolCall: BetaResponseCustomToolCallItem) {
+                    customToolCall.validate()
+                }
+
+                override fun visitCustomToolCallOutput(
+                    customToolCallOutput: BetaResponseCustomToolCallOutputItem
+                ) {
+                    customToolCallOutput.validate()
+                }
+            }
+        )
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        accept(
+            object : Visitor<Int> {
+                override fun visitBetaResponseInputMessageItem(
+                    betaResponseInputMessageItem: BetaResponseInputMessageItem
+                ) = betaResponseInputMessageItem.validity()
+
+                override fun visitBetaResponseOutputMessage(
+                    betaResponseOutputMessage: BetaResponseOutputMessage
+                ) = betaResponseOutputMessage.validity()
+
+                override fun visitFileSearchCall(fileSearchCall: BetaResponseFileSearchToolCall) =
+                    fileSearchCall.validity()
+
+                override fun visitComputerCall(computerCall: BetaResponseComputerToolCall) =
+                    computerCall.validity()
+
+                override fun visitComputerCallOutput(
+                    computerCallOutput: BetaResponseComputerToolCallOutputItem
+                ) = computerCallOutput.validity()
+
+                override fun visitWebSearchCall(webSearchCall: BetaResponseFunctionWebSearch) =
+                    webSearchCall.validity()
+
+                override fun visitFunctionCall(functionCall: BetaResponseFunctionToolCallItem) =
+                    functionCall.validity()
+
+                override fun visitFunctionCallOutput(
+                    functionCallOutput: BetaResponseFunctionToolCallOutputItem
+                ) = functionCallOutput.validity()
+
+                override fun visitAgentMessage(agentMessage: AgentMessage) = agentMessage.validity()
+
+                override fun visitMultiAgentCall(multiAgentCall: MultiAgentCall) =
+                    multiAgentCall.validity()
+
+                override fun visitMultiAgentCallOutput(multiAgentCallOutput: MultiAgentCallOutput) =
+                    multiAgentCallOutput.validity()
+
+                override fun visitToolSearchCall(toolSearchCall: BetaResponseToolSearchCall) =
+                    toolSearchCall.validity()
+
+                override fun visitToolSearchOutput(
+                    toolSearchOutput: BetaResponseToolSearchOutputItem
+                ) = toolSearchOutput.validity()
+
+                override fun visitAdditionalTools(additionalTools: AdditionalTools) =
+                    additionalTools.validity()
+
+                override fun visitReasoning(reasoning: BetaResponseReasoningItem) =
+                    reasoning.validity()
+
+                override fun visitProgram(program: Program) = program.validity()
+
+                override fun visitProgramOutput(programOutput: ProgramOutput) =
+                    programOutput.validity()
+
+                override fun visitCompaction(compaction: BetaResponseCompactionItem) =
+                    compaction.validity()
+
+                override fun visitImageGenerationCall(imageGenerationCall: ImageGenerationCall) =
+                    imageGenerationCall.validity()
+
+                override fun visitCodeInterpreterCall(
+                    codeInterpreterCall: BetaResponseCodeInterpreterToolCall
+                ) = codeInterpreterCall.validity()
+
+                override fun visitLocalShellCall(localShellCall: LocalShellCall) =
+                    localShellCall.validity()
+
+                override fun visitLocalShellCallOutput(localShellCallOutput: LocalShellCallOutput) =
+                    localShellCallOutput.validity()
+
+                override fun visitShellCall(shellCall: BetaResponseFunctionShellToolCall) =
+                    shellCall.validity()
+
+                override fun visitShellCallOutput(
+                    shellCallOutput: BetaResponseFunctionShellToolCallOutput
+                ) = shellCallOutput.validity()
+
+                override fun visitApplyPatchCall(applyPatchCall: BetaResponseApplyPatchToolCall) =
+                    applyPatchCall.validity()
+
+                override fun visitApplyPatchCallOutput(
+                    applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput
+                ) = applyPatchCallOutput.validity()
+
+                override fun visitMcpListTools(mcpListTools: McpListTools) = mcpListTools.validity()
+
+                override fun visitMcpApprovalRequest(mcpApprovalRequest: McpApprovalRequest) =
+                    mcpApprovalRequest.validity()
+
+                override fun visitMcpApprovalResponse(mcpApprovalResponse: McpApprovalResponse) =
+                    mcpApprovalResponse.validity()
+
+                override fun visitMcpCall(mcpCall: McpCall) = mcpCall.validity()
+
+                override fun visitCustomToolCall(customToolCall: BetaResponseCustomToolCallItem) =
+                    customToolCall.validity()
+
+                override fun visitCustomToolCallOutput(
+                    customToolCallOutput: BetaResponseCustomToolCallOutputItem
+                ) = customToolCallOutput.validity()
+
+                override fun unknown(json: JsonValue?) = 0
+            }
+        )
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseItem &&
+            betaResponseInputMessageItem == other.betaResponseInputMessageItem &&
+            betaResponseOutputMessage == other.betaResponseOutputMessage &&
+            fileSearchCall == other.fileSearchCall &&
+            computerCall == other.computerCall &&
+            computerCallOutput == other.computerCallOutput &&
+            webSearchCall == other.webSearchCall &&
+            functionCall == other.functionCall &&
+            functionCallOutput == other.functionCallOutput &&
+            agentMessage == other.agentMessage &&
+            multiAgentCall == other.multiAgentCall &&
+            multiAgentCallOutput == other.multiAgentCallOutput &&
+            toolSearchCall == other.toolSearchCall &&
+            toolSearchOutput == other.toolSearchOutput &&
+            additionalTools == other.additionalTools &&
+            reasoning == other.reasoning &&
+            program == other.program &&
+            programOutput == other.programOutput &&
+            compaction == other.compaction &&
+            imageGenerationCall == other.imageGenerationCall &&
+            codeInterpreterCall == other.codeInterpreterCall &&
+            localShellCall == other.localShellCall &&
+            localShellCallOutput == other.localShellCallOutput &&
+            shellCall == other.shellCall &&
+            shellCallOutput == other.shellCallOutput &&
+            applyPatchCall == other.applyPatchCall &&
+            applyPatchCallOutput == other.applyPatchCallOutput &&
+            mcpListTools == other.mcpListTools &&
+            mcpApprovalRequest == other.mcpApprovalRequest &&
+            mcpApprovalResponse == other.mcpApprovalResponse &&
+            mcpCall == other.mcpCall &&
+            customToolCall == other.customToolCall &&
+            customToolCallOutput == other.customToolCallOutput
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(
+            betaResponseInputMessageItem,
+            betaResponseOutputMessage,
+            fileSearchCall,
+            computerCall,
+            computerCallOutput,
+            webSearchCall,
+            functionCall,
+            functionCallOutput,
+            agentMessage,
+            multiAgentCall,
+            multiAgentCallOutput,
+            toolSearchCall,
+            toolSearchOutput,
+            additionalTools,
+            reasoning,
+            program,
+            programOutput,
+            compaction,
+            imageGenerationCall,
+            codeInterpreterCall,
+            localShellCall,
+            localShellCallOutput,
+            shellCall,
+            shellCallOutput,
+            applyPatchCall,
+            applyPatchCallOutput,
+            mcpListTools,
+            mcpApprovalRequest,
+            mcpApprovalResponse,
+            mcpCall,
+            customToolCall,
+            customToolCallOutput,
+        )
+
+    override fun toString(): String =
+        when {
+            betaResponseInputMessageItem != null ->
+                "BetaResponseItem{betaResponseInputMessageItem=$betaResponseInputMessageItem}"
+            betaResponseOutputMessage != null ->
+                "BetaResponseItem{betaResponseOutputMessage=$betaResponseOutputMessage}"
+            fileSearchCall != null -> "BetaResponseItem{fileSearchCall=$fileSearchCall}"
+            computerCall != null -> "BetaResponseItem{computerCall=$computerCall}"
+            computerCallOutput != null -> "BetaResponseItem{computerCallOutput=$computerCallOutput}"
+            webSearchCall != null -> "BetaResponseItem{webSearchCall=$webSearchCall}"
+            functionCall != null -> "BetaResponseItem{functionCall=$functionCall}"
+            functionCallOutput != null -> "BetaResponseItem{functionCallOutput=$functionCallOutput}"
+            agentMessage != null -> "BetaResponseItem{agentMessage=$agentMessage}"
+            multiAgentCall != null -> "BetaResponseItem{multiAgentCall=$multiAgentCall}"
+            multiAgentCallOutput != null ->
+                "BetaResponseItem{multiAgentCallOutput=$multiAgentCallOutput}"
+            toolSearchCall != null -> "BetaResponseItem{toolSearchCall=$toolSearchCall}"
+            toolSearchOutput != null -> "BetaResponseItem{toolSearchOutput=$toolSearchOutput}"
+            additionalTools != null -> "BetaResponseItem{additionalTools=$additionalTools}"
+            reasoning != null -> "BetaResponseItem{reasoning=$reasoning}"
+            program != null -> "BetaResponseItem{program=$program}"
+            programOutput != null -> "BetaResponseItem{programOutput=$programOutput}"
+            compaction != null -> "BetaResponseItem{compaction=$compaction}"
+            imageGenerationCall != null ->
+                "BetaResponseItem{imageGenerationCall=$imageGenerationCall}"
+            codeInterpreterCall != null ->
+                "BetaResponseItem{codeInterpreterCall=$codeInterpreterCall}"
+            localShellCall != null -> "BetaResponseItem{localShellCall=$localShellCall}"
+            localShellCallOutput != null ->
+                "BetaResponseItem{localShellCallOutput=$localShellCallOutput}"
+            shellCall != null -> "BetaResponseItem{shellCall=$shellCall}"
+            shellCallOutput != null -> "BetaResponseItem{shellCallOutput=$shellCallOutput}"
+            applyPatchCall != null -> "BetaResponseItem{applyPatchCall=$applyPatchCall}"
+            applyPatchCallOutput != null ->
+                "BetaResponseItem{applyPatchCallOutput=$applyPatchCallOutput}"
+            mcpListTools != null -> "BetaResponseItem{mcpListTools=$mcpListTools}"
+            mcpApprovalRequest != null -> "BetaResponseItem{mcpApprovalRequest=$mcpApprovalRequest}"
+            mcpApprovalResponse != null ->
+                "BetaResponseItem{mcpApprovalResponse=$mcpApprovalResponse}"
+            mcpCall != null -> "BetaResponseItem{mcpCall=$mcpCall}"
+            customToolCall != null -> "BetaResponseItem{customToolCall=$customToolCall}"
+            customToolCallOutput != null ->
+                "BetaResponseItem{customToolCallOutput=$customToolCallOutput}"
+            _json != null -> "BetaResponseItem{_unknown=$_json}"
+            else -> throw IllegalStateException("Invalid BetaResponseItem")
+        }
+
+    companion object {
+
+        @JvmStatic
+        fun ofBetaResponseInputMessageItem(
+            betaResponseInputMessageItem: BetaResponseInputMessageItem
+        ) = BetaResponseItem(betaResponseInputMessageItem = betaResponseInputMessageItem)
+
+        /** An output message from the model. */
+        @JvmStatic
+        fun ofBetaResponseOutputMessage(betaResponseOutputMessage: BetaResponseOutputMessage) =
+            BetaResponseItem(betaResponseOutputMessage = betaResponseOutputMessage)
+
+        /**
+         * The results of a file search tool call. See the
+         * [file search guide](https://platform.openai.com/docs/guides/tools-file-search) for more
+         * information.
+         */
+        @JvmStatic
+        fun ofFileSearchCall(fileSearchCall: BetaResponseFileSearchToolCall) =
+            BetaResponseItem(fileSearchCall = fileSearchCall)
+
+        /**
+         * A tool call to a computer use tool. See the
+         * [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more
+         * information.
+         */
+        @JvmStatic
+        fun ofComputerCall(computerCall: BetaResponseComputerToolCall) =
+            BetaResponseItem(computerCall = computerCall)
+
+        @JvmStatic
+        fun ofComputerCallOutput(computerCallOutput: BetaResponseComputerToolCallOutputItem) =
+            BetaResponseItem(computerCallOutput = computerCallOutput)
+
+        /**
+         * The results of a web search tool call. See the
+         * [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more
+         * information.
+         */
+        @JvmStatic
+        fun ofWebSearchCall(webSearchCall: BetaResponseFunctionWebSearch) =
+            BetaResponseItem(webSearchCall = webSearchCall)
+
+        /**
+         * A tool call to run a function. See the
+         * [function calling guide](https://platform.openai.com/docs/guides/function-calling) for
+         * more information.
+         */
+        @JvmStatic
+        fun ofFunctionCall(functionCall: BetaResponseFunctionToolCallItem) =
+            BetaResponseItem(functionCall = functionCall)
+
+        @JvmStatic
+        fun ofFunctionCallOutput(functionCallOutput: BetaResponseFunctionToolCallOutputItem) =
+            BetaResponseItem(functionCallOutput = functionCallOutput)
+
+        @JvmStatic
+        fun ofAgentMessage(agentMessage: AgentMessage) =
+            BetaResponseItem(agentMessage = agentMessage)
+
+        @JvmStatic
+        fun ofMultiAgentCall(multiAgentCall: MultiAgentCall) =
+            BetaResponseItem(multiAgentCall = multiAgentCall)
+
+        @JvmStatic
+        fun ofMultiAgentCallOutput(multiAgentCallOutput: MultiAgentCallOutput) =
+            BetaResponseItem(multiAgentCallOutput = multiAgentCallOutput)
+
+        @JvmStatic
+        fun ofToolSearchCall(toolSearchCall: BetaResponseToolSearchCall) =
+            BetaResponseItem(toolSearchCall = toolSearchCall)
+
+        @JvmStatic
+        fun ofToolSearchOutput(toolSearchOutput: BetaResponseToolSearchOutputItem) =
+            BetaResponseItem(toolSearchOutput = toolSearchOutput)
+
+        @JvmStatic
+        fun ofAdditionalTools(additionalTools: AdditionalTools) =
+            BetaResponseItem(additionalTools = additionalTools)
+
+        /**
+         * A description of the chain of thought used by a reasoning model while generating a
+         * response. Be sure to include these items in your `input` to the Responses API for
+         * subsequent turns of a conversation if you are manually
+         * [managing context](https://platform.openai.com/docs/guides/conversation-state).
+         */
+        @JvmStatic
+        fun ofReasoning(reasoning: BetaResponseReasoningItem) =
+            BetaResponseItem(reasoning = reasoning)
+
+        @JvmStatic fun ofProgram(program: Program) = BetaResponseItem(program = program)
+
+        @JvmStatic
+        fun ofProgramOutput(programOutput: ProgramOutput) =
+            BetaResponseItem(programOutput = programOutput)
+
+        /**
+         * A compaction item generated by the
+         * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+         */
+        @JvmStatic
+        fun ofCompaction(compaction: BetaResponseCompactionItem) =
+            BetaResponseItem(compaction = compaction)
+
+        /** An image generation request made by the model. */
+        @JvmStatic
+        fun ofImageGenerationCall(imageGenerationCall: ImageGenerationCall) =
+            BetaResponseItem(imageGenerationCall = imageGenerationCall)
+
+        /** A tool call to run code. */
+        @JvmStatic
+        fun ofCodeInterpreterCall(codeInterpreterCall: BetaResponseCodeInterpreterToolCall) =
+            BetaResponseItem(codeInterpreterCall = codeInterpreterCall)
+
+        /** A tool call to run a command on the local shell. */
+        @JvmStatic
+        fun ofLocalShellCall(localShellCall: LocalShellCall) =
+            BetaResponseItem(localShellCall = localShellCall)
+
+        /** The output of a local shell tool call. */
+        @JvmStatic
+        fun ofLocalShellCallOutput(localShellCallOutput: LocalShellCallOutput) =
+            BetaResponseItem(localShellCallOutput = localShellCallOutput)
+
+        /** A tool call that executes one or more shell commands in a managed environment. */
+        @JvmStatic
+        fun ofShellCall(shellCall: BetaResponseFunctionShellToolCall) =
+            BetaResponseItem(shellCall = shellCall)
+
+        /** The output of a shell tool call that was emitted. */
+        @JvmStatic
+        fun ofShellCallOutput(shellCallOutput: BetaResponseFunctionShellToolCallOutput) =
+            BetaResponseItem(shellCallOutput = shellCallOutput)
+
+        /** A tool call that applies file diffs by creating, deleting, or updating files. */
+        @JvmStatic
+        fun ofApplyPatchCall(applyPatchCall: BetaResponseApplyPatchToolCall) =
+            BetaResponseItem(applyPatchCall = applyPatchCall)
+
+        /** The output emitted by an apply patch tool call. */
+        @JvmStatic
+        fun ofApplyPatchCallOutput(applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput) =
+            BetaResponseItem(applyPatchCallOutput = applyPatchCallOutput)
+
+        /** A list of tools available on an MCP server. */
+        @JvmStatic
+        fun ofMcpListTools(mcpListTools: McpListTools) =
+            BetaResponseItem(mcpListTools = mcpListTools)
+
+        /** A request for human approval of a tool invocation. */
+        @JvmStatic
+        fun ofMcpApprovalRequest(mcpApprovalRequest: McpApprovalRequest) =
+            BetaResponseItem(mcpApprovalRequest = mcpApprovalRequest)
+
+        /** A response to an MCP approval request. */
+        @JvmStatic
+        fun ofMcpApprovalResponse(mcpApprovalResponse: McpApprovalResponse) =
+            BetaResponseItem(mcpApprovalResponse = mcpApprovalResponse)
+
+        /** An invocation of a tool on an MCP server. */
+        @JvmStatic fun ofMcpCall(mcpCall: McpCall) = BetaResponseItem(mcpCall = mcpCall)
+
+        /** A call to a custom tool created by the model. */
+        @JvmStatic
+        fun ofCustomToolCall(customToolCall: BetaResponseCustomToolCallItem) =
+            BetaResponseItem(customToolCall = customToolCall)
+
+        /** The output of a custom tool call from your code, being sent back to the model. */
+        @JvmStatic
+        fun ofCustomToolCallOutput(customToolCallOutput: BetaResponseCustomToolCallOutputItem) =
+            BetaResponseItem(customToolCallOutput = customToolCallOutput)
+    }
+
+    /**
+     * An interface that defines how to map each variant of [BetaResponseItem] to a value of type
+     * [T].
+     */
+    interface Visitor<out T> {
+
+        fun visitBetaResponseInputMessageItem(
+            betaResponseInputMessageItem: BetaResponseInputMessageItem
+        ): T
+
+        /** An output message from the model. */
+        fun visitBetaResponseOutputMessage(betaResponseOutputMessage: BetaResponseOutputMessage): T
+
+        /**
+         * The results of a file search tool call. See the
+         * [file search guide](https://platform.openai.com/docs/guides/tools-file-search) for more
+         * information.
+         */
+        fun visitFileSearchCall(fileSearchCall: BetaResponseFileSearchToolCall): T
+
+        /**
+         * A tool call to a computer use tool. See the
+         * [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more
+         * information.
+         */
+        fun visitComputerCall(computerCall: BetaResponseComputerToolCall): T
+
+        fun visitComputerCallOutput(computerCallOutput: BetaResponseComputerToolCallOutputItem): T
+
+        /**
+         * The results of a web search tool call. See the
+         * [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more
+         * information.
+         */
+        fun visitWebSearchCall(webSearchCall: BetaResponseFunctionWebSearch): T
+
+        /**
+         * A tool call to run a function. See the
+         * [function calling guide](https://platform.openai.com/docs/guides/function-calling) for
+         * more information.
+         */
+        fun visitFunctionCall(functionCall: BetaResponseFunctionToolCallItem): T
+
+        fun visitFunctionCallOutput(functionCallOutput: BetaResponseFunctionToolCallOutputItem): T
+
+        fun visitAgentMessage(agentMessage: AgentMessage): T
+
+        fun visitMultiAgentCall(multiAgentCall: MultiAgentCall): T
+
+        fun visitMultiAgentCallOutput(multiAgentCallOutput: MultiAgentCallOutput): T
+
+        fun visitToolSearchCall(toolSearchCall: BetaResponseToolSearchCall): T
+
+        fun visitToolSearchOutput(toolSearchOutput: BetaResponseToolSearchOutputItem): T
+
+        fun visitAdditionalTools(additionalTools: AdditionalTools): T
+
+        /**
+         * A description of the chain of thought used by a reasoning model while generating a
+         * response. Be sure to include these items in your `input` to the Responses API for
+         * subsequent turns of a conversation if you are manually
+         * [managing context](https://platform.openai.com/docs/guides/conversation-state).
+         */
+        fun visitReasoning(reasoning: BetaResponseReasoningItem): T
+
+        fun visitProgram(program: Program): T
+
+        fun visitProgramOutput(programOutput: ProgramOutput): T
+
+        /**
+         * A compaction item generated by the
+         * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+         */
+        fun visitCompaction(compaction: BetaResponseCompactionItem): T
+
+        /** An image generation request made by the model. */
+        fun visitImageGenerationCall(imageGenerationCall: ImageGenerationCall): T
+
+        /** A tool call to run code. */
+        fun visitCodeInterpreterCall(codeInterpreterCall: BetaResponseCodeInterpreterToolCall): T
+
+        /** A tool call to run a command on the local shell. */
+        fun visitLocalShellCall(localShellCall: LocalShellCall): T
+
+        /** The output of a local shell tool call. */
+        fun visitLocalShellCallOutput(localShellCallOutput: LocalShellCallOutput): T
+
+        /** A tool call that executes one or more shell commands in a managed environment. */
+        fun visitShellCall(shellCall: BetaResponseFunctionShellToolCall): T
+
+        /** The output of a shell tool call that was emitted. */
+        fun visitShellCallOutput(shellCallOutput: BetaResponseFunctionShellToolCallOutput): T
+
+        /** A tool call that applies file diffs by creating, deleting, or updating files. */
+        fun visitApplyPatchCall(applyPatchCall: BetaResponseApplyPatchToolCall): T
+
+        /** The output emitted by an apply patch tool call. */
+        fun visitApplyPatchCallOutput(applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput): T
+
+        /** A list of tools available on an MCP server. */
+        fun visitMcpListTools(mcpListTools: McpListTools): T
+
+        /** A request for human approval of a tool invocation. */
+        fun visitMcpApprovalRequest(mcpApprovalRequest: McpApprovalRequest): T
+
+        /** A response to an MCP approval request. */
+        fun visitMcpApprovalResponse(mcpApprovalResponse: McpApprovalResponse): T
+
+        /** An invocation of a tool on an MCP server. */
+        fun visitMcpCall(mcpCall: McpCall): T
+
+        /** A call to a custom tool created by the model. */
+        fun visitCustomToolCall(customToolCall: BetaResponseCustomToolCallItem): T
+
+        /** The output of a custom tool call from your code, being sent back to the model. */
+        fun visitCustomToolCallOutput(customToolCallOutput: BetaResponseCustomToolCallOutputItem): T
+
+        /**
+         * Maps an unknown variant of [BetaResponseItem] to a value of type [T].
+         *
+         * An instance of [BetaResponseItem] can contain an unknown variant if it was deserialized
+         * from data that doesn't match any known variant. For example, if the SDK is on an older
+         * version than the API, then the API may respond with new variants that the SDK is unaware
+         * of.
+         *
+         * @throws OpenAIInvalidDataException in the default implementation.
+         */
+        fun unknown(json: JsonValue?): T {
+            throw OpenAIInvalidDataException("Unknown BetaResponseItem: $json")
+        }
+    }
+
+    internal class Deserializer : BaseDeserializer<BetaResponseItem>(BetaResponseItem::class) {
+
+        override fun ObjectCodec.deserialize(node: JsonNode): BetaResponseItem {
+            val json = JsonValue.fromJsonNode(node)
+            val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+            when (type) {
+                "message" -> {
+                    val bestMatches =
+                        sequenceOf(
+                                tryDeserialize(node, jacksonTypeRef<BetaResponseInputMessageItem>())
+                                    ?.let {
+                                        BetaResponseItem(
+                                            betaResponseInputMessageItem = it,
+                                            _json = json,
+                                        )
+                                    },
+                                tryDeserialize(node, jacksonTypeRef<BetaResponseOutputMessage>())
+                                    ?.let {
+                                        BetaResponseItem(
+                                            betaResponseOutputMessage = it,
+                                            _json = json,
+                                        )
+                                    },
+                            )
+                            .filterNotNull()
+                            .allMaxBy { it.validity() }
+                            .toList()
+                    return when (bestMatches.size) {
+                        // This can happen if what we're deserializing is completely incompatible
+                        // with all the possible variants (e.g. deserializing from boolean).
+                        0 -> BetaResponseItem(_json = json)
+                        1 -> bestMatches.single()
+                        // If there's more than one match with the highest validity, then use the
+                        // first completely valid match, or simply the first match if none are
+                        // completely valid.
+                        else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                    }
+                }
+                "file_search_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseFileSearchToolCall>())
+                        ?.let { BetaResponseItem(fileSearchCall = it, _json = json) }
+                        ?: BetaResponseItem(_json = json)
+                }
+                "computer_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseComputerToolCall>())
+                        ?.let { BetaResponseItem(computerCall = it, _json = json) }
+                        ?: BetaResponseItem(_json = json)
+                }
+                "computer_call_output" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseComputerToolCallOutputItem>(),
+                        )
+                        ?.let { BetaResponseItem(computerCallOutput = it, _json = json) }
+                        ?: BetaResponseItem(_json = json)
+                }
+                "web_search_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseFunctionWebSearch>())
+                        ?.let { BetaResponseItem(webSearchCall = it, _json = json) }
+                        ?: BetaResponseItem(_json = json)
+                }
+                "function_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseFunctionToolCallItem>())
+                        ?.let { BetaResponseItem(functionCall = it, _json = json) }
+                        ?: BetaResponseItem(_json = json)
+                }
+                "function_call_output" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseFunctionToolCallOutputItem>(),
+                        )
+                        ?.let { BetaResponseItem(functionCallOutput = it, _json = json) }
+                        ?: BetaResponseItem(_json = json)
+                }
+                "agent_message" -> {
+                    return tryDeserialize(node, jacksonTypeRef<AgentMessage>())?.let {
+                        BetaResponseItem(agentMessage = it, _json = json)
+                    } ?: BetaResponseItem(_json = json)
+                }
+                "multi_agent_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<MultiAgentCall>())?.let {
+                        BetaResponseItem(multiAgentCall = it, _json = json)
+                    } ?: BetaResponseItem(_json = json)
+                }
+                "multi_agent_call_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<MultiAgentCallOutput>())?.let {
+                        BetaResponseItem(multiAgentCallOutput = it, _json = json)
+                    } ?: BetaResponseItem(_json = json)
+                }
+                "tool_search_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseToolSearchCall>())?.let {
+                        BetaResponseItem(toolSearchCall = it, _json = json)
+                    } ?: BetaResponseItem(_json = json)
+                }
+                "tool_search_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseToolSearchOutputItem>())
+                        ?.let { BetaResponseItem(toolSearchOutput = it, _json = json) }
+                        ?: BetaResponseItem(_json = json)
+                }
+                "additional_tools" -> {
+                    return tryDeserialize(node, jacksonTypeRef<AdditionalTools>())?.let {
+                        BetaResponseItem(additionalTools = it, _json = json)
+                    } ?: BetaResponseItem(_json = json)
+                }
+                "reasoning" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseReasoningItem>())?.let {
+                        BetaResponseItem(reasoning = it, _json = json)
+                    } ?: BetaResponseItem(_json = json)
+                }
+                "program" -> {
+                    return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                        BetaResponseItem(program = it, _json = json)
+                    } ?: BetaResponseItem(_json = json)
+                }
+                "program_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ProgramOutput>())?.let {
+                        BetaResponseItem(programOutput = it, _json = json)
+                    } ?: BetaResponseItem(_json = json)
+                }
+                "compaction" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseCompactionItem>())?.let {
+                        BetaResponseItem(compaction = it, _json = json)
+                    } ?: BetaResponseItem(_json = json)
+                }
+                "image_generation_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ImageGenerationCall>())?.let {
+                        BetaResponseItem(imageGenerationCall = it, _json = json)
+                    } ?: BetaResponseItem(_json = json)
+                }
+                "code_interpreter_call" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCodeInterpreterToolCall>(),
+                        )
+                        ?.let { BetaResponseItem(codeInterpreterCall = it, _json = json) }
+                        ?: BetaResponseItem(_json = json)
+                }
+                "local_shell_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<LocalShellCall>())?.let {
+                        BetaResponseItem(localShellCall = it, _json = json)
+                    } ?: BetaResponseItem(_json = json)
+                }
+                "local_shell_call_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<LocalShellCallOutput>())?.let {
+                        BetaResponseItem(localShellCallOutput = it, _json = json)
+                    } ?: BetaResponseItem(_json = json)
+                }
+                "shell_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseFunctionShellToolCall>())
+                        ?.let { BetaResponseItem(shellCall = it, _json = json) }
+                        ?: BetaResponseItem(_json = json)
+                }
+                "shell_call_output" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseFunctionShellToolCallOutput>(),
+                        )
+                        ?.let { BetaResponseItem(shellCallOutput = it, _json = json) }
+                        ?: BetaResponseItem(_json = json)
+                }
+                "apply_patch_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseApplyPatchToolCall>())
+                        ?.let { BetaResponseItem(applyPatchCall = it, _json = json) }
+                        ?: BetaResponseItem(_json = json)
+                }
+                "apply_patch_call_output" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseApplyPatchToolCallOutput>(),
+                        )
+                        ?.let { BetaResponseItem(applyPatchCallOutput = it, _json = json) }
+                        ?: BetaResponseItem(_json = json)
+                }
+                "mcp_list_tools" -> {
+                    return tryDeserialize(node, jacksonTypeRef<McpListTools>())?.let {
+                        BetaResponseItem(mcpListTools = it, _json = json)
+                    } ?: BetaResponseItem(_json = json)
+                }
+                "mcp_approval_request" -> {
+                    return tryDeserialize(node, jacksonTypeRef<McpApprovalRequest>())?.let {
+                        BetaResponseItem(mcpApprovalRequest = it, _json = json)
+                    } ?: BetaResponseItem(_json = json)
+                }
+                "mcp_approval_response" -> {
+                    return tryDeserialize(node, jacksonTypeRef<McpApprovalResponse>())?.let {
+                        BetaResponseItem(mcpApprovalResponse = it, _json = json)
+                    } ?: BetaResponseItem(_json = json)
+                }
+                "mcp_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<McpCall>())?.let {
+                        BetaResponseItem(mcpCall = it, _json = json)
+                    } ?: BetaResponseItem(_json = json)
+                }
+                "custom_tool_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseCustomToolCallItem>())
+                        ?.let { BetaResponseItem(customToolCall = it, _json = json) }
+                        ?: BetaResponseItem(_json = json)
+                }
+                "custom_tool_call_output" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCustomToolCallOutputItem>(),
+                        )
+                        ?.let { BetaResponseItem(customToolCallOutput = it, _json = json) }
+                        ?: BetaResponseItem(_json = json)
+                }
+            }
+
+            return BetaResponseItem(_json = json)
+        }
+    }
+
+    internal class Serializer : BaseSerializer<BetaResponseItem>(BetaResponseItem::class) {
+
+        override fun serialize(
+            value: BetaResponseItem,
+            generator: JsonGenerator,
+            provider: SerializerProvider,
+        ) {
+            when {
+                value.betaResponseInputMessageItem != null ->
+                    generator.writeObject(value.betaResponseInputMessageItem)
+                value.betaResponseOutputMessage != null ->
+                    generator.writeObject(value.betaResponseOutputMessage)
+                value.fileSearchCall != null -> generator.writeObject(value.fileSearchCall)
+                value.computerCall != null -> generator.writeObject(value.computerCall)
+                value.computerCallOutput != null -> generator.writeObject(value.computerCallOutput)
+                value.webSearchCall != null -> generator.writeObject(value.webSearchCall)
+                value.functionCall != null -> generator.writeObject(value.functionCall)
+                value.functionCallOutput != null -> generator.writeObject(value.functionCallOutput)
+                value.agentMessage != null -> generator.writeObject(value.agentMessage)
+                value.multiAgentCall != null -> generator.writeObject(value.multiAgentCall)
+                value.multiAgentCallOutput != null ->
+                    generator.writeObject(value.multiAgentCallOutput)
+                value.toolSearchCall != null -> generator.writeObject(value.toolSearchCall)
+                value.toolSearchOutput != null -> generator.writeObject(value.toolSearchOutput)
+                value.additionalTools != null -> generator.writeObject(value.additionalTools)
+                value.reasoning != null -> generator.writeObject(value.reasoning)
+                value.program != null -> generator.writeObject(value.program)
+                value.programOutput != null -> generator.writeObject(value.programOutput)
+                value.compaction != null -> generator.writeObject(value.compaction)
+                value.imageGenerationCall != null ->
+                    generator.writeObject(value.imageGenerationCall)
+                value.codeInterpreterCall != null ->
+                    generator.writeObject(value.codeInterpreterCall)
+                value.localShellCall != null -> generator.writeObject(value.localShellCall)
+                value.localShellCallOutput != null ->
+                    generator.writeObject(value.localShellCallOutput)
+                value.shellCall != null -> generator.writeObject(value.shellCall)
+                value.shellCallOutput != null -> generator.writeObject(value.shellCallOutput)
+                value.applyPatchCall != null -> generator.writeObject(value.applyPatchCall)
+                value.applyPatchCallOutput != null ->
+                    generator.writeObject(value.applyPatchCallOutput)
+                value.mcpListTools != null -> generator.writeObject(value.mcpListTools)
+                value.mcpApprovalRequest != null -> generator.writeObject(value.mcpApprovalRequest)
+                value.mcpApprovalResponse != null ->
+                    generator.writeObject(value.mcpApprovalResponse)
+                value.mcpCall != null -> generator.writeObject(value.mcpCall)
+                value.customToolCall != null -> generator.writeObject(value.customToolCall)
+                value.customToolCallOutput != null ->
+                    generator.writeObject(value.customToolCallOutput)
+                value._json != null -> generator.writeObject(value._json)
+                else -> throw IllegalStateException("Invalid BetaResponseItem")
+            }
+        }
+    }
+
+    class AgentMessage
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val author: JsonField<String>,
+        private val content: JsonField<List<Content>>,
+        private val recipient: JsonField<String>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("author") @ExcludeMissing author: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("content")
+            @ExcludeMissing
+            content: JsonField<List<Content>> = JsonMissing.of(),
+            @JsonProperty("recipient")
+            @ExcludeMissing
+            recipient: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, author, content, recipient, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the agent message.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The sending agent identity.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun author(): String = author.getRequired("author")
+
+        /**
+         * Encrypted content sent between agents.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun content(): List<Content> = content.getRequired("content")
+
+        /**
+         * The destination agent identity.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun recipient(): String = recipient.getRequired("recipient")
+
+        /**
+         * The type of the item. Always `agent_message`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("agent_message")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [author].
+         *
+         * Unlike [author], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("author") @ExcludeMissing fun _author(): JsonField<String> = author
+
+        /**
+         * Returns the raw JSON value of [content].
+         *
+         * Unlike [content], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("content") @ExcludeMissing fun _content(): JsonField<List<Content>> = content
+
+        /**
+         * Returns the raw JSON value of [recipient].
+         *
+         * Unlike [recipient], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("recipient") @ExcludeMissing fun _recipient(): JsonField<String> = recipient
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [AgentMessage].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .author()
+             * .content()
+             * .recipient()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [AgentMessage]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var author: JsonField<String>? = null
+            private var content: JsonField<MutableList<Content>>? = null
+            private var recipient: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("agent_message")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agentMessage: AgentMessage) = apply {
+                id = agentMessage.id
+                author = agentMessage.author
+                content = agentMessage.content.map { it.toMutableList() }
+                recipient = agentMessage.recipient
+                type = agentMessage.type
+                agent = agentMessage.agent
+                additionalProperties = agentMessage.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the agent message. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The sending agent identity. */
+            fun author(author: String) = author(JsonField.of(author))
+
+            /**
+             * Sets [Builder.author] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.author] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun author(author: JsonField<String>) = apply { this.author = author }
+
+            /** Encrypted content sent between agents. */
+            fun content(content: List<Content>) = content(JsonField.of(content))
+
+            /**
+             * Sets [Builder.content] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.content] with a well-typed `List<Content>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun content(content: JsonField<List<Content>>) = apply {
+                this.content = content.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [Content] to [Builder.content].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addContent(content: Content) = apply {
+                this.content =
+                    (this.content ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("content", it).add(content)
+                    }
+            }
+
+            /** Alias for calling [addContent] with `Content.ofInputText(inputText)`. */
+            fun addContent(inputText: BetaResponseInputText) =
+                addContent(Content.ofInputText(inputText))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * BetaResponseInputText.builder()
+             *     .text(text)
+             *     .build()
+             * ```
+             */
+            fun addInputTextContent(text: String) =
+                addContent(BetaResponseInputText.builder().text(text).build())
+
+            /** Alias for calling [addContent] with `Content.ofOutputText(outputText)`. */
+            fun addContent(outputText: BetaResponseOutputText) =
+                addContent(Content.ofOutputText(outputText))
+
+            /** Alias for calling [addContent] with `Content.ofText(text)`. */
+            fun addContent(text: Content.Text) = addContent(Content.ofText(text))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * Content.Text.builder()
+             *     .text(text)
+             *     .build()
+             * ```
+             */
+            fun addTextContent(text: String) = addContent(Content.Text.builder().text(text).build())
+
+            /** Alias for calling [addContent] with `Content.ofSummaryText(summaryText)`. */
+            fun addContent(summaryText: Content.SummaryText) =
+                addContent(Content.ofSummaryText(summaryText))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * Content.SummaryText.builder()
+             *     .text(text)
+             *     .build()
+             * ```
+             */
+            fun addSummaryTextContent(text: String) =
+                addContent(Content.SummaryText.builder().text(text).build())
+
+            /** Alias for calling [addContent] with `Content.ofReasoningText(reasoningText)`. */
+            fun addContent(reasoningText: Content.ReasoningText) =
+                addContent(Content.ofReasoningText(reasoningText))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * Content.ReasoningText.builder()
+             *     .text(text)
+             *     .build()
+             * ```
+             */
+            fun addReasoningTextContent(text: String) =
+                addContent(Content.ReasoningText.builder().text(text).build())
+
+            /** Alias for calling [addContent] with `Content.ofRefusal(refusal)`. */
+            fun addContent(refusal: BetaResponseOutputRefusal) =
+                addContent(Content.ofRefusal(refusal))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * BetaResponseOutputRefusal.builder()
+             *     .refusal(refusal)
+             *     .build()
+             * ```
+             */
+            fun addRefusalContent(refusal: String) =
+                addContent(BetaResponseOutputRefusal.builder().refusal(refusal).build())
+
+            /** Alias for calling [addContent] with `Content.ofInputImage(inputImage)`. */
+            fun addContent(inputImage: BetaResponseInputImage) =
+                addContent(Content.ofInputImage(inputImage))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * BetaResponseInputImage.builder()
+             *     .detail(detail)
+             *     .build()
+             * ```
+             */
+            fun addInputImageContent(detail: BetaResponseInputImage.Detail) =
+                addContent(BetaResponseInputImage.builder().detail(detail).build())
+
+            /**
+             * Alias for calling [addContent] with
+             * `Content.ofComputerScreenshot(computerScreenshot)`.
+             */
+            fun addContent(computerScreenshot: Content.ComputerScreenshot) =
+                addContent(Content.ofComputerScreenshot(computerScreenshot))
+
+            /** Alias for calling [addContent] with `Content.ofInputFile(inputFile)`. */
+            fun addContent(inputFile: BetaResponseInputFile) =
+                addContent(Content.ofInputFile(inputFile))
+
+            /** Alias for calling [addContent] with `Content.ofEncrypted(encrypted)`. */
+            fun addContent(encrypted: Content.EncryptedContent) =
+                addContent(Content.ofEncrypted(encrypted))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * Content.EncryptedContent.builder()
+             *     .encryptedContent(encryptedContent)
+             *     .build()
+             * ```
+             */
+            fun addEncryptedContent(encryptedContent: String) =
+                addContent(
+                    Content.EncryptedContent.builder().encryptedContent(encryptedContent).build()
+                )
+
+            /** The destination agent identity. */
+            fun recipient(recipient: String) = recipient(JsonField.of(recipient))
+
+            /**
+             * Sets [Builder.recipient] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.recipient] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun recipient(recipient: JsonField<String>) = apply { this.recipient = recipient }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("agent_message")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [AgentMessage].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .author()
+             * .content()
+             * .recipient()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): AgentMessage =
+                AgentMessage(
+                    checkRequired("id", id),
+                    checkRequired("author", author),
+                    checkRequired("content", content).map { it.toImmutable() },
+                    checkRequired("recipient", recipient),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): AgentMessage = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            author()
+            content().forEach { it.validate() }
+            recipient()
+            _type().let {
+                if (it != JsonValue.from("agent_message")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (author.asKnown().isPresent) 1 else 0) +
+                (content.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (if (recipient.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("agent_message")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** A content part that makes up an input or output item. */
+        @JsonDeserialize(using = Content.Deserializer::class)
+        @JsonSerialize(using = Content.Serializer::class)
+        class Content
+        private constructor(
+            private val inputText: BetaResponseInputText? = null,
+            private val outputText: BetaResponseOutputText? = null,
+            private val text: Text? = null,
+            private val summaryText: SummaryText? = null,
+            private val reasoningText: ReasoningText? = null,
+            private val refusal: BetaResponseOutputRefusal? = null,
+            private val inputImage: BetaResponseInputImage? = null,
+            private val computerScreenshot: ComputerScreenshot? = null,
+            private val inputFile: BetaResponseInputFile? = null,
+            private val encrypted: EncryptedContent? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /** A text input to the model. */
+            fun inputText(): Optional<BetaResponseInputText> = Optional.ofNullable(inputText)
+
+            /** A text output from the model. */
+            fun outputText(): Optional<BetaResponseOutputText> = Optional.ofNullable(outputText)
+
+            /** A text content. */
+            fun text(): Optional<Text> = Optional.ofNullable(text)
+
+            /** A summary text from the model. */
+            fun summaryText(): Optional<SummaryText> = Optional.ofNullable(summaryText)
+
+            /** Reasoning text from the model. */
+            fun reasoningText(): Optional<ReasoningText> = Optional.ofNullable(reasoningText)
+
+            /** A refusal from the model. */
+            fun refusal(): Optional<BetaResponseOutputRefusal> = Optional.ofNullable(refusal)
+
+            /**
+             * An image input to the model. Learn about
+             * [image inputs](https://platform.openai.com/docs/guides/vision).
+             */
+            fun inputImage(): Optional<BetaResponseInputImage> = Optional.ofNullable(inputImage)
+
+            /** A screenshot of a computer. */
+            fun computerScreenshot(): Optional<ComputerScreenshot> =
+                Optional.ofNullable(computerScreenshot)
+
+            /** A file input to the model. */
+            fun inputFile(): Optional<BetaResponseInputFile> = Optional.ofNullable(inputFile)
+
+            /**
+             * Opaque encrypted content that Responses API decrypts inside trusted model execution.
+             */
+            fun encrypted(): Optional<EncryptedContent> = Optional.ofNullable(encrypted)
+
+            fun isInputText(): Boolean = inputText != null
+
+            fun isOutputText(): Boolean = outputText != null
+
+            fun isText(): Boolean = text != null
+
+            fun isSummaryText(): Boolean = summaryText != null
+
+            fun isReasoningText(): Boolean = reasoningText != null
+
+            fun isRefusal(): Boolean = refusal != null
+
+            fun isInputImage(): Boolean = inputImage != null
+
+            fun isComputerScreenshot(): Boolean = computerScreenshot != null
+
+            fun isInputFile(): Boolean = inputFile != null
+
+            fun isEncrypted(): Boolean = encrypted != null
+
+            /** A text input to the model. */
+            fun asInputText(): BetaResponseInputText = inputText.getOrThrow("inputText")
+
+            /** A text output from the model. */
+            fun asOutputText(): BetaResponseOutputText = outputText.getOrThrow("outputText")
+
+            /** A text content. */
+            fun asText(): Text = text.getOrThrow("text")
+
+            /** A summary text from the model. */
+            fun asSummaryText(): SummaryText = summaryText.getOrThrow("summaryText")
+
+            /** Reasoning text from the model. */
+            fun asReasoningText(): ReasoningText = reasoningText.getOrThrow("reasoningText")
+
+            /** A refusal from the model. */
+            fun asRefusal(): BetaResponseOutputRefusal = refusal.getOrThrow("refusal")
+
+            /**
+             * An image input to the model. Learn about
+             * [image inputs](https://platform.openai.com/docs/guides/vision).
+             */
+            fun asInputImage(): BetaResponseInputImage = inputImage.getOrThrow("inputImage")
+
+            /** A screenshot of a computer. */
+            fun asComputerScreenshot(): ComputerScreenshot =
+                computerScreenshot.getOrThrow("computerScreenshot")
+
+            /** A file input to the model. */
+            fun asInputFile(): BetaResponseInputFile = inputFile.getOrThrow("inputFile")
+
+            /**
+             * Opaque encrypted content that Responses API decrypts inside trusted model execution.
+             */
+            fun asEncrypted(): EncryptedContent = encrypted.getOrThrow("encrypted")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = content.accept(new Content.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitInputText(BetaResponseInputText inputText) {
+             *         return Optional.of(inputText.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    inputText != null -> visitor.visitInputText(inputText)
+                    outputText != null -> visitor.visitOutputText(outputText)
+                    text != null -> visitor.visitText(text)
+                    summaryText != null -> visitor.visitSummaryText(summaryText)
+                    reasoningText != null -> visitor.visitReasoningText(reasoningText)
+                    refusal != null -> visitor.visitRefusal(refusal)
+                    inputImage != null -> visitor.visitInputImage(inputImage)
+                    computerScreenshot != null ->
+                        visitor.visitComputerScreenshot(computerScreenshot)
+                    inputFile != null -> visitor.visitInputFile(inputFile)
+                    encrypted != null -> visitor.visitEncrypted(encrypted)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Content = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitInputText(inputText: BetaResponseInputText) {
+                            inputText.validate()
+                        }
+
+                        override fun visitOutputText(outputText: BetaResponseOutputText) {
+                            outputText.validate()
+                        }
+
+                        override fun visitText(text: Text) {
+                            text.validate()
+                        }
+
+                        override fun visitSummaryText(summaryText: SummaryText) {
+                            summaryText.validate()
+                        }
+
+                        override fun visitReasoningText(reasoningText: ReasoningText) {
+                            reasoningText.validate()
+                        }
+
+                        override fun visitRefusal(refusal: BetaResponseOutputRefusal) {
+                            refusal.validate()
+                        }
+
+                        override fun visitInputImage(inputImage: BetaResponseInputImage) {
+                            inputImage.validate()
+                        }
+
+                        override fun visitComputerScreenshot(
+                            computerScreenshot: ComputerScreenshot
+                        ) {
+                            computerScreenshot.validate()
+                        }
+
+                        override fun visitInputFile(inputFile: BetaResponseInputFile) {
+                            inputFile.validate()
+                        }
+
+                        override fun visitEncrypted(encrypted: EncryptedContent) {
+                            encrypted.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitInputText(inputText: BetaResponseInputText) =
+                            inputText.validity()
+
+                        override fun visitOutputText(outputText: BetaResponseOutputText) =
+                            outputText.validity()
+
+                        override fun visitText(text: Text) = text.validity()
+
+                        override fun visitSummaryText(summaryText: SummaryText) =
+                            summaryText.validity()
+
+                        override fun visitReasoningText(reasoningText: ReasoningText) =
+                            reasoningText.validity()
+
+                        override fun visitRefusal(refusal: BetaResponseOutputRefusal) =
+                            refusal.validity()
+
+                        override fun visitInputImage(inputImage: BetaResponseInputImage) =
+                            inputImage.validity()
+
+                        override fun visitComputerScreenshot(
+                            computerScreenshot: ComputerScreenshot
+                        ) = computerScreenshot.validity()
+
+                        override fun visitInputFile(inputFile: BetaResponseInputFile) =
+                            inputFile.validity()
+
+                        override fun visitEncrypted(encrypted: EncryptedContent) =
+                            encrypted.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Content &&
+                    inputText == other.inputText &&
+                    outputText == other.outputText &&
+                    text == other.text &&
+                    summaryText == other.summaryText &&
+                    reasoningText == other.reasoningText &&
+                    refusal == other.refusal &&
+                    inputImage == other.inputImage &&
+                    computerScreenshot == other.computerScreenshot &&
+                    inputFile == other.inputFile &&
+                    encrypted == other.encrypted
+            }
+
+            override fun hashCode(): Int =
+                Objects.hash(
+                    inputText,
+                    outputText,
+                    text,
+                    summaryText,
+                    reasoningText,
+                    refusal,
+                    inputImage,
+                    computerScreenshot,
+                    inputFile,
+                    encrypted,
+                )
+
+            override fun toString(): String =
+                when {
+                    inputText != null -> "Content{inputText=$inputText}"
+                    outputText != null -> "Content{outputText=$outputText}"
+                    text != null -> "Content{text=$text}"
+                    summaryText != null -> "Content{summaryText=$summaryText}"
+                    reasoningText != null -> "Content{reasoningText=$reasoningText}"
+                    refusal != null -> "Content{refusal=$refusal}"
+                    inputImage != null -> "Content{inputImage=$inputImage}"
+                    computerScreenshot != null -> "Content{computerScreenshot=$computerScreenshot}"
+                    inputFile != null -> "Content{inputFile=$inputFile}"
+                    encrypted != null -> "Content{encrypted=$encrypted}"
+                    _json != null -> "Content{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Content")
+                }
+
+            companion object {
+
+                /** A text input to the model. */
+                @JvmStatic
+                fun ofInputText(inputText: BetaResponseInputText) = Content(inputText = inputText)
+
+                /** A text output from the model. */
+                @JvmStatic
+                fun ofOutputText(outputText: BetaResponseOutputText) =
+                    Content(outputText = outputText)
+
+                /** A text content. */
+                @JvmStatic fun ofText(text: Text) = Content(text = text)
+
+                /** A summary text from the model. */
+                @JvmStatic
+                fun ofSummaryText(summaryText: SummaryText) = Content(summaryText = summaryText)
+
+                /** Reasoning text from the model. */
+                @JvmStatic
+                fun ofReasoningText(reasoningText: ReasoningText) =
+                    Content(reasoningText = reasoningText)
+
+                /** A refusal from the model. */
+                @JvmStatic
+                fun ofRefusal(refusal: BetaResponseOutputRefusal) = Content(refusal = refusal)
+
+                /**
+                 * An image input to the model. Learn about
+                 * [image inputs](https://platform.openai.com/docs/guides/vision).
+                 */
+                @JvmStatic
+                fun ofInputImage(inputImage: BetaResponseInputImage) =
+                    Content(inputImage = inputImage)
+
+                /** A screenshot of a computer. */
+                @JvmStatic
+                fun ofComputerScreenshot(computerScreenshot: ComputerScreenshot) =
+                    Content(computerScreenshot = computerScreenshot)
+
+                /** A file input to the model. */
+                @JvmStatic
+                fun ofInputFile(inputFile: BetaResponseInputFile) = Content(inputFile = inputFile)
+
+                /**
+                 * Opaque encrypted content that Responses API decrypts inside trusted model
+                 * execution.
+                 */
+                @JvmStatic
+                fun ofEncrypted(encrypted: EncryptedContent) = Content(encrypted = encrypted)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Content] to a value of type
+             * [T].
+             */
+            interface Visitor<out T> {
+
+                /** A text input to the model. */
+                fun visitInputText(inputText: BetaResponseInputText): T
+
+                /** A text output from the model. */
+                fun visitOutputText(outputText: BetaResponseOutputText): T
+
+                /** A text content. */
+                fun visitText(text: Text): T
+
+                /** A summary text from the model. */
+                fun visitSummaryText(summaryText: SummaryText): T
+
+                /** Reasoning text from the model. */
+                fun visitReasoningText(reasoningText: ReasoningText): T
+
+                /** A refusal from the model. */
+                fun visitRefusal(refusal: BetaResponseOutputRefusal): T
+
+                /**
+                 * An image input to the model. Learn about
+                 * [image inputs](https://platform.openai.com/docs/guides/vision).
+                 */
+                fun visitInputImage(inputImage: BetaResponseInputImage): T
+
+                /** A screenshot of a computer. */
+                fun visitComputerScreenshot(computerScreenshot: ComputerScreenshot): T
+
+                /** A file input to the model. */
+                fun visitInputFile(inputFile: BetaResponseInputFile): T
+
+                /**
+                 * Opaque encrypted content that Responses API decrypts inside trusted model
+                 * execution.
+                 */
+                fun visitEncrypted(encrypted: EncryptedContent): T
+
+                /**
+                 * Maps an unknown variant of [Content] to a value of type [T].
+                 *
+                 * An instance of [Content] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Content: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Content>(Content::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Content {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "input_text" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaResponseInputText>())
+                                ?.let { Content(inputText = it, _json = json) }
+                                ?: Content(_json = json)
+                        }
+                        "output_text" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaResponseOutputText>())
+                                ?.let { Content(outputText = it, _json = json) }
+                                ?: Content(_json = json)
+                        }
+                        "text" -> {
+                            return tryDeserialize(node, jacksonTypeRef<Text>())?.let {
+                                Content(text = it, _json = json)
+                            } ?: Content(_json = json)
+                        }
+                        "summary_text" -> {
+                            return tryDeserialize(node, jacksonTypeRef<SummaryText>())?.let {
+                                Content(summaryText = it, _json = json)
+                            } ?: Content(_json = json)
+                        }
+                        "reasoning_text" -> {
+                            return tryDeserialize(node, jacksonTypeRef<ReasoningText>())?.let {
+                                Content(reasoningText = it, _json = json)
+                            } ?: Content(_json = json)
+                        }
+                        "refusal" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaResponseOutputRefusal>())
+                                ?.let { Content(refusal = it, _json = json) }
+                                ?: Content(_json = json)
+                        }
+                        "input_image" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaResponseInputImage>())
+                                ?.let { Content(inputImage = it, _json = json) }
+                                ?: Content(_json = json)
+                        }
+                        "computer_screenshot" -> {
+                            return tryDeserialize(node, jacksonTypeRef<ComputerScreenshot>())?.let {
+                                Content(computerScreenshot = it, _json = json)
+                            } ?: Content(_json = json)
+                        }
+                        "input_file" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaResponseInputFile>())
+                                ?.let { Content(inputFile = it, _json = json) }
+                                ?: Content(_json = json)
+                        }
+                        "encrypted_content" -> {
+                            return tryDeserialize(node, jacksonTypeRef<EncryptedContent>())?.let {
+                                Content(encrypted = it, _json = json)
+                            } ?: Content(_json = json)
+                        }
+                    }
+
+                    return Content(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Content>(Content::class) {
+
+                override fun serialize(
+                    value: Content,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.inputText != null -> generator.writeObject(value.inputText)
+                        value.outputText != null -> generator.writeObject(value.outputText)
+                        value.text != null -> generator.writeObject(value.text)
+                        value.summaryText != null -> generator.writeObject(value.summaryText)
+                        value.reasoningText != null -> generator.writeObject(value.reasoningText)
+                        value.refusal != null -> generator.writeObject(value.refusal)
+                        value.inputImage != null -> generator.writeObject(value.inputImage)
+                        value.computerScreenshot != null ->
+                            generator.writeObject(value.computerScreenshot)
+                        value.inputFile != null -> generator.writeObject(value.inputFile)
+                        value.encrypted != null -> generator.writeObject(value.encrypted)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Content")
+                    }
+                }
+            }
+
+            /** A text content. */
+            class Text
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val text: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("text")
+                    @ExcludeMissing
+                    text: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(text, type, mutableMapOf())
+
+                /**
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun text(): String = text.getRequired("text")
+
+                /**
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("text")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [text].
+                 *
+                 * Unlike [text], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Text].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .text()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Text]. */
+                class Builder internal constructor() {
+
+                    private var text: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("text")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(text: Text) = apply {
+                        this.text = text.text
+                        type = text.type
+                        additionalProperties = text.additionalProperties.toMutableMap()
+                    }
+
+                    fun text(text: String) = text(JsonField.of(text))
+
+                    /**
+                     * Sets [Builder.text] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.text] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun text(text: JsonField<String>) = apply { this.text = text }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("text")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Text].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .text()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Text =
+                        Text(checkRequired("text", text), type, additionalProperties.toMutableMap())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Text = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    text()
+                    _type().let {
+                        if (it != JsonValue.from("text")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (text.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("text")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Text &&
+                        text == other.text &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Text{text=$text, type=$type, additionalProperties=$additionalProperties}"
+            }
+
+            /** A summary text from the model. */
+            class SummaryText
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val text: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("text")
+                    @ExcludeMissing
+                    text: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(text, type, mutableMapOf())
+
+                /**
+                 * A summary of the reasoning output from the model so far.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun text(): String = text.getRequired("text")
+
+                /**
+                 * The type of the object. Always `summary_text`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("summary_text")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [text].
+                 *
+                 * Unlike [text], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [SummaryText].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .text()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [SummaryText]. */
+                class Builder internal constructor() {
+
+                    private var text: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("summary_text")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(summaryText: SummaryText) = apply {
+                        text = summaryText.text
+                        type = summaryText.type
+                        additionalProperties = summaryText.additionalProperties.toMutableMap()
+                    }
+
+                    /** A summary of the reasoning output from the model so far. */
+                    fun text(text: String) = text(JsonField.of(text))
+
+                    /**
+                     * Sets [Builder.text] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.text] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun text(text: JsonField<String>) = apply { this.text = text }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("summary_text")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [SummaryText].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .text()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): SummaryText =
+                        SummaryText(
+                            checkRequired("text", text),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): SummaryText = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    text()
+                    _type().let {
+                        if (it != JsonValue.from("summary_text")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (text.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("summary_text")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is SummaryText &&
+                        text == other.text &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "SummaryText{text=$text, type=$type, additionalProperties=$additionalProperties}"
+            }
+
+            /** Reasoning text from the model. */
+            class ReasoningText
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val text: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("text")
+                    @ExcludeMissing
+                    text: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(text, type, mutableMapOf())
+
+                /**
+                 * The reasoning text from the model.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun text(): String = text.getRequired("text")
+
+                /**
+                 * The type of the reasoning text. Always `reasoning_text`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("reasoning_text")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [text].
+                 *
+                 * Unlike [text], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [ReasoningText].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .text()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [ReasoningText]. */
+                class Builder internal constructor() {
+
+                    private var text: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("reasoning_text")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(reasoningText: ReasoningText) = apply {
+                        text = reasoningText.text
+                        type = reasoningText.type
+                        additionalProperties = reasoningText.additionalProperties.toMutableMap()
+                    }
+
+                    /** The reasoning text from the model. */
+                    fun text(text: String) = text(JsonField.of(text))
+
+                    /**
+                     * Sets [Builder.text] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.text] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun text(text: JsonField<String>) = apply { this.text = text }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("reasoning_text")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [ReasoningText].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .text()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): ReasoningText =
+                        ReasoningText(
+                            checkRequired("text", text),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): ReasoningText = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    text()
+                    _type().let {
+                        if (it != JsonValue.from("reasoning_text")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (text.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("reasoning_text")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is ReasoningText &&
+                        text == other.text &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "ReasoningText{text=$text, type=$type, additionalProperties=$additionalProperties}"
+            }
+
+            /** A screenshot of a computer. */
+            class ComputerScreenshot
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val detail: JsonField<Detail>,
+                private val fileId: JsonField<String>,
+                private val imageUrl: JsonField<String>,
+                private val type: JsonValue,
+                private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("detail")
+                    @ExcludeMissing
+                    detail: JsonField<Detail> = JsonMissing.of(),
+                    @JsonProperty("file_id")
+                    @ExcludeMissing
+                    fileId: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("image_url")
+                    @ExcludeMissing
+                    imageUrl: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                    @JsonProperty("prompt_cache_breakpoint")
+                    @ExcludeMissing
+                    promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+                ) : this(detail, fileId, imageUrl, type, promptCacheBreakpoint, mutableMapOf())
+
+                /**
+                 * The detail level of the screenshot image to be sent to the model. One of `high`,
+                 * `low`, `auto`, or `original`. Defaults to `auto`.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun detail(): Detail = detail.getRequired("detail")
+
+                /**
+                 * The identifier of an uploaded file that contains the screenshot.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun fileId(): Optional<String> = fileId.getOptional("file_id")
+
+                /**
+                 * The URL of the screenshot image.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun imageUrl(): Optional<String> = imageUrl.getOptional("image_url")
+
+                /**
+                 * Specifies the event type. For a computer screenshot, this property is always set
+                 * to `computer_screenshot`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("computer_screenshot")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+                 * from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+                 * token block.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+                    promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
+                /**
+                 * Returns the raw JSON value of [detail].
+                 *
+                 * Unlike [detail], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("detail") @ExcludeMissing fun _detail(): JsonField<Detail> = detail
+
+                /**
+                 * Returns the raw JSON value of [fileId].
+                 *
+                 * Unlike [fileId], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("file_id") @ExcludeMissing fun _fileId(): JsonField<String> = fileId
+
+                /**
+                 * Returns the raw JSON value of [imageUrl].
+                 *
+                 * Unlike [imageUrl], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("image_url")
+                @ExcludeMissing
+                fun _imageUrl(): JsonField<String> = imageUrl
+
+                /**
+                 * Returns the raw JSON value of [promptCacheBreakpoint].
+                 *
+                 * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has
+                 * an unexpected type.
+                 */
+                @JsonProperty("prompt_cache_breakpoint")
+                @ExcludeMissing
+                fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> =
+                    promptCacheBreakpoint
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of
+                     * [ComputerScreenshot].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .detail()
+                     * .fileId()
+                     * .imageUrl()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [ComputerScreenshot]. */
+                class Builder internal constructor() {
+
+                    private var detail: JsonField<Detail>? = null
+                    private var fileId: JsonField<String>? = null
+                    private var imageUrl: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("computer_screenshot")
+                    private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> =
+                        JsonMissing.of()
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(computerScreenshot: ComputerScreenshot) = apply {
+                        detail = computerScreenshot.detail
+                        fileId = computerScreenshot.fileId
+                        imageUrl = computerScreenshot.imageUrl
+                        type = computerScreenshot.type
+                        promptCacheBreakpoint = computerScreenshot.promptCacheBreakpoint
+                        additionalProperties =
+                            computerScreenshot.additionalProperties.toMutableMap()
+                    }
+
+                    /**
+                     * The detail level of the screenshot image to be sent to the model. One of
+                     * `high`, `low`, `auto`, or `original`. Defaults to `auto`.
+                     */
+                    fun detail(detail: Detail) = detail(JsonField.of(detail))
+
+                    /**
+                     * Sets [Builder.detail] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.detail] with a well-typed [Detail] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun detail(detail: JsonField<Detail>) = apply { this.detail = detail }
+
+                    /** The identifier of an uploaded file that contains the screenshot. */
+                    fun fileId(fileId: String?) = fileId(JsonField.ofNullable(fileId))
+
+                    /** Alias for calling [Builder.fileId] with `fileId.orElse(null)`. */
+                    fun fileId(fileId: Optional<String>) = fileId(fileId.getOrNull())
+
+                    /**
+                     * Sets [Builder.fileId] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.fileId] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun fileId(fileId: JsonField<String>) = apply { this.fileId = fileId }
+
+                    /** The URL of the screenshot image. */
+                    fun imageUrl(imageUrl: String?) = imageUrl(JsonField.ofNullable(imageUrl))
+
+                    /** Alias for calling [Builder.imageUrl] with `imageUrl.orElse(null)`. */
+                    fun imageUrl(imageUrl: Optional<String>) = imageUrl(imageUrl.getOrNull())
+
+                    /**
+                     * Sets [Builder.imageUrl] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.imageUrl] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun imageUrl(imageUrl: JsonField<String>) = apply { this.imageUrl = imageUrl }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("computer_screenshot")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    /**
+                     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its
+                     * TTL from the request's `prompt_cache_options.ttl`; the boundary is not
+                     * rounded to a token block.
+                     */
+                    fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint) =
+                        promptCacheBreakpoint(JsonField.of(promptCacheBreakpoint))
+
+                    /**
+                     * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+                     * [PromptCacheBreakpoint] value instead. This method is primarily for setting
+                     * the field to an undocumented or not yet supported value.
+                     */
+                    fun promptCacheBreakpoint(
+                        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>
+                    ) = apply { this.promptCacheBreakpoint = promptCacheBreakpoint }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [ComputerScreenshot].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .detail()
+                     * .fileId()
+                     * .imageUrl()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): ComputerScreenshot =
+                        ComputerScreenshot(
+                            checkRequired("detail", detail),
+                            checkRequired("fileId", fileId),
+                            checkRequired("imageUrl", imageUrl),
+                            type,
+                            promptCacheBreakpoint,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): ComputerScreenshot = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    detail().validate()
+                    fileId()
+                    imageUrl()
+                    _type().let {
+                        if (it != JsonValue.from("computer_screenshot")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    promptCacheBreakpoint().ifPresent { it.validate() }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (detail.asKnown().getOrNull()?.validity() ?: 0) +
+                        (if (fileId.asKnown().isPresent) 1 else 0) +
+                        (if (imageUrl.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("computer_screenshot")) 1 else 0 } +
+                        (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
+
+                /**
+                 * The detail level of the screenshot image to be sent to the model. One of `high`,
+                 * `low`, `auto`, or `original`. Defaults to `auto`.
+                 */
+                class Detail
+                @JsonCreator
+                private constructor(private val value: JsonField<String>) : Enum {
+
+                    /**
+                     * Returns this class instance's raw value.
+                     *
+                     * This is usually only useful if this instance was deserialized from data that
+                     * doesn't match any known member, and you want to know that value. For example,
+                     * if the SDK is on an older version than the API, then the API may respond with
+                     * new members that the SDK is unaware of.
+                     */
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    fun _value(): JsonField<String> = value
+
+                    companion object {
+
+                        @JvmField val LOW = of("low")
+
+                        @JvmField val HIGH = of("high")
+
+                        @JvmField val AUTO = of("auto")
+
+                        @JvmField val ORIGINAL = of("original")
+
+                        @JvmStatic fun of(value: String) = Detail(JsonField.of(value))
+                    }
+
+                    /** An enum containing [Detail]'s known values. */
+                    enum class Known {
+                        LOW,
+                        HIGH,
+                        AUTO,
+                        ORIGINAL,
+                    }
+
+                    /**
+                     * An enum containing [Detail]'s known values, as well as an [_UNKNOWN] member.
+                     *
+                     * An instance of [Detail] can contain an unknown value in a couple of cases:
+                     * - It was deserialized from data that doesn't match any known member. For
+                     *   example, if the SDK is on an older version than the API, then the API may
+                     *   respond with new members that the SDK is unaware of.
+                     * - It was constructed with an arbitrary value using the [of] method.
+                     */
+                    enum class Value {
+                        LOW,
+                        HIGH,
+                        AUTO,
+                        ORIGINAL,
+                        /**
+                         * An enum member indicating that [Detail] was instantiated with an unknown
+                         * value.
+                         */
+                        _UNKNOWN,
+                    }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value, or
+                     * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                     *
+                     * Use the [known] method instead if you're certain the value is always known or
+                     * if you want to throw for the unknown case.
+                     */
+                    fun value(): Value =
+                        when (this) {
+                            LOW -> Value.LOW
+                            HIGH -> Value.HIGH
+                            AUTO -> Value.AUTO
+                            ORIGINAL -> Value.ORIGINAL
+                            else -> Value._UNKNOWN
+                        }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value.
+                     *
+                     * Use the [value] method instead if you're uncertain the value is always known
+                     * and don't want to throw for the unknown case.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                     *   known member.
+                     */
+                    fun known(): Known =
+                        when (this) {
+                            LOW -> Known.LOW
+                            HIGH -> Known.HIGH
+                            AUTO -> Known.AUTO
+                            ORIGINAL -> Known.ORIGINAL
+                            else -> throw OpenAIInvalidDataException("Unknown Detail: $value")
+                        }
+
+                    /**
+                     * Returns this class instance's primitive wire representation.
+                     *
+                     * This differs from the [toString] method because that method is primarily for
+                     * debugging and generally doesn't throw.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value does not
+                     *   have the expected primitive type.
+                     */
+                    fun asString(): String =
+                        _value().asString().orElseThrow {
+                            OpenAIInvalidDataException("Value is not a String")
+                        }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): Detail = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        known()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Detail && value == other.value
+                    }
+
+                    override fun hashCode() = value.hashCode()
+
+                    override fun toString() = value.toString()
+                }
+
+                /**
+                 * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+                 * from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+                 * token block.
+                 */
+                class PromptCacheBreakpoint
+                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+                private constructor(
+                    private val mode: JsonValue,
+                    private val additionalProperties: MutableMap<String, JsonValue>,
+                ) {
+
+                    @JsonCreator
+                    private constructor(
+                        @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+                    ) : this(mode, mutableMapOf())
+
+                    /**
+                     * The breakpoint mode. Always `explicit`.
+                     *
+                     * Expected to always return the following:
+                     * ```java
+                     * JsonValue.from("explicit")
+                     * ```
+                     *
+                     * However, this method can be useful for debugging and logging (e.g. if the
+                     * server responded with an unexpected value).
+                     */
+                    @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+                    @JsonAnySetter
+                    private fun putAdditionalProperty(key: String, value: JsonValue) {
+                        additionalProperties.put(key, value)
+                    }
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> =
+                        Collections.unmodifiableMap(additionalProperties)
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of
+                         * [PromptCacheBreakpoint].
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [PromptCacheBreakpoint]. */
+                    class Builder internal constructor() {
+
+                        private var mode: JsonValue = JsonValue.from("explicit")
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                            mode = promptCacheBreakpoint.mode
+                            additionalProperties =
+                                promptCacheBreakpoint.additionalProperties.toMutableMap()
+                        }
+
+                        /**
+                         * Sets the field to an arbitrary JSON value.
+                         *
+                         * It is usually unnecessary to call this method because the field defaults
+                         * to the following:
+                         * ```java
+                         * JsonValue.from("explicit")
+                         * ```
+                         *
+                         * This method is primarily for setting the field to an undocumented or not
+                         * yet supported value.
+                         */
+                        fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [PromptCacheBreakpoint].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         */
+                        fun build(): PromptCacheBreakpoint =
+                            PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): PromptCacheBreakpoint = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        _mode().let {
+                            if (it != JsonValue.from("explicit")) {
+                                throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                            }
+                        }
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is PromptCacheBreakpoint &&
+                            mode == other.mode &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is ComputerScreenshot &&
+                        detail == other.detail &&
+                        fileId == other.fileId &&
+                        imageUrl == other.imageUrl &&
+                        type == other.type &&
+                        promptCacheBreakpoint == other.promptCacheBreakpoint &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(
+                        detail,
+                        fileId,
+                        imageUrl,
+                        type,
+                        promptCacheBreakpoint,
+                        additionalProperties,
+                    )
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "ComputerScreenshot{detail=$detail, fileId=$fileId, imageUrl=$imageUrl, type=$type, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
+            }
+
+            /**
+             * Opaque encrypted content that Responses API decrypts inside trusted model execution.
+             */
+            class EncryptedContent
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val encryptedContent: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("encrypted_content")
+                    @ExcludeMissing
+                    encryptedContent: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(encryptedContent, type, mutableMapOf())
+
+                /**
+                 * Opaque encrypted content.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun encryptedContent(): String = encryptedContent.getRequired("encrypted_content")
+
+                /**
+                 * The type of the input item. Always `encrypted_content`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("encrypted_content")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [encryptedContent].
+                 *
+                 * Unlike [encryptedContent], this method doesn't throw if the JSON field has an
+                 * unexpected type.
+                 */
+                @JsonProperty("encrypted_content")
+                @ExcludeMissing
+                fun _encryptedContent(): JsonField<String> = encryptedContent
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [EncryptedContent].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .encryptedContent()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [EncryptedContent]. */
+                class Builder internal constructor() {
+
+                    private var encryptedContent: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("encrypted_content")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(encryptedContent: EncryptedContent) = apply {
+                        this.encryptedContent = encryptedContent.encryptedContent
+                        type = encryptedContent.type
+                        additionalProperties = encryptedContent.additionalProperties.toMutableMap()
+                    }
+
+                    /** Opaque encrypted content. */
+                    fun encryptedContent(encryptedContent: String) =
+                        encryptedContent(JsonField.of(encryptedContent))
+
+                    /**
+                     * Sets [Builder.encryptedContent] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.encryptedContent] with a well-typed [String]
+                     * value instead. This method is primarily for setting the field to an
+                     * undocumented or not yet supported value.
+                     */
+                    fun encryptedContent(encryptedContent: JsonField<String>) = apply {
+                        this.encryptedContent = encryptedContent
+                    }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("encrypted_content")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [EncryptedContent].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .encryptedContent()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): EncryptedContent =
+                        EncryptedContent(
+                            checkRequired("encryptedContent", encryptedContent),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): EncryptedContent = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    encryptedContent()
+                    _type().let {
+                        if (it != JsonValue.from("encrypted_content")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (encryptedContent.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("encrypted_content")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is EncryptedContent &&
+                        encryptedContent == other.encryptedContent &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(encryptedContent, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "EncryptedContent{encryptedContent=$encryptedContent, type=$type, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AgentMessage &&
+                id == other.id &&
+                author == other.author &&
+                content == other.content &&
+                recipient == other.recipient &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, author, content, recipient, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "AgentMessage{id=$id, author=$author, content=$content, recipient=$recipient, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    class MultiAgentCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val action: JsonField<Action>,
+        private val arguments: JsonField<String>,
+        private val callId: JsonField<String>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
+            @JsonProperty("arguments")
+            @ExcludeMissing
+            arguments: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, action, arguments, callId, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the multi-agent call item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The multi-agent action to execute.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun action(): Action = action.getRequired("action")
+
+        /**
+         * The JSON string of arguments generated for the action.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun arguments(): String = arguments.getRequired("arguments")
+
+        /**
+         * The unique ID linking this call to its output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The type of the multi-agent call. Always `multi_agent_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("multi_agent_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [action].
+         *
+         * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+
+        /**
+         * Returns the raw JSON value of [arguments].
+         *
+         * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [MultiAgentCall].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .action()
+             * .arguments()
+             * .callId()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [MultiAgentCall]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var action: JsonField<Action>? = null
+            private var arguments: JsonField<String>? = null
+            private var callId: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("multi_agent_call")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(multiAgentCall: MultiAgentCall) = apply {
+                id = multiAgentCall.id
+                action = multiAgentCall.action
+                arguments = multiAgentCall.arguments
+                callId = multiAgentCall.callId
+                type = multiAgentCall.type
+                agent = multiAgentCall.agent
+                additionalProperties = multiAgentCall.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the multi-agent call item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The multi-agent action to execute. */
+            fun action(action: Action) = action(JsonField.of(action))
+
+            /**
+             * Sets [Builder.action] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.action] with a well-typed [Action] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun action(action: JsonField<Action>) = apply { this.action = action }
+
+            /** The JSON string of arguments generated for the action. */
+            fun arguments(arguments: String) = arguments(JsonField.of(arguments))
+
+            /**
+             * Sets [Builder.arguments] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.arguments] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
+
+            /** The unique ID linking this call to its output. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("multi_agent_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [MultiAgentCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .action()
+             * .arguments()
+             * .callId()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): MultiAgentCall =
+                MultiAgentCall(
+                    checkRequired("id", id),
+                    checkRequired("action", action),
+                    checkRequired("arguments", arguments),
+                    checkRequired("callId", callId),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): MultiAgentCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            action().validate()
+            arguments()
+            callId()
+            _type().let {
+                if (it != JsonValue.from("multi_agent_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (action.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (arguments.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("multi_agent_call")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The multi-agent action to execute. */
+        class Action @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val SPAWN_AGENT = of("spawn_agent")
+
+                @JvmField val INTERRUPT_AGENT = of("interrupt_agent")
+
+                @JvmField val LIST_AGENTS = of("list_agents")
+
+                @JvmField val SEND_MESSAGE = of("send_message")
+
+                @JvmField val FOLLOWUP_TASK = of("followup_task")
+
+                @JvmField val WAIT_AGENT = of("wait_agent")
+
+                @JvmStatic fun of(value: String) = Action(JsonField.of(value))
+            }
+
+            /** An enum containing [Action]'s known values. */
+            enum class Known {
+                SPAWN_AGENT,
+                INTERRUPT_AGENT,
+                LIST_AGENTS,
+                SEND_MESSAGE,
+                FOLLOWUP_TASK,
+                WAIT_AGENT,
+            }
+
+            /**
+             * An enum containing [Action]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Action] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                SPAWN_AGENT,
+                INTERRUPT_AGENT,
+                LIST_AGENTS,
+                SEND_MESSAGE,
+                FOLLOWUP_TASK,
+                WAIT_AGENT,
+                /**
+                 * An enum member indicating that [Action] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    SPAWN_AGENT -> Value.SPAWN_AGENT
+                    INTERRUPT_AGENT -> Value.INTERRUPT_AGENT
+                    LIST_AGENTS -> Value.LIST_AGENTS
+                    SEND_MESSAGE -> Value.SEND_MESSAGE
+                    FOLLOWUP_TASK -> Value.FOLLOWUP_TASK
+                    WAIT_AGENT -> Value.WAIT_AGENT
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    SPAWN_AGENT -> Known.SPAWN_AGENT
+                    INTERRUPT_AGENT -> Known.INTERRUPT_AGENT
+                    LIST_AGENTS -> Known.LIST_AGENTS
+                    SEND_MESSAGE -> Known.SEND_MESSAGE
+                    FOLLOWUP_TASK -> Known.FOLLOWUP_TASK
+                    WAIT_AGENT -> Known.WAIT_AGENT
+                    else -> throw OpenAIInvalidDataException("Unknown Action: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Action = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Action && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is MultiAgentCall &&
+                id == other.id &&
+                action == other.action &&
+                arguments == other.arguments &&
+                callId == other.callId &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, action, arguments, callId, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "MultiAgentCall{id=$id, action=$action, arguments=$arguments, callId=$callId, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    class MultiAgentCallOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val action: JsonField<Action>,
+        private val callId: JsonField<String>,
+        private val output: JsonField<List<BetaResponseOutputText>>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("output")
+            @ExcludeMissing
+            output: JsonField<List<BetaResponseOutputText>> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, action, callId, output, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the multi-agent call output item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The multi-agent action that produced this result.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun action(): Action = action.getRequired("action")
+
+        /**
+         * The unique ID of the multi-agent call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * Text output returned by the multi-agent action.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun output(): List<BetaResponseOutputText> = output.getRequired("output")
+
+        /**
+         * The type of the multi-agent result. Always `multi_agent_call_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("multi_agent_call_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [action].
+         *
+         * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output")
+        @ExcludeMissing
+        fun _output(): JsonField<List<BetaResponseOutputText>> = output
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [MultiAgentCallOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .action()
+             * .callId()
+             * .output()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [MultiAgentCallOutput]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var action: JsonField<Action>? = null
+            private var callId: JsonField<String>? = null
+            private var output: JsonField<MutableList<BetaResponseOutputText>>? = null
+            private var type: JsonValue = JsonValue.from("multi_agent_call_output")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(multiAgentCallOutput: MultiAgentCallOutput) = apply {
+                id = multiAgentCallOutput.id
+                action = multiAgentCallOutput.action
+                callId = multiAgentCallOutput.callId
+                output = multiAgentCallOutput.output.map { it.toMutableList() }
+                type = multiAgentCallOutput.type
+                agent = multiAgentCallOutput.agent
+                additionalProperties = multiAgentCallOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the multi-agent call output item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The multi-agent action that produced this result. */
+            fun action(action: Action) = action(JsonField.of(action))
+
+            /**
+             * Sets [Builder.action] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.action] with a well-typed [Action] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun action(action: JsonField<Action>) = apply { this.action = action }
+
+            /** The unique ID of the multi-agent call. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** Text output returned by the multi-agent action. */
+            fun output(output: List<BetaResponseOutputText>) = output(JsonField.of(output))
+
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed
+             * `List<BetaResponseOutputText>` value instead. This method is primarily for setting
+             * the field to an undocumented or not yet supported value.
+             */
+            fun output(output: JsonField<List<BetaResponseOutputText>>) = apply {
+                this.output = output.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [BetaResponseOutputText] to [Builder.output].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addOutput(output: BetaResponseOutputText) = apply {
+                this.output =
+                    (this.output ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("output", it).add(output)
+                    }
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("multi_agent_call_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [MultiAgentCallOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .action()
+             * .callId()
+             * .output()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): MultiAgentCallOutput =
+                MultiAgentCallOutput(
+                    checkRequired("id", id),
+                    checkRequired("action", action),
+                    checkRequired("callId", callId),
+                    checkRequired("output", output).map { it.toImmutable() },
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): MultiAgentCallOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            action().validate()
+            callId()
+            output().forEach { it.validate() }
+            _type().let {
+                if (it != JsonValue.from("multi_agent_call_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (action.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (output.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                type.let { if (it == JsonValue.from("multi_agent_call_output")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The multi-agent action that produced this result. */
+        class Action @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val SPAWN_AGENT = of("spawn_agent")
+
+                @JvmField val INTERRUPT_AGENT = of("interrupt_agent")
+
+                @JvmField val LIST_AGENTS = of("list_agents")
+
+                @JvmField val SEND_MESSAGE = of("send_message")
+
+                @JvmField val FOLLOWUP_TASK = of("followup_task")
+
+                @JvmField val WAIT_AGENT = of("wait_agent")
+
+                @JvmStatic fun of(value: String) = Action(JsonField.of(value))
+            }
+
+            /** An enum containing [Action]'s known values. */
+            enum class Known {
+                SPAWN_AGENT,
+                INTERRUPT_AGENT,
+                LIST_AGENTS,
+                SEND_MESSAGE,
+                FOLLOWUP_TASK,
+                WAIT_AGENT,
+            }
+
+            /**
+             * An enum containing [Action]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Action] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                SPAWN_AGENT,
+                INTERRUPT_AGENT,
+                LIST_AGENTS,
+                SEND_MESSAGE,
+                FOLLOWUP_TASK,
+                WAIT_AGENT,
+                /**
+                 * An enum member indicating that [Action] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    SPAWN_AGENT -> Value.SPAWN_AGENT
+                    INTERRUPT_AGENT -> Value.INTERRUPT_AGENT
+                    LIST_AGENTS -> Value.LIST_AGENTS
+                    SEND_MESSAGE -> Value.SEND_MESSAGE
+                    FOLLOWUP_TASK -> Value.FOLLOWUP_TASK
+                    WAIT_AGENT -> Value.WAIT_AGENT
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    SPAWN_AGENT -> Known.SPAWN_AGENT
+                    INTERRUPT_AGENT -> Known.INTERRUPT_AGENT
+                    LIST_AGENTS -> Known.LIST_AGENTS
+                    SEND_MESSAGE -> Known.SEND_MESSAGE
+                    FOLLOWUP_TASK -> Known.FOLLOWUP_TASK
+                    WAIT_AGENT -> Known.WAIT_AGENT
+                    else -> throw OpenAIInvalidDataException("Unknown Action: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Action = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Action && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is MultiAgentCallOutput &&
+                id == other.id &&
+                action == other.action &&
+                callId == other.callId &&
+                output == other.output &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, action, callId, output, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "MultiAgentCallOutput{id=$id, action=$action, callId=$callId, output=$output, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    class AdditionalTools
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val role: JsonField<Role>,
+        private val tools: JsonField<List<BetaTool>>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("role") @ExcludeMissing role: JsonField<Role> = JsonMissing.of(),
+            @JsonProperty("tools")
+            @ExcludeMissing
+            tools: JsonField<List<BetaTool>> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, role, tools, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the additional tools item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The role that provided the additional tools.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun role(): Role = role.getRequired("role")
+
+        /**
+         * The additional tool definitions made available at this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun tools(): List<BetaTool> = tools.getRequired("tools")
+
+        /**
+         * The type of the item. Always `additional_tools`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("additional_tools")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [role].
+         *
+         * Unlike [role], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("role") @ExcludeMissing fun _role(): JsonField<Role> = role
+
+        /**
+         * Returns the raw JSON value of [tools].
+         *
+         * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<BetaTool>> = tools
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [AdditionalTools].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .role()
+             * .tools()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [AdditionalTools]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var role: JsonField<Role>? = null
+            private var tools: JsonField<MutableList<BetaTool>>? = null
+            private var type: JsonValue = JsonValue.from("additional_tools")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(additionalTools: AdditionalTools) = apply {
+                id = additionalTools.id
+                role = additionalTools.role
+                tools = additionalTools.tools.map { it.toMutableList() }
+                type = additionalTools.type
+                agent = additionalTools.agent
+                additionalProperties = additionalTools.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the additional tools item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The role that provided the additional tools. */
+            fun role(role: Role) = role(JsonField.of(role))
+
+            /**
+             * Sets [Builder.role] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.role] with a well-typed [Role] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun role(role: JsonField<Role>) = apply { this.role = role }
+
+            /** The additional tool definitions made available at this item. */
+            fun tools(tools: List<BetaTool>) = tools(JsonField.of(tools))
+
+            /**
+             * Sets [Builder.tools] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.tools] with a well-typed `List<BetaTool>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun tools(tools: JsonField<List<BetaTool>>) = apply {
+                this.tools = tools.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [BetaTool] to [tools].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addTool(tool: BetaTool) = apply {
+                tools =
+                    (tools ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("tools", it).add(tool)
+                    }
+            }
+
+            /** Alias for calling [addTool] with `BetaTool.ofFunction(function)`. */
+            fun addTool(function: BetaFunctionTool) = addTool(BetaTool.ofFunction(function))
+
+            /** Alias for calling [addTool] with `BetaTool.ofFileSearch(fileSearch)`. */
+            fun addTool(fileSearch: BetaFileSearchTool) = addTool(BetaTool.ofFileSearch(fileSearch))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaFileSearchTool.builder()
+             *     .vectorStoreIds(vectorStoreIds)
+             *     .build()
+             * ```
+             */
+            fun addFileSearchTool(vectorStoreIds: List<String>) =
+                addTool(BetaFileSearchTool.builder().vectorStoreIds(vectorStoreIds).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofComputer(computer)`. */
+            fun addTool(computer: BetaComputerTool) = addTool(BetaTool.ofComputer(computer))
+
+            /**
+             * Alias for calling [addTool] with `BetaTool.ofComputerUsePreview(computerUsePreview)`.
+             */
+            fun addTool(computerUsePreview: BetaComputerUsePreviewTool) =
+                addTool(BetaTool.ofComputerUsePreview(computerUsePreview))
+
+            /** Alias for calling [addTool] with `BetaTool.ofWebSearch(webSearch)`. */
+            fun addTool(webSearch: BetaWebSearchTool) = addTool(BetaTool.ofWebSearch(webSearch))
+
+            /** Alias for calling [addTool] with `BetaTool.ofMcp(mcp)`. */
+            fun addTool(mcp: BetaTool.Mcp) = addTool(BetaTool.ofMcp(mcp))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaTool.Mcp.builder()
+             *     .serverLabel(serverLabel)
+             *     .build()
+             * ```
+             */
+            fun addMcpTool(serverLabel: String) =
+                addTool(BetaTool.Mcp.builder().serverLabel(serverLabel).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofCodeInterpreter(codeInterpreter)`. */
+            fun addTool(codeInterpreter: BetaTool.CodeInterpreter) =
+                addTool(BetaTool.ofCodeInterpreter(codeInterpreter))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaTool.CodeInterpreter.builder()
+             *     .container(container)
+             *     .build()
+             * ```
+             */
+            fun addCodeInterpreterTool(container: BetaTool.CodeInterpreter.Container) =
+                addTool(BetaTool.CodeInterpreter.builder().container(container).build())
+
+            /**
+             * Alias for calling [addCodeInterpreterTool] with
+             * `BetaTool.CodeInterpreter.Container.ofString(string)`.
+             */
+            fun addCodeInterpreterTool(string: String) =
+                addCodeInterpreterTool(BetaTool.CodeInterpreter.Container.ofString(string))
+
+            /**
+             * Alias for calling [addCodeInterpreterTool] with
+             * `BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)`.
+             */
+            fun addCodeInterpreterTool(
+                codeInterpreterToolAuto: BetaTool.CodeInterpreter.Container.CodeInterpreterToolAuto
+            ) =
+                addCodeInterpreterTool(
+                    BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(
+                        codeInterpreterToolAuto
+                    )
+                )
+
+            /** Alias for calling [addTool] with `BetaTool.ofProgrammaticToolCalling()`. */
+            fun addToolProgrammaticToolCalling() = addTool(BetaTool.ofProgrammaticToolCalling())
+
+            /** Alias for calling [addTool] with `BetaTool.ofImageGeneration(imageGeneration)`. */
+            fun addTool(imageGeneration: BetaTool.ImageGeneration) =
+                addTool(BetaTool.ofImageGeneration(imageGeneration))
+
+            /** Alias for calling [addTool] with `BetaTool.ofLocalShell()`. */
+            fun addToolLocalShell() = addTool(BetaTool.ofLocalShell())
+
+            /** Alias for calling [addTool] with `BetaTool.ofShell(shell)`. */
+            fun addTool(shell: BetaFunctionShellTool) = addTool(BetaTool.ofShell(shell))
+
+            /** Alias for calling [addTool] with `BetaTool.ofCustom(custom)`. */
+            fun addTool(custom: BetaCustomTool) = addTool(BetaTool.ofCustom(custom))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaCustomTool.builder()
+             *     .name(name)
+             *     .build()
+             * ```
+             */
+            fun addCustomTool(name: String) = addTool(BetaCustomTool.builder().name(name).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofNamespace(namespace)`. */
+            fun addTool(namespace: BetaNamespaceTool) = addTool(BetaTool.ofNamespace(namespace))
+
+            /** Alias for calling [addTool] with `BetaTool.ofToolSearch(toolSearch)`. */
+            fun addTool(toolSearch: BetaToolSearchTool) = addTool(BetaTool.ofToolSearch(toolSearch))
+
+            /** Alias for calling [addTool] with `BetaTool.ofWebSearchPreview(webSearchPreview)`. */
+            fun addTool(webSearchPreview: BetaWebSearchPreviewTool) =
+                addTool(BetaTool.ofWebSearchPreview(webSearchPreview))
+
+            /** Alias for calling [addTool] with `BetaTool.ofApplyPatch(applyPatch)`. */
+            fun addTool(applyPatch: BetaApplyPatchTool) = addTool(BetaTool.ofApplyPatch(applyPatch))
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("additional_tools")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [AdditionalTools].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .role()
+             * .tools()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): AdditionalTools =
+                AdditionalTools(
+                    checkRequired("id", id),
+                    checkRequired("role", role),
+                    checkRequired("tools", tools).map { it.toImmutable() },
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): AdditionalTools = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            role().validate()
+            tools().forEach { it.validate() }
+            _type().let {
+                if (it != JsonValue.from("additional_tools")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (role.asKnown().getOrNull()?.validity() ?: 0) +
+                (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                type.let { if (it == JsonValue.from("additional_tools")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The role that provided the additional tools. */
+        class Role @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val UNKNOWN = of("unknown")
+
+                @JvmField val USER = of("user")
+
+                @JvmField val ASSISTANT = of("assistant")
+
+                @JvmField val SYSTEM = of("system")
+
+                @JvmField val CRITIC = of("critic")
+
+                @JvmField val DISCRIMINATOR = of("discriminator")
+
+                @JvmField val DEVELOPER = of("developer")
+
+                @JvmField val TOOL = of("tool")
+
+                @JvmStatic fun of(value: String) = Role(JsonField.of(value))
+            }
+
+            /** An enum containing [Role]'s known values. */
+            enum class Known {
+                UNKNOWN,
+                USER,
+                ASSISTANT,
+                SYSTEM,
+                CRITIC,
+                DISCRIMINATOR,
+                DEVELOPER,
+                TOOL,
+            }
+
+            /**
+             * An enum containing [Role]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Role] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                UNKNOWN,
+                USER,
+                ASSISTANT,
+                SYSTEM,
+                CRITIC,
+                DISCRIMINATOR,
+                DEVELOPER,
+                TOOL,
+                /** An enum member indicating that [Role] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    UNKNOWN -> Value.UNKNOWN
+                    USER -> Value.USER
+                    ASSISTANT -> Value.ASSISTANT
+                    SYSTEM -> Value.SYSTEM
+                    CRITIC -> Value.CRITIC
+                    DISCRIMINATOR -> Value.DISCRIMINATOR
+                    DEVELOPER -> Value.DEVELOPER
+                    TOOL -> Value.TOOL
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    UNKNOWN -> Known.UNKNOWN
+                    USER -> Known.USER
+                    ASSISTANT -> Known.ASSISTANT
+                    SYSTEM -> Known.SYSTEM
+                    CRITIC -> Known.CRITIC
+                    DISCRIMINATOR -> Known.DISCRIMINATOR
+                    DEVELOPER -> Known.DEVELOPER
+                    TOOL -> Known.TOOL
+                    else -> throw OpenAIInvalidDataException("Unknown Role: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Role = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Role && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AdditionalTools &&
+                id == other.id &&
+                role == other.role &&
+                tools == other.tools &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, role, tools, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "AdditionalTools{id=$id, role=$role, tools=$tools, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    class Program
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val callId: JsonField<String>,
+        private val code: JsonField<String>,
+        private val fingerprint: JsonField<String>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("code") @ExcludeMissing code: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("fingerprint")
+            @ExcludeMissing
+            fingerprint: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, callId, code, fingerprint, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The stable call ID of the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The JavaScript source executed by programmatic tool calling.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun code(): String = code.getRequired("code")
+
+        /**
+         * Opaque program replay fingerprint that must be round-tripped.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun fingerprint(): String = fingerprint.getRequired("fingerprint")
+
+        /**
+         * The type of the item. Always `program`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("program")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [code].
+         *
+         * Unlike [code], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<String> = code
+
+        /**
+         * Returns the raw JSON value of [fingerprint].
+         *
+         * Unlike [fingerprint], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("fingerprint")
+        @ExcludeMissing
+        fun _fingerprint(): JsonField<String> = fingerprint
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Program].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .code()
+             * .fingerprint()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Program]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var callId: JsonField<String>? = null
+            private var code: JsonField<String>? = null
+            private var fingerprint: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("program")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(program: Program) = apply {
+                id = program.id
+                callId = program.callId
+                code = program.code
+                fingerprint = program.fingerprint
+                type = program.type
+                agent = program.agent
+                additionalProperties = program.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the program item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The stable call ID of the program item. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The JavaScript source executed by programmatic tool calling. */
+            fun code(code: String) = code(JsonField.of(code))
+
+            /**
+             * Sets [Builder.code] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.code] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun code(code: JsonField<String>) = apply { this.code = code }
+
+            /** Opaque program replay fingerprint that must be round-tripped. */
+            fun fingerprint(fingerprint: String) = fingerprint(JsonField.of(fingerprint))
+
+            /**
+             * Sets [Builder.fingerprint] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.fingerprint] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun fingerprint(fingerprint: JsonField<String>) = apply {
+                this.fingerprint = fingerprint
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Program].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .code()
+             * .fingerprint()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Program =
+                Program(
+                    checkRequired("id", id),
+                    checkRequired("callId", callId),
+                    checkRequired("code", code),
+                    checkRequired("fingerprint", fingerprint),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Program = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            callId()
+            code()
+            fingerprint()
+            _type().let {
+                if (it != JsonValue.from("program")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (if (code.asKnown().isPresent) 1 else 0) +
+                (if (fingerprint.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("program")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Program &&
+                id == other.id &&
+                callId == other.callId &&
+                code == other.code &&
+                fingerprint == other.fingerprint &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, callId, code, fingerprint, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Program{id=$id, callId=$callId, code=$code, fingerprint=$fingerprint, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    class ProgramOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val callId: JsonField<String>,
+        private val result: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("result") @ExcludeMissing result: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, callId, result, status, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the program output item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The call ID of the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The result produced by the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun result(): String = result.getRequired("result")
+
+        /**
+         * The terminal status of the program output item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The type of the item. Always `program_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("program_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [result].
+         *
+         * Unlike [result], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("result") @ExcludeMissing fun _result(): JsonField<String> = result
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ProgramOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .result()
+             * .status()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ProgramOutput]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var callId: JsonField<String>? = null
+            private var result: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("program_output")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(programOutput: ProgramOutput) = apply {
+                id = programOutput.id
+                callId = programOutput.callId
+                result = programOutput.result
+                status = programOutput.status
+                type = programOutput.type
+                agent = programOutput.agent
+                additionalProperties = programOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the program output item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The call ID of the program item. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The result produced by the program item. */
+            fun result(result: String) = result(JsonField.of(result))
+
+            /**
+             * Sets [Builder.result] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.result] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun result(result: JsonField<String>) = apply { this.result = result }
+
+            /** The terminal status of the program output item. */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("program_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ProgramOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .result()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ProgramOutput =
+                ProgramOutput(
+                    checkRequired("id", id),
+                    checkRequired("callId", callId),
+                    checkRequired("result", result),
+                    checkRequired("status", status),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ProgramOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            callId()
+            result()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("program_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (if (result.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("program_output")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The terminal status of the program output item. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ProgramOutput &&
+                id == other.id &&
+                callId == other.callId &&
+                result == other.result &&
+                status == other.status &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, callId, result, status, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ProgramOutput{id=$id, callId=$callId, result=$result, status=$status, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    /** An image generation request made by the model. */
+    class ImageGenerationCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val result: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("result") @ExcludeMissing result: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, result, status, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the image generation call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The generated image encoded in base64.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun result(): Optional<String> = result.getOptional("result")
+
+        /**
+         * The status of the image generation call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The type of the image generation call. Always `image_generation_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("image_generation_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [result].
+         *
+         * Unlike [result], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("result") @ExcludeMissing fun _result(): JsonField<String> = result
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ImageGenerationCall].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .result()
+             * .status()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ImageGenerationCall]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var result: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("image_generation_call")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(imageGenerationCall: ImageGenerationCall) = apply {
+                id = imageGenerationCall.id
+                result = imageGenerationCall.result
+                status = imageGenerationCall.status
+                type = imageGenerationCall.type
+                agent = imageGenerationCall.agent
+                additionalProperties = imageGenerationCall.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the image generation call. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The generated image encoded in base64. */
+            fun result(result: String?) = result(JsonField.ofNullable(result))
+
+            /** Alias for calling [Builder.result] with `result.orElse(null)`. */
+            fun result(result: Optional<String>) = result(result.getOrNull())
+
+            /**
+             * Sets [Builder.result] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.result] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun result(result: JsonField<String>) = apply { this.result = result }
+
+            /** The status of the image generation call. */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("image_generation_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ImageGenerationCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .result()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ImageGenerationCall =
+                ImageGenerationCall(
+                    checkRequired("id", id),
+                    checkRequired("result", result),
+                    checkRequired("status", status),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ImageGenerationCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            result()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("image_generation_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (result.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("image_generation_call")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The status of the image generation call. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val GENERATING = of("generating")
+
+                @JvmField val FAILED = of("failed")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                GENERATING,
+                FAILED,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                GENERATING,
+                FAILED,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    GENERATING -> Value.GENERATING
+                    FAILED -> Value.FAILED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    GENERATING -> Known.GENERATING
+                    FAILED -> Known.FAILED
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ImageGenerationCall &&
+                id == other.id &&
+                result == other.result &&
+                status == other.status &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, result, status, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ImageGenerationCall{id=$id, result=$result, status=$status, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    /** A tool call to run a command on the local shell. */
+    class LocalShellCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val action: JsonField<Action>,
+        private val callId: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, action, callId, status, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the local shell call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * Execute a shell command on the server.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun action(): Action = action.getRequired("action")
+
+        /**
+         * The unique ID of the local shell tool call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The status of the local shell call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The type of the local shell call. Always `local_shell_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("local_shell_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [action].
+         *
+         * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [LocalShellCall].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .action()
+             * .callId()
+             * .status()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [LocalShellCall]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var action: JsonField<Action>? = null
+            private var callId: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("local_shell_call")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(localShellCall: LocalShellCall) = apply {
+                id = localShellCall.id
+                action = localShellCall.action
+                callId = localShellCall.callId
+                status = localShellCall.status
+                type = localShellCall.type
+                agent = localShellCall.agent
+                additionalProperties = localShellCall.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the local shell call. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** Execute a shell command on the server. */
+            fun action(action: Action) = action(JsonField.of(action))
+
+            /**
+             * Sets [Builder.action] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.action] with a well-typed [Action] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun action(action: JsonField<Action>) = apply { this.action = action }
+
+            /** The unique ID of the local shell tool call generated by the model. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The status of the local shell call. */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("local_shell_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [LocalShellCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .action()
+             * .callId()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): LocalShellCall =
+                LocalShellCall(
+                    checkRequired("id", id),
+                    checkRequired("action", action),
+                    checkRequired("callId", callId),
+                    checkRequired("status", status),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): LocalShellCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            action().validate()
+            callId()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("local_shell_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (action.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("local_shell_call")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** Execute a shell command on the server. */
+        class Action
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val command: JsonField<List<String>>,
+            private val env: JsonField<Env>,
+            private val type: JsonValue,
+            private val timeoutMs: JsonField<Long>,
+            private val user: JsonField<String>,
+            private val workingDirectory: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("command")
+                @ExcludeMissing
+                command: JsonField<List<String>> = JsonMissing.of(),
+                @JsonProperty("env") @ExcludeMissing env: JsonField<Env> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                @JsonProperty("timeout_ms")
+                @ExcludeMissing
+                timeoutMs: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("user") @ExcludeMissing user: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("working_directory")
+                @ExcludeMissing
+                workingDirectory: JsonField<String> = JsonMissing.of(),
+            ) : this(command, env, type, timeoutMs, user, workingDirectory, mutableMapOf())
+
+            /**
+             * The command to run.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun command(): List<String> = command.getRequired("command")
+
+            /**
+             * Environment variables to set for the command.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun env(): Env = env.getRequired("env")
+
+            /**
+             * The type of the local shell action. Always `exec`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("exec")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Optional timeout in milliseconds for the command.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun timeoutMs(): Optional<Long> = timeoutMs.getOptional("timeout_ms")
+
+            /**
+             * Optional user to run the command as.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun user(): Optional<String> = user.getOptional("user")
+
+            /**
+             * Optional working directory to run the command in.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun workingDirectory(): Optional<String> =
+                workingDirectory.getOptional("working_directory")
+
+            /**
+             * Returns the raw JSON value of [command].
+             *
+             * Unlike [command], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("command")
+            @ExcludeMissing
+            fun _command(): JsonField<List<String>> = command
+
+            /**
+             * Returns the raw JSON value of [env].
+             *
+             * Unlike [env], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("env") @ExcludeMissing fun _env(): JsonField<Env> = env
+
+            /**
+             * Returns the raw JSON value of [timeoutMs].
+             *
+             * Unlike [timeoutMs], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("timeout_ms")
+            @ExcludeMissing
+            fun _timeoutMs(): JsonField<Long> = timeoutMs
+
+            /**
+             * Returns the raw JSON value of [user].
+             *
+             * Unlike [user], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("user") @ExcludeMissing fun _user(): JsonField<String> = user
+
+            /**
+             * Returns the raw JSON value of [workingDirectory].
+             *
+             * Unlike [workingDirectory], this method doesn't throw if the JSON field has an
+             * unexpected type.
+             */
+            @JsonProperty("working_directory")
+            @ExcludeMissing
+            fun _workingDirectory(): JsonField<String> = workingDirectory
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Action].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .command()
+                 * .env()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Action]. */
+            class Builder internal constructor() {
+
+                private var command: JsonField<MutableList<String>>? = null
+                private var env: JsonField<Env>? = null
+                private var type: JsonValue = JsonValue.from("exec")
+                private var timeoutMs: JsonField<Long> = JsonMissing.of()
+                private var user: JsonField<String> = JsonMissing.of()
+                private var workingDirectory: JsonField<String> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(action: Action) = apply {
+                    command = action.command.map { it.toMutableList() }
+                    env = action.env
+                    type = action.type
+                    timeoutMs = action.timeoutMs
+                    user = action.user
+                    workingDirectory = action.workingDirectory
+                    additionalProperties = action.additionalProperties.toMutableMap()
+                }
+
+                /** The command to run. */
+                fun command(command: List<String>) = command(JsonField.of(command))
+
+                /**
+                 * Sets [Builder.command] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.command] with a well-typed `List<String>` value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun command(command: JsonField<List<String>>) = apply {
+                    this.command = command.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [String] to [Builder.command].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addCommand(command: String) = apply {
+                    this.command =
+                        (this.command ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("command", it).add(command)
+                        }
+                }
+
+                /** Environment variables to set for the command. */
+                fun env(env: Env) = env(JsonField.of(env))
+
+                /**
+                 * Sets [Builder.env] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.env] with a well-typed [Env] value instead. This
+                 * method is primarily for setting the field to an undocumented or not yet supported
+                 * value.
+                 */
+                fun env(env: JsonField<Env>) = apply { this.env = env }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("exec")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                /** Optional timeout in milliseconds for the command. */
+                fun timeoutMs(timeoutMs: Long?) = timeoutMs(JsonField.ofNullable(timeoutMs))
+
+                /**
+                 * Alias for [Builder.timeoutMs].
+                 *
+                 * This unboxed primitive overload exists for backwards compatibility.
+                 */
+                fun timeoutMs(timeoutMs: Long) = timeoutMs(timeoutMs as Long?)
+
+                /** Alias for calling [Builder.timeoutMs] with `timeoutMs.orElse(null)`. */
+                fun timeoutMs(timeoutMs: Optional<Long>) = timeoutMs(timeoutMs.getOrNull())
+
+                /**
+                 * Sets [Builder.timeoutMs] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.timeoutMs] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun timeoutMs(timeoutMs: JsonField<Long>) = apply { this.timeoutMs = timeoutMs }
+
+                /** Optional user to run the command as. */
+                fun user(user: String?) = user(JsonField.ofNullable(user))
+
+                /** Alias for calling [Builder.user] with `user.orElse(null)`. */
+                fun user(user: Optional<String>) = user(user.getOrNull())
+
+                /**
+                 * Sets [Builder.user] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.user] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun user(user: JsonField<String>) = apply { this.user = user }
+
+                /** Optional working directory to run the command in. */
+                fun workingDirectory(workingDirectory: String?) =
+                    workingDirectory(JsonField.ofNullable(workingDirectory))
+
+                /**
+                 * Alias for calling [Builder.workingDirectory] with
+                 * `workingDirectory.orElse(null)`.
+                 */
+                fun workingDirectory(workingDirectory: Optional<String>) =
+                    workingDirectory(workingDirectory.getOrNull())
+
+                /**
+                 * Sets [Builder.workingDirectory] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.workingDirectory] with a well-typed [String]
+                 * value instead. This method is primarily for setting the field to an undocumented
+                 * or not yet supported value.
+                 */
+                fun workingDirectory(workingDirectory: JsonField<String>) = apply {
+                    this.workingDirectory = workingDirectory
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Action].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .command()
+                 * .env()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Action =
+                    Action(
+                        checkRequired("command", command).map { it.toImmutable() },
+                        checkRequired("env", env),
+                        type,
+                        timeoutMs,
+                        user,
+                        workingDirectory,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Action = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                command()
+                env().validate()
+                _type().let {
+                    if (it != JsonValue.from("exec")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                timeoutMs()
+                user()
+                workingDirectory()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (command.asKnown().getOrNull()?.size ?: 0) +
+                    (env.asKnown().getOrNull()?.validity() ?: 0) +
+                    type.let { if (it == JsonValue.from("exec")) 1 else 0 } +
+                    (if (timeoutMs.asKnown().isPresent) 1 else 0) +
+                    (if (user.asKnown().isPresent) 1 else 0) +
+                    (if (workingDirectory.asKnown().isPresent) 1 else 0)
+
+            /** Environment variables to set for the command. */
+            class Env
+            @JsonCreator
+            private constructor(
+                @com.fasterxml.jackson.annotation.JsonValue
+                private val additionalProperties: Map<String, JsonValue>
+            ) {
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /** Returns a mutable builder for constructing an instance of [Env]. */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Env]. */
+                class Builder internal constructor() {
+
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(env: Env) = apply {
+                        additionalProperties = env.additionalProperties.toMutableMap()
+                    }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Env].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     */
+                    fun build(): Env = Env(additionalProperties.toImmutable())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Env = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    additionalProperties.count { (_, value) ->
+                        !value.isNull() && !value.isMissing()
+                    }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Env && additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() = "Env{additionalProperties=$additionalProperties}"
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Action &&
+                    command == other.command &&
+                    env == other.env &&
+                    type == other.type &&
+                    timeoutMs == other.timeoutMs &&
+                    user == other.user &&
+                    workingDirectory == other.workingDirectory &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(
+                    command,
+                    env,
+                    type,
+                    timeoutMs,
+                    user,
+                    workingDirectory,
+                    additionalProperties,
+                )
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Action{command=$command, env=$env, type=$type, timeoutMs=$timeoutMs, user=$user, workingDirectory=$workingDirectory, additionalProperties=$additionalProperties}"
+        }
+
+        /** The status of the local shell call. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is LocalShellCall &&
+                id == other.id &&
+                action == other.action &&
+                callId == other.callId &&
+                status == other.status &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, action, callId, status, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "LocalShellCall{id=$id, action=$action, callId=$callId, status=$status, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    /** The output of a local shell tool call. */
+    class LocalShellCallOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val output: JsonField<String>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val status: JsonField<Status>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("output") @ExcludeMissing output: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        ) : this(id, output, type, agent, status, mutableMapOf())
+
+        /**
+         * The unique ID of the local shell tool call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * A JSON string of the output of the local shell tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun output(): String = output.getRequired("output")
+
+        /**
+         * The type of the local shell tool call output. Always `local_shell_call_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("local_shell_call_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun status(): Optional<Status> = status.getOptional("status")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<String> = output
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [LocalShellCallOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .output()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [LocalShellCallOutput]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var output: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("local_shell_call_output")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var status: JsonField<Status> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(localShellCallOutput: LocalShellCallOutput) = apply {
+                id = localShellCallOutput.id
+                output = localShellCallOutput.output
+                type = localShellCallOutput.type
+                agent = localShellCallOutput.agent
+                status = localShellCallOutput.status
+                additionalProperties = localShellCallOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the local shell tool call generated by the model. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** A JSON string of the output of the local shell tool call. */
+            fun output(output: String) = output(JsonField.of(output))
+
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun output(output: JsonField<String>) = apply { this.output = output }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("local_shell_call_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /** The status of the item. One of `in_progress`, `completed`, or `incomplete`. */
+            fun status(status: Status?) = status(JsonField.ofNullable(status))
+
+            /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+            fun status(status: Optional<Status>) = status(status.getOrNull())
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [LocalShellCallOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .output()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): LocalShellCallOutput =
+                LocalShellCallOutput(
+                    checkRequired("id", id),
+                    checkRequired("output", output),
+                    type,
+                    agent,
+                    status,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): LocalShellCallOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            output()
+            _type().let {
+                if (it != JsonValue.from("local_shell_call_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            status().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (output.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("local_shell_call_output")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        /** The status of the item. One of `in_progress`, `completed`, or `incomplete`. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is LocalShellCallOutput &&
+                id == other.id &&
+                output == other.output &&
+                type == other.type &&
+                agent == other.agent &&
+                status == other.status &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, output, type, agent, status, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "LocalShellCallOutput{id=$id, output=$output, type=$type, agent=$agent, status=$status, additionalProperties=$additionalProperties}"
+    }
+
+    /** A list of tools available on an MCP server. */
+    class McpListTools
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val serverLabel: JsonField<String>,
+        private val tools: JsonField<List<Tool>>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val error: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("server_label")
+            @ExcludeMissing
+            serverLabel: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("tools") @ExcludeMissing tools: JsonField<List<Tool>> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("error") @ExcludeMissing error: JsonField<String> = JsonMissing.of(),
+        ) : this(id, serverLabel, tools, type, agent, error, mutableMapOf())
+
+        /**
+         * The unique ID of the list.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The label of the MCP server.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun serverLabel(): String = serverLabel.getRequired("server_label")
+
+        /**
+         * The tools available on the server.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun tools(): List<Tool> = tools.getRequired("tools")
+
+        /**
+         * The type of the item. Always `mcp_list_tools`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("mcp_list_tools")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Error message if the server could not list tools.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun error(): Optional<String> = error.getOptional("error")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [serverLabel].
+         *
+         * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("server_label")
+        @ExcludeMissing
+        fun _serverLabel(): JsonField<String> = serverLabel
+
+        /**
+         * Returns the raw JSON value of [tools].
+         *
+         * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<Tool>> = tools
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [error].
+         *
+         * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<String> = error
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [McpListTools].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .serverLabel()
+             * .tools()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [McpListTools]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var serverLabel: JsonField<String>? = null
+            private var tools: JsonField<MutableList<Tool>>? = null
+            private var type: JsonValue = JsonValue.from("mcp_list_tools")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var error: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(mcpListTools: McpListTools) = apply {
+                id = mcpListTools.id
+                serverLabel = mcpListTools.serverLabel
+                tools = mcpListTools.tools.map { it.toMutableList() }
+                type = mcpListTools.type
+                agent = mcpListTools.agent
+                error = mcpListTools.error
+                additionalProperties = mcpListTools.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the list. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The label of the MCP server. */
+            fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
+
+            /**
+             * Sets [Builder.serverLabel] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serverLabel] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun serverLabel(serverLabel: JsonField<String>) = apply {
+                this.serverLabel = serverLabel
+            }
+
+            /** The tools available on the server. */
+            fun tools(tools: List<Tool>) = tools(JsonField.of(tools))
+
+            /**
+             * Sets [Builder.tools] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.tools] with a well-typed `List<Tool>` value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun tools(tools: JsonField<List<Tool>>) = apply {
+                this.tools = tools.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [Tool] to [tools].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addTool(tool: Tool) = apply {
+                tools =
+                    (tools ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("tools", it).add(tool)
+                    }
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("mcp_list_tools")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /** Error message if the server could not list tools. */
+            fun error(error: String?) = error(JsonField.ofNullable(error))
+
+            /** Alias for calling [Builder.error] with `error.orElse(null)`. */
+            fun error(error: Optional<String>) = error(error.getOrNull())
+
+            /**
+             * Sets [Builder.error] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.error] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun error(error: JsonField<String>) = apply { this.error = error }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [McpListTools].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .serverLabel()
+             * .tools()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): McpListTools =
+                McpListTools(
+                    checkRequired("id", id),
+                    checkRequired("serverLabel", serverLabel),
+                    checkRequired("tools", tools).map { it.toImmutable() },
+                    type,
+                    agent,
+                    error,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): McpListTools = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            serverLabel()
+            tools().forEach { it.validate() }
+            _type().let {
+                if (it != JsonValue.from("mcp_list_tools")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            error()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (serverLabel.asKnown().isPresent) 1 else 0) +
+                (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                type.let { if (it == JsonValue.from("mcp_list_tools")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (error.asKnown().isPresent) 1 else 0)
+
+        /** A tool available on an MCP server. */
+        class Tool
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val inputSchema: JsonValue,
+            private val name: JsonField<String>,
+            private val annotations: JsonValue,
+            private val description: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("input_schema")
+                @ExcludeMissing
+                inputSchema: JsonValue = JsonMissing.of(),
+                @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("annotations")
+                @ExcludeMissing
+                annotations: JsonValue = JsonMissing.of(),
+                @JsonProperty("description")
+                @ExcludeMissing
+                description: JsonField<String> = JsonMissing.of(),
+            ) : this(inputSchema, name, annotations, description, mutableMapOf())
+
+            /**
+             * The JSON schema describing the tool's input.
+             *
+             * This arbitrary value can be deserialized into a custom type using the `convert`
+             * method:
+             * ```java
+             * MyClass myObject = tool.inputSchema().convert(MyClass.class);
+             * ```
+             */
+            @JsonProperty("input_schema")
+            @ExcludeMissing
+            fun _inputSchema(): JsonValue = inputSchema
+
+            /**
+             * The name of the tool.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun name(): String = name.getRequired("name")
+
+            /**
+             * Additional annotations about the tool.
+             *
+             * This arbitrary value can be deserialized into a custom type using the `convert`
+             * method:
+             * ```java
+             * MyClass myObject = tool.annotations().convert(MyClass.class);
+             * ```
+             */
+            @JsonProperty("annotations") @ExcludeMissing fun _annotations(): JsonValue = annotations
+
+            /**
+             * The description of the tool.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun description(): Optional<String> = description.getOptional("description")
+
+            /**
+             * Returns the raw JSON value of [name].
+             *
+             * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+            /**
+             * Returns the raw JSON value of [description].
+             *
+             * Unlike [description], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("description")
+            @ExcludeMissing
+            fun _description(): JsonField<String> = description
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Tool].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .inputSchema()
+                 * .name()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Tool]. */
+            class Builder internal constructor() {
+
+                private var inputSchema: JsonValue? = null
+                private var name: JsonField<String>? = null
+                private var annotations: JsonValue = JsonMissing.of()
+                private var description: JsonField<String> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(tool: Tool) = apply {
+                    inputSchema = tool.inputSchema
+                    name = tool.name
+                    annotations = tool.annotations
+                    description = tool.description
+                    additionalProperties = tool.additionalProperties.toMutableMap()
+                }
+
+                /** The JSON schema describing the tool's input. */
+                fun inputSchema(inputSchema: JsonValue) = apply { this.inputSchema = inputSchema }
+
+                /** The name of the tool. */
+                fun name(name: String) = name(JsonField.of(name))
+
+                /**
+                 * Sets [Builder.name] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.name] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun name(name: JsonField<String>) = apply { this.name = name }
+
+                /** Additional annotations about the tool. */
+                fun annotations(annotations: JsonValue) = apply { this.annotations = annotations }
+
+                /** The description of the tool. */
+                fun description(description: String?) =
+                    description(JsonField.ofNullable(description))
+
+                /** Alias for calling [Builder.description] with `description.orElse(null)`. */
+                fun description(description: Optional<String>) =
+                    description(description.getOrNull())
+
+                /**
+                 * Sets [Builder.description] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.description] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun description(description: JsonField<String>) = apply {
+                    this.description = description
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Tool].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .inputSchema()
+                 * .name()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Tool =
+                    Tool(
+                        checkRequired("inputSchema", inputSchema),
+                        checkRequired("name", name),
+                        annotations,
+                        description,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Tool = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                name()
+                description()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (name.asKnown().isPresent) 1 else 0) +
+                    (if (description.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Tool &&
+                    inputSchema == other.inputSchema &&
+                    name == other.name &&
+                    annotations == other.annotations &&
+                    description == other.description &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(inputSchema, name, annotations, description, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Tool{inputSchema=$inputSchema, name=$name, annotations=$annotations, description=$description, additionalProperties=$additionalProperties}"
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is McpListTools &&
+                id == other.id &&
+                serverLabel == other.serverLabel &&
+                tools == other.tools &&
+                type == other.type &&
+                agent == other.agent &&
+                error == other.error &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, serverLabel, tools, type, agent, error, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "McpListTools{id=$id, serverLabel=$serverLabel, tools=$tools, type=$type, agent=$agent, error=$error, additionalProperties=$additionalProperties}"
+    }
+
+    /** A request for human approval of a tool invocation. */
+    class McpApprovalRequest
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val arguments: JsonField<String>,
+        private val name: JsonField<String>,
+        private val serverLabel: JsonField<String>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("arguments")
+            @ExcludeMissing
+            arguments: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("server_label")
+            @ExcludeMissing
+            serverLabel: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, arguments, name, serverLabel, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the approval request.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * A JSON string of arguments for the tool.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun arguments(): String = arguments.getRequired("arguments")
+
+        /**
+         * The name of the tool to run.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun name(): String = name.getRequired("name")
+
+        /**
+         * The label of the MCP server making the request.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun serverLabel(): String = serverLabel.getRequired("server_label")
+
+        /**
+         * The type of the item. Always `mcp_approval_request`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("mcp_approval_request")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [arguments].
+         *
+         * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
+
+        /**
+         * Returns the raw JSON value of [name].
+         *
+         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+        /**
+         * Returns the raw JSON value of [serverLabel].
+         *
+         * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("server_label")
+        @ExcludeMissing
+        fun _serverLabel(): JsonField<String> = serverLabel
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [McpApprovalRequest].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .arguments()
+             * .name()
+             * .serverLabel()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [McpApprovalRequest]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var arguments: JsonField<String>? = null
+            private var name: JsonField<String>? = null
+            private var serverLabel: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("mcp_approval_request")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(mcpApprovalRequest: McpApprovalRequest) = apply {
+                id = mcpApprovalRequest.id
+                arguments = mcpApprovalRequest.arguments
+                name = mcpApprovalRequest.name
+                serverLabel = mcpApprovalRequest.serverLabel
+                type = mcpApprovalRequest.type
+                agent = mcpApprovalRequest.agent
+                additionalProperties = mcpApprovalRequest.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the approval request. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** A JSON string of arguments for the tool. */
+            fun arguments(arguments: String) = arguments(JsonField.of(arguments))
+
+            /**
+             * Sets [Builder.arguments] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.arguments] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
+
+            /** The name of the tool to run. */
+            fun name(name: String) = name(JsonField.of(name))
+
+            /**
+             * Sets [Builder.name] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.name] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun name(name: JsonField<String>) = apply { this.name = name }
+
+            /** The label of the MCP server making the request. */
+            fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
+
+            /**
+             * Sets [Builder.serverLabel] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serverLabel] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun serverLabel(serverLabel: JsonField<String>) = apply {
+                this.serverLabel = serverLabel
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("mcp_approval_request")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [McpApprovalRequest].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .arguments()
+             * .name()
+             * .serverLabel()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): McpApprovalRequest =
+                McpApprovalRequest(
+                    checkRequired("id", id),
+                    checkRequired("arguments", arguments),
+                    checkRequired("name", name),
+                    checkRequired("serverLabel", serverLabel),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): McpApprovalRequest = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            arguments()
+            name()
+            serverLabel()
+            _type().let {
+                if (it != JsonValue.from("mcp_approval_request")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (arguments.asKnown().isPresent) 1 else 0) +
+                (if (name.asKnown().isPresent) 1 else 0) +
+                (if (serverLabel.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("mcp_approval_request")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is McpApprovalRequest &&
+                id == other.id &&
+                arguments == other.arguments &&
+                name == other.name &&
+                serverLabel == other.serverLabel &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, arguments, name, serverLabel, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "McpApprovalRequest{id=$id, arguments=$arguments, name=$name, serverLabel=$serverLabel, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    /** A response to an MCP approval request. */
+    class McpApprovalResponse
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val approvalRequestId: JsonField<String>,
+        private val approve: JsonField<Boolean>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val reason: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("approval_request_id")
+            @ExcludeMissing
+            approvalRequestId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("approve") @ExcludeMissing approve: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("reason") @ExcludeMissing reason: JsonField<String> = JsonMissing.of(),
+        ) : this(id, approvalRequestId, approve, type, agent, reason, mutableMapOf())
+
+        /**
+         * The unique ID of the approval response
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The ID of the approval request being answered.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun approvalRequestId(): String = approvalRequestId.getRequired("approval_request_id")
+
+        /**
+         * Whether the request was approved.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun approve(): Boolean = approve.getRequired("approve")
+
+        /**
+         * The type of the item. Always `mcp_approval_response`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("mcp_approval_response")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Optional reason for the decision.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun reason(): Optional<String> = reason.getOptional("reason")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [approvalRequestId].
+         *
+         * Unlike [approvalRequestId], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("approval_request_id")
+        @ExcludeMissing
+        fun _approvalRequestId(): JsonField<String> = approvalRequestId
+
+        /**
+         * Returns the raw JSON value of [approve].
+         *
+         * Unlike [approve], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("approve") @ExcludeMissing fun _approve(): JsonField<Boolean> = approve
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [reason].
+         *
+         * Unlike [reason], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("reason") @ExcludeMissing fun _reason(): JsonField<String> = reason
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [McpApprovalResponse].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .approvalRequestId()
+             * .approve()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [McpApprovalResponse]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var approvalRequestId: JsonField<String>? = null
+            private var approve: JsonField<Boolean>? = null
+            private var type: JsonValue = JsonValue.from("mcp_approval_response")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var reason: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(mcpApprovalResponse: McpApprovalResponse) = apply {
+                id = mcpApprovalResponse.id
+                approvalRequestId = mcpApprovalResponse.approvalRequestId
+                approve = mcpApprovalResponse.approve
+                type = mcpApprovalResponse.type
+                agent = mcpApprovalResponse.agent
+                reason = mcpApprovalResponse.reason
+                additionalProperties = mcpApprovalResponse.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the approval response */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The ID of the approval request being answered. */
+            fun approvalRequestId(approvalRequestId: String) =
+                approvalRequestId(JsonField.of(approvalRequestId))
+
+            /**
+             * Sets [Builder.approvalRequestId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.approvalRequestId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun approvalRequestId(approvalRequestId: JsonField<String>) = apply {
+                this.approvalRequestId = approvalRequestId
+            }
+
+            /** Whether the request was approved. */
+            fun approve(approve: Boolean) = approve(JsonField.of(approve))
+
+            /**
+             * Sets [Builder.approve] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.approve] with a well-typed [Boolean] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun approve(approve: JsonField<Boolean>) = apply { this.approve = approve }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("mcp_approval_response")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /** Optional reason for the decision. */
+            fun reason(reason: String?) = reason(JsonField.ofNullable(reason))
+
+            /** Alias for calling [Builder.reason] with `reason.orElse(null)`. */
+            fun reason(reason: Optional<String>) = reason(reason.getOrNull())
+
+            /**
+             * Sets [Builder.reason] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.reason] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun reason(reason: JsonField<String>) = apply { this.reason = reason }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [McpApprovalResponse].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .approvalRequestId()
+             * .approve()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): McpApprovalResponse =
+                McpApprovalResponse(
+                    checkRequired("id", id),
+                    checkRequired("approvalRequestId", approvalRequestId),
+                    checkRequired("approve", approve),
+                    type,
+                    agent,
+                    reason,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): McpApprovalResponse = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            approvalRequestId()
+            approve()
+            _type().let {
+                if (it != JsonValue.from("mcp_approval_response")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            reason()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (approvalRequestId.asKnown().isPresent) 1 else 0) +
+                (if (approve.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("mcp_approval_response")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (reason.asKnown().isPresent) 1 else 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is McpApprovalResponse &&
+                id == other.id &&
+                approvalRequestId == other.approvalRequestId &&
+                approve == other.approve &&
+                type == other.type &&
+                agent == other.agent &&
+                reason == other.reason &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, approvalRequestId, approve, type, agent, reason, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "McpApprovalResponse{id=$id, approvalRequestId=$approvalRequestId, approve=$approve, type=$type, agent=$agent, reason=$reason, additionalProperties=$additionalProperties}"
+    }
+
+    /** An invocation of a tool on an MCP server. */
+    class McpCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val arguments: JsonField<String>,
+        private val name: JsonField<String>,
+        private val serverLabel: JsonField<String>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val approvalRequestId: JsonField<String>,
+        private val error: JsonField<String>,
+        private val output: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("arguments")
+            @ExcludeMissing
+            arguments: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("server_label")
+            @ExcludeMissing
+            serverLabel: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("approval_request_id")
+            @ExcludeMissing
+            approvalRequestId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("error") @ExcludeMissing error: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("output") @ExcludeMissing output: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        ) : this(
+            id,
+            arguments,
+            name,
+            serverLabel,
+            type,
+            agent,
+            approvalRequestId,
+            error,
+            output,
+            status,
+            mutableMapOf(),
+        )
+
+        /**
+         * The unique ID of the tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * A JSON string of the arguments passed to the tool.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun arguments(): String = arguments.getRequired("arguments")
+
+        /**
+         * The name of the tool that was run.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun name(): String = name.getRequired("name")
+
+        /**
+         * The label of the MCP server running the tool.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun serverLabel(): String = serverLabel.getRequired("server_label")
+
+        /**
+         * The type of the item. Always `mcp_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("mcp_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Unique identifier for the MCP tool call approval request. Include this value in a
+         * subsequent `mcp_approval_response` input to approve or reject the corresponding tool
+         * call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun approvalRequestId(): Optional<String> =
+            approvalRequestId.getOptional("approval_request_id")
+
+        /**
+         * The error from the tool call, if any.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun error(): Optional<String> = error.getOptional("error")
+
+        /**
+         * The output from the tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun output(): Optional<String> = output.getOptional("output")
+
+        /**
+         * The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `calling`,
+         * or `failed`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun status(): Optional<Status> = status.getOptional("status")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [arguments].
+         *
+         * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
+
+        /**
+         * Returns the raw JSON value of [name].
+         *
+         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+        /**
+         * Returns the raw JSON value of [serverLabel].
+         *
+         * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("server_label")
+        @ExcludeMissing
+        fun _serverLabel(): JsonField<String> = serverLabel
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [approvalRequestId].
+         *
+         * Unlike [approvalRequestId], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("approval_request_id")
+        @ExcludeMissing
+        fun _approvalRequestId(): JsonField<String> = approvalRequestId
+
+        /**
+         * Returns the raw JSON value of [error].
+         *
+         * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<String> = error
+
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<String> = output
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [McpCall].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .arguments()
+             * .name()
+             * .serverLabel()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [McpCall]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var arguments: JsonField<String>? = null
+            private var name: JsonField<String>? = null
+            private var serverLabel: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("mcp_call")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var approvalRequestId: JsonField<String> = JsonMissing.of()
+            private var error: JsonField<String> = JsonMissing.of()
+            private var output: JsonField<String> = JsonMissing.of()
+            private var status: JsonField<Status> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(mcpCall: McpCall) = apply {
+                id = mcpCall.id
+                arguments = mcpCall.arguments
+                name = mcpCall.name
+                serverLabel = mcpCall.serverLabel
+                type = mcpCall.type
+                agent = mcpCall.agent
+                approvalRequestId = mcpCall.approvalRequestId
+                error = mcpCall.error
+                output = mcpCall.output
+                status = mcpCall.status
+                additionalProperties = mcpCall.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the tool call. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** A JSON string of the arguments passed to the tool. */
+            fun arguments(arguments: String) = arguments(JsonField.of(arguments))
+
+            /**
+             * Sets [Builder.arguments] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.arguments] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
+
+            /** The name of the tool that was run. */
+            fun name(name: String) = name(JsonField.of(name))
+
+            /**
+             * Sets [Builder.name] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.name] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun name(name: JsonField<String>) = apply { this.name = name }
+
+            /** The label of the MCP server running the tool. */
+            fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
+
+            /**
+             * Sets [Builder.serverLabel] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serverLabel] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun serverLabel(serverLabel: JsonField<String>) = apply {
+                this.serverLabel = serverLabel
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("mcp_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /**
+             * Unique identifier for the MCP tool call approval request. Include this value in a
+             * subsequent `mcp_approval_response` input to approve or reject the corresponding tool
+             * call.
+             */
+            fun approvalRequestId(approvalRequestId: String?) =
+                approvalRequestId(JsonField.ofNullable(approvalRequestId))
+
+            /**
+             * Alias for calling [Builder.approvalRequestId] with `approvalRequestId.orElse(null)`.
+             */
+            fun approvalRequestId(approvalRequestId: Optional<String>) =
+                approvalRequestId(approvalRequestId.getOrNull())
+
+            /**
+             * Sets [Builder.approvalRequestId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.approvalRequestId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun approvalRequestId(approvalRequestId: JsonField<String>) = apply {
+                this.approvalRequestId = approvalRequestId
+            }
+
+            /** The error from the tool call, if any. */
+            fun error(error: String?) = error(JsonField.ofNullable(error))
+
+            /** Alias for calling [Builder.error] with `error.orElse(null)`. */
+            fun error(error: Optional<String>) = error(error.getOrNull())
+
+            /**
+             * Sets [Builder.error] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.error] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun error(error: JsonField<String>) = apply { this.error = error }
+
+            /** The output from the tool call. */
+            fun output(output: String?) = output(JsonField.ofNullable(output))
+
+            /** Alias for calling [Builder.output] with `output.orElse(null)`. */
+            fun output(output: Optional<String>) = output(output.getOrNull())
+
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun output(output: JsonField<String>) = apply { this.output = output }
+
+            /**
+             * The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+             * `calling`, or `failed`.
+             */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [McpCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .arguments()
+             * .name()
+             * .serverLabel()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): McpCall =
+                McpCall(
+                    checkRequired("id", id),
+                    checkRequired("arguments", arguments),
+                    checkRequired("name", name),
+                    checkRequired("serverLabel", serverLabel),
+                    type,
+                    agent,
+                    approvalRequestId,
+                    error,
+                    output,
+                    status,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): McpCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            arguments()
+            name()
+            serverLabel()
+            _type().let {
+                if (it != JsonValue.from("mcp_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            approvalRequestId()
+            error()
+            output()
+            status().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (arguments.asKnown().isPresent) 1 else 0) +
+                (if (name.asKnown().isPresent) 1 else 0) +
+                (if (serverLabel.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("mcp_call")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (approvalRequestId.asKnown().isPresent) 1 else 0) +
+                (if (error.asKnown().isPresent) 1 else 0) +
+                (if (output.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        /**
+         * The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `calling`,
+         * or `failed`.
+         */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmField val CALLING = of("calling")
+
+                @JvmField val FAILED = of("failed")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                CALLING,
+                FAILED,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                CALLING,
+                FAILED,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    CALLING -> Value.CALLING
+                    FAILED -> Value.FAILED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    CALLING -> Known.CALLING
+                    FAILED -> Known.FAILED
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is McpCall &&
+                id == other.id &&
+                arguments == other.arguments &&
+                name == other.name &&
+                serverLabel == other.serverLabel &&
+                type == other.type &&
+                agent == other.agent &&
+                approvalRequestId == other.approvalRequestId &&
+                error == other.error &&
+                output == other.output &&
+                status == other.status &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                id,
+                arguments,
+                name,
+                serverLabel,
+                type,
+                agent,
+                approvalRequestId,
+                error,
+                output,
+                status,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "McpCall{id=$id, arguments=$arguments, name=$name, serverLabel=$serverLabel, type=$type, agent=$agent, approvalRequestId=$approvalRequestId, error=$error, output=$output, status=$status, additionalProperties=$additionalProperties}"
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseLocalEnvironment.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseLocalEnvironment.kt
new file mode 100644
index 000000000..d96437d2a
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseLocalEnvironment.kt
@@ -0,0 +1,171 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+
+/** Represents the use of a local environment to perform shell actions. */
+class BetaResponseLocalEnvironment
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of()
+    ) : this(type, mutableMapOf())
+
+    /**
+     * The environment type. Always `local`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("local")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseLocalEnvironment].
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseLocalEnvironment]. */
+    class Builder internal constructor() {
+
+        private var type: JsonValue = JsonValue.from("local")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseLocalEnvironment: BetaResponseLocalEnvironment) = apply {
+            type = betaResponseLocalEnvironment.type
+            additionalProperties = betaResponseLocalEnvironment.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("local")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseLocalEnvironment].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): BetaResponseLocalEnvironment =
+            BetaResponseLocalEnvironment(type, additionalProperties.toMutableMap())
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseLocalEnvironment = apply {
+        if (validated) {
+            return@apply
+        }
+
+        _type().let {
+            if (it != JsonValue.from("local")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int = type.let { if (it == JsonValue.from("local")) 1 else 0 }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseLocalEnvironment &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(type, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseLocalEnvironment{type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallArgumentsDeltaEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallArgumentsDeltaEvent.kt
new file mode 100644
index 000000000..ee45ab82c
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallArgumentsDeltaEvent.kt
@@ -0,0 +1,554 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when there is a delta (partial update) to the arguments of an MCP tool call. */
+class BetaResponseMcpCallArgumentsDeltaEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val delta: JsonField<String>,
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("delta") @ExcludeMissing delta: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(delta, itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * A JSON string containing the partial update to the arguments for the MCP tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun delta(): String = delta.getRequired("delta")
+
+    /**
+     * The unique identifier of the MCP tool call item being processed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item in the response's output array.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always 'response.mcp_call_arguments.delta'.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.mcp_call_arguments.delta")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [delta].
+     *
+     * Unlike [delta], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("delta") @ExcludeMissing fun _delta(): JsonField<String> = delta
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseMcpCallArgumentsDeltaEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .delta()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseMcpCallArgumentsDeltaEvent]. */
+    class Builder internal constructor() {
+
+        private var delta: JsonField<String>? = null
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.mcp_call_arguments.delta")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseMcpCallArgumentsDeltaEvent: BetaResponseMcpCallArgumentsDeltaEvent
+        ) = apply {
+            delta = betaResponseMcpCallArgumentsDeltaEvent.delta
+            itemId = betaResponseMcpCallArgumentsDeltaEvent.itemId
+            outputIndex = betaResponseMcpCallArgumentsDeltaEvent.outputIndex
+            sequenceNumber = betaResponseMcpCallArgumentsDeltaEvent.sequenceNumber
+            type = betaResponseMcpCallArgumentsDeltaEvent.type
+            agent = betaResponseMcpCallArgumentsDeltaEvent.agent
+            additionalProperties =
+                betaResponseMcpCallArgumentsDeltaEvent.additionalProperties.toMutableMap()
+        }
+
+        /** A JSON string containing the partial update to the arguments for the MCP tool call. */
+        fun delta(delta: String) = delta(JsonField.of(delta))
+
+        /**
+         * Sets [Builder.delta] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.delta] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun delta(delta: JsonField<String>) = apply { this.delta = delta }
+
+        /** The unique identifier of the MCP tool call item being processed. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item in the response's output array. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.mcp_call_arguments.delta")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseMcpCallArgumentsDeltaEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .delta()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseMcpCallArgumentsDeltaEvent =
+            BetaResponseMcpCallArgumentsDeltaEvent(
+                checkRequired("delta", delta),
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseMcpCallArgumentsDeltaEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        delta()
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.mcp_call_arguments.delta")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (delta.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.mcp_call_arguments.delta")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseMcpCallArgumentsDeltaEvent &&
+            delta == other.delta &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(delta, itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseMcpCallArgumentsDeltaEvent{delta=$delta, itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallArgumentsDoneEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallArgumentsDoneEvent.kt
new file mode 100644
index 000000000..17a4440e4
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallArgumentsDoneEvent.kt
@@ -0,0 +1,563 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when the arguments for an MCP tool call are finalized. */
+class BetaResponseMcpCallArgumentsDoneEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val arguments: JsonField<String>,
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("arguments") @ExcludeMissing arguments: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(arguments, itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * A JSON string containing the finalized arguments for the MCP tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun arguments(): String = arguments.getRequired("arguments")
+
+    /**
+     * The unique identifier of the MCP tool call item being processed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item in the response's output array.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always 'response.mcp_call_arguments.done'.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.mcp_call_arguments.done")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [arguments].
+     *
+     * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseMcpCallArgumentsDoneEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .arguments()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseMcpCallArgumentsDoneEvent]. */
+    class Builder internal constructor() {
+
+        private var arguments: JsonField<String>? = null
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.mcp_call_arguments.done")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseMcpCallArgumentsDoneEvent: BetaResponseMcpCallArgumentsDoneEvent
+        ) = apply {
+            arguments = betaResponseMcpCallArgumentsDoneEvent.arguments
+            itemId = betaResponseMcpCallArgumentsDoneEvent.itemId
+            outputIndex = betaResponseMcpCallArgumentsDoneEvent.outputIndex
+            sequenceNumber = betaResponseMcpCallArgumentsDoneEvent.sequenceNumber
+            type = betaResponseMcpCallArgumentsDoneEvent.type
+            agent = betaResponseMcpCallArgumentsDoneEvent.agent
+            additionalProperties =
+                betaResponseMcpCallArgumentsDoneEvent.additionalProperties.toMutableMap()
+        }
+
+        /** A JSON string containing the finalized arguments for the MCP tool call. */
+        fun arguments(arguments: String) = arguments(JsonField.of(arguments))
+
+        /**
+         * Sets [Builder.arguments] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.arguments] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
+
+        /** The unique identifier of the MCP tool call item being processed. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item in the response's output array. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.mcp_call_arguments.done")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseMcpCallArgumentsDoneEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .arguments()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseMcpCallArgumentsDoneEvent =
+            BetaResponseMcpCallArgumentsDoneEvent(
+                checkRequired("arguments", arguments),
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseMcpCallArgumentsDoneEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        arguments()
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.mcp_call_arguments.done")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (arguments.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.mcp_call_arguments.done")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseMcpCallArgumentsDoneEvent &&
+            arguments == other.arguments &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            arguments,
+            itemId,
+            outputIndex,
+            sequenceNumber,
+            type,
+            agent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseMcpCallArgumentsDoneEvent{arguments=$arguments, itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallCompletedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallCompletedEvent.kt
new file mode 100644
index 000000000..3f0d3877d
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallCompletedEvent.kt
@@ -0,0 +1,517 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when an MCP tool call has completed successfully. */
+class BetaResponseMcpCallCompletedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The ID of the MCP tool call item that completed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item that completed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always 'response.mcp_call.completed'.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.mcp_call.completed")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseMcpCallCompletedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseMcpCallCompletedEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.mcp_call.completed")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseMcpCallCompletedEvent: BetaResponseMcpCallCompletedEvent) =
+            apply {
+                itemId = betaResponseMcpCallCompletedEvent.itemId
+                outputIndex = betaResponseMcpCallCompletedEvent.outputIndex
+                sequenceNumber = betaResponseMcpCallCompletedEvent.sequenceNumber
+                type = betaResponseMcpCallCompletedEvent.type
+                agent = betaResponseMcpCallCompletedEvent.agent
+                additionalProperties =
+                    betaResponseMcpCallCompletedEvent.additionalProperties.toMutableMap()
+            }
+
+        /** The ID of the MCP tool call item that completed. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item that completed. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.mcp_call.completed")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseMcpCallCompletedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseMcpCallCompletedEvent =
+            BetaResponseMcpCallCompletedEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseMcpCallCompletedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.mcp_call.completed")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.mcp_call.completed")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseMcpCallCompletedEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseMcpCallCompletedEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallFailedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallFailedEvent.kt
new file mode 100644
index 000000000..315b26915
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallFailedEvent.kt
@@ -0,0 +1,516 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when an MCP tool call has failed. */
+class BetaResponseMcpCallFailedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The ID of the MCP tool call item that failed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item that failed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always 'response.mcp_call.failed'.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.mcp_call.failed")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseMcpCallFailedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseMcpCallFailedEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.mcp_call.failed")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseMcpCallFailedEvent: BetaResponseMcpCallFailedEvent) = apply {
+            itemId = betaResponseMcpCallFailedEvent.itemId
+            outputIndex = betaResponseMcpCallFailedEvent.outputIndex
+            sequenceNumber = betaResponseMcpCallFailedEvent.sequenceNumber
+            type = betaResponseMcpCallFailedEvent.type
+            agent = betaResponseMcpCallFailedEvent.agent
+            additionalProperties =
+                betaResponseMcpCallFailedEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The ID of the MCP tool call item that failed. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item that failed. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.mcp_call.failed")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseMcpCallFailedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseMcpCallFailedEvent =
+            BetaResponseMcpCallFailedEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseMcpCallFailedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.mcp_call.failed")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.mcp_call.failed")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseMcpCallFailedEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseMcpCallFailedEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallInProgressEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallInProgressEvent.kt
new file mode 100644
index 000000000..54b5ba87a
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallInProgressEvent.kt
@@ -0,0 +1,517 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when an MCP tool call is in progress. */
+class BetaResponseMcpCallInProgressEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The unique identifier of the MCP tool call item being processed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item in the response's output array.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always 'response.mcp_call.in_progress'.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.mcp_call.in_progress")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseMcpCallInProgressEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseMcpCallInProgressEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.mcp_call.in_progress")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseMcpCallInProgressEvent: BetaResponseMcpCallInProgressEvent) =
+            apply {
+                itemId = betaResponseMcpCallInProgressEvent.itemId
+                outputIndex = betaResponseMcpCallInProgressEvent.outputIndex
+                sequenceNumber = betaResponseMcpCallInProgressEvent.sequenceNumber
+                type = betaResponseMcpCallInProgressEvent.type
+                agent = betaResponseMcpCallInProgressEvent.agent
+                additionalProperties =
+                    betaResponseMcpCallInProgressEvent.additionalProperties.toMutableMap()
+            }
+
+        /** The unique identifier of the MCP tool call item being processed. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item in the response's output array. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.mcp_call.in_progress")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseMcpCallInProgressEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseMcpCallInProgressEvent =
+            BetaResponseMcpCallInProgressEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseMcpCallInProgressEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.mcp_call.in_progress")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.mcp_call.in_progress")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseMcpCallInProgressEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseMcpCallInProgressEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsCompletedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsCompletedEvent.kt
new file mode 100644
index 000000000..9ec0a7924
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsCompletedEvent.kt
@@ -0,0 +1,518 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when the list of available MCP tools has been successfully retrieved. */
+class BetaResponseMcpListToolsCompletedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The ID of the MCP tool call item that produced this output.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item that was processed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always 'response.mcp_list_tools.completed'.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.mcp_list_tools.completed")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseMcpListToolsCompletedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseMcpListToolsCompletedEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.mcp_list_tools.completed")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseMcpListToolsCompletedEvent: BetaResponseMcpListToolsCompletedEvent
+        ) = apply {
+            itemId = betaResponseMcpListToolsCompletedEvent.itemId
+            outputIndex = betaResponseMcpListToolsCompletedEvent.outputIndex
+            sequenceNumber = betaResponseMcpListToolsCompletedEvent.sequenceNumber
+            type = betaResponseMcpListToolsCompletedEvent.type
+            agent = betaResponseMcpListToolsCompletedEvent.agent
+            additionalProperties =
+                betaResponseMcpListToolsCompletedEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The ID of the MCP tool call item that produced this output. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item that was processed. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.mcp_list_tools.completed")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseMcpListToolsCompletedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseMcpListToolsCompletedEvent =
+            BetaResponseMcpListToolsCompletedEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseMcpListToolsCompletedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.mcp_list_tools.completed")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.mcp_list_tools.completed")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseMcpListToolsCompletedEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseMcpListToolsCompletedEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsFailedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsFailedEvent.kt
new file mode 100644
index 000000000..5f2d731e4
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsFailedEvent.kt
@@ -0,0 +1,518 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when the attempt to list available MCP tools has failed. */
+class BetaResponseMcpListToolsFailedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The ID of the MCP tool call item that failed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item that failed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always 'response.mcp_list_tools.failed'.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.mcp_list_tools.failed")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseMcpListToolsFailedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseMcpListToolsFailedEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.mcp_list_tools.failed")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseMcpListToolsFailedEvent: BetaResponseMcpListToolsFailedEvent
+        ) = apply {
+            itemId = betaResponseMcpListToolsFailedEvent.itemId
+            outputIndex = betaResponseMcpListToolsFailedEvent.outputIndex
+            sequenceNumber = betaResponseMcpListToolsFailedEvent.sequenceNumber
+            type = betaResponseMcpListToolsFailedEvent.type
+            agent = betaResponseMcpListToolsFailedEvent.agent
+            additionalProperties =
+                betaResponseMcpListToolsFailedEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The ID of the MCP tool call item that failed. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item that failed. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.mcp_list_tools.failed")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseMcpListToolsFailedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseMcpListToolsFailedEvent =
+            BetaResponseMcpListToolsFailedEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseMcpListToolsFailedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.mcp_list_tools.failed")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.mcp_list_tools.failed")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseMcpListToolsFailedEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseMcpListToolsFailedEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsInProgressEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsInProgressEvent.kt
new file mode 100644
index 000000000..1f00affb9
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsInProgressEvent.kt
@@ -0,0 +1,518 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when the system is in the process of retrieving the list of available MCP tools. */
+class BetaResponseMcpListToolsInProgressEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The ID of the MCP tool call item that is being processed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item that is being processed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always 'response.mcp_list_tools.in_progress'.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.mcp_list_tools.in_progress")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseMcpListToolsInProgressEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseMcpListToolsInProgressEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.mcp_list_tools.in_progress")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseMcpListToolsInProgressEvent: BetaResponseMcpListToolsInProgressEvent
+        ) = apply {
+            itemId = betaResponseMcpListToolsInProgressEvent.itemId
+            outputIndex = betaResponseMcpListToolsInProgressEvent.outputIndex
+            sequenceNumber = betaResponseMcpListToolsInProgressEvent.sequenceNumber
+            type = betaResponseMcpListToolsInProgressEvent.type
+            agent = betaResponseMcpListToolsInProgressEvent.agent
+            additionalProperties =
+                betaResponseMcpListToolsInProgressEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The ID of the MCP tool call item that is being processed. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item that is being processed. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.mcp_list_tools.in_progress")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseMcpListToolsInProgressEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseMcpListToolsInProgressEvent =
+            BetaResponseMcpListToolsInProgressEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseMcpListToolsInProgressEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.mcp_list_tools.in_progress")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.mcp_list_tools.in_progress")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseMcpListToolsInProgressEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseMcpListToolsInProgressEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputAudio.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputAudio.kt
new file mode 100644
index 000000000..5a8d3156d
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputAudio.kt
@@ -0,0 +1,262 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+
+/** An audio output from the model. */
+class BetaResponseOutputAudio
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val data: JsonField<String>,
+    private val transcript: JsonField<String>,
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("data") @ExcludeMissing data: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("transcript")
+        @ExcludeMissing
+        transcript: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+    ) : this(data, transcript, type, mutableMapOf())
+
+    /**
+     * Base64-encoded audio data from the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun data(): String = data.getRequired("data")
+
+    /**
+     * The transcript of the audio data from the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun transcript(): String = transcript.getRequired("transcript")
+
+    /**
+     * The type of the output audio. Always `output_audio`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("output_audio")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Returns the raw JSON value of [data].
+     *
+     * Unlike [data], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("data") @ExcludeMissing fun _data(): JsonField<String> = data
+
+    /**
+     * Returns the raw JSON value of [transcript].
+     *
+     * Unlike [transcript], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("transcript") @ExcludeMissing fun _transcript(): JsonField<String> = transcript
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseOutputAudio].
+         *
+         * The following fields are required:
+         * ```java
+         * .data()
+         * .transcript()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseOutputAudio]. */
+    class Builder internal constructor() {
+
+        private var data: JsonField<String>? = null
+        private var transcript: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("output_audio")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseOutputAudio: BetaResponseOutputAudio) = apply {
+            data = betaResponseOutputAudio.data
+            transcript = betaResponseOutputAudio.transcript
+            type = betaResponseOutputAudio.type
+            additionalProperties = betaResponseOutputAudio.additionalProperties.toMutableMap()
+        }
+
+        /** Base64-encoded audio data from the model. */
+        fun data(data: String) = data(JsonField.of(data))
+
+        /**
+         * Sets [Builder.data] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.data] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun data(data: JsonField<String>) = apply { this.data = data }
+
+        /** The transcript of the audio data from the model. */
+        fun transcript(transcript: String) = transcript(JsonField.of(transcript))
+
+        /**
+         * Sets [Builder.transcript] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.transcript] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun transcript(transcript: JsonField<String>) = apply { this.transcript = transcript }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("output_audio")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseOutputAudio].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .data()
+         * .transcript()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseOutputAudio =
+            BetaResponseOutputAudio(
+                checkRequired("data", data),
+                checkRequired("transcript", transcript),
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseOutputAudio = apply {
+        if (validated) {
+            return@apply
+        }
+
+        data()
+        transcript()
+        _type().let {
+            if (it != JsonValue.from("output_audio")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (data.asKnown().isPresent) 1 else 0) +
+            (if (transcript.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("output_audio")) 1 else 0 }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseOutputAudio &&
+            data == other.data &&
+            transcript == other.transcript &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(data, transcript, type, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseOutputAudio{data=$data, transcript=$transcript, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputItem.kt
new file mode 100644
index 000000000..a11abb7e2
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputItem.kt
@@ -0,0 +1,12967 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** An output message from the model. */
+@JsonDeserialize(using = BetaResponseOutputItem.Deserializer::class)
+@JsonSerialize(using = BetaResponseOutputItem.Serializer::class)
+class BetaResponseOutputItem
+private constructor(
+    private val message: BetaResponseOutputMessage? = null,
+    private val fileSearchCall: BetaResponseFileSearchToolCall? = null,
+    private val functionCall: BetaResponseFunctionToolCall? = null,
+    private val functionCallOutput: BetaResponseFunctionToolCallOutputItem? = null,
+    private val agentMessage: AgentMessage? = null,
+    private val multiAgentCall: MultiAgentCall? = null,
+    private val multiAgentCallOutput: MultiAgentCallOutput? = null,
+    private val webSearchCall: BetaResponseFunctionWebSearch? = null,
+    private val computerCall: BetaResponseComputerToolCall? = null,
+    private val computerCallOutput: BetaResponseComputerToolCallOutputItem? = null,
+    private val reasoning: BetaResponseReasoningItem? = null,
+    private val program: Program? = null,
+    private val programOutput: ProgramOutput? = null,
+    private val toolSearchCall: BetaResponseToolSearchCall? = null,
+    private val toolSearchOutput: BetaResponseToolSearchOutputItem? = null,
+    private val additionalTools: AdditionalTools? = null,
+    private val compaction: BetaResponseCompactionItem? = null,
+    private val imageGenerationCall: ImageGenerationCall? = null,
+    private val codeInterpreterCall: BetaResponseCodeInterpreterToolCall? = null,
+    private val localShellCall: LocalShellCall? = null,
+    private val localShellCallOutput: LocalShellCallOutput? = null,
+    private val shellCall: BetaResponseFunctionShellToolCall? = null,
+    private val shellCallOutput: BetaResponseFunctionShellToolCallOutput? = null,
+    private val applyPatchCall: BetaResponseApplyPatchToolCall? = null,
+    private val applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput? = null,
+    private val mcpCall: McpCall? = null,
+    private val mcpListTools: McpListTools? = null,
+    private val mcpApprovalRequest: McpApprovalRequest? = null,
+    private val mcpApprovalResponse: McpApprovalResponse? = null,
+    private val customToolCall: BetaResponseCustomToolCall? = null,
+    private val customToolCallOutput: BetaResponseCustomToolCallOutputItem? = null,
+    private val _json: JsonValue? = null,
+) {
+
+    /** An output message from the model. */
+    fun message(): Optional<BetaResponseOutputMessage> = Optional.ofNullable(message)
+
+    /**
+     * The results of a file search tool call. See the
+     * [file search guide](https://platform.openai.com/docs/guides/tools-file-search) for more
+     * information.
+     */
+    fun fileSearchCall(): Optional<BetaResponseFileSearchToolCall> =
+        Optional.ofNullable(fileSearchCall)
+
+    /**
+     * A tool call to run a function. See the
+     * [function calling guide](https://platform.openai.com/docs/guides/function-calling) for more
+     * information.
+     */
+    fun functionCall(): Optional<BetaResponseFunctionToolCall> = Optional.ofNullable(functionCall)
+
+    fun functionCallOutput(): Optional<BetaResponseFunctionToolCallOutputItem> =
+        Optional.ofNullable(functionCallOutput)
+
+    fun agentMessage(): Optional<AgentMessage> = Optional.ofNullable(agentMessage)
+
+    fun multiAgentCall(): Optional<MultiAgentCall> = Optional.ofNullable(multiAgentCall)
+
+    fun multiAgentCallOutput(): Optional<MultiAgentCallOutput> =
+        Optional.ofNullable(multiAgentCallOutput)
+
+    /**
+     * The results of a web search tool call. See the
+     * [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more
+     * information.
+     */
+    fun webSearchCall(): Optional<BetaResponseFunctionWebSearch> =
+        Optional.ofNullable(webSearchCall)
+
+    /**
+     * A tool call to a computer use tool. See the
+     * [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more
+     * information.
+     */
+    fun computerCall(): Optional<BetaResponseComputerToolCall> = Optional.ofNullable(computerCall)
+
+    fun computerCallOutput(): Optional<BetaResponseComputerToolCallOutputItem> =
+        Optional.ofNullable(computerCallOutput)
+
+    /**
+     * A description of the chain of thought used by a reasoning model while generating a response.
+     * Be sure to include these items in your `input` to the Responses API for subsequent turns of a
+     * conversation if you are manually
+     * [managing context](https://platform.openai.com/docs/guides/conversation-state).
+     */
+    fun reasoning(): Optional<BetaResponseReasoningItem> = Optional.ofNullable(reasoning)
+
+    fun program(): Optional<Program> = Optional.ofNullable(program)
+
+    fun programOutput(): Optional<ProgramOutput> = Optional.ofNullable(programOutput)
+
+    fun toolSearchCall(): Optional<BetaResponseToolSearchCall> = Optional.ofNullable(toolSearchCall)
+
+    fun toolSearchOutput(): Optional<BetaResponseToolSearchOutputItem> =
+        Optional.ofNullable(toolSearchOutput)
+
+    fun additionalTools(): Optional<AdditionalTools> = Optional.ofNullable(additionalTools)
+
+    /**
+     * A compaction item generated by the
+     * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+     */
+    fun compaction(): Optional<BetaResponseCompactionItem> = Optional.ofNullable(compaction)
+
+    /** An image generation request made by the model. */
+    fun imageGenerationCall(): Optional<ImageGenerationCall> =
+        Optional.ofNullable(imageGenerationCall)
+
+    /** A tool call to run code. */
+    fun codeInterpreterCall(): Optional<BetaResponseCodeInterpreterToolCall> =
+        Optional.ofNullable(codeInterpreterCall)
+
+    /** A tool call to run a command on the local shell. */
+    fun localShellCall(): Optional<LocalShellCall> = Optional.ofNullable(localShellCall)
+
+    /** The output of a local shell tool call. */
+    fun localShellCallOutput(): Optional<LocalShellCallOutput> =
+        Optional.ofNullable(localShellCallOutput)
+
+    /** A tool call that executes one or more shell commands in a managed environment. */
+    fun shellCall(): Optional<BetaResponseFunctionShellToolCall> = Optional.ofNullable(shellCall)
+
+    /** The output of a shell tool call that was emitted. */
+    fun shellCallOutput(): Optional<BetaResponseFunctionShellToolCallOutput> =
+        Optional.ofNullable(shellCallOutput)
+
+    /** A tool call that applies file diffs by creating, deleting, or updating files. */
+    fun applyPatchCall(): Optional<BetaResponseApplyPatchToolCall> =
+        Optional.ofNullable(applyPatchCall)
+
+    /** The output emitted by an apply patch tool call. */
+    fun applyPatchCallOutput(): Optional<BetaResponseApplyPatchToolCallOutput> =
+        Optional.ofNullable(applyPatchCallOutput)
+
+    /** An invocation of a tool on an MCP server. */
+    fun mcpCall(): Optional<McpCall> = Optional.ofNullable(mcpCall)
+
+    /** A list of tools available on an MCP server. */
+    fun mcpListTools(): Optional<McpListTools> = Optional.ofNullable(mcpListTools)
+
+    /** A request for human approval of a tool invocation. */
+    fun mcpApprovalRequest(): Optional<McpApprovalRequest> = Optional.ofNullable(mcpApprovalRequest)
+
+    /** A response to an MCP approval request. */
+    fun mcpApprovalResponse(): Optional<McpApprovalResponse> =
+        Optional.ofNullable(mcpApprovalResponse)
+
+    /** A call to a custom tool created by the model. */
+    fun customToolCall(): Optional<BetaResponseCustomToolCall> = Optional.ofNullable(customToolCall)
+
+    /** The output of a custom tool call from your code, being sent back to the model. */
+    fun customToolCallOutput(): Optional<BetaResponseCustomToolCallOutputItem> =
+        Optional.ofNullable(customToolCallOutput)
+
+    fun isMessage(): Boolean = message != null
+
+    fun isFileSearchCall(): Boolean = fileSearchCall != null
+
+    fun isFunctionCall(): Boolean = functionCall != null
+
+    fun isFunctionCallOutput(): Boolean = functionCallOutput != null
+
+    fun isAgentMessage(): Boolean = agentMessage != null
+
+    fun isMultiAgentCall(): Boolean = multiAgentCall != null
+
+    fun isMultiAgentCallOutput(): Boolean = multiAgentCallOutput != null
+
+    fun isWebSearchCall(): Boolean = webSearchCall != null
+
+    fun isComputerCall(): Boolean = computerCall != null
+
+    fun isComputerCallOutput(): Boolean = computerCallOutput != null
+
+    fun isReasoning(): Boolean = reasoning != null
+
+    fun isProgram(): Boolean = program != null
+
+    fun isProgramOutput(): Boolean = programOutput != null
+
+    fun isToolSearchCall(): Boolean = toolSearchCall != null
+
+    fun isToolSearchOutput(): Boolean = toolSearchOutput != null
+
+    fun isAdditionalTools(): Boolean = additionalTools != null
+
+    fun isCompaction(): Boolean = compaction != null
+
+    fun isImageGenerationCall(): Boolean = imageGenerationCall != null
+
+    fun isCodeInterpreterCall(): Boolean = codeInterpreterCall != null
+
+    fun isLocalShellCall(): Boolean = localShellCall != null
+
+    fun isLocalShellCallOutput(): Boolean = localShellCallOutput != null
+
+    fun isShellCall(): Boolean = shellCall != null
+
+    fun isShellCallOutput(): Boolean = shellCallOutput != null
+
+    fun isApplyPatchCall(): Boolean = applyPatchCall != null
+
+    fun isApplyPatchCallOutput(): Boolean = applyPatchCallOutput != null
+
+    fun isMcpCall(): Boolean = mcpCall != null
+
+    fun isMcpListTools(): Boolean = mcpListTools != null
+
+    fun isMcpApprovalRequest(): Boolean = mcpApprovalRequest != null
+
+    fun isMcpApprovalResponse(): Boolean = mcpApprovalResponse != null
+
+    fun isCustomToolCall(): Boolean = customToolCall != null
+
+    fun isCustomToolCallOutput(): Boolean = customToolCallOutput != null
+
+    /** An output message from the model. */
+    fun asMessage(): BetaResponseOutputMessage = message.getOrThrow("message")
+
+    /**
+     * The results of a file search tool call. See the
+     * [file search guide](https://platform.openai.com/docs/guides/tools-file-search) for more
+     * information.
+     */
+    fun asFileSearchCall(): BetaResponseFileSearchToolCall =
+        fileSearchCall.getOrThrow("fileSearchCall")
+
+    /**
+     * A tool call to run a function. See the
+     * [function calling guide](https://platform.openai.com/docs/guides/function-calling) for more
+     * information.
+     */
+    fun asFunctionCall(): BetaResponseFunctionToolCall = functionCall.getOrThrow("functionCall")
+
+    fun asFunctionCallOutput(): BetaResponseFunctionToolCallOutputItem =
+        functionCallOutput.getOrThrow("functionCallOutput")
+
+    fun asAgentMessage(): AgentMessage = agentMessage.getOrThrow("agentMessage")
+
+    fun asMultiAgentCall(): MultiAgentCall = multiAgentCall.getOrThrow("multiAgentCall")
+
+    fun asMultiAgentCallOutput(): MultiAgentCallOutput =
+        multiAgentCallOutput.getOrThrow("multiAgentCallOutput")
+
+    /**
+     * The results of a web search tool call. See the
+     * [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more
+     * information.
+     */
+    fun asWebSearchCall(): BetaResponseFunctionWebSearch = webSearchCall.getOrThrow("webSearchCall")
+
+    /**
+     * A tool call to a computer use tool. See the
+     * [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more
+     * information.
+     */
+    fun asComputerCall(): BetaResponseComputerToolCall = computerCall.getOrThrow("computerCall")
+
+    fun asComputerCallOutput(): BetaResponseComputerToolCallOutputItem =
+        computerCallOutput.getOrThrow("computerCallOutput")
+
+    /**
+     * A description of the chain of thought used by a reasoning model while generating a response.
+     * Be sure to include these items in your `input` to the Responses API for subsequent turns of a
+     * conversation if you are manually
+     * [managing context](https://platform.openai.com/docs/guides/conversation-state).
+     */
+    fun asReasoning(): BetaResponseReasoningItem = reasoning.getOrThrow("reasoning")
+
+    fun asProgram(): Program = program.getOrThrow("program")
+
+    fun asProgramOutput(): ProgramOutput = programOutput.getOrThrow("programOutput")
+
+    fun asToolSearchCall(): BetaResponseToolSearchCall = toolSearchCall.getOrThrow("toolSearchCall")
+
+    fun asToolSearchOutput(): BetaResponseToolSearchOutputItem =
+        toolSearchOutput.getOrThrow("toolSearchOutput")
+
+    fun asAdditionalTools(): AdditionalTools = additionalTools.getOrThrow("additionalTools")
+
+    /**
+     * A compaction item generated by the
+     * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+     */
+    fun asCompaction(): BetaResponseCompactionItem = compaction.getOrThrow("compaction")
+
+    /** An image generation request made by the model. */
+    fun asImageGenerationCall(): ImageGenerationCall =
+        imageGenerationCall.getOrThrow("imageGenerationCall")
+
+    /** A tool call to run code. */
+    fun asCodeInterpreterCall(): BetaResponseCodeInterpreterToolCall =
+        codeInterpreterCall.getOrThrow("codeInterpreterCall")
+
+    /** A tool call to run a command on the local shell. */
+    fun asLocalShellCall(): LocalShellCall = localShellCall.getOrThrow("localShellCall")
+
+    /** The output of a local shell tool call. */
+    fun asLocalShellCallOutput(): LocalShellCallOutput =
+        localShellCallOutput.getOrThrow("localShellCallOutput")
+
+    /** A tool call that executes one or more shell commands in a managed environment. */
+    fun asShellCall(): BetaResponseFunctionShellToolCall = shellCall.getOrThrow("shellCall")
+
+    /** The output of a shell tool call that was emitted. */
+    fun asShellCallOutput(): BetaResponseFunctionShellToolCallOutput =
+        shellCallOutput.getOrThrow("shellCallOutput")
+
+    /** A tool call that applies file diffs by creating, deleting, or updating files. */
+    fun asApplyPatchCall(): BetaResponseApplyPatchToolCall =
+        applyPatchCall.getOrThrow("applyPatchCall")
+
+    /** The output emitted by an apply patch tool call. */
+    fun asApplyPatchCallOutput(): BetaResponseApplyPatchToolCallOutput =
+        applyPatchCallOutput.getOrThrow("applyPatchCallOutput")
+
+    /** An invocation of a tool on an MCP server. */
+    fun asMcpCall(): McpCall = mcpCall.getOrThrow("mcpCall")
+
+    /** A list of tools available on an MCP server. */
+    fun asMcpListTools(): McpListTools = mcpListTools.getOrThrow("mcpListTools")
+
+    /** A request for human approval of a tool invocation. */
+    fun asMcpApprovalRequest(): McpApprovalRequest =
+        mcpApprovalRequest.getOrThrow("mcpApprovalRequest")
+
+    /** A response to an MCP approval request. */
+    fun asMcpApprovalResponse(): McpApprovalResponse =
+        mcpApprovalResponse.getOrThrow("mcpApprovalResponse")
+
+    /** A call to a custom tool created by the model. */
+    fun asCustomToolCall(): BetaResponseCustomToolCall = customToolCall.getOrThrow("customToolCall")
+
+    /** The output of a custom tool call from your code, being sent back to the model. */
+    fun asCustomToolCallOutput(): BetaResponseCustomToolCallOutputItem =
+        customToolCallOutput.getOrThrow("customToolCallOutput")
+
+    fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+    /**
+     * Maps this instance's current variant to a value of type [T] using the given [visitor].
+     *
+     * Note that this method is _not_ forwards compatible with new variants from the API, unless
+     * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of the
+     * SDK gracefully, consider overriding [Visitor.unknown]:
+     * ```java
+     * import com.openai.core.JsonValue;
+     * import java.util.Optional;
+     *
+     * Optional<String> result = betaResponseOutputItem.accept(new BetaResponseOutputItem.Visitor<Optional<String>>() {
+     *     @Override
+     *     public Optional<String> visitMessage(BetaResponseOutputMessage message) {
+     *         return Optional.of(message.toString());
+     *     }
+     *
+     *     // ...
+     *
+     *     @Override
+     *     public Optional<String> unknown(JsonValue json) {
+     *         // Or inspect the `json`.
+     *         return Optional.empty();
+     *     }
+     * });
+     * ```
+     *
+     * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor] and
+     *   the current variant is unknown.
+     */
+    fun <T> accept(visitor: Visitor<T>): T =
+        when {
+            message != null -> visitor.visitMessage(message)
+            fileSearchCall != null -> visitor.visitFileSearchCall(fileSearchCall)
+            functionCall != null -> visitor.visitFunctionCall(functionCall)
+            functionCallOutput != null -> visitor.visitFunctionCallOutput(functionCallOutput)
+            agentMessage != null -> visitor.visitAgentMessage(agentMessage)
+            multiAgentCall != null -> visitor.visitMultiAgentCall(multiAgentCall)
+            multiAgentCallOutput != null -> visitor.visitMultiAgentCallOutput(multiAgentCallOutput)
+            webSearchCall != null -> visitor.visitWebSearchCall(webSearchCall)
+            computerCall != null -> visitor.visitComputerCall(computerCall)
+            computerCallOutput != null -> visitor.visitComputerCallOutput(computerCallOutput)
+            reasoning != null -> visitor.visitReasoning(reasoning)
+            program != null -> visitor.visitProgram(program)
+            programOutput != null -> visitor.visitProgramOutput(programOutput)
+            toolSearchCall != null -> visitor.visitToolSearchCall(toolSearchCall)
+            toolSearchOutput != null -> visitor.visitToolSearchOutput(toolSearchOutput)
+            additionalTools != null -> visitor.visitAdditionalTools(additionalTools)
+            compaction != null -> visitor.visitCompaction(compaction)
+            imageGenerationCall != null -> visitor.visitImageGenerationCall(imageGenerationCall)
+            codeInterpreterCall != null -> visitor.visitCodeInterpreterCall(codeInterpreterCall)
+            localShellCall != null -> visitor.visitLocalShellCall(localShellCall)
+            localShellCallOutput != null -> visitor.visitLocalShellCallOutput(localShellCallOutput)
+            shellCall != null -> visitor.visitShellCall(shellCall)
+            shellCallOutput != null -> visitor.visitShellCallOutput(shellCallOutput)
+            applyPatchCall != null -> visitor.visitApplyPatchCall(applyPatchCall)
+            applyPatchCallOutput != null -> visitor.visitApplyPatchCallOutput(applyPatchCallOutput)
+            mcpCall != null -> visitor.visitMcpCall(mcpCall)
+            mcpListTools != null -> visitor.visitMcpListTools(mcpListTools)
+            mcpApprovalRequest != null -> visitor.visitMcpApprovalRequest(mcpApprovalRequest)
+            mcpApprovalResponse != null -> visitor.visitMcpApprovalResponse(mcpApprovalResponse)
+            customToolCall != null -> visitor.visitCustomToolCall(customToolCall)
+            customToolCallOutput != null -> visitor.visitCustomToolCallOutput(customToolCallOutput)
+            else -> visitor.unknown(_json)
+        }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseOutputItem = apply {
+        if (validated) {
+            return@apply
+        }
+
+        accept(
+            object : Visitor<Unit> {
+                override fun visitMessage(message: BetaResponseOutputMessage) {
+                    message.validate()
+                }
+
+                override fun visitFileSearchCall(fileSearchCall: BetaResponseFileSearchToolCall) {
+                    fileSearchCall.validate()
+                }
+
+                override fun visitFunctionCall(functionCall: BetaResponseFunctionToolCall) {
+                    functionCall.validate()
+                }
+
+                override fun visitFunctionCallOutput(
+                    functionCallOutput: BetaResponseFunctionToolCallOutputItem
+                ) {
+                    functionCallOutput.validate()
+                }
+
+                override fun visitAgentMessage(agentMessage: AgentMessage) {
+                    agentMessage.validate()
+                }
+
+                override fun visitMultiAgentCall(multiAgentCall: MultiAgentCall) {
+                    multiAgentCall.validate()
+                }
+
+                override fun visitMultiAgentCallOutput(multiAgentCallOutput: MultiAgentCallOutput) {
+                    multiAgentCallOutput.validate()
+                }
+
+                override fun visitWebSearchCall(webSearchCall: BetaResponseFunctionWebSearch) {
+                    webSearchCall.validate()
+                }
+
+                override fun visitComputerCall(computerCall: BetaResponseComputerToolCall) {
+                    computerCall.validate()
+                }
+
+                override fun visitComputerCallOutput(
+                    computerCallOutput: BetaResponseComputerToolCallOutputItem
+                ) {
+                    computerCallOutput.validate()
+                }
+
+                override fun visitReasoning(reasoning: BetaResponseReasoningItem) {
+                    reasoning.validate()
+                }
+
+                override fun visitProgram(program: Program) {
+                    program.validate()
+                }
+
+                override fun visitProgramOutput(programOutput: ProgramOutput) {
+                    programOutput.validate()
+                }
+
+                override fun visitToolSearchCall(toolSearchCall: BetaResponseToolSearchCall) {
+                    toolSearchCall.validate()
+                }
+
+                override fun visitToolSearchOutput(
+                    toolSearchOutput: BetaResponseToolSearchOutputItem
+                ) {
+                    toolSearchOutput.validate()
+                }
+
+                override fun visitAdditionalTools(additionalTools: AdditionalTools) {
+                    additionalTools.validate()
+                }
+
+                override fun visitCompaction(compaction: BetaResponseCompactionItem) {
+                    compaction.validate()
+                }
+
+                override fun visitImageGenerationCall(imageGenerationCall: ImageGenerationCall) {
+                    imageGenerationCall.validate()
+                }
+
+                override fun visitCodeInterpreterCall(
+                    codeInterpreterCall: BetaResponseCodeInterpreterToolCall
+                ) {
+                    codeInterpreterCall.validate()
+                }
+
+                override fun visitLocalShellCall(localShellCall: LocalShellCall) {
+                    localShellCall.validate()
+                }
+
+                override fun visitLocalShellCallOutput(localShellCallOutput: LocalShellCallOutput) {
+                    localShellCallOutput.validate()
+                }
+
+                override fun visitShellCall(shellCall: BetaResponseFunctionShellToolCall) {
+                    shellCall.validate()
+                }
+
+                override fun visitShellCallOutput(
+                    shellCallOutput: BetaResponseFunctionShellToolCallOutput
+                ) {
+                    shellCallOutput.validate()
+                }
+
+                override fun visitApplyPatchCall(applyPatchCall: BetaResponseApplyPatchToolCall) {
+                    applyPatchCall.validate()
+                }
+
+                override fun visitApplyPatchCallOutput(
+                    applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput
+                ) {
+                    applyPatchCallOutput.validate()
+                }
+
+                override fun visitMcpCall(mcpCall: McpCall) {
+                    mcpCall.validate()
+                }
+
+                override fun visitMcpListTools(mcpListTools: McpListTools) {
+                    mcpListTools.validate()
+                }
+
+                override fun visitMcpApprovalRequest(mcpApprovalRequest: McpApprovalRequest) {
+                    mcpApprovalRequest.validate()
+                }
+
+                override fun visitMcpApprovalResponse(mcpApprovalResponse: McpApprovalResponse) {
+                    mcpApprovalResponse.validate()
+                }
+
+                override fun visitCustomToolCall(customToolCall: BetaResponseCustomToolCall) {
+                    customToolCall.validate()
+                }
+
+                override fun visitCustomToolCallOutput(
+                    customToolCallOutput: BetaResponseCustomToolCallOutputItem
+                ) {
+                    customToolCallOutput.validate()
+                }
+            }
+        )
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        accept(
+            object : Visitor<Int> {
+                override fun visitMessage(message: BetaResponseOutputMessage) = message.validity()
+
+                override fun visitFileSearchCall(fileSearchCall: BetaResponseFileSearchToolCall) =
+                    fileSearchCall.validity()
+
+                override fun visitFunctionCall(functionCall: BetaResponseFunctionToolCall) =
+                    functionCall.validity()
+
+                override fun visitFunctionCallOutput(
+                    functionCallOutput: BetaResponseFunctionToolCallOutputItem
+                ) = functionCallOutput.validity()
+
+                override fun visitAgentMessage(agentMessage: AgentMessage) = agentMessage.validity()
+
+                override fun visitMultiAgentCall(multiAgentCall: MultiAgentCall) =
+                    multiAgentCall.validity()
+
+                override fun visitMultiAgentCallOutput(multiAgentCallOutput: MultiAgentCallOutput) =
+                    multiAgentCallOutput.validity()
+
+                override fun visitWebSearchCall(webSearchCall: BetaResponseFunctionWebSearch) =
+                    webSearchCall.validity()
+
+                override fun visitComputerCall(computerCall: BetaResponseComputerToolCall) =
+                    computerCall.validity()
+
+                override fun visitComputerCallOutput(
+                    computerCallOutput: BetaResponseComputerToolCallOutputItem
+                ) = computerCallOutput.validity()
+
+                override fun visitReasoning(reasoning: BetaResponseReasoningItem) =
+                    reasoning.validity()
+
+                override fun visitProgram(program: Program) = program.validity()
+
+                override fun visitProgramOutput(programOutput: ProgramOutput) =
+                    programOutput.validity()
+
+                override fun visitToolSearchCall(toolSearchCall: BetaResponseToolSearchCall) =
+                    toolSearchCall.validity()
+
+                override fun visitToolSearchOutput(
+                    toolSearchOutput: BetaResponseToolSearchOutputItem
+                ) = toolSearchOutput.validity()
+
+                override fun visitAdditionalTools(additionalTools: AdditionalTools) =
+                    additionalTools.validity()
+
+                override fun visitCompaction(compaction: BetaResponseCompactionItem) =
+                    compaction.validity()
+
+                override fun visitImageGenerationCall(imageGenerationCall: ImageGenerationCall) =
+                    imageGenerationCall.validity()
+
+                override fun visitCodeInterpreterCall(
+                    codeInterpreterCall: BetaResponseCodeInterpreterToolCall
+                ) = codeInterpreterCall.validity()
+
+                override fun visitLocalShellCall(localShellCall: LocalShellCall) =
+                    localShellCall.validity()
+
+                override fun visitLocalShellCallOutput(localShellCallOutput: LocalShellCallOutput) =
+                    localShellCallOutput.validity()
+
+                override fun visitShellCall(shellCall: BetaResponseFunctionShellToolCall) =
+                    shellCall.validity()
+
+                override fun visitShellCallOutput(
+                    shellCallOutput: BetaResponseFunctionShellToolCallOutput
+                ) = shellCallOutput.validity()
+
+                override fun visitApplyPatchCall(applyPatchCall: BetaResponseApplyPatchToolCall) =
+                    applyPatchCall.validity()
+
+                override fun visitApplyPatchCallOutput(
+                    applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput
+                ) = applyPatchCallOutput.validity()
+
+                override fun visitMcpCall(mcpCall: McpCall) = mcpCall.validity()
+
+                override fun visitMcpListTools(mcpListTools: McpListTools) = mcpListTools.validity()
+
+                override fun visitMcpApprovalRequest(mcpApprovalRequest: McpApprovalRequest) =
+                    mcpApprovalRequest.validity()
+
+                override fun visitMcpApprovalResponse(mcpApprovalResponse: McpApprovalResponse) =
+                    mcpApprovalResponse.validity()
+
+                override fun visitCustomToolCall(customToolCall: BetaResponseCustomToolCall) =
+                    customToolCall.validity()
+
+                override fun visitCustomToolCallOutput(
+                    customToolCallOutput: BetaResponseCustomToolCallOutputItem
+                ) = customToolCallOutput.validity()
+
+                override fun unknown(json: JsonValue?) = 0
+            }
+        )
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseOutputItem &&
+            message == other.message &&
+            fileSearchCall == other.fileSearchCall &&
+            functionCall == other.functionCall &&
+            functionCallOutput == other.functionCallOutput &&
+            agentMessage == other.agentMessage &&
+            multiAgentCall == other.multiAgentCall &&
+            multiAgentCallOutput == other.multiAgentCallOutput &&
+            webSearchCall == other.webSearchCall &&
+            computerCall == other.computerCall &&
+            computerCallOutput == other.computerCallOutput &&
+            reasoning == other.reasoning &&
+            program == other.program &&
+            programOutput == other.programOutput &&
+            toolSearchCall == other.toolSearchCall &&
+            toolSearchOutput == other.toolSearchOutput &&
+            additionalTools == other.additionalTools &&
+            compaction == other.compaction &&
+            imageGenerationCall == other.imageGenerationCall &&
+            codeInterpreterCall == other.codeInterpreterCall &&
+            localShellCall == other.localShellCall &&
+            localShellCallOutput == other.localShellCallOutput &&
+            shellCall == other.shellCall &&
+            shellCallOutput == other.shellCallOutput &&
+            applyPatchCall == other.applyPatchCall &&
+            applyPatchCallOutput == other.applyPatchCallOutput &&
+            mcpCall == other.mcpCall &&
+            mcpListTools == other.mcpListTools &&
+            mcpApprovalRequest == other.mcpApprovalRequest &&
+            mcpApprovalResponse == other.mcpApprovalResponse &&
+            customToolCall == other.customToolCall &&
+            customToolCallOutput == other.customToolCallOutput
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(
+            message,
+            fileSearchCall,
+            functionCall,
+            functionCallOutput,
+            agentMessage,
+            multiAgentCall,
+            multiAgentCallOutput,
+            webSearchCall,
+            computerCall,
+            computerCallOutput,
+            reasoning,
+            program,
+            programOutput,
+            toolSearchCall,
+            toolSearchOutput,
+            additionalTools,
+            compaction,
+            imageGenerationCall,
+            codeInterpreterCall,
+            localShellCall,
+            localShellCallOutput,
+            shellCall,
+            shellCallOutput,
+            applyPatchCall,
+            applyPatchCallOutput,
+            mcpCall,
+            mcpListTools,
+            mcpApprovalRequest,
+            mcpApprovalResponse,
+            customToolCall,
+            customToolCallOutput,
+        )
+
+    override fun toString(): String =
+        when {
+            message != null -> "BetaResponseOutputItem{message=$message}"
+            fileSearchCall != null -> "BetaResponseOutputItem{fileSearchCall=$fileSearchCall}"
+            functionCall != null -> "BetaResponseOutputItem{functionCall=$functionCall}"
+            functionCallOutput != null ->
+                "BetaResponseOutputItem{functionCallOutput=$functionCallOutput}"
+            agentMessage != null -> "BetaResponseOutputItem{agentMessage=$agentMessage}"
+            multiAgentCall != null -> "BetaResponseOutputItem{multiAgentCall=$multiAgentCall}"
+            multiAgentCallOutput != null ->
+                "BetaResponseOutputItem{multiAgentCallOutput=$multiAgentCallOutput}"
+            webSearchCall != null -> "BetaResponseOutputItem{webSearchCall=$webSearchCall}"
+            computerCall != null -> "BetaResponseOutputItem{computerCall=$computerCall}"
+            computerCallOutput != null ->
+                "BetaResponseOutputItem{computerCallOutput=$computerCallOutput}"
+            reasoning != null -> "BetaResponseOutputItem{reasoning=$reasoning}"
+            program != null -> "BetaResponseOutputItem{program=$program}"
+            programOutput != null -> "BetaResponseOutputItem{programOutput=$programOutput}"
+            toolSearchCall != null -> "BetaResponseOutputItem{toolSearchCall=$toolSearchCall}"
+            toolSearchOutput != null -> "BetaResponseOutputItem{toolSearchOutput=$toolSearchOutput}"
+            additionalTools != null -> "BetaResponseOutputItem{additionalTools=$additionalTools}"
+            compaction != null -> "BetaResponseOutputItem{compaction=$compaction}"
+            imageGenerationCall != null ->
+                "BetaResponseOutputItem{imageGenerationCall=$imageGenerationCall}"
+            codeInterpreterCall != null ->
+                "BetaResponseOutputItem{codeInterpreterCall=$codeInterpreterCall}"
+            localShellCall != null -> "BetaResponseOutputItem{localShellCall=$localShellCall}"
+            localShellCallOutput != null ->
+                "BetaResponseOutputItem{localShellCallOutput=$localShellCallOutput}"
+            shellCall != null -> "BetaResponseOutputItem{shellCall=$shellCall}"
+            shellCallOutput != null -> "BetaResponseOutputItem{shellCallOutput=$shellCallOutput}"
+            applyPatchCall != null -> "BetaResponseOutputItem{applyPatchCall=$applyPatchCall}"
+            applyPatchCallOutput != null ->
+                "BetaResponseOutputItem{applyPatchCallOutput=$applyPatchCallOutput}"
+            mcpCall != null -> "BetaResponseOutputItem{mcpCall=$mcpCall}"
+            mcpListTools != null -> "BetaResponseOutputItem{mcpListTools=$mcpListTools}"
+            mcpApprovalRequest != null ->
+                "BetaResponseOutputItem{mcpApprovalRequest=$mcpApprovalRequest}"
+            mcpApprovalResponse != null ->
+                "BetaResponseOutputItem{mcpApprovalResponse=$mcpApprovalResponse}"
+            customToolCall != null -> "BetaResponseOutputItem{customToolCall=$customToolCall}"
+            customToolCallOutput != null ->
+                "BetaResponseOutputItem{customToolCallOutput=$customToolCallOutput}"
+            _json != null -> "BetaResponseOutputItem{_unknown=$_json}"
+            else -> throw IllegalStateException("Invalid BetaResponseOutputItem")
+        }
+
+    companion object {
+
+        /** An output message from the model. */
+        @JvmStatic
+        fun ofMessage(message: BetaResponseOutputMessage) =
+            BetaResponseOutputItem(message = message)
+
+        /**
+         * The results of a file search tool call. See the
+         * [file search guide](https://platform.openai.com/docs/guides/tools-file-search) for more
+         * information.
+         */
+        @JvmStatic
+        fun ofFileSearchCall(fileSearchCall: BetaResponseFileSearchToolCall) =
+            BetaResponseOutputItem(fileSearchCall = fileSearchCall)
+
+        /**
+         * A tool call to run a function. See the
+         * [function calling guide](https://platform.openai.com/docs/guides/function-calling) for
+         * more information.
+         */
+        @JvmStatic
+        fun ofFunctionCall(functionCall: BetaResponseFunctionToolCall) =
+            BetaResponseOutputItem(functionCall = functionCall)
+
+        @JvmStatic
+        fun ofFunctionCallOutput(functionCallOutput: BetaResponseFunctionToolCallOutputItem) =
+            BetaResponseOutputItem(functionCallOutput = functionCallOutput)
+
+        @JvmStatic
+        fun ofAgentMessage(agentMessage: AgentMessage) =
+            BetaResponseOutputItem(agentMessage = agentMessage)
+
+        @JvmStatic
+        fun ofMultiAgentCall(multiAgentCall: MultiAgentCall) =
+            BetaResponseOutputItem(multiAgentCall = multiAgentCall)
+
+        @JvmStatic
+        fun ofMultiAgentCallOutput(multiAgentCallOutput: MultiAgentCallOutput) =
+            BetaResponseOutputItem(multiAgentCallOutput = multiAgentCallOutput)
+
+        /**
+         * The results of a web search tool call. See the
+         * [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more
+         * information.
+         */
+        @JvmStatic
+        fun ofWebSearchCall(webSearchCall: BetaResponseFunctionWebSearch) =
+            BetaResponseOutputItem(webSearchCall = webSearchCall)
+
+        /**
+         * A tool call to a computer use tool. See the
+         * [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more
+         * information.
+         */
+        @JvmStatic
+        fun ofComputerCall(computerCall: BetaResponseComputerToolCall) =
+            BetaResponseOutputItem(computerCall = computerCall)
+
+        @JvmStatic
+        fun ofComputerCallOutput(computerCallOutput: BetaResponseComputerToolCallOutputItem) =
+            BetaResponseOutputItem(computerCallOutput = computerCallOutput)
+
+        /**
+         * A description of the chain of thought used by a reasoning model while generating a
+         * response. Be sure to include these items in your `input` to the Responses API for
+         * subsequent turns of a conversation if you are manually
+         * [managing context](https://platform.openai.com/docs/guides/conversation-state).
+         */
+        @JvmStatic
+        fun ofReasoning(reasoning: BetaResponseReasoningItem) =
+            BetaResponseOutputItem(reasoning = reasoning)
+
+        @JvmStatic fun ofProgram(program: Program) = BetaResponseOutputItem(program = program)
+
+        @JvmStatic
+        fun ofProgramOutput(programOutput: ProgramOutput) =
+            BetaResponseOutputItem(programOutput = programOutput)
+
+        @JvmStatic
+        fun ofToolSearchCall(toolSearchCall: BetaResponseToolSearchCall) =
+            BetaResponseOutputItem(toolSearchCall = toolSearchCall)
+
+        @JvmStatic
+        fun ofToolSearchOutput(toolSearchOutput: BetaResponseToolSearchOutputItem) =
+            BetaResponseOutputItem(toolSearchOutput = toolSearchOutput)
+
+        @JvmStatic
+        fun ofAdditionalTools(additionalTools: AdditionalTools) =
+            BetaResponseOutputItem(additionalTools = additionalTools)
+
+        /**
+         * A compaction item generated by the
+         * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+         */
+        @JvmStatic
+        fun ofCompaction(compaction: BetaResponseCompactionItem) =
+            BetaResponseOutputItem(compaction = compaction)
+
+        /** An image generation request made by the model. */
+        @JvmStatic
+        fun ofImageGenerationCall(imageGenerationCall: ImageGenerationCall) =
+            BetaResponseOutputItem(imageGenerationCall = imageGenerationCall)
+
+        /** A tool call to run code. */
+        @JvmStatic
+        fun ofCodeInterpreterCall(codeInterpreterCall: BetaResponseCodeInterpreterToolCall) =
+            BetaResponseOutputItem(codeInterpreterCall = codeInterpreterCall)
+
+        /** A tool call to run a command on the local shell. */
+        @JvmStatic
+        fun ofLocalShellCall(localShellCall: LocalShellCall) =
+            BetaResponseOutputItem(localShellCall = localShellCall)
+
+        /** The output of a local shell tool call. */
+        @JvmStatic
+        fun ofLocalShellCallOutput(localShellCallOutput: LocalShellCallOutput) =
+            BetaResponseOutputItem(localShellCallOutput = localShellCallOutput)
+
+        /** A tool call that executes one or more shell commands in a managed environment. */
+        @JvmStatic
+        fun ofShellCall(shellCall: BetaResponseFunctionShellToolCall) =
+            BetaResponseOutputItem(shellCall = shellCall)
+
+        /** The output of a shell tool call that was emitted. */
+        @JvmStatic
+        fun ofShellCallOutput(shellCallOutput: BetaResponseFunctionShellToolCallOutput) =
+            BetaResponseOutputItem(shellCallOutput = shellCallOutput)
+
+        /** A tool call that applies file diffs by creating, deleting, or updating files. */
+        @JvmStatic
+        fun ofApplyPatchCall(applyPatchCall: BetaResponseApplyPatchToolCall) =
+            BetaResponseOutputItem(applyPatchCall = applyPatchCall)
+
+        /** The output emitted by an apply patch tool call. */
+        @JvmStatic
+        fun ofApplyPatchCallOutput(applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput) =
+            BetaResponseOutputItem(applyPatchCallOutput = applyPatchCallOutput)
+
+        /** An invocation of a tool on an MCP server. */
+        @JvmStatic fun ofMcpCall(mcpCall: McpCall) = BetaResponseOutputItem(mcpCall = mcpCall)
+
+        /** A list of tools available on an MCP server. */
+        @JvmStatic
+        fun ofMcpListTools(mcpListTools: McpListTools) =
+            BetaResponseOutputItem(mcpListTools = mcpListTools)
+
+        /** A request for human approval of a tool invocation. */
+        @JvmStatic
+        fun ofMcpApprovalRequest(mcpApprovalRequest: McpApprovalRequest) =
+            BetaResponseOutputItem(mcpApprovalRequest = mcpApprovalRequest)
+
+        /** A response to an MCP approval request. */
+        @JvmStatic
+        fun ofMcpApprovalResponse(mcpApprovalResponse: McpApprovalResponse) =
+            BetaResponseOutputItem(mcpApprovalResponse = mcpApprovalResponse)
+
+        /** A call to a custom tool created by the model. */
+        @JvmStatic
+        fun ofCustomToolCall(customToolCall: BetaResponseCustomToolCall) =
+            BetaResponseOutputItem(customToolCall = customToolCall)
+
+        /** The output of a custom tool call from your code, being sent back to the model. */
+        @JvmStatic
+        fun ofCustomToolCallOutput(customToolCallOutput: BetaResponseCustomToolCallOutputItem) =
+            BetaResponseOutputItem(customToolCallOutput = customToolCallOutput)
+    }
+
+    /**
+     * An interface that defines how to map each variant of [BetaResponseOutputItem] to a value of
+     * type [T].
+     */
+    interface Visitor<out T> {
+
+        /** An output message from the model. */
+        fun visitMessage(message: BetaResponseOutputMessage): T
+
+        /**
+         * The results of a file search tool call. See the
+         * [file search guide](https://platform.openai.com/docs/guides/tools-file-search) for more
+         * information.
+         */
+        fun visitFileSearchCall(fileSearchCall: BetaResponseFileSearchToolCall): T
+
+        /**
+         * A tool call to run a function. See the
+         * [function calling guide](https://platform.openai.com/docs/guides/function-calling) for
+         * more information.
+         */
+        fun visitFunctionCall(functionCall: BetaResponseFunctionToolCall): T
+
+        fun visitFunctionCallOutput(functionCallOutput: BetaResponseFunctionToolCallOutputItem): T
+
+        fun visitAgentMessage(agentMessage: AgentMessage): T
+
+        fun visitMultiAgentCall(multiAgentCall: MultiAgentCall): T
+
+        fun visitMultiAgentCallOutput(multiAgentCallOutput: MultiAgentCallOutput): T
+
+        /**
+         * The results of a web search tool call. See the
+         * [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for more
+         * information.
+         */
+        fun visitWebSearchCall(webSearchCall: BetaResponseFunctionWebSearch): T
+
+        /**
+         * A tool call to a computer use tool. See the
+         * [computer use guide](https://platform.openai.com/docs/guides/tools-computer-use) for more
+         * information.
+         */
+        fun visitComputerCall(computerCall: BetaResponseComputerToolCall): T
+
+        fun visitComputerCallOutput(computerCallOutput: BetaResponseComputerToolCallOutputItem): T
+
+        /**
+         * A description of the chain of thought used by a reasoning model while generating a
+         * response. Be sure to include these items in your `input` to the Responses API for
+         * subsequent turns of a conversation if you are manually
+         * [managing context](https://platform.openai.com/docs/guides/conversation-state).
+         */
+        fun visitReasoning(reasoning: BetaResponseReasoningItem): T
+
+        fun visitProgram(program: Program): T
+
+        fun visitProgramOutput(programOutput: ProgramOutput): T
+
+        fun visitToolSearchCall(toolSearchCall: BetaResponseToolSearchCall): T
+
+        fun visitToolSearchOutput(toolSearchOutput: BetaResponseToolSearchOutputItem): T
+
+        fun visitAdditionalTools(additionalTools: AdditionalTools): T
+
+        /**
+         * A compaction item generated by the
+         * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
+         */
+        fun visitCompaction(compaction: BetaResponseCompactionItem): T
+
+        /** An image generation request made by the model. */
+        fun visitImageGenerationCall(imageGenerationCall: ImageGenerationCall): T
+
+        /** A tool call to run code. */
+        fun visitCodeInterpreterCall(codeInterpreterCall: BetaResponseCodeInterpreterToolCall): T
+
+        /** A tool call to run a command on the local shell. */
+        fun visitLocalShellCall(localShellCall: LocalShellCall): T
+
+        /** The output of a local shell tool call. */
+        fun visitLocalShellCallOutput(localShellCallOutput: LocalShellCallOutput): T
+
+        /** A tool call that executes one or more shell commands in a managed environment. */
+        fun visitShellCall(shellCall: BetaResponseFunctionShellToolCall): T
+
+        /** The output of a shell tool call that was emitted. */
+        fun visitShellCallOutput(shellCallOutput: BetaResponseFunctionShellToolCallOutput): T
+
+        /** A tool call that applies file diffs by creating, deleting, or updating files. */
+        fun visitApplyPatchCall(applyPatchCall: BetaResponseApplyPatchToolCall): T
+
+        /** The output emitted by an apply patch tool call. */
+        fun visitApplyPatchCallOutput(applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput): T
+
+        /** An invocation of a tool on an MCP server. */
+        fun visitMcpCall(mcpCall: McpCall): T
+
+        /** A list of tools available on an MCP server. */
+        fun visitMcpListTools(mcpListTools: McpListTools): T
+
+        /** A request for human approval of a tool invocation. */
+        fun visitMcpApprovalRequest(mcpApprovalRequest: McpApprovalRequest): T
+
+        /** A response to an MCP approval request. */
+        fun visitMcpApprovalResponse(mcpApprovalResponse: McpApprovalResponse): T
+
+        /** A call to a custom tool created by the model. */
+        fun visitCustomToolCall(customToolCall: BetaResponseCustomToolCall): T
+
+        /** The output of a custom tool call from your code, being sent back to the model. */
+        fun visitCustomToolCallOutput(customToolCallOutput: BetaResponseCustomToolCallOutputItem): T
+
+        /**
+         * Maps an unknown variant of [BetaResponseOutputItem] to a value of type [T].
+         *
+         * An instance of [BetaResponseOutputItem] can contain an unknown variant if it was
+         * deserialized from data that doesn't match any known variant. For example, if the SDK is
+         * on an older version than the API, then the API may respond with new variants that the SDK
+         * is unaware of.
+         *
+         * @throws OpenAIInvalidDataException in the default implementation.
+         */
+        fun unknown(json: JsonValue?): T {
+            throw OpenAIInvalidDataException("Unknown BetaResponseOutputItem: $json")
+        }
+    }
+
+    internal class Deserializer :
+        BaseDeserializer<BetaResponseOutputItem>(BetaResponseOutputItem::class) {
+
+        override fun ObjectCodec.deserialize(node: JsonNode): BetaResponseOutputItem {
+            val json = JsonValue.fromJsonNode(node)
+            val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+            when (type) {
+                "message" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseOutputMessage>())?.let {
+                        BetaResponseOutputItem(message = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "file_search_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseFileSearchToolCall>())
+                        ?.let { BetaResponseOutputItem(fileSearchCall = it, _json = json) }
+                        ?: BetaResponseOutputItem(_json = json)
+                }
+                "function_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseFunctionToolCall>())
+                        ?.let { BetaResponseOutputItem(functionCall = it, _json = json) }
+                        ?: BetaResponseOutputItem(_json = json)
+                }
+                "function_call_output" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseFunctionToolCallOutputItem>(),
+                        )
+                        ?.let { BetaResponseOutputItem(functionCallOutput = it, _json = json) }
+                        ?: BetaResponseOutputItem(_json = json)
+                }
+                "agent_message" -> {
+                    return tryDeserialize(node, jacksonTypeRef<AgentMessage>())?.let {
+                        BetaResponseOutputItem(agentMessage = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "multi_agent_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<MultiAgentCall>())?.let {
+                        BetaResponseOutputItem(multiAgentCall = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "multi_agent_call_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<MultiAgentCallOutput>())?.let {
+                        BetaResponseOutputItem(multiAgentCallOutput = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "web_search_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseFunctionWebSearch>())
+                        ?.let { BetaResponseOutputItem(webSearchCall = it, _json = json) }
+                        ?: BetaResponseOutputItem(_json = json)
+                }
+                "computer_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseComputerToolCall>())
+                        ?.let { BetaResponseOutputItem(computerCall = it, _json = json) }
+                        ?: BetaResponseOutputItem(_json = json)
+                }
+                "computer_call_output" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseComputerToolCallOutputItem>(),
+                        )
+                        ?.let { BetaResponseOutputItem(computerCallOutput = it, _json = json) }
+                        ?: BetaResponseOutputItem(_json = json)
+                }
+                "reasoning" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseReasoningItem>())?.let {
+                        BetaResponseOutputItem(reasoning = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "program" -> {
+                    return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                        BetaResponseOutputItem(program = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "program_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ProgramOutput>())?.let {
+                        BetaResponseOutputItem(programOutput = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "tool_search_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseToolSearchCall>())?.let {
+                        BetaResponseOutputItem(toolSearchCall = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "tool_search_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseToolSearchOutputItem>())
+                        ?.let { BetaResponseOutputItem(toolSearchOutput = it, _json = json) }
+                        ?: BetaResponseOutputItem(_json = json)
+                }
+                "additional_tools" -> {
+                    return tryDeserialize(node, jacksonTypeRef<AdditionalTools>())?.let {
+                        BetaResponseOutputItem(additionalTools = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "compaction" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseCompactionItem>())?.let {
+                        BetaResponseOutputItem(compaction = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "image_generation_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ImageGenerationCall>())?.let {
+                        BetaResponseOutputItem(imageGenerationCall = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "code_interpreter_call" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCodeInterpreterToolCall>(),
+                        )
+                        ?.let { BetaResponseOutputItem(codeInterpreterCall = it, _json = json) }
+                        ?: BetaResponseOutputItem(_json = json)
+                }
+                "local_shell_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<LocalShellCall>())?.let {
+                        BetaResponseOutputItem(localShellCall = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "local_shell_call_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<LocalShellCallOutput>())?.let {
+                        BetaResponseOutputItem(localShellCallOutput = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "shell_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseFunctionShellToolCall>())
+                        ?.let { BetaResponseOutputItem(shellCall = it, _json = json) }
+                        ?: BetaResponseOutputItem(_json = json)
+                }
+                "shell_call_output" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseFunctionShellToolCallOutput>(),
+                        )
+                        ?.let { BetaResponseOutputItem(shellCallOutput = it, _json = json) }
+                        ?: BetaResponseOutputItem(_json = json)
+                }
+                "apply_patch_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseApplyPatchToolCall>())
+                        ?.let { BetaResponseOutputItem(applyPatchCall = it, _json = json) }
+                        ?: BetaResponseOutputItem(_json = json)
+                }
+                "apply_patch_call_output" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseApplyPatchToolCallOutput>(),
+                        )
+                        ?.let { BetaResponseOutputItem(applyPatchCallOutput = it, _json = json) }
+                        ?: BetaResponseOutputItem(_json = json)
+                }
+                "mcp_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<McpCall>())?.let {
+                        BetaResponseOutputItem(mcpCall = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "mcp_list_tools" -> {
+                    return tryDeserialize(node, jacksonTypeRef<McpListTools>())?.let {
+                        BetaResponseOutputItem(mcpListTools = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "mcp_approval_request" -> {
+                    return tryDeserialize(node, jacksonTypeRef<McpApprovalRequest>())?.let {
+                        BetaResponseOutputItem(mcpApprovalRequest = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "mcp_approval_response" -> {
+                    return tryDeserialize(node, jacksonTypeRef<McpApprovalResponse>())?.let {
+                        BetaResponseOutputItem(mcpApprovalResponse = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "custom_tool_call" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseCustomToolCall>())?.let {
+                        BetaResponseOutputItem(customToolCall = it, _json = json)
+                    } ?: BetaResponseOutputItem(_json = json)
+                }
+                "custom_tool_call_output" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCustomToolCallOutputItem>(),
+                        )
+                        ?.let { BetaResponseOutputItem(customToolCallOutput = it, _json = json) }
+                        ?: BetaResponseOutputItem(_json = json)
+                }
+            }
+
+            return BetaResponseOutputItem(_json = json)
+        }
+    }
+
+    internal class Serializer :
+        BaseSerializer<BetaResponseOutputItem>(BetaResponseOutputItem::class) {
+
+        override fun serialize(
+            value: BetaResponseOutputItem,
+            generator: JsonGenerator,
+            provider: SerializerProvider,
+        ) {
+            when {
+                value.message != null -> generator.writeObject(value.message)
+                value.fileSearchCall != null -> generator.writeObject(value.fileSearchCall)
+                value.functionCall != null -> generator.writeObject(value.functionCall)
+                value.functionCallOutput != null -> generator.writeObject(value.functionCallOutput)
+                value.agentMessage != null -> generator.writeObject(value.agentMessage)
+                value.multiAgentCall != null -> generator.writeObject(value.multiAgentCall)
+                value.multiAgentCallOutput != null ->
+                    generator.writeObject(value.multiAgentCallOutput)
+                value.webSearchCall != null -> generator.writeObject(value.webSearchCall)
+                value.computerCall != null -> generator.writeObject(value.computerCall)
+                value.computerCallOutput != null -> generator.writeObject(value.computerCallOutput)
+                value.reasoning != null -> generator.writeObject(value.reasoning)
+                value.program != null -> generator.writeObject(value.program)
+                value.programOutput != null -> generator.writeObject(value.programOutput)
+                value.toolSearchCall != null -> generator.writeObject(value.toolSearchCall)
+                value.toolSearchOutput != null -> generator.writeObject(value.toolSearchOutput)
+                value.additionalTools != null -> generator.writeObject(value.additionalTools)
+                value.compaction != null -> generator.writeObject(value.compaction)
+                value.imageGenerationCall != null ->
+                    generator.writeObject(value.imageGenerationCall)
+                value.codeInterpreterCall != null ->
+                    generator.writeObject(value.codeInterpreterCall)
+                value.localShellCall != null -> generator.writeObject(value.localShellCall)
+                value.localShellCallOutput != null ->
+                    generator.writeObject(value.localShellCallOutput)
+                value.shellCall != null -> generator.writeObject(value.shellCall)
+                value.shellCallOutput != null -> generator.writeObject(value.shellCallOutput)
+                value.applyPatchCall != null -> generator.writeObject(value.applyPatchCall)
+                value.applyPatchCallOutput != null ->
+                    generator.writeObject(value.applyPatchCallOutput)
+                value.mcpCall != null -> generator.writeObject(value.mcpCall)
+                value.mcpListTools != null -> generator.writeObject(value.mcpListTools)
+                value.mcpApprovalRequest != null -> generator.writeObject(value.mcpApprovalRequest)
+                value.mcpApprovalResponse != null ->
+                    generator.writeObject(value.mcpApprovalResponse)
+                value.customToolCall != null -> generator.writeObject(value.customToolCall)
+                value.customToolCallOutput != null ->
+                    generator.writeObject(value.customToolCallOutput)
+                value._json != null -> generator.writeObject(value._json)
+                else -> throw IllegalStateException("Invalid BetaResponseOutputItem")
+            }
+        }
+    }
+
+    class AgentMessage
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val author: JsonField<String>,
+        private val content: JsonField<List<Content>>,
+        private val recipient: JsonField<String>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("author") @ExcludeMissing author: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("content")
+            @ExcludeMissing
+            content: JsonField<List<Content>> = JsonMissing.of(),
+            @JsonProperty("recipient")
+            @ExcludeMissing
+            recipient: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, author, content, recipient, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the agent message.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The sending agent identity.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun author(): String = author.getRequired("author")
+
+        /**
+         * Encrypted content sent between agents.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun content(): List<Content> = content.getRequired("content")
+
+        /**
+         * The destination agent identity.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun recipient(): String = recipient.getRequired("recipient")
+
+        /**
+         * The type of the item. Always `agent_message`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("agent_message")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [author].
+         *
+         * Unlike [author], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("author") @ExcludeMissing fun _author(): JsonField<String> = author
+
+        /**
+         * Returns the raw JSON value of [content].
+         *
+         * Unlike [content], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("content") @ExcludeMissing fun _content(): JsonField<List<Content>> = content
+
+        /**
+         * Returns the raw JSON value of [recipient].
+         *
+         * Unlike [recipient], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("recipient") @ExcludeMissing fun _recipient(): JsonField<String> = recipient
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [AgentMessage].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .author()
+             * .content()
+             * .recipient()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [AgentMessage]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var author: JsonField<String>? = null
+            private var content: JsonField<MutableList<Content>>? = null
+            private var recipient: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("agent_message")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agentMessage: AgentMessage) = apply {
+                id = agentMessage.id
+                author = agentMessage.author
+                content = agentMessage.content.map { it.toMutableList() }
+                recipient = agentMessage.recipient
+                type = agentMessage.type
+                agent = agentMessage.agent
+                additionalProperties = agentMessage.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the agent message. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The sending agent identity. */
+            fun author(author: String) = author(JsonField.of(author))
+
+            /**
+             * Sets [Builder.author] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.author] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun author(author: JsonField<String>) = apply { this.author = author }
+
+            /** Encrypted content sent between agents. */
+            fun content(content: List<Content>) = content(JsonField.of(content))
+
+            /**
+             * Sets [Builder.content] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.content] with a well-typed `List<Content>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun content(content: JsonField<List<Content>>) = apply {
+                this.content = content.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [Content] to [Builder.content].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addContent(content: Content) = apply {
+                this.content =
+                    (this.content ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("content", it).add(content)
+                    }
+            }
+
+            /** Alias for calling [addContent] with `Content.ofInputText(inputText)`. */
+            fun addContent(inputText: BetaResponseInputText) =
+                addContent(Content.ofInputText(inputText))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * BetaResponseInputText.builder()
+             *     .text(text)
+             *     .build()
+             * ```
+             */
+            fun addInputTextContent(text: String) =
+                addContent(BetaResponseInputText.builder().text(text).build())
+
+            /** Alias for calling [addContent] with `Content.ofOutputText(outputText)`. */
+            fun addContent(outputText: BetaResponseOutputText) =
+                addContent(Content.ofOutputText(outputText))
+
+            /** Alias for calling [addContent] with `Content.ofText(text)`. */
+            fun addContent(text: Content.Text) = addContent(Content.ofText(text))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * Content.Text.builder()
+             *     .text(text)
+             *     .build()
+             * ```
+             */
+            fun addTextContent(text: String) = addContent(Content.Text.builder().text(text).build())
+
+            /** Alias for calling [addContent] with `Content.ofSummaryText(summaryText)`. */
+            fun addContent(summaryText: Content.SummaryText) =
+                addContent(Content.ofSummaryText(summaryText))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * Content.SummaryText.builder()
+             *     .text(text)
+             *     .build()
+             * ```
+             */
+            fun addSummaryTextContent(text: String) =
+                addContent(Content.SummaryText.builder().text(text).build())
+
+            /** Alias for calling [addContent] with `Content.ofReasoningText(reasoningText)`. */
+            fun addContent(reasoningText: Content.ReasoningText) =
+                addContent(Content.ofReasoningText(reasoningText))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * Content.ReasoningText.builder()
+             *     .text(text)
+             *     .build()
+             * ```
+             */
+            fun addReasoningTextContent(text: String) =
+                addContent(Content.ReasoningText.builder().text(text).build())
+
+            /** Alias for calling [addContent] with `Content.ofRefusal(refusal)`. */
+            fun addContent(refusal: BetaResponseOutputRefusal) =
+                addContent(Content.ofRefusal(refusal))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * BetaResponseOutputRefusal.builder()
+             *     .refusal(refusal)
+             *     .build()
+             * ```
+             */
+            fun addRefusalContent(refusal: String) =
+                addContent(BetaResponseOutputRefusal.builder().refusal(refusal).build())
+
+            /** Alias for calling [addContent] with `Content.ofInputImage(inputImage)`. */
+            fun addContent(inputImage: BetaResponseInputImage) =
+                addContent(Content.ofInputImage(inputImage))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * BetaResponseInputImage.builder()
+             *     .detail(detail)
+             *     .build()
+             * ```
+             */
+            fun addInputImageContent(detail: BetaResponseInputImage.Detail) =
+                addContent(BetaResponseInputImage.builder().detail(detail).build())
+
+            /**
+             * Alias for calling [addContent] with
+             * `Content.ofComputerScreenshot(computerScreenshot)`.
+             */
+            fun addContent(computerScreenshot: Content.ComputerScreenshot) =
+                addContent(Content.ofComputerScreenshot(computerScreenshot))
+
+            /** Alias for calling [addContent] with `Content.ofInputFile(inputFile)`. */
+            fun addContent(inputFile: BetaResponseInputFile) =
+                addContent(Content.ofInputFile(inputFile))
+
+            /** Alias for calling [addContent] with `Content.ofEncrypted(encrypted)`. */
+            fun addContent(encrypted: Content.EncryptedContent) =
+                addContent(Content.ofEncrypted(encrypted))
+
+            /**
+             * Alias for calling [addContent] with the following:
+             * ```java
+             * Content.EncryptedContent.builder()
+             *     .encryptedContent(encryptedContent)
+             *     .build()
+             * ```
+             */
+            fun addEncryptedContent(encryptedContent: String) =
+                addContent(
+                    Content.EncryptedContent.builder().encryptedContent(encryptedContent).build()
+                )
+
+            /** The destination agent identity. */
+            fun recipient(recipient: String) = recipient(JsonField.of(recipient))
+
+            /**
+             * Sets [Builder.recipient] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.recipient] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun recipient(recipient: JsonField<String>) = apply { this.recipient = recipient }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("agent_message")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [AgentMessage].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .author()
+             * .content()
+             * .recipient()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): AgentMessage =
+                AgentMessage(
+                    checkRequired("id", id),
+                    checkRequired("author", author),
+                    checkRequired("content", content).map { it.toImmutable() },
+                    checkRequired("recipient", recipient),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): AgentMessage = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            author()
+            content().forEach { it.validate() }
+            recipient()
+            _type().let {
+                if (it != JsonValue.from("agent_message")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (author.asKnown().isPresent) 1 else 0) +
+                (content.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (if (recipient.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("agent_message")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** A content part that makes up an input or output item. */
+        @JsonDeserialize(using = Content.Deserializer::class)
+        @JsonSerialize(using = Content.Serializer::class)
+        class Content
+        private constructor(
+            private val inputText: BetaResponseInputText? = null,
+            private val outputText: BetaResponseOutputText? = null,
+            private val text: Text? = null,
+            private val summaryText: SummaryText? = null,
+            private val reasoningText: ReasoningText? = null,
+            private val refusal: BetaResponseOutputRefusal? = null,
+            private val inputImage: BetaResponseInputImage? = null,
+            private val computerScreenshot: ComputerScreenshot? = null,
+            private val inputFile: BetaResponseInputFile? = null,
+            private val encrypted: EncryptedContent? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /** A text input to the model. */
+            fun inputText(): Optional<BetaResponseInputText> = Optional.ofNullable(inputText)
+
+            /** A text output from the model. */
+            fun outputText(): Optional<BetaResponseOutputText> = Optional.ofNullable(outputText)
+
+            /** A text content. */
+            fun text(): Optional<Text> = Optional.ofNullable(text)
+
+            /** A summary text from the model. */
+            fun summaryText(): Optional<SummaryText> = Optional.ofNullable(summaryText)
+
+            /** Reasoning text from the model. */
+            fun reasoningText(): Optional<ReasoningText> = Optional.ofNullable(reasoningText)
+
+            /** A refusal from the model. */
+            fun refusal(): Optional<BetaResponseOutputRefusal> = Optional.ofNullable(refusal)
+
+            /**
+             * An image input to the model. Learn about
+             * [image inputs](https://platform.openai.com/docs/guides/vision).
+             */
+            fun inputImage(): Optional<BetaResponseInputImage> = Optional.ofNullable(inputImage)
+
+            /** A screenshot of a computer. */
+            fun computerScreenshot(): Optional<ComputerScreenshot> =
+                Optional.ofNullable(computerScreenshot)
+
+            /** A file input to the model. */
+            fun inputFile(): Optional<BetaResponseInputFile> = Optional.ofNullable(inputFile)
+
+            /**
+             * Opaque encrypted content that Responses API decrypts inside trusted model execution.
+             */
+            fun encrypted(): Optional<EncryptedContent> = Optional.ofNullable(encrypted)
+
+            fun isInputText(): Boolean = inputText != null
+
+            fun isOutputText(): Boolean = outputText != null
+
+            fun isText(): Boolean = text != null
+
+            fun isSummaryText(): Boolean = summaryText != null
+
+            fun isReasoningText(): Boolean = reasoningText != null
+
+            fun isRefusal(): Boolean = refusal != null
+
+            fun isInputImage(): Boolean = inputImage != null
+
+            fun isComputerScreenshot(): Boolean = computerScreenshot != null
+
+            fun isInputFile(): Boolean = inputFile != null
+
+            fun isEncrypted(): Boolean = encrypted != null
+
+            /** A text input to the model. */
+            fun asInputText(): BetaResponseInputText = inputText.getOrThrow("inputText")
+
+            /** A text output from the model. */
+            fun asOutputText(): BetaResponseOutputText = outputText.getOrThrow("outputText")
+
+            /** A text content. */
+            fun asText(): Text = text.getOrThrow("text")
+
+            /** A summary text from the model. */
+            fun asSummaryText(): SummaryText = summaryText.getOrThrow("summaryText")
+
+            /** Reasoning text from the model. */
+            fun asReasoningText(): ReasoningText = reasoningText.getOrThrow("reasoningText")
+
+            /** A refusal from the model. */
+            fun asRefusal(): BetaResponseOutputRefusal = refusal.getOrThrow("refusal")
+
+            /**
+             * An image input to the model. Learn about
+             * [image inputs](https://platform.openai.com/docs/guides/vision).
+             */
+            fun asInputImage(): BetaResponseInputImage = inputImage.getOrThrow("inputImage")
+
+            /** A screenshot of a computer. */
+            fun asComputerScreenshot(): ComputerScreenshot =
+                computerScreenshot.getOrThrow("computerScreenshot")
+
+            /** A file input to the model. */
+            fun asInputFile(): BetaResponseInputFile = inputFile.getOrThrow("inputFile")
+
+            /**
+             * Opaque encrypted content that Responses API decrypts inside trusted model execution.
+             */
+            fun asEncrypted(): EncryptedContent = encrypted.getOrThrow("encrypted")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = content.accept(new Content.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitInputText(BetaResponseInputText inputText) {
+             *         return Optional.of(inputText.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    inputText != null -> visitor.visitInputText(inputText)
+                    outputText != null -> visitor.visitOutputText(outputText)
+                    text != null -> visitor.visitText(text)
+                    summaryText != null -> visitor.visitSummaryText(summaryText)
+                    reasoningText != null -> visitor.visitReasoningText(reasoningText)
+                    refusal != null -> visitor.visitRefusal(refusal)
+                    inputImage != null -> visitor.visitInputImage(inputImage)
+                    computerScreenshot != null ->
+                        visitor.visitComputerScreenshot(computerScreenshot)
+                    inputFile != null -> visitor.visitInputFile(inputFile)
+                    encrypted != null -> visitor.visitEncrypted(encrypted)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Content = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitInputText(inputText: BetaResponseInputText) {
+                            inputText.validate()
+                        }
+
+                        override fun visitOutputText(outputText: BetaResponseOutputText) {
+                            outputText.validate()
+                        }
+
+                        override fun visitText(text: Text) {
+                            text.validate()
+                        }
+
+                        override fun visitSummaryText(summaryText: SummaryText) {
+                            summaryText.validate()
+                        }
+
+                        override fun visitReasoningText(reasoningText: ReasoningText) {
+                            reasoningText.validate()
+                        }
+
+                        override fun visitRefusal(refusal: BetaResponseOutputRefusal) {
+                            refusal.validate()
+                        }
+
+                        override fun visitInputImage(inputImage: BetaResponseInputImage) {
+                            inputImage.validate()
+                        }
+
+                        override fun visitComputerScreenshot(
+                            computerScreenshot: ComputerScreenshot
+                        ) {
+                            computerScreenshot.validate()
+                        }
+
+                        override fun visitInputFile(inputFile: BetaResponseInputFile) {
+                            inputFile.validate()
+                        }
+
+                        override fun visitEncrypted(encrypted: EncryptedContent) {
+                            encrypted.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitInputText(inputText: BetaResponseInputText) =
+                            inputText.validity()
+
+                        override fun visitOutputText(outputText: BetaResponseOutputText) =
+                            outputText.validity()
+
+                        override fun visitText(text: Text) = text.validity()
+
+                        override fun visitSummaryText(summaryText: SummaryText) =
+                            summaryText.validity()
+
+                        override fun visitReasoningText(reasoningText: ReasoningText) =
+                            reasoningText.validity()
+
+                        override fun visitRefusal(refusal: BetaResponseOutputRefusal) =
+                            refusal.validity()
+
+                        override fun visitInputImage(inputImage: BetaResponseInputImage) =
+                            inputImage.validity()
+
+                        override fun visitComputerScreenshot(
+                            computerScreenshot: ComputerScreenshot
+                        ) = computerScreenshot.validity()
+
+                        override fun visitInputFile(inputFile: BetaResponseInputFile) =
+                            inputFile.validity()
+
+                        override fun visitEncrypted(encrypted: EncryptedContent) =
+                            encrypted.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Content &&
+                    inputText == other.inputText &&
+                    outputText == other.outputText &&
+                    text == other.text &&
+                    summaryText == other.summaryText &&
+                    reasoningText == other.reasoningText &&
+                    refusal == other.refusal &&
+                    inputImage == other.inputImage &&
+                    computerScreenshot == other.computerScreenshot &&
+                    inputFile == other.inputFile &&
+                    encrypted == other.encrypted
+            }
+
+            override fun hashCode(): Int =
+                Objects.hash(
+                    inputText,
+                    outputText,
+                    text,
+                    summaryText,
+                    reasoningText,
+                    refusal,
+                    inputImage,
+                    computerScreenshot,
+                    inputFile,
+                    encrypted,
+                )
+
+            override fun toString(): String =
+                when {
+                    inputText != null -> "Content{inputText=$inputText}"
+                    outputText != null -> "Content{outputText=$outputText}"
+                    text != null -> "Content{text=$text}"
+                    summaryText != null -> "Content{summaryText=$summaryText}"
+                    reasoningText != null -> "Content{reasoningText=$reasoningText}"
+                    refusal != null -> "Content{refusal=$refusal}"
+                    inputImage != null -> "Content{inputImage=$inputImage}"
+                    computerScreenshot != null -> "Content{computerScreenshot=$computerScreenshot}"
+                    inputFile != null -> "Content{inputFile=$inputFile}"
+                    encrypted != null -> "Content{encrypted=$encrypted}"
+                    _json != null -> "Content{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Content")
+                }
+
+            companion object {
+
+                /** A text input to the model. */
+                @JvmStatic
+                fun ofInputText(inputText: BetaResponseInputText) = Content(inputText = inputText)
+
+                /** A text output from the model. */
+                @JvmStatic
+                fun ofOutputText(outputText: BetaResponseOutputText) =
+                    Content(outputText = outputText)
+
+                /** A text content. */
+                @JvmStatic fun ofText(text: Text) = Content(text = text)
+
+                /** A summary text from the model. */
+                @JvmStatic
+                fun ofSummaryText(summaryText: SummaryText) = Content(summaryText = summaryText)
+
+                /** Reasoning text from the model. */
+                @JvmStatic
+                fun ofReasoningText(reasoningText: ReasoningText) =
+                    Content(reasoningText = reasoningText)
+
+                /** A refusal from the model. */
+                @JvmStatic
+                fun ofRefusal(refusal: BetaResponseOutputRefusal) = Content(refusal = refusal)
+
+                /**
+                 * An image input to the model. Learn about
+                 * [image inputs](https://platform.openai.com/docs/guides/vision).
+                 */
+                @JvmStatic
+                fun ofInputImage(inputImage: BetaResponseInputImage) =
+                    Content(inputImage = inputImage)
+
+                /** A screenshot of a computer. */
+                @JvmStatic
+                fun ofComputerScreenshot(computerScreenshot: ComputerScreenshot) =
+                    Content(computerScreenshot = computerScreenshot)
+
+                /** A file input to the model. */
+                @JvmStatic
+                fun ofInputFile(inputFile: BetaResponseInputFile) = Content(inputFile = inputFile)
+
+                /**
+                 * Opaque encrypted content that Responses API decrypts inside trusted model
+                 * execution.
+                 */
+                @JvmStatic
+                fun ofEncrypted(encrypted: EncryptedContent) = Content(encrypted = encrypted)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Content] to a value of type
+             * [T].
+             */
+            interface Visitor<out T> {
+
+                /** A text input to the model. */
+                fun visitInputText(inputText: BetaResponseInputText): T
+
+                /** A text output from the model. */
+                fun visitOutputText(outputText: BetaResponseOutputText): T
+
+                /** A text content. */
+                fun visitText(text: Text): T
+
+                /** A summary text from the model. */
+                fun visitSummaryText(summaryText: SummaryText): T
+
+                /** Reasoning text from the model. */
+                fun visitReasoningText(reasoningText: ReasoningText): T
+
+                /** A refusal from the model. */
+                fun visitRefusal(refusal: BetaResponseOutputRefusal): T
+
+                /**
+                 * An image input to the model. Learn about
+                 * [image inputs](https://platform.openai.com/docs/guides/vision).
+                 */
+                fun visitInputImage(inputImage: BetaResponseInputImage): T
+
+                /** A screenshot of a computer. */
+                fun visitComputerScreenshot(computerScreenshot: ComputerScreenshot): T
+
+                /** A file input to the model. */
+                fun visitInputFile(inputFile: BetaResponseInputFile): T
+
+                /**
+                 * Opaque encrypted content that Responses API decrypts inside trusted model
+                 * execution.
+                 */
+                fun visitEncrypted(encrypted: EncryptedContent): T
+
+                /**
+                 * Maps an unknown variant of [Content] to a value of type [T].
+                 *
+                 * An instance of [Content] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Content: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Content>(Content::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Content {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "input_text" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaResponseInputText>())
+                                ?.let { Content(inputText = it, _json = json) }
+                                ?: Content(_json = json)
+                        }
+                        "output_text" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaResponseOutputText>())
+                                ?.let { Content(outputText = it, _json = json) }
+                                ?: Content(_json = json)
+                        }
+                        "text" -> {
+                            return tryDeserialize(node, jacksonTypeRef<Text>())?.let {
+                                Content(text = it, _json = json)
+                            } ?: Content(_json = json)
+                        }
+                        "summary_text" -> {
+                            return tryDeserialize(node, jacksonTypeRef<SummaryText>())?.let {
+                                Content(summaryText = it, _json = json)
+                            } ?: Content(_json = json)
+                        }
+                        "reasoning_text" -> {
+                            return tryDeserialize(node, jacksonTypeRef<ReasoningText>())?.let {
+                                Content(reasoningText = it, _json = json)
+                            } ?: Content(_json = json)
+                        }
+                        "refusal" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaResponseOutputRefusal>())
+                                ?.let { Content(refusal = it, _json = json) }
+                                ?: Content(_json = json)
+                        }
+                        "input_image" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaResponseInputImage>())
+                                ?.let { Content(inputImage = it, _json = json) }
+                                ?: Content(_json = json)
+                        }
+                        "computer_screenshot" -> {
+                            return tryDeserialize(node, jacksonTypeRef<ComputerScreenshot>())?.let {
+                                Content(computerScreenshot = it, _json = json)
+                            } ?: Content(_json = json)
+                        }
+                        "input_file" -> {
+                            return tryDeserialize(node, jacksonTypeRef<BetaResponseInputFile>())
+                                ?.let { Content(inputFile = it, _json = json) }
+                                ?: Content(_json = json)
+                        }
+                        "encrypted_content" -> {
+                            return tryDeserialize(node, jacksonTypeRef<EncryptedContent>())?.let {
+                                Content(encrypted = it, _json = json)
+                            } ?: Content(_json = json)
+                        }
+                    }
+
+                    return Content(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Content>(Content::class) {
+
+                override fun serialize(
+                    value: Content,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.inputText != null -> generator.writeObject(value.inputText)
+                        value.outputText != null -> generator.writeObject(value.outputText)
+                        value.text != null -> generator.writeObject(value.text)
+                        value.summaryText != null -> generator.writeObject(value.summaryText)
+                        value.reasoningText != null -> generator.writeObject(value.reasoningText)
+                        value.refusal != null -> generator.writeObject(value.refusal)
+                        value.inputImage != null -> generator.writeObject(value.inputImage)
+                        value.computerScreenshot != null ->
+                            generator.writeObject(value.computerScreenshot)
+                        value.inputFile != null -> generator.writeObject(value.inputFile)
+                        value.encrypted != null -> generator.writeObject(value.encrypted)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Content")
+                    }
+                }
+            }
+
+            /** A text content. */
+            class Text
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val text: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("text")
+                    @ExcludeMissing
+                    text: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(text, type, mutableMapOf())
+
+                /**
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun text(): String = text.getRequired("text")
+
+                /**
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("text")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [text].
+                 *
+                 * Unlike [text], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Text].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .text()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Text]. */
+                class Builder internal constructor() {
+
+                    private var text: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("text")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(text: Text) = apply {
+                        this.text = text.text
+                        type = text.type
+                        additionalProperties = text.additionalProperties.toMutableMap()
+                    }
+
+                    fun text(text: String) = text(JsonField.of(text))
+
+                    /**
+                     * Sets [Builder.text] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.text] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun text(text: JsonField<String>) = apply { this.text = text }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("text")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Text].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .text()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Text =
+                        Text(checkRequired("text", text), type, additionalProperties.toMutableMap())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Text = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    text()
+                    _type().let {
+                        if (it != JsonValue.from("text")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (text.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("text")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Text &&
+                        text == other.text &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Text{text=$text, type=$type, additionalProperties=$additionalProperties}"
+            }
+
+            /** A summary text from the model. */
+            class SummaryText
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val text: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("text")
+                    @ExcludeMissing
+                    text: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(text, type, mutableMapOf())
+
+                /**
+                 * A summary of the reasoning output from the model so far.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun text(): String = text.getRequired("text")
+
+                /**
+                 * The type of the object. Always `summary_text`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("summary_text")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [text].
+                 *
+                 * Unlike [text], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [SummaryText].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .text()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [SummaryText]. */
+                class Builder internal constructor() {
+
+                    private var text: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("summary_text")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(summaryText: SummaryText) = apply {
+                        text = summaryText.text
+                        type = summaryText.type
+                        additionalProperties = summaryText.additionalProperties.toMutableMap()
+                    }
+
+                    /** A summary of the reasoning output from the model so far. */
+                    fun text(text: String) = text(JsonField.of(text))
+
+                    /**
+                     * Sets [Builder.text] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.text] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun text(text: JsonField<String>) = apply { this.text = text }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("summary_text")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [SummaryText].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .text()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): SummaryText =
+                        SummaryText(
+                            checkRequired("text", text),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): SummaryText = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    text()
+                    _type().let {
+                        if (it != JsonValue.from("summary_text")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (text.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("summary_text")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is SummaryText &&
+                        text == other.text &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "SummaryText{text=$text, type=$type, additionalProperties=$additionalProperties}"
+            }
+
+            /** Reasoning text from the model. */
+            class ReasoningText
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val text: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("text")
+                    @ExcludeMissing
+                    text: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(text, type, mutableMapOf())
+
+                /**
+                 * The reasoning text from the model.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun text(): String = text.getRequired("text")
+
+                /**
+                 * The type of the reasoning text. Always `reasoning_text`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("reasoning_text")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [text].
+                 *
+                 * Unlike [text], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [ReasoningText].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .text()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [ReasoningText]. */
+                class Builder internal constructor() {
+
+                    private var text: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("reasoning_text")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(reasoningText: ReasoningText) = apply {
+                        text = reasoningText.text
+                        type = reasoningText.type
+                        additionalProperties = reasoningText.additionalProperties.toMutableMap()
+                    }
+
+                    /** The reasoning text from the model. */
+                    fun text(text: String) = text(JsonField.of(text))
+
+                    /**
+                     * Sets [Builder.text] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.text] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun text(text: JsonField<String>) = apply { this.text = text }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("reasoning_text")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [ReasoningText].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .text()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): ReasoningText =
+                        ReasoningText(
+                            checkRequired("text", text),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): ReasoningText = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    text()
+                    _type().let {
+                        if (it != JsonValue.from("reasoning_text")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (text.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("reasoning_text")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is ReasoningText &&
+                        text == other.text &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "ReasoningText{text=$text, type=$type, additionalProperties=$additionalProperties}"
+            }
+
+            /** A screenshot of a computer. */
+            class ComputerScreenshot
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val detail: JsonField<Detail>,
+                private val fileId: JsonField<String>,
+                private val imageUrl: JsonField<String>,
+                private val type: JsonValue,
+                private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("detail")
+                    @ExcludeMissing
+                    detail: JsonField<Detail> = JsonMissing.of(),
+                    @JsonProperty("file_id")
+                    @ExcludeMissing
+                    fileId: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("image_url")
+                    @ExcludeMissing
+                    imageUrl: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                    @JsonProperty("prompt_cache_breakpoint")
+                    @ExcludeMissing
+                    promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+                ) : this(detail, fileId, imageUrl, type, promptCacheBreakpoint, mutableMapOf())
+
+                /**
+                 * The detail level of the screenshot image to be sent to the model. One of `high`,
+                 * `low`, `auto`, or `original`. Defaults to `auto`.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun detail(): Detail = detail.getRequired("detail")
+
+                /**
+                 * The identifier of an uploaded file that contains the screenshot.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun fileId(): Optional<String> = fileId.getOptional("file_id")
+
+                /**
+                 * The URL of the screenshot image.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun imageUrl(): Optional<String> = imageUrl.getOptional("image_url")
+
+                /**
+                 * Specifies the event type. For a computer screenshot, this property is always set
+                 * to `computer_screenshot`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("computer_screenshot")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+                 * from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+                 * token block.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+                    promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
+                /**
+                 * Returns the raw JSON value of [detail].
+                 *
+                 * Unlike [detail], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("detail") @ExcludeMissing fun _detail(): JsonField<Detail> = detail
+
+                /**
+                 * Returns the raw JSON value of [fileId].
+                 *
+                 * Unlike [fileId], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("file_id") @ExcludeMissing fun _fileId(): JsonField<String> = fileId
+
+                /**
+                 * Returns the raw JSON value of [imageUrl].
+                 *
+                 * Unlike [imageUrl], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("image_url")
+                @ExcludeMissing
+                fun _imageUrl(): JsonField<String> = imageUrl
+
+                /**
+                 * Returns the raw JSON value of [promptCacheBreakpoint].
+                 *
+                 * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has
+                 * an unexpected type.
+                 */
+                @JsonProperty("prompt_cache_breakpoint")
+                @ExcludeMissing
+                fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> =
+                    promptCacheBreakpoint
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of
+                     * [ComputerScreenshot].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .detail()
+                     * .fileId()
+                     * .imageUrl()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [ComputerScreenshot]. */
+                class Builder internal constructor() {
+
+                    private var detail: JsonField<Detail>? = null
+                    private var fileId: JsonField<String>? = null
+                    private var imageUrl: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("computer_screenshot")
+                    private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> =
+                        JsonMissing.of()
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(computerScreenshot: ComputerScreenshot) = apply {
+                        detail = computerScreenshot.detail
+                        fileId = computerScreenshot.fileId
+                        imageUrl = computerScreenshot.imageUrl
+                        type = computerScreenshot.type
+                        promptCacheBreakpoint = computerScreenshot.promptCacheBreakpoint
+                        additionalProperties =
+                            computerScreenshot.additionalProperties.toMutableMap()
+                    }
+
+                    /**
+                     * The detail level of the screenshot image to be sent to the model. One of
+                     * `high`, `low`, `auto`, or `original`. Defaults to `auto`.
+                     */
+                    fun detail(detail: Detail) = detail(JsonField.of(detail))
+
+                    /**
+                     * Sets [Builder.detail] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.detail] with a well-typed [Detail] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun detail(detail: JsonField<Detail>) = apply { this.detail = detail }
+
+                    /** The identifier of an uploaded file that contains the screenshot. */
+                    fun fileId(fileId: String?) = fileId(JsonField.ofNullable(fileId))
+
+                    /** Alias for calling [Builder.fileId] with `fileId.orElse(null)`. */
+                    fun fileId(fileId: Optional<String>) = fileId(fileId.getOrNull())
+
+                    /**
+                     * Sets [Builder.fileId] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.fileId] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun fileId(fileId: JsonField<String>) = apply { this.fileId = fileId }
+
+                    /** The URL of the screenshot image. */
+                    fun imageUrl(imageUrl: String?) = imageUrl(JsonField.ofNullable(imageUrl))
+
+                    /** Alias for calling [Builder.imageUrl] with `imageUrl.orElse(null)`. */
+                    fun imageUrl(imageUrl: Optional<String>) = imageUrl(imageUrl.getOrNull())
+
+                    /**
+                     * Sets [Builder.imageUrl] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.imageUrl] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun imageUrl(imageUrl: JsonField<String>) = apply { this.imageUrl = imageUrl }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("computer_screenshot")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    /**
+                     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its
+                     * TTL from the request's `prompt_cache_options.ttl`; the boundary is not
+                     * rounded to a token block.
+                     */
+                    fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint) =
+                        promptCacheBreakpoint(JsonField.of(promptCacheBreakpoint))
+
+                    /**
+                     * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+                     * [PromptCacheBreakpoint] value instead. This method is primarily for setting
+                     * the field to an undocumented or not yet supported value.
+                     */
+                    fun promptCacheBreakpoint(
+                        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>
+                    ) = apply { this.promptCacheBreakpoint = promptCacheBreakpoint }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [ComputerScreenshot].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .detail()
+                     * .fileId()
+                     * .imageUrl()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): ComputerScreenshot =
+                        ComputerScreenshot(
+                            checkRequired("detail", detail),
+                            checkRequired("fileId", fileId),
+                            checkRequired("imageUrl", imageUrl),
+                            type,
+                            promptCacheBreakpoint,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): ComputerScreenshot = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    detail().validate()
+                    fileId()
+                    imageUrl()
+                    _type().let {
+                        if (it != JsonValue.from("computer_screenshot")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    promptCacheBreakpoint().ifPresent { it.validate() }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (detail.asKnown().getOrNull()?.validity() ?: 0) +
+                        (if (fileId.asKnown().isPresent) 1 else 0) +
+                        (if (imageUrl.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("computer_screenshot")) 1 else 0 } +
+                        (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
+
+                /**
+                 * The detail level of the screenshot image to be sent to the model. One of `high`,
+                 * `low`, `auto`, or `original`. Defaults to `auto`.
+                 */
+                class Detail
+                @JsonCreator
+                private constructor(private val value: JsonField<String>) : Enum {
+
+                    /**
+                     * Returns this class instance's raw value.
+                     *
+                     * This is usually only useful if this instance was deserialized from data that
+                     * doesn't match any known member, and you want to know that value. For example,
+                     * if the SDK is on an older version than the API, then the API may respond with
+                     * new members that the SDK is unaware of.
+                     */
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    fun _value(): JsonField<String> = value
+
+                    companion object {
+
+                        @JvmField val LOW = of("low")
+
+                        @JvmField val HIGH = of("high")
+
+                        @JvmField val AUTO = of("auto")
+
+                        @JvmField val ORIGINAL = of("original")
+
+                        @JvmStatic fun of(value: String) = Detail(JsonField.of(value))
+                    }
+
+                    /** An enum containing [Detail]'s known values. */
+                    enum class Known {
+                        LOW,
+                        HIGH,
+                        AUTO,
+                        ORIGINAL,
+                    }
+
+                    /**
+                     * An enum containing [Detail]'s known values, as well as an [_UNKNOWN] member.
+                     *
+                     * An instance of [Detail] can contain an unknown value in a couple of cases:
+                     * - It was deserialized from data that doesn't match any known member. For
+                     *   example, if the SDK is on an older version than the API, then the API may
+                     *   respond with new members that the SDK is unaware of.
+                     * - It was constructed with an arbitrary value using the [of] method.
+                     */
+                    enum class Value {
+                        LOW,
+                        HIGH,
+                        AUTO,
+                        ORIGINAL,
+                        /**
+                         * An enum member indicating that [Detail] was instantiated with an unknown
+                         * value.
+                         */
+                        _UNKNOWN,
+                    }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value, or
+                     * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                     *
+                     * Use the [known] method instead if you're certain the value is always known or
+                     * if you want to throw for the unknown case.
+                     */
+                    fun value(): Value =
+                        when (this) {
+                            LOW -> Value.LOW
+                            HIGH -> Value.HIGH
+                            AUTO -> Value.AUTO
+                            ORIGINAL -> Value.ORIGINAL
+                            else -> Value._UNKNOWN
+                        }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value.
+                     *
+                     * Use the [value] method instead if you're uncertain the value is always known
+                     * and don't want to throw for the unknown case.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                     *   known member.
+                     */
+                    fun known(): Known =
+                        when (this) {
+                            LOW -> Known.LOW
+                            HIGH -> Known.HIGH
+                            AUTO -> Known.AUTO
+                            ORIGINAL -> Known.ORIGINAL
+                            else -> throw OpenAIInvalidDataException("Unknown Detail: $value")
+                        }
+
+                    /**
+                     * Returns this class instance's primitive wire representation.
+                     *
+                     * This differs from the [toString] method because that method is primarily for
+                     * debugging and generally doesn't throw.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value does not
+                     *   have the expected primitive type.
+                     */
+                    fun asString(): String =
+                        _value().asString().orElseThrow {
+                            OpenAIInvalidDataException("Value is not a String")
+                        }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): Detail = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        known()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Detail && value == other.value
+                    }
+
+                    override fun hashCode() = value.hashCode()
+
+                    override fun toString() = value.toString()
+                }
+
+                /**
+                 * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+                 * from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+                 * token block.
+                 */
+                class PromptCacheBreakpoint
+                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+                private constructor(
+                    private val mode: JsonValue,
+                    private val additionalProperties: MutableMap<String, JsonValue>,
+                ) {
+
+                    @JsonCreator
+                    private constructor(
+                        @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+                    ) : this(mode, mutableMapOf())
+
+                    /**
+                     * The breakpoint mode. Always `explicit`.
+                     *
+                     * Expected to always return the following:
+                     * ```java
+                     * JsonValue.from("explicit")
+                     * ```
+                     *
+                     * However, this method can be useful for debugging and logging (e.g. if the
+                     * server responded with an unexpected value).
+                     */
+                    @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+                    @JsonAnySetter
+                    private fun putAdditionalProperty(key: String, value: JsonValue) {
+                        additionalProperties.put(key, value)
+                    }
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> =
+                        Collections.unmodifiableMap(additionalProperties)
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of
+                         * [PromptCacheBreakpoint].
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [PromptCacheBreakpoint]. */
+                    class Builder internal constructor() {
+
+                        private var mode: JsonValue = JsonValue.from("explicit")
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                            mode = promptCacheBreakpoint.mode
+                            additionalProperties =
+                                promptCacheBreakpoint.additionalProperties.toMutableMap()
+                        }
+
+                        /**
+                         * Sets the field to an arbitrary JSON value.
+                         *
+                         * It is usually unnecessary to call this method because the field defaults
+                         * to the following:
+                         * ```java
+                         * JsonValue.from("explicit")
+                         * ```
+                         *
+                         * This method is primarily for setting the field to an undocumented or not
+                         * yet supported value.
+                         */
+                        fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [PromptCacheBreakpoint].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         */
+                        fun build(): PromptCacheBreakpoint =
+                            PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): PromptCacheBreakpoint = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        _mode().let {
+                            if (it != JsonValue.from("explicit")) {
+                                throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                            }
+                        }
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is PromptCacheBreakpoint &&
+                            mode == other.mode &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is ComputerScreenshot &&
+                        detail == other.detail &&
+                        fileId == other.fileId &&
+                        imageUrl == other.imageUrl &&
+                        type == other.type &&
+                        promptCacheBreakpoint == other.promptCacheBreakpoint &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(
+                        detail,
+                        fileId,
+                        imageUrl,
+                        type,
+                        promptCacheBreakpoint,
+                        additionalProperties,
+                    )
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "ComputerScreenshot{detail=$detail, fileId=$fileId, imageUrl=$imageUrl, type=$type, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
+            }
+
+            /**
+             * Opaque encrypted content that Responses API decrypts inside trusted model execution.
+             */
+            class EncryptedContent
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val encryptedContent: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("encrypted_content")
+                    @ExcludeMissing
+                    encryptedContent: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(encryptedContent, type, mutableMapOf())
+
+                /**
+                 * Opaque encrypted content.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun encryptedContent(): String = encryptedContent.getRequired("encrypted_content")
+
+                /**
+                 * The type of the input item. Always `encrypted_content`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("encrypted_content")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [encryptedContent].
+                 *
+                 * Unlike [encryptedContent], this method doesn't throw if the JSON field has an
+                 * unexpected type.
+                 */
+                @JsonProperty("encrypted_content")
+                @ExcludeMissing
+                fun _encryptedContent(): JsonField<String> = encryptedContent
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [EncryptedContent].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .encryptedContent()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [EncryptedContent]. */
+                class Builder internal constructor() {
+
+                    private var encryptedContent: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("encrypted_content")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(encryptedContent: EncryptedContent) = apply {
+                        this.encryptedContent = encryptedContent.encryptedContent
+                        type = encryptedContent.type
+                        additionalProperties = encryptedContent.additionalProperties.toMutableMap()
+                    }
+
+                    /** Opaque encrypted content. */
+                    fun encryptedContent(encryptedContent: String) =
+                        encryptedContent(JsonField.of(encryptedContent))
+
+                    /**
+                     * Sets [Builder.encryptedContent] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.encryptedContent] with a well-typed [String]
+                     * value instead. This method is primarily for setting the field to an
+                     * undocumented or not yet supported value.
+                     */
+                    fun encryptedContent(encryptedContent: JsonField<String>) = apply {
+                        this.encryptedContent = encryptedContent
+                    }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("encrypted_content")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [EncryptedContent].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .encryptedContent()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): EncryptedContent =
+                        EncryptedContent(
+                            checkRequired("encryptedContent", encryptedContent),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): EncryptedContent = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    encryptedContent()
+                    _type().let {
+                        if (it != JsonValue.from("encrypted_content")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (encryptedContent.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("encrypted_content")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is EncryptedContent &&
+                        encryptedContent == other.encryptedContent &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(encryptedContent, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "EncryptedContent{encryptedContent=$encryptedContent, type=$type, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AgentMessage &&
+                id == other.id &&
+                author == other.author &&
+                content == other.content &&
+                recipient == other.recipient &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, author, content, recipient, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "AgentMessage{id=$id, author=$author, content=$content, recipient=$recipient, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    class MultiAgentCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val action: JsonField<Action>,
+        private val arguments: JsonField<String>,
+        private val callId: JsonField<String>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
+            @JsonProperty("arguments")
+            @ExcludeMissing
+            arguments: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, action, arguments, callId, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the multi-agent call item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The multi-agent action to execute.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun action(): Action = action.getRequired("action")
+
+        /**
+         * The JSON string of arguments generated for the action.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun arguments(): String = arguments.getRequired("arguments")
+
+        /**
+         * The unique ID linking this call to its output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The type of the multi-agent call. Always `multi_agent_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("multi_agent_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [action].
+         *
+         * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+
+        /**
+         * Returns the raw JSON value of [arguments].
+         *
+         * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [MultiAgentCall].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .action()
+             * .arguments()
+             * .callId()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [MultiAgentCall]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var action: JsonField<Action>? = null
+            private var arguments: JsonField<String>? = null
+            private var callId: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("multi_agent_call")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(multiAgentCall: MultiAgentCall) = apply {
+                id = multiAgentCall.id
+                action = multiAgentCall.action
+                arguments = multiAgentCall.arguments
+                callId = multiAgentCall.callId
+                type = multiAgentCall.type
+                agent = multiAgentCall.agent
+                additionalProperties = multiAgentCall.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the multi-agent call item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The multi-agent action to execute. */
+            fun action(action: Action) = action(JsonField.of(action))
+
+            /**
+             * Sets [Builder.action] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.action] with a well-typed [Action] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun action(action: JsonField<Action>) = apply { this.action = action }
+
+            /** The JSON string of arguments generated for the action. */
+            fun arguments(arguments: String) = arguments(JsonField.of(arguments))
+
+            /**
+             * Sets [Builder.arguments] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.arguments] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
+
+            /** The unique ID linking this call to its output. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("multi_agent_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [MultiAgentCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .action()
+             * .arguments()
+             * .callId()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): MultiAgentCall =
+                MultiAgentCall(
+                    checkRequired("id", id),
+                    checkRequired("action", action),
+                    checkRequired("arguments", arguments),
+                    checkRequired("callId", callId),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): MultiAgentCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            action().validate()
+            arguments()
+            callId()
+            _type().let {
+                if (it != JsonValue.from("multi_agent_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (action.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (arguments.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("multi_agent_call")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The multi-agent action to execute. */
+        class Action @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val SPAWN_AGENT = of("spawn_agent")
+
+                @JvmField val INTERRUPT_AGENT = of("interrupt_agent")
+
+                @JvmField val LIST_AGENTS = of("list_agents")
+
+                @JvmField val SEND_MESSAGE = of("send_message")
+
+                @JvmField val FOLLOWUP_TASK = of("followup_task")
+
+                @JvmField val WAIT_AGENT = of("wait_agent")
+
+                @JvmStatic fun of(value: String) = Action(JsonField.of(value))
+            }
+
+            /** An enum containing [Action]'s known values. */
+            enum class Known {
+                SPAWN_AGENT,
+                INTERRUPT_AGENT,
+                LIST_AGENTS,
+                SEND_MESSAGE,
+                FOLLOWUP_TASK,
+                WAIT_AGENT,
+            }
+
+            /**
+             * An enum containing [Action]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Action] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                SPAWN_AGENT,
+                INTERRUPT_AGENT,
+                LIST_AGENTS,
+                SEND_MESSAGE,
+                FOLLOWUP_TASK,
+                WAIT_AGENT,
+                /**
+                 * An enum member indicating that [Action] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    SPAWN_AGENT -> Value.SPAWN_AGENT
+                    INTERRUPT_AGENT -> Value.INTERRUPT_AGENT
+                    LIST_AGENTS -> Value.LIST_AGENTS
+                    SEND_MESSAGE -> Value.SEND_MESSAGE
+                    FOLLOWUP_TASK -> Value.FOLLOWUP_TASK
+                    WAIT_AGENT -> Value.WAIT_AGENT
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    SPAWN_AGENT -> Known.SPAWN_AGENT
+                    INTERRUPT_AGENT -> Known.INTERRUPT_AGENT
+                    LIST_AGENTS -> Known.LIST_AGENTS
+                    SEND_MESSAGE -> Known.SEND_MESSAGE
+                    FOLLOWUP_TASK -> Known.FOLLOWUP_TASK
+                    WAIT_AGENT -> Known.WAIT_AGENT
+                    else -> throw OpenAIInvalidDataException("Unknown Action: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Action = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Action && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is MultiAgentCall &&
+                id == other.id &&
+                action == other.action &&
+                arguments == other.arguments &&
+                callId == other.callId &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, action, arguments, callId, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "MultiAgentCall{id=$id, action=$action, arguments=$arguments, callId=$callId, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    class MultiAgentCallOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val action: JsonField<Action>,
+        private val callId: JsonField<String>,
+        private val output: JsonField<List<BetaResponseOutputText>>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("output")
+            @ExcludeMissing
+            output: JsonField<List<BetaResponseOutputText>> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, action, callId, output, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the multi-agent call output item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The multi-agent action that produced this result.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun action(): Action = action.getRequired("action")
+
+        /**
+         * The unique ID of the multi-agent call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * Text output returned by the multi-agent action.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun output(): List<BetaResponseOutputText> = output.getRequired("output")
+
+        /**
+         * The type of the multi-agent result. Always `multi_agent_call_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("multi_agent_call_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [action].
+         *
+         * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output")
+        @ExcludeMissing
+        fun _output(): JsonField<List<BetaResponseOutputText>> = output
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [MultiAgentCallOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .action()
+             * .callId()
+             * .output()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [MultiAgentCallOutput]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var action: JsonField<Action>? = null
+            private var callId: JsonField<String>? = null
+            private var output: JsonField<MutableList<BetaResponseOutputText>>? = null
+            private var type: JsonValue = JsonValue.from("multi_agent_call_output")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(multiAgentCallOutput: MultiAgentCallOutput) = apply {
+                id = multiAgentCallOutput.id
+                action = multiAgentCallOutput.action
+                callId = multiAgentCallOutput.callId
+                output = multiAgentCallOutput.output.map { it.toMutableList() }
+                type = multiAgentCallOutput.type
+                agent = multiAgentCallOutput.agent
+                additionalProperties = multiAgentCallOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the multi-agent call output item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The multi-agent action that produced this result. */
+            fun action(action: Action) = action(JsonField.of(action))
+
+            /**
+             * Sets [Builder.action] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.action] with a well-typed [Action] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun action(action: JsonField<Action>) = apply { this.action = action }
+
+            /** The unique ID of the multi-agent call. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** Text output returned by the multi-agent action. */
+            fun output(output: List<BetaResponseOutputText>) = output(JsonField.of(output))
+
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed
+             * `List<BetaResponseOutputText>` value instead. This method is primarily for setting
+             * the field to an undocumented or not yet supported value.
+             */
+            fun output(output: JsonField<List<BetaResponseOutputText>>) = apply {
+                this.output = output.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [BetaResponseOutputText] to [Builder.output].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addOutput(output: BetaResponseOutputText) = apply {
+                this.output =
+                    (this.output ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("output", it).add(output)
+                    }
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("multi_agent_call_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [MultiAgentCallOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .action()
+             * .callId()
+             * .output()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): MultiAgentCallOutput =
+                MultiAgentCallOutput(
+                    checkRequired("id", id),
+                    checkRequired("action", action),
+                    checkRequired("callId", callId),
+                    checkRequired("output", output).map { it.toImmutable() },
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): MultiAgentCallOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            action().validate()
+            callId()
+            output().forEach { it.validate() }
+            _type().let {
+                if (it != JsonValue.from("multi_agent_call_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (action.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (output.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                type.let { if (it == JsonValue.from("multi_agent_call_output")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The multi-agent action that produced this result. */
+        class Action @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val SPAWN_AGENT = of("spawn_agent")
+
+                @JvmField val INTERRUPT_AGENT = of("interrupt_agent")
+
+                @JvmField val LIST_AGENTS = of("list_agents")
+
+                @JvmField val SEND_MESSAGE = of("send_message")
+
+                @JvmField val FOLLOWUP_TASK = of("followup_task")
+
+                @JvmField val WAIT_AGENT = of("wait_agent")
+
+                @JvmStatic fun of(value: String) = Action(JsonField.of(value))
+            }
+
+            /** An enum containing [Action]'s known values. */
+            enum class Known {
+                SPAWN_AGENT,
+                INTERRUPT_AGENT,
+                LIST_AGENTS,
+                SEND_MESSAGE,
+                FOLLOWUP_TASK,
+                WAIT_AGENT,
+            }
+
+            /**
+             * An enum containing [Action]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Action] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                SPAWN_AGENT,
+                INTERRUPT_AGENT,
+                LIST_AGENTS,
+                SEND_MESSAGE,
+                FOLLOWUP_TASK,
+                WAIT_AGENT,
+                /**
+                 * An enum member indicating that [Action] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    SPAWN_AGENT -> Value.SPAWN_AGENT
+                    INTERRUPT_AGENT -> Value.INTERRUPT_AGENT
+                    LIST_AGENTS -> Value.LIST_AGENTS
+                    SEND_MESSAGE -> Value.SEND_MESSAGE
+                    FOLLOWUP_TASK -> Value.FOLLOWUP_TASK
+                    WAIT_AGENT -> Value.WAIT_AGENT
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    SPAWN_AGENT -> Known.SPAWN_AGENT
+                    INTERRUPT_AGENT -> Known.INTERRUPT_AGENT
+                    LIST_AGENTS -> Known.LIST_AGENTS
+                    SEND_MESSAGE -> Known.SEND_MESSAGE
+                    FOLLOWUP_TASK -> Known.FOLLOWUP_TASK
+                    WAIT_AGENT -> Known.WAIT_AGENT
+                    else -> throw OpenAIInvalidDataException("Unknown Action: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Action = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Action && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is MultiAgentCallOutput &&
+                id == other.id &&
+                action == other.action &&
+                callId == other.callId &&
+                output == other.output &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, action, callId, output, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "MultiAgentCallOutput{id=$id, action=$action, callId=$callId, output=$output, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    class Program
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val callId: JsonField<String>,
+        private val code: JsonField<String>,
+        private val fingerprint: JsonField<String>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("code") @ExcludeMissing code: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("fingerprint")
+            @ExcludeMissing
+            fingerprint: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, callId, code, fingerprint, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The stable call ID of the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The JavaScript source executed by programmatic tool calling.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun code(): String = code.getRequired("code")
+
+        /**
+         * Opaque program replay fingerprint that must be round-tripped.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun fingerprint(): String = fingerprint.getRequired("fingerprint")
+
+        /**
+         * The type of the item. Always `program`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("program")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [code].
+         *
+         * Unlike [code], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<String> = code
+
+        /**
+         * Returns the raw JSON value of [fingerprint].
+         *
+         * Unlike [fingerprint], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("fingerprint")
+        @ExcludeMissing
+        fun _fingerprint(): JsonField<String> = fingerprint
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Program].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .code()
+             * .fingerprint()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Program]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var callId: JsonField<String>? = null
+            private var code: JsonField<String>? = null
+            private var fingerprint: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("program")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(program: Program) = apply {
+                id = program.id
+                callId = program.callId
+                code = program.code
+                fingerprint = program.fingerprint
+                type = program.type
+                agent = program.agent
+                additionalProperties = program.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the program item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The stable call ID of the program item. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The JavaScript source executed by programmatic tool calling. */
+            fun code(code: String) = code(JsonField.of(code))
+
+            /**
+             * Sets [Builder.code] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.code] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun code(code: JsonField<String>) = apply { this.code = code }
+
+            /** Opaque program replay fingerprint that must be round-tripped. */
+            fun fingerprint(fingerprint: String) = fingerprint(JsonField.of(fingerprint))
+
+            /**
+             * Sets [Builder.fingerprint] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.fingerprint] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun fingerprint(fingerprint: JsonField<String>) = apply {
+                this.fingerprint = fingerprint
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Program].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .code()
+             * .fingerprint()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Program =
+                Program(
+                    checkRequired("id", id),
+                    checkRequired("callId", callId),
+                    checkRequired("code", code),
+                    checkRequired("fingerprint", fingerprint),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Program = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            callId()
+            code()
+            fingerprint()
+            _type().let {
+                if (it != JsonValue.from("program")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (if (code.asKnown().isPresent) 1 else 0) +
+                (if (fingerprint.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("program")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Program &&
+                id == other.id &&
+                callId == other.callId &&
+                code == other.code &&
+                fingerprint == other.fingerprint &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, callId, code, fingerprint, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Program{id=$id, callId=$callId, code=$code, fingerprint=$fingerprint, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    class ProgramOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val callId: JsonField<String>,
+        private val result: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("result") @ExcludeMissing result: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, callId, result, status, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the program output item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The call ID of the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The result produced by the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun result(): String = result.getRequired("result")
+
+        /**
+         * The terminal status of the program output item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The type of the item. Always `program_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("program_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [result].
+         *
+         * Unlike [result], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("result") @ExcludeMissing fun _result(): JsonField<String> = result
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ProgramOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .result()
+             * .status()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ProgramOutput]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var callId: JsonField<String>? = null
+            private var result: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("program_output")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(programOutput: ProgramOutput) = apply {
+                id = programOutput.id
+                callId = programOutput.callId
+                result = programOutput.result
+                status = programOutput.status
+                type = programOutput.type
+                agent = programOutput.agent
+                additionalProperties = programOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the program output item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The call ID of the program item. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The result produced by the program item. */
+            fun result(result: String) = result(JsonField.of(result))
+
+            /**
+             * Sets [Builder.result] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.result] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun result(result: JsonField<String>) = apply { this.result = result }
+
+            /** The terminal status of the program output item. */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("program_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ProgramOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .result()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ProgramOutput =
+                ProgramOutput(
+                    checkRequired("id", id),
+                    checkRequired("callId", callId),
+                    checkRequired("result", result),
+                    checkRequired("status", status),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ProgramOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            callId()
+            result()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("program_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (if (result.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("program_output")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The terminal status of the program output item. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ProgramOutput &&
+                id == other.id &&
+                callId == other.callId &&
+                result == other.result &&
+                status == other.status &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, callId, result, status, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ProgramOutput{id=$id, callId=$callId, result=$result, status=$status, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    class AdditionalTools
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val role: JsonField<Role>,
+        private val tools: JsonField<List<BetaTool>>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("role") @ExcludeMissing role: JsonField<Role> = JsonMissing.of(),
+            @JsonProperty("tools")
+            @ExcludeMissing
+            tools: JsonField<List<BetaTool>> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, role, tools, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the additional tools item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The role that provided the additional tools.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun role(): Role = role.getRequired("role")
+
+        /**
+         * The additional tool definitions made available at this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun tools(): List<BetaTool> = tools.getRequired("tools")
+
+        /**
+         * The type of the item. Always `additional_tools`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("additional_tools")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [role].
+         *
+         * Unlike [role], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("role") @ExcludeMissing fun _role(): JsonField<Role> = role
+
+        /**
+         * Returns the raw JSON value of [tools].
+         *
+         * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<BetaTool>> = tools
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [AdditionalTools].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .role()
+             * .tools()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [AdditionalTools]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var role: JsonField<Role>? = null
+            private var tools: JsonField<MutableList<BetaTool>>? = null
+            private var type: JsonValue = JsonValue.from("additional_tools")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(additionalTools: AdditionalTools) = apply {
+                id = additionalTools.id
+                role = additionalTools.role
+                tools = additionalTools.tools.map { it.toMutableList() }
+                type = additionalTools.type
+                agent = additionalTools.agent
+                additionalProperties = additionalTools.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the additional tools item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The role that provided the additional tools. */
+            fun role(role: Role) = role(JsonField.of(role))
+
+            /**
+             * Sets [Builder.role] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.role] with a well-typed [Role] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun role(role: JsonField<Role>) = apply { this.role = role }
+
+            /** The additional tool definitions made available at this item. */
+            fun tools(tools: List<BetaTool>) = tools(JsonField.of(tools))
+
+            /**
+             * Sets [Builder.tools] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.tools] with a well-typed `List<BetaTool>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun tools(tools: JsonField<List<BetaTool>>) = apply {
+                this.tools = tools.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [BetaTool] to [tools].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addTool(tool: BetaTool) = apply {
+                tools =
+                    (tools ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("tools", it).add(tool)
+                    }
+            }
+
+            /** Alias for calling [addTool] with `BetaTool.ofFunction(function)`. */
+            fun addTool(function: BetaFunctionTool) = addTool(BetaTool.ofFunction(function))
+
+            /** Alias for calling [addTool] with `BetaTool.ofFileSearch(fileSearch)`. */
+            fun addTool(fileSearch: BetaFileSearchTool) = addTool(BetaTool.ofFileSearch(fileSearch))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaFileSearchTool.builder()
+             *     .vectorStoreIds(vectorStoreIds)
+             *     .build()
+             * ```
+             */
+            fun addFileSearchTool(vectorStoreIds: List<String>) =
+                addTool(BetaFileSearchTool.builder().vectorStoreIds(vectorStoreIds).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofComputer(computer)`. */
+            fun addTool(computer: BetaComputerTool) = addTool(BetaTool.ofComputer(computer))
+
+            /**
+             * Alias for calling [addTool] with `BetaTool.ofComputerUsePreview(computerUsePreview)`.
+             */
+            fun addTool(computerUsePreview: BetaComputerUsePreviewTool) =
+                addTool(BetaTool.ofComputerUsePreview(computerUsePreview))
+
+            /** Alias for calling [addTool] with `BetaTool.ofWebSearch(webSearch)`. */
+            fun addTool(webSearch: BetaWebSearchTool) = addTool(BetaTool.ofWebSearch(webSearch))
+
+            /** Alias for calling [addTool] with `BetaTool.ofMcp(mcp)`. */
+            fun addTool(mcp: BetaTool.Mcp) = addTool(BetaTool.ofMcp(mcp))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaTool.Mcp.builder()
+             *     .serverLabel(serverLabel)
+             *     .build()
+             * ```
+             */
+            fun addMcpTool(serverLabel: String) =
+                addTool(BetaTool.Mcp.builder().serverLabel(serverLabel).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofCodeInterpreter(codeInterpreter)`. */
+            fun addTool(codeInterpreter: BetaTool.CodeInterpreter) =
+                addTool(BetaTool.ofCodeInterpreter(codeInterpreter))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaTool.CodeInterpreter.builder()
+             *     .container(container)
+             *     .build()
+             * ```
+             */
+            fun addCodeInterpreterTool(container: BetaTool.CodeInterpreter.Container) =
+                addTool(BetaTool.CodeInterpreter.builder().container(container).build())
+
+            /**
+             * Alias for calling [addCodeInterpreterTool] with
+             * `BetaTool.CodeInterpreter.Container.ofString(string)`.
+             */
+            fun addCodeInterpreterTool(string: String) =
+                addCodeInterpreterTool(BetaTool.CodeInterpreter.Container.ofString(string))
+
+            /**
+             * Alias for calling [addCodeInterpreterTool] with
+             * `BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)`.
+             */
+            fun addCodeInterpreterTool(
+                codeInterpreterToolAuto: BetaTool.CodeInterpreter.Container.CodeInterpreterToolAuto
+            ) =
+                addCodeInterpreterTool(
+                    BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(
+                        codeInterpreterToolAuto
+                    )
+                )
+
+            /** Alias for calling [addTool] with `BetaTool.ofProgrammaticToolCalling()`. */
+            fun addToolProgrammaticToolCalling() = addTool(BetaTool.ofProgrammaticToolCalling())
+
+            /** Alias for calling [addTool] with `BetaTool.ofImageGeneration(imageGeneration)`. */
+            fun addTool(imageGeneration: BetaTool.ImageGeneration) =
+                addTool(BetaTool.ofImageGeneration(imageGeneration))
+
+            /** Alias for calling [addTool] with `BetaTool.ofLocalShell()`. */
+            fun addToolLocalShell() = addTool(BetaTool.ofLocalShell())
+
+            /** Alias for calling [addTool] with `BetaTool.ofShell(shell)`. */
+            fun addTool(shell: BetaFunctionShellTool) = addTool(BetaTool.ofShell(shell))
+
+            /** Alias for calling [addTool] with `BetaTool.ofCustom(custom)`. */
+            fun addTool(custom: BetaCustomTool) = addTool(BetaTool.ofCustom(custom))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaCustomTool.builder()
+             *     .name(name)
+             *     .build()
+             * ```
+             */
+            fun addCustomTool(name: String) = addTool(BetaCustomTool.builder().name(name).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofNamespace(namespace)`. */
+            fun addTool(namespace: BetaNamespaceTool) = addTool(BetaTool.ofNamespace(namespace))
+
+            /** Alias for calling [addTool] with `BetaTool.ofToolSearch(toolSearch)`. */
+            fun addTool(toolSearch: BetaToolSearchTool) = addTool(BetaTool.ofToolSearch(toolSearch))
+
+            /** Alias for calling [addTool] with `BetaTool.ofWebSearchPreview(webSearchPreview)`. */
+            fun addTool(webSearchPreview: BetaWebSearchPreviewTool) =
+                addTool(BetaTool.ofWebSearchPreview(webSearchPreview))
+
+            /** Alias for calling [addTool] with `BetaTool.ofApplyPatch(applyPatch)`. */
+            fun addTool(applyPatch: BetaApplyPatchTool) = addTool(BetaTool.ofApplyPatch(applyPatch))
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("additional_tools")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [AdditionalTools].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .role()
+             * .tools()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): AdditionalTools =
+                AdditionalTools(
+                    checkRequired("id", id),
+                    checkRequired("role", role),
+                    checkRequired("tools", tools).map { it.toImmutable() },
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): AdditionalTools = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            role().validate()
+            tools().forEach { it.validate() }
+            _type().let {
+                if (it != JsonValue.from("additional_tools")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (role.asKnown().getOrNull()?.validity() ?: 0) +
+                (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                type.let { if (it == JsonValue.from("additional_tools")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The role that provided the additional tools. */
+        class Role @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val UNKNOWN = of("unknown")
+
+                @JvmField val USER = of("user")
+
+                @JvmField val ASSISTANT = of("assistant")
+
+                @JvmField val SYSTEM = of("system")
+
+                @JvmField val CRITIC = of("critic")
+
+                @JvmField val DISCRIMINATOR = of("discriminator")
+
+                @JvmField val DEVELOPER = of("developer")
+
+                @JvmField val TOOL = of("tool")
+
+                @JvmStatic fun of(value: String) = Role(JsonField.of(value))
+            }
+
+            /** An enum containing [Role]'s known values. */
+            enum class Known {
+                UNKNOWN,
+                USER,
+                ASSISTANT,
+                SYSTEM,
+                CRITIC,
+                DISCRIMINATOR,
+                DEVELOPER,
+                TOOL,
+            }
+
+            /**
+             * An enum containing [Role]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Role] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                UNKNOWN,
+                USER,
+                ASSISTANT,
+                SYSTEM,
+                CRITIC,
+                DISCRIMINATOR,
+                DEVELOPER,
+                TOOL,
+                /** An enum member indicating that [Role] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    UNKNOWN -> Value.UNKNOWN
+                    USER -> Value.USER
+                    ASSISTANT -> Value.ASSISTANT
+                    SYSTEM -> Value.SYSTEM
+                    CRITIC -> Value.CRITIC
+                    DISCRIMINATOR -> Value.DISCRIMINATOR
+                    DEVELOPER -> Value.DEVELOPER
+                    TOOL -> Value.TOOL
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    UNKNOWN -> Known.UNKNOWN
+                    USER -> Known.USER
+                    ASSISTANT -> Known.ASSISTANT
+                    SYSTEM -> Known.SYSTEM
+                    CRITIC -> Known.CRITIC
+                    DISCRIMINATOR -> Known.DISCRIMINATOR
+                    DEVELOPER -> Known.DEVELOPER
+                    TOOL -> Known.TOOL
+                    else -> throw OpenAIInvalidDataException("Unknown Role: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Role = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Role && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AdditionalTools &&
+                id == other.id &&
+                role == other.role &&
+                tools == other.tools &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, role, tools, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "AdditionalTools{id=$id, role=$role, tools=$tools, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    /** An image generation request made by the model. */
+    class ImageGenerationCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val result: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("result") @ExcludeMissing result: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, result, status, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the image generation call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The generated image encoded in base64.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun result(): Optional<String> = result.getOptional("result")
+
+        /**
+         * The status of the image generation call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The type of the image generation call. Always `image_generation_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("image_generation_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [result].
+         *
+         * Unlike [result], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("result") @ExcludeMissing fun _result(): JsonField<String> = result
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ImageGenerationCall].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .result()
+             * .status()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ImageGenerationCall]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var result: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("image_generation_call")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(imageGenerationCall: ImageGenerationCall) = apply {
+                id = imageGenerationCall.id
+                result = imageGenerationCall.result
+                status = imageGenerationCall.status
+                type = imageGenerationCall.type
+                agent = imageGenerationCall.agent
+                additionalProperties = imageGenerationCall.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the image generation call. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The generated image encoded in base64. */
+            fun result(result: String?) = result(JsonField.ofNullable(result))
+
+            /** Alias for calling [Builder.result] with `result.orElse(null)`. */
+            fun result(result: Optional<String>) = result(result.getOrNull())
+
+            /**
+             * Sets [Builder.result] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.result] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun result(result: JsonField<String>) = apply { this.result = result }
+
+            /** The status of the image generation call. */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("image_generation_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ImageGenerationCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .result()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ImageGenerationCall =
+                ImageGenerationCall(
+                    checkRequired("id", id),
+                    checkRequired("result", result),
+                    checkRequired("status", status),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ImageGenerationCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            result()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("image_generation_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (result.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("image_generation_call")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The status of the image generation call. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val GENERATING = of("generating")
+
+                @JvmField val FAILED = of("failed")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                GENERATING,
+                FAILED,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                GENERATING,
+                FAILED,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    GENERATING -> Value.GENERATING
+                    FAILED -> Value.FAILED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    GENERATING -> Known.GENERATING
+                    FAILED -> Known.FAILED
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ImageGenerationCall &&
+                id == other.id &&
+                result == other.result &&
+                status == other.status &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, result, status, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ImageGenerationCall{id=$id, result=$result, status=$status, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    /** A tool call to run a command on the local shell. */
+    class LocalShellCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val action: JsonField<Action>,
+        private val callId: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, action, callId, status, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the local shell call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * Execute a shell command on the server.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun action(): Action = action.getRequired("action")
+
+        /**
+         * The unique ID of the local shell tool call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The status of the local shell call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The type of the local shell call. Always `local_shell_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("local_shell_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [action].
+         *
+         * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [LocalShellCall].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .action()
+             * .callId()
+             * .status()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [LocalShellCall]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var action: JsonField<Action>? = null
+            private var callId: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("local_shell_call")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(localShellCall: LocalShellCall) = apply {
+                id = localShellCall.id
+                action = localShellCall.action
+                callId = localShellCall.callId
+                status = localShellCall.status
+                type = localShellCall.type
+                agent = localShellCall.agent
+                additionalProperties = localShellCall.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the local shell call. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** Execute a shell command on the server. */
+            fun action(action: Action) = action(JsonField.of(action))
+
+            /**
+             * Sets [Builder.action] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.action] with a well-typed [Action] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun action(action: JsonField<Action>) = apply { this.action = action }
+
+            /** The unique ID of the local shell tool call generated by the model. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The status of the local shell call. */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("local_shell_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [LocalShellCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .action()
+             * .callId()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): LocalShellCall =
+                LocalShellCall(
+                    checkRequired("id", id),
+                    checkRequired("action", action),
+                    checkRequired("callId", callId),
+                    checkRequired("status", status),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): LocalShellCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            action().validate()
+            callId()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("local_shell_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (action.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("local_shell_call")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** Execute a shell command on the server. */
+        class Action
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val command: JsonField<List<String>>,
+            private val env: JsonField<Env>,
+            private val type: JsonValue,
+            private val timeoutMs: JsonField<Long>,
+            private val user: JsonField<String>,
+            private val workingDirectory: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("command")
+                @ExcludeMissing
+                command: JsonField<List<String>> = JsonMissing.of(),
+                @JsonProperty("env") @ExcludeMissing env: JsonField<Env> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                @JsonProperty("timeout_ms")
+                @ExcludeMissing
+                timeoutMs: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("user") @ExcludeMissing user: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("working_directory")
+                @ExcludeMissing
+                workingDirectory: JsonField<String> = JsonMissing.of(),
+            ) : this(command, env, type, timeoutMs, user, workingDirectory, mutableMapOf())
+
+            /**
+             * The command to run.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun command(): List<String> = command.getRequired("command")
+
+            /**
+             * Environment variables to set for the command.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun env(): Env = env.getRequired("env")
+
+            /**
+             * The type of the local shell action. Always `exec`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("exec")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Optional timeout in milliseconds for the command.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun timeoutMs(): Optional<Long> = timeoutMs.getOptional("timeout_ms")
+
+            /**
+             * Optional user to run the command as.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun user(): Optional<String> = user.getOptional("user")
+
+            /**
+             * Optional working directory to run the command in.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun workingDirectory(): Optional<String> =
+                workingDirectory.getOptional("working_directory")
+
+            /**
+             * Returns the raw JSON value of [command].
+             *
+             * Unlike [command], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("command")
+            @ExcludeMissing
+            fun _command(): JsonField<List<String>> = command
+
+            /**
+             * Returns the raw JSON value of [env].
+             *
+             * Unlike [env], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("env") @ExcludeMissing fun _env(): JsonField<Env> = env
+
+            /**
+             * Returns the raw JSON value of [timeoutMs].
+             *
+             * Unlike [timeoutMs], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("timeout_ms")
+            @ExcludeMissing
+            fun _timeoutMs(): JsonField<Long> = timeoutMs
+
+            /**
+             * Returns the raw JSON value of [user].
+             *
+             * Unlike [user], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("user") @ExcludeMissing fun _user(): JsonField<String> = user
+
+            /**
+             * Returns the raw JSON value of [workingDirectory].
+             *
+             * Unlike [workingDirectory], this method doesn't throw if the JSON field has an
+             * unexpected type.
+             */
+            @JsonProperty("working_directory")
+            @ExcludeMissing
+            fun _workingDirectory(): JsonField<String> = workingDirectory
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Action].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .command()
+                 * .env()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Action]. */
+            class Builder internal constructor() {
+
+                private var command: JsonField<MutableList<String>>? = null
+                private var env: JsonField<Env>? = null
+                private var type: JsonValue = JsonValue.from("exec")
+                private var timeoutMs: JsonField<Long> = JsonMissing.of()
+                private var user: JsonField<String> = JsonMissing.of()
+                private var workingDirectory: JsonField<String> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(action: Action) = apply {
+                    command = action.command.map { it.toMutableList() }
+                    env = action.env
+                    type = action.type
+                    timeoutMs = action.timeoutMs
+                    user = action.user
+                    workingDirectory = action.workingDirectory
+                    additionalProperties = action.additionalProperties.toMutableMap()
+                }
+
+                /** The command to run. */
+                fun command(command: List<String>) = command(JsonField.of(command))
+
+                /**
+                 * Sets [Builder.command] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.command] with a well-typed `List<String>` value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun command(command: JsonField<List<String>>) = apply {
+                    this.command = command.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [String] to [Builder.command].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addCommand(command: String) = apply {
+                    this.command =
+                        (this.command ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("command", it).add(command)
+                        }
+                }
+
+                /** Environment variables to set for the command. */
+                fun env(env: Env) = env(JsonField.of(env))
+
+                /**
+                 * Sets [Builder.env] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.env] with a well-typed [Env] value instead. This
+                 * method is primarily for setting the field to an undocumented or not yet supported
+                 * value.
+                 */
+                fun env(env: JsonField<Env>) = apply { this.env = env }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("exec")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                /** Optional timeout in milliseconds for the command. */
+                fun timeoutMs(timeoutMs: Long?) = timeoutMs(JsonField.ofNullable(timeoutMs))
+
+                /**
+                 * Alias for [Builder.timeoutMs].
+                 *
+                 * This unboxed primitive overload exists for backwards compatibility.
+                 */
+                fun timeoutMs(timeoutMs: Long) = timeoutMs(timeoutMs as Long?)
+
+                /** Alias for calling [Builder.timeoutMs] with `timeoutMs.orElse(null)`. */
+                fun timeoutMs(timeoutMs: Optional<Long>) = timeoutMs(timeoutMs.getOrNull())
+
+                /**
+                 * Sets [Builder.timeoutMs] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.timeoutMs] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun timeoutMs(timeoutMs: JsonField<Long>) = apply { this.timeoutMs = timeoutMs }
+
+                /** Optional user to run the command as. */
+                fun user(user: String?) = user(JsonField.ofNullable(user))
+
+                /** Alias for calling [Builder.user] with `user.orElse(null)`. */
+                fun user(user: Optional<String>) = user(user.getOrNull())
+
+                /**
+                 * Sets [Builder.user] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.user] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun user(user: JsonField<String>) = apply { this.user = user }
+
+                /** Optional working directory to run the command in. */
+                fun workingDirectory(workingDirectory: String?) =
+                    workingDirectory(JsonField.ofNullable(workingDirectory))
+
+                /**
+                 * Alias for calling [Builder.workingDirectory] with
+                 * `workingDirectory.orElse(null)`.
+                 */
+                fun workingDirectory(workingDirectory: Optional<String>) =
+                    workingDirectory(workingDirectory.getOrNull())
+
+                /**
+                 * Sets [Builder.workingDirectory] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.workingDirectory] with a well-typed [String]
+                 * value instead. This method is primarily for setting the field to an undocumented
+                 * or not yet supported value.
+                 */
+                fun workingDirectory(workingDirectory: JsonField<String>) = apply {
+                    this.workingDirectory = workingDirectory
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Action].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .command()
+                 * .env()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Action =
+                    Action(
+                        checkRequired("command", command).map { it.toImmutable() },
+                        checkRequired("env", env),
+                        type,
+                        timeoutMs,
+                        user,
+                        workingDirectory,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Action = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                command()
+                env().validate()
+                _type().let {
+                    if (it != JsonValue.from("exec")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                timeoutMs()
+                user()
+                workingDirectory()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (command.asKnown().getOrNull()?.size ?: 0) +
+                    (env.asKnown().getOrNull()?.validity() ?: 0) +
+                    type.let { if (it == JsonValue.from("exec")) 1 else 0 } +
+                    (if (timeoutMs.asKnown().isPresent) 1 else 0) +
+                    (if (user.asKnown().isPresent) 1 else 0) +
+                    (if (workingDirectory.asKnown().isPresent) 1 else 0)
+
+            /** Environment variables to set for the command. */
+            class Env
+            @JsonCreator
+            private constructor(
+                @com.fasterxml.jackson.annotation.JsonValue
+                private val additionalProperties: Map<String, JsonValue>
+            ) {
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /** Returns a mutable builder for constructing an instance of [Env]. */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Env]. */
+                class Builder internal constructor() {
+
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(env: Env) = apply {
+                        additionalProperties = env.additionalProperties.toMutableMap()
+                    }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Env].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     */
+                    fun build(): Env = Env(additionalProperties.toImmutable())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Env = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    additionalProperties.count { (_, value) ->
+                        !value.isNull() && !value.isMissing()
+                    }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Env && additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() = "Env{additionalProperties=$additionalProperties}"
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Action &&
+                    command == other.command &&
+                    env == other.env &&
+                    type == other.type &&
+                    timeoutMs == other.timeoutMs &&
+                    user == other.user &&
+                    workingDirectory == other.workingDirectory &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(
+                    command,
+                    env,
+                    type,
+                    timeoutMs,
+                    user,
+                    workingDirectory,
+                    additionalProperties,
+                )
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Action{command=$command, env=$env, type=$type, timeoutMs=$timeoutMs, user=$user, workingDirectory=$workingDirectory, additionalProperties=$additionalProperties}"
+        }
+
+        /** The status of the local shell call. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is LocalShellCall &&
+                id == other.id &&
+                action == other.action &&
+                callId == other.callId &&
+                status == other.status &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, action, callId, status, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "LocalShellCall{id=$id, action=$action, callId=$callId, status=$status, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    /** The output of a local shell tool call. */
+    class LocalShellCallOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val output: JsonField<String>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val status: JsonField<Status>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("output") @ExcludeMissing output: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        ) : this(id, output, type, agent, status, mutableMapOf())
+
+        /**
+         * The unique ID of the local shell tool call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * A JSON string of the output of the local shell tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun output(): String = output.getRequired("output")
+
+        /**
+         * The type of the local shell tool call output. Always `local_shell_call_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("local_shell_call_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun status(): Optional<Status> = status.getOptional("status")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<String> = output
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [LocalShellCallOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .output()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [LocalShellCallOutput]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var output: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("local_shell_call_output")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var status: JsonField<Status> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(localShellCallOutput: LocalShellCallOutput) = apply {
+                id = localShellCallOutput.id
+                output = localShellCallOutput.output
+                type = localShellCallOutput.type
+                agent = localShellCallOutput.agent
+                status = localShellCallOutput.status
+                additionalProperties = localShellCallOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the local shell tool call generated by the model. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** A JSON string of the output of the local shell tool call. */
+            fun output(output: String) = output(JsonField.of(output))
+
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun output(output: JsonField<String>) = apply { this.output = output }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("local_shell_call_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /** The status of the item. One of `in_progress`, `completed`, or `incomplete`. */
+            fun status(status: Status?) = status(JsonField.ofNullable(status))
+
+            /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+            fun status(status: Optional<Status>) = status(status.getOrNull())
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [LocalShellCallOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .output()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): LocalShellCallOutput =
+                LocalShellCallOutput(
+                    checkRequired("id", id),
+                    checkRequired("output", output),
+                    type,
+                    agent,
+                    status,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): LocalShellCallOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            output()
+            _type().let {
+                if (it != JsonValue.from("local_shell_call_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            status().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (output.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("local_shell_call_output")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        /** The status of the item. One of `in_progress`, `completed`, or `incomplete`. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is LocalShellCallOutput &&
+                id == other.id &&
+                output == other.output &&
+                type == other.type &&
+                agent == other.agent &&
+                status == other.status &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, output, type, agent, status, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "LocalShellCallOutput{id=$id, output=$output, type=$type, agent=$agent, status=$status, additionalProperties=$additionalProperties}"
+    }
+
+    /** An invocation of a tool on an MCP server. */
+    class McpCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val arguments: JsonField<String>,
+        private val name: JsonField<String>,
+        private val serverLabel: JsonField<String>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val approvalRequestId: JsonField<String>,
+        private val error: JsonField<String>,
+        private val output: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("arguments")
+            @ExcludeMissing
+            arguments: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("server_label")
+            @ExcludeMissing
+            serverLabel: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("approval_request_id")
+            @ExcludeMissing
+            approvalRequestId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("error") @ExcludeMissing error: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("output") @ExcludeMissing output: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        ) : this(
+            id,
+            arguments,
+            name,
+            serverLabel,
+            type,
+            agent,
+            approvalRequestId,
+            error,
+            output,
+            status,
+            mutableMapOf(),
+        )
+
+        /**
+         * The unique ID of the tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * A JSON string of the arguments passed to the tool.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun arguments(): String = arguments.getRequired("arguments")
+
+        /**
+         * The name of the tool that was run.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun name(): String = name.getRequired("name")
+
+        /**
+         * The label of the MCP server running the tool.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun serverLabel(): String = serverLabel.getRequired("server_label")
+
+        /**
+         * The type of the item. Always `mcp_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("mcp_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Unique identifier for the MCP tool call approval request. Include this value in a
+         * subsequent `mcp_approval_response` input to approve or reject the corresponding tool
+         * call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun approvalRequestId(): Optional<String> =
+            approvalRequestId.getOptional("approval_request_id")
+
+        /**
+         * The error from the tool call, if any.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun error(): Optional<String> = error.getOptional("error")
+
+        /**
+         * The output from the tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun output(): Optional<String> = output.getOptional("output")
+
+        /**
+         * The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `calling`,
+         * or `failed`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun status(): Optional<Status> = status.getOptional("status")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [arguments].
+         *
+         * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
+
+        /**
+         * Returns the raw JSON value of [name].
+         *
+         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+        /**
+         * Returns the raw JSON value of [serverLabel].
+         *
+         * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("server_label")
+        @ExcludeMissing
+        fun _serverLabel(): JsonField<String> = serverLabel
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [approvalRequestId].
+         *
+         * Unlike [approvalRequestId], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("approval_request_id")
+        @ExcludeMissing
+        fun _approvalRequestId(): JsonField<String> = approvalRequestId
+
+        /**
+         * Returns the raw JSON value of [error].
+         *
+         * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<String> = error
+
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<String> = output
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [McpCall].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .arguments()
+             * .name()
+             * .serverLabel()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [McpCall]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var arguments: JsonField<String>? = null
+            private var name: JsonField<String>? = null
+            private var serverLabel: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("mcp_call")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var approvalRequestId: JsonField<String> = JsonMissing.of()
+            private var error: JsonField<String> = JsonMissing.of()
+            private var output: JsonField<String> = JsonMissing.of()
+            private var status: JsonField<Status> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(mcpCall: McpCall) = apply {
+                id = mcpCall.id
+                arguments = mcpCall.arguments
+                name = mcpCall.name
+                serverLabel = mcpCall.serverLabel
+                type = mcpCall.type
+                agent = mcpCall.agent
+                approvalRequestId = mcpCall.approvalRequestId
+                error = mcpCall.error
+                output = mcpCall.output
+                status = mcpCall.status
+                additionalProperties = mcpCall.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the tool call. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** A JSON string of the arguments passed to the tool. */
+            fun arguments(arguments: String) = arguments(JsonField.of(arguments))
+
+            /**
+             * Sets [Builder.arguments] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.arguments] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
+
+            /** The name of the tool that was run. */
+            fun name(name: String) = name(JsonField.of(name))
+
+            /**
+             * Sets [Builder.name] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.name] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun name(name: JsonField<String>) = apply { this.name = name }
+
+            /** The label of the MCP server running the tool. */
+            fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
+
+            /**
+             * Sets [Builder.serverLabel] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serverLabel] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun serverLabel(serverLabel: JsonField<String>) = apply {
+                this.serverLabel = serverLabel
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("mcp_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /**
+             * Unique identifier for the MCP tool call approval request. Include this value in a
+             * subsequent `mcp_approval_response` input to approve or reject the corresponding tool
+             * call.
+             */
+            fun approvalRequestId(approvalRequestId: String?) =
+                approvalRequestId(JsonField.ofNullable(approvalRequestId))
+
+            /**
+             * Alias for calling [Builder.approvalRequestId] with `approvalRequestId.orElse(null)`.
+             */
+            fun approvalRequestId(approvalRequestId: Optional<String>) =
+                approvalRequestId(approvalRequestId.getOrNull())
+
+            /**
+             * Sets [Builder.approvalRequestId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.approvalRequestId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun approvalRequestId(approvalRequestId: JsonField<String>) = apply {
+                this.approvalRequestId = approvalRequestId
+            }
+
+            /** The error from the tool call, if any. */
+            fun error(error: String?) = error(JsonField.ofNullable(error))
+
+            /** Alias for calling [Builder.error] with `error.orElse(null)`. */
+            fun error(error: Optional<String>) = error(error.getOrNull())
+
+            /**
+             * Sets [Builder.error] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.error] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun error(error: JsonField<String>) = apply { this.error = error }
+
+            /** The output from the tool call. */
+            fun output(output: String?) = output(JsonField.ofNullable(output))
+
+            /** Alias for calling [Builder.output] with `output.orElse(null)`. */
+            fun output(output: Optional<String>) = output(output.getOrNull())
+
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun output(output: JsonField<String>) = apply { this.output = output }
+
+            /**
+             * The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+             * `calling`, or `failed`.
+             */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [McpCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .arguments()
+             * .name()
+             * .serverLabel()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): McpCall =
+                McpCall(
+                    checkRequired("id", id),
+                    checkRequired("arguments", arguments),
+                    checkRequired("name", name),
+                    checkRequired("serverLabel", serverLabel),
+                    type,
+                    agent,
+                    approvalRequestId,
+                    error,
+                    output,
+                    status,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): McpCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            arguments()
+            name()
+            serverLabel()
+            _type().let {
+                if (it != JsonValue.from("mcp_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            approvalRequestId()
+            error()
+            output()
+            status().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (arguments.asKnown().isPresent) 1 else 0) +
+                (if (name.asKnown().isPresent) 1 else 0) +
+                (if (serverLabel.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("mcp_call")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (approvalRequestId.asKnown().isPresent) 1 else 0) +
+                (if (error.asKnown().isPresent) 1 else 0) +
+                (if (output.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        /**
+         * The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `calling`,
+         * or `failed`.
+         */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmField val CALLING = of("calling")
+
+                @JvmField val FAILED = of("failed")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                CALLING,
+                FAILED,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                CALLING,
+                FAILED,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    CALLING -> Value.CALLING
+                    FAILED -> Value.FAILED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    CALLING -> Known.CALLING
+                    FAILED -> Known.FAILED
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is McpCall &&
+                id == other.id &&
+                arguments == other.arguments &&
+                name == other.name &&
+                serverLabel == other.serverLabel &&
+                type == other.type &&
+                agent == other.agent &&
+                approvalRequestId == other.approvalRequestId &&
+                error == other.error &&
+                output == other.output &&
+                status == other.status &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                id,
+                arguments,
+                name,
+                serverLabel,
+                type,
+                agent,
+                approvalRequestId,
+                error,
+                output,
+                status,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "McpCall{id=$id, arguments=$arguments, name=$name, serverLabel=$serverLabel, type=$type, agent=$agent, approvalRequestId=$approvalRequestId, error=$error, output=$output, status=$status, additionalProperties=$additionalProperties}"
+    }
+
+    /** A list of tools available on an MCP server. */
+    class McpListTools
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val serverLabel: JsonField<String>,
+        private val tools: JsonField<List<Tool>>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val error: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("server_label")
+            @ExcludeMissing
+            serverLabel: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("tools") @ExcludeMissing tools: JsonField<List<Tool>> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("error") @ExcludeMissing error: JsonField<String> = JsonMissing.of(),
+        ) : this(id, serverLabel, tools, type, agent, error, mutableMapOf())
+
+        /**
+         * The unique ID of the list.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The label of the MCP server.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun serverLabel(): String = serverLabel.getRequired("server_label")
+
+        /**
+         * The tools available on the server.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun tools(): List<Tool> = tools.getRequired("tools")
+
+        /**
+         * The type of the item. Always `mcp_list_tools`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("mcp_list_tools")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Error message if the server could not list tools.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun error(): Optional<String> = error.getOptional("error")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [serverLabel].
+         *
+         * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("server_label")
+        @ExcludeMissing
+        fun _serverLabel(): JsonField<String> = serverLabel
+
+        /**
+         * Returns the raw JSON value of [tools].
+         *
+         * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<Tool>> = tools
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [error].
+         *
+         * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<String> = error
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [McpListTools].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .serverLabel()
+             * .tools()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [McpListTools]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var serverLabel: JsonField<String>? = null
+            private var tools: JsonField<MutableList<Tool>>? = null
+            private var type: JsonValue = JsonValue.from("mcp_list_tools")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var error: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(mcpListTools: McpListTools) = apply {
+                id = mcpListTools.id
+                serverLabel = mcpListTools.serverLabel
+                tools = mcpListTools.tools.map { it.toMutableList() }
+                type = mcpListTools.type
+                agent = mcpListTools.agent
+                error = mcpListTools.error
+                additionalProperties = mcpListTools.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the list. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The label of the MCP server. */
+            fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
+
+            /**
+             * Sets [Builder.serverLabel] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serverLabel] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun serverLabel(serverLabel: JsonField<String>) = apply {
+                this.serverLabel = serverLabel
+            }
+
+            /** The tools available on the server. */
+            fun tools(tools: List<Tool>) = tools(JsonField.of(tools))
+
+            /**
+             * Sets [Builder.tools] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.tools] with a well-typed `List<Tool>` value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun tools(tools: JsonField<List<Tool>>) = apply {
+                this.tools = tools.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [Tool] to [tools].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addTool(tool: Tool) = apply {
+                tools =
+                    (tools ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("tools", it).add(tool)
+                    }
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("mcp_list_tools")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /** Error message if the server could not list tools. */
+            fun error(error: String?) = error(JsonField.ofNullable(error))
+
+            /** Alias for calling [Builder.error] with `error.orElse(null)`. */
+            fun error(error: Optional<String>) = error(error.getOrNull())
+
+            /**
+             * Sets [Builder.error] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.error] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun error(error: JsonField<String>) = apply { this.error = error }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [McpListTools].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .serverLabel()
+             * .tools()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): McpListTools =
+                McpListTools(
+                    checkRequired("id", id),
+                    checkRequired("serverLabel", serverLabel),
+                    checkRequired("tools", tools).map { it.toImmutable() },
+                    type,
+                    agent,
+                    error,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): McpListTools = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            serverLabel()
+            tools().forEach { it.validate() }
+            _type().let {
+                if (it != JsonValue.from("mcp_list_tools")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            error()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (serverLabel.asKnown().isPresent) 1 else 0) +
+                (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                type.let { if (it == JsonValue.from("mcp_list_tools")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (error.asKnown().isPresent) 1 else 0)
+
+        /** A tool available on an MCP server. */
+        class Tool
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val inputSchema: JsonValue,
+            private val name: JsonField<String>,
+            private val annotations: JsonValue,
+            private val description: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("input_schema")
+                @ExcludeMissing
+                inputSchema: JsonValue = JsonMissing.of(),
+                @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("annotations")
+                @ExcludeMissing
+                annotations: JsonValue = JsonMissing.of(),
+                @JsonProperty("description")
+                @ExcludeMissing
+                description: JsonField<String> = JsonMissing.of(),
+            ) : this(inputSchema, name, annotations, description, mutableMapOf())
+
+            /**
+             * The JSON schema describing the tool's input.
+             *
+             * This arbitrary value can be deserialized into a custom type using the `convert`
+             * method:
+             * ```java
+             * MyClass myObject = tool.inputSchema().convert(MyClass.class);
+             * ```
+             */
+            @JsonProperty("input_schema")
+            @ExcludeMissing
+            fun _inputSchema(): JsonValue = inputSchema
+
+            /**
+             * The name of the tool.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun name(): String = name.getRequired("name")
+
+            /**
+             * Additional annotations about the tool.
+             *
+             * This arbitrary value can be deserialized into a custom type using the `convert`
+             * method:
+             * ```java
+             * MyClass myObject = tool.annotations().convert(MyClass.class);
+             * ```
+             */
+            @JsonProperty("annotations") @ExcludeMissing fun _annotations(): JsonValue = annotations
+
+            /**
+             * The description of the tool.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun description(): Optional<String> = description.getOptional("description")
+
+            /**
+             * Returns the raw JSON value of [name].
+             *
+             * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+            /**
+             * Returns the raw JSON value of [description].
+             *
+             * Unlike [description], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("description")
+            @ExcludeMissing
+            fun _description(): JsonField<String> = description
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Tool].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .inputSchema()
+                 * .name()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Tool]. */
+            class Builder internal constructor() {
+
+                private var inputSchema: JsonValue? = null
+                private var name: JsonField<String>? = null
+                private var annotations: JsonValue = JsonMissing.of()
+                private var description: JsonField<String> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(tool: Tool) = apply {
+                    inputSchema = tool.inputSchema
+                    name = tool.name
+                    annotations = tool.annotations
+                    description = tool.description
+                    additionalProperties = tool.additionalProperties.toMutableMap()
+                }
+
+                /** The JSON schema describing the tool's input. */
+                fun inputSchema(inputSchema: JsonValue) = apply { this.inputSchema = inputSchema }
+
+                /** The name of the tool. */
+                fun name(name: String) = name(JsonField.of(name))
+
+                /**
+                 * Sets [Builder.name] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.name] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun name(name: JsonField<String>) = apply { this.name = name }
+
+                /** Additional annotations about the tool. */
+                fun annotations(annotations: JsonValue) = apply { this.annotations = annotations }
+
+                /** The description of the tool. */
+                fun description(description: String?) =
+                    description(JsonField.ofNullable(description))
+
+                /** Alias for calling [Builder.description] with `description.orElse(null)`. */
+                fun description(description: Optional<String>) =
+                    description(description.getOrNull())
+
+                /**
+                 * Sets [Builder.description] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.description] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun description(description: JsonField<String>) = apply {
+                    this.description = description
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Tool].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .inputSchema()
+                 * .name()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Tool =
+                    Tool(
+                        checkRequired("inputSchema", inputSchema),
+                        checkRequired("name", name),
+                        annotations,
+                        description,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Tool = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                name()
+                description()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (name.asKnown().isPresent) 1 else 0) +
+                    (if (description.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Tool &&
+                    inputSchema == other.inputSchema &&
+                    name == other.name &&
+                    annotations == other.annotations &&
+                    description == other.description &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(inputSchema, name, annotations, description, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Tool{inputSchema=$inputSchema, name=$name, annotations=$annotations, description=$description, additionalProperties=$additionalProperties}"
+        }
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is McpListTools &&
+                id == other.id &&
+                serverLabel == other.serverLabel &&
+                tools == other.tools &&
+                type == other.type &&
+                agent == other.agent &&
+                error == other.error &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, serverLabel, tools, type, agent, error, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "McpListTools{id=$id, serverLabel=$serverLabel, tools=$tools, type=$type, agent=$agent, error=$error, additionalProperties=$additionalProperties}"
+    }
+
+    /** A request for human approval of a tool invocation. */
+    class McpApprovalRequest
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val arguments: JsonField<String>,
+        private val name: JsonField<String>,
+        private val serverLabel: JsonField<String>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("arguments")
+            @ExcludeMissing
+            arguments: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("server_label")
+            @ExcludeMissing
+            serverLabel: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        ) : this(id, arguments, name, serverLabel, type, agent, mutableMapOf())
+
+        /**
+         * The unique ID of the approval request.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * A JSON string of arguments for the tool.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun arguments(): String = arguments.getRequired("arguments")
+
+        /**
+         * The name of the tool to run.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun name(): String = name.getRequired("name")
+
+        /**
+         * The label of the MCP server making the request.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun serverLabel(): String = serverLabel.getRequired("server_label")
+
+        /**
+         * The type of the item. Always `mcp_approval_request`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("mcp_approval_request")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [arguments].
+         *
+         * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
+
+        /**
+         * Returns the raw JSON value of [name].
+         *
+         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+        /**
+         * Returns the raw JSON value of [serverLabel].
+         *
+         * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("server_label")
+        @ExcludeMissing
+        fun _serverLabel(): JsonField<String> = serverLabel
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [McpApprovalRequest].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .arguments()
+             * .name()
+             * .serverLabel()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [McpApprovalRequest]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var arguments: JsonField<String>? = null
+            private var name: JsonField<String>? = null
+            private var serverLabel: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("mcp_approval_request")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(mcpApprovalRequest: McpApprovalRequest) = apply {
+                id = mcpApprovalRequest.id
+                arguments = mcpApprovalRequest.arguments
+                name = mcpApprovalRequest.name
+                serverLabel = mcpApprovalRequest.serverLabel
+                type = mcpApprovalRequest.type
+                agent = mcpApprovalRequest.agent
+                additionalProperties = mcpApprovalRequest.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the approval request. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** A JSON string of arguments for the tool. */
+            fun arguments(arguments: String) = arguments(JsonField.of(arguments))
+
+            /**
+             * Sets [Builder.arguments] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.arguments] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
+
+            /** The name of the tool to run. */
+            fun name(name: String) = name(JsonField.of(name))
+
+            /**
+             * Sets [Builder.name] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.name] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun name(name: JsonField<String>) = apply { this.name = name }
+
+            /** The label of the MCP server making the request. */
+            fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
+
+            /**
+             * Sets [Builder.serverLabel] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serverLabel] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun serverLabel(serverLabel: JsonField<String>) = apply {
+                this.serverLabel = serverLabel
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("mcp_approval_request")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [McpApprovalRequest].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .arguments()
+             * .name()
+             * .serverLabel()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): McpApprovalRequest =
+                McpApprovalRequest(
+                    checkRequired("id", id),
+                    checkRequired("arguments", arguments),
+                    checkRequired("name", name),
+                    checkRequired("serverLabel", serverLabel),
+                    type,
+                    agent,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): McpApprovalRequest = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            arguments()
+            name()
+            serverLabel()
+            _type().let {
+                if (it != JsonValue.from("mcp_approval_request")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (arguments.asKnown().isPresent) 1 else 0) +
+                (if (name.asKnown().isPresent) 1 else 0) +
+                (if (serverLabel.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("mcp_approval_request")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is McpApprovalRequest &&
+                id == other.id &&
+                arguments == other.arguments &&
+                name == other.name &&
+                serverLabel == other.serverLabel &&
+                type == other.type &&
+                agent == other.agent &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, arguments, name, serverLabel, type, agent, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "McpApprovalRequest{id=$id, arguments=$arguments, name=$name, serverLabel=$serverLabel, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+    }
+
+    /** A response to an MCP approval request. */
+    class McpApprovalResponse
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val approvalRequestId: JsonField<String>,
+        private val approve: JsonField<Boolean>,
+        private val type: JsonValue,
+        private val agent: JsonField<Agent>,
+        private val reason: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("approval_request_id")
+            @ExcludeMissing
+            approvalRequestId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("approve") @ExcludeMissing approve: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+            @JsonProperty("reason") @ExcludeMissing reason: JsonField<String> = JsonMissing.of(),
+        ) : this(id, approvalRequestId, approve, type, agent, reason, mutableMapOf())
+
+        /**
+         * The unique ID of the approval response
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The ID of the approval request being answered.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun approvalRequestId(): String = approvalRequestId.getRequired("approval_request_id")
+
+        /**
+         * Whether the request was approved.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun approve(): Boolean = approve.getRequired("approve")
+
+        /**
+         * The type of the item. Always `mcp_approval_response`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("mcp_approval_response")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+        /**
+         * Optional reason for the decision.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun reason(): Optional<String> = reason.getOptional("reason")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [approvalRequestId].
+         *
+         * Unlike [approvalRequestId], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("approval_request_id")
+        @ExcludeMissing
+        fun _approvalRequestId(): JsonField<String> = approvalRequestId
+
+        /**
+         * Returns the raw JSON value of [approve].
+         *
+         * Unlike [approve], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("approve") @ExcludeMissing fun _approve(): JsonField<Boolean> = approve
+
+        /**
+         * Returns the raw JSON value of [agent].
+         *
+         * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+        /**
+         * Returns the raw JSON value of [reason].
+         *
+         * Unlike [reason], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("reason") @ExcludeMissing fun _reason(): JsonField<String> = reason
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [McpApprovalResponse].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .approvalRequestId()
+             * .approve()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [McpApprovalResponse]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var approvalRequestId: JsonField<String>? = null
+            private var approve: JsonField<Boolean>? = null
+            private var type: JsonValue = JsonValue.from("mcp_approval_response")
+            private var agent: JsonField<Agent> = JsonMissing.of()
+            private var reason: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(mcpApprovalResponse: McpApprovalResponse) = apply {
+                id = mcpApprovalResponse.id
+                approvalRequestId = mcpApprovalResponse.approvalRequestId
+                approve = mcpApprovalResponse.approve
+                type = mcpApprovalResponse.type
+                agent = mcpApprovalResponse.agent
+                reason = mcpApprovalResponse.reason
+                additionalProperties = mcpApprovalResponse.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the approval response */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The ID of the approval request being answered. */
+            fun approvalRequestId(approvalRequestId: String) =
+                approvalRequestId(JsonField.of(approvalRequestId))
+
+            /**
+             * Sets [Builder.approvalRequestId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.approvalRequestId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun approvalRequestId(approvalRequestId: JsonField<String>) = apply {
+                this.approvalRequestId = approvalRequestId
+            }
+
+            /** Whether the request was approved. */
+            fun approve(approve: Boolean) = approve(JsonField.of(approve))
+
+            /**
+             * Sets [Builder.approve] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.approve] with a well-typed [Boolean] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun approve(approve: JsonField<Boolean>) = apply { this.approve = approve }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("mcp_approval_response")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The agent that produced this item. */
+            fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+            /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+            fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+            /**
+             * Sets [Builder.agent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+            /** Optional reason for the decision. */
+            fun reason(reason: String?) = reason(JsonField.ofNullable(reason))
+
+            /** Alias for calling [Builder.reason] with `reason.orElse(null)`. */
+            fun reason(reason: Optional<String>) = reason(reason.getOrNull())
+
+            /**
+             * Sets [Builder.reason] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.reason] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun reason(reason: JsonField<String>) = apply { this.reason = reason }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [McpApprovalResponse].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .approvalRequestId()
+             * .approve()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): McpApprovalResponse =
+                McpApprovalResponse(
+                    checkRequired("id", id),
+                    checkRequired("approvalRequestId", approvalRequestId),
+                    checkRequired("approve", approve),
+                    type,
+                    agent,
+                    reason,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): McpApprovalResponse = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            approvalRequestId()
+            approve()
+            _type().let {
+                if (it != JsonValue.from("mcp_approval_response")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            agent().ifPresent { it.validate() }
+            reason()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (approvalRequestId.asKnown().isPresent) 1 else 0) +
+                (if (approve.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("mcp_approval_response")) 1 else 0 } +
+                (agent.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (reason.asKnown().isPresent) 1 else 0)
+
+        /** The agent that produced this item. */
+        class Agent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val agentName: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("agent_name")
+                @ExcludeMissing
+                agentName: JsonField<String> = JsonMissing.of()
+            ) : this(agentName, mutableMapOf())
+
+            /**
+             * The canonical name of the agent that produced this item.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun agentName(): String = agentName.getRequired("agent_name")
+
+            /**
+             * Returns the raw JSON value of [agentName].
+             *
+             * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            fun _agentName(): JsonField<String> = agentName
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Agent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Agent]. */
+            class Builder internal constructor() {
+
+                private var agentName: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(agent: Agent) = apply {
+                    agentName = agent.agentName
+                    additionalProperties = agent.additionalProperties.toMutableMap()
+                }
+
+                /** The canonical name of the agent that produced this item. */
+                fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+                /**
+                 * Sets [Builder.agentName] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.agentName] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Agent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .agentName()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Agent =
+                    Agent(
+                        checkRequired("agentName", agentName),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Agent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                agentName()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Agent &&
+                    agentName == other.agentName &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is McpApprovalResponse &&
+                id == other.id &&
+                approvalRequestId == other.approvalRequestId &&
+                approve == other.approve &&
+                type == other.type &&
+                agent == other.agent &&
+                reason == other.reason &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, approvalRequestId, approve, type, agent, reason, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "McpApprovalResponse{id=$id, approvalRequestId=$approvalRequestId, approve=$approve, type=$type, agent=$agent, reason=$reason, additionalProperties=$additionalProperties}"
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemAddedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemAddedEvent.kt
new file mode 100644
index 000000000..c658a526c
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemAddedEvent.kt
@@ -0,0 +1,699 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a new output item is added. */
+class BetaResponseOutputItemAddedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val item: JsonField<BetaResponseOutputItem>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item")
+        @ExcludeMissing
+        item: JsonField<BetaResponseOutputItem> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(item, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The output item that was added.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun item(): BetaResponseOutputItem = item.getRequired("item")
+
+    /**
+     * The index of the output item that was added.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.output_item.added`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.output_item.added")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [item].
+     *
+     * Unlike [item], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item") @ExcludeMissing fun _item(): JsonField<BetaResponseOutputItem> = item
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseOutputItemAddedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .item()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseOutputItemAddedEvent]. */
+    class Builder internal constructor() {
+
+        private var item: JsonField<BetaResponseOutputItem>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.output_item.added")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseOutputItemAddedEvent: BetaResponseOutputItemAddedEvent) =
+            apply {
+                item = betaResponseOutputItemAddedEvent.item
+                outputIndex = betaResponseOutputItemAddedEvent.outputIndex
+                sequenceNumber = betaResponseOutputItemAddedEvent.sequenceNumber
+                type = betaResponseOutputItemAddedEvent.type
+                agent = betaResponseOutputItemAddedEvent.agent
+                additionalProperties =
+                    betaResponseOutputItemAddedEvent.additionalProperties.toMutableMap()
+            }
+
+        /** The output item that was added. */
+        fun item(item: BetaResponseOutputItem) = item(JsonField.of(item))
+
+        /**
+         * Sets [Builder.item] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.item] with a well-typed [BetaResponseOutputItem] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun item(item: JsonField<BetaResponseOutputItem>) = apply { this.item = item }
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofMessage(message)`. */
+        fun item(message: BetaResponseOutputMessage) =
+            item(BetaResponseOutputItem.ofMessage(message))
+
+        /**
+         * Alias for calling [item] with `BetaResponseOutputItem.ofFileSearchCall(fileSearchCall)`.
+         */
+        fun item(fileSearchCall: BetaResponseFileSearchToolCall) =
+            item(BetaResponseOutputItem.ofFileSearchCall(fileSearchCall))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofFunctionCall(functionCall)`. */
+        fun item(functionCall: BetaResponseFunctionToolCall) =
+            item(BetaResponseOutputItem.ofFunctionCall(functionCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofFunctionCallOutput(functionCallOutput)`.
+         */
+        fun item(functionCallOutput: BetaResponseFunctionToolCallOutputItem) =
+            item(BetaResponseOutputItem.ofFunctionCallOutput(functionCallOutput))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofAgentMessage(agentMessage)`. */
+        fun item(agentMessage: BetaResponseOutputItem.AgentMessage) =
+            item(BetaResponseOutputItem.ofAgentMessage(agentMessage))
+
+        /**
+         * Alias for calling [item] with `BetaResponseOutputItem.ofMultiAgentCall(multiAgentCall)`.
+         */
+        fun item(multiAgentCall: BetaResponseOutputItem.MultiAgentCall) =
+            item(BetaResponseOutputItem.ofMultiAgentCall(multiAgentCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofMultiAgentCallOutput(multiAgentCallOutput)`.
+         */
+        fun item(multiAgentCallOutput: BetaResponseOutputItem.MultiAgentCallOutput) =
+            item(BetaResponseOutputItem.ofMultiAgentCallOutput(multiAgentCallOutput))
+
+        /**
+         * Alias for calling [item] with `BetaResponseOutputItem.ofWebSearchCall(webSearchCall)`.
+         */
+        fun item(webSearchCall: BetaResponseFunctionWebSearch) =
+            item(BetaResponseOutputItem.ofWebSearchCall(webSearchCall))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofComputerCall(computerCall)`. */
+        fun item(computerCall: BetaResponseComputerToolCall) =
+            item(BetaResponseOutputItem.ofComputerCall(computerCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofComputerCallOutput(computerCallOutput)`.
+         */
+        fun item(computerCallOutput: BetaResponseComputerToolCallOutputItem) =
+            item(BetaResponseOutputItem.ofComputerCallOutput(computerCallOutput))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofReasoning(reasoning)`. */
+        fun item(reasoning: BetaResponseReasoningItem) =
+            item(BetaResponseOutputItem.ofReasoning(reasoning))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofProgram(program)`. */
+        fun item(program: BetaResponseOutputItem.Program) =
+            item(BetaResponseOutputItem.ofProgram(program))
+
+        /**
+         * Alias for calling [item] with `BetaResponseOutputItem.ofProgramOutput(programOutput)`.
+         */
+        fun item(programOutput: BetaResponseOutputItem.ProgramOutput) =
+            item(BetaResponseOutputItem.ofProgramOutput(programOutput))
+
+        /**
+         * Alias for calling [item] with `BetaResponseOutputItem.ofToolSearchCall(toolSearchCall)`.
+         */
+        fun item(toolSearchCall: BetaResponseToolSearchCall) =
+            item(BetaResponseOutputItem.ofToolSearchCall(toolSearchCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofToolSearchOutput(toolSearchOutput)`.
+         */
+        fun item(toolSearchOutput: BetaResponseToolSearchOutputItem) =
+            item(BetaResponseOutputItem.ofToolSearchOutput(toolSearchOutput))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofAdditionalTools(additionalTools)`.
+         */
+        fun item(additionalTools: BetaResponseOutputItem.AdditionalTools) =
+            item(BetaResponseOutputItem.ofAdditionalTools(additionalTools))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofCompaction(compaction)`. */
+        fun item(compaction: BetaResponseCompactionItem) =
+            item(BetaResponseOutputItem.ofCompaction(compaction))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofImageGenerationCall(imageGenerationCall)`.
+         */
+        fun item(imageGenerationCall: BetaResponseOutputItem.ImageGenerationCall) =
+            item(BetaResponseOutputItem.ofImageGenerationCall(imageGenerationCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofCodeInterpreterCall(codeInterpreterCall)`.
+         */
+        fun item(codeInterpreterCall: BetaResponseCodeInterpreterToolCall) =
+            item(BetaResponseOutputItem.ofCodeInterpreterCall(codeInterpreterCall))
+
+        /**
+         * Alias for calling [item] with `BetaResponseOutputItem.ofLocalShellCall(localShellCall)`.
+         */
+        fun item(localShellCall: BetaResponseOutputItem.LocalShellCall) =
+            item(BetaResponseOutputItem.ofLocalShellCall(localShellCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofLocalShellCallOutput(localShellCallOutput)`.
+         */
+        fun item(localShellCallOutput: BetaResponseOutputItem.LocalShellCallOutput) =
+            item(BetaResponseOutputItem.ofLocalShellCallOutput(localShellCallOutput))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofShellCall(shellCall)`. */
+        fun item(shellCall: BetaResponseFunctionShellToolCall) =
+            item(BetaResponseOutputItem.ofShellCall(shellCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofShellCallOutput(shellCallOutput)`.
+         */
+        fun item(shellCallOutput: BetaResponseFunctionShellToolCallOutput) =
+            item(BetaResponseOutputItem.ofShellCallOutput(shellCallOutput))
+
+        /**
+         * Alias for calling [item] with `BetaResponseOutputItem.ofApplyPatchCall(applyPatchCall)`.
+         */
+        fun item(applyPatchCall: BetaResponseApplyPatchToolCall) =
+            item(BetaResponseOutputItem.ofApplyPatchCall(applyPatchCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofApplyPatchCallOutput(applyPatchCallOutput)`.
+         */
+        fun item(applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput) =
+            item(BetaResponseOutputItem.ofApplyPatchCallOutput(applyPatchCallOutput))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofMcpCall(mcpCall)`. */
+        fun item(mcpCall: BetaResponseOutputItem.McpCall) =
+            item(BetaResponseOutputItem.ofMcpCall(mcpCall))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofMcpListTools(mcpListTools)`. */
+        fun item(mcpListTools: BetaResponseOutputItem.McpListTools) =
+            item(BetaResponseOutputItem.ofMcpListTools(mcpListTools))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofMcpApprovalRequest(mcpApprovalRequest)`.
+         */
+        fun item(mcpApprovalRequest: BetaResponseOutputItem.McpApprovalRequest) =
+            item(BetaResponseOutputItem.ofMcpApprovalRequest(mcpApprovalRequest))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofMcpApprovalResponse(mcpApprovalResponse)`.
+         */
+        fun item(mcpApprovalResponse: BetaResponseOutputItem.McpApprovalResponse) =
+            item(BetaResponseOutputItem.ofMcpApprovalResponse(mcpApprovalResponse))
+
+        /**
+         * Alias for calling [item] with `BetaResponseOutputItem.ofCustomToolCall(customToolCall)`.
+         */
+        fun item(customToolCall: BetaResponseCustomToolCall) =
+            item(BetaResponseOutputItem.ofCustomToolCall(customToolCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofCustomToolCallOutput(customToolCallOutput)`.
+         */
+        fun item(customToolCallOutput: BetaResponseCustomToolCallOutputItem) =
+            item(BetaResponseOutputItem.ofCustomToolCallOutput(customToolCallOutput))
+
+        /** The index of the output item that was added. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.output_item.added")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseOutputItemAddedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .item()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseOutputItemAddedEvent =
+            BetaResponseOutputItemAddedEvent(
+                checkRequired("item", item),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseOutputItemAddedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        item().validate()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.output_item.added")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (item.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.output_item.added")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseOutputItemAddedEvent &&
+            item == other.item &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(item, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseOutputItemAddedEvent{item=$item, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemDoneEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemDoneEvent.kt
new file mode 100644
index 000000000..eeaed3271
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemDoneEvent.kt
@@ -0,0 +1,699 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when an output item is marked done. */
+class BetaResponseOutputItemDoneEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val item: JsonField<BetaResponseOutputItem>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item")
+        @ExcludeMissing
+        item: JsonField<BetaResponseOutputItem> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(item, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The output item that was marked done.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun item(): BetaResponseOutputItem = item.getRequired("item")
+
+    /**
+     * The index of the output item that was marked done.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.output_item.done`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.output_item.done")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [item].
+     *
+     * Unlike [item], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item") @ExcludeMissing fun _item(): JsonField<BetaResponseOutputItem> = item
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseOutputItemDoneEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .item()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseOutputItemDoneEvent]. */
+    class Builder internal constructor() {
+
+        private var item: JsonField<BetaResponseOutputItem>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.output_item.done")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseOutputItemDoneEvent: BetaResponseOutputItemDoneEvent) =
+            apply {
+                item = betaResponseOutputItemDoneEvent.item
+                outputIndex = betaResponseOutputItemDoneEvent.outputIndex
+                sequenceNumber = betaResponseOutputItemDoneEvent.sequenceNumber
+                type = betaResponseOutputItemDoneEvent.type
+                agent = betaResponseOutputItemDoneEvent.agent
+                additionalProperties =
+                    betaResponseOutputItemDoneEvent.additionalProperties.toMutableMap()
+            }
+
+        /** The output item that was marked done. */
+        fun item(item: BetaResponseOutputItem) = item(JsonField.of(item))
+
+        /**
+         * Sets [Builder.item] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.item] with a well-typed [BetaResponseOutputItem] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun item(item: JsonField<BetaResponseOutputItem>) = apply { this.item = item }
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofMessage(message)`. */
+        fun item(message: BetaResponseOutputMessage) =
+            item(BetaResponseOutputItem.ofMessage(message))
+
+        /**
+         * Alias for calling [item] with `BetaResponseOutputItem.ofFileSearchCall(fileSearchCall)`.
+         */
+        fun item(fileSearchCall: BetaResponseFileSearchToolCall) =
+            item(BetaResponseOutputItem.ofFileSearchCall(fileSearchCall))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofFunctionCall(functionCall)`. */
+        fun item(functionCall: BetaResponseFunctionToolCall) =
+            item(BetaResponseOutputItem.ofFunctionCall(functionCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofFunctionCallOutput(functionCallOutput)`.
+         */
+        fun item(functionCallOutput: BetaResponseFunctionToolCallOutputItem) =
+            item(BetaResponseOutputItem.ofFunctionCallOutput(functionCallOutput))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofAgentMessage(agentMessage)`. */
+        fun item(agentMessage: BetaResponseOutputItem.AgentMessage) =
+            item(BetaResponseOutputItem.ofAgentMessage(agentMessage))
+
+        /**
+         * Alias for calling [item] with `BetaResponseOutputItem.ofMultiAgentCall(multiAgentCall)`.
+         */
+        fun item(multiAgentCall: BetaResponseOutputItem.MultiAgentCall) =
+            item(BetaResponseOutputItem.ofMultiAgentCall(multiAgentCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofMultiAgentCallOutput(multiAgentCallOutput)`.
+         */
+        fun item(multiAgentCallOutput: BetaResponseOutputItem.MultiAgentCallOutput) =
+            item(BetaResponseOutputItem.ofMultiAgentCallOutput(multiAgentCallOutput))
+
+        /**
+         * Alias for calling [item] with `BetaResponseOutputItem.ofWebSearchCall(webSearchCall)`.
+         */
+        fun item(webSearchCall: BetaResponseFunctionWebSearch) =
+            item(BetaResponseOutputItem.ofWebSearchCall(webSearchCall))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofComputerCall(computerCall)`. */
+        fun item(computerCall: BetaResponseComputerToolCall) =
+            item(BetaResponseOutputItem.ofComputerCall(computerCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofComputerCallOutput(computerCallOutput)`.
+         */
+        fun item(computerCallOutput: BetaResponseComputerToolCallOutputItem) =
+            item(BetaResponseOutputItem.ofComputerCallOutput(computerCallOutput))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofReasoning(reasoning)`. */
+        fun item(reasoning: BetaResponseReasoningItem) =
+            item(BetaResponseOutputItem.ofReasoning(reasoning))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofProgram(program)`. */
+        fun item(program: BetaResponseOutputItem.Program) =
+            item(BetaResponseOutputItem.ofProgram(program))
+
+        /**
+         * Alias for calling [item] with `BetaResponseOutputItem.ofProgramOutput(programOutput)`.
+         */
+        fun item(programOutput: BetaResponseOutputItem.ProgramOutput) =
+            item(BetaResponseOutputItem.ofProgramOutput(programOutput))
+
+        /**
+         * Alias for calling [item] with `BetaResponseOutputItem.ofToolSearchCall(toolSearchCall)`.
+         */
+        fun item(toolSearchCall: BetaResponseToolSearchCall) =
+            item(BetaResponseOutputItem.ofToolSearchCall(toolSearchCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofToolSearchOutput(toolSearchOutput)`.
+         */
+        fun item(toolSearchOutput: BetaResponseToolSearchOutputItem) =
+            item(BetaResponseOutputItem.ofToolSearchOutput(toolSearchOutput))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofAdditionalTools(additionalTools)`.
+         */
+        fun item(additionalTools: BetaResponseOutputItem.AdditionalTools) =
+            item(BetaResponseOutputItem.ofAdditionalTools(additionalTools))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofCompaction(compaction)`. */
+        fun item(compaction: BetaResponseCompactionItem) =
+            item(BetaResponseOutputItem.ofCompaction(compaction))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofImageGenerationCall(imageGenerationCall)`.
+         */
+        fun item(imageGenerationCall: BetaResponseOutputItem.ImageGenerationCall) =
+            item(BetaResponseOutputItem.ofImageGenerationCall(imageGenerationCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofCodeInterpreterCall(codeInterpreterCall)`.
+         */
+        fun item(codeInterpreterCall: BetaResponseCodeInterpreterToolCall) =
+            item(BetaResponseOutputItem.ofCodeInterpreterCall(codeInterpreterCall))
+
+        /**
+         * Alias for calling [item] with `BetaResponseOutputItem.ofLocalShellCall(localShellCall)`.
+         */
+        fun item(localShellCall: BetaResponseOutputItem.LocalShellCall) =
+            item(BetaResponseOutputItem.ofLocalShellCall(localShellCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofLocalShellCallOutput(localShellCallOutput)`.
+         */
+        fun item(localShellCallOutput: BetaResponseOutputItem.LocalShellCallOutput) =
+            item(BetaResponseOutputItem.ofLocalShellCallOutput(localShellCallOutput))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofShellCall(shellCall)`. */
+        fun item(shellCall: BetaResponseFunctionShellToolCall) =
+            item(BetaResponseOutputItem.ofShellCall(shellCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofShellCallOutput(shellCallOutput)`.
+         */
+        fun item(shellCallOutput: BetaResponseFunctionShellToolCallOutput) =
+            item(BetaResponseOutputItem.ofShellCallOutput(shellCallOutput))
+
+        /**
+         * Alias for calling [item] with `BetaResponseOutputItem.ofApplyPatchCall(applyPatchCall)`.
+         */
+        fun item(applyPatchCall: BetaResponseApplyPatchToolCall) =
+            item(BetaResponseOutputItem.ofApplyPatchCall(applyPatchCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofApplyPatchCallOutput(applyPatchCallOutput)`.
+         */
+        fun item(applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput) =
+            item(BetaResponseOutputItem.ofApplyPatchCallOutput(applyPatchCallOutput))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofMcpCall(mcpCall)`. */
+        fun item(mcpCall: BetaResponseOutputItem.McpCall) =
+            item(BetaResponseOutputItem.ofMcpCall(mcpCall))
+
+        /** Alias for calling [item] with `BetaResponseOutputItem.ofMcpListTools(mcpListTools)`. */
+        fun item(mcpListTools: BetaResponseOutputItem.McpListTools) =
+            item(BetaResponseOutputItem.ofMcpListTools(mcpListTools))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofMcpApprovalRequest(mcpApprovalRequest)`.
+         */
+        fun item(mcpApprovalRequest: BetaResponseOutputItem.McpApprovalRequest) =
+            item(BetaResponseOutputItem.ofMcpApprovalRequest(mcpApprovalRequest))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofMcpApprovalResponse(mcpApprovalResponse)`.
+         */
+        fun item(mcpApprovalResponse: BetaResponseOutputItem.McpApprovalResponse) =
+            item(BetaResponseOutputItem.ofMcpApprovalResponse(mcpApprovalResponse))
+
+        /**
+         * Alias for calling [item] with `BetaResponseOutputItem.ofCustomToolCall(customToolCall)`.
+         */
+        fun item(customToolCall: BetaResponseCustomToolCall) =
+            item(BetaResponseOutputItem.ofCustomToolCall(customToolCall))
+
+        /**
+         * Alias for calling [item] with
+         * `BetaResponseOutputItem.ofCustomToolCallOutput(customToolCallOutput)`.
+         */
+        fun item(customToolCallOutput: BetaResponseCustomToolCallOutputItem) =
+            item(BetaResponseOutputItem.ofCustomToolCallOutput(customToolCallOutput))
+
+        /** The index of the output item that was marked done. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.output_item.done")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseOutputItemDoneEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .item()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseOutputItemDoneEvent =
+            BetaResponseOutputItemDoneEvent(
+                checkRequired("item", item),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseOutputItemDoneEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        item().validate()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.output_item.done")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (item.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.output_item.done")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseOutputItemDoneEvent &&
+            item == other.item &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(item, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseOutputItemDoneEvent{item=$item, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputMessage.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputMessage.kt
new file mode 100644
index 000000000..c8cbe2980
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputMessage.kt
@@ -0,0 +1,1140 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** An output message from the model. */
+class BetaResponseOutputMessage
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val content: JsonField<List<Content>>,
+    private val role: JsonValue,
+    private val status: JsonField<Status>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val phase: JsonField<Phase>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("content")
+        @ExcludeMissing
+        content: JsonField<List<Content>> = JsonMissing.of(),
+        @JsonProperty("role") @ExcludeMissing role: JsonValue = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("phase") @ExcludeMissing phase: JsonField<Phase> = JsonMissing.of(),
+    ) : this(id, content, role, status, type, agent, phase, mutableMapOf())
+
+    /**
+     * The unique ID of the output message.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * The content of the output message.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun content(): List<Content> = content.getRequired("content")
+
+    /**
+     * The role of the output message. Always `assistant`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("assistant")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("role") @ExcludeMissing fun _role(): JsonValue = role
+
+    /**
+     * The status of the message input. One of `in_progress`, `completed`, or `incomplete`.
+     * Populated when input items are returned via API.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun status(): Status = status.getRequired("status")
+
+    /**
+     * The type of the output message. Always `message`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("message")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Labels an `assistant` message as intermediate commentary (`commentary`) or the final answer
+     * (`final_answer`). For models like `gpt-5.3-codex` and beyond, when sending follow-up
+     * requests, preserve and resend phase on all assistant messages — dropping it can degrade
+     * performance. Not used for user messages.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun phase(): Optional<Phase> = phase.getOptional("phase")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [content].
+     *
+     * Unlike [content], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("content") @ExcludeMissing fun _content(): JsonField<List<Content>> = content
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [phase].
+     *
+     * Unlike [phase], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("phase") @ExcludeMissing fun _phase(): JsonField<Phase> = phase
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseOutputMessage].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .content()
+         * .status()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseOutputMessage]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var content: JsonField<MutableList<Content>>? = null
+        private var role: JsonValue = JsonValue.from("assistant")
+        private var status: JsonField<Status>? = null
+        private var type: JsonValue = JsonValue.from("message")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var phase: JsonField<Phase> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseOutputMessage: BetaResponseOutputMessage) = apply {
+            id = betaResponseOutputMessage.id
+            content = betaResponseOutputMessage.content.map { it.toMutableList() }
+            role = betaResponseOutputMessage.role
+            status = betaResponseOutputMessage.status
+            type = betaResponseOutputMessage.type
+            agent = betaResponseOutputMessage.agent
+            phase = betaResponseOutputMessage.phase
+            additionalProperties = betaResponseOutputMessage.additionalProperties.toMutableMap()
+        }
+
+        /** The unique ID of the output message. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The content of the output message. */
+        fun content(content: List<Content>) = content(JsonField.of(content))
+
+        /**
+         * Sets [Builder.content] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.content] with a well-typed `List<Content>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun content(content: JsonField<List<Content>>) = apply {
+            this.content = content.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Content] to [Builder.content].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addContent(content: Content) = apply {
+            this.content =
+                (this.content ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("content", it).add(content)
+                }
+        }
+
+        /** Alias for calling [addContent] with `Content.ofOutputText(outputText)`. */
+        fun addContent(outputText: BetaResponseOutputText) =
+            addContent(Content.ofOutputText(outputText))
+
+        /** Alias for calling [addContent] with `Content.ofRefusal(refusal)`. */
+        fun addContent(refusal: BetaResponseOutputRefusal) = addContent(Content.ofRefusal(refusal))
+
+        /**
+         * Alias for calling [addContent] with the following:
+         * ```java
+         * BetaResponseOutputRefusal.builder()
+         *     .refusal(refusal)
+         *     .build()
+         * ```
+         */
+        fun addRefusalContent(refusal: String) =
+            addContent(BetaResponseOutputRefusal.builder().refusal(refusal).build())
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("assistant")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun role(role: JsonValue) = apply { this.role = role }
+
+        /**
+         * The status of the message input. One of `in_progress`, `completed`, or `incomplete`.
+         * Populated when input items are returned via API.
+         */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("message")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /**
+         * Labels an `assistant` message as intermediate commentary (`commentary`) or the final
+         * answer (`final_answer`). For models like `gpt-5.3-codex` and beyond, when sending
+         * follow-up requests, preserve and resend phase on all assistant messages — dropping it can
+         * degrade performance. Not used for user messages.
+         */
+        fun phase(phase: Phase?) = phase(JsonField.ofNullable(phase))
+
+        /** Alias for calling [Builder.phase] with `phase.orElse(null)`. */
+        fun phase(phase: Optional<Phase>) = phase(phase.getOrNull())
+
+        /**
+         * Sets [Builder.phase] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.phase] with a well-typed [Phase] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun phase(phase: JsonField<Phase>) = apply { this.phase = phase }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseOutputMessage].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .content()
+         * .status()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseOutputMessage =
+            BetaResponseOutputMessage(
+                checkRequired("id", id),
+                checkRequired("content", content).map { it.toImmutable() },
+                role,
+                checkRequired("status", status),
+                type,
+                agent,
+                phase,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseOutputMessage = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        content().forEach { it.validate() }
+        _role().let {
+            if (it != JsonValue.from("assistant")) {
+                throw OpenAIInvalidDataException("'role' is invalid, received $it")
+            }
+        }
+        status().validate()
+        _type().let {
+            if (it != JsonValue.from("message")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        phase().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (content.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            role.let { if (it == JsonValue.from("assistant")) 1 else 0 } +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("message")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (phase.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** A text output from the model. */
+    @JsonDeserialize(using = Content.Deserializer::class)
+    @JsonSerialize(using = Content.Serializer::class)
+    class Content
+    private constructor(
+        private val outputText: BetaResponseOutputText? = null,
+        private val refusal: BetaResponseOutputRefusal? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** A text output from the model. */
+        fun outputText(): Optional<BetaResponseOutputText> = Optional.ofNullable(outputText)
+
+        /** A refusal from the model. */
+        fun refusal(): Optional<BetaResponseOutputRefusal> = Optional.ofNullable(refusal)
+
+        fun isOutputText(): Boolean = outputText != null
+
+        fun isRefusal(): Boolean = refusal != null
+
+        /** A text output from the model. */
+        fun asOutputText(): BetaResponseOutputText = outputText.getOrThrow("outputText")
+
+        /** A refusal from the model. */
+        fun asRefusal(): BetaResponseOutputRefusal = refusal.getOrThrow("refusal")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = content.accept(new Content.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitOutputText(BetaResponseOutputText outputText) {
+         *         return Optional.of(outputText.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                outputText != null -> visitor.visitOutputText(outputText)
+                refusal != null -> visitor.visitRefusal(refusal)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Content = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitOutputText(outputText: BetaResponseOutputText) {
+                        outputText.validate()
+                    }
+
+                    override fun visitRefusal(refusal: BetaResponseOutputRefusal) {
+                        refusal.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitOutputText(outputText: BetaResponseOutputText) =
+                        outputText.validity()
+
+                    override fun visitRefusal(refusal: BetaResponseOutputRefusal) =
+                        refusal.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Content && outputText == other.outputText && refusal == other.refusal
+        }
+
+        override fun hashCode(): Int = Objects.hash(outputText, refusal)
+
+        override fun toString(): String =
+            when {
+                outputText != null -> "Content{outputText=$outputText}"
+                refusal != null -> "Content{refusal=$refusal}"
+                _json != null -> "Content{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Content")
+            }
+
+        companion object {
+
+            /** A text output from the model. */
+            @JvmStatic
+            fun ofOutputText(outputText: BetaResponseOutputText) = Content(outputText = outputText)
+
+            /** A refusal from the model. */
+            @JvmStatic
+            fun ofRefusal(refusal: BetaResponseOutputRefusal) = Content(refusal = refusal)
+        }
+
+        /**
+         * An interface that defines how to map each variant of [Content] to a value of type [T].
+         */
+        interface Visitor<out T> {
+
+            /** A text output from the model. */
+            fun visitOutputText(outputText: BetaResponseOutputText): T
+
+            /** A refusal from the model. */
+            fun visitRefusal(refusal: BetaResponseOutputRefusal): T
+
+            /**
+             * Maps an unknown variant of [Content] to a value of type [T].
+             *
+             * An instance of [Content] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Content: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Content>(Content::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Content {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "output_text" -> {
+                        return tryDeserialize(node, jacksonTypeRef<BetaResponseOutputText>())?.let {
+                            Content(outputText = it, _json = json)
+                        } ?: Content(_json = json)
+                    }
+                    "refusal" -> {
+                        return tryDeserialize(node, jacksonTypeRef<BetaResponseOutputRefusal>())
+                            ?.let { Content(refusal = it, _json = json) } ?: Content(_json = json)
+                    }
+                }
+
+                return Content(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Content>(Content::class) {
+
+            override fun serialize(
+                value: Content,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.outputText != null -> generator.writeObject(value.outputText)
+                    value.refusal != null -> generator.writeObject(value.refusal)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Content")
+                }
+            }
+        }
+    }
+
+    /**
+     * The status of the message input. One of `in_progress`, `completed`, or `incomplete`.
+     * Populated when input items are returned via API.
+     */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Labels an `assistant` message as intermediate commentary (`commentary`) or the final answer
+     * (`final_answer`). For models like `gpt-5.3-codex` and beyond, when sending follow-up
+     * requests, preserve and resend phase on all assistant messages — dropping it can degrade
+     * performance. Not used for user messages.
+     */
+    class Phase @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val COMMENTARY = of("commentary")
+
+            @JvmField val FINAL_ANSWER = of("final_answer")
+
+            @JvmStatic fun of(value: String) = Phase(JsonField.of(value))
+        }
+
+        /** An enum containing [Phase]'s known values. */
+        enum class Known {
+            COMMENTARY,
+            FINAL_ANSWER,
+        }
+
+        /**
+         * An enum containing [Phase]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Phase] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            COMMENTARY,
+            FINAL_ANSWER,
+            /** An enum member indicating that [Phase] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                COMMENTARY -> Value.COMMENTARY
+                FINAL_ANSWER -> Value.FINAL_ANSWER
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                COMMENTARY -> Known.COMMENTARY
+                FINAL_ANSWER -> Known.FINAL_ANSWER
+                else -> throw OpenAIInvalidDataException("Unknown Phase: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Phase = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Phase && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseOutputMessage &&
+            id == other.id &&
+            content == other.content &&
+            role == other.role &&
+            status == other.status &&
+            type == other.type &&
+            agent == other.agent &&
+            phase == other.phase &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(id, content, role, status, type, agent, phase, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseOutputMessage{id=$id, content=$content, role=$role, status=$status, type=$type, agent=$agent, phase=$phase, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputRefusal.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputRefusal.kt
new file mode 100644
index 000000000..622525aa0
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputRefusal.kt
@@ -0,0 +1,223 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+
+/** A refusal from the model. */
+class BetaResponseOutputRefusal
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val refusal: JsonField<String>,
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("refusal") @ExcludeMissing refusal: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+    ) : this(refusal, type, mutableMapOf())
+
+    /**
+     * The refusal explanation from the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun refusal(): String = refusal.getRequired("refusal")
+
+    /**
+     * The type of the refusal. Always `refusal`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("refusal")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Returns the raw JSON value of [refusal].
+     *
+     * Unlike [refusal], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("refusal") @ExcludeMissing fun _refusal(): JsonField<String> = refusal
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseOutputRefusal].
+         *
+         * The following fields are required:
+         * ```java
+         * .refusal()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseOutputRefusal]. */
+    class Builder internal constructor() {
+
+        private var refusal: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("refusal")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseOutputRefusal: BetaResponseOutputRefusal) = apply {
+            refusal = betaResponseOutputRefusal.refusal
+            type = betaResponseOutputRefusal.type
+            additionalProperties = betaResponseOutputRefusal.additionalProperties.toMutableMap()
+        }
+
+        /** The refusal explanation from the model. */
+        fun refusal(refusal: String) = refusal(JsonField.of(refusal))
+
+        /**
+         * Sets [Builder.refusal] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.refusal] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun refusal(refusal: JsonField<String>) = apply { this.refusal = refusal }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("refusal")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseOutputRefusal].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .refusal()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseOutputRefusal =
+            BetaResponseOutputRefusal(
+                checkRequired("refusal", refusal),
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseOutputRefusal = apply {
+        if (validated) {
+            return@apply
+        }
+
+        refusal()
+        _type().let {
+            if (it != JsonValue.from("refusal")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (refusal.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("refusal")) 1 else 0 }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseOutputRefusal &&
+            refusal == other.refusal &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(refusal, type, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseOutputRefusal{refusal=$refusal, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputText.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputText.kt
new file mode 100644
index 000000000..7cd386c59
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputText.kt
@@ -0,0 +1,2514 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** A text output from the model. */
+class BetaResponseOutputText
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val annotations: JsonField<List<Annotation>>,
+    private val text: JsonField<String>,
+    private val type: JsonValue,
+    private val logprobs: JsonField<List<Logprob>>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("annotations")
+        @ExcludeMissing
+        annotations: JsonField<List<Annotation>> = JsonMissing.of(),
+        @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("logprobs")
+        @ExcludeMissing
+        logprobs: JsonField<List<Logprob>> = JsonMissing.of(),
+    ) : this(annotations, text, type, logprobs, mutableMapOf())
+
+    /**
+     * The annotations of the text output.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun annotations(): List<Annotation> = annotations.getRequired("annotations")
+
+    /**
+     * The text output from the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun text(): String = text.getRequired("text")
+
+    /**
+     * The type of the output text. Always `output_text`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("output_text")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun logprobs(): Optional<List<Logprob>> = logprobs.getOptional("logprobs")
+
+    /**
+     * Returns the raw JSON value of [annotations].
+     *
+     * Unlike [annotations], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("annotations")
+    @ExcludeMissing
+    fun _annotations(): JsonField<List<Annotation>> = annotations
+
+    /**
+     * Returns the raw JSON value of [text].
+     *
+     * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+    /**
+     * Returns the raw JSON value of [logprobs].
+     *
+     * Unlike [logprobs], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("logprobs") @ExcludeMissing fun _logprobs(): JsonField<List<Logprob>> = logprobs
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseOutputText].
+         *
+         * The following fields are required:
+         * ```java
+         * .annotations()
+         * .text()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseOutputText]. */
+    class Builder internal constructor() {
+
+        private var annotations: JsonField<MutableList<Annotation>>? = null
+        private var text: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("output_text")
+        private var logprobs: JsonField<MutableList<Logprob>>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseOutputText: BetaResponseOutputText) = apply {
+            annotations = betaResponseOutputText.annotations.map { it.toMutableList() }
+            text = betaResponseOutputText.text
+            type = betaResponseOutputText.type
+            logprobs = betaResponseOutputText.logprobs.map { it.toMutableList() }
+            additionalProperties = betaResponseOutputText.additionalProperties.toMutableMap()
+        }
+
+        /** The annotations of the text output. */
+        fun annotations(annotations: List<Annotation>) = annotations(JsonField.of(annotations))
+
+        /**
+         * Sets [Builder.annotations] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.annotations] with a well-typed `List<Annotation>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun annotations(annotations: JsonField<List<Annotation>>) = apply {
+            this.annotations = annotations.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Annotation] to [annotations].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addAnnotation(annotation: Annotation) = apply {
+            annotations =
+                (annotations ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("annotations", it).add(annotation)
+                }
+        }
+
+        /** Alias for calling [addAnnotation] with `Annotation.ofFileCitation(fileCitation)`. */
+        fun addAnnotation(fileCitation: Annotation.FileCitation) =
+            addAnnotation(Annotation.ofFileCitation(fileCitation))
+
+        /** Alias for calling [addAnnotation] with `Annotation.ofUrlCitation(urlCitation)`. */
+        fun addAnnotation(urlCitation: Annotation.UrlCitation) =
+            addAnnotation(Annotation.ofUrlCitation(urlCitation))
+
+        /**
+         * Alias for calling [addAnnotation] with
+         * `Annotation.ofContainerFileCitation(containerFileCitation)`.
+         */
+        fun addAnnotation(containerFileCitation: Annotation.ContainerFileCitation) =
+            addAnnotation(Annotation.ofContainerFileCitation(containerFileCitation))
+
+        /** Alias for calling [addAnnotation] with `Annotation.ofFilePath(filePath)`. */
+        fun addAnnotation(filePath: Annotation.FilePath) =
+            addAnnotation(Annotation.ofFilePath(filePath))
+
+        /** The text output from the model. */
+        fun text(text: String) = text(JsonField.of(text))
+
+        /**
+         * Sets [Builder.text] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.text] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun text(text: JsonField<String>) = apply { this.text = text }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("output_text")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun logprobs(logprobs: List<Logprob>) = logprobs(JsonField.of(logprobs))
+
+        /**
+         * Sets [Builder.logprobs] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.logprobs] with a well-typed `List<Logprob>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun logprobs(logprobs: JsonField<List<Logprob>>) = apply {
+            this.logprobs = logprobs.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Logprob] to [logprobs].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addLogprob(logprob: Logprob) = apply {
+            logprobs =
+                (logprobs ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("logprobs", it).add(logprob)
+                }
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseOutputText].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .annotations()
+         * .text()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseOutputText =
+            BetaResponseOutputText(
+                checkRequired("annotations", annotations).map { it.toImmutable() },
+                checkRequired("text", text),
+                type,
+                (logprobs ?: JsonMissing.of()).map { it.toImmutable() },
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseOutputText = apply {
+        if (validated) {
+            return@apply
+        }
+
+        annotations().forEach { it.validate() }
+        text()
+        _type().let {
+            if (it != JsonValue.from("output_text")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        logprobs().ifPresent { it.forEach { it.validate() } }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (annotations.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (if (text.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("output_text")) 1 else 0 } +
+            (logprobs.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+    /** An annotation that applies to a span of output text. */
+    @JsonDeserialize(using = Annotation.Deserializer::class)
+    @JsonSerialize(using = Annotation.Serializer::class)
+    class Annotation
+    private constructor(
+        private val fileCitation: FileCitation? = null,
+        private val urlCitation: UrlCitation? = null,
+        private val containerFileCitation: ContainerFileCitation? = null,
+        private val filePath: FilePath? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** A citation to a file. */
+        fun fileCitation(): Optional<FileCitation> = Optional.ofNullable(fileCitation)
+
+        /** A citation for a web resource used to generate a model response. */
+        fun urlCitation(): Optional<UrlCitation> = Optional.ofNullable(urlCitation)
+
+        /** A citation for a container file used to generate a model response. */
+        fun containerFileCitation(): Optional<ContainerFileCitation> =
+            Optional.ofNullable(containerFileCitation)
+
+        /** A path to a file. */
+        fun filePath(): Optional<FilePath> = Optional.ofNullable(filePath)
+
+        fun isFileCitation(): Boolean = fileCitation != null
+
+        fun isUrlCitation(): Boolean = urlCitation != null
+
+        fun isContainerFileCitation(): Boolean = containerFileCitation != null
+
+        fun isFilePath(): Boolean = filePath != null
+
+        /** A citation to a file. */
+        fun asFileCitation(): FileCitation = fileCitation.getOrThrow("fileCitation")
+
+        /** A citation for a web resource used to generate a model response. */
+        fun asUrlCitation(): UrlCitation = urlCitation.getOrThrow("urlCitation")
+
+        /** A citation for a container file used to generate a model response. */
+        fun asContainerFileCitation(): ContainerFileCitation =
+            containerFileCitation.getOrThrow("containerFileCitation")
+
+        /** A path to a file. */
+        fun asFilePath(): FilePath = filePath.getOrThrow("filePath")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = annotation.accept(new Annotation.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitFileCitation(FileCitation fileCitation) {
+         *         return Optional.of(fileCitation.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                fileCitation != null -> visitor.visitFileCitation(fileCitation)
+                urlCitation != null -> visitor.visitUrlCitation(urlCitation)
+                containerFileCitation != null ->
+                    visitor.visitContainerFileCitation(containerFileCitation)
+                filePath != null -> visitor.visitFilePath(filePath)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Annotation = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitFileCitation(fileCitation: FileCitation) {
+                        fileCitation.validate()
+                    }
+
+                    override fun visitUrlCitation(urlCitation: UrlCitation) {
+                        urlCitation.validate()
+                    }
+
+                    override fun visitContainerFileCitation(
+                        containerFileCitation: ContainerFileCitation
+                    ) {
+                        containerFileCitation.validate()
+                    }
+
+                    override fun visitFilePath(filePath: FilePath) {
+                        filePath.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitFileCitation(fileCitation: FileCitation) =
+                        fileCitation.validity()
+
+                    override fun visitUrlCitation(urlCitation: UrlCitation) = urlCitation.validity()
+
+                    override fun visitContainerFileCitation(
+                        containerFileCitation: ContainerFileCitation
+                    ) = containerFileCitation.validity()
+
+                    override fun visitFilePath(filePath: FilePath) = filePath.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Annotation &&
+                fileCitation == other.fileCitation &&
+                urlCitation == other.urlCitation &&
+                containerFileCitation == other.containerFileCitation &&
+                filePath == other.filePath
+        }
+
+        override fun hashCode(): Int =
+            Objects.hash(fileCitation, urlCitation, containerFileCitation, filePath)
+
+        override fun toString(): String =
+            when {
+                fileCitation != null -> "Annotation{fileCitation=$fileCitation}"
+                urlCitation != null -> "Annotation{urlCitation=$urlCitation}"
+                containerFileCitation != null ->
+                    "Annotation{containerFileCitation=$containerFileCitation}"
+                filePath != null -> "Annotation{filePath=$filePath}"
+                _json != null -> "Annotation{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Annotation")
+            }
+
+        companion object {
+
+            /** A citation to a file. */
+            @JvmStatic
+            fun ofFileCitation(fileCitation: FileCitation) = Annotation(fileCitation = fileCitation)
+
+            /** A citation for a web resource used to generate a model response. */
+            @JvmStatic
+            fun ofUrlCitation(urlCitation: UrlCitation) = Annotation(urlCitation = urlCitation)
+
+            /** A citation for a container file used to generate a model response. */
+            @JvmStatic
+            fun ofContainerFileCitation(containerFileCitation: ContainerFileCitation) =
+                Annotation(containerFileCitation = containerFileCitation)
+
+            /** A path to a file. */
+            @JvmStatic fun ofFilePath(filePath: FilePath) = Annotation(filePath = filePath)
+        }
+
+        /**
+         * An interface that defines how to map each variant of [Annotation] to a value of type [T].
+         */
+        interface Visitor<out T> {
+
+            /** A citation to a file. */
+            fun visitFileCitation(fileCitation: FileCitation): T
+
+            /** A citation for a web resource used to generate a model response. */
+            fun visitUrlCitation(urlCitation: UrlCitation): T
+
+            /** A citation for a container file used to generate a model response. */
+            fun visitContainerFileCitation(containerFileCitation: ContainerFileCitation): T
+
+            /** A path to a file. */
+            fun visitFilePath(filePath: FilePath): T
+
+            /**
+             * Maps an unknown variant of [Annotation] to a value of type [T].
+             *
+             * An instance of [Annotation] can contain an unknown variant if it was deserialized
+             * from data that doesn't match any known variant. For example, if the SDK is on an
+             * older version than the API, then the API may respond with new variants that the SDK
+             * is unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Annotation: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Annotation>(Annotation::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Annotation {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "file_citation" -> {
+                        return tryDeserialize(node, jacksonTypeRef<FileCitation>())?.let {
+                            Annotation(fileCitation = it, _json = json)
+                        } ?: Annotation(_json = json)
+                    }
+                    "url_citation" -> {
+                        return tryDeserialize(node, jacksonTypeRef<UrlCitation>())?.let {
+                            Annotation(urlCitation = it, _json = json)
+                        } ?: Annotation(_json = json)
+                    }
+                    "container_file_citation" -> {
+                        return tryDeserialize(node, jacksonTypeRef<ContainerFileCitation>())?.let {
+                            Annotation(containerFileCitation = it, _json = json)
+                        } ?: Annotation(_json = json)
+                    }
+                    "file_path" -> {
+                        return tryDeserialize(node, jacksonTypeRef<FilePath>())?.let {
+                            Annotation(filePath = it, _json = json)
+                        } ?: Annotation(_json = json)
+                    }
+                }
+
+                return Annotation(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Annotation>(Annotation::class) {
+
+            override fun serialize(
+                value: Annotation,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.fileCitation != null -> generator.writeObject(value.fileCitation)
+                    value.urlCitation != null -> generator.writeObject(value.urlCitation)
+                    value.containerFileCitation != null ->
+                        generator.writeObject(value.containerFileCitation)
+                    value.filePath != null -> generator.writeObject(value.filePath)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Annotation")
+                }
+            }
+        }
+
+        /** A citation to a file. */
+        class FileCitation
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val fileId: JsonField<String>,
+            private val filename: JsonField<String>,
+            private val index: JsonField<Long>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("file_id")
+                @ExcludeMissing
+                fileId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("filename")
+                @ExcludeMissing
+                filename: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("index") @ExcludeMissing index: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(fileId, filename, index, type, mutableMapOf())
+
+            /**
+             * The ID of the file.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun fileId(): String = fileId.getRequired("file_id")
+
+            /**
+             * The filename of the file cited.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun filename(): String = filename.getRequired("filename")
+
+            /**
+             * The index of the file in the list of files.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun index(): Long = index.getRequired("index")
+
+            /**
+             * The type of the file citation. Always `file_citation`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("file_citation")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [fileId].
+             *
+             * Unlike [fileId], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("file_id") @ExcludeMissing fun _fileId(): JsonField<String> = fileId
+
+            /**
+             * Returns the raw JSON value of [filename].
+             *
+             * Unlike [filename], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("filename") @ExcludeMissing fun _filename(): JsonField<String> = filename
+
+            /**
+             * Returns the raw JSON value of [index].
+             *
+             * Unlike [index], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("index") @ExcludeMissing fun _index(): JsonField<Long> = index
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [FileCitation].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .fileId()
+                 * .filename()
+                 * .index()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [FileCitation]. */
+            class Builder internal constructor() {
+
+                private var fileId: JsonField<String>? = null
+                private var filename: JsonField<String>? = null
+                private var index: JsonField<Long>? = null
+                private var type: JsonValue = JsonValue.from("file_citation")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(fileCitation: FileCitation) = apply {
+                    fileId = fileCitation.fileId
+                    filename = fileCitation.filename
+                    index = fileCitation.index
+                    type = fileCitation.type
+                    additionalProperties = fileCitation.additionalProperties.toMutableMap()
+                }
+
+                /** The ID of the file. */
+                fun fileId(fileId: String) = fileId(JsonField.of(fileId))
+
+                /**
+                 * Sets [Builder.fileId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.fileId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun fileId(fileId: JsonField<String>) = apply { this.fileId = fileId }
+
+                /** The filename of the file cited. */
+                fun filename(filename: String) = filename(JsonField.of(filename))
+
+                /**
+                 * Sets [Builder.filename] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.filename] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun filename(filename: JsonField<String>) = apply { this.filename = filename }
+
+                /** The index of the file in the list of files. */
+                fun index(index: Long) = index(JsonField.of(index))
+
+                /**
+                 * Sets [Builder.index] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.index] with a well-typed [Long] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun index(index: JsonField<Long>) = apply { this.index = index }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("file_citation")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [FileCitation].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .fileId()
+                 * .filename()
+                 * .index()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): FileCitation =
+                    FileCitation(
+                        checkRequired("fileId", fileId),
+                        checkRequired("filename", filename),
+                        checkRequired("index", index),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): FileCitation = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                fileId()
+                filename()
+                index()
+                _type().let {
+                    if (it != JsonValue.from("file_citation")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (fileId.asKnown().isPresent) 1 else 0) +
+                    (if (filename.asKnown().isPresent) 1 else 0) +
+                    (if (index.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("file_citation")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is FileCitation &&
+                    fileId == other.fileId &&
+                    filename == other.filename &&
+                    index == other.index &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(fileId, filename, index, type, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "FileCitation{fileId=$fileId, filename=$filename, index=$index, type=$type, additionalProperties=$additionalProperties}"
+        }
+
+        /** A citation for a web resource used to generate a model response. */
+        class UrlCitation
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val endIndex: JsonField<Long>,
+            private val startIndex: JsonField<Long>,
+            private val title: JsonField<String>,
+            private val type: JsonValue,
+            private val url: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("end_index")
+                @ExcludeMissing
+                endIndex: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("start_index")
+                @ExcludeMissing
+                startIndex: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("title") @ExcludeMissing title: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                @JsonProperty("url") @ExcludeMissing url: JsonField<String> = JsonMissing.of(),
+            ) : this(endIndex, startIndex, title, type, url, mutableMapOf())
+
+            /**
+             * The index of the last character of the URL citation in the message.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun endIndex(): Long = endIndex.getRequired("end_index")
+
+            /**
+             * The index of the first character of the URL citation in the message.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun startIndex(): Long = startIndex.getRequired("start_index")
+
+            /**
+             * The title of the web resource.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun title(): String = title.getRequired("title")
+
+            /**
+             * The type of the URL citation. Always `url_citation`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("url_citation")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * The URL of the web resource.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun url(): String = url.getRequired("url")
+
+            /**
+             * Returns the raw JSON value of [endIndex].
+             *
+             * Unlike [endIndex], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("end_index") @ExcludeMissing fun _endIndex(): JsonField<Long> = endIndex
+
+            /**
+             * Returns the raw JSON value of [startIndex].
+             *
+             * Unlike [startIndex], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("start_index")
+            @ExcludeMissing
+            fun _startIndex(): JsonField<Long> = startIndex
+
+            /**
+             * Returns the raw JSON value of [title].
+             *
+             * Unlike [title], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("title") @ExcludeMissing fun _title(): JsonField<String> = title
+
+            /**
+             * Returns the raw JSON value of [url].
+             *
+             * Unlike [url], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("url") @ExcludeMissing fun _url(): JsonField<String> = url
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [UrlCitation].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .endIndex()
+                 * .startIndex()
+                 * .title()
+                 * .url()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [UrlCitation]. */
+            class Builder internal constructor() {
+
+                private var endIndex: JsonField<Long>? = null
+                private var startIndex: JsonField<Long>? = null
+                private var title: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("url_citation")
+                private var url: JsonField<String>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(urlCitation: UrlCitation) = apply {
+                    endIndex = urlCitation.endIndex
+                    startIndex = urlCitation.startIndex
+                    title = urlCitation.title
+                    type = urlCitation.type
+                    url = urlCitation.url
+                    additionalProperties = urlCitation.additionalProperties.toMutableMap()
+                }
+
+                /** The index of the last character of the URL citation in the message. */
+                fun endIndex(endIndex: Long) = endIndex(JsonField.of(endIndex))
+
+                /**
+                 * Sets [Builder.endIndex] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.endIndex] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun endIndex(endIndex: JsonField<Long>) = apply { this.endIndex = endIndex }
+
+                /** The index of the first character of the URL citation in the message. */
+                fun startIndex(startIndex: Long) = startIndex(JsonField.of(startIndex))
+
+                /**
+                 * Sets [Builder.startIndex] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.startIndex] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun startIndex(startIndex: JsonField<Long>) = apply { this.startIndex = startIndex }
+
+                /** The title of the web resource. */
+                fun title(title: String) = title(JsonField.of(title))
+
+                /**
+                 * Sets [Builder.title] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.title] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun title(title: JsonField<String>) = apply { this.title = title }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("url_citation")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                /** The URL of the web resource. */
+                fun url(url: String) = url(JsonField.of(url))
+
+                /**
+                 * Sets [Builder.url] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.url] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun url(url: JsonField<String>) = apply { this.url = url }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [UrlCitation].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .endIndex()
+                 * .startIndex()
+                 * .title()
+                 * .url()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): UrlCitation =
+                    UrlCitation(
+                        checkRequired("endIndex", endIndex),
+                        checkRequired("startIndex", startIndex),
+                        checkRequired("title", title),
+                        type,
+                        checkRequired("url", url),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): UrlCitation = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                endIndex()
+                startIndex()
+                title()
+                _type().let {
+                    if (it != JsonValue.from("url_citation")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                url()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (endIndex.asKnown().isPresent) 1 else 0) +
+                    (if (startIndex.asKnown().isPresent) 1 else 0) +
+                    (if (title.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("url_citation")) 1 else 0 } +
+                    (if (url.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is UrlCitation &&
+                    endIndex == other.endIndex &&
+                    startIndex == other.startIndex &&
+                    title == other.title &&
+                    type == other.type &&
+                    url == other.url &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(endIndex, startIndex, title, type, url, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "UrlCitation{endIndex=$endIndex, startIndex=$startIndex, title=$title, type=$type, url=$url, additionalProperties=$additionalProperties}"
+        }
+
+        /** A citation for a container file used to generate a model response. */
+        class ContainerFileCitation
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val containerId: JsonField<String>,
+            private val endIndex: JsonField<Long>,
+            private val fileId: JsonField<String>,
+            private val filename: JsonField<String>,
+            private val startIndex: JsonField<Long>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("container_id")
+                @ExcludeMissing
+                containerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("end_index")
+                @ExcludeMissing
+                endIndex: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("file_id")
+                @ExcludeMissing
+                fileId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("filename")
+                @ExcludeMissing
+                filename: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("start_index")
+                @ExcludeMissing
+                startIndex: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(containerId, endIndex, fileId, filename, startIndex, type, mutableMapOf())
+
+            /**
+             * The ID of the container file.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun containerId(): String = containerId.getRequired("container_id")
+
+            /**
+             * The index of the last character of the container file citation in the message.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun endIndex(): Long = endIndex.getRequired("end_index")
+
+            /**
+             * The ID of the file.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun fileId(): String = fileId.getRequired("file_id")
+
+            /**
+             * The filename of the container file cited.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun filename(): String = filename.getRequired("filename")
+
+            /**
+             * The index of the first character of the container file citation in the message.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun startIndex(): Long = startIndex.getRequired("start_index")
+
+            /**
+             * The type of the container file citation. Always `container_file_citation`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("container_file_citation")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [containerId].
+             *
+             * Unlike [containerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("container_id")
+            @ExcludeMissing
+            fun _containerId(): JsonField<String> = containerId
+
+            /**
+             * Returns the raw JSON value of [endIndex].
+             *
+             * Unlike [endIndex], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("end_index") @ExcludeMissing fun _endIndex(): JsonField<Long> = endIndex
+
+            /**
+             * Returns the raw JSON value of [fileId].
+             *
+             * Unlike [fileId], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("file_id") @ExcludeMissing fun _fileId(): JsonField<String> = fileId
+
+            /**
+             * Returns the raw JSON value of [filename].
+             *
+             * Unlike [filename], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("filename") @ExcludeMissing fun _filename(): JsonField<String> = filename
+
+            /**
+             * Returns the raw JSON value of [startIndex].
+             *
+             * Unlike [startIndex], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("start_index")
+            @ExcludeMissing
+            fun _startIndex(): JsonField<Long> = startIndex
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of
+                 * [ContainerFileCitation].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .containerId()
+                 * .endIndex()
+                 * .fileId()
+                 * .filename()
+                 * .startIndex()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [ContainerFileCitation]. */
+            class Builder internal constructor() {
+
+                private var containerId: JsonField<String>? = null
+                private var endIndex: JsonField<Long>? = null
+                private var fileId: JsonField<String>? = null
+                private var filename: JsonField<String>? = null
+                private var startIndex: JsonField<Long>? = null
+                private var type: JsonValue = JsonValue.from("container_file_citation")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(containerFileCitation: ContainerFileCitation) = apply {
+                    containerId = containerFileCitation.containerId
+                    endIndex = containerFileCitation.endIndex
+                    fileId = containerFileCitation.fileId
+                    filename = containerFileCitation.filename
+                    startIndex = containerFileCitation.startIndex
+                    type = containerFileCitation.type
+                    additionalProperties = containerFileCitation.additionalProperties.toMutableMap()
+                }
+
+                /** The ID of the container file. */
+                fun containerId(containerId: String) = containerId(JsonField.of(containerId))
+
+                /**
+                 * Sets [Builder.containerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.containerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun containerId(containerId: JsonField<String>) = apply {
+                    this.containerId = containerId
+                }
+
+                /**
+                 * The index of the last character of the container file citation in the message.
+                 */
+                fun endIndex(endIndex: Long) = endIndex(JsonField.of(endIndex))
+
+                /**
+                 * Sets [Builder.endIndex] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.endIndex] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun endIndex(endIndex: JsonField<Long>) = apply { this.endIndex = endIndex }
+
+                /** The ID of the file. */
+                fun fileId(fileId: String) = fileId(JsonField.of(fileId))
+
+                /**
+                 * Sets [Builder.fileId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.fileId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun fileId(fileId: JsonField<String>) = apply { this.fileId = fileId }
+
+                /** The filename of the container file cited. */
+                fun filename(filename: String) = filename(JsonField.of(filename))
+
+                /**
+                 * Sets [Builder.filename] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.filename] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun filename(filename: JsonField<String>) = apply { this.filename = filename }
+
+                /**
+                 * The index of the first character of the container file citation in the message.
+                 */
+                fun startIndex(startIndex: Long) = startIndex(JsonField.of(startIndex))
+
+                /**
+                 * Sets [Builder.startIndex] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.startIndex] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun startIndex(startIndex: JsonField<Long>) = apply { this.startIndex = startIndex }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("container_file_citation")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [ContainerFileCitation].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .containerId()
+                 * .endIndex()
+                 * .fileId()
+                 * .filename()
+                 * .startIndex()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): ContainerFileCitation =
+                    ContainerFileCitation(
+                        checkRequired("containerId", containerId),
+                        checkRequired("endIndex", endIndex),
+                        checkRequired("fileId", fileId),
+                        checkRequired("filename", filename),
+                        checkRequired("startIndex", startIndex),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): ContainerFileCitation = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                containerId()
+                endIndex()
+                fileId()
+                filename()
+                startIndex()
+                _type().let {
+                    if (it != JsonValue.from("container_file_citation")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (containerId.asKnown().isPresent) 1 else 0) +
+                    (if (endIndex.asKnown().isPresent) 1 else 0) +
+                    (if (fileId.asKnown().isPresent) 1 else 0) +
+                    (if (filename.asKnown().isPresent) 1 else 0) +
+                    (if (startIndex.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("container_file_citation")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is ContainerFileCitation &&
+                    containerId == other.containerId &&
+                    endIndex == other.endIndex &&
+                    fileId == other.fileId &&
+                    filename == other.filename &&
+                    startIndex == other.startIndex &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(
+                    containerId,
+                    endIndex,
+                    fileId,
+                    filename,
+                    startIndex,
+                    type,
+                    additionalProperties,
+                )
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "ContainerFileCitation{containerId=$containerId, endIndex=$endIndex, fileId=$fileId, filename=$filename, startIndex=$startIndex, type=$type, additionalProperties=$additionalProperties}"
+        }
+
+        /** A path to a file. */
+        class FilePath
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val fileId: JsonField<String>,
+            private val index: JsonField<Long>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("file_id")
+                @ExcludeMissing
+                fileId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("index") @ExcludeMissing index: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(fileId, index, type, mutableMapOf())
+
+            /**
+             * The ID of the file.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun fileId(): String = fileId.getRequired("file_id")
+
+            /**
+             * The index of the file in the list of files.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun index(): Long = index.getRequired("index")
+
+            /**
+             * The type of the file path. Always `file_path`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("file_path")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [fileId].
+             *
+             * Unlike [fileId], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("file_id") @ExcludeMissing fun _fileId(): JsonField<String> = fileId
+
+            /**
+             * Returns the raw JSON value of [index].
+             *
+             * Unlike [index], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("index") @ExcludeMissing fun _index(): JsonField<Long> = index
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [FilePath].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .fileId()
+                 * .index()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [FilePath]. */
+            class Builder internal constructor() {
+
+                private var fileId: JsonField<String>? = null
+                private var index: JsonField<Long>? = null
+                private var type: JsonValue = JsonValue.from("file_path")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(filePath: FilePath) = apply {
+                    fileId = filePath.fileId
+                    index = filePath.index
+                    type = filePath.type
+                    additionalProperties = filePath.additionalProperties.toMutableMap()
+                }
+
+                /** The ID of the file. */
+                fun fileId(fileId: String) = fileId(JsonField.of(fileId))
+
+                /**
+                 * Sets [Builder.fileId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.fileId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun fileId(fileId: JsonField<String>) = apply { this.fileId = fileId }
+
+                /** The index of the file in the list of files. */
+                fun index(index: Long) = index(JsonField.of(index))
+
+                /**
+                 * Sets [Builder.index] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.index] with a well-typed [Long] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun index(index: JsonField<Long>) = apply { this.index = index }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("file_path")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [FilePath].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .fileId()
+                 * .index()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): FilePath =
+                    FilePath(
+                        checkRequired("fileId", fileId),
+                        checkRequired("index", index),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): FilePath = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                fileId()
+                index()
+                _type().let {
+                    if (it != JsonValue.from("file_path")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (fileId.asKnown().isPresent) 1 else 0) +
+                    (if (index.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("file_path")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is FilePath &&
+                    fileId == other.fileId &&
+                    index == other.index &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(fileId, index, type, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "FilePath{fileId=$fileId, index=$index, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
+    /** The log probability of a token. */
+    class Logprob
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val token: JsonField<String>,
+        private val bytes: JsonField<List<Long>>,
+        private val logprob: JsonField<Double>,
+        private val topLogprobs: JsonField<List<TopLogprob>>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("token") @ExcludeMissing token: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("bytes") @ExcludeMissing bytes: JsonField<List<Long>> = JsonMissing.of(),
+            @JsonProperty("logprob") @ExcludeMissing logprob: JsonField<Double> = JsonMissing.of(),
+            @JsonProperty("top_logprobs")
+            @ExcludeMissing
+            topLogprobs: JsonField<List<TopLogprob>> = JsonMissing.of(),
+        ) : this(token, bytes, logprob, topLogprobs, mutableMapOf())
+
+        /**
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun token(): String = token.getRequired("token")
+
+        /**
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun bytes(): List<Long> = bytes.getRequired("bytes")
+
+        /**
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun logprob(): Double = logprob.getRequired("logprob")
+
+        /**
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun topLogprobs(): List<TopLogprob> = topLogprobs.getRequired("top_logprobs")
+
+        /**
+         * Returns the raw JSON value of [token].
+         *
+         * Unlike [token], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("token") @ExcludeMissing fun _token(): JsonField<String> = token
+
+        /**
+         * Returns the raw JSON value of [bytes].
+         *
+         * Unlike [bytes], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("bytes") @ExcludeMissing fun _bytes(): JsonField<List<Long>> = bytes
+
+        /**
+         * Returns the raw JSON value of [logprob].
+         *
+         * Unlike [logprob], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("logprob") @ExcludeMissing fun _logprob(): JsonField<Double> = logprob
+
+        /**
+         * Returns the raw JSON value of [topLogprobs].
+         *
+         * Unlike [topLogprobs], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("top_logprobs")
+        @ExcludeMissing
+        fun _topLogprobs(): JsonField<List<TopLogprob>> = topLogprobs
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Logprob].
+             *
+             * The following fields are required:
+             * ```java
+             * .token()
+             * .bytes()
+             * .logprob()
+             * .topLogprobs()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Logprob]. */
+        class Builder internal constructor() {
+
+            private var token: JsonField<String>? = null
+            private var bytes: JsonField<MutableList<Long>>? = null
+            private var logprob: JsonField<Double>? = null
+            private var topLogprobs: JsonField<MutableList<TopLogprob>>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(logprob: Logprob) = apply {
+                token = logprob.token
+                bytes = logprob.bytes.map { it.toMutableList() }
+                this.logprob = logprob.logprob
+                topLogprobs = logprob.topLogprobs.map { it.toMutableList() }
+                additionalProperties = logprob.additionalProperties.toMutableMap()
+            }
+
+            fun token(token: String) = token(JsonField.of(token))
+
+            /**
+             * Sets [Builder.token] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.token] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun token(token: JsonField<String>) = apply { this.token = token }
+
+            fun bytes(bytes: List<Long>) = bytes(JsonField.of(bytes))
+
+            /**
+             * Sets [Builder.bytes] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.bytes] with a well-typed `List<Long>` value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun bytes(bytes: JsonField<List<Long>>) = apply {
+                this.bytes = bytes.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [Long] to [bytes].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addByte(byte_: Long) = apply {
+                bytes =
+                    (bytes ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("bytes", it).add(byte_)
+                    }
+            }
+
+            fun logprob(logprob: Double) = logprob(JsonField.of(logprob))
+
+            /**
+             * Sets [Builder.logprob] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.logprob] with a well-typed [Double] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun logprob(logprob: JsonField<Double>) = apply { this.logprob = logprob }
+
+            fun topLogprobs(topLogprobs: List<TopLogprob>) = topLogprobs(JsonField.of(topLogprobs))
+
+            /**
+             * Sets [Builder.topLogprobs] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.topLogprobs] with a well-typed `List<TopLogprob>`
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            fun topLogprobs(topLogprobs: JsonField<List<TopLogprob>>) = apply {
+                this.topLogprobs = topLogprobs.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [TopLogprob] to [topLogprobs].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addTopLogprob(topLogprob: TopLogprob) = apply {
+                topLogprobs =
+                    (topLogprobs ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("topLogprobs", it).add(topLogprob)
+                    }
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Logprob].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .token()
+             * .bytes()
+             * .logprob()
+             * .topLogprobs()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Logprob =
+                Logprob(
+                    checkRequired("token", token),
+                    checkRequired("bytes", bytes).map { it.toImmutable() },
+                    checkRequired("logprob", logprob),
+                    checkRequired("topLogprobs", topLogprobs).map { it.toImmutable() },
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Logprob = apply {
+            if (validated) {
+                return@apply
+            }
+
+            token()
+            bytes()
+            logprob()
+            topLogprobs().forEach { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (token.asKnown().isPresent) 1 else 0) +
+                (bytes.asKnown().getOrNull()?.size ?: 0) +
+                (if (logprob.asKnown().isPresent) 1 else 0) +
+                (topLogprobs.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+        /** The top log probability of a token. */
+        class TopLogprob
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val token: JsonField<String>,
+            private val bytes: JsonField<List<Long>>,
+            private val logprob: JsonField<Double>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("token") @ExcludeMissing token: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("bytes")
+                @ExcludeMissing
+                bytes: JsonField<List<Long>> = JsonMissing.of(),
+                @JsonProperty("logprob")
+                @ExcludeMissing
+                logprob: JsonField<Double> = JsonMissing.of(),
+            ) : this(token, bytes, logprob, mutableMapOf())
+
+            /**
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun token(): String = token.getRequired("token")
+
+            /**
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun bytes(): List<Long> = bytes.getRequired("bytes")
+
+            /**
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun logprob(): Double = logprob.getRequired("logprob")
+
+            /**
+             * Returns the raw JSON value of [token].
+             *
+             * Unlike [token], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("token") @ExcludeMissing fun _token(): JsonField<String> = token
+
+            /**
+             * Returns the raw JSON value of [bytes].
+             *
+             * Unlike [bytes], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("bytes") @ExcludeMissing fun _bytes(): JsonField<List<Long>> = bytes
+
+            /**
+             * Returns the raw JSON value of [logprob].
+             *
+             * Unlike [logprob], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("logprob") @ExcludeMissing fun _logprob(): JsonField<Double> = logprob
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [TopLogprob].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .token()
+                 * .bytes()
+                 * .logprob()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [TopLogprob]. */
+            class Builder internal constructor() {
+
+                private var token: JsonField<String>? = null
+                private var bytes: JsonField<MutableList<Long>>? = null
+                private var logprob: JsonField<Double>? = null
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(topLogprob: TopLogprob) = apply {
+                    token = topLogprob.token
+                    bytes = topLogprob.bytes.map { it.toMutableList() }
+                    logprob = topLogprob.logprob
+                    additionalProperties = topLogprob.additionalProperties.toMutableMap()
+                }
+
+                fun token(token: String) = token(JsonField.of(token))
+
+                /**
+                 * Sets [Builder.token] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.token] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun token(token: JsonField<String>) = apply { this.token = token }
+
+                fun bytes(bytes: List<Long>) = bytes(JsonField.of(bytes))
+
+                /**
+                 * Sets [Builder.bytes] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.bytes] with a well-typed `List<Long>` value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun bytes(bytes: JsonField<List<Long>>) = apply {
+                    this.bytes = bytes.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [Long] to [bytes].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addByte(byte_: Long) = apply {
+                    bytes =
+                        (bytes ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("bytes", it).add(byte_)
+                        }
+                }
+
+                fun logprob(logprob: Double) = logprob(JsonField.of(logprob))
+
+                /**
+                 * Sets [Builder.logprob] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.logprob] with a well-typed [Double] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun logprob(logprob: JsonField<Double>) = apply { this.logprob = logprob }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [TopLogprob].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .token()
+                 * .bytes()
+                 * .logprob()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): TopLogprob =
+                    TopLogprob(
+                        checkRequired("token", token),
+                        checkRequired("bytes", bytes).map { it.toImmutable() },
+                        checkRequired("logprob", logprob),
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): TopLogprob = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                token()
+                bytes()
+                logprob()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (token.asKnown().isPresent) 1 else 0) +
+                    (bytes.asKnown().getOrNull()?.size ?: 0) +
+                    (if (logprob.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is TopLogprob &&
+                    token == other.token &&
+                    bytes == other.bytes &&
+                    logprob == other.logprob &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(token, bytes, logprob, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "TopLogprob{token=$token, bytes=$bytes, logprob=$logprob, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Logprob &&
+                token == other.token &&
+                bytes == other.bytes &&
+                logprob == other.logprob &&
+                topLogprobs == other.topLogprobs &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(token, bytes, logprob, topLogprobs, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Logprob{token=$token, bytes=$bytes, logprob=$logprob, topLogprobs=$topLogprobs, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseOutputText &&
+            annotations == other.annotations &&
+            text == other.text &&
+            type == other.type &&
+            logprobs == other.logprobs &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(annotations, text, type, logprobs, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseOutputText{annotations=$annotations, text=$text, type=$type, logprobs=$logprobs, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputTextAnnotationAddedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputTextAnnotationAddedEvent.kt
new file mode 100644
index 000000000..534cca632
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseOutputTextAnnotationAddedEvent.kt
@@ -0,0 +1,645 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when an annotation is added to output text content. */
+class BetaResponseOutputTextAnnotationAddedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val annotation: JsonValue,
+    private val annotationIndex: JsonField<Long>,
+    private val contentIndex: JsonField<Long>,
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("annotation") @ExcludeMissing annotation: JsonValue = JsonMissing.of(),
+        @JsonProperty("annotation_index")
+        @ExcludeMissing
+        annotationIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("content_index")
+        @ExcludeMissing
+        contentIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(
+        annotation,
+        annotationIndex,
+        contentIndex,
+        itemId,
+        outputIndex,
+        sequenceNumber,
+        type,
+        agent,
+        mutableMapOf(),
+    )
+
+    /**
+     * The annotation object being added. (See annotation schema for details.)
+     *
+     * This arbitrary value can be deserialized into a custom type using the `convert` method:
+     * ```java
+     * MyClass myObject = betaResponseOutputTextAnnotationAddedEvent.annotation().convert(MyClass.class);
+     * ```
+     */
+    @JsonProperty("annotation") @ExcludeMissing fun _annotation(): JsonValue = annotation
+
+    /**
+     * The index of the annotation within the content part.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun annotationIndex(): Long = annotationIndex.getRequired("annotation_index")
+
+    /**
+     * The index of the content part within the output item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun contentIndex(): Long = contentIndex.getRequired("content_index")
+
+    /**
+     * The unique identifier of the item to which the annotation is being added.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item in the response's output array.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always 'response.output_text.annotation.added'.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.output_text.annotation.added")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [annotationIndex].
+     *
+     * Unlike [annotationIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("annotation_index")
+    @ExcludeMissing
+    fun _annotationIndex(): JsonField<Long> = annotationIndex
+
+    /**
+     * Returns the raw JSON value of [contentIndex].
+     *
+     * Unlike [contentIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("content_index")
+    @ExcludeMissing
+    fun _contentIndex(): JsonField<Long> = contentIndex
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseOutputTextAnnotationAddedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .annotation()
+         * .annotationIndex()
+         * .contentIndex()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseOutputTextAnnotationAddedEvent]. */
+    class Builder internal constructor() {
+
+        private var annotation: JsonValue? = null
+        private var annotationIndex: JsonField<Long>? = null
+        private var contentIndex: JsonField<Long>? = null
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.output_text.annotation.added")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseOutputTextAnnotationAddedEvent: BetaResponseOutputTextAnnotationAddedEvent
+        ) = apply {
+            annotation = betaResponseOutputTextAnnotationAddedEvent.annotation
+            annotationIndex = betaResponseOutputTextAnnotationAddedEvent.annotationIndex
+            contentIndex = betaResponseOutputTextAnnotationAddedEvent.contentIndex
+            itemId = betaResponseOutputTextAnnotationAddedEvent.itemId
+            outputIndex = betaResponseOutputTextAnnotationAddedEvent.outputIndex
+            sequenceNumber = betaResponseOutputTextAnnotationAddedEvent.sequenceNumber
+            type = betaResponseOutputTextAnnotationAddedEvent.type
+            agent = betaResponseOutputTextAnnotationAddedEvent.agent
+            additionalProperties =
+                betaResponseOutputTextAnnotationAddedEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The annotation object being added. (See annotation schema for details.) */
+        fun annotation(annotation: JsonValue) = apply { this.annotation = annotation }
+
+        /** The index of the annotation within the content part. */
+        fun annotationIndex(annotationIndex: Long) = annotationIndex(JsonField.of(annotationIndex))
+
+        /**
+         * Sets [Builder.annotationIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.annotationIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun annotationIndex(annotationIndex: JsonField<Long>) = apply {
+            this.annotationIndex = annotationIndex
+        }
+
+        /** The index of the content part within the output item. */
+        fun contentIndex(contentIndex: Long) = contentIndex(JsonField.of(contentIndex))
+
+        /**
+         * Sets [Builder.contentIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.contentIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun contentIndex(contentIndex: JsonField<Long>) = apply { this.contentIndex = contentIndex }
+
+        /** The unique identifier of the item to which the annotation is being added. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item in the response's output array. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.output_text.annotation.added")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseOutputTextAnnotationAddedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .annotation()
+         * .annotationIndex()
+         * .contentIndex()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseOutputTextAnnotationAddedEvent =
+            BetaResponseOutputTextAnnotationAddedEvent(
+                checkRequired("annotation", annotation),
+                checkRequired("annotationIndex", annotationIndex),
+                checkRequired("contentIndex", contentIndex),
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseOutputTextAnnotationAddedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        annotationIndex()
+        contentIndex()
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.output_text.annotation.added")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (annotationIndex.asKnown().isPresent) 1 else 0) +
+            (if (contentIndex.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.output_text.annotation.added")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseOutputTextAnnotationAddedEvent &&
+            annotation == other.annotation &&
+            annotationIndex == other.annotationIndex &&
+            contentIndex == other.contentIndex &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            annotation,
+            annotationIndex,
+            contentIndex,
+            itemId,
+            outputIndex,
+            sequenceNumber,
+            type,
+            agent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseOutputTextAnnotationAddedEvent{annotation=$annotation, annotationIndex=$annotationIndex, contentIndex=$contentIndex, itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponsePrompt.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponsePrompt.kt
new file mode 100644
index 000000000..d5aaa8c15
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponsePrompt.kt
@@ -0,0 +1,383 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Reference to a prompt template and its variables.
+ * [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+ */
+class BetaResponsePrompt
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val variables: JsonField<Variables>,
+    private val version: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("variables")
+        @ExcludeMissing
+        variables: JsonField<Variables> = JsonMissing.of(),
+        @JsonProperty("version") @ExcludeMissing version: JsonField<String> = JsonMissing.of(),
+    ) : this(id, variables, version, mutableMapOf())
+
+    /**
+     * The unique identifier of the prompt template to use.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * Optional map of values to substitute in for variables in your prompt. The substitution values
+     * can either be strings, or other Response input types like images or files.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun variables(): Optional<Variables> = variables.getOptional("variables")
+
+    /**
+     * Optional version of the prompt template.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun version(): Optional<String> = version.getOptional("version")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [variables].
+     *
+     * Unlike [variables], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("variables") @ExcludeMissing fun _variables(): JsonField<Variables> = variables
+
+    /**
+     * Returns the raw JSON value of [version].
+     *
+     * Unlike [version], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("version") @ExcludeMissing fun _version(): JsonField<String> = version
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponsePrompt].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponsePrompt]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var variables: JsonField<Variables> = JsonMissing.of()
+        private var version: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponsePrompt: BetaResponsePrompt) = apply {
+            id = betaResponsePrompt.id
+            variables = betaResponsePrompt.variables
+            version = betaResponsePrompt.version
+            additionalProperties = betaResponsePrompt.additionalProperties.toMutableMap()
+        }
+
+        /** The unique identifier of the prompt template to use. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /**
+         * Optional map of values to substitute in for variables in your prompt. The substitution
+         * values can either be strings, or other Response input types like images or files.
+         */
+        fun variables(variables: Variables?) = variables(JsonField.ofNullable(variables))
+
+        /** Alias for calling [Builder.variables] with `variables.orElse(null)`. */
+        fun variables(variables: Optional<Variables>) = variables(variables.getOrNull())
+
+        /**
+         * Sets [Builder.variables] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.variables] with a well-typed [Variables] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun variables(variables: JsonField<Variables>) = apply { this.variables = variables }
+
+        /** Optional version of the prompt template. */
+        fun version(version: String?) = version(JsonField.ofNullable(version))
+
+        /** Alias for calling [Builder.version] with `version.orElse(null)`. */
+        fun version(version: Optional<String>) = version(version.getOrNull())
+
+        /**
+         * Sets [Builder.version] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.version] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun version(version: JsonField<String>) = apply { this.version = version }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponsePrompt].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponsePrompt =
+            BetaResponsePrompt(
+                checkRequired("id", id),
+                variables,
+                version,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponsePrompt = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        variables().ifPresent { it.validate() }
+        version()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (variables.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (version.asKnown().isPresent) 1 else 0)
+
+    /**
+     * Optional map of values to substitute in for variables in your prompt. The substitution values
+     * can either be strings, or other Response input types like images or files.
+     */
+    class Variables
+    @JsonCreator
+    private constructor(
+        @com.fasterxml.jackson.annotation.JsonValue
+        private val additionalProperties: Map<String, JsonValue>
+    ) {
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Variables]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Variables]. */
+        class Builder internal constructor() {
+
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(variables: Variables) = apply {
+                additionalProperties = variables.additionalProperties.toMutableMap()
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Variables].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Variables = Variables(additionalProperties.toImmutable())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Variables = apply {
+            if (validated) {
+                return@apply
+            }
+
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            additionalProperties.count { (_, value) -> !value.isNull() && !value.isMissing() }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Variables && additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() = "Variables{additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponsePrompt &&
+            id == other.id &&
+            variables == other.variables &&
+            version == other.version &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(id, variables, version, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponsePrompt{id=$id, variables=$variables, version=$version, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseQueuedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseQueuedEvent.kt
new file mode 100644
index 000000000..f2e089fa9
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseQueuedEvent.kt
@@ -0,0 +1,478 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a response is queued and waiting to be processed. */
+class BetaResponseQueuedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val response: JsonField<BetaResponse>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("response")
+        @ExcludeMissing
+        response: JsonField<BetaResponse> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(response, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The full response object that is queued.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun response(): BetaResponse = response.getRequired("response")
+
+    /**
+     * The sequence number for this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always 'response.queued'.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.queued")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [response].
+     *
+     * Unlike [response], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("response") @ExcludeMissing fun _response(): JsonField<BetaResponse> = response
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseQueuedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .response()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseQueuedEvent]. */
+    class Builder internal constructor() {
+
+        private var response: JsonField<BetaResponse>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.queued")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseQueuedEvent: BetaResponseQueuedEvent) = apply {
+            response = betaResponseQueuedEvent.response
+            sequenceNumber = betaResponseQueuedEvent.sequenceNumber
+            type = betaResponseQueuedEvent.type
+            agent = betaResponseQueuedEvent.agent
+            additionalProperties = betaResponseQueuedEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The full response object that is queued. */
+        fun response(response: BetaResponse) = response(JsonField.of(response))
+
+        /**
+         * Sets [Builder.response] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.response] with a well-typed [BetaResponse] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun response(response: JsonField<BetaResponse>) = apply { this.response = response }
+
+        /** The sequence number for this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.queued")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseQueuedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .response()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseQueuedEvent =
+            BetaResponseQueuedEvent(
+                checkRequired("response", response),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseQueuedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        response().validate()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.queued")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (response.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.queued")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseQueuedEvent &&
+            response == other.response &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(response, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseQueuedEvent{response=$response, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningItem.kt
new file mode 100644
index 000000000..36ac5d4c7
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningItem.kt
@@ -0,0 +1,1198 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * A description of the chain of thought used by a reasoning model while generating a response. Be
+ * sure to include these items in your `input` to the Responses API for subsequent turns of a
+ * conversation if you are manually
+ * [managing context](https://platform.openai.com/docs/guides/conversation-state).
+ */
+class BetaResponseReasoningItem
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val summary: JsonField<List<Summary>>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val content: JsonField<List<Content>>,
+    private val encryptedContent: JsonField<String>,
+    private val status: JsonField<Status>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("summary")
+        @ExcludeMissing
+        summary: JsonField<List<Summary>> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("content")
+        @ExcludeMissing
+        content: JsonField<List<Content>> = JsonMissing.of(),
+        @JsonProperty("encrypted_content")
+        @ExcludeMissing
+        encryptedContent: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+    ) : this(id, summary, type, agent, content, encryptedContent, status, mutableMapOf())
+
+    /**
+     * The unique identifier of the reasoning content.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * Reasoning summary content.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun summary(): List<Summary> = summary.getRequired("summary")
+
+    /**
+     * The type of the object. Always `reasoning`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("reasoning")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Reasoning text content.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun content(): Optional<List<Content>> = content.getOptional("content")
+
+    /**
+     * The encrypted content of the reasoning item - populated when a response is generated with
+     * `reasoning.encrypted_content` in the `include` parameter.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun encryptedContent(): Optional<String> = encryptedContent.getOptional("encrypted_content")
+
+    /**
+     * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+     * items are returned via API.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun status(): Optional<Status> = status.getOptional("status")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [summary].
+     *
+     * Unlike [summary], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("summary") @ExcludeMissing fun _summary(): JsonField<List<Summary>> = summary
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [content].
+     *
+     * Unlike [content], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("content") @ExcludeMissing fun _content(): JsonField<List<Content>> = content
+
+    /**
+     * Returns the raw JSON value of [encryptedContent].
+     *
+     * Unlike [encryptedContent], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("encrypted_content")
+    @ExcludeMissing
+    fun _encryptedContent(): JsonField<String> = encryptedContent
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseReasoningItem].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .summary()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseReasoningItem]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var summary: JsonField<MutableList<Summary>>? = null
+        private var type: JsonValue = JsonValue.from("reasoning")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var content: JsonField<MutableList<Content>>? = null
+        private var encryptedContent: JsonField<String> = JsonMissing.of()
+        private var status: JsonField<Status> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseReasoningItem: BetaResponseReasoningItem) = apply {
+            id = betaResponseReasoningItem.id
+            summary = betaResponseReasoningItem.summary.map { it.toMutableList() }
+            type = betaResponseReasoningItem.type
+            agent = betaResponseReasoningItem.agent
+            content = betaResponseReasoningItem.content.map { it.toMutableList() }
+            encryptedContent = betaResponseReasoningItem.encryptedContent
+            status = betaResponseReasoningItem.status
+            additionalProperties = betaResponseReasoningItem.additionalProperties.toMutableMap()
+        }
+
+        /** The unique identifier of the reasoning content. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** Reasoning summary content. */
+        fun summary(summary: List<Summary>) = summary(JsonField.of(summary))
+
+        /**
+         * Sets [Builder.summary] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.summary] with a well-typed `List<Summary>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun summary(summary: JsonField<List<Summary>>) = apply {
+            this.summary = summary.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Summary] to [Builder.summary].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addSummary(summary: Summary) = apply {
+            this.summary =
+                (this.summary ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("summary", it).add(summary)
+                }
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("reasoning")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /** Reasoning text content. */
+        fun content(content: List<Content>) = content(JsonField.of(content))
+
+        /**
+         * Sets [Builder.content] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.content] with a well-typed `List<Content>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun content(content: JsonField<List<Content>>) = apply {
+            this.content = content.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Content] to [Builder.content].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addContent(content: Content) = apply {
+            this.content =
+                (this.content ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("content", it).add(content)
+                }
+        }
+
+        /**
+         * The encrypted content of the reasoning item - populated when a response is generated with
+         * `reasoning.encrypted_content` in the `include` parameter.
+         */
+        fun encryptedContent(encryptedContent: String?) =
+            encryptedContent(JsonField.ofNullable(encryptedContent))
+
+        /** Alias for calling [Builder.encryptedContent] with `encryptedContent.orElse(null)`. */
+        fun encryptedContent(encryptedContent: Optional<String>) =
+            encryptedContent(encryptedContent.getOrNull())
+
+        /**
+         * Sets [Builder.encryptedContent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.encryptedContent] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun encryptedContent(encryptedContent: JsonField<String>) = apply {
+            this.encryptedContent = encryptedContent
+        }
+
+        /**
+         * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated
+         * when items are returned via API.
+         */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseReasoningItem].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .summary()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseReasoningItem =
+            BetaResponseReasoningItem(
+                checkRequired("id", id),
+                checkRequired("summary", summary).map { it.toImmutable() },
+                type,
+                agent,
+                (content ?: JsonMissing.of()).map { it.toImmutable() },
+                encryptedContent,
+                status,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseReasoningItem = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        summary().forEach { it.validate() }
+        _type().let {
+            if (it != JsonValue.from("reasoning")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        content().ifPresent { it.forEach { it.validate() } }
+        encryptedContent()
+        status().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (summary.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            type.let { if (it == JsonValue.from("reasoning")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (content.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (if (encryptedContent.asKnown().isPresent) 1 else 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** A summary text from the model. */
+    class Summary
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val text: JsonField<String>,
+        private val type: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(text, type, mutableMapOf())
+
+        /**
+         * A summary of the reasoning output from the model so far.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun text(): String = text.getRequired("text")
+
+        /**
+         * The type of the object. Always `summary_text`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("summary_text")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Returns the raw JSON value of [text].
+         *
+         * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Summary].
+             *
+             * The following fields are required:
+             * ```java
+             * .text()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Summary]. */
+        class Builder internal constructor() {
+
+            private var text: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("summary_text")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(summary: Summary) = apply {
+                text = summary.text
+                type = summary.type
+                additionalProperties = summary.additionalProperties.toMutableMap()
+            }
+
+            /** A summary of the reasoning output from the model so far. */
+            fun text(text: String) = text(JsonField.of(text))
+
+            /**
+             * Sets [Builder.text] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.text] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun text(text: JsonField<String>) = apply { this.text = text }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("summary_text")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Summary].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .text()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Summary =
+                Summary(checkRequired("text", text), type, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Summary = apply {
+            if (validated) {
+                return@apply
+            }
+
+            text()
+            _type().let {
+                if (it != JsonValue.from("summary_text")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (text.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("summary_text")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Summary &&
+                text == other.text &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Summary{text=$text, type=$type, additionalProperties=$additionalProperties}"
+    }
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    /** Reasoning text from the model. */
+    class Content
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val text: JsonField<String>,
+        private val type: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(text, type, mutableMapOf())
+
+        /**
+         * The reasoning text from the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun text(): String = text.getRequired("text")
+
+        /**
+         * The type of the reasoning text. Always `reasoning_text`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("reasoning_text")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Returns the raw JSON value of [text].
+         *
+         * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Content].
+             *
+             * The following fields are required:
+             * ```java
+             * .text()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Content]. */
+        class Builder internal constructor() {
+
+            private var text: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("reasoning_text")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(content: Content) = apply {
+                text = content.text
+                type = content.type
+                additionalProperties = content.additionalProperties.toMutableMap()
+            }
+
+            /** The reasoning text from the model. */
+            fun text(text: String) = text(JsonField.of(text))
+
+            /**
+             * Sets [Builder.text] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.text] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun text(text: JsonField<String>) = apply { this.text = text }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("reasoning_text")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Content].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .text()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Content =
+                Content(checkRequired("text", text), type, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Content = apply {
+            if (validated) {
+                return@apply
+            }
+
+            text()
+            _type().let {
+                if (it != JsonValue.from("reasoning_text")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (text.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("reasoning_text")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Content &&
+                text == other.text &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Content{text=$text, type=$type, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when
+     * items are returned via API.
+     */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseReasoningItem &&
+            id == other.id &&
+            summary == other.summary &&
+            type == other.type &&
+            agent == other.agent &&
+            content == other.content &&
+            encryptedContent == other.encryptedContent &&
+            status == other.status &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            id,
+            summary,
+            type,
+            agent,
+            content,
+            encryptedContent,
+            status,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseReasoningItem{id=$id, summary=$summary, type=$type, agent=$agent, content=$content, encryptedContent=$encryptedContent, status=$status, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryPartAddedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryPartAddedEvent.kt
new file mode 100644
index 000000000..fca827a79
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryPartAddedEvent.kt
@@ -0,0 +1,812 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a new reasoning summary part is added. */
+class BetaResponseReasoningSummaryPartAddedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val part: JsonField<Part>,
+    private val sequenceNumber: JsonField<Long>,
+    private val summaryIndex: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("part") @ExcludeMissing part: JsonField<Part> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("summary_index")
+        @ExcludeMissing
+        summaryIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, part, sequenceNumber, summaryIndex, type, agent, mutableMapOf())
+
+    /**
+     * The ID of the item this summary part is associated with.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item this summary part is associated with.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The summary part that was added.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun part(): Part = part.getRequired("part")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The index of the summary part within the reasoning summary.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun summaryIndex(): Long = summaryIndex.getRequired("summary_index")
+
+    /**
+     * The type of the event. Always `response.reasoning_summary_part.added`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.reasoning_summary_part.added")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [part].
+     *
+     * Unlike [part], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("part") @ExcludeMissing fun _part(): JsonField<Part> = part
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [summaryIndex].
+     *
+     * Unlike [summaryIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("summary_index")
+    @ExcludeMissing
+    fun _summaryIndex(): JsonField<Long> = summaryIndex
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseReasoningSummaryPartAddedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .part()
+         * .sequenceNumber()
+         * .summaryIndex()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseReasoningSummaryPartAddedEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var part: JsonField<Part>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var summaryIndex: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.reasoning_summary_part.added")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseReasoningSummaryPartAddedEvent: BetaResponseReasoningSummaryPartAddedEvent
+        ) = apply {
+            itemId = betaResponseReasoningSummaryPartAddedEvent.itemId
+            outputIndex = betaResponseReasoningSummaryPartAddedEvent.outputIndex
+            part = betaResponseReasoningSummaryPartAddedEvent.part
+            sequenceNumber = betaResponseReasoningSummaryPartAddedEvent.sequenceNumber
+            summaryIndex = betaResponseReasoningSummaryPartAddedEvent.summaryIndex
+            type = betaResponseReasoningSummaryPartAddedEvent.type
+            agent = betaResponseReasoningSummaryPartAddedEvent.agent
+            additionalProperties =
+                betaResponseReasoningSummaryPartAddedEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The ID of the item this summary part is associated with. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item this summary part is associated with. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The summary part that was added. */
+        fun part(part: Part) = part(JsonField.of(part))
+
+        /**
+         * Sets [Builder.part] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.part] with a well-typed [Part] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun part(part: JsonField<Part>) = apply { this.part = part }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /** The index of the summary part within the reasoning summary. */
+        fun summaryIndex(summaryIndex: Long) = summaryIndex(JsonField.of(summaryIndex))
+
+        /**
+         * Sets [Builder.summaryIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.summaryIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun summaryIndex(summaryIndex: JsonField<Long>) = apply { this.summaryIndex = summaryIndex }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.reasoning_summary_part.added")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseReasoningSummaryPartAddedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .part()
+         * .sequenceNumber()
+         * .summaryIndex()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseReasoningSummaryPartAddedEvent =
+            BetaResponseReasoningSummaryPartAddedEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("part", part),
+                checkRequired("sequenceNumber", sequenceNumber),
+                checkRequired("summaryIndex", summaryIndex),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseReasoningSummaryPartAddedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        part().validate()
+        sequenceNumber()
+        summaryIndex()
+        _type().let {
+            if (it != JsonValue.from("response.reasoning_summary_part.added")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (part.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            (if (summaryIndex.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.reasoning_summary_part.added")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The summary part that was added. */
+    class Part
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val text: JsonField<String>,
+        private val type: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(text, type, mutableMapOf())
+
+        /**
+         * The text of the summary part.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun text(): String = text.getRequired("text")
+
+        /**
+         * The type of the summary part. Always `summary_text`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("summary_text")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Returns the raw JSON value of [text].
+         *
+         * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Part].
+             *
+             * The following fields are required:
+             * ```java
+             * .text()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Part]. */
+        class Builder internal constructor() {
+
+            private var text: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("summary_text")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(part: Part) = apply {
+                text = part.text
+                type = part.type
+                additionalProperties = part.additionalProperties.toMutableMap()
+            }
+
+            /** The text of the summary part. */
+            fun text(text: String) = text(JsonField.of(text))
+
+            /**
+             * Sets [Builder.text] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.text] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun text(text: JsonField<String>) = apply { this.text = text }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("summary_text")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Part].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .text()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Part =
+                Part(checkRequired("text", text), type, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Part = apply {
+            if (validated) {
+                return@apply
+            }
+
+            text()
+            _type().let {
+                if (it != JsonValue.from("summary_text")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (text.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("summary_text")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Part &&
+                text == other.text &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Part{text=$text, type=$type, additionalProperties=$additionalProperties}"
+    }
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseReasoningSummaryPartAddedEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            part == other.part &&
+            sequenceNumber == other.sequenceNumber &&
+            summaryIndex == other.summaryIndex &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            itemId,
+            outputIndex,
+            part,
+            sequenceNumber,
+            summaryIndex,
+            type,
+            agent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseReasoningSummaryPartAddedEvent{itemId=$itemId, outputIndex=$outputIndex, part=$part, sequenceNumber=$sequenceNumber, summaryIndex=$summaryIndex, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryPartDoneEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryPartDoneEvent.kt
new file mode 100644
index 000000000..971e8e3b7
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryPartDoneEvent.kt
@@ -0,0 +1,994 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a reasoning summary part is completed. */
+class BetaResponseReasoningSummaryPartDoneEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val part: JsonField<Part>,
+    private val sequenceNumber: JsonField<Long>,
+    private val summaryIndex: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val status: JsonField<Status>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("part") @ExcludeMissing part: JsonField<Part> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("summary_index")
+        @ExcludeMissing
+        summaryIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+    ) : this(
+        itemId,
+        outputIndex,
+        part,
+        sequenceNumber,
+        summaryIndex,
+        type,
+        agent,
+        status,
+        mutableMapOf(),
+    )
+
+    /**
+     * The ID of the item this summary part is associated with.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item this summary part is associated with.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The completed summary part.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun part(): Part = part.getRequired("part")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The index of the summary part within the reasoning summary.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun summaryIndex(): Long = summaryIndex.getRequired("summary_index")
+
+    /**
+     * The type of the event. Always `response.reasoning_summary_part.done`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.reasoning_summary_part.done")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * The completion status of the summary part. Omitted when the part completed normally and set
+     * to `incomplete` when generation was interrupted.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun status(): Optional<Status> = status.getOptional("status")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [part].
+     *
+     * Unlike [part], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("part") @ExcludeMissing fun _part(): JsonField<Part> = part
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [summaryIndex].
+     *
+     * Unlike [summaryIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("summary_index")
+    @ExcludeMissing
+    fun _summaryIndex(): JsonField<Long> = summaryIndex
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseReasoningSummaryPartDoneEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .part()
+         * .sequenceNumber()
+         * .summaryIndex()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseReasoningSummaryPartDoneEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var part: JsonField<Part>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var summaryIndex: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.reasoning_summary_part.done")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var status: JsonField<Status> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseReasoningSummaryPartDoneEvent: BetaResponseReasoningSummaryPartDoneEvent
+        ) = apply {
+            itemId = betaResponseReasoningSummaryPartDoneEvent.itemId
+            outputIndex = betaResponseReasoningSummaryPartDoneEvent.outputIndex
+            part = betaResponseReasoningSummaryPartDoneEvent.part
+            sequenceNumber = betaResponseReasoningSummaryPartDoneEvent.sequenceNumber
+            summaryIndex = betaResponseReasoningSummaryPartDoneEvent.summaryIndex
+            type = betaResponseReasoningSummaryPartDoneEvent.type
+            agent = betaResponseReasoningSummaryPartDoneEvent.agent
+            status = betaResponseReasoningSummaryPartDoneEvent.status
+            additionalProperties =
+                betaResponseReasoningSummaryPartDoneEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The ID of the item this summary part is associated with. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item this summary part is associated with. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The completed summary part. */
+        fun part(part: Part) = part(JsonField.of(part))
+
+        /**
+         * Sets [Builder.part] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.part] with a well-typed [Part] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun part(part: JsonField<Part>) = apply { this.part = part }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /** The index of the summary part within the reasoning summary. */
+        fun summaryIndex(summaryIndex: Long) = summaryIndex(JsonField.of(summaryIndex))
+
+        /**
+         * Sets [Builder.summaryIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.summaryIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun summaryIndex(summaryIndex: JsonField<Long>) = apply { this.summaryIndex = summaryIndex }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.reasoning_summary_part.done")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /**
+         * The completion status of the summary part. Omitted when the part completed normally and
+         * set to `incomplete` when generation was interrupted.
+         */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseReasoningSummaryPartDoneEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .part()
+         * .sequenceNumber()
+         * .summaryIndex()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseReasoningSummaryPartDoneEvent =
+            BetaResponseReasoningSummaryPartDoneEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("part", part),
+                checkRequired("sequenceNumber", sequenceNumber),
+                checkRequired("summaryIndex", summaryIndex),
+                type,
+                agent,
+                status,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseReasoningSummaryPartDoneEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        part().validate()
+        sequenceNumber()
+        summaryIndex()
+        _type().let {
+            if (it != JsonValue.from("response.reasoning_summary_part.done")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        status().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (part.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            (if (summaryIndex.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.reasoning_summary_part.done")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The completed summary part. */
+    class Part
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val text: JsonField<String>,
+        private val type: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(text, type, mutableMapOf())
+
+        /**
+         * The text of the summary part.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun text(): String = text.getRequired("text")
+
+        /**
+         * The type of the summary part. Always `summary_text`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("summary_text")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Returns the raw JSON value of [text].
+         *
+         * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Part].
+             *
+             * The following fields are required:
+             * ```java
+             * .text()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Part]. */
+        class Builder internal constructor() {
+
+            private var text: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("summary_text")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(part: Part) = apply {
+                text = part.text
+                type = part.type
+                additionalProperties = part.additionalProperties.toMutableMap()
+            }
+
+            /** The text of the summary part. */
+            fun text(text: String) = text(JsonField.of(text))
+
+            /**
+             * Sets [Builder.text] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.text] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun text(text: JsonField<String>) = apply { this.text = text }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("summary_text")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Part].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .text()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Part =
+                Part(checkRequired("text", text), type, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Part = apply {
+            if (validated) {
+                return@apply
+            }
+
+            text()
+            _type().let {
+                if (it != JsonValue.from("summary_text")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (text.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("summary_text")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Part &&
+                text == other.text &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Part{text=$text, type=$type, additionalProperties=$additionalProperties}"
+    }
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * The completion status of the summary part. Omitted when the part completed normally and set
+     * to `incomplete` when generation was interrupted.
+     */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            INCOMPLETE
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            INCOMPLETE,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                INCOMPLETE -> Value.INCOMPLETE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                INCOMPLETE -> Known.INCOMPLETE
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseReasoningSummaryPartDoneEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            part == other.part &&
+            sequenceNumber == other.sequenceNumber &&
+            summaryIndex == other.summaryIndex &&
+            type == other.type &&
+            agent == other.agent &&
+            status == other.status &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            itemId,
+            outputIndex,
+            part,
+            sequenceNumber,
+            summaryIndex,
+            type,
+            agent,
+            status,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseReasoningSummaryPartDoneEvent{itemId=$itemId, outputIndex=$outputIndex, part=$part, sequenceNumber=$sequenceNumber, summaryIndex=$summaryIndex, type=$type, agent=$agent, status=$status, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryTextDeltaEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryTextDeltaEvent.kt
new file mode 100644
index 000000000..4ad794f71
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryTextDeltaEvent.kt
@@ -0,0 +1,606 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a delta is added to a reasoning summary text. */
+class BetaResponseReasoningSummaryTextDeltaEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val delta: JsonField<String>,
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val summaryIndex: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("delta") @ExcludeMissing delta: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("summary_index")
+        @ExcludeMissing
+        summaryIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(delta, itemId, outputIndex, sequenceNumber, summaryIndex, type, agent, mutableMapOf())
+
+    /**
+     * The text delta that was added to the summary.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun delta(): String = delta.getRequired("delta")
+
+    /**
+     * The ID of the item this summary text delta is associated with.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item this summary text delta is associated with.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The index of the summary part within the reasoning summary.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun summaryIndex(): Long = summaryIndex.getRequired("summary_index")
+
+    /**
+     * The type of the event. Always `response.reasoning_summary_text.delta`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.reasoning_summary_text.delta")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [delta].
+     *
+     * Unlike [delta], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("delta") @ExcludeMissing fun _delta(): JsonField<String> = delta
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [summaryIndex].
+     *
+     * Unlike [summaryIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("summary_index")
+    @ExcludeMissing
+    fun _summaryIndex(): JsonField<Long> = summaryIndex
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseReasoningSummaryTextDeltaEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .delta()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * .summaryIndex()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseReasoningSummaryTextDeltaEvent]. */
+    class Builder internal constructor() {
+
+        private var delta: JsonField<String>? = null
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var summaryIndex: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.reasoning_summary_text.delta")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseReasoningSummaryTextDeltaEvent: BetaResponseReasoningSummaryTextDeltaEvent
+        ) = apply {
+            delta = betaResponseReasoningSummaryTextDeltaEvent.delta
+            itemId = betaResponseReasoningSummaryTextDeltaEvent.itemId
+            outputIndex = betaResponseReasoningSummaryTextDeltaEvent.outputIndex
+            sequenceNumber = betaResponseReasoningSummaryTextDeltaEvent.sequenceNumber
+            summaryIndex = betaResponseReasoningSummaryTextDeltaEvent.summaryIndex
+            type = betaResponseReasoningSummaryTextDeltaEvent.type
+            agent = betaResponseReasoningSummaryTextDeltaEvent.agent
+            additionalProperties =
+                betaResponseReasoningSummaryTextDeltaEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The text delta that was added to the summary. */
+        fun delta(delta: String) = delta(JsonField.of(delta))
+
+        /**
+         * Sets [Builder.delta] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.delta] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun delta(delta: JsonField<String>) = apply { this.delta = delta }
+
+        /** The ID of the item this summary text delta is associated with. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item this summary text delta is associated with. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /** The index of the summary part within the reasoning summary. */
+        fun summaryIndex(summaryIndex: Long) = summaryIndex(JsonField.of(summaryIndex))
+
+        /**
+         * Sets [Builder.summaryIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.summaryIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun summaryIndex(summaryIndex: JsonField<Long>) = apply { this.summaryIndex = summaryIndex }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.reasoning_summary_text.delta")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseReasoningSummaryTextDeltaEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .delta()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * .summaryIndex()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseReasoningSummaryTextDeltaEvent =
+            BetaResponseReasoningSummaryTextDeltaEvent(
+                checkRequired("delta", delta),
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                checkRequired("summaryIndex", summaryIndex),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseReasoningSummaryTextDeltaEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        delta()
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        summaryIndex()
+        _type().let {
+            if (it != JsonValue.from("response.reasoning_summary_text.delta")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (delta.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            (if (summaryIndex.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.reasoning_summary_text.delta")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseReasoningSummaryTextDeltaEvent &&
+            delta == other.delta &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            summaryIndex == other.summaryIndex &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            delta,
+            itemId,
+            outputIndex,
+            sequenceNumber,
+            summaryIndex,
+            type,
+            agent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseReasoningSummaryTextDeltaEvent{delta=$delta, itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, summaryIndex=$summaryIndex, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryTextDoneEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryTextDoneEvent.kt
new file mode 100644
index 000000000..206ca87b8
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryTextDoneEvent.kt
@@ -0,0 +1,606 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a reasoning summary text is completed. */
+class BetaResponseReasoningSummaryTextDoneEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val summaryIndex: JsonField<Long>,
+    private val text: JsonField<String>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("summary_index")
+        @ExcludeMissing
+        summaryIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, summaryIndex, text, type, agent, mutableMapOf())
+
+    /**
+     * The ID of the item this summary text is associated with.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item this summary text is associated with.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The index of the summary part within the reasoning summary.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun summaryIndex(): Long = summaryIndex.getRequired("summary_index")
+
+    /**
+     * The full text of the completed reasoning summary.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun text(): String = text.getRequired("text")
+
+    /**
+     * The type of the event. Always `response.reasoning_summary_text.done`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.reasoning_summary_text.done")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [summaryIndex].
+     *
+     * Unlike [summaryIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("summary_index")
+    @ExcludeMissing
+    fun _summaryIndex(): JsonField<Long> = summaryIndex
+
+    /**
+     * Returns the raw JSON value of [text].
+     *
+     * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseReasoningSummaryTextDoneEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * .summaryIndex()
+         * .text()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseReasoningSummaryTextDoneEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var summaryIndex: JsonField<Long>? = null
+        private var text: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("response.reasoning_summary_text.done")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseReasoningSummaryTextDoneEvent: BetaResponseReasoningSummaryTextDoneEvent
+        ) = apply {
+            itemId = betaResponseReasoningSummaryTextDoneEvent.itemId
+            outputIndex = betaResponseReasoningSummaryTextDoneEvent.outputIndex
+            sequenceNumber = betaResponseReasoningSummaryTextDoneEvent.sequenceNumber
+            summaryIndex = betaResponseReasoningSummaryTextDoneEvent.summaryIndex
+            text = betaResponseReasoningSummaryTextDoneEvent.text
+            type = betaResponseReasoningSummaryTextDoneEvent.type
+            agent = betaResponseReasoningSummaryTextDoneEvent.agent
+            additionalProperties =
+                betaResponseReasoningSummaryTextDoneEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The ID of the item this summary text is associated with. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item this summary text is associated with. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /** The index of the summary part within the reasoning summary. */
+        fun summaryIndex(summaryIndex: Long) = summaryIndex(JsonField.of(summaryIndex))
+
+        /**
+         * Sets [Builder.summaryIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.summaryIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun summaryIndex(summaryIndex: JsonField<Long>) = apply { this.summaryIndex = summaryIndex }
+
+        /** The full text of the completed reasoning summary. */
+        fun text(text: String) = text(JsonField.of(text))
+
+        /**
+         * Sets [Builder.text] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.text] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun text(text: JsonField<String>) = apply { this.text = text }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.reasoning_summary_text.done")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseReasoningSummaryTextDoneEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * .summaryIndex()
+         * .text()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseReasoningSummaryTextDoneEvent =
+            BetaResponseReasoningSummaryTextDoneEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                checkRequired("summaryIndex", summaryIndex),
+                checkRequired("text", text),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseReasoningSummaryTextDoneEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        summaryIndex()
+        text()
+        _type().let {
+            if (it != JsonValue.from("response.reasoning_summary_text.done")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            (if (summaryIndex.asKnown().isPresent) 1 else 0) +
+            (if (text.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.reasoning_summary_text.done")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseReasoningSummaryTextDoneEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            summaryIndex == other.summaryIndex &&
+            text == other.text &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            itemId,
+            outputIndex,
+            sequenceNumber,
+            summaryIndex,
+            text,
+            type,
+            agent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseReasoningSummaryTextDoneEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, summaryIndex=$summaryIndex, text=$text, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningTextDeltaEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningTextDeltaEvent.kt
new file mode 100644
index 000000000..a37416299
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningTextDeltaEvent.kt
@@ -0,0 +1,604 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a delta is added to a reasoning text. */
+class BetaResponseReasoningTextDeltaEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val contentIndex: JsonField<Long>,
+    private val delta: JsonField<String>,
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("content_index")
+        @ExcludeMissing
+        contentIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("delta") @ExcludeMissing delta: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(contentIndex, delta, itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The index of the reasoning content part this delta is associated with.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun contentIndex(): Long = contentIndex.getRequired("content_index")
+
+    /**
+     * The text delta that was added to the reasoning content.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun delta(): String = delta.getRequired("delta")
+
+    /**
+     * The ID of the item this reasoning text delta is associated with.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item this reasoning text delta is associated with.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.reasoning_text.delta`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.reasoning_text.delta")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [contentIndex].
+     *
+     * Unlike [contentIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("content_index")
+    @ExcludeMissing
+    fun _contentIndex(): JsonField<Long> = contentIndex
+
+    /**
+     * Returns the raw JSON value of [delta].
+     *
+     * Unlike [delta], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("delta") @ExcludeMissing fun _delta(): JsonField<String> = delta
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseReasoningTextDeltaEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .contentIndex()
+         * .delta()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseReasoningTextDeltaEvent]. */
+    class Builder internal constructor() {
+
+        private var contentIndex: JsonField<Long>? = null
+        private var delta: JsonField<String>? = null
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.reasoning_text.delta")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseReasoningTextDeltaEvent: BetaResponseReasoningTextDeltaEvent
+        ) = apply {
+            contentIndex = betaResponseReasoningTextDeltaEvent.contentIndex
+            delta = betaResponseReasoningTextDeltaEvent.delta
+            itemId = betaResponseReasoningTextDeltaEvent.itemId
+            outputIndex = betaResponseReasoningTextDeltaEvent.outputIndex
+            sequenceNumber = betaResponseReasoningTextDeltaEvent.sequenceNumber
+            type = betaResponseReasoningTextDeltaEvent.type
+            agent = betaResponseReasoningTextDeltaEvent.agent
+            additionalProperties =
+                betaResponseReasoningTextDeltaEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The index of the reasoning content part this delta is associated with. */
+        fun contentIndex(contentIndex: Long) = contentIndex(JsonField.of(contentIndex))
+
+        /**
+         * Sets [Builder.contentIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.contentIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun contentIndex(contentIndex: JsonField<Long>) = apply { this.contentIndex = contentIndex }
+
+        /** The text delta that was added to the reasoning content. */
+        fun delta(delta: String) = delta(JsonField.of(delta))
+
+        /**
+         * Sets [Builder.delta] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.delta] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun delta(delta: JsonField<String>) = apply { this.delta = delta }
+
+        /** The ID of the item this reasoning text delta is associated with. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item this reasoning text delta is associated with. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.reasoning_text.delta")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseReasoningTextDeltaEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .contentIndex()
+         * .delta()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseReasoningTextDeltaEvent =
+            BetaResponseReasoningTextDeltaEvent(
+                checkRequired("contentIndex", contentIndex),
+                checkRequired("delta", delta),
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseReasoningTextDeltaEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        contentIndex()
+        delta()
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.reasoning_text.delta")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (contentIndex.asKnown().isPresent) 1 else 0) +
+            (if (delta.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.reasoning_text.delta")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseReasoningTextDeltaEvent &&
+            contentIndex == other.contentIndex &&
+            delta == other.delta &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            contentIndex,
+            delta,
+            itemId,
+            outputIndex,
+            sequenceNumber,
+            type,
+            agent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseReasoningTextDeltaEvent{contentIndex=$contentIndex, delta=$delta, itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningTextDoneEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningTextDoneEvent.kt
new file mode 100644
index 000000000..16260ee6a
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseReasoningTextDoneEvent.kt
@@ -0,0 +1,603 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a reasoning text is completed. */
+class BetaResponseReasoningTextDoneEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val contentIndex: JsonField<Long>,
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val text: JsonField<String>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("content_index")
+        @ExcludeMissing
+        contentIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(contentIndex, itemId, outputIndex, sequenceNumber, text, type, agent, mutableMapOf())
+
+    /**
+     * The index of the reasoning content part.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun contentIndex(): Long = contentIndex.getRequired("content_index")
+
+    /**
+     * The ID of the item this reasoning text is associated with.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item this reasoning text is associated with.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The full text of the completed reasoning content.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun text(): String = text.getRequired("text")
+
+    /**
+     * The type of the event. Always `response.reasoning_text.done`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.reasoning_text.done")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [contentIndex].
+     *
+     * Unlike [contentIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("content_index")
+    @ExcludeMissing
+    fun _contentIndex(): JsonField<Long> = contentIndex
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [text].
+     *
+     * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseReasoningTextDoneEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .contentIndex()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * .text()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseReasoningTextDoneEvent]. */
+    class Builder internal constructor() {
+
+        private var contentIndex: JsonField<Long>? = null
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var text: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("response.reasoning_text.done")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseReasoningTextDoneEvent: BetaResponseReasoningTextDoneEvent) =
+            apply {
+                contentIndex = betaResponseReasoningTextDoneEvent.contentIndex
+                itemId = betaResponseReasoningTextDoneEvent.itemId
+                outputIndex = betaResponseReasoningTextDoneEvent.outputIndex
+                sequenceNumber = betaResponseReasoningTextDoneEvent.sequenceNumber
+                text = betaResponseReasoningTextDoneEvent.text
+                type = betaResponseReasoningTextDoneEvent.type
+                agent = betaResponseReasoningTextDoneEvent.agent
+                additionalProperties =
+                    betaResponseReasoningTextDoneEvent.additionalProperties.toMutableMap()
+            }
+
+        /** The index of the reasoning content part. */
+        fun contentIndex(contentIndex: Long) = contentIndex(JsonField.of(contentIndex))
+
+        /**
+         * Sets [Builder.contentIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.contentIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun contentIndex(contentIndex: JsonField<Long>) = apply { this.contentIndex = contentIndex }
+
+        /** The ID of the item this reasoning text is associated with. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item this reasoning text is associated with. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /** The full text of the completed reasoning content. */
+        fun text(text: String) = text(JsonField.of(text))
+
+        /**
+         * Sets [Builder.text] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.text] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun text(text: JsonField<String>) = apply { this.text = text }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.reasoning_text.done")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseReasoningTextDoneEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .contentIndex()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * .text()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseReasoningTextDoneEvent =
+            BetaResponseReasoningTextDoneEvent(
+                checkRequired("contentIndex", contentIndex),
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                checkRequired("text", text),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseReasoningTextDoneEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        contentIndex()
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        text()
+        _type().let {
+            if (it != JsonValue.from("response.reasoning_text.done")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (contentIndex.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            (if (text.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.reasoning_text.done")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseReasoningTextDoneEvent &&
+            contentIndex == other.contentIndex &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            text == other.text &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            contentIndex,
+            itemId,
+            outputIndex,
+            sequenceNumber,
+            text,
+            type,
+            agent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseReasoningTextDoneEvent{contentIndex=$contentIndex, itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, text=$text, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseRefusalDeltaEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseRefusalDeltaEvent.kt
new file mode 100644
index 000000000..6abb7aec4
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseRefusalDeltaEvent.kt
@@ -0,0 +1,601 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when there is a partial refusal text. */
+class BetaResponseRefusalDeltaEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val contentIndex: JsonField<Long>,
+    private val delta: JsonField<String>,
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("content_index")
+        @ExcludeMissing
+        contentIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("delta") @ExcludeMissing delta: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(contentIndex, delta, itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * The index of the content part that the refusal text is added to.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun contentIndex(): Long = contentIndex.getRequired("content_index")
+
+    /**
+     * The refusal text that is added.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun delta(): String = delta.getRequired("delta")
+
+    /**
+     * The ID of the output item that the refusal text is added to.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item that the refusal text is added to.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.refusal.delta`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.refusal.delta")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [contentIndex].
+     *
+     * Unlike [contentIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("content_index")
+    @ExcludeMissing
+    fun _contentIndex(): JsonField<Long> = contentIndex
+
+    /**
+     * Returns the raw JSON value of [delta].
+     *
+     * Unlike [delta], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("delta") @ExcludeMissing fun _delta(): JsonField<String> = delta
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseRefusalDeltaEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .contentIndex()
+         * .delta()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseRefusalDeltaEvent]. */
+    class Builder internal constructor() {
+
+        private var contentIndex: JsonField<Long>? = null
+        private var delta: JsonField<String>? = null
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.refusal.delta")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseRefusalDeltaEvent: BetaResponseRefusalDeltaEvent) = apply {
+            contentIndex = betaResponseRefusalDeltaEvent.contentIndex
+            delta = betaResponseRefusalDeltaEvent.delta
+            itemId = betaResponseRefusalDeltaEvent.itemId
+            outputIndex = betaResponseRefusalDeltaEvent.outputIndex
+            sequenceNumber = betaResponseRefusalDeltaEvent.sequenceNumber
+            type = betaResponseRefusalDeltaEvent.type
+            agent = betaResponseRefusalDeltaEvent.agent
+            additionalProperties = betaResponseRefusalDeltaEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The index of the content part that the refusal text is added to. */
+        fun contentIndex(contentIndex: Long) = contentIndex(JsonField.of(contentIndex))
+
+        /**
+         * Sets [Builder.contentIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.contentIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun contentIndex(contentIndex: JsonField<Long>) = apply { this.contentIndex = contentIndex }
+
+        /** The refusal text that is added. */
+        fun delta(delta: String) = delta(JsonField.of(delta))
+
+        /**
+         * Sets [Builder.delta] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.delta] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun delta(delta: JsonField<String>) = apply { this.delta = delta }
+
+        /** The ID of the output item that the refusal text is added to. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item that the refusal text is added to. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.refusal.delta")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseRefusalDeltaEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .contentIndex()
+         * .delta()
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseRefusalDeltaEvent =
+            BetaResponseRefusalDeltaEvent(
+                checkRequired("contentIndex", contentIndex),
+                checkRequired("delta", delta),
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseRefusalDeltaEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        contentIndex()
+        delta()
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.refusal.delta")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (contentIndex.asKnown().isPresent) 1 else 0) +
+            (if (delta.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.refusal.delta")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseRefusalDeltaEvent &&
+            contentIndex == other.contentIndex &&
+            delta == other.delta &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            contentIndex,
+            delta,
+            itemId,
+            outputIndex,
+            sequenceNumber,
+            type,
+            agent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseRefusalDeltaEvent{contentIndex=$contentIndex, delta=$delta, itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseRefusalDoneEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseRefusalDoneEvent.kt
new file mode 100644
index 000000000..4279fd163
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseRefusalDoneEvent.kt
@@ -0,0 +1,609 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when refusal text is finalized. */
+class BetaResponseRefusalDoneEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val contentIndex: JsonField<Long>,
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val refusal: JsonField<String>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("content_index")
+        @ExcludeMissing
+        contentIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("refusal") @ExcludeMissing refusal: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(
+        contentIndex,
+        itemId,
+        outputIndex,
+        refusal,
+        sequenceNumber,
+        type,
+        agent,
+        mutableMapOf(),
+    )
+
+    /**
+     * The index of the content part that the refusal text is finalized.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun contentIndex(): Long = contentIndex.getRequired("content_index")
+
+    /**
+     * The ID of the output item that the refusal text is finalized.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item that the refusal text is finalized.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The refusal text that is finalized.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun refusal(): String = refusal.getRequired("refusal")
+
+    /**
+     * The sequence number of this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.refusal.done`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.refusal.done")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [contentIndex].
+     *
+     * Unlike [contentIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("content_index")
+    @ExcludeMissing
+    fun _contentIndex(): JsonField<Long> = contentIndex
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [refusal].
+     *
+     * Unlike [refusal], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("refusal") @ExcludeMissing fun _refusal(): JsonField<String> = refusal
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseRefusalDoneEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .contentIndex()
+         * .itemId()
+         * .outputIndex()
+         * .refusal()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseRefusalDoneEvent]. */
+    class Builder internal constructor() {
+
+        private var contentIndex: JsonField<Long>? = null
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var refusal: JsonField<String>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.refusal.done")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseRefusalDoneEvent: BetaResponseRefusalDoneEvent) = apply {
+            contentIndex = betaResponseRefusalDoneEvent.contentIndex
+            itemId = betaResponseRefusalDoneEvent.itemId
+            outputIndex = betaResponseRefusalDoneEvent.outputIndex
+            refusal = betaResponseRefusalDoneEvent.refusal
+            sequenceNumber = betaResponseRefusalDoneEvent.sequenceNumber
+            type = betaResponseRefusalDoneEvent.type
+            agent = betaResponseRefusalDoneEvent.agent
+            additionalProperties = betaResponseRefusalDoneEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The index of the content part that the refusal text is finalized. */
+        fun contentIndex(contentIndex: Long) = contentIndex(JsonField.of(contentIndex))
+
+        /**
+         * Sets [Builder.contentIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.contentIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun contentIndex(contentIndex: JsonField<Long>) = apply { this.contentIndex = contentIndex }
+
+        /** The ID of the output item that the refusal text is finalized. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item that the refusal text is finalized. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The refusal text that is finalized. */
+        fun refusal(refusal: String) = refusal(JsonField.of(refusal))
+
+        /**
+         * Sets [Builder.refusal] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.refusal] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun refusal(refusal: JsonField<String>) = apply { this.refusal = refusal }
+
+        /** The sequence number of this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.refusal.done")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseRefusalDoneEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .contentIndex()
+         * .itemId()
+         * .outputIndex()
+         * .refusal()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseRefusalDoneEvent =
+            BetaResponseRefusalDoneEvent(
+                checkRequired("contentIndex", contentIndex),
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("refusal", refusal),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseRefusalDoneEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        contentIndex()
+        itemId()
+        outputIndex()
+        refusal()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.refusal.done")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (contentIndex.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (refusal.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.refusal.done")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseRefusalDoneEvent &&
+            contentIndex == other.contentIndex &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            refusal == other.refusal &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            contentIndex,
+            itemId,
+            outputIndex,
+            refusal,
+            sequenceNumber,
+            type,
+            agent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseRefusalDoneEvent{contentIndex=$contentIndex, itemId=$itemId, outputIndex=$outputIndex, refusal=$refusal, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseStatus.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseStatus.kt
new file mode 100644
index 000000000..f86c94693
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseStatus.kt
@@ -0,0 +1,170 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.openai.core.Enum
+import com.openai.core.JsonField
+import com.openai.errors.OpenAIInvalidDataException
+
+/**
+ * The status of the response generation. One of `completed`, `failed`, `in_progress`, `cancelled`,
+ * `queued`, or `incomplete`.
+ */
+class BetaResponseStatus @JsonCreator private constructor(private val value: JsonField<String>) :
+    Enum {
+
+    /**
+     * Returns this class instance's raw value.
+     *
+     * This is usually only useful if this instance was deserialized from data that doesn't match
+     * any known member, and you want to know that value. For example, if the SDK is on an older
+     * version than the API, then the API may respond with new members that the SDK is unaware of.
+     */
+    @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+    companion object {
+
+        @JvmField val COMPLETED = of("completed")
+
+        @JvmField val FAILED = of("failed")
+
+        @JvmField val IN_PROGRESS = of("in_progress")
+
+        @JvmField val CANCELLED = of("cancelled")
+
+        @JvmField val QUEUED = of("queued")
+
+        @JvmField val INCOMPLETE = of("incomplete")
+
+        @JvmStatic fun of(value: String) = BetaResponseStatus(JsonField.of(value))
+    }
+
+    /** An enum containing [BetaResponseStatus]'s known values. */
+    enum class Known {
+        COMPLETED,
+        FAILED,
+        IN_PROGRESS,
+        CANCELLED,
+        QUEUED,
+        INCOMPLETE,
+    }
+
+    /**
+     * An enum containing [BetaResponseStatus]'s known values, as well as an [_UNKNOWN] member.
+     *
+     * An instance of [BetaResponseStatus] can contain an unknown value in a couple of cases:
+     * - It was deserialized from data that doesn't match any known member. For example, if the SDK
+     *   is on an older version than the API, then the API may respond with new members that the SDK
+     *   is unaware of.
+     * - It was constructed with an arbitrary value using the [of] method.
+     */
+    enum class Value {
+        COMPLETED,
+        FAILED,
+        IN_PROGRESS,
+        CANCELLED,
+        QUEUED,
+        INCOMPLETE,
+        /**
+         * An enum member indicating that [BetaResponseStatus] was instantiated with an unknown
+         * value.
+         */
+        _UNKNOWN,
+    }
+
+    /**
+     * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN] if
+     * the class was instantiated with an unknown value.
+     *
+     * Use the [known] method instead if you're certain the value is always known or if you want to
+     * throw for the unknown case.
+     */
+    fun value(): Value =
+        when (this) {
+            COMPLETED -> Value.COMPLETED
+            FAILED -> Value.FAILED
+            IN_PROGRESS -> Value.IN_PROGRESS
+            CANCELLED -> Value.CANCELLED
+            QUEUED -> Value.QUEUED
+            INCOMPLETE -> Value.INCOMPLETE
+            else -> Value._UNKNOWN
+        }
+
+    /**
+     * Returns an enum member corresponding to this class instance's value.
+     *
+     * Use the [value] method instead if you're uncertain the value is always known and don't want
+     * to throw for the unknown case.
+     *
+     * @throws OpenAIInvalidDataException if this class instance's value is a not a known member.
+     */
+    fun known(): Known =
+        when (this) {
+            COMPLETED -> Known.COMPLETED
+            FAILED -> Known.FAILED
+            IN_PROGRESS -> Known.IN_PROGRESS
+            CANCELLED -> Known.CANCELLED
+            QUEUED -> Known.QUEUED
+            INCOMPLETE -> Known.INCOMPLETE
+            else -> throw OpenAIInvalidDataException("Unknown BetaResponseStatus: $value")
+        }
+
+    /**
+     * Returns this class instance's primitive wire representation.
+     *
+     * This differs from the [toString] method because that method is primarily for debugging and
+     * generally doesn't throw.
+     *
+     * @throws OpenAIInvalidDataException if this class instance's value does not have the expected
+     *   primitive type.
+     */
+    fun asString(): String =
+        _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseStatus = apply {
+        if (validated) {
+            return@apply
+        }
+
+        known()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseStatus && value == other.value
+    }
+
+    override fun hashCode() = value.hashCode()
+
+    override fun toString() = value.toString()
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseStreamEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseStreamEvent.kt
new file mode 100644
index 000000000..19fe8bbf4
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseStreamEvent.kt
@@ -0,0 +1,2851 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.JsonValue
+import com.openai.core.getOrThrow
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when there is a partial audio response. */
+@JsonDeserialize(using = BetaResponseStreamEvent.Deserializer::class)
+@JsonSerialize(using = BetaResponseStreamEvent.Serializer::class)
+class BetaResponseStreamEvent
+private constructor(
+    private val responseAudioDelta: BetaResponseAudioDeltaEvent? = null,
+    private val responseAudioDone: BetaResponseAudioDoneEvent? = null,
+    private val responseAudioTranscriptDelta: BetaResponseAudioTranscriptDeltaEvent? = null,
+    private val responseAudioTranscriptDone: BetaResponseAudioTranscriptDoneEvent? = null,
+    private val responseCodeInterpreterCallCodeDelta:
+        BetaResponseCodeInterpreterCallCodeDeltaEvent? =
+        null,
+    private val responseCodeInterpreterCallCodeDone: BetaResponseCodeInterpreterCallCodeDoneEvent? =
+        null,
+    private val responseCodeInterpreterCallCompleted:
+        BetaResponseCodeInterpreterCallCompletedEvent? =
+        null,
+    private val responseCodeInterpreterCallInProgress:
+        BetaResponseCodeInterpreterCallInProgressEvent? =
+        null,
+    private val responseCodeInterpreterCallInterpreting:
+        BetaResponseCodeInterpreterCallInterpretingEvent? =
+        null,
+    private val responseCompleted: BetaResponseCompletedEvent? = null,
+    private val responseContentPartAdded: BetaResponseContentPartAddedEvent? = null,
+    private val responseContentPartDone: BetaResponseContentPartDoneEvent? = null,
+    private val responseCreated: BetaResponseCreatedEvent? = null,
+    private val error: BetaResponseErrorEvent? = null,
+    private val responseFileSearchCallCompleted: BetaResponseFileSearchCallCompletedEvent? = null,
+    private val responseFileSearchCallInProgress: BetaResponseFileSearchCallInProgressEvent? = null,
+    private val responseFileSearchCallSearching: BetaResponseFileSearchCallSearchingEvent? = null,
+    private val responseFunctionCallArgumentsDelta: BetaResponseFunctionCallArgumentsDeltaEvent? =
+        null,
+    private val responseFunctionCallArgumentsDone: BetaResponseFunctionCallArgumentsDoneEvent? =
+        null,
+    private val responseInProgress: BetaResponseInProgressEvent? = null,
+    private val responseFailed: BetaResponseFailedEvent? = null,
+    private val responseIncomplete: BetaResponseIncompleteEvent? = null,
+    private val responseOutputItemAdded: BetaResponseOutputItemAddedEvent? = null,
+    private val responseOutputItemDone: BetaResponseOutputItemDoneEvent? = null,
+    private val responseReasoningSummaryPartAdded: BetaResponseReasoningSummaryPartAddedEvent? =
+        null,
+    private val responseReasoningSummaryPartDone: BetaResponseReasoningSummaryPartDoneEvent? = null,
+    private val responseReasoningSummaryTextDelta: BetaResponseReasoningSummaryTextDeltaEvent? =
+        null,
+    private val responseReasoningSummaryTextDone: BetaResponseReasoningSummaryTextDoneEvent? = null,
+    private val responseReasoningTextDelta: BetaResponseReasoningTextDeltaEvent? = null,
+    private val responseReasoningTextDone: BetaResponseReasoningTextDoneEvent? = null,
+    private val responseRefusalDelta: BetaResponseRefusalDeltaEvent? = null,
+    private val responseRefusalDone: BetaResponseRefusalDoneEvent? = null,
+    private val responseOutputTextDelta: BetaResponseTextDeltaEvent? = null,
+    private val responseOutputTextDone: BetaResponseTextDoneEvent? = null,
+    private val responseWebSearchCallCompleted: BetaResponseWebSearchCallCompletedEvent? = null,
+    private val responseWebSearchCallInProgress: BetaResponseWebSearchCallInProgressEvent? = null,
+    private val responseWebSearchCallSearching: BetaResponseWebSearchCallSearchingEvent? = null,
+    private val responseImageGenerationCallCompleted: BetaResponseImageGenCallCompletedEvent? =
+        null,
+    private val responseImageGenerationCallGenerating: BetaResponseImageGenCallGeneratingEvent? =
+        null,
+    private val responseImageGenerationCallInProgress: BetaResponseImageGenCallInProgressEvent? =
+        null,
+    private val responseImageGenerationCallPartialImage:
+        BetaResponseImageGenCallPartialImageEvent? =
+        null,
+    private val responseMcpCallArgumentsDelta: BetaResponseMcpCallArgumentsDeltaEvent? = null,
+    private val responseMcpCallArgumentsDone: BetaResponseMcpCallArgumentsDoneEvent? = null,
+    private val responseMcpCallCompleted: BetaResponseMcpCallCompletedEvent? = null,
+    private val responseMcpCallFailed: BetaResponseMcpCallFailedEvent? = null,
+    private val responseMcpCallInProgress: BetaResponseMcpCallInProgressEvent? = null,
+    private val responseMcpListToolsCompleted: BetaResponseMcpListToolsCompletedEvent? = null,
+    private val responseMcpListToolsFailed: BetaResponseMcpListToolsFailedEvent? = null,
+    private val responseMcpListToolsInProgress: BetaResponseMcpListToolsInProgressEvent? = null,
+    private val responseOutputTextAnnotationAdded: BetaResponseOutputTextAnnotationAddedEvent? =
+        null,
+    private val responseQueued: BetaResponseQueuedEvent? = null,
+    private val responseCustomToolCallInputDelta: BetaResponseCustomToolCallInputDeltaEvent? = null,
+    private val responseCustomToolCallInputDone: BetaResponseCustomToolCallInputDoneEvent? = null,
+    private val _json: JsonValue? = null,
+) {
+
+    /** Emitted when there is a partial audio response. */
+    fun responseAudioDelta(): Optional<BetaResponseAudioDeltaEvent> =
+        Optional.ofNullable(responseAudioDelta)
+
+    /** Emitted when the audio response is complete. */
+    fun responseAudioDone(): Optional<BetaResponseAudioDoneEvent> =
+        Optional.ofNullable(responseAudioDone)
+
+    /** Emitted when there is a partial transcript of audio. */
+    fun responseAudioTranscriptDelta(): Optional<BetaResponseAudioTranscriptDeltaEvent> =
+        Optional.ofNullable(responseAudioTranscriptDelta)
+
+    /** Emitted when the full audio transcript is completed. */
+    fun responseAudioTranscriptDone(): Optional<BetaResponseAudioTranscriptDoneEvent> =
+        Optional.ofNullable(responseAudioTranscriptDone)
+
+    /** Emitted when a partial code snippet is streamed by the code interpreter. */
+    fun responseCodeInterpreterCallCodeDelta():
+        Optional<BetaResponseCodeInterpreterCallCodeDeltaEvent> =
+        Optional.ofNullable(responseCodeInterpreterCallCodeDelta)
+
+    /** Emitted when the code snippet is finalized by the code interpreter. */
+    fun responseCodeInterpreterCallCodeDone():
+        Optional<BetaResponseCodeInterpreterCallCodeDoneEvent> =
+        Optional.ofNullable(responseCodeInterpreterCallCodeDone)
+
+    /** Emitted when the code interpreter call is completed. */
+    fun responseCodeInterpreterCallCompleted():
+        Optional<BetaResponseCodeInterpreterCallCompletedEvent> =
+        Optional.ofNullable(responseCodeInterpreterCallCompleted)
+
+    /** Emitted when a code interpreter call is in progress. */
+    fun responseCodeInterpreterCallInProgress():
+        Optional<BetaResponseCodeInterpreterCallInProgressEvent> =
+        Optional.ofNullable(responseCodeInterpreterCallInProgress)
+
+    /** Emitted when the code interpreter is actively interpreting the code snippet. */
+    fun responseCodeInterpreterCallInterpreting():
+        Optional<BetaResponseCodeInterpreterCallInterpretingEvent> =
+        Optional.ofNullable(responseCodeInterpreterCallInterpreting)
+
+    /** Emitted when the model response is complete. */
+    fun responseCompleted(): Optional<BetaResponseCompletedEvent> =
+        Optional.ofNullable(responseCompleted)
+
+    /** Emitted when a new content part is added. */
+    fun responseContentPartAdded(): Optional<BetaResponseContentPartAddedEvent> =
+        Optional.ofNullable(responseContentPartAdded)
+
+    /** Emitted when a content part is done. */
+    fun responseContentPartDone(): Optional<BetaResponseContentPartDoneEvent> =
+        Optional.ofNullable(responseContentPartDone)
+
+    /** An event that is emitted when a response is created. */
+    fun responseCreated(): Optional<BetaResponseCreatedEvent> = Optional.ofNullable(responseCreated)
+
+    /** Emitted when an error occurs. */
+    fun error(): Optional<BetaResponseErrorEvent> = Optional.ofNullable(error)
+
+    /** Emitted when a file search call is completed (results found). */
+    fun responseFileSearchCallCompleted(): Optional<BetaResponseFileSearchCallCompletedEvent> =
+        Optional.ofNullable(responseFileSearchCallCompleted)
+
+    /** Emitted when a file search call is initiated. */
+    fun responseFileSearchCallInProgress(): Optional<BetaResponseFileSearchCallInProgressEvent> =
+        Optional.ofNullable(responseFileSearchCallInProgress)
+
+    /** Emitted when a file search is currently searching. */
+    fun responseFileSearchCallSearching(): Optional<BetaResponseFileSearchCallSearchingEvent> =
+        Optional.ofNullable(responseFileSearchCallSearching)
+
+    /** Emitted when there is a partial function-call arguments delta. */
+    fun responseFunctionCallArgumentsDelta():
+        Optional<BetaResponseFunctionCallArgumentsDeltaEvent> =
+        Optional.ofNullable(responseFunctionCallArgumentsDelta)
+
+    /** Emitted when function-call arguments are finalized. */
+    fun responseFunctionCallArgumentsDone(): Optional<BetaResponseFunctionCallArgumentsDoneEvent> =
+        Optional.ofNullable(responseFunctionCallArgumentsDone)
+
+    /** Emitted when the response is in progress. */
+    fun responseInProgress(): Optional<BetaResponseInProgressEvent> =
+        Optional.ofNullable(responseInProgress)
+
+    /** An event that is emitted when a response fails. */
+    fun responseFailed(): Optional<BetaResponseFailedEvent> = Optional.ofNullable(responseFailed)
+
+    /** An event that is emitted when a response finishes as incomplete. */
+    fun responseIncomplete(): Optional<BetaResponseIncompleteEvent> =
+        Optional.ofNullable(responseIncomplete)
+
+    /** Emitted when a new output item is added. */
+    fun responseOutputItemAdded(): Optional<BetaResponseOutputItemAddedEvent> =
+        Optional.ofNullable(responseOutputItemAdded)
+
+    /** Emitted when an output item is marked done. */
+    fun responseOutputItemDone(): Optional<BetaResponseOutputItemDoneEvent> =
+        Optional.ofNullable(responseOutputItemDone)
+
+    /** Emitted when a new reasoning summary part is added. */
+    fun responseReasoningSummaryPartAdded(): Optional<BetaResponseReasoningSummaryPartAddedEvent> =
+        Optional.ofNullable(responseReasoningSummaryPartAdded)
+
+    /** Emitted when a reasoning summary part is completed. */
+    fun responseReasoningSummaryPartDone(): Optional<BetaResponseReasoningSummaryPartDoneEvent> =
+        Optional.ofNullable(responseReasoningSummaryPartDone)
+
+    /** Emitted when a delta is added to a reasoning summary text. */
+    fun responseReasoningSummaryTextDelta(): Optional<BetaResponseReasoningSummaryTextDeltaEvent> =
+        Optional.ofNullable(responseReasoningSummaryTextDelta)
+
+    /** Emitted when a reasoning summary text is completed. */
+    fun responseReasoningSummaryTextDone(): Optional<BetaResponseReasoningSummaryTextDoneEvent> =
+        Optional.ofNullable(responseReasoningSummaryTextDone)
+
+    /** Emitted when a delta is added to a reasoning text. */
+    fun responseReasoningTextDelta(): Optional<BetaResponseReasoningTextDeltaEvent> =
+        Optional.ofNullable(responseReasoningTextDelta)
+
+    /** Emitted when a reasoning text is completed. */
+    fun responseReasoningTextDone(): Optional<BetaResponseReasoningTextDoneEvent> =
+        Optional.ofNullable(responseReasoningTextDone)
+
+    /** Emitted when there is a partial refusal text. */
+    fun responseRefusalDelta(): Optional<BetaResponseRefusalDeltaEvent> =
+        Optional.ofNullable(responseRefusalDelta)
+
+    /** Emitted when refusal text is finalized. */
+    fun responseRefusalDone(): Optional<BetaResponseRefusalDoneEvent> =
+        Optional.ofNullable(responseRefusalDone)
+
+    /** Emitted when there is an additional text delta. */
+    fun responseOutputTextDelta(): Optional<BetaResponseTextDeltaEvent> =
+        Optional.ofNullable(responseOutputTextDelta)
+
+    /** Emitted when text content is finalized. */
+    fun responseOutputTextDone(): Optional<BetaResponseTextDoneEvent> =
+        Optional.ofNullable(responseOutputTextDone)
+
+    /** Emitted when a web search call is completed. */
+    fun responseWebSearchCallCompleted(): Optional<BetaResponseWebSearchCallCompletedEvent> =
+        Optional.ofNullable(responseWebSearchCallCompleted)
+
+    /** Emitted when a web search call is initiated. */
+    fun responseWebSearchCallInProgress(): Optional<BetaResponseWebSearchCallInProgressEvent> =
+        Optional.ofNullable(responseWebSearchCallInProgress)
+
+    /** Emitted when a web search call is executing. */
+    fun responseWebSearchCallSearching(): Optional<BetaResponseWebSearchCallSearchingEvent> =
+        Optional.ofNullable(responseWebSearchCallSearching)
+
+    /**
+     * Emitted when an image generation tool call has completed and the final image is available.
+     */
+    fun responseImageGenerationCallCompleted(): Optional<BetaResponseImageGenCallCompletedEvent> =
+        Optional.ofNullable(responseImageGenerationCallCompleted)
+
+    /**
+     * Emitted when an image generation tool call is actively generating an image (intermediate
+     * state).
+     */
+    fun responseImageGenerationCallGenerating(): Optional<BetaResponseImageGenCallGeneratingEvent> =
+        Optional.ofNullable(responseImageGenerationCallGenerating)
+
+    /** Emitted when an image generation tool call is in progress. */
+    fun responseImageGenerationCallInProgress(): Optional<BetaResponseImageGenCallInProgressEvent> =
+        Optional.ofNullable(responseImageGenerationCallInProgress)
+
+    /** Emitted when a partial image is available during image generation streaming. */
+    fun responseImageGenerationCallPartialImage():
+        Optional<BetaResponseImageGenCallPartialImageEvent> =
+        Optional.ofNullable(responseImageGenerationCallPartialImage)
+
+    /** Emitted when there is a delta (partial update) to the arguments of an MCP tool call. */
+    fun responseMcpCallArgumentsDelta(): Optional<BetaResponseMcpCallArgumentsDeltaEvent> =
+        Optional.ofNullable(responseMcpCallArgumentsDelta)
+
+    /** Emitted when the arguments for an MCP tool call are finalized. */
+    fun responseMcpCallArgumentsDone(): Optional<BetaResponseMcpCallArgumentsDoneEvent> =
+        Optional.ofNullable(responseMcpCallArgumentsDone)
+
+    /** Emitted when an MCP tool call has completed successfully. */
+    fun responseMcpCallCompleted(): Optional<BetaResponseMcpCallCompletedEvent> =
+        Optional.ofNullable(responseMcpCallCompleted)
+
+    /** Emitted when an MCP tool call has failed. */
+    fun responseMcpCallFailed(): Optional<BetaResponseMcpCallFailedEvent> =
+        Optional.ofNullable(responseMcpCallFailed)
+
+    /** Emitted when an MCP tool call is in progress. */
+    fun responseMcpCallInProgress(): Optional<BetaResponseMcpCallInProgressEvent> =
+        Optional.ofNullable(responseMcpCallInProgress)
+
+    /** Emitted when the list of available MCP tools has been successfully retrieved. */
+    fun responseMcpListToolsCompleted(): Optional<BetaResponseMcpListToolsCompletedEvent> =
+        Optional.ofNullable(responseMcpListToolsCompleted)
+
+    /** Emitted when the attempt to list available MCP tools has failed. */
+    fun responseMcpListToolsFailed(): Optional<BetaResponseMcpListToolsFailedEvent> =
+        Optional.ofNullable(responseMcpListToolsFailed)
+
+    /** Emitted when the system is in the process of retrieving the list of available MCP tools. */
+    fun responseMcpListToolsInProgress(): Optional<BetaResponseMcpListToolsInProgressEvent> =
+        Optional.ofNullable(responseMcpListToolsInProgress)
+
+    /** Emitted when an annotation is added to output text content. */
+    fun responseOutputTextAnnotationAdded(): Optional<BetaResponseOutputTextAnnotationAddedEvent> =
+        Optional.ofNullable(responseOutputTextAnnotationAdded)
+
+    /** Emitted when a response is queued and waiting to be processed. */
+    fun responseQueued(): Optional<BetaResponseQueuedEvent> = Optional.ofNullable(responseQueued)
+
+    /** Event representing a delta (partial update) to the input of a custom tool call. */
+    fun responseCustomToolCallInputDelta(): Optional<BetaResponseCustomToolCallInputDeltaEvent> =
+        Optional.ofNullable(responseCustomToolCallInputDelta)
+
+    /** Event indicating that input for a custom tool call is complete. */
+    fun responseCustomToolCallInputDone(): Optional<BetaResponseCustomToolCallInputDoneEvent> =
+        Optional.ofNullable(responseCustomToolCallInputDone)
+
+    fun isResponseAudioDelta(): Boolean = responseAudioDelta != null
+
+    fun isResponseAudioDone(): Boolean = responseAudioDone != null
+
+    fun isResponseAudioTranscriptDelta(): Boolean = responseAudioTranscriptDelta != null
+
+    fun isResponseAudioTranscriptDone(): Boolean = responseAudioTranscriptDone != null
+
+    fun isResponseCodeInterpreterCallCodeDelta(): Boolean =
+        responseCodeInterpreterCallCodeDelta != null
+
+    fun isResponseCodeInterpreterCallCodeDone(): Boolean =
+        responseCodeInterpreterCallCodeDone != null
+
+    fun isResponseCodeInterpreterCallCompleted(): Boolean =
+        responseCodeInterpreterCallCompleted != null
+
+    fun isResponseCodeInterpreterCallInProgress(): Boolean =
+        responseCodeInterpreterCallInProgress != null
+
+    fun isResponseCodeInterpreterCallInterpreting(): Boolean =
+        responseCodeInterpreterCallInterpreting != null
+
+    fun isResponseCompleted(): Boolean = responseCompleted != null
+
+    fun isResponseContentPartAdded(): Boolean = responseContentPartAdded != null
+
+    fun isResponseContentPartDone(): Boolean = responseContentPartDone != null
+
+    fun isResponseCreated(): Boolean = responseCreated != null
+
+    fun isError(): Boolean = error != null
+
+    fun isResponseFileSearchCallCompleted(): Boolean = responseFileSearchCallCompleted != null
+
+    fun isResponseFileSearchCallInProgress(): Boolean = responseFileSearchCallInProgress != null
+
+    fun isResponseFileSearchCallSearching(): Boolean = responseFileSearchCallSearching != null
+
+    fun isResponseFunctionCallArgumentsDelta(): Boolean = responseFunctionCallArgumentsDelta != null
+
+    fun isResponseFunctionCallArgumentsDone(): Boolean = responseFunctionCallArgumentsDone != null
+
+    fun isResponseInProgress(): Boolean = responseInProgress != null
+
+    fun isResponseFailed(): Boolean = responseFailed != null
+
+    fun isResponseIncomplete(): Boolean = responseIncomplete != null
+
+    fun isResponseOutputItemAdded(): Boolean = responseOutputItemAdded != null
+
+    fun isResponseOutputItemDone(): Boolean = responseOutputItemDone != null
+
+    fun isResponseReasoningSummaryPartAdded(): Boolean = responseReasoningSummaryPartAdded != null
+
+    fun isResponseReasoningSummaryPartDone(): Boolean = responseReasoningSummaryPartDone != null
+
+    fun isResponseReasoningSummaryTextDelta(): Boolean = responseReasoningSummaryTextDelta != null
+
+    fun isResponseReasoningSummaryTextDone(): Boolean = responseReasoningSummaryTextDone != null
+
+    fun isResponseReasoningTextDelta(): Boolean = responseReasoningTextDelta != null
+
+    fun isResponseReasoningTextDone(): Boolean = responseReasoningTextDone != null
+
+    fun isResponseRefusalDelta(): Boolean = responseRefusalDelta != null
+
+    fun isResponseRefusalDone(): Boolean = responseRefusalDone != null
+
+    fun isResponseOutputTextDelta(): Boolean = responseOutputTextDelta != null
+
+    fun isResponseOutputTextDone(): Boolean = responseOutputTextDone != null
+
+    fun isResponseWebSearchCallCompleted(): Boolean = responseWebSearchCallCompleted != null
+
+    fun isResponseWebSearchCallInProgress(): Boolean = responseWebSearchCallInProgress != null
+
+    fun isResponseWebSearchCallSearching(): Boolean = responseWebSearchCallSearching != null
+
+    fun isResponseImageGenerationCallCompleted(): Boolean =
+        responseImageGenerationCallCompleted != null
+
+    fun isResponseImageGenerationCallGenerating(): Boolean =
+        responseImageGenerationCallGenerating != null
+
+    fun isResponseImageGenerationCallInProgress(): Boolean =
+        responseImageGenerationCallInProgress != null
+
+    fun isResponseImageGenerationCallPartialImage(): Boolean =
+        responseImageGenerationCallPartialImage != null
+
+    fun isResponseMcpCallArgumentsDelta(): Boolean = responseMcpCallArgumentsDelta != null
+
+    fun isResponseMcpCallArgumentsDone(): Boolean = responseMcpCallArgumentsDone != null
+
+    fun isResponseMcpCallCompleted(): Boolean = responseMcpCallCompleted != null
+
+    fun isResponseMcpCallFailed(): Boolean = responseMcpCallFailed != null
+
+    fun isResponseMcpCallInProgress(): Boolean = responseMcpCallInProgress != null
+
+    fun isResponseMcpListToolsCompleted(): Boolean = responseMcpListToolsCompleted != null
+
+    fun isResponseMcpListToolsFailed(): Boolean = responseMcpListToolsFailed != null
+
+    fun isResponseMcpListToolsInProgress(): Boolean = responseMcpListToolsInProgress != null
+
+    fun isResponseOutputTextAnnotationAdded(): Boolean = responseOutputTextAnnotationAdded != null
+
+    fun isResponseQueued(): Boolean = responseQueued != null
+
+    fun isResponseCustomToolCallInputDelta(): Boolean = responseCustomToolCallInputDelta != null
+
+    fun isResponseCustomToolCallInputDone(): Boolean = responseCustomToolCallInputDone != null
+
+    /** Emitted when there is a partial audio response. */
+    fun asResponseAudioDelta(): BetaResponseAudioDeltaEvent =
+        responseAudioDelta.getOrThrow("responseAudioDelta")
+
+    /** Emitted when the audio response is complete. */
+    fun asResponseAudioDone(): BetaResponseAudioDoneEvent =
+        responseAudioDone.getOrThrow("responseAudioDone")
+
+    /** Emitted when there is a partial transcript of audio. */
+    fun asResponseAudioTranscriptDelta(): BetaResponseAudioTranscriptDeltaEvent =
+        responseAudioTranscriptDelta.getOrThrow("responseAudioTranscriptDelta")
+
+    /** Emitted when the full audio transcript is completed. */
+    fun asResponseAudioTranscriptDone(): BetaResponseAudioTranscriptDoneEvent =
+        responseAudioTranscriptDone.getOrThrow("responseAudioTranscriptDone")
+
+    /** Emitted when a partial code snippet is streamed by the code interpreter. */
+    fun asResponseCodeInterpreterCallCodeDelta(): BetaResponseCodeInterpreterCallCodeDeltaEvent =
+        responseCodeInterpreterCallCodeDelta.getOrThrow("responseCodeInterpreterCallCodeDelta")
+
+    /** Emitted when the code snippet is finalized by the code interpreter. */
+    fun asResponseCodeInterpreterCallCodeDone(): BetaResponseCodeInterpreterCallCodeDoneEvent =
+        responseCodeInterpreterCallCodeDone.getOrThrow("responseCodeInterpreterCallCodeDone")
+
+    /** Emitted when the code interpreter call is completed. */
+    fun asResponseCodeInterpreterCallCompleted(): BetaResponseCodeInterpreterCallCompletedEvent =
+        responseCodeInterpreterCallCompleted.getOrThrow("responseCodeInterpreterCallCompleted")
+
+    /** Emitted when a code interpreter call is in progress. */
+    fun asResponseCodeInterpreterCallInProgress(): BetaResponseCodeInterpreterCallInProgressEvent =
+        responseCodeInterpreterCallInProgress.getOrThrow("responseCodeInterpreterCallInProgress")
+
+    /** Emitted when the code interpreter is actively interpreting the code snippet. */
+    fun asResponseCodeInterpreterCallInterpreting():
+        BetaResponseCodeInterpreterCallInterpretingEvent =
+        responseCodeInterpreterCallInterpreting.getOrThrow(
+            "responseCodeInterpreterCallInterpreting"
+        )
+
+    /** Emitted when the model response is complete. */
+    fun asResponseCompleted(): BetaResponseCompletedEvent =
+        responseCompleted.getOrThrow("responseCompleted")
+
+    /** Emitted when a new content part is added. */
+    fun asResponseContentPartAdded(): BetaResponseContentPartAddedEvent =
+        responseContentPartAdded.getOrThrow("responseContentPartAdded")
+
+    /** Emitted when a content part is done. */
+    fun asResponseContentPartDone(): BetaResponseContentPartDoneEvent =
+        responseContentPartDone.getOrThrow("responseContentPartDone")
+
+    /** An event that is emitted when a response is created. */
+    fun asResponseCreated(): BetaResponseCreatedEvent =
+        responseCreated.getOrThrow("responseCreated")
+
+    /** Emitted when an error occurs. */
+    fun asError(): BetaResponseErrorEvent = error.getOrThrow("error")
+
+    /** Emitted when a file search call is completed (results found). */
+    fun asResponseFileSearchCallCompleted(): BetaResponseFileSearchCallCompletedEvent =
+        responseFileSearchCallCompleted.getOrThrow("responseFileSearchCallCompleted")
+
+    /** Emitted when a file search call is initiated. */
+    fun asResponseFileSearchCallInProgress(): BetaResponseFileSearchCallInProgressEvent =
+        responseFileSearchCallInProgress.getOrThrow("responseFileSearchCallInProgress")
+
+    /** Emitted when a file search is currently searching. */
+    fun asResponseFileSearchCallSearching(): BetaResponseFileSearchCallSearchingEvent =
+        responseFileSearchCallSearching.getOrThrow("responseFileSearchCallSearching")
+
+    /** Emitted when there is a partial function-call arguments delta. */
+    fun asResponseFunctionCallArgumentsDelta(): BetaResponseFunctionCallArgumentsDeltaEvent =
+        responseFunctionCallArgumentsDelta.getOrThrow("responseFunctionCallArgumentsDelta")
+
+    /** Emitted when function-call arguments are finalized. */
+    fun asResponseFunctionCallArgumentsDone(): BetaResponseFunctionCallArgumentsDoneEvent =
+        responseFunctionCallArgumentsDone.getOrThrow("responseFunctionCallArgumentsDone")
+
+    /** Emitted when the response is in progress. */
+    fun asResponseInProgress(): BetaResponseInProgressEvent =
+        responseInProgress.getOrThrow("responseInProgress")
+
+    /** An event that is emitted when a response fails. */
+    fun asResponseFailed(): BetaResponseFailedEvent = responseFailed.getOrThrow("responseFailed")
+
+    /** An event that is emitted when a response finishes as incomplete. */
+    fun asResponseIncomplete(): BetaResponseIncompleteEvent =
+        responseIncomplete.getOrThrow("responseIncomplete")
+
+    /** Emitted when a new output item is added. */
+    fun asResponseOutputItemAdded(): BetaResponseOutputItemAddedEvent =
+        responseOutputItemAdded.getOrThrow("responseOutputItemAdded")
+
+    /** Emitted when an output item is marked done. */
+    fun asResponseOutputItemDone(): BetaResponseOutputItemDoneEvent =
+        responseOutputItemDone.getOrThrow("responseOutputItemDone")
+
+    /** Emitted when a new reasoning summary part is added. */
+    fun asResponseReasoningSummaryPartAdded(): BetaResponseReasoningSummaryPartAddedEvent =
+        responseReasoningSummaryPartAdded.getOrThrow("responseReasoningSummaryPartAdded")
+
+    /** Emitted when a reasoning summary part is completed. */
+    fun asResponseReasoningSummaryPartDone(): BetaResponseReasoningSummaryPartDoneEvent =
+        responseReasoningSummaryPartDone.getOrThrow("responseReasoningSummaryPartDone")
+
+    /** Emitted when a delta is added to a reasoning summary text. */
+    fun asResponseReasoningSummaryTextDelta(): BetaResponseReasoningSummaryTextDeltaEvent =
+        responseReasoningSummaryTextDelta.getOrThrow("responseReasoningSummaryTextDelta")
+
+    /** Emitted when a reasoning summary text is completed. */
+    fun asResponseReasoningSummaryTextDone(): BetaResponseReasoningSummaryTextDoneEvent =
+        responseReasoningSummaryTextDone.getOrThrow("responseReasoningSummaryTextDone")
+
+    /** Emitted when a delta is added to a reasoning text. */
+    fun asResponseReasoningTextDelta(): BetaResponseReasoningTextDeltaEvent =
+        responseReasoningTextDelta.getOrThrow("responseReasoningTextDelta")
+
+    /** Emitted when a reasoning text is completed. */
+    fun asResponseReasoningTextDone(): BetaResponseReasoningTextDoneEvent =
+        responseReasoningTextDone.getOrThrow("responseReasoningTextDone")
+
+    /** Emitted when there is a partial refusal text. */
+    fun asResponseRefusalDelta(): BetaResponseRefusalDeltaEvent =
+        responseRefusalDelta.getOrThrow("responseRefusalDelta")
+
+    /** Emitted when refusal text is finalized. */
+    fun asResponseRefusalDone(): BetaResponseRefusalDoneEvent =
+        responseRefusalDone.getOrThrow("responseRefusalDone")
+
+    /** Emitted when there is an additional text delta. */
+    fun asResponseOutputTextDelta(): BetaResponseTextDeltaEvent =
+        responseOutputTextDelta.getOrThrow("responseOutputTextDelta")
+
+    /** Emitted when text content is finalized. */
+    fun asResponseOutputTextDone(): BetaResponseTextDoneEvent =
+        responseOutputTextDone.getOrThrow("responseOutputTextDone")
+
+    /** Emitted when a web search call is completed. */
+    fun asResponseWebSearchCallCompleted(): BetaResponseWebSearchCallCompletedEvent =
+        responseWebSearchCallCompleted.getOrThrow("responseWebSearchCallCompleted")
+
+    /** Emitted when a web search call is initiated. */
+    fun asResponseWebSearchCallInProgress(): BetaResponseWebSearchCallInProgressEvent =
+        responseWebSearchCallInProgress.getOrThrow("responseWebSearchCallInProgress")
+
+    /** Emitted when a web search call is executing. */
+    fun asResponseWebSearchCallSearching(): BetaResponseWebSearchCallSearchingEvent =
+        responseWebSearchCallSearching.getOrThrow("responseWebSearchCallSearching")
+
+    /**
+     * Emitted when an image generation tool call has completed and the final image is available.
+     */
+    fun asResponseImageGenerationCallCompleted(): BetaResponseImageGenCallCompletedEvent =
+        responseImageGenerationCallCompleted.getOrThrow("responseImageGenerationCallCompleted")
+
+    /**
+     * Emitted when an image generation tool call is actively generating an image (intermediate
+     * state).
+     */
+    fun asResponseImageGenerationCallGenerating(): BetaResponseImageGenCallGeneratingEvent =
+        responseImageGenerationCallGenerating.getOrThrow("responseImageGenerationCallGenerating")
+
+    /** Emitted when an image generation tool call is in progress. */
+    fun asResponseImageGenerationCallInProgress(): BetaResponseImageGenCallInProgressEvent =
+        responseImageGenerationCallInProgress.getOrThrow("responseImageGenerationCallInProgress")
+
+    /** Emitted when a partial image is available during image generation streaming. */
+    fun asResponseImageGenerationCallPartialImage(): BetaResponseImageGenCallPartialImageEvent =
+        responseImageGenerationCallPartialImage.getOrThrow(
+            "responseImageGenerationCallPartialImage"
+        )
+
+    /** Emitted when there is a delta (partial update) to the arguments of an MCP tool call. */
+    fun asResponseMcpCallArgumentsDelta(): BetaResponseMcpCallArgumentsDeltaEvent =
+        responseMcpCallArgumentsDelta.getOrThrow("responseMcpCallArgumentsDelta")
+
+    /** Emitted when the arguments for an MCP tool call are finalized. */
+    fun asResponseMcpCallArgumentsDone(): BetaResponseMcpCallArgumentsDoneEvent =
+        responseMcpCallArgumentsDone.getOrThrow("responseMcpCallArgumentsDone")
+
+    /** Emitted when an MCP tool call has completed successfully. */
+    fun asResponseMcpCallCompleted(): BetaResponseMcpCallCompletedEvent =
+        responseMcpCallCompleted.getOrThrow("responseMcpCallCompleted")
+
+    /** Emitted when an MCP tool call has failed. */
+    fun asResponseMcpCallFailed(): BetaResponseMcpCallFailedEvent =
+        responseMcpCallFailed.getOrThrow("responseMcpCallFailed")
+
+    /** Emitted when an MCP tool call is in progress. */
+    fun asResponseMcpCallInProgress(): BetaResponseMcpCallInProgressEvent =
+        responseMcpCallInProgress.getOrThrow("responseMcpCallInProgress")
+
+    /** Emitted when the list of available MCP tools has been successfully retrieved. */
+    fun asResponseMcpListToolsCompleted(): BetaResponseMcpListToolsCompletedEvent =
+        responseMcpListToolsCompleted.getOrThrow("responseMcpListToolsCompleted")
+
+    /** Emitted when the attempt to list available MCP tools has failed. */
+    fun asResponseMcpListToolsFailed(): BetaResponseMcpListToolsFailedEvent =
+        responseMcpListToolsFailed.getOrThrow("responseMcpListToolsFailed")
+
+    /** Emitted when the system is in the process of retrieving the list of available MCP tools. */
+    fun asResponseMcpListToolsInProgress(): BetaResponseMcpListToolsInProgressEvent =
+        responseMcpListToolsInProgress.getOrThrow("responseMcpListToolsInProgress")
+
+    /** Emitted when an annotation is added to output text content. */
+    fun asResponseOutputTextAnnotationAdded(): BetaResponseOutputTextAnnotationAddedEvent =
+        responseOutputTextAnnotationAdded.getOrThrow("responseOutputTextAnnotationAdded")
+
+    /** Emitted when a response is queued and waiting to be processed. */
+    fun asResponseQueued(): BetaResponseQueuedEvent = responseQueued.getOrThrow("responseQueued")
+
+    /** Event representing a delta (partial update) to the input of a custom tool call. */
+    fun asResponseCustomToolCallInputDelta(): BetaResponseCustomToolCallInputDeltaEvent =
+        responseCustomToolCallInputDelta.getOrThrow("responseCustomToolCallInputDelta")
+
+    /** Event indicating that input for a custom tool call is complete. */
+    fun asResponseCustomToolCallInputDone(): BetaResponseCustomToolCallInputDoneEvent =
+        responseCustomToolCallInputDone.getOrThrow("responseCustomToolCallInputDone")
+
+    fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+    /**
+     * Maps this instance's current variant to a value of type [T] using the given [visitor].
+     *
+     * Note that this method is _not_ forwards compatible with new variants from the API, unless
+     * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of the
+     * SDK gracefully, consider overriding [Visitor.unknown]:
+     * ```java
+     * import com.openai.core.JsonValue;
+     * import java.util.Optional;
+     *
+     * Optional<String> result = betaResponseStreamEvent.accept(new BetaResponseStreamEvent.Visitor<Optional<String>>() {
+     *     @Override
+     *     public Optional<String> visitResponseAudioDelta(BetaResponseAudioDeltaEvent responseAudioDelta) {
+     *         return Optional.of(responseAudioDelta.toString());
+     *     }
+     *
+     *     // ...
+     *
+     *     @Override
+     *     public Optional<String> unknown(JsonValue json) {
+     *         // Or inspect the `json`.
+     *         return Optional.empty();
+     *     }
+     * });
+     * ```
+     *
+     * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor] and
+     *   the current variant is unknown.
+     */
+    fun <T> accept(visitor: Visitor<T>): T =
+        when {
+            responseAudioDelta != null -> visitor.visitResponseAudioDelta(responseAudioDelta)
+            responseAudioDone != null -> visitor.visitResponseAudioDone(responseAudioDone)
+            responseAudioTranscriptDelta != null ->
+                visitor.visitResponseAudioTranscriptDelta(responseAudioTranscriptDelta)
+            responseAudioTranscriptDone != null ->
+                visitor.visitResponseAudioTranscriptDone(responseAudioTranscriptDone)
+            responseCodeInterpreterCallCodeDelta != null ->
+                visitor.visitResponseCodeInterpreterCallCodeDelta(
+                    responseCodeInterpreterCallCodeDelta
+                )
+            responseCodeInterpreterCallCodeDone != null ->
+                visitor.visitResponseCodeInterpreterCallCodeDone(
+                    responseCodeInterpreterCallCodeDone
+                )
+            responseCodeInterpreterCallCompleted != null ->
+                visitor.visitResponseCodeInterpreterCallCompleted(
+                    responseCodeInterpreterCallCompleted
+                )
+            responseCodeInterpreterCallInProgress != null ->
+                visitor.visitResponseCodeInterpreterCallInProgress(
+                    responseCodeInterpreterCallInProgress
+                )
+            responseCodeInterpreterCallInterpreting != null ->
+                visitor.visitResponseCodeInterpreterCallInterpreting(
+                    responseCodeInterpreterCallInterpreting
+                )
+            responseCompleted != null -> visitor.visitResponseCompleted(responseCompleted)
+            responseContentPartAdded != null ->
+                visitor.visitResponseContentPartAdded(responseContentPartAdded)
+            responseContentPartDone != null ->
+                visitor.visitResponseContentPartDone(responseContentPartDone)
+            responseCreated != null -> visitor.visitResponseCreated(responseCreated)
+            error != null -> visitor.visitError(error)
+            responseFileSearchCallCompleted != null ->
+                visitor.visitResponseFileSearchCallCompleted(responseFileSearchCallCompleted)
+            responseFileSearchCallInProgress != null ->
+                visitor.visitResponseFileSearchCallInProgress(responseFileSearchCallInProgress)
+            responseFileSearchCallSearching != null ->
+                visitor.visitResponseFileSearchCallSearching(responseFileSearchCallSearching)
+            responseFunctionCallArgumentsDelta != null ->
+                visitor.visitResponseFunctionCallArgumentsDelta(responseFunctionCallArgumentsDelta)
+            responseFunctionCallArgumentsDone != null ->
+                visitor.visitResponseFunctionCallArgumentsDone(responseFunctionCallArgumentsDone)
+            responseInProgress != null -> visitor.visitResponseInProgress(responseInProgress)
+            responseFailed != null -> visitor.visitResponseFailed(responseFailed)
+            responseIncomplete != null -> visitor.visitResponseIncomplete(responseIncomplete)
+            responseOutputItemAdded != null ->
+                visitor.visitResponseOutputItemAdded(responseOutputItemAdded)
+            responseOutputItemDone != null ->
+                visitor.visitResponseOutputItemDone(responseOutputItemDone)
+            responseReasoningSummaryPartAdded != null ->
+                visitor.visitResponseReasoningSummaryPartAdded(responseReasoningSummaryPartAdded)
+            responseReasoningSummaryPartDone != null ->
+                visitor.visitResponseReasoningSummaryPartDone(responseReasoningSummaryPartDone)
+            responseReasoningSummaryTextDelta != null ->
+                visitor.visitResponseReasoningSummaryTextDelta(responseReasoningSummaryTextDelta)
+            responseReasoningSummaryTextDone != null ->
+                visitor.visitResponseReasoningSummaryTextDone(responseReasoningSummaryTextDone)
+            responseReasoningTextDelta != null ->
+                visitor.visitResponseReasoningTextDelta(responseReasoningTextDelta)
+            responseReasoningTextDone != null ->
+                visitor.visitResponseReasoningTextDone(responseReasoningTextDone)
+            responseRefusalDelta != null -> visitor.visitResponseRefusalDelta(responseRefusalDelta)
+            responseRefusalDone != null -> visitor.visitResponseRefusalDone(responseRefusalDone)
+            responseOutputTextDelta != null ->
+                visitor.visitResponseOutputTextDelta(responseOutputTextDelta)
+            responseOutputTextDone != null ->
+                visitor.visitResponseOutputTextDone(responseOutputTextDone)
+            responseWebSearchCallCompleted != null ->
+                visitor.visitResponseWebSearchCallCompleted(responseWebSearchCallCompleted)
+            responseWebSearchCallInProgress != null ->
+                visitor.visitResponseWebSearchCallInProgress(responseWebSearchCallInProgress)
+            responseWebSearchCallSearching != null ->
+                visitor.visitResponseWebSearchCallSearching(responseWebSearchCallSearching)
+            responseImageGenerationCallCompleted != null ->
+                visitor.visitResponseImageGenerationCallCompleted(
+                    responseImageGenerationCallCompleted
+                )
+            responseImageGenerationCallGenerating != null ->
+                visitor.visitResponseImageGenerationCallGenerating(
+                    responseImageGenerationCallGenerating
+                )
+            responseImageGenerationCallInProgress != null ->
+                visitor.visitResponseImageGenerationCallInProgress(
+                    responseImageGenerationCallInProgress
+                )
+            responseImageGenerationCallPartialImage != null ->
+                visitor.visitResponseImageGenerationCallPartialImage(
+                    responseImageGenerationCallPartialImage
+                )
+            responseMcpCallArgumentsDelta != null ->
+                visitor.visitResponseMcpCallArgumentsDelta(responseMcpCallArgumentsDelta)
+            responseMcpCallArgumentsDone != null ->
+                visitor.visitResponseMcpCallArgumentsDone(responseMcpCallArgumentsDone)
+            responseMcpCallCompleted != null ->
+                visitor.visitResponseMcpCallCompleted(responseMcpCallCompleted)
+            responseMcpCallFailed != null ->
+                visitor.visitResponseMcpCallFailed(responseMcpCallFailed)
+            responseMcpCallInProgress != null ->
+                visitor.visitResponseMcpCallInProgress(responseMcpCallInProgress)
+            responseMcpListToolsCompleted != null ->
+                visitor.visitResponseMcpListToolsCompleted(responseMcpListToolsCompleted)
+            responseMcpListToolsFailed != null ->
+                visitor.visitResponseMcpListToolsFailed(responseMcpListToolsFailed)
+            responseMcpListToolsInProgress != null ->
+                visitor.visitResponseMcpListToolsInProgress(responseMcpListToolsInProgress)
+            responseOutputTextAnnotationAdded != null ->
+                visitor.visitResponseOutputTextAnnotationAdded(responseOutputTextAnnotationAdded)
+            responseQueued != null -> visitor.visitResponseQueued(responseQueued)
+            responseCustomToolCallInputDelta != null ->
+                visitor.visitResponseCustomToolCallInputDelta(responseCustomToolCallInputDelta)
+            responseCustomToolCallInputDone != null ->
+                visitor.visitResponseCustomToolCallInputDone(responseCustomToolCallInputDone)
+            else -> visitor.unknown(_json)
+        }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseStreamEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        accept(
+            object : Visitor<Unit> {
+                override fun visitResponseAudioDelta(
+                    responseAudioDelta: BetaResponseAudioDeltaEvent
+                ) {
+                    responseAudioDelta.validate()
+                }
+
+                override fun visitResponseAudioDone(responseAudioDone: BetaResponseAudioDoneEvent) {
+                    responseAudioDone.validate()
+                }
+
+                override fun visitResponseAudioTranscriptDelta(
+                    responseAudioTranscriptDelta: BetaResponseAudioTranscriptDeltaEvent
+                ) {
+                    responseAudioTranscriptDelta.validate()
+                }
+
+                override fun visitResponseAudioTranscriptDone(
+                    responseAudioTranscriptDone: BetaResponseAudioTranscriptDoneEvent
+                ) {
+                    responseAudioTranscriptDone.validate()
+                }
+
+                override fun visitResponseCodeInterpreterCallCodeDelta(
+                    responseCodeInterpreterCallCodeDelta:
+                        BetaResponseCodeInterpreterCallCodeDeltaEvent
+                ) {
+                    responseCodeInterpreterCallCodeDelta.validate()
+                }
+
+                override fun visitResponseCodeInterpreterCallCodeDone(
+                    responseCodeInterpreterCallCodeDone:
+                        BetaResponseCodeInterpreterCallCodeDoneEvent
+                ) {
+                    responseCodeInterpreterCallCodeDone.validate()
+                }
+
+                override fun visitResponseCodeInterpreterCallCompleted(
+                    responseCodeInterpreterCallCompleted:
+                        BetaResponseCodeInterpreterCallCompletedEvent
+                ) {
+                    responseCodeInterpreterCallCompleted.validate()
+                }
+
+                override fun visitResponseCodeInterpreterCallInProgress(
+                    responseCodeInterpreterCallInProgress:
+                        BetaResponseCodeInterpreterCallInProgressEvent
+                ) {
+                    responseCodeInterpreterCallInProgress.validate()
+                }
+
+                override fun visitResponseCodeInterpreterCallInterpreting(
+                    responseCodeInterpreterCallInterpreting:
+                        BetaResponseCodeInterpreterCallInterpretingEvent
+                ) {
+                    responseCodeInterpreterCallInterpreting.validate()
+                }
+
+                override fun visitResponseCompleted(responseCompleted: BetaResponseCompletedEvent) {
+                    responseCompleted.validate()
+                }
+
+                override fun visitResponseContentPartAdded(
+                    responseContentPartAdded: BetaResponseContentPartAddedEvent
+                ) {
+                    responseContentPartAdded.validate()
+                }
+
+                override fun visitResponseContentPartDone(
+                    responseContentPartDone: BetaResponseContentPartDoneEvent
+                ) {
+                    responseContentPartDone.validate()
+                }
+
+                override fun visitResponseCreated(responseCreated: BetaResponseCreatedEvent) {
+                    responseCreated.validate()
+                }
+
+                override fun visitError(error: BetaResponseErrorEvent) {
+                    error.validate()
+                }
+
+                override fun visitResponseFileSearchCallCompleted(
+                    responseFileSearchCallCompleted: BetaResponseFileSearchCallCompletedEvent
+                ) {
+                    responseFileSearchCallCompleted.validate()
+                }
+
+                override fun visitResponseFileSearchCallInProgress(
+                    responseFileSearchCallInProgress: BetaResponseFileSearchCallInProgressEvent
+                ) {
+                    responseFileSearchCallInProgress.validate()
+                }
+
+                override fun visitResponseFileSearchCallSearching(
+                    responseFileSearchCallSearching: BetaResponseFileSearchCallSearchingEvent
+                ) {
+                    responseFileSearchCallSearching.validate()
+                }
+
+                override fun visitResponseFunctionCallArgumentsDelta(
+                    responseFunctionCallArgumentsDelta: BetaResponseFunctionCallArgumentsDeltaEvent
+                ) {
+                    responseFunctionCallArgumentsDelta.validate()
+                }
+
+                override fun visitResponseFunctionCallArgumentsDone(
+                    responseFunctionCallArgumentsDone: BetaResponseFunctionCallArgumentsDoneEvent
+                ) {
+                    responseFunctionCallArgumentsDone.validate()
+                }
+
+                override fun visitResponseInProgress(
+                    responseInProgress: BetaResponseInProgressEvent
+                ) {
+                    responseInProgress.validate()
+                }
+
+                override fun visitResponseFailed(responseFailed: BetaResponseFailedEvent) {
+                    responseFailed.validate()
+                }
+
+                override fun visitResponseIncomplete(
+                    responseIncomplete: BetaResponseIncompleteEvent
+                ) {
+                    responseIncomplete.validate()
+                }
+
+                override fun visitResponseOutputItemAdded(
+                    responseOutputItemAdded: BetaResponseOutputItemAddedEvent
+                ) {
+                    responseOutputItemAdded.validate()
+                }
+
+                override fun visitResponseOutputItemDone(
+                    responseOutputItemDone: BetaResponseOutputItemDoneEvent
+                ) {
+                    responseOutputItemDone.validate()
+                }
+
+                override fun visitResponseReasoningSummaryPartAdded(
+                    responseReasoningSummaryPartAdded: BetaResponseReasoningSummaryPartAddedEvent
+                ) {
+                    responseReasoningSummaryPartAdded.validate()
+                }
+
+                override fun visitResponseReasoningSummaryPartDone(
+                    responseReasoningSummaryPartDone: BetaResponseReasoningSummaryPartDoneEvent
+                ) {
+                    responseReasoningSummaryPartDone.validate()
+                }
+
+                override fun visitResponseReasoningSummaryTextDelta(
+                    responseReasoningSummaryTextDelta: BetaResponseReasoningSummaryTextDeltaEvent
+                ) {
+                    responseReasoningSummaryTextDelta.validate()
+                }
+
+                override fun visitResponseReasoningSummaryTextDone(
+                    responseReasoningSummaryTextDone: BetaResponseReasoningSummaryTextDoneEvent
+                ) {
+                    responseReasoningSummaryTextDone.validate()
+                }
+
+                override fun visitResponseReasoningTextDelta(
+                    responseReasoningTextDelta: BetaResponseReasoningTextDeltaEvent
+                ) {
+                    responseReasoningTextDelta.validate()
+                }
+
+                override fun visitResponseReasoningTextDone(
+                    responseReasoningTextDone: BetaResponseReasoningTextDoneEvent
+                ) {
+                    responseReasoningTextDone.validate()
+                }
+
+                override fun visitResponseRefusalDelta(
+                    responseRefusalDelta: BetaResponseRefusalDeltaEvent
+                ) {
+                    responseRefusalDelta.validate()
+                }
+
+                override fun visitResponseRefusalDone(
+                    responseRefusalDone: BetaResponseRefusalDoneEvent
+                ) {
+                    responseRefusalDone.validate()
+                }
+
+                override fun visitResponseOutputTextDelta(
+                    responseOutputTextDelta: BetaResponseTextDeltaEvent
+                ) {
+                    responseOutputTextDelta.validate()
+                }
+
+                override fun visitResponseOutputTextDone(
+                    responseOutputTextDone: BetaResponseTextDoneEvent
+                ) {
+                    responseOutputTextDone.validate()
+                }
+
+                override fun visitResponseWebSearchCallCompleted(
+                    responseWebSearchCallCompleted: BetaResponseWebSearchCallCompletedEvent
+                ) {
+                    responseWebSearchCallCompleted.validate()
+                }
+
+                override fun visitResponseWebSearchCallInProgress(
+                    responseWebSearchCallInProgress: BetaResponseWebSearchCallInProgressEvent
+                ) {
+                    responseWebSearchCallInProgress.validate()
+                }
+
+                override fun visitResponseWebSearchCallSearching(
+                    responseWebSearchCallSearching: BetaResponseWebSearchCallSearchingEvent
+                ) {
+                    responseWebSearchCallSearching.validate()
+                }
+
+                override fun visitResponseImageGenerationCallCompleted(
+                    responseImageGenerationCallCompleted: BetaResponseImageGenCallCompletedEvent
+                ) {
+                    responseImageGenerationCallCompleted.validate()
+                }
+
+                override fun visitResponseImageGenerationCallGenerating(
+                    responseImageGenerationCallGenerating: BetaResponseImageGenCallGeneratingEvent
+                ) {
+                    responseImageGenerationCallGenerating.validate()
+                }
+
+                override fun visitResponseImageGenerationCallInProgress(
+                    responseImageGenerationCallInProgress: BetaResponseImageGenCallInProgressEvent
+                ) {
+                    responseImageGenerationCallInProgress.validate()
+                }
+
+                override fun visitResponseImageGenerationCallPartialImage(
+                    responseImageGenerationCallPartialImage:
+                        BetaResponseImageGenCallPartialImageEvent
+                ) {
+                    responseImageGenerationCallPartialImage.validate()
+                }
+
+                override fun visitResponseMcpCallArgumentsDelta(
+                    responseMcpCallArgumentsDelta: BetaResponseMcpCallArgumentsDeltaEvent
+                ) {
+                    responseMcpCallArgumentsDelta.validate()
+                }
+
+                override fun visitResponseMcpCallArgumentsDone(
+                    responseMcpCallArgumentsDone: BetaResponseMcpCallArgumentsDoneEvent
+                ) {
+                    responseMcpCallArgumentsDone.validate()
+                }
+
+                override fun visitResponseMcpCallCompleted(
+                    responseMcpCallCompleted: BetaResponseMcpCallCompletedEvent
+                ) {
+                    responseMcpCallCompleted.validate()
+                }
+
+                override fun visitResponseMcpCallFailed(
+                    responseMcpCallFailed: BetaResponseMcpCallFailedEvent
+                ) {
+                    responseMcpCallFailed.validate()
+                }
+
+                override fun visitResponseMcpCallInProgress(
+                    responseMcpCallInProgress: BetaResponseMcpCallInProgressEvent
+                ) {
+                    responseMcpCallInProgress.validate()
+                }
+
+                override fun visitResponseMcpListToolsCompleted(
+                    responseMcpListToolsCompleted: BetaResponseMcpListToolsCompletedEvent
+                ) {
+                    responseMcpListToolsCompleted.validate()
+                }
+
+                override fun visitResponseMcpListToolsFailed(
+                    responseMcpListToolsFailed: BetaResponseMcpListToolsFailedEvent
+                ) {
+                    responseMcpListToolsFailed.validate()
+                }
+
+                override fun visitResponseMcpListToolsInProgress(
+                    responseMcpListToolsInProgress: BetaResponseMcpListToolsInProgressEvent
+                ) {
+                    responseMcpListToolsInProgress.validate()
+                }
+
+                override fun visitResponseOutputTextAnnotationAdded(
+                    responseOutputTextAnnotationAdded: BetaResponseOutputTextAnnotationAddedEvent
+                ) {
+                    responseOutputTextAnnotationAdded.validate()
+                }
+
+                override fun visitResponseQueued(responseQueued: BetaResponseQueuedEvent) {
+                    responseQueued.validate()
+                }
+
+                override fun visitResponseCustomToolCallInputDelta(
+                    responseCustomToolCallInputDelta: BetaResponseCustomToolCallInputDeltaEvent
+                ) {
+                    responseCustomToolCallInputDelta.validate()
+                }
+
+                override fun visitResponseCustomToolCallInputDone(
+                    responseCustomToolCallInputDone: BetaResponseCustomToolCallInputDoneEvent
+                ) {
+                    responseCustomToolCallInputDone.validate()
+                }
+            }
+        )
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        accept(
+            object : Visitor<Int> {
+                override fun visitResponseAudioDelta(
+                    responseAudioDelta: BetaResponseAudioDeltaEvent
+                ) = responseAudioDelta.validity()
+
+                override fun visitResponseAudioDone(responseAudioDone: BetaResponseAudioDoneEvent) =
+                    responseAudioDone.validity()
+
+                override fun visitResponseAudioTranscriptDelta(
+                    responseAudioTranscriptDelta: BetaResponseAudioTranscriptDeltaEvent
+                ) = responseAudioTranscriptDelta.validity()
+
+                override fun visitResponseAudioTranscriptDone(
+                    responseAudioTranscriptDone: BetaResponseAudioTranscriptDoneEvent
+                ) = responseAudioTranscriptDone.validity()
+
+                override fun visitResponseCodeInterpreterCallCodeDelta(
+                    responseCodeInterpreterCallCodeDelta:
+                        BetaResponseCodeInterpreterCallCodeDeltaEvent
+                ) = responseCodeInterpreterCallCodeDelta.validity()
+
+                override fun visitResponseCodeInterpreterCallCodeDone(
+                    responseCodeInterpreterCallCodeDone:
+                        BetaResponseCodeInterpreterCallCodeDoneEvent
+                ) = responseCodeInterpreterCallCodeDone.validity()
+
+                override fun visitResponseCodeInterpreterCallCompleted(
+                    responseCodeInterpreterCallCompleted:
+                        BetaResponseCodeInterpreterCallCompletedEvent
+                ) = responseCodeInterpreterCallCompleted.validity()
+
+                override fun visitResponseCodeInterpreterCallInProgress(
+                    responseCodeInterpreterCallInProgress:
+                        BetaResponseCodeInterpreterCallInProgressEvent
+                ) = responseCodeInterpreterCallInProgress.validity()
+
+                override fun visitResponseCodeInterpreterCallInterpreting(
+                    responseCodeInterpreterCallInterpreting:
+                        BetaResponseCodeInterpreterCallInterpretingEvent
+                ) = responseCodeInterpreterCallInterpreting.validity()
+
+                override fun visitResponseCompleted(responseCompleted: BetaResponseCompletedEvent) =
+                    responseCompleted.validity()
+
+                override fun visitResponseContentPartAdded(
+                    responseContentPartAdded: BetaResponseContentPartAddedEvent
+                ) = responseContentPartAdded.validity()
+
+                override fun visitResponseContentPartDone(
+                    responseContentPartDone: BetaResponseContentPartDoneEvent
+                ) = responseContentPartDone.validity()
+
+                override fun visitResponseCreated(responseCreated: BetaResponseCreatedEvent) =
+                    responseCreated.validity()
+
+                override fun visitError(error: BetaResponseErrorEvent) = error.validity()
+
+                override fun visitResponseFileSearchCallCompleted(
+                    responseFileSearchCallCompleted: BetaResponseFileSearchCallCompletedEvent
+                ) = responseFileSearchCallCompleted.validity()
+
+                override fun visitResponseFileSearchCallInProgress(
+                    responseFileSearchCallInProgress: BetaResponseFileSearchCallInProgressEvent
+                ) = responseFileSearchCallInProgress.validity()
+
+                override fun visitResponseFileSearchCallSearching(
+                    responseFileSearchCallSearching: BetaResponseFileSearchCallSearchingEvent
+                ) = responseFileSearchCallSearching.validity()
+
+                override fun visitResponseFunctionCallArgumentsDelta(
+                    responseFunctionCallArgumentsDelta: BetaResponseFunctionCallArgumentsDeltaEvent
+                ) = responseFunctionCallArgumentsDelta.validity()
+
+                override fun visitResponseFunctionCallArgumentsDone(
+                    responseFunctionCallArgumentsDone: BetaResponseFunctionCallArgumentsDoneEvent
+                ) = responseFunctionCallArgumentsDone.validity()
+
+                override fun visitResponseInProgress(
+                    responseInProgress: BetaResponseInProgressEvent
+                ) = responseInProgress.validity()
+
+                override fun visitResponseFailed(responseFailed: BetaResponseFailedEvent) =
+                    responseFailed.validity()
+
+                override fun visitResponseIncomplete(
+                    responseIncomplete: BetaResponseIncompleteEvent
+                ) = responseIncomplete.validity()
+
+                override fun visitResponseOutputItemAdded(
+                    responseOutputItemAdded: BetaResponseOutputItemAddedEvent
+                ) = responseOutputItemAdded.validity()
+
+                override fun visitResponseOutputItemDone(
+                    responseOutputItemDone: BetaResponseOutputItemDoneEvent
+                ) = responseOutputItemDone.validity()
+
+                override fun visitResponseReasoningSummaryPartAdded(
+                    responseReasoningSummaryPartAdded: BetaResponseReasoningSummaryPartAddedEvent
+                ) = responseReasoningSummaryPartAdded.validity()
+
+                override fun visitResponseReasoningSummaryPartDone(
+                    responseReasoningSummaryPartDone: BetaResponseReasoningSummaryPartDoneEvent
+                ) = responseReasoningSummaryPartDone.validity()
+
+                override fun visitResponseReasoningSummaryTextDelta(
+                    responseReasoningSummaryTextDelta: BetaResponseReasoningSummaryTextDeltaEvent
+                ) = responseReasoningSummaryTextDelta.validity()
+
+                override fun visitResponseReasoningSummaryTextDone(
+                    responseReasoningSummaryTextDone: BetaResponseReasoningSummaryTextDoneEvent
+                ) = responseReasoningSummaryTextDone.validity()
+
+                override fun visitResponseReasoningTextDelta(
+                    responseReasoningTextDelta: BetaResponseReasoningTextDeltaEvent
+                ) = responseReasoningTextDelta.validity()
+
+                override fun visitResponseReasoningTextDone(
+                    responseReasoningTextDone: BetaResponseReasoningTextDoneEvent
+                ) = responseReasoningTextDone.validity()
+
+                override fun visitResponseRefusalDelta(
+                    responseRefusalDelta: BetaResponseRefusalDeltaEvent
+                ) = responseRefusalDelta.validity()
+
+                override fun visitResponseRefusalDone(
+                    responseRefusalDone: BetaResponseRefusalDoneEvent
+                ) = responseRefusalDone.validity()
+
+                override fun visitResponseOutputTextDelta(
+                    responseOutputTextDelta: BetaResponseTextDeltaEvent
+                ) = responseOutputTextDelta.validity()
+
+                override fun visitResponseOutputTextDone(
+                    responseOutputTextDone: BetaResponseTextDoneEvent
+                ) = responseOutputTextDone.validity()
+
+                override fun visitResponseWebSearchCallCompleted(
+                    responseWebSearchCallCompleted: BetaResponseWebSearchCallCompletedEvent
+                ) = responseWebSearchCallCompleted.validity()
+
+                override fun visitResponseWebSearchCallInProgress(
+                    responseWebSearchCallInProgress: BetaResponseWebSearchCallInProgressEvent
+                ) = responseWebSearchCallInProgress.validity()
+
+                override fun visitResponseWebSearchCallSearching(
+                    responseWebSearchCallSearching: BetaResponseWebSearchCallSearchingEvent
+                ) = responseWebSearchCallSearching.validity()
+
+                override fun visitResponseImageGenerationCallCompleted(
+                    responseImageGenerationCallCompleted: BetaResponseImageGenCallCompletedEvent
+                ) = responseImageGenerationCallCompleted.validity()
+
+                override fun visitResponseImageGenerationCallGenerating(
+                    responseImageGenerationCallGenerating: BetaResponseImageGenCallGeneratingEvent
+                ) = responseImageGenerationCallGenerating.validity()
+
+                override fun visitResponseImageGenerationCallInProgress(
+                    responseImageGenerationCallInProgress: BetaResponseImageGenCallInProgressEvent
+                ) = responseImageGenerationCallInProgress.validity()
+
+                override fun visitResponseImageGenerationCallPartialImage(
+                    responseImageGenerationCallPartialImage:
+                        BetaResponseImageGenCallPartialImageEvent
+                ) = responseImageGenerationCallPartialImage.validity()
+
+                override fun visitResponseMcpCallArgumentsDelta(
+                    responseMcpCallArgumentsDelta: BetaResponseMcpCallArgumentsDeltaEvent
+                ) = responseMcpCallArgumentsDelta.validity()
+
+                override fun visitResponseMcpCallArgumentsDone(
+                    responseMcpCallArgumentsDone: BetaResponseMcpCallArgumentsDoneEvent
+                ) = responseMcpCallArgumentsDone.validity()
+
+                override fun visitResponseMcpCallCompleted(
+                    responseMcpCallCompleted: BetaResponseMcpCallCompletedEvent
+                ) = responseMcpCallCompleted.validity()
+
+                override fun visitResponseMcpCallFailed(
+                    responseMcpCallFailed: BetaResponseMcpCallFailedEvent
+                ) = responseMcpCallFailed.validity()
+
+                override fun visitResponseMcpCallInProgress(
+                    responseMcpCallInProgress: BetaResponseMcpCallInProgressEvent
+                ) = responseMcpCallInProgress.validity()
+
+                override fun visitResponseMcpListToolsCompleted(
+                    responseMcpListToolsCompleted: BetaResponseMcpListToolsCompletedEvent
+                ) = responseMcpListToolsCompleted.validity()
+
+                override fun visitResponseMcpListToolsFailed(
+                    responseMcpListToolsFailed: BetaResponseMcpListToolsFailedEvent
+                ) = responseMcpListToolsFailed.validity()
+
+                override fun visitResponseMcpListToolsInProgress(
+                    responseMcpListToolsInProgress: BetaResponseMcpListToolsInProgressEvent
+                ) = responseMcpListToolsInProgress.validity()
+
+                override fun visitResponseOutputTextAnnotationAdded(
+                    responseOutputTextAnnotationAdded: BetaResponseOutputTextAnnotationAddedEvent
+                ) = responseOutputTextAnnotationAdded.validity()
+
+                override fun visitResponseQueued(responseQueued: BetaResponseQueuedEvent) =
+                    responseQueued.validity()
+
+                override fun visitResponseCustomToolCallInputDelta(
+                    responseCustomToolCallInputDelta: BetaResponseCustomToolCallInputDeltaEvent
+                ) = responseCustomToolCallInputDelta.validity()
+
+                override fun visitResponseCustomToolCallInputDone(
+                    responseCustomToolCallInputDone: BetaResponseCustomToolCallInputDoneEvent
+                ) = responseCustomToolCallInputDone.validity()
+
+                override fun unknown(json: JsonValue?) = 0
+            }
+        )
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseStreamEvent &&
+            responseAudioDelta == other.responseAudioDelta &&
+            responseAudioDone == other.responseAudioDone &&
+            responseAudioTranscriptDelta == other.responseAudioTranscriptDelta &&
+            responseAudioTranscriptDone == other.responseAudioTranscriptDone &&
+            responseCodeInterpreterCallCodeDelta == other.responseCodeInterpreterCallCodeDelta &&
+            responseCodeInterpreterCallCodeDone == other.responseCodeInterpreterCallCodeDone &&
+            responseCodeInterpreterCallCompleted == other.responseCodeInterpreterCallCompleted &&
+            responseCodeInterpreterCallInProgress == other.responseCodeInterpreterCallInProgress &&
+            responseCodeInterpreterCallInterpreting ==
+                other.responseCodeInterpreterCallInterpreting &&
+            responseCompleted == other.responseCompleted &&
+            responseContentPartAdded == other.responseContentPartAdded &&
+            responseContentPartDone == other.responseContentPartDone &&
+            responseCreated == other.responseCreated &&
+            error == other.error &&
+            responseFileSearchCallCompleted == other.responseFileSearchCallCompleted &&
+            responseFileSearchCallInProgress == other.responseFileSearchCallInProgress &&
+            responseFileSearchCallSearching == other.responseFileSearchCallSearching &&
+            responseFunctionCallArgumentsDelta == other.responseFunctionCallArgumentsDelta &&
+            responseFunctionCallArgumentsDone == other.responseFunctionCallArgumentsDone &&
+            responseInProgress == other.responseInProgress &&
+            responseFailed == other.responseFailed &&
+            responseIncomplete == other.responseIncomplete &&
+            responseOutputItemAdded == other.responseOutputItemAdded &&
+            responseOutputItemDone == other.responseOutputItemDone &&
+            responseReasoningSummaryPartAdded == other.responseReasoningSummaryPartAdded &&
+            responseReasoningSummaryPartDone == other.responseReasoningSummaryPartDone &&
+            responseReasoningSummaryTextDelta == other.responseReasoningSummaryTextDelta &&
+            responseReasoningSummaryTextDone == other.responseReasoningSummaryTextDone &&
+            responseReasoningTextDelta == other.responseReasoningTextDelta &&
+            responseReasoningTextDone == other.responseReasoningTextDone &&
+            responseRefusalDelta == other.responseRefusalDelta &&
+            responseRefusalDone == other.responseRefusalDone &&
+            responseOutputTextDelta == other.responseOutputTextDelta &&
+            responseOutputTextDone == other.responseOutputTextDone &&
+            responseWebSearchCallCompleted == other.responseWebSearchCallCompleted &&
+            responseWebSearchCallInProgress == other.responseWebSearchCallInProgress &&
+            responseWebSearchCallSearching == other.responseWebSearchCallSearching &&
+            responseImageGenerationCallCompleted == other.responseImageGenerationCallCompleted &&
+            responseImageGenerationCallGenerating == other.responseImageGenerationCallGenerating &&
+            responseImageGenerationCallInProgress == other.responseImageGenerationCallInProgress &&
+            responseImageGenerationCallPartialImage ==
+                other.responseImageGenerationCallPartialImage &&
+            responseMcpCallArgumentsDelta == other.responseMcpCallArgumentsDelta &&
+            responseMcpCallArgumentsDone == other.responseMcpCallArgumentsDone &&
+            responseMcpCallCompleted == other.responseMcpCallCompleted &&
+            responseMcpCallFailed == other.responseMcpCallFailed &&
+            responseMcpCallInProgress == other.responseMcpCallInProgress &&
+            responseMcpListToolsCompleted == other.responseMcpListToolsCompleted &&
+            responseMcpListToolsFailed == other.responseMcpListToolsFailed &&
+            responseMcpListToolsInProgress == other.responseMcpListToolsInProgress &&
+            responseOutputTextAnnotationAdded == other.responseOutputTextAnnotationAdded &&
+            responseQueued == other.responseQueued &&
+            responseCustomToolCallInputDelta == other.responseCustomToolCallInputDelta &&
+            responseCustomToolCallInputDone == other.responseCustomToolCallInputDone
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(
+            responseAudioDelta,
+            responseAudioDone,
+            responseAudioTranscriptDelta,
+            responseAudioTranscriptDone,
+            responseCodeInterpreterCallCodeDelta,
+            responseCodeInterpreterCallCodeDone,
+            responseCodeInterpreterCallCompleted,
+            responseCodeInterpreterCallInProgress,
+            responseCodeInterpreterCallInterpreting,
+            responseCompleted,
+            responseContentPartAdded,
+            responseContentPartDone,
+            responseCreated,
+            error,
+            responseFileSearchCallCompleted,
+            responseFileSearchCallInProgress,
+            responseFileSearchCallSearching,
+            responseFunctionCallArgumentsDelta,
+            responseFunctionCallArgumentsDone,
+            responseInProgress,
+            responseFailed,
+            responseIncomplete,
+            responseOutputItemAdded,
+            responseOutputItemDone,
+            responseReasoningSummaryPartAdded,
+            responseReasoningSummaryPartDone,
+            responseReasoningSummaryTextDelta,
+            responseReasoningSummaryTextDone,
+            responseReasoningTextDelta,
+            responseReasoningTextDone,
+            responseRefusalDelta,
+            responseRefusalDone,
+            responseOutputTextDelta,
+            responseOutputTextDone,
+            responseWebSearchCallCompleted,
+            responseWebSearchCallInProgress,
+            responseWebSearchCallSearching,
+            responseImageGenerationCallCompleted,
+            responseImageGenerationCallGenerating,
+            responseImageGenerationCallInProgress,
+            responseImageGenerationCallPartialImage,
+            responseMcpCallArgumentsDelta,
+            responseMcpCallArgumentsDone,
+            responseMcpCallCompleted,
+            responseMcpCallFailed,
+            responseMcpCallInProgress,
+            responseMcpListToolsCompleted,
+            responseMcpListToolsFailed,
+            responseMcpListToolsInProgress,
+            responseOutputTextAnnotationAdded,
+            responseQueued,
+            responseCustomToolCallInputDelta,
+            responseCustomToolCallInputDone,
+        )
+
+    override fun toString(): String =
+        when {
+            responseAudioDelta != null ->
+                "BetaResponseStreamEvent{responseAudioDelta=$responseAudioDelta}"
+            responseAudioDone != null ->
+                "BetaResponseStreamEvent{responseAudioDone=$responseAudioDone}"
+            responseAudioTranscriptDelta != null ->
+                "BetaResponseStreamEvent{responseAudioTranscriptDelta=$responseAudioTranscriptDelta}"
+            responseAudioTranscriptDone != null ->
+                "BetaResponseStreamEvent{responseAudioTranscriptDone=$responseAudioTranscriptDone}"
+            responseCodeInterpreterCallCodeDelta != null ->
+                "BetaResponseStreamEvent{responseCodeInterpreterCallCodeDelta=$responseCodeInterpreterCallCodeDelta}"
+            responseCodeInterpreterCallCodeDone != null ->
+                "BetaResponseStreamEvent{responseCodeInterpreterCallCodeDone=$responseCodeInterpreterCallCodeDone}"
+            responseCodeInterpreterCallCompleted != null ->
+                "BetaResponseStreamEvent{responseCodeInterpreterCallCompleted=$responseCodeInterpreterCallCompleted}"
+            responseCodeInterpreterCallInProgress != null ->
+                "BetaResponseStreamEvent{responseCodeInterpreterCallInProgress=$responseCodeInterpreterCallInProgress}"
+            responseCodeInterpreterCallInterpreting != null ->
+                "BetaResponseStreamEvent{responseCodeInterpreterCallInterpreting=$responseCodeInterpreterCallInterpreting}"
+            responseCompleted != null ->
+                "BetaResponseStreamEvent{responseCompleted=$responseCompleted}"
+            responseContentPartAdded != null ->
+                "BetaResponseStreamEvent{responseContentPartAdded=$responseContentPartAdded}"
+            responseContentPartDone != null ->
+                "BetaResponseStreamEvent{responseContentPartDone=$responseContentPartDone}"
+            responseCreated != null -> "BetaResponseStreamEvent{responseCreated=$responseCreated}"
+            error != null -> "BetaResponseStreamEvent{error=$error}"
+            responseFileSearchCallCompleted != null ->
+                "BetaResponseStreamEvent{responseFileSearchCallCompleted=$responseFileSearchCallCompleted}"
+            responseFileSearchCallInProgress != null ->
+                "BetaResponseStreamEvent{responseFileSearchCallInProgress=$responseFileSearchCallInProgress}"
+            responseFileSearchCallSearching != null ->
+                "BetaResponseStreamEvent{responseFileSearchCallSearching=$responseFileSearchCallSearching}"
+            responseFunctionCallArgumentsDelta != null ->
+                "BetaResponseStreamEvent{responseFunctionCallArgumentsDelta=$responseFunctionCallArgumentsDelta}"
+            responseFunctionCallArgumentsDone != null ->
+                "BetaResponseStreamEvent{responseFunctionCallArgumentsDone=$responseFunctionCallArgumentsDone}"
+            responseInProgress != null ->
+                "BetaResponseStreamEvent{responseInProgress=$responseInProgress}"
+            responseFailed != null -> "BetaResponseStreamEvent{responseFailed=$responseFailed}"
+            responseIncomplete != null ->
+                "BetaResponseStreamEvent{responseIncomplete=$responseIncomplete}"
+            responseOutputItemAdded != null ->
+                "BetaResponseStreamEvent{responseOutputItemAdded=$responseOutputItemAdded}"
+            responseOutputItemDone != null ->
+                "BetaResponseStreamEvent{responseOutputItemDone=$responseOutputItemDone}"
+            responseReasoningSummaryPartAdded != null ->
+                "BetaResponseStreamEvent{responseReasoningSummaryPartAdded=$responseReasoningSummaryPartAdded}"
+            responseReasoningSummaryPartDone != null ->
+                "BetaResponseStreamEvent{responseReasoningSummaryPartDone=$responseReasoningSummaryPartDone}"
+            responseReasoningSummaryTextDelta != null ->
+                "BetaResponseStreamEvent{responseReasoningSummaryTextDelta=$responseReasoningSummaryTextDelta}"
+            responseReasoningSummaryTextDone != null ->
+                "BetaResponseStreamEvent{responseReasoningSummaryTextDone=$responseReasoningSummaryTextDone}"
+            responseReasoningTextDelta != null ->
+                "BetaResponseStreamEvent{responseReasoningTextDelta=$responseReasoningTextDelta}"
+            responseReasoningTextDone != null ->
+                "BetaResponseStreamEvent{responseReasoningTextDone=$responseReasoningTextDone}"
+            responseRefusalDelta != null ->
+                "BetaResponseStreamEvent{responseRefusalDelta=$responseRefusalDelta}"
+            responseRefusalDone != null ->
+                "BetaResponseStreamEvent{responseRefusalDone=$responseRefusalDone}"
+            responseOutputTextDelta != null ->
+                "BetaResponseStreamEvent{responseOutputTextDelta=$responseOutputTextDelta}"
+            responseOutputTextDone != null ->
+                "BetaResponseStreamEvent{responseOutputTextDone=$responseOutputTextDone}"
+            responseWebSearchCallCompleted != null ->
+                "BetaResponseStreamEvent{responseWebSearchCallCompleted=$responseWebSearchCallCompleted}"
+            responseWebSearchCallInProgress != null ->
+                "BetaResponseStreamEvent{responseWebSearchCallInProgress=$responseWebSearchCallInProgress}"
+            responseWebSearchCallSearching != null ->
+                "BetaResponseStreamEvent{responseWebSearchCallSearching=$responseWebSearchCallSearching}"
+            responseImageGenerationCallCompleted != null ->
+                "BetaResponseStreamEvent{responseImageGenerationCallCompleted=$responseImageGenerationCallCompleted}"
+            responseImageGenerationCallGenerating != null ->
+                "BetaResponseStreamEvent{responseImageGenerationCallGenerating=$responseImageGenerationCallGenerating}"
+            responseImageGenerationCallInProgress != null ->
+                "BetaResponseStreamEvent{responseImageGenerationCallInProgress=$responseImageGenerationCallInProgress}"
+            responseImageGenerationCallPartialImage != null ->
+                "BetaResponseStreamEvent{responseImageGenerationCallPartialImage=$responseImageGenerationCallPartialImage}"
+            responseMcpCallArgumentsDelta != null ->
+                "BetaResponseStreamEvent{responseMcpCallArgumentsDelta=$responseMcpCallArgumentsDelta}"
+            responseMcpCallArgumentsDone != null ->
+                "BetaResponseStreamEvent{responseMcpCallArgumentsDone=$responseMcpCallArgumentsDone}"
+            responseMcpCallCompleted != null ->
+                "BetaResponseStreamEvent{responseMcpCallCompleted=$responseMcpCallCompleted}"
+            responseMcpCallFailed != null ->
+                "BetaResponseStreamEvent{responseMcpCallFailed=$responseMcpCallFailed}"
+            responseMcpCallInProgress != null ->
+                "BetaResponseStreamEvent{responseMcpCallInProgress=$responseMcpCallInProgress}"
+            responseMcpListToolsCompleted != null ->
+                "BetaResponseStreamEvent{responseMcpListToolsCompleted=$responseMcpListToolsCompleted}"
+            responseMcpListToolsFailed != null ->
+                "BetaResponseStreamEvent{responseMcpListToolsFailed=$responseMcpListToolsFailed}"
+            responseMcpListToolsInProgress != null ->
+                "BetaResponseStreamEvent{responseMcpListToolsInProgress=$responseMcpListToolsInProgress}"
+            responseOutputTextAnnotationAdded != null ->
+                "BetaResponseStreamEvent{responseOutputTextAnnotationAdded=$responseOutputTextAnnotationAdded}"
+            responseQueued != null -> "BetaResponseStreamEvent{responseQueued=$responseQueued}"
+            responseCustomToolCallInputDelta != null ->
+                "BetaResponseStreamEvent{responseCustomToolCallInputDelta=$responseCustomToolCallInputDelta}"
+            responseCustomToolCallInputDone != null ->
+                "BetaResponseStreamEvent{responseCustomToolCallInputDone=$responseCustomToolCallInputDone}"
+            _json != null -> "BetaResponseStreamEvent{_unknown=$_json}"
+            else -> throw IllegalStateException("Invalid BetaResponseStreamEvent")
+        }
+
+    companion object {
+
+        /** Emitted when there is a partial audio response. */
+        @JvmStatic
+        fun ofResponseAudioDelta(responseAudioDelta: BetaResponseAudioDeltaEvent) =
+            BetaResponseStreamEvent(responseAudioDelta = responseAudioDelta)
+
+        /** Emitted when the audio response is complete. */
+        @JvmStatic
+        fun ofResponseAudioDone(responseAudioDone: BetaResponseAudioDoneEvent) =
+            BetaResponseStreamEvent(responseAudioDone = responseAudioDone)
+
+        /** Emitted when there is a partial transcript of audio. */
+        @JvmStatic
+        fun ofResponseAudioTranscriptDelta(
+            responseAudioTranscriptDelta: BetaResponseAudioTranscriptDeltaEvent
+        ) = BetaResponseStreamEvent(responseAudioTranscriptDelta = responseAudioTranscriptDelta)
+
+        /** Emitted when the full audio transcript is completed. */
+        @JvmStatic
+        fun ofResponseAudioTranscriptDone(
+            responseAudioTranscriptDone: BetaResponseAudioTranscriptDoneEvent
+        ) = BetaResponseStreamEvent(responseAudioTranscriptDone = responseAudioTranscriptDone)
+
+        /** Emitted when a partial code snippet is streamed by the code interpreter. */
+        @JvmStatic
+        fun ofResponseCodeInterpreterCallCodeDelta(
+            responseCodeInterpreterCallCodeDelta: BetaResponseCodeInterpreterCallCodeDeltaEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseCodeInterpreterCallCodeDelta = responseCodeInterpreterCallCodeDelta
+            )
+
+        /** Emitted when the code snippet is finalized by the code interpreter. */
+        @JvmStatic
+        fun ofResponseCodeInterpreterCallCodeDone(
+            responseCodeInterpreterCallCodeDone: BetaResponseCodeInterpreterCallCodeDoneEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseCodeInterpreterCallCodeDone = responseCodeInterpreterCallCodeDone
+            )
+
+        /** Emitted when the code interpreter call is completed. */
+        @JvmStatic
+        fun ofResponseCodeInterpreterCallCompleted(
+            responseCodeInterpreterCallCompleted: BetaResponseCodeInterpreterCallCompletedEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseCodeInterpreterCallCompleted = responseCodeInterpreterCallCompleted
+            )
+
+        /** Emitted when a code interpreter call is in progress. */
+        @JvmStatic
+        fun ofResponseCodeInterpreterCallInProgress(
+            responseCodeInterpreterCallInProgress: BetaResponseCodeInterpreterCallInProgressEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseCodeInterpreterCallInProgress = responseCodeInterpreterCallInProgress
+            )
+
+        /** Emitted when the code interpreter is actively interpreting the code snippet. */
+        @JvmStatic
+        fun ofResponseCodeInterpreterCallInterpreting(
+            responseCodeInterpreterCallInterpreting:
+                BetaResponseCodeInterpreterCallInterpretingEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseCodeInterpreterCallInterpreting = responseCodeInterpreterCallInterpreting
+            )
+
+        /** Emitted when the model response is complete. */
+        @JvmStatic
+        fun ofResponseCompleted(responseCompleted: BetaResponseCompletedEvent) =
+            BetaResponseStreamEvent(responseCompleted = responseCompleted)
+
+        /** Emitted when a new content part is added. */
+        @JvmStatic
+        fun ofResponseContentPartAdded(
+            responseContentPartAdded: BetaResponseContentPartAddedEvent
+        ) = BetaResponseStreamEvent(responseContentPartAdded = responseContentPartAdded)
+
+        /** Emitted when a content part is done. */
+        @JvmStatic
+        fun ofResponseContentPartDone(responseContentPartDone: BetaResponseContentPartDoneEvent) =
+            BetaResponseStreamEvent(responseContentPartDone = responseContentPartDone)
+
+        /** An event that is emitted when a response is created. */
+        @JvmStatic
+        fun ofResponseCreated(responseCreated: BetaResponseCreatedEvent) =
+            BetaResponseStreamEvent(responseCreated = responseCreated)
+
+        /** Emitted when an error occurs. */
+        @JvmStatic
+        fun ofError(error: BetaResponseErrorEvent) = BetaResponseStreamEvent(error = error)
+
+        /** Emitted when a file search call is completed (results found). */
+        @JvmStatic
+        fun ofResponseFileSearchCallCompleted(
+            responseFileSearchCallCompleted: BetaResponseFileSearchCallCompletedEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseFileSearchCallCompleted = responseFileSearchCallCompleted
+            )
+
+        /** Emitted when a file search call is initiated. */
+        @JvmStatic
+        fun ofResponseFileSearchCallInProgress(
+            responseFileSearchCallInProgress: BetaResponseFileSearchCallInProgressEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseFileSearchCallInProgress = responseFileSearchCallInProgress
+            )
+
+        /** Emitted when a file search is currently searching. */
+        @JvmStatic
+        fun ofResponseFileSearchCallSearching(
+            responseFileSearchCallSearching: BetaResponseFileSearchCallSearchingEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseFileSearchCallSearching = responseFileSearchCallSearching
+            )
+
+        /** Emitted when there is a partial function-call arguments delta. */
+        @JvmStatic
+        fun ofResponseFunctionCallArgumentsDelta(
+            responseFunctionCallArgumentsDelta: BetaResponseFunctionCallArgumentsDeltaEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseFunctionCallArgumentsDelta = responseFunctionCallArgumentsDelta
+            )
+
+        /** Emitted when function-call arguments are finalized. */
+        @JvmStatic
+        fun ofResponseFunctionCallArgumentsDone(
+            responseFunctionCallArgumentsDone: BetaResponseFunctionCallArgumentsDoneEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseFunctionCallArgumentsDone = responseFunctionCallArgumentsDone
+            )
+
+        /** Emitted when the response is in progress. */
+        @JvmStatic
+        fun ofResponseInProgress(responseInProgress: BetaResponseInProgressEvent) =
+            BetaResponseStreamEvent(responseInProgress = responseInProgress)
+
+        /** An event that is emitted when a response fails. */
+        @JvmStatic
+        fun ofResponseFailed(responseFailed: BetaResponseFailedEvent) =
+            BetaResponseStreamEvent(responseFailed = responseFailed)
+
+        /** An event that is emitted when a response finishes as incomplete. */
+        @JvmStatic
+        fun ofResponseIncomplete(responseIncomplete: BetaResponseIncompleteEvent) =
+            BetaResponseStreamEvent(responseIncomplete = responseIncomplete)
+
+        /** Emitted when a new output item is added. */
+        @JvmStatic
+        fun ofResponseOutputItemAdded(responseOutputItemAdded: BetaResponseOutputItemAddedEvent) =
+            BetaResponseStreamEvent(responseOutputItemAdded = responseOutputItemAdded)
+
+        /** Emitted when an output item is marked done. */
+        @JvmStatic
+        fun ofResponseOutputItemDone(responseOutputItemDone: BetaResponseOutputItemDoneEvent) =
+            BetaResponseStreamEvent(responseOutputItemDone = responseOutputItemDone)
+
+        /** Emitted when a new reasoning summary part is added. */
+        @JvmStatic
+        fun ofResponseReasoningSummaryPartAdded(
+            responseReasoningSummaryPartAdded: BetaResponseReasoningSummaryPartAddedEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseReasoningSummaryPartAdded = responseReasoningSummaryPartAdded
+            )
+
+        /** Emitted when a reasoning summary part is completed. */
+        @JvmStatic
+        fun ofResponseReasoningSummaryPartDone(
+            responseReasoningSummaryPartDone: BetaResponseReasoningSummaryPartDoneEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseReasoningSummaryPartDone = responseReasoningSummaryPartDone
+            )
+
+        /** Emitted when a delta is added to a reasoning summary text. */
+        @JvmStatic
+        fun ofResponseReasoningSummaryTextDelta(
+            responseReasoningSummaryTextDelta: BetaResponseReasoningSummaryTextDeltaEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseReasoningSummaryTextDelta = responseReasoningSummaryTextDelta
+            )
+
+        /** Emitted when a reasoning summary text is completed. */
+        @JvmStatic
+        fun ofResponseReasoningSummaryTextDone(
+            responseReasoningSummaryTextDone: BetaResponseReasoningSummaryTextDoneEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseReasoningSummaryTextDone = responseReasoningSummaryTextDone
+            )
+
+        /** Emitted when a delta is added to a reasoning text. */
+        @JvmStatic
+        fun ofResponseReasoningTextDelta(
+            responseReasoningTextDelta: BetaResponseReasoningTextDeltaEvent
+        ) = BetaResponseStreamEvent(responseReasoningTextDelta = responseReasoningTextDelta)
+
+        /** Emitted when a reasoning text is completed. */
+        @JvmStatic
+        fun ofResponseReasoningTextDone(
+            responseReasoningTextDone: BetaResponseReasoningTextDoneEvent
+        ) = BetaResponseStreamEvent(responseReasoningTextDone = responseReasoningTextDone)
+
+        /** Emitted when there is a partial refusal text. */
+        @JvmStatic
+        fun ofResponseRefusalDelta(responseRefusalDelta: BetaResponseRefusalDeltaEvent) =
+            BetaResponseStreamEvent(responseRefusalDelta = responseRefusalDelta)
+
+        /** Emitted when refusal text is finalized. */
+        @JvmStatic
+        fun ofResponseRefusalDone(responseRefusalDone: BetaResponseRefusalDoneEvent) =
+            BetaResponseStreamEvent(responseRefusalDone = responseRefusalDone)
+
+        /** Emitted when there is an additional text delta. */
+        @JvmStatic
+        fun ofResponseOutputTextDelta(responseOutputTextDelta: BetaResponseTextDeltaEvent) =
+            BetaResponseStreamEvent(responseOutputTextDelta = responseOutputTextDelta)
+
+        /** Emitted when text content is finalized. */
+        @JvmStatic
+        fun ofResponseOutputTextDone(responseOutputTextDone: BetaResponseTextDoneEvent) =
+            BetaResponseStreamEvent(responseOutputTextDone = responseOutputTextDone)
+
+        /** Emitted when a web search call is completed. */
+        @JvmStatic
+        fun ofResponseWebSearchCallCompleted(
+            responseWebSearchCallCompleted: BetaResponseWebSearchCallCompletedEvent
+        ) = BetaResponseStreamEvent(responseWebSearchCallCompleted = responseWebSearchCallCompleted)
+
+        /** Emitted when a web search call is initiated. */
+        @JvmStatic
+        fun ofResponseWebSearchCallInProgress(
+            responseWebSearchCallInProgress: BetaResponseWebSearchCallInProgressEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseWebSearchCallInProgress = responseWebSearchCallInProgress
+            )
+
+        /** Emitted when a web search call is executing. */
+        @JvmStatic
+        fun ofResponseWebSearchCallSearching(
+            responseWebSearchCallSearching: BetaResponseWebSearchCallSearchingEvent
+        ) = BetaResponseStreamEvent(responseWebSearchCallSearching = responseWebSearchCallSearching)
+
+        /**
+         * Emitted when an image generation tool call has completed and the final image is
+         * available.
+         */
+        @JvmStatic
+        fun ofResponseImageGenerationCallCompleted(
+            responseImageGenerationCallCompleted: BetaResponseImageGenCallCompletedEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseImageGenerationCallCompleted = responseImageGenerationCallCompleted
+            )
+
+        /**
+         * Emitted when an image generation tool call is actively generating an image (intermediate
+         * state).
+         */
+        @JvmStatic
+        fun ofResponseImageGenerationCallGenerating(
+            responseImageGenerationCallGenerating: BetaResponseImageGenCallGeneratingEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseImageGenerationCallGenerating = responseImageGenerationCallGenerating
+            )
+
+        /** Emitted when an image generation tool call is in progress. */
+        @JvmStatic
+        fun ofResponseImageGenerationCallInProgress(
+            responseImageGenerationCallInProgress: BetaResponseImageGenCallInProgressEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseImageGenerationCallInProgress = responseImageGenerationCallInProgress
+            )
+
+        /** Emitted when a partial image is available during image generation streaming. */
+        @JvmStatic
+        fun ofResponseImageGenerationCallPartialImage(
+            responseImageGenerationCallPartialImage: BetaResponseImageGenCallPartialImageEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseImageGenerationCallPartialImage = responseImageGenerationCallPartialImage
+            )
+
+        /** Emitted when there is a delta (partial update) to the arguments of an MCP tool call. */
+        @JvmStatic
+        fun ofResponseMcpCallArgumentsDelta(
+            responseMcpCallArgumentsDelta: BetaResponseMcpCallArgumentsDeltaEvent
+        ) = BetaResponseStreamEvent(responseMcpCallArgumentsDelta = responseMcpCallArgumentsDelta)
+
+        /** Emitted when the arguments for an MCP tool call are finalized. */
+        @JvmStatic
+        fun ofResponseMcpCallArgumentsDone(
+            responseMcpCallArgumentsDone: BetaResponseMcpCallArgumentsDoneEvent
+        ) = BetaResponseStreamEvent(responseMcpCallArgumentsDone = responseMcpCallArgumentsDone)
+
+        /** Emitted when an MCP tool call has completed successfully. */
+        @JvmStatic
+        fun ofResponseMcpCallCompleted(
+            responseMcpCallCompleted: BetaResponseMcpCallCompletedEvent
+        ) = BetaResponseStreamEvent(responseMcpCallCompleted = responseMcpCallCompleted)
+
+        /** Emitted when an MCP tool call has failed. */
+        @JvmStatic
+        fun ofResponseMcpCallFailed(responseMcpCallFailed: BetaResponseMcpCallFailedEvent) =
+            BetaResponseStreamEvent(responseMcpCallFailed = responseMcpCallFailed)
+
+        /** Emitted when an MCP tool call is in progress. */
+        @JvmStatic
+        fun ofResponseMcpCallInProgress(
+            responseMcpCallInProgress: BetaResponseMcpCallInProgressEvent
+        ) = BetaResponseStreamEvent(responseMcpCallInProgress = responseMcpCallInProgress)
+
+        /** Emitted when the list of available MCP tools has been successfully retrieved. */
+        @JvmStatic
+        fun ofResponseMcpListToolsCompleted(
+            responseMcpListToolsCompleted: BetaResponseMcpListToolsCompletedEvent
+        ) = BetaResponseStreamEvent(responseMcpListToolsCompleted = responseMcpListToolsCompleted)
+
+        /** Emitted when the attempt to list available MCP tools has failed. */
+        @JvmStatic
+        fun ofResponseMcpListToolsFailed(
+            responseMcpListToolsFailed: BetaResponseMcpListToolsFailedEvent
+        ) = BetaResponseStreamEvent(responseMcpListToolsFailed = responseMcpListToolsFailed)
+
+        /**
+         * Emitted when the system is in the process of retrieving the list of available MCP tools.
+         */
+        @JvmStatic
+        fun ofResponseMcpListToolsInProgress(
+            responseMcpListToolsInProgress: BetaResponseMcpListToolsInProgressEvent
+        ) = BetaResponseStreamEvent(responseMcpListToolsInProgress = responseMcpListToolsInProgress)
+
+        /** Emitted when an annotation is added to output text content. */
+        @JvmStatic
+        fun ofResponseOutputTextAnnotationAdded(
+            responseOutputTextAnnotationAdded: BetaResponseOutputTextAnnotationAddedEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseOutputTextAnnotationAdded = responseOutputTextAnnotationAdded
+            )
+
+        /** Emitted when a response is queued and waiting to be processed. */
+        @JvmStatic
+        fun ofResponseQueued(responseQueued: BetaResponseQueuedEvent) =
+            BetaResponseStreamEvent(responseQueued = responseQueued)
+
+        /** Event representing a delta (partial update) to the input of a custom tool call. */
+        @JvmStatic
+        fun ofResponseCustomToolCallInputDelta(
+            responseCustomToolCallInputDelta: BetaResponseCustomToolCallInputDeltaEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseCustomToolCallInputDelta = responseCustomToolCallInputDelta
+            )
+
+        /** Event indicating that input for a custom tool call is complete. */
+        @JvmStatic
+        fun ofResponseCustomToolCallInputDone(
+            responseCustomToolCallInputDone: BetaResponseCustomToolCallInputDoneEvent
+        ) =
+            BetaResponseStreamEvent(
+                responseCustomToolCallInputDone = responseCustomToolCallInputDone
+            )
+    }
+
+    /**
+     * An interface that defines how to map each variant of [BetaResponseStreamEvent] to a value of
+     * type [T].
+     */
+    interface Visitor<out T> {
+
+        /** Emitted when there is a partial audio response. */
+        fun visitResponseAudioDelta(responseAudioDelta: BetaResponseAudioDeltaEvent): T
+
+        /** Emitted when the audio response is complete. */
+        fun visitResponseAudioDone(responseAudioDone: BetaResponseAudioDoneEvent): T
+
+        /** Emitted when there is a partial transcript of audio. */
+        fun visitResponseAudioTranscriptDelta(
+            responseAudioTranscriptDelta: BetaResponseAudioTranscriptDeltaEvent
+        ): T
+
+        /** Emitted when the full audio transcript is completed. */
+        fun visitResponseAudioTranscriptDone(
+            responseAudioTranscriptDone: BetaResponseAudioTranscriptDoneEvent
+        ): T
+
+        /** Emitted when a partial code snippet is streamed by the code interpreter. */
+        fun visitResponseCodeInterpreterCallCodeDelta(
+            responseCodeInterpreterCallCodeDelta: BetaResponseCodeInterpreterCallCodeDeltaEvent
+        ): T
+
+        /** Emitted when the code snippet is finalized by the code interpreter. */
+        fun visitResponseCodeInterpreterCallCodeDone(
+            responseCodeInterpreterCallCodeDone: BetaResponseCodeInterpreterCallCodeDoneEvent
+        ): T
+
+        /** Emitted when the code interpreter call is completed. */
+        fun visitResponseCodeInterpreterCallCompleted(
+            responseCodeInterpreterCallCompleted: BetaResponseCodeInterpreterCallCompletedEvent
+        ): T
+
+        /** Emitted when a code interpreter call is in progress. */
+        fun visitResponseCodeInterpreterCallInProgress(
+            responseCodeInterpreterCallInProgress: BetaResponseCodeInterpreterCallInProgressEvent
+        ): T
+
+        /** Emitted when the code interpreter is actively interpreting the code snippet. */
+        fun visitResponseCodeInterpreterCallInterpreting(
+            responseCodeInterpreterCallInterpreting:
+                BetaResponseCodeInterpreterCallInterpretingEvent
+        ): T
+
+        /** Emitted when the model response is complete. */
+        fun visitResponseCompleted(responseCompleted: BetaResponseCompletedEvent): T
+
+        /** Emitted when a new content part is added. */
+        fun visitResponseContentPartAdded(
+            responseContentPartAdded: BetaResponseContentPartAddedEvent
+        ): T
+
+        /** Emitted when a content part is done. */
+        fun visitResponseContentPartDone(
+            responseContentPartDone: BetaResponseContentPartDoneEvent
+        ): T
+
+        /** An event that is emitted when a response is created. */
+        fun visitResponseCreated(responseCreated: BetaResponseCreatedEvent): T
+
+        /** Emitted when an error occurs. */
+        fun visitError(error: BetaResponseErrorEvent): T
+
+        /** Emitted when a file search call is completed (results found). */
+        fun visitResponseFileSearchCallCompleted(
+            responseFileSearchCallCompleted: BetaResponseFileSearchCallCompletedEvent
+        ): T
+
+        /** Emitted when a file search call is initiated. */
+        fun visitResponseFileSearchCallInProgress(
+            responseFileSearchCallInProgress: BetaResponseFileSearchCallInProgressEvent
+        ): T
+
+        /** Emitted when a file search is currently searching. */
+        fun visitResponseFileSearchCallSearching(
+            responseFileSearchCallSearching: BetaResponseFileSearchCallSearchingEvent
+        ): T
+
+        /** Emitted when there is a partial function-call arguments delta. */
+        fun visitResponseFunctionCallArgumentsDelta(
+            responseFunctionCallArgumentsDelta: BetaResponseFunctionCallArgumentsDeltaEvent
+        ): T
+
+        /** Emitted when function-call arguments are finalized. */
+        fun visitResponseFunctionCallArgumentsDone(
+            responseFunctionCallArgumentsDone: BetaResponseFunctionCallArgumentsDoneEvent
+        ): T
+
+        /** Emitted when the response is in progress. */
+        fun visitResponseInProgress(responseInProgress: BetaResponseInProgressEvent): T
+
+        /** An event that is emitted when a response fails. */
+        fun visitResponseFailed(responseFailed: BetaResponseFailedEvent): T
+
+        /** An event that is emitted when a response finishes as incomplete. */
+        fun visitResponseIncomplete(responseIncomplete: BetaResponseIncompleteEvent): T
+
+        /** Emitted when a new output item is added. */
+        fun visitResponseOutputItemAdded(
+            responseOutputItemAdded: BetaResponseOutputItemAddedEvent
+        ): T
+
+        /** Emitted when an output item is marked done. */
+        fun visitResponseOutputItemDone(responseOutputItemDone: BetaResponseOutputItemDoneEvent): T
+
+        /** Emitted when a new reasoning summary part is added. */
+        fun visitResponseReasoningSummaryPartAdded(
+            responseReasoningSummaryPartAdded: BetaResponseReasoningSummaryPartAddedEvent
+        ): T
+
+        /** Emitted when a reasoning summary part is completed. */
+        fun visitResponseReasoningSummaryPartDone(
+            responseReasoningSummaryPartDone: BetaResponseReasoningSummaryPartDoneEvent
+        ): T
+
+        /** Emitted when a delta is added to a reasoning summary text. */
+        fun visitResponseReasoningSummaryTextDelta(
+            responseReasoningSummaryTextDelta: BetaResponseReasoningSummaryTextDeltaEvent
+        ): T
+
+        /** Emitted when a reasoning summary text is completed. */
+        fun visitResponseReasoningSummaryTextDone(
+            responseReasoningSummaryTextDone: BetaResponseReasoningSummaryTextDoneEvent
+        ): T
+
+        /** Emitted when a delta is added to a reasoning text. */
+        fun visitResponseReasoningTextDelta(
+            responseReasoningTextDelta: BetaResponseReasoningTextDeltaEvent
+        ): T
+
+        /** Emitted when a reasoning text is completed. */
+        fun visitResponseReasoningTextDone(
+            responseReasoningTextDone: BetaResponseReasoningTextDoneEvent
+        ): T
+
+        /** Emitted when there is a partial refusal text. */
+        fun visitResponseRefusalDelta(responseRefusalDelta: BetaResponseRefusalDeltaEvent): T
+
+        /** Emitted when refusal text is finalized. */
+        fun visitResponseRefusalDone(responseRefusalDone: BetaResponseRefusalDoneEvent): T
+
+        /** Emitted when there is an additional text delta. */
+        fun visitResponseOutputTextDelta(responseOutputTextDelta: BetaResponseTextDeltaEvent): T
+
+        /** Emitted when text content is finalized. */
+        fun visitResponseOutputTextDone(responseOutputTextDone: BetaResponseTextDoneEvent): T
+
+        /** Emitted when a web search call is completed. */
+        fun visitResponseWebSearchCallCompleted(
+            responseWebSearchCallCompleted: BetaResponseWebSearchCallCompletedEvent
+        ): T
+
+        /** Emitted when a web search call is initiated. */
+        fun visitResponseWebSearchCallInProgress(
+            responseWebSearchCallInProgress: BetaResponseWebSearchCallInProgressEvent
+        ): T
+
+        /** Emitted when a web search call is executing. */
+        fun visitResponseWebSearchCallSearching(
+            responseWebSearchCallSearching: BetaResponseWebSearchCallSearchingEvent
+        ): T
+
+        /**
+         * Emitted when an image generation tool call has completed and the final image is
+         * available.
+         */
+        fun visitResponseImageGenerationCallCompleted(
+            responseImageGenerationCallCompleted: BetaResponseImageGenCallCompletedEvent
+        ): T
+
+        /**
+         * Emitted when an image generation tool call is actively generating an image (intermediate
+         * state).
+         */
+        fun visitResponseImageGenerationCallGenerating(
+            responseImageGenerationCallGenerating: BetaResponseImageGenCallGeneratingEvent
+        ): T
+
+        /** Emitted when an image generation tool call is in progress. */
+        fun visitResponseImageGenerationCallInProgress(
+            responseImageGenerationCallInProgress: BetaResponseImageGenCallInProgressEvent
+        ): T
+
+        /** Emitted when a partial image is available during image generation streaming. */
+        fun visitResponseImageGenerationCallPartialImage(
+            responseImageGenerationCallPartialImage: BetaResponseImageGenCallPartialImageEvent
+        ): T
+
+        /** Emitted when there is a delta (partial update) to the arguments of an MCP tool call. */
+        fun visitResponseMcpCallArgumentsDelta(
+            responseMcpCallArgumentsDelta: BetaResponseMcpCallArgumentsDeltaEvent
+        ): T
+
+        /** Emitted when the arguments for an MCP tool call are finalized. */
+        fun visitResponseMcpCallArgumentsDone(
+            responseMcpCallArgumentsDone: BetaResponseMcpCallArgumentsDoneEvent
+        ): T
+
+        /** Emitted when an MCP tool call has completed successfully. */
+        fun visitResponseMcpCallCompleted(
+            responseMcpCallCompleted: BetaResponseMcpCallCompletedEvent
+        ): T
+
+        /** Emitted when an MCP tool call has failed. */
+        fun visitResponseMcpCallFailed(responseMcpCallFailed: BetaResponseMcpCallFailedEvent): T
+
+        /** Emitted when an MCP tool call is in progress. */
+        fun visitResponseMcpCallInProgress(
+            responseMcpCallInProgress: BetaResponseMcpCallInProgressEvent
+        ): T
+
+        /** Emitted when the list of available MCP tools has been successfully retrieved. */
+        fun visitResponseMcpListToolsCompleted(
+            responseMcpListToolsCompleted: BetaResponseMcpListToolsCompletedEvent
+        ): T
+
+        /** Emitted when the attempt to list available MCP tools has failed. */
+        fun visitResponseMcpListToolsFailed(
+            responseMcpListToolsFailed: BetaResponseMcpListToolsFailedEvent
+        ): T
+
+        /**
+         * Emitted when the system is in the process of retrieving the list of available MCP tools.
+         */
+        fun visitResponseMcpListToolsInProgress(
+            responseMcpListToolsInProgress: BetaResponseMcpListToolsInProgressEvent
+        ): T
+
+        /** Emitted when an annotation is added to output text content. */
+        fun visitResponseOutputTextAnnotationAdded(
+            responseOutputTextAnnotationAdded: BetaResponseOutputTextAnnotationAddedEvent
+        ): T
+
+        /** Emitted when a response is queued and waiting to be processed. */
+        fun visitResponseQueued(responseQueued: BetaResponseQueuedEvent): T
+
+        /** Event representing a delta (partial update) to the input of a custom tool call. */
+        fun visitResponseCustomToolCallInputDelta(
+            responseCustomToolCallInputDelta: BetaResponseCustomToolCallInputDeltaEvent
+        ): T
+
+        /** Event indicating that input for a custom tool call is complete. */
+        fun visitResponseCustomToolCallInputDone(
+            responseCustomToolCallInputDone: BetaResponseCustomToolCallInputDoneEvent
+        ): T
+
+        /**
+         * Maps an unknown variant of [BetaResponseStreamEvent] to a value of type [T].
+         *
+         * An instance of [BetaResponseStreamEvent] can contain an unknown variant if it was
+         * deserialized from data that doesn't match any known variant. For example, if the SDK is
+         * on an older version than the API, then the API may respond with new variants that the SDK
+         * is unaware of.
+         *
+         * @throws OpenAIInvalidDataException in the default implementation.
+         */
+        fun unknown(json: JsonValue?): T {
+            throw OpenAIInvalidDataException("Unknown BetaResponseStreamEvent: $json")
+        }
+    }
+
+    internal class Deserializer :
+        BaseDeserializer<BetaResponseStreamEvent>(BetaResponseStreamEvent::class) {
+
+        override fun ObjectCodec.deserialize(node: JsonNode): BetaResponseStreamEvent {
+            val json = JsonValue.fromJsonNode(node)
+            val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+            when (type) {
+                "response.audio.delta" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseAudioDeltaEvent>())
+                        ?.let { BetaResponseStreamEvent(responseAudioDelta = it, _json = json) }
+                        ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.audio.done" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseAudioDoneEvent>())?.let {
+                        BetaResponseStreamEvent(responseAudioDone = it, _json = json)
+                    } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.audio.transcript.delta" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseAudioTranscriptDeltaEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(responseAudioTranscriptDelta = it, _json = json)
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.audio.transcript.done" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseAudioTranscriptDoneEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(responseAudioTranscriptDone = it, _json = json)
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.code_interpreter_call_code.delta" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCodeInterpreterCallCodeDeltaEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseCodeInterpreterCallCodeDelta = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.code_interpreter_call_code.done" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCodeInterpreterCallCodeDoneEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseCodeInterpreterCallCodeDone = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.code_interpreter_call.completed" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCodeInterpreterCallCompletedEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseCodeInterpreterCallCompleted = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.code_interpreter_call.in_progress" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCodeInterpreterCallInProgressEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseCodeInterpreterCallInProgress = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.code_interpreter_call.interpreting" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCodeInterpreterCallInterpretingEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseCodeInterpreterCallInterpreting = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.completed" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseCompletedEvent>())?.let {
+                        BetaResponseStreamEvent(responseCompleted = it, _json = json)
+                    } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.content_part.added" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseContentPartAddedEvent>())
+                        ?.let {
+                            BetaResponseStreamEvent(responseContentPartAdded = it, _json = json)
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.content_part.done" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseContentPartDoneEvent>())
+                        ?.let {
+                            BetaResponseStreamEvent(responseContentPartDone = it, _json = json)
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.created" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseCreatedEvent>())?.let {
+                        BetaResponseStreamEvent(responseCreated = it, _json = json)
+                    } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "error" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseErrorEvent>())?.let {
+                        BetaResponseStreamEvent(error = it, _json = json)
+                    } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.file_search_call.completed" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseFileSearchCallCompletedEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseFileSearchCallCompleted = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.file_search_call.in_progress" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseFileSearchCallInProgressEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseFileSearchCallInProgress = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.file_search_call.searching" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseFileSearchCallSearchingEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseFileSearchCallSearching = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.function_call_arguments.delta" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseFunctionCallArgumentsDeltaEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseFunctionCallArgumentsDelta = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.function_call_arguments.done" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseFunctionCallArgumentsDoneEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseFunctionCallArgumentsDone = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.in_progress" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseInProgressEvent>())
+                        ?.let { BetaResponseStreamEvent(responseInProgress = it, _json = json) }
+                        ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.failed" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseFailedEvent>())?.let {
+                        BetaResponseStreamEvent(responseFailed = it, _json = json)
+                    } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.incomplete" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseIncompleteEvent>())
+                        ?.let { BetaResponseStreamEvent(responseIncomplete = it, _json = json) }
+                        ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.output_item.added" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseOutputItemAddedEvent>())
+                        ?.let {
+                            BetaResponseStreamEvent(responseOutputItemAdded = it, _json = json)
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.output_item.done" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseOutputItemDoneEvent>())
+                        ?.let { BetaResponseStreamEvent(responseOutputItemDone = it, _json = json) }
+                        ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.reasoning_summary_part.added" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseReasoningSummaryPartAddedEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseReasoningSummaryPartAdded = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.reasoning_summary_part.done" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseReasoningSummaryPartDoneEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseReasoningSummaryPartDone = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.reasoning_summary_text.delta" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseReasoningSummaryTextDeltaEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseReasoningSummaryTextDelta = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.reasoning_summary_text.done" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseReasoningSummaryTextDoneEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseReasoningSummaryTextDone = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.reasoning_text.delta" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseReasoningTextDeltaEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(responseReasoningTextDelta = it, _json = json)
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.reasoning_text.done" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseReasoningTextDoneEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(responseReasoningTextDone = it, _json = json)
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.refusal.delta" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseRefusalDeltaEvent>())
+                        ?.let { BetaResponseStreamEvent(responseRefusalDelta = it, _json = json) }
+                        ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.refusal.done" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseRefusalDoneEvent>())
+                        ?.let { BetaResponseStreamEvent(responseRefusalDone = it, _json = json) }
+                        ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.output_text.delta" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseTextDeltaEvent>())?.let {
+                        BetaResponseStreamEvent(responseOutputTextDelta = it, _json = json)
+                    } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.output_text.done" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseTextDoneEvent>())?.let {
+                        BetaResponseStreamEvent(responseOutputTextDone = it, _json = json)
+                    } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.web_search_call.completed" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseWebSearchCallCompletedEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseWebSearchCallCompleted = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.web_search_call.in_progress" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseWebSearchCallInProgressEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseWebSearchCallInProgress = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.web_search_call.searching" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseWebSearchCallSearchingEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseWebSearchCallSearching = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.image_generation_call.completed" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseImageGenCallCompletedEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseImageGenerationCallCompleted = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.image_generation_call.generating" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseImageGenCallGeneratingEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseImageGenerationCallGenerating = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.image_generation_call.in_progress" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseImageGenCallInProgressEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseImageGenerationCallInProgress = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.image_generation_call.partial_image" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseImageGenCallPartialImageEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseImageGenerationCallPartialImage = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.mcp_call_arguments.delta" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseMcpCallArgumentsDeltaEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseMcpCallArgumentsDelta = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.mcp_call_arguments.done" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseMcpCallArgumentsDoneEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(responseMcpCallArgumentsDone = it, _json = json)
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.mcp_call.completed" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseMcpCallCompletedEvent>())
+                        ?.let {
+                            BetaResponseStreamEvent(responseMcpCallCompleted = it, _json = json)
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.mcp_call.failed" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseMcpCallFailedEvent>())
+                        ?.let { BetaResponseStreamEvent(responseMcpCallFailed = it, _json = json) }
+                        ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.mcp_call.in_progress" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseMcpCallInProgressEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(responseMcpCallInProgress = it, _json = json)
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.mcp_list_tools.completed" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseMcpListToolsCompletedEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseMcpListToolsCompleted = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.mcp_list_tools.failed" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseMcpListToolsFailedEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(responseMcpListToolsFailed = it, _json = json)
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.mcp_list_tools.in_progress" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseMcpListToolsInProgressEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseMcpListToolsInProgress = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.output_text.annotation.added" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseOutputTextAnnotationAddedEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseOutputTextAnnotationAdded = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.queued" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseQueuedEvent>())?.let {
+                        BetaResponseStreamEvent(responseQueued = it, _json = json)
+                    } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.custom_tool_call_input.delta" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCustomToolCallInputDeltaEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseCustomToolCallInputDelta = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+                "response.custom_tool_call_input.done" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCustomToolCallInputDoneEvent>(),
+                        )
+                        ?.let {
+                            BetaResponseStreamEvent(
+                                responseCustomToolCallInputDone = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponseStreamEvent(_json = json)
+                }
+            }
+
+            return BetaResponseStreamEvent(_json = json)
+        }
+    }
+
+    internal class Serializer :
+        BaseSerializer<BetaResponseStreamEvent>(BetaResponseStreamEvent::class) {
+
+        override fun serialize(
+            value: BetaResponseStreamEvent,
+            generator: JsonGenerator,
+            provider: SerializerProvider,
+        ) {
+            when {
+                value.responseAudioDelta != null -> generator.writeObject(value.responseAudioDelta)
+                value.responseAudioDone != null -> generator.writeObject(value.responseAudioDone)
+                value.responseAudioTranscriptDelta != null ->
+                    generator.writeObject(value.responseAudioTranscriptDelta)
+                value.responseAudioTranscriptDone != null ->
+                    generator.writeObject(value.responseAudioTranscriptDone)
+                value.responseCodeInterpreterCallCodeDelta != null ->
+                    generator.writeObject(value.responseCodeInterpreterCallCodeDelta)
+                value.responseCodeInterpreterCallCodeDone != null ->
+                    generator.writeObject(value.responseCodeInterpreterCallCodeDone)
+                value.responseCodeInterpreterCallCompleted != null ->
+                    generator.writeObject(value.responseCodeInterpreterCallCompleted)
+                value.responseCodeInterpreterCallInProgress != null ->
+                    generator.writeObject(value.responseCodeInterpreterCallInProgress)
+                value.responseCodeInterpreterCallInterpreting != null ->
+                    generator.writeObject(value.responseCodeInterpreterCallInterpreting)
+                value.responseCompleted != null -> generator.writeObject(value.responseCompleted)
+                value.responseContentPartAdded != null ->
+                    generator.writeObject(value.responseContentPartAdded)
+                value.responseContentPartDone != null ->
+                    generator.writeObject(value.responseContentPartDone)
+                value.responseCreated != null -> generator.writeObject(value.responseCreated)
+                value.error != null -> generator.writeObject(value.error)
+                value.responseFileSearchCallCompleted != null ->
+                    generator.writeObject(value.responseFileSearchCallCompleted)
+                value.responseFileSearchCallInProgress != null ->
+                    generator.writeObject(value.responseFileSearchCallInProgress)
+                value.responseFileSearchCallSearching != null ->
+                    generator.writeObject(value.responseFileSearchCallSearching)
+                value.responseFunctionCallArgumentsDelta != null ->
+                    generator.writeObject(value.responseFunctionCallArgumentsDelta)
+                value.responseFunctionCallArgumentsDone != null ->
+                    generator.writeObject(value.responseFunctionCallArgumentsDone)
+                value.responseInProgress != null -> generator.writeObject(value.responseInProgress)
+                value.responseFailed != null -> generator.writeObject(value.responseFailed)
+                value.responseIncomplete != null -> generator.writeObject(value.responseIncomplete)
+                value.responseOutputItemAdded != null ->
+                    generator.writeObject(value.responseOutputItemAdded)
+                value.responseOutputItemDone != null ->
+                    generator.writeObject(value.responseOutputItemDone)
+                value.responseReasoningSummaryPartAdded != null ->
+                    generator.writeObject(value.responseReasoningSummaryPartAdded)
+                value.responseReasoningSummaryPartDone != null ->
+                    generator.writeObject(value.responseReasoningSummaryPartDone)
+                value.responseReasoningSummaryTextDelta != null ->
+                    generator.writeObject(value.responseReasoningSummaryTextDelta)
+                value.responseReasoningSummaryTextDone != null ->
+                    generator.writeObject(value.responseReasoningSummaryTextDone)
+                value.responseReasoningTextDelta != null ->
+                    generator.writeObject(value.responseReasoningTextDelta)
+                value.responseReasoningTextDone != null ->
+                    generator.writeObject(value.responseReasoningTextDone)
+                value.responseRefusalDelta != null ->
+                    generator.writeObject(value.responseRefusalDelta)
+                value.responseRefusalDone != null ->
+                    generator.writeObject(value.responseRefusalDone)
+                value.responseOutputTextDelta != null ->
+                    generator.writeObject(value.responseOutputTextDelta)
+                value.responseOutputTextDone != null ->
+                    generator.writeObject(value.responseOutputTextDone)
+                value.responseWebSearchCallCompleted != null ->
+                    generator.writeObject(value.responseWebSearchCallCompleted)
+                value.responseWebSearchCallInProgress != null ->
+                    generator.writeObject(value.responseWebSearchCallInProgress)
+                value.responseWebSearchCallSearching != null ->
+                    generator.writeObject(value.responseWebSearchCallSearching)
+                value.responseImageGenerationCallCompleted != null ->
+                    generator.writeObject(value.responseImageGenerationCallCompleted)
+                value.responseImageGenerationCallGenerating != null ->
+                    generator.writeObject(value.responseImageGenerationCallGenerating)
+                value.responseImageGenerationCallInProgress != null ->
+                    generator.writeObject(value.responseImageGenerationCallInProgress)
+                value.responseImageGenerationCallPartialImage != null ->
+                    generator.writeObject(value.responseImageGenerationCallPartialImage)
+                value.responseMcpCallArgumentsDelta != null ->
+                    generator.writeObject(value.responseMcpCallArgumentsDelta)
+                value.responseMcpCallArgumentsDone != null ->
+                    generator.writeObject(value.responseMcpCallArgumentsDone)
+                value.responseMcpCallCompleted != null ->
+                    generator.writeObject(value.responseMcpCallCompleted)
+                value.responseMcpCallFailed != null ->
+                    generator.writeObject(value.responseMcpCallFailed)
+                value.responseMcpCallInProgress != null ->
+                    generator.writeObject(value.responseMcpCallInProgress)
+                value.responseMcpListToolsCompleted != null ->
+                    generator.writeObject(value.responseMcpListToolsCompleted)
+                value.responseMcpListToolsFailed != null ->
+                    generator.writeObject(value.responseMcpListToolsFailed)
+                value.responseMcpListToolsInProgress != null ->
+                    generator.writeObject(value.responseMcpListToolsInProgress)
+                value.responseOutputTextAnnotationAdded != null ->
+                    generator.writeObject(value.responseOutputTextAnnotationAdded)
+                value.responseQueued != null -> generator.writeObject(value.responseQueued)
+                value.responseCustomToolCallInputDelta != null ->
+                    generator.writeObject(value.responseCustomToolCallInputDelta)
+                value.responseCustomToolCallInputDone != null ->
+                    generator.writeObject(value.responseCustomToolCallInputDone)
+                value._json != null -> generator.writeObject(value._json)
+                else -> throw IllegalStateException("Invalid BetaResponseStreamEvent")
+            }
+        }
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseTextConfig.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseTextConfig.kt
new file mode 100644
index 000000000..9cab9c98e
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseTextConfig.kt
@@ -0,0 +1,409 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Configuration options for a text response from the model. Can be plain text or structured JSON
+ * data. Learn more:
+ * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+ * - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+ */
+class BetaResponseTextConfig
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val format: JsonField<BetaResponseFormatTextConfig>,
+    private val verbosity: JsonField<Verbosity>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("format")
+        @ExcludeMissing
+        format: JsonField<BetaResponseFormatTextConfig> = JsonMissing.of(),
+        @JsonProperty("verbosity")
+        @ExcludeMissing
+        verbosity: JsonField<Verbosity> = JsonMissing.of(),
+    ) : this(format, verbosity, mutableMapOf())
+
+    /**
+     * An object specifying the format that the model must output.
+     *
+     * Configuring `{ "type": "json_schema" }` enables Structured Outputs, which ensures the model
+     * will match your supplied JSON schema. Learn more in the
+     * [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+     *
+     * The default format is `{ "type": "text" }` with no additional options.
+     *
+     * **Not recommended for gpt-4o and newer models:**
+     *
+     * Setting to `{ "type": "json_object" }` enables the older JSON mode, which ensures the message
+     * the model generates is valid JSON. Using `json_schema` is preferred for models that support
+     * it.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun format(): Optional<BetaResponseFormatTextConfig> = format.getOptional("format")
+
+    /**
+     * Constrains the verbosity of the model's response. Lower values will result in more concise
+     * responses, while higher values will result in more verbose responses. Currently supported
+     * values are `low`, `medium`, and `high`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun verbosity(): Optional<Verbosity> = verbosity.getOptional("verbosity")
+
+    /**
+     * Returns the raw JSON value of [format].
+     *
+     * Unlike [format], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("format")
+    @ExcludeMissing
+    fun _format(): JsonField<BetaResponseFormatTextConfig> = format
+
+    /**
+     * Returns the raw JSON value of [verbosity].
+     *
+     * Unlike [verbosity], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("verbosity") @ExcludeMissing fun _verbosity(): JsonField<Verbosity> = verbosity
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [BetaResponseTextConfig]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseTextConfig]. */
+    class Builder internal constructor() {
+
+        private var format: JsonField<BetaResponseFormatTextConfig> = JsonMissing.of()
+        private var verbosity: JsonField<Verbosity> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseTextConfig: BetaResponseTextConfig) = apply {
+            format = betaResponseTextConfig.format
+            verbosity = betaResponseTextConfig.verbosity
+            additionalProperties = betaResponseTextConfig.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * An object specifying the format that the model must output.
+         *
+         * Configuring `{ "type": "json_schema" }` enables Structured Outputs, which ensures the
+         * model will match your supplied JSON schema. Learn more in the
+         * [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+         *
+         * The default format is `{ "type": "text" }` with no additional options.
+         *
+         * **Not recommended for gpt-4o and newer models:**
+         *
+         * Setting to `{ "type": "json_object" }` enables the older JSON mode, which ensures the
+         * message the model generates is valid JSON. Using `json_schema` is preferred for models
+         * that support it.
+         */
+        fun format(format: BetaResponseFormatTextConfig) = format(JsonField.of(format))
+
+        /**
+         * Sets [Builder.format] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.format] with a well-typed [BetaResponseFormatTextConfig]
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun format(format: JsonField<BetaResponseFormatTextConfig>) = apply { this.format = format }
+
+        /** Alias for calling [format] with `BetaResponseFormatTextConfig.ofText()`. */
+        fun formatText() = format(BetaResponseFormatTextConfig.ofText())
+
+        /**
+         * Alias for calling [format] with `BetaResponseFormatTextConfig.ofJsonSchema(jsonSchema)`.
+         */
+        fun format(jsonSchema: BetaResponseFormatTextJsonSchemaConfig) =
+            format(BetaResponseFormatTextConfig.ofJsonSchema(jsonSchema))
+
+        /** Alias for calling [format] with `BetaResponseFormatTextConfig.ofJsonObject()`. */
+        fun formatJsonObject() = format(BetaResponseFormatTextConfig.ofJsonObject())
+
+        /**
+         * Constrains the verbosity of the model's response. Lower values will result in more
+         * concise responses, while higher values will result in more verbose responses. Currently
+         * supported values are `low`, `medium`, and `high`.
+         */
+        fun verbosity(verbosity: Verbosity?) = verbosity(JsonField.ofNullable(verbosity))
+
+        /** Alias for calling [Builder.verbosity] with `verbosity.orElse(null)`. */
+        fun verbosity(verbosity: Optional<Verbosity>) = verbosity(verbosity.getOrNull())
+
+        /**
+         * Sets [Builder.verbosity] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.verbosity] with a well-typed [Verbosity] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun verbosity(verbosity: JsonField<Verbosity>) = apply { this.verbosity = verbosity }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseTextConfig].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): BetaResponseTextConfig =
+            BetaResponseTextConfig(format, verbosity, additionalProperties.toMutableMap())
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseTextConfig = apply {
+        if (validated) {
+            return@apply
+        }
+
+        format().ifPresent { it.validate() }
+        verbosity().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (format.asKnown().getOrNull()?.validity() ?: 0) +
+            (verbosity.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * Constrains the verbosity of the model's response. Lower values will result in more concise
+     * responses, while higher values will result in more verbose responses. Currently supported
+     * values are `low`, `medium`, and `high`.
+     */
+    class Verbosity @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val LOW = of("low")
+
+            @JvmField val MEDIUM = of("medium")
+
+            @JvmField val HIGH = of("high")
+
+            @JvmStatic fun of(value: String) = Verbosity(JsonField.of(value))
+        }
+
+        /** An enum containing [Verbosity]'s known values. */
+        enum class Known {
+            LOW,
+            MEDIUM,
+            HIGH,
+        }
+
+        /**
+         * An enum containing [Verbosity]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Verbosity] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            LOW,
+            MEDIUM,
+            HIGH,
+            /**
+             * An enum member indicating that [Verbosity] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                LOW -> Value.LOW
+                MEDIUM -> Value.MEDIUM
+                HIGH -> Value.HIGH
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                LOW -> Known.LOW
+                MEDIUM -> Known.MEDIUM
+                HIGH -> Known.HIGH
+                else -> throw OpenAIInvalidDataException("Unknown Verbosity: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Verbosity = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Verbosity && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseTextConfig &&
+            format == other.format &&
+            verbosity == other.verbosity &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(format, verbosity, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseTextConfig{format=$format, verbosity=$verbosity, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseTextDeltaEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseTextDeltaEvent.kt
new file mode 100644
index 000000000..7459c6c18
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseTextDeltaEvent.kt
@@ -0,0 +1,1126 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when there is an additional text delta. */
+class BetaResponseTextDeltaEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val contentIndex: JsonField<Long>,
+    private val delta: JsonField<String>,
+    private val itemId: JsonField<String>,
+    private val logprobs: JsonField<List<Logprob>>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("content_index")
+        @ExcludeMissing
+        contentIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("delta") @ExcludeMissing delta: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("logprobs")
+        @ExcludeMissing
+        logprobs: JsonField<List<Logprob>> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(
+        contentIndex,
+        delta,
+        itemId,
+        logprobs,
+        outputIndex,
+        sequenceNumber,
+        type,
+        agent,
+        mutableMapOf(),
+    )
+
+    /**
+     * The index of the content part that the text delta was added to.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun contentIndex(): Long = contentIndex.getRequired("content_index")
+
+    /**
+     * The text delta that was added.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun delta(): String = delta.getRequired("delta")
+
+    /**
+     * The ID of the output item that the text delta was added to.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The log probabilities of the tokens in the delta.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun logprobs(): List<Logprob> = logprobs.getRequired("logprobs")
+
+    /**
+     * The index of the output item that the text delta was added to.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number for this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.output_text.delta`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.output_text.delta")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [contentIndex].
+     *
+     * Unlike [contentIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("content_index")
+    @ExcludeMissing
+    fun _contentIndex(): JsonField<Long> = contentIndex
+
+    /**
+     * Returns the raw JSON value of [delta].
+     *
+     * Unlike [delta], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("delta") @ExcludeMissing fun _delta(): JsonField<String> = delta
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [logprobs].
+     *
+     * Unlike [logprobs], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("logprobs") @ExcludeMissing fun _logprobs(): JsonField<List<Logprob>> = logprobs
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseTextDeltaEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .contentIndex()
+         * .delta()
+         * .itemId()
+         * .logprobs()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseTextDeltaEvent]. */
+    class Builder internal constructor() {
+
+        private var contentIndex: JsonField<Long>? = null
+        private var delta: JsonField<String>? = null
+        private var itemId: JsonField<String>? = null
+        private var logprobs: JsonField<MutableList<Logprob>>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.output_text.delta")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseTextDeltaEvent: BetaResponseTextDeltaEvent) = apply {
+            contentIndex = betaResponseTextDeltaEvent.contentIndex
+            delta = betaResponseTextDeltaEvent.delta
+            itemId = betaResponseTextDeltaEvent.itemId
+            logprobs = betaResponseTextDeltaEvent.logprobs.map { it.toMutableList() }
+            outputIndex = betaResponseTextDeltaEvent.outputIndex
+            sequenceNumber = betaResponseTextDeltaEvent.sequenceNumber
+            type = betaResponseTextDeltaEvent.type
+            agent = betaResponseTextDeltaEvent.agent
+            additionalProperties = betaResponseTextDeltaEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The index of the content part that the text delta was added to. */
+        fun contentIndex(contentIndex: Long) = contentIndex(JsonField.of(contentIndex))
+
+        /**
+         * Sets [Builder.contentIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.contentIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun contentIndex(contentIndex: JsonField<Long>) = apply { this.contentIndex = contentIndex }
+
+        /** The text delta that was added. */
+        fun delta(delta: String) = delta(JsonField.of(delta))
+
+        /**
+         * Sets [Builder.delta] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.delta] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun delta(delta: JsonField<String>) = apply { this.delta = delta }
+
+        /** The ID of the output item that the text delta was added to. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The log probabilities of the tokens in the delta. */
+        fun logprobs(logprobs: List<Logprob>) = logprobs(JsonField.of(logprobs))
+
+        /**
+         * Sets [Builder.logprobs] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.logprobs] with a well-typed `List<Logprob>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun logprobs(logprobs: JsonField<List<Logprob>>) = apply {
+            this.logprobs = logprobs.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Logprob] to [logprobs].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addLogprob(logprob: Logprob) = apply {
+            logprobs =
+                (logprobs ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("logprobs", it).add(logprob)
+                }
+        }
+
+        /** The index of the output item that the text delta was added to. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number for this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.output_text.delta")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseTextDeltaEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .contentIndex()
+         * .delta()
+         * .itemId()
+         * .logprobs()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseTextDeltaEvent =
+            BetaResponseTextDeltaEvent(
+                checkRequired("contentIndex", contentIndex),
+                checkRequired("delta", delta),
+                checkRequired("itemId", itemId),
+                checkRequired("logprobs", logprobs).map { it.toImmutable() },
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseTextDeltaEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        contentIndex()
+        delta()
+        itemId()
+        logprobs().forEach { it.validate() }
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.output_text.delta")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (contentIndex.asKnown().isPresent) 1 else 0) +
+            (if (delta.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (logprobs.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.output_text.delta")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * A logprob is the logarithmic probability that the model assigns to producing a particular
+     * token at a given position in the sequence. Less-negative (higher) logprob values indicate
+     * greater model confidence in that token choice.
+     */
+    class Logprob
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val token: JsonField<String>,
+        private val logprob: JsonField<Double>,
+        private val topLogprobs: JsonField<List<TopLogprob>>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("token") @ExcludeMissing token: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("logprob") @ExcludeMissing logprob: JsonField<Double> = JsonMissing.of(),
+            @JsonProperty("top_logprobs")
+            @ExcludeMissing
+            topLogprobs: JsonField<List<TopLogprob>> = JsonMissing.of(),
+        ) : this(token, logprob, topLogprobs, mutableMapOf())
+
+        /**
+         * A possible text token.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun token(): String = token.getRequired("token")
+
+        /**
+         * The log probability of this token.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun logprob(): Double = logprob.getRequired("logprob")
+
+        /**
+         * The log probabilities of up to 20 of the most likely tokens.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun topLogprobs(): Optional<List<TopLogprob>> = topLogprobs.getOptional("top_logprobs")
+
+        /**
+         * Returns the raw JSON value of [token].
+         *
+         * Unlike [token], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("token") @ExcludeMissing fun _token(): JsonField<String> = token
+
+        /**
+         * Returns the raw JSON value of [logprob].
+         *
+         * Unlike [logprob], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("logprob") @ExcludeMissing fun _logprob(): JsonField<Double> = logprob
+
+        /**
+         * Returns the raw JSON value of [topLogprobs].
+         *
+         * Unlike [topLogprobs], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("top_logprobs")
+        @ExcludeMissing
+        fun _topLogprobs(): JsonField<List<TopLogprob>> = topLogprobs
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Logprob].
+             *
+             * The following fields are required:
+             * ```java
+             * .token()
+             * .logprob()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Logprob]. */
+        class Builder internal constructor() {
+
+            private var token: JsonField<String>? = null
+            private var logprob: JsonField<Double>? = null
+            private var topLogprobs: JsonField<MutableList<TopLogprob>>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(logprob: Logprob) = apply {
+                token = logprob.token
+                this.logprob = logprob.logprob
+                topLogprobs = logprob.topLogprobs.map { it.toMutableList() }
+                additionalProperties = logprob.additionalProperties.toMutableMap()
+            }
+
+            /** A possible text token. */
+            fun token(token: String) = token(JsonField.of(token))
+
+            /**
+             * Sets [Builder.token] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.token] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun token(token: JsonField<String>) = apply { this.token = token }
+
+            /** The log probability of this token. */
+            fun logprob(logprob: Double) = logprob(JsonField.of(logprob))
+
+            /**
+             * Sets [Builder.logprob] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.logprob] with a well-typed [Double] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun logprob(logprob: JsonField<Double>) = apply { this.logprob = logprob }
+
+            /** The log probabilities of up to 20 of the most likely tokens. */
+            fun topLogprobs(topLogprobs: List<TopLogprob>) = topLogprobs(JsonField.of(topLogprobs))
+
+            /**
+             * Sets [Builder.topLogprobs] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.topLogprobs] with a well-typed `List<TopLogprob>`
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            fun topLogprobs(topLogprobs: JsonField<List<TopLogprob>>) = apply {
+                this.topLogprobs = topLogprobs.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [TopLogprob] to [topLogprobs].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addTopLogprob(topLogprob: TopLogprob) = apply {
+                topLogprobs =
+                    (topLogprobs ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("topLogprobs", it).add(topLogprob)
+                    }
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Logprob].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .token()
+             * .logprob()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Logprob =
+                Logprob(
+                    checkRequired("token", token),
+                    checkRequired("logprob", logprob),
+                    (topLogprobs ?: JsonMissing.of()).map { it.toImmutable() },
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Logprob = apply {
+            if (validated) {
+                return@apply
+            }
+
+            token()
+            logprob()
+            topLogprobs().ifPresent { it.forEach { it.validate() } }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (token.asKnown().isPresent) 1 else 0) +
+                (if (logprob.asKnown().isPresent) 1 else 0) +
+                (topLogprobs.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+        class TopLogprob
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val token: JsonField<String>,
+            private val logprob: JsonField<Double>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("token") @ExcludeMissing token: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("logprob")
+                @ExcludeMissing
+                logprob: JsonField<Double> = JsonMissing.of(),
+            ) : this(token, logprob, mutableMapOf())
+
+            /**
+             * A possible text token.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun token(): Optional<String> = token.getOptional("token")
+
+            /**
+             * The log probability of this token.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun logprob(): Optional<Double> = logprob.getOptional("logprob")
+
+            /**
+             * Returns the raw JSON value of [token].
+             *
+             * Unlike [token], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("token") @ExcludeMissing fun _token(): JsonField<String> = token
+
+            /**
+             * Returns the raw JSON value of [logprob].
+             *
+             * Unlike [logprob], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("logprob") @ExcludeMissing fun _logprob(): JsonField<Double> = logprob
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /** Returns a mutable builder for constructing an instance of [TopLogprob]. */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [TopLogprob]. */
+            class Builder internal constructor() {
+
+                private var token: JsonField<String> = JsonMissing.of()
+                private var logprob: JsonField<Double> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(topLogprob: TopLogprob) = apply {
+                    token = topLogprob.token
+                    logprob = topLogprob.logprob
+                    additionalProperties = topLogprob.additionalProperties.toMutableMap()
+                }
+
+                /** A possible text token. */
+                fun token(token: String) = token(JsonField.of(token))
+
+                /**
+                 * Sets [Builder.token] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.token] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun token(token: JsonField<String>) = apply { this.token = token }
+
+                /** The log probability of this token. */
+                fun logprob(logprob: Double) = logprob(JsonField.of(logprob))
+
+                /**
+                 * Sets [Builder.logprob] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.logprob] with a well-typed [Double] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun logprob(logprob: JsonField<Double>) = apply { this.logprob = logprob }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [TopLogprob].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): TopLogprob =
+                    TopLogprob(token, logprob, additionalProperties.toMutableMap())
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): TopLogprob = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                token()
+                logprob()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (token.asKnown().isPresent) 1 else 0) +
+                    (if (logprob.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is TopLogprob &&
+                    token == other.token &&
+                    logprob == other.logprob &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(token, logprob, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "TopLogprob{token=$token, logprob=$logprob, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Logprob &&
+                token == other.token &&
+                logprob == other.logprob &&
+                topLogprobs == other.topLogprobs &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(token, logprob, topLogprobs, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Logprob{token=$token, logprob=$logprob, topLogprobs=$topLogprobs, additionalProperties=$additionalProperties}"
+    }
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseTextDeltaEvent &&
+            contentIndex == other.contentIndex &&
+            delta == other.delta &&
+            itemId == other.itemId &&
+            logprobs == other.logprobs &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            contentIndex,
+            delta,
+            itemId,
+            logprobs,
+            outputIndex,
+            sequenceNumber,
+            type,
+            agent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseTextDeltaEvent{contentIndex=$contentIndex, delta=$delta, itemId=$itemId, logprobs=$logprobs, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseTextDoneEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseTextDoneEvent.kt
new file mode 100644
index 000000000..e10ee45fd
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseTextDoneEvent.kt
@@ -0,0 +1,1126 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when text content is finalized. */
+class BetaResponseTextDoneEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val contentIndex: JsonField<Long>,
+    private val itemId: JsonField<String>,
+    private val logprobs: JsonField<List<Logprob>>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val text: JsonField<String>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("content_index")
+        @ExcludeMissing
+        contentIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("logprobs")
+        @ExcludeMissing
+        logprobs: JsonField<List<Logprob>> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(
+        contentIndex,
+        itemId,
+        logprobs,
+        outputIndex,
+        sequenceNumber,
+        text,
+        type,
+        agent,
+        mutableMapOf(),
+    )
+
+    /**
+     * The index of the content part that the text content is finalized.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun contentIndex(): Long = contentIndex.getRequired("content_index")
+
+    /**
+     * The ID of the output item that the text content is finalized.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The log probabilities of the tokens in the delta.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun logprobs(): List<Logprob> = logprobs.getRequired("logprobs")
+
+    /**
+     * The index of the output item that the text content is finalized.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number for this event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The text content that is finalized.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun text(): String = text.getRequired("text")
+
+    /**
+     * The type of the event. Always `response.output_text.done`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.output_text.done")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [contentIndex].
+     *
+     * Unlike [contentIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("content_index")
+    @ExcludeMissing
+    fun _contentIndex(): JsonField<Long> = contentIndex
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [logprobs].
+     *
+     * Unlike [logprobs], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("logprobs") @ExcludeMissing fun _logprobs(): JsonField<List<Logprob>> = logprobs
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [text].
+     *
+     * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseTextDoneEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .contentIndex()
+         * .itemId()
+         * .logprobs()
+         * .outputIndex()
+         * .sequenceNumber()
+         * .text()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseTextDoneEvent]. */
+    class Builder internal constructor() {
+
+        private var contentIndex: JsonField<Long>? = null
+        private var itemId: JsonField<String>? = null
+        private var logprobs: JsonField<MutableList<Logprob>>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var text: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("response.output_text.done")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseTextDoneEvent: BetaResponseTextDoneEvent) = apply {
+            contentIndex = betaResponseTextDoneEvent.contentIndex
+            itemId = betaResponseTextDoneEvent.itemId
+            logprobs = betaResponseTextDoneEvent.logprobs.map { it.toMutableList() }
+            outputIndex = betaResponseTextDoneEvent.outputIndex
+            sequenceNumber = betaResponseTextDoneEvent.sequenceNumber
+            text = betaResponseTextDoneEvent.text
+            type = betaResponseTextDoneEvent.type
+            agent = betaResponseTextDoneEvent.agent
+            additionalProperties = betaResponseTextDoneEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The index of the content part that the text content is finalized. */
+        fun contentIndex(contentIndex: Long) = contentIndex(JsonField.of(contentIndex))
+
+        /**
+         * Sets [Builder.contentIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.contentIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun contentIndex(contentIndex: JsonField<Long>) = apply { this.contentIndex = contentIndex }
+
+        /** The ID of the output item that the text content is finalized. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The log probabilities of the tokens in the delta. */
+        fun logprobs(logprobs: List<Logprob>) = logprobs(JsonField.of(logprobs))
+
+        /**
+         * Sets [Builder.logprobs] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.logprobs] with a well-typed `List<Logprob>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun logprobs(logprobs: JsonField<List<Logprob>>) = apply {
+            this.logprobs = logprobs.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Logprob] to [logprobs].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addLogprob(logprob: Logprob) = apply {
+            logprobs =
+                (logprobs ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("logprobs", it).add(logprob)
+                }
+        }
+
+        /** The index of the output item that the text content is finalized. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number for this event. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /** The text content that is finalized. */
+        fun text(text: String) = text(JsonField.of(text))
+
+        /**
+         * Sets [Builder.text] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.text] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun text(text: JsonField<String>) = apply { this.text = text }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.output_text.done")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseTextDoneEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .contentIndex()
+         * .itemId()
+         * .logprobs()
+         * .outputIndex()
+         * .sequenceNumber()
+         * .text()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseTextDoneEvent =
+            BetaResponseTextDoneEvent(
+                checkRequired("contentIndex", contentIndex),
+                checkRequired("itemId", itemId),
+                checkRequired("logprobs", logprobs).map { it.toImmutable() },
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                checkRequired("text", text),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseTextDoneEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        contentIndex()
+        itemId()
+        logprobs().forEach { it.validate() }
+        outputIndex()
+        sequenceNumber()
+        text()
+        _type().let {
+            if (it != JsonValue.from("response.output_text.done")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (contentIndex.asKnown().isPresent) 1 else 0) +
+            (if (itemId.asKnown().isPresent) 1 else 0) +
+            (logprobs.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            (if (text.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.output_text.done")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * A logprob is the logarithmic probability that the model assigns to producing a particular
+     * token at a given position in the sequence. Less-negative (higher) logprob values indicate
+     * greater model confidence in that token choice.
+     */
+    class Logprob
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val token: JsonField<String>,
+        private val logprob: JsonField<Double>,
+        private val topLogprobs: JsonField<List<TopLogprob>>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("token") @ExcludeMissing token: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("logprob") @ExcludeMissing logprob: JsonField<Double> = JsonMissing.of(),
+            @JsonProperty("top_logprobs")
+            @ExcludeMissing
+            topLogprobs: JsonField<List<TopLogprob>> = JsonMissing.of(),
+        ) : this(token, logprob, topLogprobs, mutableMapOf())
+
+        /**
+         * A possible text token.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun token(): String = token.getRequired("token")
+
+        /**
+         * The log probability of this token.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun logprob(): Double = logprob.getRequired("logprob")
+
+        /**
+         * The log probabilities of up to 20 of the most likely tokens.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun topLogprobs(): Optional<List<TopLogprob>> = topLogprobs.getOptional("top_logprobs")
+
+        /**
+         * Returns the raw JSON value of [token].
+         *
+         * Unlike [token], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("token") @ExcludeMissing fun _token(): JsonField<String> = token
+
+        /**
+         * Returns the raw JSON value of [logprob].
+         *
+         * Unlike [logprob], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("logprob") @ExcludeMissing fun _logprob(): JsonField<Double> = logprob
+
+        /**
+         * Returns the raw JSON value of [topLogprobs].
+         *
+         * Unlike [topLogprobs], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("top_logprobs")
+        @ExcludeMissing
+        fun _topLogprobs(): JsonField<List<TopLogprob>> = topLogprobs
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Logprob].
+             *
+             * The following fields are required:
+             * ```java
+             * .token()
+             * .logprob()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Logprob]. */
+        class Builder internal constructor() {
+
+            private var token: JsonField<String>? = null
+            private var logprob: JsonField<Double>? = null
+            private var topLogprobs: JsonField<MutableList<TopLogprob>>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(logprob: Logprob) = apply {
+                token = logprob.token
+                this.logprob = logprob.logprob
+                topLogprobs = logprob.topLogprobs.map { it.toMutableList() }
+                additionalProperties = logprob.additionalProperties.toMutableMap()
+            }
+
+            /** A possible text token. */
+            fun token(token: String) = token(JsonField.of(token))
+
+            /**
+             * Sets [Builder.token] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.token] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun token(token: JsonField<String>) = apply { this.token = token }
+
+            /** The log probability of this token. */
+            fun logprob(logprob: Double) = logprob(JsonField.of(logprob))
+
+            /**
+             * Sets [Builder.logprob] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.logprob] with a well-typed [Double] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun logprob(logprob: JsonField<Double>) = apply { this.logprob = logprob }
+
+            /** The log probabilities of up to 20 of the most likely tokens. */
+            fun topLogprobs(topLogprobs: List<TopLogprob>) = topLogprobs(JsonField.of(topLogprobs))
+
+            /**
+             * Sets [Builder.topLogprobs] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.topLogprobs] with a well-typed `List<TopLogprob>`
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            fun topLogprobs(topLogprobs: JsonField<List<TopLogprob>>) = apply {
+                this.topLogprobs = topLogprobs.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [TopLogprob] to [topLogprobs].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addTopLogprob(topLogprob: TopLogprob) = apply {
+                topLogprobs =
+                    (topLogprobs ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("topLogprobs", it).add(topLogprob)
+                    }
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Logprob].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .token()
+             * .logprob()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Logprob =
+                Logprob(
+                    checkRequired("token", token),
+                    checkRequired("logprob", logprob),
+                    (topLogprobs ?: JsonMissing.of()).map { it.toImmutable() },
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Logprob = apply {
+            if (validated) {
+                return@apply
+            }
+
+            token()
+            logprob()
+            topLogprobs().ifPresent { it.forEach { it.validate() } }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (token.asKnown().isPresent) 1 else 0) +
+                (if (logprob.asKnown().isPresent) 1 else 0) +
+                (topLogprobs.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+        class TopLogprob
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val token: JsonField<String>,
+            private val logprob: JsonField<Double>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("token") @ExcludeMissing token: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("logprob")
+                @ExcludeMissing
+                logprob: JsonField<Double> = JsonMissing.of(),
+            ) : this(token, logprob, mutableMapOf())
+
+            /**
+             * A possible text token.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun token(): Optional<String> = token.getOptional("token")
+
+            /**
+             * The log probability of this token.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun logprob(): Optional<Double> = logprob.getOptional("logprob")
+
+            /**
+             * Returns the raw JSON value of [token].
+             *
+             * Unlike [token], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("token") @ExcludeMissing fun _token(): JsonField<String> = token
+
+            /**
+             * Returns the raw JSON value of [logprob].
+             *
+             * Unlike [logprob], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("logprob") @ExcludeMissing fun _logprob(): JsonField<Double> = logprob
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /** Returns a mutable builder for constructing an instance of [TopLogprob]. */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [TopLogprob]. */
+            class Builder internal constructor() {
+
+                private var token: JsonField<String> = JsonMissing.of()
+                private var logprob: JsonField<Double> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(topLogprob: TopLogprob) = apply {
+                    token = topLogprob.token
+                    logprob = topLogprob.logprob
+                    additionalProperties = topLogprob.additionalProperties.toMutableMap()
+                }
+
+                /** A possible text token. */
+                fun token(token: String) = token(JsonField.of(token))
+
+                /**
+                 * Sets [Builder.token] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.token] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun token(token: JsonField<String>) = apply { this.token = token }
+
+                /** The log probability of this token. */
+                fun logprob(logprob: Double) = logprob(JsonField.of(logprob))
+
+                /**
+                 * Sets [Builder.logprob] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.logprob] with a well-typed [Double] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun logprob(logprob: JsonField<Double>) = apply { this.logprob = logprob }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [TopLogprob].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): TopLogprob =
+                    TopLogprob(token, logprob, additionalProperties.toMutableMap())
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): TopLogprob = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                token()
+                logprob()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (token.asKnown().isPresent) 1 else 0) +
+                    (if (logprob.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is TopLogprob &&
+                    token == other.token &&
+                    logprob == other.logprob &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(token, logprob, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "TopLogprob{token=$token, logprob=$logprob, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Logprob &&
+                token == other.token &&
+                logprob == other.logprob &&
+                topLogprobs == other.topLogprobs &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(token, logprob, topLogprobs, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Logprob{token=$token, logprob=$logprob, topLogprobs=$topLogprobs, additionalProperties=$additionalProperties}"
+    }
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseTextDoneEvent &&
+            contentIndex == other.contentIndex &&
+            itemId == other.itemId &&
+            logprobs == other.logprobs &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            text == other.text &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            contentIndex,
+            itemId,
+            logprobs,
+            outputIndex,
+            sequenceNumber,
+            text,
+            type,
+            agent,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseTextDoneEvent{contentIndex=$contentIndex, itemId=$itemId, logprobs=$logprobs, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, text=$text, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchCall.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchCall.kt
new file mode 100644
index 000000000..c436b5597
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchCall.kt
@@ -0,0 +1,887 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class BetaResponseToolSearchCall
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val arguments: JsonValue,
+    private val callId: JsonField<String>,
+    private val execution: JsonField<Execution>,
+    private val status: JsonField<Status>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val createdBy: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("arguments") @ExcludeMissing arguments: JsonValue = JsonMissing.of(),
+        @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("execution")
+        @ExcludeMissing
+        execution: JsonField<Execution> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
+    ) : this(id, arguments, callId, execution, status, type, agent, createdBy, mutableMapOf())
+
+    /**
+     * The unique ID of the tool search call item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * Arguments used for the tool search call.
+     *
+     * This arbitrary value can be deserialized into a custom type using the `convert` method:
+     * ```java
+     * MyClass myObject = betaResponseToolSearchCall.arguments().convert(MyClass.class);
+     * ```
+     */
+    @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonValue = arguments
+
+    /**
+     * The unique ID of the tool search call generated by the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun callId(): Optional<String> = callId.getOptional("call_id")
+
+    /**
+     * Whether tool search was executed by the server or by the client.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun execution(): Execution = execution.getRequired("execution")
+
+    /**
+     * The status of the tool search call item that was recorded.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun status(): Status = status.getRequired("status")
+
+    /**
+     * The type of the item. Always `tool_search_call`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("tool_search_call")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * The identifier of the actor that created the item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdBy(): Optional<String> = createdBy.getOptional("created_by")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [callId].
+     *
+     * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+    /**
+     * Returns the raw JSON value of [execution].
+     *
+     * Unlike [execution], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("execution") @ExcludeMissing fun _execution(): JsonField<Execution> = execution
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [createdBy].
+     *
+     * Unlike [createdBy], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_by") @ExcludeMissing fun _createdBy(): JsonField<String> = createdBy
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseToolSearchCall].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .arguments()
+         * .callId()
+         * .execution()
+         * .status()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseToolSearchCall]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var arguments: JsonValue? = null
+        private var callId: JsonField<String>? = null
+        private var execution: JsonField<Execution>? = null
+        private var status: JsonField<Status>? = null
+        private var type: JsonValue = JsonValue.from("tool_search_call")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var createdBy: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseToolSearchCall: BetaResponseToolSearchCall) = apply {
+            id = betaResponseToolSearchCall.id
+            arguments = betaResponseToolSearchCall.arguments
+            callId = betaResponseToolSearchCall.callId
+            execution = betaResponseToolSearchCall.execution
+            status = betaResponseToolSearchCall.status
+            type = betaResponseToolSearchCall.type
+            agent = betaResponseToolSearchCall.agent
+            createdBy = betaResponseToolSearchCall.createdBy
+            additionalProperties = betaResponseToolSearchCall.additionalProperties.toMutableMap()
+        }
+
+        /** The unique ID of the tool search call item. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** Arguments used for the tool search call. */
+        fun arguments(arguments: JsonValue) = apply { this.arguments = arguments }
+
+        /** The unique ID of the tool search call generated by the model. */
+        fun callId(callId: String?) = callId(JsonField.ofNullable(callId))
+
+        /** Alias for calling [Builder.callId] with `callId.orElse(null)`. */
+        fun callId(callId: Optional<String>) = callId(callId.getOrNull())
+
+        /**
+         * Sets [Builder.callId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.callId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+        /** Whether tool search was executed by the server or by the client. */
+        fun execution(execution: Execution) = execution(JsonField.of(execution))
+
+        /**
+         * Sets [Builder.execution] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.execution] with a well-typed [Execution] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun execution(execution: JsonField<Execution>) = apply { this.execution = execution }
+
+        /** The status of the tool search call item that was recorded. */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("tool_search_call")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /** The identifier of the actor that created the item. */
+        fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
+
+        /**
+         * Sets [Builder.createdBy] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdBy] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun createdBy(createdBy: JsonField<String>) = apply { this.createdBy = createdBy }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseToolSearchCall].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .arguments()
+         * .callId()
+         * .execution()
+         * .status()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseToolSearchCall =
+            BetaResponseToolSearchCall(
+                checkRequired("id", id),
+                checkRequired("arguments", arguments),
+                checkRequired("callId", callId),
+                checkRequired("execution", execution),
+                checkRequired("status", status),
+                type,
+                agent,
+                createdBy,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseToolSearchCall = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        callId()
+        execution().validate()
+        status().validate()
+        _type().let {
+            if (it != JsonValue.from("tool_search_call")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        createdBy()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (if (callId.asKnown().isPresent) 1 else 0) +
+            (execution.asKnown().getOrNull()?.validity() ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("tool_search_call")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (createdBy.asKnown().isPresent) 1 else 0)
+
+    /** Whether tool search was executed by the server or by the client. */
+    class Execution @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val SERVER = of("server")
+
+            @JvmField val CLIENT = of("client")
+
+            @JvmStatic fun of(value: String) = Execution(JsonField.of(value))
+        }
+
+        /** An enum containing [Execution]'s known values. */
+        enum class Known {
+            SERVER,
+            CLIENT,
+        }
+
+        /**
+         * An enum containing [Execution]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Execution] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            SERVER,
+            CLIENT,
+            /**
+             * An enum member indicating that [Execution] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                SERVER -> Value.SERVER
+                CLIENT -> Value.CLIENT
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                SERVER -> Known.SERVER
+                CLIENT -> Known.CLIENT
+                else -> throw OpenAIInvalidDataException("Unknown Execution: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Execution = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Execution && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The status of the tool search call item that was recorded. */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseToolSearchCall &&
+            id == other.id &&
+            arguments == other.arguments &&
+            callId == other.callId &&
+            execution == other.execution &&
+            status == other.status &&
+            type == other.type &&
+            agent == other.agent &&
+            createdBy == other.createdBy &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            id,
+            arguments,
+            callId,
+            execution,
+            status,
+            type,
+            agent,
+            createdBy,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseToolSearchCall{id=$id, arguments=$arguments, callId=$callId, execution=$execution, status=$status, type=$type, agent=$agent, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItem.kt
new file mode 100644
index 000000000..c7038ca8b
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItem.kt
@@ -0,0 +1,1035 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class BetaResponseToolSearchOutputItem
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val callId: JsonField<String>,
+    private val execution: JsonField<Execution>,
+    private val status: JsonField<Status>,
+    private val tools: JsonField<List<BetaTool>>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val createdBy: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("execution")
+        @ExcludeMissing
+        execution: JsonField<Execution> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        @JsonProperty("tools") @ExcludeMissing tools: JsonField<List<BetaTool>> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
+    ) : this(id, callId, execution, status, tools, type, agent, createdBy, mutableMapOf())
+
+    /**
+     * The unique ID of the tool search output item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * The unique ID of the tool search call generated by the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun callId(): Optional<String> = callId.getOptional("call_id")
+
+    /**
+     * Whether tool search was executed by the server or by the client.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun execution(): Execution = execution.getRequired("execution")
+
+    /**
+     * The status of the tool search output item that was recorded.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun status(): Status = status.getRequired("status")
+
+    /**
+     * The loaded tool definitions returned by tool search.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun tools(): List<BetaTool> = tools.getRequired("tools")
+
+    /**
+     * The type of the item. Always `tool_search_output`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("tool_search_output")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * The identifier of the actor that created the item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun createdBy(): Optional<String> = createdBy.getOptional("created_by")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [callId].
+     *
+     * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+    /**
+     * Returns the raw JSON value of [execution].
+     *
+     * Unlike [execution], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("execution") @ExcludeMissing fun _execution(): JsonField<Execution> = execution
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    /**
+     * Returns the raw JSON value of [tools].
+     *
+     * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<BetaTool>> = tools
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [createdBy].
+     *
+     * Unlike [createdBy], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_by") @ExcludeMissing fun _createdBy(): JsonField<String> = createdBy
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseToolSearchOutputItem].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .callId()
+         * .execution()
+         * .status()
+         * .tools()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseToolSearchOutputItem]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var callId: JsonField<String>? = null
+        private var execution: JsonField<Execution>? = null
+        private var status: JsonField<Status>? = null
+        private var tools: JsonField<MutableList<BetaTool>>? = null
+        private var type: JsonValue = JsonValue.from("tool_search_output")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var createdBy: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseToolSearchOutputItem: BetaResponseToolSearchOutputItem) =
+            apply {
+                id = betaResponseToolSearchOutputItem.id
+                callId = betaResponseToolSearchOutputItem.callId
+                execution = betaResponseToolSearchOutputItem.execution
+                status = betaResponseToolSearchOutputItem.status
+                tools = betaResponseToolSearchOutputItem.tools.map { it.toMutableList() }
+                type = betaResponseToolSearchOutputItem.type
+                agent = betaResponseToolSearchOutputItem.agent
+                createdBy = betaResponseToolSearchOutputItem.createdBy
+                additionalProperties =
+                    betaResponseToolSearchOutputItem.additionalProperties.toMutableMap()
+            }
+
+        /** The unique ID of the tool search output item. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The unique ID of the tool search call generated by the model. */
+        fun callId(callId: String?) = callId(JsonField.ofNullable(callId))
+
+        /** Alias for calling [Builder.callId] with `callId.orElse(null)`. */
+        fun callId(callId: Optional<String>) = callId(callId.getOrNull())
+
+        /**
+         * Sets [Builder.callId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.callId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+        /** Whether tool search was executed by the server or by the client. */
+        fun execution(execution: Execution) = execution(JsonField.of(execution))
+
+        /**
+         * Sets [Builder.execution] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.execution] with a well-typed [Execution] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun execution(execution: JsonField<Execution>) = apply { this.execution = execution }
+
+        /** The status of the tool search output item that was recorded. */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        /** The loaded tool definitions returned by tool search. */
+        fun tools(tools: List<BetaTool>) = tools(JsonField.of(tools))
+
+        /**
+         * Sets [Builder.tools] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.tools] with a well-typed `List<BetaTool>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun tools(tools: JsonField<List<BetaTool>>) = apply {
+            this.tools = tools.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [BetaTool] to [tools].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addTool(tool: BetaTool) = apply {
+            tools =
+                (tools ?: JsonField.of(mutableListOf())).also { checkKnown("tools", it).add(tool) }
+        }
+
+        /** Alias for calling [addTool] with `BetaTool.ofFunction(function)`. */
+        fun addTool(function: BetaFunctionTool) = addTool(BetaTool.ofFunction(function))
+
+        /** Alias for calling [addTool] with `BetaTool.ofFileSearch(fileSearch)`. */
+        fun addTool(fileSearch: BetaFileSearchTool) = addTool(BetaTool.ofFileSearch(fileSearch))
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaFileSearchTool.builder()
+         *     .vectorStoreIds(vectorStoreIds)
+         *     .build()
+         * ```
+         */
+        fun addFileSearchTool(vectorStoreIds: List<String>) =
+            addTool(BetaFileSearchTool.builder().vectorStoreIds(vectorStoreIds).build())
+
+        /** Alias for calling [addTool] with `BetaTool.ofComputer(computer)`. */
+        fun addTool(computer: BetaComputerTool) = addTool(BetaTool.ofComputer(computer))
+
+        /** Alias for calling [addTool] with `BetaTool.ofComputerUsePreview(computerUsePreview)`. */
+        fun addTool(computerUsePreview: BetaComputerUsePreviewTool) =
+            addTool(BetaTool.ofComputerUsePreview(computerUsePreview))
+
+        /** Alias for calling [addTool] with `BetaTool.ofWebSearch(webSearch)`. */
+        fun addTool(webSearch: BetaWebSearchTool) = addTool(BetaTool.ofWebSearch(webSearch))
+
+        /** Alias for calling [addTool] with `BetaTool.ofMcp(mcp)`. */
+        fun addTool(mcp: BetaTool.Mcp) = addTool(BetaTool.ofMcp(mcp))
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaTool.Mcp.builder()
+         *     .serverLabel(serverLabel)
+         *     .build()
+         * ```
+         */
+        fun addMcpTool(serverLabel: String) =
+            addTool(BetaTool.Mcp.builder().serverLabel(serverLabel).build())
+
+        /** Alias for calling [addTool] with `BetaTool.ofCodeInterpreter(codeInterpreter)`. */
+        fun addTool(codeInterpreter: BetaTool.CodeInterpreter) =
+            addTool(BetaTool.ofCodeInterpreter(codeInterpreter))
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaTool.CodeInterpreter.builder()
+         *     .container(container)
+         *     .build()
+         * ```
+         */
+        fun addCodeInterpreterTool(container: BetaTool.CodeInterpreter.Container) =
+            addTool(BetaTool.CodeInterpreter.builder().container(container).build())
+
+        /**
+         * Alias for calling [addCodeInterpreterTool] with
+         * `BetaTool.CodeInterpreter.Container.ofString(string)`.
+         */
+        fun addCodeInterpreterTool(string: String) =
+            addCodeInterpreterTool(BetaTool.CodeInterpreter.Container.ofString(string))
+
+        /**
+         * Alias for calling [addCodeInterpreterTool] with
+         * `BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)`.
+         */
+        fun addCodeInterpreterTool(
+            codeInterpreterToolAuto: BetaTool.CodeInterpreter.Container.CodeInterpreterToolAuto
+        ) =
+            addCodeInterpreterTool(
+                BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(
+                    codeInterpreterToolAuto
+                )
+            )
+
+        /** Alias for calling [addTool] with `BetaTool.ofProgrammaticToolCalling()`. */
+        fun addToolProgrammaticToolCalling() = addTool(BetaTool.ofProgrammaticToolCalling())
+
+        /** Alias for calling [addTool] with `BetaTool.ofImageGeneration(imageGeneration)`. */
+        fun addTool(imageGeneration: BetaTool.ImageGeneration) =
+            addTool(BetaTool.ofImageGeneration(imageGeneration))
+
+        /** Alias for calling [addTool] with `BetaTool.ofLocalShell()`. */
+        fun addToolLocalShell() = addTool(BetaTool.ofLocalShell())
+
+        /** Alias for calling [addTool] with `BetaTool.ofShell(shell)`. */
+        fun addTool(shell: BetaFunctionShellTool) = addTool(BetaTool.ofShell(shell))
+
+        /** Alias for calling [addTool] with `BetaTool.ofCustom(custom)`. */
+        fun addTool(custom: BetaCustomTool) = addTool(BetaTool.ofCustom(custom))
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaCustomTool.builder()
+         *     .name(name)
+         *     .build()
+         * ```
+         */
+        fun addCustomTool(name: String) = addTool(BetaCustomTool.builder().name(name).build())
+
+        /** Alias for calling [addTool] with `BetaTool.ofNamespace(namespace)`. */
+        fun addTool(namespace: BetaNamespaceTool) = addTool(BetaTool.ofNamespace(namespace))
+
+        /** Alias for calling [addTool] with `BetaTool.ofToolSearch(toolSearch)`. */
+        fun addTool(toolSearch: BetaToolSearchTool) = addTool(BetaTool.ofToolSearch(toolSearch))
+
+        /** Alias for calling [addTool] with `BetaTool.ofWebSearchPreview(webSearchPreview)`. */
+        fun addTool(webSearchPreview: BetaWebSearchPreviewTool) =
+            addTool(BetaTool.ofWebSearchPreview(webSearchPreview))
+
+        /** Alias for calling [addTool] with `BetaTool.ofApplyPatch(applyPatch)`. */
+        fun addTool(applyPatch: BetaApplyPatchTool) = addTool(BetaTool.ofApplyPatch(applyPatch))
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("tool_search_output")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent) = agent(JsonField.of(agent))
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /** The identifier of the actor that created the item. */
+        fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
+
+        /**
+         * Sets [Builder.createdBy] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdBy] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun createdBy(createdBy: JsonField<String>) = apply { this.createdBy = createdBy }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseToolSearchOutputItem].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .callId()
+         * .execution()
+         * .status()
+         * .tools()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseToolSearchOutputItem =
+            BetaResponseToolSearchOutputItem(
+                checkRequired("id", id),
+                checkRequired("callId", callId),
+                checkRequired("execution", execution),
+                checkRequired("status", status),
+                checkRequired("tools", tools).map { it.toImmutable() },
+                type,
+                agent,
+                createdBy,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseToolSearchOutputItem = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        callId()
+        execution().validate()
+        status().validate()
+        tools().forEach { it.validate() }
+        _type().let {
+            if (it != JsonValue.from("tool_search_output")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        createdBy()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (if (callId.asKnown().isPresent) 1 else 0) +
+            (execution.asKnown().getOrNull()?.validity() ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0) +
+            (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            type.let { if (it == JsonValue.from("tool_search_output")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (createdBy.asKnown().isPresent) 1 else 0)
+
+    /** Whether tool search was executed by the server or by the client. */
+    class Execution @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val SERVER = of("server")
+
+            @JvmField val CLIENT = of("client")
+
+            @JvmStatic fun of(value: String) = Execution(JsonField.of(value))
+        }
+
+        /** An enum containing [Execution]'s known values. */
+        enum class Known {
+            SERVER,
+            CLIENT,
+        }
+
+        /**
+         * An enum containing [Execution]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Execution] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            SERVER,
+            CLIENT,
+            /**
+             * An enum member indicating that [Execution] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                SERVER -> Value.SERVER
+                CLIENT -> Value.CLIENT
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                SERVER -> Known.SERVER
+                CLIENT -> Known.CLIENT
+                else -> throw OpenAIInvalidDataException("Unknown Execution: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Execution = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Execution && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The status of the tool search output item that was recorded. */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseToolSearchOutputItem &&
+            id == other.id &&
+            callId == other.callId &&
+            execution == other.execution &&
+            status == other.status &&
+            tools == other.tools &&
+            type == other.type &&
+            agent == other.agent &&
+            createdBy == other.createdBy &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            id,
+            callId,
+            execution,
+            status,
+            tools,
+            type,
+            agent,
+            createdBy,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseToolSearchOutputItem{id=$id, callId=$callId, execution=$execution, status=$status, tools=$tools, type=$type, agent=$agent, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItemParam.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItemParam.kt
new file mode 100644
index 000000000..889eb0d78
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItemParam.kt
@@ -0,0 +1,992 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+class BetaResponseToolSearchOutputItemParam
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val tools: JsonField<List<BetaTool>>,
+    private val type: JsonValue,
+    private val id: JsonField<String>,
+    private val agent: JsonField<Agent>,
+    private val callId: JsonField<String>,
+    private val execution: JsonField<Execution>,
+    private val status: JsonField<Status>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("tools") @ExcludeMissing tools: JsonField<List<BetaTool>> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+        @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("execution")
+        @ExcludeMissing
+        execution: JsonField<Execution> = JsonMissing.of(),
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+    ) : this(tools, type, id, agent, callId, execution, status, mutableMapOf())
+
+    /**
+     * The loaded tool definitions returned by the tool search output.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun tools(): List<BetaTool> = tools.getRequired("tools")
+
+    /**
+     * The item type. Always `tool_search_output`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("tool_search_output")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The unique ID of this tool search output.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun id(): Optional<String> = id.getOptional("id")
+
+    /**
+     * The agent that produced this item.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * The unique ID of the tool search call generated by the model.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun callId(): Optional<String> = callId.getOptional("call_id")
+
+    /**
+     * Whether tool search was executed by the server or by the client.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun execution(): Optional<Execution> = execution.getOptional("execution")
+
+    /**
+     * The status of the tool search output.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun status(): Optional<Status> = status.getOptional("status")
+
+    /**
+     * Returns the raw JSON value of [tools].
+     *
+     * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<BetaTool>> = tools
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    /**
+     * Returns the raw JSON value of [callId].
+     *
+     * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+    /**
+     * Returns the raw JSON value of [execution].
+     *
+     * Unlike [execution], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("execution") @ExcludeMissing fun _execution(): JsonField<Execution> = execution
+
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseToolSearchOutputItemParam].
+         *
+         * The following fields are required:
+         * ```java
+         * .tools()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseToolSearchOutputItemParam]. */
+    class Builder internal constructor() {
+
+        private var tools: JsonField<MutableList<BetaTool>>? = null
+        private var type: JsonValue = JsonValue.from("tool_search_output")
+        private var id: JsonField<String> = JsonMissing.of()
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var callId: JsonField<String> = JsonMissing.of()
+        private var execution: JsonField<Execution> = JsonMissing.of()
+        private var status: JsonField<Status> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseToolSearchOutputItemParam: BetaResponseToolSearchOutputItemParam
+        ) = apply {
+            tools = betaResponseToolSearchOutputItemParam.tools.map { it.toMutableList() }
+            type = betaResponseToolSearchOutputItemParam.type
+            id = betaResponseToolSearchOutputItemParam.id
+            agent = betaResponseToolSearchOutputItemParam.agent
+            callId = betaResponseToolSearchOutputItemParam.callId
+            execution = betaResponseToolSearchOutputItemParam.execution
+            status = betaResponseToolSearchOutputItemParam.status
+            additionalProperties =
+                betaResponseToolSearchOutputItemParam.additionalProperties.toMutableMap()
+        }
+
+        /** The loaded tool definitions returned by the tool search output. */
+        fun tools(tools: List<BetaTool>) = tools(JsonField.of(tools))
+
+        /**
+         * Sets [Builder.tools] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.tools] with a well-typed `List<BetaTool>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun tools(tools: JsonField<List<BetaTool>>) = apply {
+            this.tools = tools.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [BetaTool] to [tools].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addTool(tool: BetaTool) = apply {
+            tools =
+                (tools ?: JsonField.of(mutableListOf())).also { checkKnown("tools", it).add(tool) }
+        }
+
+        /** Alias for calling [addTool] with `BetaTool.ofFunction(function)`. */
+        fun addTool(function: BetaFunctionTool) = addTool(BetaTool.ofFunction(function))
+
+        /** Alias for calling [addTool] with `BetaTool.ofFileSearch(fileSearch)`. */
+        fun addTool(fileSearch: BetaFileSearchTool) = addTool(BetaTool.ofFileSearch(fileSearch))
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaFileSearchTool.builder()
+         *     .vectorStoreIds(vectorStoreIds)
+         *     .build()
+         * ```
+         */
+        fun addFileSearchTool(vectorStoreIds: List<String>) =
+            addTool(BetaFileSearchTool.builder().vectorStoreIds(vectorStoreIds).build())
+
+        /** Alias for calling [addTool] with `BetaTool.ofComputer(computer)`. */
+        fun addTool(computer: BetaComputerTool) = addTool(BetaTool.ofComputer(computer))
+
+        /** Alias for calling [addTool] with `BetaTool.ofComputerUsePreview(computerUsePreview)`. */
+        fun addTool(computerUsePreview: BetaComputerUsePreviewTool) =
+            addTool(BetaTool.ofComputerUsePreview(computerUsePreview))
+
+        /** Alias for calling [addTool] with `BetaTool.ofWebSearch(webSearch)`. */
+        fun addTool(webSearch: BetaWebSearchTool) = addTool(BetaTool.ofWebSearch(webSearch))
+
+        /** Alias for calling [addTool] with `BetaTool.ofMcp(mcp)`. */
+        fun addTool(mcp: BetaTool.Mcp) = addTool(BetaTool.ofMcp(mcp))
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaTool.Mcp.builder()
+         *     .serverLabel(serverLabel)
+         *     .build()
+         * ```
+         */
+        fun addMcpTool(serverLabel: String) =
+            addTool(BetaTool.Mcp.builder().serverLabel(serverLabel).build())
+
+        /** Alias for calling [addTool] with `BetaTool.ofCodeInterpreter(codeInterpreter)`. */
+        fun addTool(codeInterpreter: BetaTool.CodeInterpreter) =
+            addTool(BetaTool.ofCodeInterpreter(codeInterpreter))
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaTool.CodeInterpreter.builder()
+         *     .container(container)
+         *     .build()
+         * ```
+         */
+        fun addCodeInterpreterTool(container: BetaTool.CodeInterpreter.Container) =
+            addTool(BetaTool.CodeInterpreter.builder().container(container).build())
+
+        /**
+         * Alias for calling [addCodeInterpreterTool] with
+         * `BetaTool.CodeInterpreter.Container.ofString(string)`.
+         */
+        fun addCodeInterpreterTool(string: String) =
+            addCodeInterpreterTool(BetaTool.CodeInterpreter.Container.ofString(string))
+
+        /**
+         * Alias for calling [addCodeInterpreterTool] with
+         * `BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)`.
+         */
+        fun addCodeInterpreterTool(
+            codeInterpreterToolAuto: BetaTool.CodeInterpreter.Container.CodeInterpreterToolAuto
+        ) =
+            addCodeInterpreterTool(
+                BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(
+                    codeInterpreterToolAuto
+                )
+            )
+
+        /** Alias for calling [addTool] with `BetaTool.ofProgrammaticToolCalling()`. */
+        fun addToolProgrammaticToolCalling() = addTool(BetaTool.ofProgrammaticToolCalling())
+
+        /** Alias for calling [addTool] with `BetaTool.ofImageGeneration(imageGeneration)`. */
+        fun addTool(imageGeneration: BetaTool.ImageGeneration) =
+            addTool(BetaTool.ofImageGeneration(imageGeneration))
+
+        /** Alias for calling [addTool] with `BetaTool.ofLocalShell()`. */
+        fun addToolLocalShell() = addTool(BetaTool.ofLocalShell())
+
+        /** Alias for calling [addTool] with `BetaTool.ofShell(shell)`. */
+        fun addTool(shell: BetaFunctionShellTool) = addTool(BetaTool.ofShell(shell))
+
+        /** Alias for calling [addTool] with `BetaTool.ofCustom(custom)`. */
+        fun addTool(custom: BetaCustomTool) = addTool(BetaTool.ofCustom(custom))
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaCustomTool.builder()
+         *     .name(name)
+         *     .build()
+         * ```
+         */
+        fun addCustomTool(name: String) = addTool(BetaCustomTool.builder().name(name).build())
+
+        /** Alias for calling [addTool] with `BetaTool.ofNamespace(namespace)`. */
+        fun addTool(namespace: BetaNamespaceTool) = addTool(BetaTool.ofNamespace(namespace))
+
+        /** Alias for calling [addTool] with `BetaTool.ofToolSearch(toolSearch)`. */
+        fun addTool(toolSearch: BetaToolSearchTool) = addTool(BetaTool.ofToolSearch(toolSearch))
+
+        /** Alias for calling [addTool] with `BetaTool.ofWebSearchPreview(webSearchPreview)`. */
+        fun addTool(webSearchPreview: BetaWebSearchPreviewTool) =
+            addTool(BetaTool.ofWebSearchPreview(webSearchPreview))
+
+        /** Alias for calling [addTool] with `BetaTool.ofApplyPatch(applyPatch)`. */
+        fun addTool(applyPatch: BetaApplyPatchTool) = addTool(BetaTool.ofApplyPatch(applyPatch))
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("tool_search_output")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The unique ID of this tool search output. */
+        fun id(id: String?) = id(JsonField.ofNullable(id))
+
+        /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+        fun id(id: Optional<String>) = id(id.getOrNull())
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The agent that produced this item. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        /** The unique ID of the tool search call generated by the model. */
+        fun callId(callId: String?) = callId(JsonField.ofNullable(callId))
+
+        /** Alias for calling [Builder.callId] with `callId.orElse(null)`. */
+        fun callId(callId: Optional<String>) = callId(callId.getOrNull())
+
+        /**
+         * Sets [Builder.callId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.callId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+        /** Whether tool search was executed by the server or by the client. */
+        fun execution(execution: Execution) = execution(JsonField.of(execution))
+
+        /**
+         * Sets [Builder.execution] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.execution] with a well-typed [Execution] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun execution(execution: JsonField<Execution>) = apply { this.execution = execution }
+
+        /** The status of the tool search output. */
+        fun status(status: Status?) = status(JsonField.ofNullable(status))
+
+        /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+        fun status(status: Optional<Status>) = status(status.getOrNull())
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseToolSearchOutputItemParam].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .tools()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseToolSearchOutputItemParam =
+            BetaResponseToolSearchOutputItemParam(
+                checkRequired("tools", tools).map { it.toImmutable() },
+                type,
+                id,
+                agent,
+                callId,
+                execution,
+                status,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseToolSearchOutputItemParam = apply {
+        if (validated) {
+            return@apply
+        }
+
+        tools().forEach { it.validate() }
+        _type().let {
+            if (it != JsonValue.from("tool_search_output")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        id()
+        agent().ifPresent { it.validate() }
+        callId()
+        execution().ifPresent { it.validate() }
+        status().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            type.let { if (it == JsonValue.from("tool_search_output")) 1 else 0 } +
+            (if (id.asKnown().isPresent) 1 else 0) +
+            (agent.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (callId.asKnown().isPresent) 1 else 0) +
+            (execution.asKnown().getOrNull()?.validity() ?: 0) +
+            (status.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that produced this item. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    /** Whether tool search was executed by the server or by the client. */
+    class Execution @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val SERVER = of("server")
+
+            @JvmField val CLIENT = of("client")
+
+            @JvmStatic fun of(value: String) = Execution(JsonField.of(value))
+        }
+
+        /** An enum containing [Execution]'s known values. */
+        enum class Known {
+            SERVER,
+            CLIENT,
+        }
+
+        /**
+         * An enum containing [Execution]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Execution] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            SERVER,
+            CLIENT,
+            /**
+             * An enum member indicating that [Execution] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                SERVER -> Value.SERVER
+                CLIENT -> Value.CLIENT
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                SERVER -> Known.SERVER
+                CLIENT -> Known.CLIENT
+                else -> throw OpenAIInvalidDataException("Unknown Execution: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Execution = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Execution && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The status of the tool search output. */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_PROGRESS = of("in_progress")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_PROGRESS,
+            COMPLETED,
+            INCOMPLETE,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_PROGRESS -> Value.IN_PROGRESS
+                COMPLETED -> Value.COMPLETED
+                INCOMPLETE -> Value.INCOMPLETE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_PROGRESS -> Known.IN_PROGRESS
+                COMPLETED -> Known.COMPLETED
+                INCOMPLETE -> Known.INCOMPLETE
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseToolSearchOutputItemParam &&
+            tools == other.tools &&
+            type == other.type &&
+            id == other.id &&
+            agent == other.agent &&
+            callId == other.callId &&
+            execution == other.execution &&
+            status == other.status &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(tools, type, id, agent, callId, execution, status, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseToolSearchOutputItemParam{tools=$tools, type=$type, id=$id, agent=$agent, callId=$callId, execution=$execution, status=$status, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseUsage.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseUsage.kt
new file mode 100644
index 000000000..56dbe9c90
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseUsage.kt
@@ -0,0 +1,786 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Represents token usage details including input tokens, output tokens, a breakdown of output
+ * tokens, and the total tokens used.
+ */
+class BetaResponseUsage
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val inputTokens: JsonField<Long>,
+    private val inputTokensDetails: JsonField<InputTokensDetails>,
+    private val outputTokens: JsonField<Long>,
+    private val outputTokensDetails: JsonField<OutputTokensDetails>,
+    private val totalTokens: JsonField<Long>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("input_tokens")
+        @ExcludeMissing
+        inputTokens: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("input_tokens_details")
+        @ExcludeMissing
+        inputTokensDetails: JsonField<InputTokensDetails> = JsonMissing.of(),
+        @JsonProperty("output_tokens")
+        @ExcludeMissing
+        outputTokens: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("output_tokens_details")
+        @ExcludeMissing
+        outputTokensDetails: JsonField<OutputTokensDetails> = JsonMissing.of(),
+        @JsonProperty("total_tokens")
+        @ExcludeMissing
+        totalTokens: JsonField<Long> = JsonMissing.of(),
+    ) : this(
+        inputTokens,
+        inputTokensDetails,
+        outputTokens,
+        outputTokensDetails,
+        totalTokens,
+        mutableMapOf(),
+    )
+
+    /**
+     * The number of input tokens.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun inputTokens(): Long = inputTokens.getRequired("input_tokens")
+
+    /**
+     * A detailed breakdown of the input tokens.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun inputTokensDetails(): InputTokensDetails =
+        inputTokensDetails.getRequired("input_tokens_details")
+
+    /**
+     * The number of output tokens.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputTokens(): Long = outputTokens.getRequired("output_tokens")
+
+    /**
+     * A detailed breakdown of the output tokens.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputTokensDetails(): OutputTokensDetails =
+        outputTokensDetails.getRequired("output_tokens_details")
+
+    /**
+     * The total number of tokens used.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun totalTokens(): Long = totalTokens.getRequired("total_tokens")
+
+    /**
+     * Returns the raw JSON value of [inputTokens].
+     *
+     * Unlike [inputTokens], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("input_tokens") @ExcludeMissing fun _inputTokens(): JsonField<Long> = inputTokens
+
+    /**
+     * Returns the raw JSON value of [inputTokensDetails].
+     *
+     * Unlike [inputTokensDetails], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("input_tokens_details")
+    @ExcludeMissing
+    fun _inputTokensDetails(): JsonField<InputTokensDetails> = inputTokensDetails
+
+    /**
+     * Returns the raw JSON value of [outputTokens].
+     *
+     * Unlike [outputTokens], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_tokens")
+    @ExcludeMissing
+    fun _outputTokens(): JsonField<Long> = outputTokens
+
+    /**
+     * Returns the raw JSON value of [outputTokensDetails].
+     *
+     * Unlike [outputTokensDetails], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("output_tokens_details")
+    @ExcludeMissing
+    fun _outputTokensDetails(): JsonField<OutputTokensDetails> = outputTokensDetails
+
+    /**
+     * Returns the raw JSON value of [totalTokens].
+     *
+     * Unlike [totalTokens], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("total_tokens") @ExcludeMissing fun _totalTokens(): JsonField<Long> = totalTokens
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseUsage].
+         *
+         * The following fields are required:
+         * ```java
+         * .inputTokens()
+         * .inputTokensDetails()
+         * .outputTokens()
+         * .outputTokensDetails()
+         * .totalTokens()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseUsage]. */
+    class Builder internal constructor() {
+
+        private var inputTokens: JsonField<Long>? = null
+        private var inputTokensDetails: JsonField<InputTokensDetails>? = null
+        private var outputTokens: JsonField<Long>? = null
+        private var outputTokensDetails: JsonField<OutputTokensDetails>? = null
+        private var totalTokens: JsonField<Long>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseUsage: BetaResponseUsage) = apply {
+            inputTokens = betaResponseUsage.inputTokens
+            inputTokensDetails = betaResponseUsage.inputTokensDetails
+            outputTokens = betaResponseUsage.outputTokens
+            outputTokensDetails = betaResponseUsage.outputTokensDetails
+            totalTokens = betaResponseUsage.totalTokens
+            additionalProperties = betaResponseUsage.additionalProperties.toMutableMap()
+        }
+
+        /** The number of input tokens. */
+        fun inputTokens(inputTokens: Long) = inputTokens(JsonField.of(inputTokens))
+
+        /**
+         * Sets [Builder.inputTokens] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.inputTokens] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun inputTokens(inputTokens: JsonField<Long>) = apply { this.inputTokens = inputTokens }
+
+        /** A detailed breakdown of the input tokens. */
+        fun inputTokensDetails(inputTokensDetails: InputTokensDetails) =
+            inputTokensDetails(JsonField.of(inputTokensDetails))
+
+        /**
+         * Sets [Builder.inputTokensDetails] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.inputTokensDetails] with a well-typed
+         * [InputTokensDetails] value instead. This method is primarily for setting the field to an
+         * undocumented or not yet supported value.
+         */
+        fun inputTokensDetails(inputTokensDetails: JsonField<InputTokensDetails>) = apply {
+            this.inputTokensDetails = inputTokensDetails
+        }
+
+        /** The number of output tokens. */
+        fun outputTokens(outputTokens: Long) = outputTokens(JsonField.of(outputTokens))
+
+        /**
+         * Sets [Builder.outputTokens] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputTokens] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputTokens(outputTokens: JsonField<Long>) = apply { this.outputTokens = outputTokens }
+
+        /** A detailed breakdown of the output tokens. */
+        fun outputTokensDetails(outputTokensDetails: OutputTokensDetails) =
+            outputTokensDetails(JsonField.of(outputTokensDetails))
+
+        /**
+         * Sets [Builder.outputTokensDetails] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputTokensDetails] with a well-typed
+         * [OutputTokensDetails] value instead. This method is primarily for setting the field to an
+         * undocumented or not yet supported value.
+         */
+        fun outputTokensDetails(outputTokensDetails: JsonField<OutputTokensDetails>) = apply {
+            this.outputTokensDetails = outputTokensDetails
+        }
+
+        /** The total number of tokens used. */
+        fun totalTokens(totalTokens: Long) = totalTokens(JsonField.of(totalTokens))
+
+        /**
+         * Sets [Builder.totalTokens] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.totalTokens] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun totalTokens(totalTokens: JsonField<Long>) = apply { this.totalTokens = totalTokens }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseUsage].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .inputTokens()
+         * .inputTokensDetails()
+         * .outputTokens()
+         * .outputTokensDetails()
+         * .totalTokens()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseUsage =
+            BetaResponseUsage(
+                checkRequired("inputTokens", inputTokens),
+                checkRequired("inputTokensDetails", inputTokensDetails),
+                checkRequired("outputTokens", outputTokens),
+                checkRequired("outputTokensDetails", outputTokensDetails),
+                checkRequired("totalTokens", totalTokens),
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseUsage = apply {
+        if (validated) {
+            return@apply
+        }
+
+        inputTokens()
+        inputTokensDetails().validate()
+        outputTokens()
+        outputTokensDetails().validate()
+        totalTokens()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (inputTokens.asKnown().isPresent) 1 else 0) +
+            (inputTokensDetails.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (outputTokens.asKnown().isPresent) 1 else 0) +
+            (outputTokensDetails.asKnown().getOrNull()?.validity() ?: 0) +
+            (if (totalTokens.asKnown().isPresent) 1 else 0)
+
+    /** A detailed breakdown of the input tokens. */
+    class InputTokensDetails
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val cacheWriteTokens: JsonField<Long>,
+        private val cachedTokens: JsonField<Long>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("cache_write_tokens")
+            @ExcludeMissing
+            cacheWriteTokens: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("cached_tokens")
+            @ExcludeMissing
+            cachedTokens: JsonField<Long> = JsonMissing.of(),
+        ) : this(cacheWriteTokens, cachedTokens, mutableMapOf())
+
+        /**
+         * The number of input tokens that were written to the cache.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun cacheWriteTokens(): Long = cacheWriteTokens.getRequired("cache_write_tokens")
+
+        /**
+         * The number of tokens that were retrieved from the cache.
+         * [More on prompt caching](https://platform.openai.com/docs/guides/prompt-caching).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun cachedTokens(): Long = cachedTokens.getRequired("cached_tokens")
+
+        /**
+         * Returns the raw JSON value of [cacheWriteTokens].
+         *
+         * Unlike [cacheWriteTokens], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("cache_write_tokens")
+        @ExcludeMissing
+        fun _cacheWriteTokens(): JsonField<Long> = cacheWriteTokens
+
+        /**
+         * Returns the raw JSON value of [cachedTokens].
+         *
+         * Unlike [cachedTokens], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("cached_tokens")
+        @ExcludeMissing
+        fun _cachedTokens(): JsonField<Long> = cachedTokens
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [InputTokensDetails].
+             *
+             * The following fields are required:
+             * ```java
+             * .cacheWriteTokens()
+             * .cachedTokens()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [InputTokensDetails]. */
+        class Builder internal constructor() {
+
+            private var cacheWriteTokens: JsonField<Long>? = null
+            private var cachedTokens: JsonField<Long>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(inputTokensDetails: InputTokensDetails) = apply {
+                cacheWriteTokens = inputTokensDetails.cacheWriteTokens
+                cachedTokens = inputTokensDetails.cachedTokens
+                additionalProperties = inputTokensDetails.additionalProperties.toMutableMap()
+            }
+
+            /** The number of input tokens that were written to the cache. */
+            fun cacheWriteTokens(cacheWriteTokens: Long) =
+                cacheWriteTokens(JsonField.of(cacheWriteTokens))
+
+            /**
+             * Sets [Builder.cacheWriteTokens] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.cacheWriteTokens] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun cacheWriteTokens(cacheWriteTokens: JsonField<Long>) = apply {
+                this.cacheWriteTokens = cacheWriteTokens
+            }
+
+            /**
+             * The number of tokens that were retrieved from the cache.
+             * [More on prompt caching](https://platform.openai.com/docs/guides/prompt-caching).
+             */
+            fun cachedTokens(cachedTokens: Long) = cachedTokens(JsonField.of(cachedTokens))
+
+            /**
+             * Sets [Builder.cachedTokens] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.cachedTokens] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun cachedTokens(cachedTokens: JsonField<Long>) = apply {
+                this.cachedTokens = cachedTokens
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [InputTokensDetails].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .cacheWriteTokens()
+             * .cachedTokens()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): InputTokensDetails =
+                InputTokensDetails(
+                    checkRequired("cacheWriteTokens", cacheWriteTokens),
+                    checkRequired("cachedTokens", cachedTokens),
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): InputTokensDetails = apply {
+            if (validated) {
+                return@apply
+            }
+
+            cacheWriteTokens()
+            cachedTokens()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (cacheWriteTokens.asKnown().isPresent) 1 else 0) +
+                (if (cachedTokens.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is InputTokensDetails &&
+                cacheWriteTokens == other.cacheWriteTokens &&
+                cachedTokens == other.cachedTokens &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(cacheWriteTokens, cachedTokens, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "InputTokensDetails{cacheWriteTokens=$cacheWriteTokens, cachedTokens=$cachedTokens, additionalProperties=$additionalProperties}"
+    }
+
+    /** A detailed breakdown of the output tokens. */
+    class OutputTokensDetails
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val reasoningTokens: JsonField<Long>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("reasoning_tokens")
+            @ExcludeMissing
+            reasoningTokens: JsonField<Long> = JsonMissing.of()
+        ) : this(reasoningTokens, mutableMapOf())
+
+        /**
+         * The number of reasoning tokens.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun reasoningTokens(): Long = reasoningTokens.getRequired("reasoning_tokens")
+
+        /**
+         * Returns the raw JSON value of [reasoningTokens].
+         *
+         * Unlike [reasoningTokens], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("reasoning_tokens")
+        @ExcludeMissing
+        fun _reasoningTokens(): JsonField<Long> = reasoningTokens
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [OutputTokensDetails].
+             *
+             * The following fields are required:
+             * ```java
+             * .reasoningTokens()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [OutputTokensDetails]. */
+        class Builder internal constructor() {
+
+            private var reasoningTokens: JsonField<Long>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(outputTokensDetails: OutputTokensDetails) = apply {
+                reasoningTokens = outputTokensDetails.reasoningTokens
+                additionalProperties = outputTokensDetails.additionalProperties.toMutableMap()
+            }
+
+            /** The number of reasoning tokens. */
+            fun reasoningTokens(reasoningTokens: Long) =
+                reasoningTokens(JsonField.of(reasoningTokens))
+
+            /**
+             * Sets [Builder.reasoningTokens] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.reasoningTokens] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun reasoningTokens(reasoningTokens: JsonField<Long>) = apply {
+                this.reasoningTokens = reasoningTokens
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [OutputTokensDetails].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .reasoningTokens()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): OutputTokensDetails =
+                OutputTokensDetails(
+                    checkRequired("reasoningTokens", reasoningTokens),
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): OutputTokensDetails = apply {
+            if (validated) {
+                return@apply
+            }
+
+            reasoningTokens()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = (if (reasoningTokens.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is OutputTokensDetails &&
+                reasoningTokens == other.reasoningTokens &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(reasoningTokens, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "OutputTokensDetails{reasoningTokens=$reasoningTokens, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseUsage &&
+            inputTokens == other.inputTokens &&
+            inputTokensDetails == other.inputTokensDetails &&
+            outputTokens == other.outputTokens &&
+            outputTokensDetails == other.outputTokensDetails &&
+            totalTokens == other.totalTokens &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            inputTokens,
+            inputTokensDetails,
+            outputTokens,
+            outputTokensDetails,
+            totalTokens,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseUsage{inputTokens=$inputTokens, inputTokensDetails=$inputTokensDetails, outputTokens=$outputTokens, outputTokensDetails=$outputTokensDetails, totalTokens=$totalTokens, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallCompletedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallCompletedEvent.kt
new file mode 100644
index 000000000..469b5436d
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallCompletedEvent.kt
@@ -0,0 +1,518 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a web search call is completed. */
+class BetaResponseWebSearchCallCompletedEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * Unique ID for the output item associated with the web search call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item that the web search call is associated with.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of the web search call being processed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.web_search_call.completed`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.web_search_call.completed")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseWebSearchCallCompletedEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseWebSearchCallCompletedEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.web_search_call.completed")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseWebSearchCallCompletedEvent: BetaResponseWebSearchCallCompletedEvent
+        ) = apply {
+            itemId = betaResponseWebSearchCallCompletedEvent.itemId
+            outputIndex = betaResponseWebSearchCallCompletedEvent.outputIndex
+            sequenceNumber = betaResponseWebSearchCallCompletedEvent.sequenceNumber
+            type = betaResponseWebSearchCallCompletedEvent.type
+            agent = betaResponseWebSearchCallCompletedEvent.agent
+            additionalProperties =
+                betaResponseWebSearchCallCompletedEvent.additionalProperties.toMutableMap()
+        }
+
+        /** Unique ID for the output item associated with the web search call. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item that the web search call is associated with. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of the web search call being processed. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.web_search_call.completed")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseWebSearchCallCompletedEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseWebSearchCallCompletedEvent =
+            BetaResponseWebSearchCallCompletedEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseWebSearchCallCompletedEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.web_search_call.completed")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.web_search_call.completed")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseWebSearchCallCompletedEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseWebSearchCallCompletedEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallInProgressEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallInProgressEvent.kt
new file mode 100644
index 000000000..b975ee658
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallInProgressEvent.kt
@@ -0,0 +1,520 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a web search call is initiated. */
+class BetaResponseWebSearchCallInProgressEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * Unique ID for the output item associated with the web search call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item that the web search call is associated with.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of the web search call being processed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.web_search_call.in_progress`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.web_search_call.in_progress")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseWebSearchCallInProgressEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseWebSearchCallInProgressEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.web_search_call.in_progress")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseWebSearchCallInProgressEvent: BetaResponseWebSearchCallInProgressEvent
+        ) = apply {
+            itemId = betaResponseWebSearchCallInProgressEvent.itemId
+            outputIndex = betaResponseWebSearchCallInProgressEvent.outputIndex
+            sequenceNumber = betaResponseWebSearchCallInProgressEvent.sequenceNumber
+            type = betaResponseWebSearchCallInProgressEvent.type
+            agent = betaResponseWebSearchCallInProgressEvent.agent
+            additionalProperties =
+                betaResponseWebSearchCallInProgressEvent.additionalProperties.toMutableMap()
+        }
+
+        /** Unique ID for the output item associated with the web search call. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item that the web search call is associated with. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of the web search call being processed. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.web_search_call.in_progress")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseWebSearchCallInProgressEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseWebSearchCallInProgressEvent =
+            BetaResponseWebSearchCallInProgressEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseWebSearchCallInProgressEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.web_search_call.in_progress")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let {
+                if (it == JsonValue.from("response.web_search_call.in_progress")) 1 else 0
+            } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseWebSearchCallInProgressEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseWebSearchCallInProgressEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallSearchingEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallSearchingEvent.kt
new file mode 100644
index 000000000..f354be304
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallSearchingEvent.kt
@@ -0,0 +1,518 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Emitted when a web search call is executing. */
+class BetaResponseWebSearchCallSearchingEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val itemId: JsonField<String>,
+    private val outputIndex: JsonField<Long>,
+    private val sequenceNumber: JsonField<Long>,
+    private val type: JsonValue,
+    private val agent: JsonField<Agent>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("item_id") @ExcludeMissing itemId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("output_index")
+        @ExcludeMissing
+        outputIndex: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("sequence_number")
+        @ExcludeMissing
+        sequenceNumber: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("agent") @ExcludeMissing agent: JsonField<Agent> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, sequenceNumber, type, agent, mutableMapOf())
+
+    /**
+     * Unique ID for the output item associated with the web search call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun itemId(): String = itemId.getRequired("item_id")
+
+    /**
+     * The index of the output item that the web search call is associated with.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun outputIndex(): Long = outputIndex.getRequired("output_index")
+
+    /**
+     * The sequence number of the web search call being processed.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun sequenceNumber(): Long = sequenceNumber.getRequired("sequence_number")
+
+    /**
+     * The type of the event. Always `response.web_search_call.searching`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.web_search_call.searching")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The agent that owns this multi-agent streaming event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun agent(): Optional<Agent> = agent.getOptional("agent")
+
+    /**
+     * Returns the raw JSON value of [itemId].
+     *
+     * Unlike [itemId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("item_id") @ExcludeMissing fun _itemId(): JsonField<String> = itemId
+
+    /**
+     * Returns the raw JSON value of [outputIndex].
+     *
+     * Unlike [outputIndex], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_index") @ExcludeMissing fun _outputIndex(): JsonField<Long> = outputIndex
+
+    /**
+     * Returns the raw JSON value of [sequenceNumber].
+     *
+     * Unlike [sequenceNumber], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("sequence_number")
+    @ExcludeMissing
+    fun _sequenceNumber(): JsonField<Long> = sequenceNumber
+
+    /**
+     * Returns the raw JSON value of [agent].
+     *
+     * Unlike [agent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("agent") @ExcludeMissing fun _agent(): JsonField<Agent> = agent
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [BetaResponseWebSearchCallSearchingEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseWebSearchCallSearchingEvent]. */
+    class Builder internal constructor() {
+
+        private var itemId: JsonField<String>? = null
+        private var outputIndex: JsonField<Long>? = null
+        private var sequenceNumber: JsonField<Long>? = null
+        private var type: JsonValue = JsonValue.from("response.web_search_call.searching")
+        private var agent: JsonField<Agent> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            betaResponseWebSearchCallSearchingEvent: BetaResponseWebSearchCallSearchingEvent
+        ) = apply {
+            itemId = betaResponseWebSearchCallSearchingEvent.itemId
+            outputIndex = betaResponseWebSearchCallSearchingEvent.outputIndex
+            sequenceNumber = betaResponseWebSearchCallSearchingEvent.sequenceNumber
+            type = betaResponseWebSearchCallSearchingEvent.type
+            agent = betaResponseWebSearchCallSearchingEvent.agent
+            additionalProperties =
+                betaResponseWebSearchCallSearchingEvent.additionalProperties.toMutableMap()
+        }
+
+        /** Unique ID for the output item associated with the web search call. */
+        fun itemId(itemId: String) = itemId(JsonField.of(itemId))
+
+        /**
+         * Sets [Builder.itemId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.itemId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun itemId(itemId: JsonField<String>) = apply { this.itemId = itemId }
+
+        /** The index of the output item that the web search call is associated with. */
+        fun outputIndex(outputIndex: Long) = outputIndex(JsonField.of(outputIndex))
+
+        /**
+         * Sets [Builder.outputIndex] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputIndex] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun outputIndex(outputIndex: JsonField<Long>) = apply { this.outputIndex = outputIndex }
+
+        /** The sequence number of the web search call being processed. */
+        fun sequenceNumber(sequenceNumber: Long) = sequenceNumber(JsonField.of(sequenceNumber))
+
+        /**
+         * Sets [Builder.sequenceNumber] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.sequenceNumber] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun sequenceNumber(sequenceNumber: JsonField<Long>) = apply {
+            this.sequenceNumber = sequenceNumber
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.web_search_call.searching")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The agent that owns this multi-agent streaming event. */
+        fun agent(agent: Agent?) = agent(JsonField.ofNullable(agent))
+
+        /** Alias for calling [Builder.agent] with `agent.orElse(null)`. */
+        fun agent(agent: Optional<Agent>) = agent(agent.getOrNull())
+
+        /**
+         * Sets [Builder.agent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.agent] with a well-typed [Agent] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun agent(agent: JsonField<Agent>) = apply { this.agent = agent }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseWebSearchCallSearchingEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .itemId()
+         * .outputIndex()
+         * .sequenceNumber()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseWebSearchCallSearchingEvent =
+            BetaResponseWebSearchCallSearchingEvent(
+                checkRequired("itemId", itemId),
+                checkRequired("outputIndex", outputIndex),
+                checkRequired("sequenceNumber", sequenceNumber),
+                type,
+                agent,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseWebSearchCallSearchingEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        itemId()
+        outputIndex()
+        sequenceNumber()
+        _type().let {
+            if (it != JsonValue.from("response.web_search_call.searching")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        agent().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (itemId.asKnown().isPresent) 1 else 0) +
+            (if (outputIndex.asKnown().isPresent) 1 else 0) +
+            (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("response.web_search_call.searching")) 1 else 0 } +
+            (agent.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The agent that owns this multi-agent streaming event. */
+    class Agent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val agentName: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("agent_name")
+            @ExcludeMissing
+            agentName: JsonField<String> = JsonMissing.of()
+        ) : this(agentName, mutableMapOf())
+
+        /**
+         * The canonical name of the agent that produced this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun agentName(): String = agentName.getRequired("agent_name")
+
+        /**
+         * Returns the raw JSON value of [agentName].
+         *
+         * Unlike [agentName], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("agent_name") @ExcludeMissing fun _agentName(): JsonField<String> = agentName
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Agent].
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Agent]. */
+        class Builder internal constructor() {
+
+            private var agentName: JsonField<String>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(agent: Agent) = apply {
+                agentName = agent.agentName
+                additionalProperties = agent.additionalProperties.toMutableMap()
+            }
+
+            /** The canonical name of the agent that produced this item. */
+            fun agentName(agentName: String) = agentName(JsonField.of(agentName))
+
+            /**
+             * Sets [Builder.agentName] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.agentName] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun agentName(agentName: JsonField<String>) = apply { this.agentName = agentName }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Agent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .agentName()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Agent =
+                Agent(checkRequired("agentName", agentName), additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Agent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            agentName()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = (if (agentName.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Agent &&
+                agentName == other.agentName &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(agentName, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Agent{agentName=$agentName, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseWebSearchCallSearchingEvent &&
+            itemId == other.itemId &&
+            outputIndex == other.outputIndex &&
+            sequenceNumber == other.sequenceNumber &&
+            type == other.type &&
+            agent == other.agent &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(itemId, outputIndex, sequenceNumber, type, agent, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseWebSearchCallSearchingEvent{itemId=$itemId, outputIndex=$outputIndex, sequenceNumber=$sequenceNumber, type=$type, agent=$agent, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponsesClientEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponsesClientEvent.kt
new file mode 100644
index 000000000..9cbbc8ac6
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponsesClientEvent.kt
@@ -0,0 +1,8384 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.allMaxBy
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Client events accepted by the Responses WebSocket server. */
+@JsonDeserialize(using = BetaResponsesClientEvent.Deserializer::class)
+@JsonSerialize(using = BetaResponsesClientEvent.Serializer::class)
+class BetaResponsesClientEvent
+private constructor(
+    private val responseCreate: ResponseCreate? = null,
+    private val responseInject: BetaResponseInjectEvent? = null,
+    private val _json: JsonValue? = null,
+) {
+
+    /**
+     * Client event for creating a response over a persistent WebSocket connection. This payload
+     * uses the same top-level fields as `POST /v1/responses`.
+     *
+     * Notes:
+     * - `stream` is implicit over WebSocket and should not be sent.
+     * - `background` is not supported over WebSocket.
+     */
+    fun responseCreate(): Optional<ResponseCreate> = Optional.ofNullable(responseCreate)
+
+    /**
+     * Injects input items into an active response over a WebSocket connection. The items are
+     * validated and committed atomically. Currently, the server accepts client-owned tool outputs
+     * that resume a waiting agent.
+     */
+    fun responseInject(): Optional<BetaResponseInjectEvent> = Optional.ofNullable(responseInject)
+
+    fun isResponseCreate(): Boolean = responseCreate != null
+
+    fun isResponseInject(): Boolean = responseInject != null
+
+    /**
+     * Client event for creating a response over a persistent WebSocket connection. This payload
+     * uses the same top-level fields as `POST /v1/responses`.
+     *
+     * Notes:
+     * - `stream` is implicit over WebSocket and should not be sent.
+     * - `background` is not supported over WebSocket.
+     */
+    fun asResponseCreate(): ResponseCreate = responseCreate.getOrThrow("responseCreate")
+
+    /**
+     * Injects input items into an active response over a WebSocket connection. The items are
+     * validated and committed atomically. Currently, the server accepts client-owned tool outputs
+     * that resume a waiting agent.
+     */
+    fun asResponseInject(): BetaResponseInjectEvent = responseInject.getOrThrow("responseInject")
+
+    fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+    /**
+     * Maps this instance's current variant to a value of type [T] using the given [visitor].
+     *
+     * Note that this method is _not_ forwards compatible with new variants from the API, unless
+     * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of the
+     * SDK gracefully, consider overriding [Visitor.unknown]:
+     * ```java
+     * import com.openai.core.JsonValue;
+     * import java.util.Optional;
+     *
+     * Optional<String> result = betaResponsesClientEvent.accept(new BetaResponsesClientEvent.Visitor<Optional<String>>() {
+     *     @Override
+     *     public Optional<String> visitResponseCreate(ResponseCreate responseCreate) {
+     *         return Optional.of(responseCreate.toString());
+     *     }
+     *
+     *     // ...
+     *
+     *     @Override
+     *     public Optional<String> unknown(JsonValue json) {
+     *         // Or inspect the `json`.
+     *         return Optional.empty();
+     *     }
+     * });
+     * ```
+     *
+     * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor] and
+     *   the current variant is unknown.
+     */
+    fun <T> accept(visitor: Visitor<T>): T =
+        when {
+            responseCreate != null -> visitor.visitResponseCreate(responseCreate)
+            responseInject != null -> visitor.visitResponseInject(responseInject)
+            else -> visitor.unknown(_json)
+        }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponsesClientEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        accept(
+            object : Visitor<Unit> {
+                override fun visitResponseCreate(responseCreate: ResponseCreate) {
+                    responseCreate.validate()
+                }
+
+                override fun visitResponseInject(responseInject: BetaResponseInjectEvent) {
+                    responseInject.validate()
+                }
+            }
+        )
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        accept(
+            object : Visitor<Int> {
+                override fun visitResponseCreate(responseCreate: ResponseCreate) =
+                    responseCreate.validity()
+
+                override fun visitResponseInject(responseInject: BetaResponseInjectEvent) =
+                    responseInject.validity()
+
+                override fun unknown(json: JsonValue?) = 0
+            }
+        )
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponsesClientEvent &&
+            responseCreate == other.responseCreate &&
+            responseInject == other.responseInject
+    }
+
+    override fun hashCode(): Int = Objects.hash(responseCreate, responseInject)
+
+    override fun toString(): String =
+        when {
+            responseCreate != null -> "BetaResponsesClientEvent{responseCreate=$responseCreate}"
+            responseInject != null -> "BetaResponsesClientEvent{responseInject=$responseInject}"
+            _json != null -> "BetaResponsesClientEvent{_unknown=$_json}"
+            else -> throw IllegalStateException("Invalid BetaResponsesClientEvent")
+        }
+
+    companion object {
+
+        /**
+         * Client event for creating a response over a persistent WebSocket connection. This payload
+         * uses the same top-level fields as `POST /v1/responses`.
+         *
+         * Notes:
+         * - `stream` is implicit over WebSocket and should not be sent.
+         * - `background` is not supported over WebSocket.
+         */
+        @JvmStatic
+        fun ofResponseCreate(responseCreate: ResponseCreate) =
+            BetaResponsesClientEvent(responseCreate = responseCreate)
+
+        /**
+         * Injects input items into an active response over a WebSocket connection. The items are
+         * validated and committed atomically. Currently, the server accepts client-owned tool
+         * outputs that resume a waiting agent.
+         */
+        @JvmStatic
+        fun ofResponseInject(responseInject: BetaResponseInjectEvent) =
+            BetaResponsesClientEvent(responseInject = responseInject)
+    }
+
+    /**
+     * An interface that defines how to map each variant of [BetaResponsesClientEvent] to a value of
+     * type [T].
+     */
+    interface Visitor<out T> {
+
+        /**
+         * Client event for creating a response over a persistent WebSocket connection. This payload
+         * uses the same top-level fields as `POST /v1/responses`.
+         *
+         * Notes:
+         * - `stream` is implicit over WebSocket and should not be sent.
+         * - `background` is not supported over WebSocket.
+         */
+        fun visitResponseCreate(responseCreate: ResponseCreate): T
+
+        /**
+         * Injects input items into an active response over a WebSocket connection. The items are
+         * validated and committed atomically. Currently, the server accepts client-owned tool
+         * outputs that resume a waiting agent.
+         */
+        fun visitResponseInject(responseInject: BetaResponseInjectEvent): T
+
+        /**
+         * Maps an unknown variant of [BetaResponsesClientEvent] to a value of type [T].
+         *
+         * An instance of [BetaResponsesClientEvent] can contain an unknown variant if it was
+         * deserialized from data that doesn't match any known variant. For example, if the SDK is
+         * on an older version than the API, then the API may respond with new variants that the SDK
+         * is unaware of.
+         *
+         * @throws OpenAIInvalidDataException in the default implementation.
+         */
+        fun unknown(json: JsonValue?): T {
+            throw OpenAIInvalidDataException("Unknown BetaResponsesClientEvent: $json")
+        }
+    }
+
+    internal class Deserializer :
+        BaseDeserializer<BetaResponsesClientEvent>(BetaResponsesClientEvent::class) {
+
+        override fun ObjectCodec.deserialize(node: JsonNode): BetaResponsesClientEvent {
+            val json = JsonValue.fromJsonNode(node)
+            val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+            when (type) {
+                "response.create" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ResponseCreate>())?.let {
+                        BetaResponsesClientEvent(responseCreate = it, _json = json)
+                    } ?: BetaResponsesClientEvent(_json = json)
+                }
+                "response.inject" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseInjectEvent>())?.let {
+                        BetaResponsesClientEvent(responseInject = it, _json = json)
+                    } ?: BetaResponsesClientEvent(_json = json)
+                }
+            }
+
+            return BetaResponsesClientEvent(_json = json)
+        }
+    }
+
+    internal class Serializer :
+        BaseSerializer<BetaResponsesClientEvent>(BetaResponsesClientEvent::class) {
+
+        override fun serialize(
+            value: BetaResponsesClientEvent,
+            generator: JsonGenerator,
+            provider: SerializerProvider,
+        ) {
+            when {
+                value.responseCreate != null -> generator.writeObject(value.responseCreate)
+                value.responseInject != null -> generator.writeObject(value.responseInject)
+                value._json != null -> generator.writeObject(value._json)
+                else -> throw IllegalStateException("Invalid BetaResponsesClientEvent")
+            }
+        }
+    }
+
+    /**
+     * Client event for creating a response over a persistent WebSocket connection. This payload
+     * uses the same top-level fields as `POST /v1/responses`.
+     *
+     * Notes:
+     * - `stream` is implicit over WebSocket and should not be sent.
+     * - `background` is not supported over WebSocket.
+     */
+    class ResponseCreate
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val type: JsonValue,
+        private val background: JsonField<Boolean>,
+        private val contextManagement: JsonField<List<ContextManagement>>,
+        private val conversation: JsonField<Conversation>,
+        private val include: JsonField<List<BetaResponseIncludable>>,
+        private val input: JsonField<Input>,
+        private val instructions: JsonField<String>,
+        private val maxOutputTokens: JsonField<Long>,
+        private val maxToolCalls: JsonField<Long>,
+        private val metadata: JsonField<Metadata>,
+        private val model: JsonField<Model>,
+        private val moderation: JsonField<Moderation>,
+        private val multiAgent: JsonField<MultiAgent>,
+        private val parallelToolCalls: JsonField<Boolean>,
+        private val previousResponseId: JsonField<String>,
+        private val prompt: JsonField<BetaResponsePrompt>,
+        private val promptCacheKey: JsonField<String>,
+        private val promptCacheOptions: JsonField<PromptCacheOptions>,
+        private val promptCacheRetention: JsonField<PromptCacheRetention>,
+        private val reasoning: JsonField<Reasoning>,
+        private val safetyIdentifier: JsonField<String>,
+        private val serviceTier: JsonField<ServiceTier>,
+        private val store: JsonField<Boolean>,
+        private val stream: JsonField<Boolean>,
+        private val streamOptions: JsonField<StreamOptions>,
+        private val temperature: JsonField<Double>,
+        private val text: JsonField<BetaResponseTextConfig>,
+        private val toolChoice: JsonField<ToolChoice>,
+        private val tools: JsonField<List<BetaTool>>,
+        private val topLogprobs: JsonField<Long>,
+        private val topP: JsonField<Double>,
+        private val truncation: JsonField<Truncation>,
+        private val user: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("background")
+            @ExcludeMissing
+            background: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("context_management")
+            @ExcludeMissing
+            contextManagement: JsonField<List<ContextManagement>> = JsonMissing.of(),
+            @JsonProperty("conversation")
+            @ExcludeMissing
+            conversation: JsonField<Conversation> = JsonMissing.of(),
+            @JsonProperty("include")
+            @ExcludeMissing
+            include: JsonField<List<BetaResponseIncludable>> = JsonMissing.of(),
+            @JsonProperty("input") @ExcludeMissing input: JsonField<Input> = JsonMissing.of(),
+            @JsonProperty("instructions")
+            @ExcludeMissing
+            instructions: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("max_output_tokens")
+            @ExcludeMissing
+            maxOutputTokens: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("max_tool_calls")
+            @ExcludeMissing
+            maxToolCalls: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("metadata")
+            @ExcludeMissing
+            metadata: JsonField<Metadata> = JsonMissing.of(),
+            @JsonProperty("model") @ExcludeMissing model: JsonField<Model> = JsonMissing.of(),
+            @JsonProperty("moderation")
+            @ExcludeMissing
+            moderation: JsonField<Moderation> = JsonMissing.of(),
+            @JsonProperty("multi_agent")
+            @ExcludeMissing
+            multiAgent: JsonField<MultiAgent> = JsonMissing.of(),
+            @JsonProperty("parallel_tool_calls")
+            @ExcludeMissing
+            parallelToolCalls: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("previous_response_id")
+            @ExcludeMissing
+            previousResponseId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("prompt")
+            @ExcludeMissing
+            prompt: JsonField<BetaResponsePrompt> = JsonMissing.of(),
+            @JsonProperty("prompt_cache_key")
+            @ExcludeMissing
+            promptCacheKey: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("prompt_cache_options")
+            @ExcludeMissing
+            promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of(),
+            @JsonProperty("prompt_cache_retention")
+            @ExcludeMissing
+            promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of(),
+            @JsonProperty("reasoning")
+            @ExcludeMissing
+            reasoning: JsonField<Reasoning> = JsonMissing.of(),
+            @JsonProperty("safety_identifier")
+            @ExcludeMissing
+            safetyIdentifier: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("service_tier")
+            @ExcludeMissing
+            serviceTier: JsonField<ServiceTier> = JsonMissing.of(),
+            @JsonProperty("store") @ExcludeMissing store: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("stream") @ExcludeMissing stream: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("stream_options")
+            @ExcludeMissing
+            streamOptions: JsonField<StreamOptions> = JsonMissing.of(),
+            @JsonProperty("temperature")
+            @ExcludeMissing
+            temperature: JsonField<Double> = JsonMissing.of(),
+            @JsonProperty("text")
+            @ExcludeMissing
+            text: JsonField<BetaResponseTextConfig> = JsonMissing.of(),
+            @JsonProperty("tool_choice")
+            @ExcludeMissing
+            toolChoice: JsonField<ToolChoice> = JsonMissing.of(),
+            @JsonProperty("tools")
+            @ExcludeMissing
+            tools: JsonField<List<BetaTool>> = JsonMissing.of(),
+            @JsonProperty("top_logprobs")
+            @ExcludeMissing
+            topLogprobs: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("top_p") @ExcludeMissing topP: JsonField<Double> = JsonMissing.of(),
+            @JsonProperty("truncation")
+            @ExcludeMissing
+            truncation: JsonField<Truncation> = JsonMissing.of(),
+            @JsonProperty("user") @ExcludeMissing user: JsonField<String> = JsonMissing.of(),
+        ) : this(
+            type,
+            background,
+            contextManagement,
+            conversation,
+            include,
+            input,
+            instructions,
+            maxOutputTokens,
+            maxToolCalls,
+            metadata,
+            model,
+            moderation,
+            multiAgent,
+            parallelToolCalls,
+            previousResponseId,
+            prompt,
+            promptCacheKey,
+            promptCacheOptions,
+            promptCacheRetention,
+            reasoning,
+            safetyIdentifier,
+            serviceTier,
+            store,
+            stream,
+            streamOptions,
+            temperature,
+            text,
+            toolChoice,
+            tools,
+            topLogprobs,
+            topP,
+            truncation,
+            user,
+            mutableMapOf(),
+        )
+
+        /**
+         * The type of the client event. Always `response.create`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("response.create")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Whether to run the model response in the background.
+         * [Learn more](https://platform.openai.com/docs/guides/background).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun background(): Optional<Boolean> = background.getOptional("background")
+
+        /**
+         * Context management configuration for this request.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun contextManagement(): Optional<List<ContextManagement>> =
+            contextManagement.getOptional("context_management")
+
+        /**
+         * The conversation that this response belongs to. Items from this conversation are
+         * prepended to `input_items` for this response request. Input items and output items from
+         * this response are automatically added to this conversation after this response completes.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun conversation(): Optional<Conversation> = conversation.getOptional("conversation")
+
+        /**
+         * Specify additional output data to include in the model response. Currently supported
+         * values are:
+         * - `web_search_call.action.sources`: Include the sources of the web search tool call.
+         * - `code_interpreter_call.outputs`: Includes the outputs of python code execution in code
+         *   interpreter tool call items.
+         * - `computer_call_output.output.image_url`: Include image urls from the computer call
+         *   output.
+         * - `file_search_call.results`: Include the search results of the file search tool call.
+         * - `message.input_image.image_url`: Include image urls from the input message.
+         * - `message.output_text.logprobs`: Include logprobs with assistant messages.
+         * - `reasoning.encrypted_content`: Includes an encrypted version of reasoning tokens in
+         *   reasoning item outputs. This enables reasoning items to be used in multi-turn
+         *   conversations when using the Responses API statelessly (like when the `store` parameter
+         *   is set to `false`, or when an organization is enrolled in the zero data retention
+         *   program).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun include(): Optional<List<BetaResponseIncludable>> = include.getOptional("include")
+
+        /**
+         * Text, image, or file inputs to the model, used to generate a response.
+         *
+         * Learn more:
+         * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+         * - [Image inputs](https://platform.openai.com/docs/guides/images)
+         * - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
+         * - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
+         * - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun input(): Optional<Input> = input.getOptional("input")
+
+        /**
+         * A system (or developer) message inserted into the model's context.
+         *
+         * When using along with `previous_response_id`, the instructions from a previous response
+         * will not be carried over to the next response. This makes it simple to swap out system
+         * (or developer) messages in new responses.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun instructions(): Optional<String> = instructions.getOptional("instructions")
+
+        /**
+         * An upper bound for the number of tokens that can be generated for a response, including
+         * visible output tokens and
+         * [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun maxOutputTokens(): Optional<Long> = maxOutputTokens.getOptional("max_output_tokens")
+
+        /**
+         * The maximum number of total calls to built-in tools that can be processed in a response.
+         * This maximum number applies across all built-in tool calls, not per individual tool. Any
+         * further attempts to call a tool by the model will be ignored.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun maxToolCalls(): Optional<Long> = maxToolCalls.getOptional("max_tool_calls")
+
+        /**
+         * Set of 16 key-value pairs that can be attached to an object. This can be useful for
+         * storing additional information about the object in a structured format, and querying for
+         * objects via API or the dashboard.
+         *
+         * Keys are strings with a maximum length of 64 characters. Values are strings with a
+         * maximum length of 512 characters.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun metadata(): Optional<Metadata> = metadata.getOptional("metadata")
+
+        /**
+         * Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide range
+         * of models with different capabilities, performance characteristics, and price points.
+         * Refer to the [model guide](https://platform.openai.com/docs/models) to browse and compare
+         * available models.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun model(): Optional<Model> = model.getOptional("model")
+
+        /**
+         * Configuration for running moderation on the input and output of this response.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun moderation(): Optional<Moderation> = moderation.getOptional("moderation")
+
+        /**
+         * Configuration for server-hosted multi-agent execution.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun multiAgent(): Optional<MultiAgent> = multiAgent.getOptional("multi_agent")
+
+        /**
+         * Whether to allow the model to run tool calls in parallel.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun parallelToolCalls(): Optional<Boolean> =
+            parallelToolCalls.getOptional("parallel_tool_calls")
+
+        /**
+         * The unique ID of the previous response to the model. Use this to create multi-turn
+         * conversations. Learn more about
+         * [conversation state](https://platform.openai.com/docs/guides/conversation-state). Cannot
+         * be used in conjunction with `conversation`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun previousResponseId(): Optional<String> =
+            previousResponseId.getOptional("previous_response_id")
+
+        /**
+         * Reference to a prompt template and its variables.
+         * [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun prompt(): Optional<BetaResponsePrompt> = prompt.getOptional("prompt")
+
+        /**
+         * Used by OpenAI to cache responses for similar requests to optimize your cache hit rates.
+         * Replaces the `user` field.
+         * [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun promptCacheKey(): Optional<String> = promptCacheKey.getOptional("prompt_cache_key")
+
+        /**
+         * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+         * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+         * content blocks with `prompt_cache_breakpoint`. Each request can write up to four
+         * breakpoints. For cache matching, OpenAI considers up to the latest 80 breakpoints in the
+         * conversation, without a content-block lookback limit. Set `mode` to `explicit` to disable
+         * the implicit breakpoint. The `ttl` defaults to `30m`, which is currently the only
+         * supported value. See the
+         * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+         * current details.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun promptCacheOptions(): Optional<PromptCacheOptions> =
+            promptCacheOptions.getOptional("prompt_cache_options")
+
+        /**
+         * Deprecated. Use `prompt_cache_options.ttl` instead.
+         *
+         * The retention policy for the prompt cache. Set to `24h` to enable extended prompt
+         * caching, which keeps cached prefixes active for longer, up to a maximum of 24 hours.
+         * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+         * This field expresses a maximum retention policy, while `prompt_cache_options.ttl`
+         * expresses a minimum cache lifetime. The two fields are independent and do not interact.
+         * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+         *
+         * For older models that support both `in_memory` and `24h`, the default depends on your
+         * organization's data retention policy:
+         * - Organizations without ZDR enabled default to `24h`.
+         * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is
+         *   not specified.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        @Deprecated("deprecated")
+        fun promptCacheRetention(): Optional<PromptCacheRetention> =
+            promptCacheRetention.getOptional("prompt_cache_retention")
+
+        /**
+         * **gpt-5 and o-series models only**
+         *
+         * Configuration options for
+         * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun reasoning(): Optional<Reasoning> = reasoning.getOptional("reasoning")
+
+        /**
+         * A stable identifier used to help detect users of your application that may be violating
+         * OpenAI's usage policies. The IDs should be a string that uniquely identifies each user,
+         * with a maximum length of 64 characters. We recommend hashing their username or email
+         * address, in order to avoid sending us any identifying information.
+         * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun safetyIdentifier(): Optional<String> = safetyIdentifier.getOptional("safety_identifier")
+
+        /**
+         * Specifies the processing type used for serving the request.
+         * - If set to 'auto', then the request will be processed with the service tier configured
+         *   in the Project settings. Unless otherwise configured, the Project will use 'default'.
+         * - If set to 'default', then the request will be processed with the standard pricing and
+         *   performance for the selected model.
+         * - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
+         *   '[priority](https://openai.com/api-priority-processing/)', then the request will be
+         *   processed with the corresponding service tier.
+         * - When not set, the default behavior is 'auto'.
+         *
+         *   When the `service_tier` parameter is set, the response body will include the
+         *   `service_tier` value based on the processing mode actually used to serve the request.
+         *   This response value may be different from the value set in the parameter.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun serviceTier(): Optional<ServiceTier> = serviceTier.getOptional("service_tier")
+
+        /**
+         * Whether to store the generated model response for later retrieval via API.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun store(): Optional<Boolean> = store.getOptional("store")
+
+        /**
+         * If set to true, the model response data will be streamed to the client as it is generated
+         * using
+         * [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format).
+         * See the
+         * [Streaming section below](https://platform.openai.com/docs/api-reference/responses-streaming)
+         * for more information.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun stream(): Optional<Boolean> = stream.getOptional("stream")
+
+        /**
+         * Options for streaming responses. Only set this when you set `stream: true`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun streamOptions(): Optional<StreamOptions> = streamOptions.getOptional("stream_options")
+
+        /**
+         * What sampling temperature to use, between 0 and 2. Higher values like 0.8 will make the
+         * output more random, while lower values like 0.2 will make it more focused and
+         * deterministic. We generally recommend altering this or `top_p` but not both.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun temperature(): Optional<Double> = temperature.getOptional("temperature")
+
+        /**
+         * Configuration options for a text response from the model. Can be plain text or structured
+         * JSON data. Learn more:
+         * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+         * - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun text(): Optional<BetaResponseTextConfig> = text.getOptional("text")
+
+        /**
+         * How the model should select which tool (or tools) to use when generating a response. See
+         * the `tools` parameter to see how to specify which tools the model can call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun toolChoice(): Optional<ToolChoice> = toolChoice.getOptional("tool_choice")
+
+        /**
+         * An array of tools the model may call while generating a response. You can specify which
+         * tool to use by setting the `tool_choice` parameter.
+         *
+         * We support the following categories of tools:
+         * - **Built-in tools**: Tools that are provided by OpenAI that extend the model's
+         *   capabilities, like
+         *   [web search](https://platform.openai.com/docs/guides/tools-web-search) or
+         *   [file search](https://platform.openai.com/docs/guides/tools-file-search). Learn more
+         *   about [built-in tools](https://platform.openai.com/docs/guides/tools).
+         * - **MCP Tools**: Integrations with third-party systems via custom MCP servers or
+         *   predefined connectors such as Google Drive and SharePoint. Learn more about
+         *   [MCP Tools](https://platform.openai.com/docs/guides/tools-connectors-mcp).
+         * - **Function calls (custom tools)**: Functions that are defined by you, enabling the
+         *   model to call your own code with strongly typed arguments and outputs. Learn more about
+         *   [function calling](https://platform.openai.com/docs/guides/function-calling). You can
+         *   also use custom tools to call your own code.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun tools(): Optional<List<BetaTool>> = tools.getOptional("tools")
+
+        /**
+         * An integer between 0 and 20 specifying the maximum number of most likely tokens to return
+         * at each token position, each with an associated log probability. In some cases, the
+         * number of returned tokens may be fewer than requested.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun topLogprobs(): Optional<Long> = topLogprobs.getOptional("top_logprobs")
+
+        /**
+         * An alternative to sampling with temperature, called nucleus sampling, where the model
+         * considers the results of the tokens with top_p probability mass. So 0.1 means only the
+         * tokens comprising the top 10% probability mass are considered.
+         *
+         * We generally recommend altering this or `temperature` but not both.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun topP(): Optional<Double> = topP.getOptional("top_p")
+
+        /**
+         * The truncation strategy to use for the model response.
+         * - `auto`: If the input to this Response exceeds the model's context window size, the
+         *   model will truncate the response to fit the context window by dropping items from the
+         *   beginning of the conversation.
+         * - `disabled` (default): If the input size will exceed the context window size for a
+         *   model, the request will fail with a 400 error.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        @Deprecated("deprecated")
+        fun truncation(): Optional<Truncation> = truncation.getOptional("truncation")
+
+        /**
+         * This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+         * `prompt_cache_key` instead to maintain caching optimizations. 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#safety-identifiers).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        @Deprecated("deprecated") fun user(): Optional<String> = user.getOptional("user")
+
+        /**
+         * Returns the raw JSON value of [background].
+         *
+         * Unlike [background], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("background")
+        @ExcludeMissing
+        fun _background(): JsonField<Boolean> = background
+
+        /**
+         * Returns the raw JSON value of [contextManagement].
+         *
+         * Unlike [contextManagement], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("context_management")
+        @ExcludeMissing
+        fun _contextManagement(): JsonField<List<ContextManagement>> = contextManagement
+
+        /**
+         * Returns the raw JSON value of [conversation].
+         *
+         * Unlike [conversation], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("conversation")
+        @ExcludeMissing
+        fun _conversation(): JsonField<Conversation> = conversation
+
+        /**
+         * Returns the raw JSON value of [include].
+         *
+         * Unlike [include], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("include")
+        @ExcludeMissing
+        fun _include(): JsonField<List<BetaResponseIncludable>> = include
+
+        /**
+         * Returns the raw JSON value of [input].
+         *
+         * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("input") @ExcludeMissing fun _input(): JsonField<Input> = input
+
+        /**
+         * Returns the raw JSON value of [instructions].
+         *
+         * Unlike [instructions], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("instructions")
+        @ExcludeMissing
+        fun _instructions(): JsonField<String> = instructions
+
+        /**
+         * Returns the raw JSON value of [maxOutputTokens].
+         *
+         * Unlike [maxOutputTokens], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("max_output_tokens")
+        @ExcludeMissing
+        fun _maxOutputTokens(): JsonField<Long> = maxOutputTokens
+
+        /**
+         * Returns the raw JSON value of [maxToolCalls].
+         *
+         * Unlike [maxToolCalls], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("max_tool_calls")
+        @ExcludeMissing
+        fun _maxToolCalls(): JsonField<Long> = maxToolCalls
+
+        /**
+         * Returns the raw JSON value of [metadata].
+         *
+         * Unlike [metadata], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("metadata") @ExcludeMissing fun _metadata(): JsonField<Metadata> = metadata
+
+        /**
+         * Returns the raw JSON value of [model].
+         *
+         * Unlike [model], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("model") @ExcludeMissing fun _model(): JsonField<Model> = model
+
+        /**
+         * Returns the raw JSON value of [moderation].
+         *
+         * Unlike [moderation], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("moderation")
+        @ExcludeMissing
+        fun _moderation(): JsonField<Moderation> = moderation
+
+        /**
+         * Returns the raw JSON value of [multiAgent].
+         *
+         * Unlike [multiAgent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("multi_agent")
+        @ExcludeMissing
+        fun _multiAgent(): JsonField<MultiAgent> = multiAgent
+
+        /**
+         * Returns the raw JSON value of [parallelToolCalls].
+         *
+         * Unlike [parallelToolCalls], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("parallel_tool_calls")
+        @ExcludeMissing
+        fun _parallelToolCalls(): JsonField<Boolean> = parallelToolCalls
+
+        /**
+         * Returns the raw JSON value of [previousResponseId].
+         *
+         * Unlike [previousResponseId], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @JsonProperty("previous_response_id")
+        @ExcludeMissing
+        fun _previousResponseId(): JsonField<String> = previousResponseId
+
+        /**
+         * Returns the raw JSON value of [prompt].
+         *
+         * Unlike [prompt], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("prompt")
+        @ExcludeMissing
+        fun _prompt(): JsonField<BetaResponsePrompt> = prompt
+
+        /**
+         * Returns the raw JSON value of [promptCacheKey].
+         *
+         * Unlike [promptCacheKey], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("prompt_cache_key")
+        @ExcludeMissing
+        fun _promptCacheKey(): JsonField<String> = promptCacheKey
+
+        /**
+         * Returns the raw JSON value of [promptCacheOptions].
+         *
+         * Unlike [promptCacheOptions], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @JsonProperty("prompt_cache_options")
+        @ExcludeMissing
+        fun _promptCacheOptions(): JsonField<PromptCacheOptions> = promptCacheOptions
+
+        /**
+         * Returns the raw JSON value of [promptCacheRetention].
+         *
+         * Unlike [promptCacheRetention], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @Deprecated("deprecated")
+        @JsonProperty("prompt_cache_retention")
+        @ExcludeMissing
+        fun _promptCacheRetention(): JsonField<PromptCacheRetention> = promptCacheRetention
+
+        /**
+         * Returns the raw JSON value of [reasoning].
+         *
+         * Unlike [reasoning], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("reasoning")
+        @ExcludeMissing
+        fun _reasoning(): JsonField<Reasoning> = reasoning
+
+        /**
+         * Returns the raw JSON value of [safetyIdentifier].
+         *
+         * Unlike [safetyIdentifier], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("safety_identifier")
+        @ExcludeMissing
+        fun _safetyIdentifier(): JsonField<String> = safetyIdentifier
+
+        /**
+         * Returns the raw JSON value of [serviceTier].
+         *
+         * Unlike [serviceTier], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("service_tier")
+        @ExcludeMissing
+        fun _serviceTier(): JsonField<ServiceTier> = serviceTier
+
+        /**
+         * Returns the raw JSON value of [store].
+         *
+         * Unlike [store], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("store") @ExcludeMissing fun _store(): JsonField<Boolean> = store
+
+        /**
+         * Returns the raw JSON value of [stream].
+         *
+         * Unlike [stream], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("stream") @ExcludeMissing fun _stream(): JsonField<Boolean> = stream
+
+        /**
+         * Returns the raw JSON value of [streamOptions].
+         *
+         * Unlike [streamOptions], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("stream_options")
+        @ExcludeMissing
+        fun _streamOptions(): JsonField<StreamOptions> = streamOptions
+
+        /**
+         * Returns the raw JSON value of [temperature].
+         *
+         * Unlike [temperature], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("temperature")
+        @ExcludeMissing
+        fun _temperature(): JsonField<Double> = temperature
+
+        /**
+         * Returns the raw JSON value of [text].
+         *
+         * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<BetaResponseTextConfig> = text
+
+        /**
+         * Returns the raw JSON value of [toolChoice].
+         *
+         * Unlike [toolChoice], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("tool_choice")
+        @ExcludeMissing
+        fun _toolChoice(): JsonField<ToolChoice> = toolChoice
+
+        /**
+         * Returns the raw JSON value of [tools].
+         *
+         * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<BetaTool>> = tools
+
+        /**
+         * Returns the raw JSON value of [topLogprobs].
+         *
+         * Unlike [topLogprobs], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("top_logprobs")
+        @ExcludeMissing
+        fun _topLogprobs(): JsonField<Long> = topLogprobs
+
+        /**
+         * Returns the raw JSON value of [topP].
+         *
+         * Unlike [topP], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("top_p") @ExcludeMissing fun _topP(): JsonField<Double> = topP
+
+        /**
+         * Returns the raw JSON value of [truncation].
+         *
+         * Unlike [truncation], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @Deprecated("deprecated")
+        @JsonProperty("truncation")
+        @ExcludeMissing
+        fun _truncation(): JsonField<Truncation> = truncation
+
+        /**
+         * Returns the raw JSON value of [user].
+         *
+         * Unlike [user], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @Deprecated("deprecated")
+        @JsonProperty("user")
+        @ExcludeMissing
+        fun _user(): JsonField<String> = user
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [ResponseCreate]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ResponseCreate]. */
+        class Builder internal constructor() {
+
+            private var type: JsonValue = JsonValue.from("response.create")
+            private var background: JsonField<Boolean> = JsonMissing.of()
+            private var contextManagement: JsonField<MutableList<ContextManagement>>? = null
+            private var conversation: JsonField<Conversation> = JsonMissing.of()
+            private var include: JsonField<MutableList<BetaResponseIncludable>>? = null
+            private var input: JsonField<Input> = JsonMissing.of()
+            private var instructions: JsonField<String> = JsonMissing.of()
+            private var maxOutputTokens: JsonField<Long> = JsonMissing.of()
+            private var maxToolCalls: JsonField<Long> = JsonMissing.of()
+            private var metadata: JsonField<Metadata> = JsonMissing.of()
+            private var model: JsonField<Model> = JsonMissing.of()
+            private var moderation: JsonField<Moderation> = JsonMissing.of()
+            private var multiAgent: JsonField<MultiAgent> = JsonMissing.of()
+            private var parallelToolCalls: JsonField<Boolean> = JsonMissing.of()
+            private var previousResponseId: JsonField<String> = JsonMissing.of()
+            private var prompt: JsonField<BetaResponsePrompt> = JsonMissing.of()
+            private var promptCacheKey: JsonField<String> = JsonMissing.of()
+            private var promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of()
+            private var promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of()
+            private var reasoning: JsonField<Reasoning> = JsonMissing.of()
+            private var safetyIdentifier: JsonField<String> = JsonMissing.of()
+            private var serviceTier: JsonField<ServiceTier> = JsonMissing.of()
+            private var store: JsonField<Boolean> = JsonMissing.of()
+            private var stream: JsonField<Boolean> = JsonMissing.of()
+            private var streamOptions: JsonField<StreamOptions> = JsonMissing.of()
+            private var temperature: JsonField<Double> = JsonMissing.of()
+            private var text: JsonField<BetaResponseTextConfig> = JsonMissing.of()
+            private var toolChoice: JsonField<ToolChoice> = JsonMissing.of()
+            private var tools: JsonField<MutableList<BetaTool>>? = null
+            private var topLogprobs: JsonField<Long> = JsonMissing.of()
+            private var topP: JsonField<Double> = JsonMissing.of()
+            private var truncation: JsonField<Truncation> = JsonMissing.of()
+            private var user: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(responseCreate: ResponseCreate) = apply {
+                type = responseCreate.type
+                background = responseCreate.background
+                contextManagement = responseCreate.contextManagement.map { it.toMutableList() }
+                conversation = responseCreate.conversation
+                include = responseCreate.include.map { it.toMutableList() }
+                input = responseCreate.input
+                instructions = responseCreate.instructions
+                maxOutputTokens = responseCreate.maxOutputTokens
+                maxToolCalls = responseCreate.maxToolCalls
+                metadata = responseCreate.metadata
+                model = responseCreate.model
+                moderation = responseCreate.moderation
+                multiAgent = responseCreate.multiAgent
+                parallelToolCalls = responseCreate.parallelToolCalls
+                previousResponseId = responseCreate.previousResponseId
+                prompt = responseCreate.prompt
+                promptCacheKey = responseCreate.promptCacheKey
+                promptCacheOptions = responseCreate.promptCacheOptions
+                promptCacheRetention = responseCreate.promptCacheRetention
+                reasoning = responseCreate.reasoning
+                safetyIdentifier = responseCreate.safetyIdentifier
+                serviceTier = responseCreate.serviceTier
+                store = responseCreate.store
+                stream = responseCreate.stream
+                streamOptions = responseCreate.streamOptions
+                temperature = responseCreate.temperature
+                text = responseCreate.text
+                toolChoice = responseCreate.toolChoice
+                tools = responseCreate.tools.map { it.toMutableList() }
+                topLogprobs = responseCreate.topLogprobs
+                topP = responseCreate.topP
+                truncation = responseCreate.truncation
+                user = responseCreate.user
+                additionalProperties = responseCreate.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("response.create")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /**
+             * Whether to run the model response in the background.
+             * [Learn more](https://platform.openai.com/docs/guides/background).
+             */
+            fun background(background: Boolean?) = background(JsonField.ofNullable(background))
+
+            /**
+             * Alias for [Builder.background].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun background(background: Boolean) = background(background as Boolean?)
+
+            /** Alias for calling [Builder.background] with `background.orElse(null)`. */
+            fun background(background: Optional<Boolean>) = background(background.getOrNull())
+
+            /**
+             * Sets [Builder.background] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.background] with a well-typed [Boolean] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun background(background: JsonField<Boolean>) = apply { this.background = background }
+
+            /** Context management configuration for this request. */
+            fun contextManagement(contextManagement: List<ContextManagement>?) =
+                contextManagement(JsonField.ofNullable(contextManagement))
+
+            /**
+             * Alias for calling [Builder.contextManagement] with `contextManagement.orElse(null)`.
+             */
+            fun contextManagement(contextManagement: Optional<List<ContextManagement>>) =
+                contextManagement(contextManagement.getOrNull())
+
+            /**
+             * Sets [Builder.contextManagement] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.contextManagement] with a well-typed
+             * `List<ContextManagement>` value instead. This method is primarily for setting the
+             * field to an undocumented or not yet supported value.
+             */
+            fun contextManagement(contextManagement: JsonField<List<ContextManagement>>) = apply {
+                this.contextManagement = contextManagement.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [ContextManagement] to [Builder.contextManagement].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addContextManagement(contextManagement: ContextManagement) = apply {
+                this.contextManagement =
+                    (this.contextManagement ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("contextManagement", it).add(contextManagement)
+                    }
+            }
+
+            /**
+             * The conversation that this response belongs to. Items from this conversation are
+             * prepended to `input_items` for this response request. Input items and output items
+             * from this response are automatically added to this conversation after this response
+             * completes.
+             */
+            fun conversation(conversation: Conversation?) =
+                conversation(JsonField.ofNullable(conversation))
+
+            /** Alias for calling [Builder.conversation] with `conversation.orElse(null)`. */
+            fun conversation(conversation: Optional<Conversation>) =
+                conversation(conversation.getOrNull())
+
+            /**
+             * Sets [Builder.conversation] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.conversation] with a well-typed [Conversation] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun conversation(conversation: JsonField<Conversation>) = apply {
+                this.conversation = conversation
+            }
+
+            /** Alias for calling [conversation] with `Conversation.ofId(id)`. */
+            fun conversation(id: String) = conversation(Conversation.ofId(id))
+
+            /**
+             * Alias for calling [conversation] with
+             * `Conversation.ofBetaResponseConversationParam(betaResponseConversationParam)`.
+             */
+            fun conversation(betaResponseConversationParam: BetaResponseConversationParam) =
+                conversation(
+                    Conversation.ofBetaResponseConversationParam(betaResponseConversationParam)
+                )
+
+            /**
+             * Specify additional output data to include in the model response. Currently supported
+             * values are:
+             * - `web_search_call.action.sources`: Include the sources of the web search tool call.
+             * - `code_interpreter_call.outputs`: Includes the outputs of python code execution in
+             *   code interpreter tool call items.
+             * - `computer_call_output.output.image_url`: Include image urls from the computer call
+             *   output.
+             * - `file_search_call.results`: Include the search results of the file search tool
+             *   call.
+             * - `message.input_image.image_url`: Include image urls from the input message.
+             * - `message.output_text.logprobs`: Include logprobs with assistant messages.
+             * - `reasoning.encrypted_content`: Includes an encrypted version of reasoning tokens in
+             *   reasoning item outputs. This enables reasoning items to be used in multi-turn
+             *   conversations when using the Responses API statelessly (like when the `store`
+             *   parameter is set to `false`, or when an organization is enrolled in the zero data
+             *   retention program).
+             */
+            fun include(include: List<BetaResponseIncludable>?) =
+                include(JsonField.ofNullable(include))
+
+            /** Alias for calling [Builder.include] with `include.orElse(null)`. */
+            fun include(include: Optional<List<BetaResponseIncludable>>) =
+                include(include.getOrNull())
+
+            /**
+             * Sets [Builder.include] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.include] with a well-typed
+             * `List<BetaResponseIncludable>` value instead. This method is primarily for setting
+             * the field to an undocumented or not yet supported value.
+             */
+            fun include(include: JsonField<List<BetaResponseIncludable>>) = apply {
+                this.include = include.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [BetaResponseIncludable] to [Builder.include].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addInclude(include: BetaResponseIncludable) = apply {
+                this.include =
+                    (this.include ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("include", it).add(include)
+                    }
+            }
+
+            /**
+             * Text, image, or file inputs to the model, used to generate a response.
+             *
+             * Learn more:
+             * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+             * - [Image inputs](https://platform.openai.com/docs/guides/images)
+             * - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
+             * - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
+             * - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+             */
+            fun input(input: Input) = input(JsonField.of(input))
+
+            /**
+             * Sets [Builder.input] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.input] with a well-typed [Input] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun input(input: JsonField<Input>) = apply { this.input = input }
+
+            /** Alias for calling [input] with `Input.ofText(text)`. */
+            fun input(text: String) = input(Input.ofText(text))
+
+            /** Alias for calling [input] with `Input.ofBetaResponse(betaResponse)`. */
+            fun inputOfBetaResponse(betaResponse: List<BetaResponseInputItem>) =
+                input(Input.ofBetaResponse(betaResponse))
+
+            /**
+             * A system (or developer) message inserted into the model's context.
+             *
+             * When using along with `previous_response_id`, the instructions from a previous
+             * response will not be carried over to the next response. This makes it simple to swap
+             * out system (or developer) messages in new responses.
+             */
+            fun instructions(instructions: String?) =
+                instructions(JsonField.ofNullable(instructions))
+
+            /** Alias for calling [Builder.instructions] with `instructions.orElse(null)`. */
+            fun instructions(instructions: Optional<String>) =
+                instructions(instructions.getOrNull())
+
+            /**
+             * Sets [Builder.instructions] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.instructions] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun instructions(instructions: JsonField<String>) = apply {
+                this.instructions = instructions
+            }
+
+            /**
+             * An upper bound for the number of tokens that can be generated for a response,
+             * including visible output tokens and
+             * [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
+             */
+            fun maxOutputTokens(maxOutputTokens: Long?) =
+                maxOutputTokens(JsonField.ofNullable(maxOutputTokens))
+
+            /**
+             * Alias for [Builder.maxOutputTokens].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun maxOutputTokens(maxOutputTokens: Long) = maxOutputTokens(maxOutputTokens as Long?)
+
+            /** Alias for calling [Builder.maxOutputTokens] with `maxOutputTokens.orElse(null)`. */
+            fun maxOutputTokens(maxOutputTokens: Optional<Long>) =
+                maxOutputTokens(maxOutputTokens.getOrNull())
+
+            /**
+             * Sets [Builder.maxOutputTokens] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.maxOutputTokens] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun maxOutputTokens(maxOutputTokens: JsonField<Long>) = apply {
+                this.maxOutputTokens = maxOutputTokens
+            }
+
+            /**
+             * The maximum number of total calls to built-in tools that can be processed in a
+             * response. This maximum number applies across all built-in tool calls, not per
+             * individual tool. Any further attempts to call a tool by the model will be ignored.
+             */
+            fun maxToolCalls(maxToolCalls: Long?) = maxToolCalls(JsonField.ofNullable(maxToolCalls))
+
+            /**
+             * Alias for [Builder.maxToolCalls].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun maxToolCalls(maxToolCalls: Long) = maxToolCalls(maxToolCalls as Long?)
+
+            /** Alias for calling [Builder.maxToolCalls] with `maxToolCalls.orElse(null)`. */
+            fun maxToolCalls(maxToolCalls: Optional<Long>) = maxToolCalls(maxToolCalls.getOrNull())
+
+            /**
+             * Sets [Builder.maxToolCalls] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.maxToolCalls] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun maxToolCalls(maxToolCalls: JsonField<Long>) = apply {
+                this.maxToolCalls = maxToolCalls
+            }
+
+            /**
+             * Set of 16 key-value pairs that can be attached to an object. This can be useful for
+             * storing additional information about the object in a structured format, and querying
+             * for objects via API or the dashboard.
+             *
+             * Keys are strings with a maximum length of 64 characters. Values are strings with a
+             * maximum length of 512 characters.
+             */
+            fun metadata(metadata: Metadata?) = metadata(JsonField.ofNullable(metadata))
+
+            /** Alias for calling [Builder.metadata] with `metadata.orElse(null)`. */
+            fun metadata(metadata: Optional<Metadata>) = metadata(metadata.getOrNull())
+
+            /**
+             * Sets [Builder.metadata] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.metadata] with a well-typed [Metadata] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun metadata(metadata: JsonField<Metadata>) = apply { this.metadata = metadata }
+
+            /**
+             * Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide
+             * range of models with different capabilities, performance characteristics, and price
+             * points. Refer to the [model guide](https://platform.openai.com/docs/models) to browse
+             * and compare available models.
+             */
+            fun model(model: Model) = model(JsonField.of(model))
+
+            /**
+             * Sets [Builder.model] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.model] with a well-typed [Model] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun model(model: JsonField<Model>) = apply { this.model = model }
+
+            /**
+             * Sets [model] to an arbitrary [String].
+             *
+             * You should usually call [model] with a well-typed [Model] constant instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun model(value: String) = model(Model.of(value))
+
+            /** Configuration for running moderation on the input and output of this response. */
+            fun moderation(moderation: Moderation?) = moderation(JsonField.ofNullable(moderation))
+
+            /** Alias for calling [Builder.moderation] with `moderation.orElse(null)`. */
+            fun moderation(moderation: Optional<Moderation>) = moderation(moderation.getOrNull())
+
+            /**
+             * Sets [Builder.moderation] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.moderation] with a well-typed [Moderation] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun moderation(moderation: JsonField<Moderation>) = apply {
+                this.moderation = moderation
+            }
+
+            /** Configuration for server-hosted multi-agent execution. */
+            fun multiAgent(multiAgent: MultiAgent?) = multiAgent(JsonField.ofNullable(multiAgent))
+
+            /** Alias for calling [Builder.multiAgent] with `multiAgent.orElse(null)`. */
+            fun multiAgent(multiAgent: Optional<MultiAgent>) = multiAgent(multiAgent.getOrNull())
+
+            /**
+             * Sets [Builder.multiAgent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.multiAgent] with a well-typed [MultiAgent] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun multiAgent(multiAgent: JsonField<MultiAgent>) = apply {
+                this.multiAgent = multiAgent
+            }
+
+            /** Whether to allow the model to run tool calls in parallel. */
+            fun parallelToolCalls(parallelToolCalls: Boolean?) =
+                parallelToolCalls(JsonField.ofNullable(parallelToolCalls))
+
+            /**
+             * Alias for [Builder.parallelToolCalls].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun parallelToolCalls(parallelToolCalls: Boolean) =
+                parallelToolCalls(parallelToolCalls as Boolean?)
+
+            /**
+             * Alias for calling [Builder.parallelToolCalls] with `parallelToolCalls.orElse(null)`.
+             */
+            fun parallelToolCalls(parallelToolCalls: Optional<Boolean>) =
+                parallelToolCalls(parallelToolCalls.getOrNull())
+
+            /**
+             * Sets [Builder.parallelToolCalls] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.parallelToolCalls] with a well-typed [Boolean] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun parallelToolCalls(parallelToolCalls: JsonField<Boolean>) = apply {
+                this.parallelToolCalls = parallelToolCalls
+            }
+
+            /**
+             * The unique ID of the previous response to the model. Use this to create multi-turn
+             * conversations. Learn more about
+             * [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+             * Cannot be used in conjunction with `conversation`.
+             */
+            fun previousResponseId(previousResponseId: String?) =
+                previousResponseId(JsonField.ofNullable(previousResponseId))
+
+            /**
+             * Alias for calling [Builder.previousResponseId] with
+             * `previousResponseId.orElse(null)`.
+             */
+            fun previousResponseId(previousResponseId: Optional<String>) =
+                previousResponseId(previousResponseId.getOrNull())
+
+            /**
+             * Sets [Builder.previousResponseId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.previousResponseId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun previousResponseId(previousResponseId: JsonField<String>) = apply {
+                this.previousResponseId = previousResponseId
+            }
+
+            /**
+             * Reference to a prompt template and its variables.
+             * [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+             */
+            fun prompt(prompt: BetaResponsePrompt?) = prompt(JsonField.ofNullable(prompt))
+
+            /** Alias for calling [Builder.prompt] with `prompt.orElse(null)`. */
+            fun prompt(prompt: Optional<BetaResponsePrompt>) = prompt(prompt.getOrNull())
+
+            /**
+             * Sets [Builder.prompt] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.prompt] with a well-typed [BetaResponsePrompt] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun prompt(prompt: JsonField<BetaResponsePrompt>) = apply { this.prompt = prompt }
+
+            /**
+             * Used by OpenAI to cache responses for similar requests to optimize your cache hit
+             * rates. Replaces the `user` field.
+             * [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+             */
+            fun promptCacheKey(promptCacheKey: String) =
+                promptCacheKey(JsonField.of(promptCacheKey))
+
+            /**
+             * Sets [Builder.promptCacheKey] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.promptCacheKey] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun promptCacheKey(promptCacheKey: JsonField<String>) = apply {
+                this.promptCacheKey = promptCacheKey
+            }
+
+            /**
+             * Options for prompt caching. Supported for `gpt-5.6` and later models. By default,
+             * OpenAI automatically chooses one implicit cache breakpoint. You can add explicit
+             * breakpoints to content blocks with `prompt_cache_breakpoint`. Each request can write
+             * up to four breakpoints. For cache matching, OpenAI considers up to the latest 80
+             * breakpoints in the conversation, without a content-block lookback limit. Set `mode`
+             * to `explicit` to disable the implicit breakpoint. The `ttl` defaults to `30m`, which
+             * is currently the only supported value. See the
+             * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+             * current details.
+             */
+            fun promptCacheOptions(promptCacheOptions: PromptCacheOptions) =
+                promptCacheOptions(JsonField.of(promptCacheOptions))
+
+            /**
+             * Sets [Builder.promptCacheOptions] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.promptCacheOptions] with a well-typed
+             * [PromptCacheOptions] value instead. This method is primarily for setting the field to
+             * an undocumented or not yet supported value.
+             */
+            fun promptCacheOptions(promptCacheOptions: JsonField<PromptCacheOptions>) = apply {
+                this.promptCacheOptions = promptCacheOptions
+            }
+
+            /**
+             * Deprecated. Use `prompt_cache_options.ttl` instead.
+             *
+             * The retention policy for the prompt cache. Set to `24h` to enable extended prompt
+             * caching, which keeps cached prefixes active for longer, up to a maximum of 24 hours.
+             * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+             * This field expresses a maximum retention policy, while `prompt_cache_options.ttl`
+             * expresses a minimum cache lifetime. The two fields are independent and do not
+             * interact. For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+             *
+             * For older models that support both `in_memory` and `24h`, the default depends on your
+             * organization's data retention policy:
+             * - Organizations without ZDR enabled default to `24h`.
+             * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention`
+             *   is not specified.
+             */
+            @Deprecated("deprecated")
+            fun promptCacheRetention(promptCacheRetention: PromptCacheRetention?) =
+                promptCacheRetention(JsonField.ofNullable(promptCacheRetention))
+
+            /**
+             * Alias for calling [Builder.promptCacheRetention] with
+             * `promptCacheRetention.orElse(null)`.
+             */
+            @Deprecated("deprecated")
+            fun promptCacheRetention(promptCacheRetention: Optional<PromptCacheRetention>) =
+                promptCacheRetention(promptCacheRetention.getOrNull())
+
+            /**
+             * Sets [Builder.promptCacheRetention] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.promptCacheRetention] with a well-typed
+             * [PromptCacheRetention] value instead. This method is primarily for setting the field
+             * to an undocumented or not yet supported value.
+             */
+            @Deprecated("deprecated")
+            fun promptCacheRetention(promptCacheRetention: JsonField<PromptCacheRetention>) =
+                apply {
+                    this.promptCacheRetention = promptCacheRetention
+                }
+
+            /**
+             * **gpt-5 and o-series models only**
+             *
+             * Configuration options for
+             * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+             */
+            fun reasoning(reasoning: Reasoning?) = reasoning(JsonField.ofNullable(reasoning))
+
+            /** Alias for calling [Builder.reasoning] with `reasoning.orElse(null)`. */
+            fun reasoning(reasoning: Optional<Reasoning>) = reasoning(reasoning.getOrNull())
+
+            /**
+             * Sets [Builder.reasoning] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.reasoning] with a well-typed [Reasoning] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun reasoning(reasoning: JsonField<Reasoning>) = apply { this.reasoning = reasoning }
+
+            /**
+             * A stable identifier used to help detect users of your application that may be
+             * violating OpenAI's usage policies. The IDs should be a string that uniquely
+             * identifies each user, with a maximum length of 64 characters. We recommend hashing
+             * their username or email address, in order to avoid sending us any identifying
+             * information.
+             * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+             */
+            fun safetyIdentifier(safetyIdentifier: String) =
+                safetyIdentifier(JsonField.of(safetyIdentifier))
+
+            /**
+             * Sets [Builder.safetyIdentifier] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.safetyIdentifier] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun safetyIdentifier(safetyIdentifier: JsonField<String>) = apply {
+                this.safetyIdentifier = safetyIdentifier
+            }
+
+            /**
+             * Specifies the processing type used for serving the request.
+             * - If set to 'auto', then the request will be processed with the service tier
+             *   configured in the Project settings. Unless otherwise configured, the Project will
+             *   use 'default'.
+             * - If set to 'default', then the request will be processed with the standard pricing
+             *   and performance for the selected model.
+             * - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
+             *   '[priority](https://openai.com/api-priority-processing/)', then the request will be
+             *   processed with the corresponding service tier.
+             * - When not set, the default behavior is 'auto'.
+             *
+             *   When the `service_tier` parameter is set, the response body will include the
+             *   `service_tier` value based on the processing mode actually used to serve the
+             *   request. This response value may be different from the value set in the parameter.
+             */
+            fun serviceTier(serviceTier: ServiceTier?) =
+                serviceTier(JsonField.ofNullable(serviceTier))
+
+            /** Alias for calling [Builder.serviceTier] with `serviceTier.orElse(null)`. */
+            fun serviceTier(serviceTier: Optional<ServiceTier>) =
+                serviceTier(serviceTier.getOrNull())
+
+            /**
+             * Sets [Builder.serviceTier] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serviceTier] with a well-typed [ServiceTier] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun serviceTier(serviceTier: JsonField<ServiceTier>) = apply {
+                this.serviceTier = serviceTier
+            }
+
+            /** Whether to store the generated model response for later retrieval via API. */
+            fun store(store: Boolean?) = store(JsonField.ofNullable(store))
+
+            /**
+             * Alias for [Builder.store].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun store(store: Boolean) = store(store as Boolean?)
+
+            /** Alias for calling [Builder.store] with `store.orElse(null)`. */
+            fun store(store: Optional<Boolean>) = store(store.getOrNull())
+
+            /**
+             * Sets [Builder.store] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.store] with a well-typed [Boolean] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun store(store: JsonField<Boolean>) = apply { this.store = store }
+
+            /**
+             * If set to true, the model response data will be streamed to the client as it is
+             * generated using
+             * [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events#Event_stream_format).
+             * See the
+             * [Streaming section below](https://platform.openai.com/docs/api-reference/responses-streaming)
+             * for more information.
+             */
+            fun stream(stream: Boolean?) = stream(JsonField.ofNullable(stream))
+
+            /**
+             * Alias for [Builder.stream].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun stream(stream: Boolean) = stream(stream as Boolean?)
+
+            /** Alias for calling [Builder.stream] with `stream.orElse(null)`. */
+            fun stream(stream: Optional<Boolean>) = stream(stream.getOrNull())
+
+            /**
+             * Sets [Builder.stream] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.stream] with a well-typed [Boolean] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun stream(stream: JsonField<Boolean>) = apply { this.stream = stream }
+
+            /** Options for streaming responses. Only set this when you set `stream: true`. */
+            fun streamOptions(streamOptions: StreamOptions?) =
+                streamOptions(JsonField.ofNullable(streamOptions))
+
+            /** Alias for calling [Builder.streamOptions] with `streamOptions.orElse(null)`. */
+            fun streamOptions(streamOptions: Optional<StreamOptions>) =
+                streamOptions(streamOptions.getOrNull())
+
+            /**
+             * Sets [Builder.streamOptions] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.streamOptions] with a well-typed [StreamOptions]
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            fun streamOptions(streamOptions: JsonField<StreamOptions>) = apply {
+                this.streamOptions = streamOptions
+            }
+
+            /**
+             * What sampling temperature to use, between 0 and 2. Higher values like 0.8 will make
+             * the output more random, while lower values like 0.2 will make it more focused and
+             * deterministic. We generally recommend altering this or `top_p` but not both.
+             */
+            fun temperature(temperature: Double?) = temperature(JsonField.ofNullable(temperature))
+
+            /**
+             * Alias for [Builder.temperature].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun temperature(temperature: Double) = temperature(temperature as Double?)
+
+            /** Alias for calling [Builder.temperature] with `temperature.orElse(null)`. */
+            fun temperature(temperature: Optional<Double>) = temperature(temperature.getOrNull())
+
+            /**
+             * Sets [Builder.temperature] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.temperature] with a well-typed [Double] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun temperature(temperature: JsonField<Double>) = apply {
+                this.temperature = temperature
+            }
+
+            /**
+             * Configuration options for a text response from the model. Can be plain text or
+             * structured JSON data. Learn more:
+             * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+             * - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+             */
+            fun text(text: BetaResponseTextConfig) = text(JsonField.of(text))
+
+            /**
+             * Sets [Builder.text] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.text] with a well-typed [BetaResponseTextConfig]
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            fun text(text: JsonField<BetaResponseTextConfig>) = apply { this.text = text }
+
+            /**
+             * How the model should select which tool (or tools) to use when generating a response.
+             * See the `tools` parameter to see how to specify which tools the model can call.
+             */
+            fun toolChoice(toolChoice: ToolChoice) = toolChoice(JsonField.of(toolChoice))
+
+            /**
+             * Sets [Builder.toolChoice] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.toolChoice] with a well-typed [ToolChoice] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun toolChoice(toolChoice: JsonField<ToolChoice>) = apply {
+                this.toolChoice = toolChoice
+            }
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceOptions(betaToolChoiceOptions)`.
+             */
+            fun toolChoice(betaToolChoiceOptions: BetaToolChoiceOptions) =
+                toolChoice(ToolChoice.ofBetaToolChoiceOptions(betaToolChoiceOptions))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceAllowed(betaToolChoiceAllowed)`.
+             */
+            fun toolChoice(betaToolChoiceAllowed: BetaToolChoiceAllowed) =
+                toolChoice(ToolChoice.ofBetaToolChoiceAllowed(betaToolChoiceAllowed))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceTypes(betaToolChoiceTypes)`.
+             */
+            fun toolChoice(betaToolChoiceTypes: BetaToolChoiceTypes) =
+                toolChoice(ToolChoice.ofBetaToolChoiceTypes(betaToolChoiceTypes))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceFunction(betaToolChoiceFunction)`.
+             */
+            fun toolChoice(betaToolChoiceFunction: BetaToolChoiceFunction) =
+                toolChoice(ToolChoice.ofBetaToolChoiceFunction(betaToolChoiceFunction))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceMcp(betaToolChoiceMcp)`.
+             */
+            fun toolChoice(betaToolChoiceMcp: BetaToolChoiceMcp) =
+                toolChoice(ToolChoice.ofBetaToolChoiceMcp(betaToolChoiceMcp))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceCustom(betaToolChoiceCustom)`.
+             */
+            fun toolChoice(betaToolChoiceCustom: BetaToolChoiceCustom) =
+                toolChoice(ToolChoice.ofBetaToolChoiceCustom(betaToolChoiceCustom))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaSpecificProgrammaticToolCallingParam()`.
+             */
+            fun toolChoiceBetaSpecificProgrammaticToolCallingParam() =
+                toolChoice(ToolChoice.ofBetaSpecificProgrammaticToolCallingParam())
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch)`.
+             */
+            fun toolChoice(betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch) =
+                toolChoice(ToolChoice.ofBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceShell(betaToolChoiceShell)`.
+             */
+            fun toolChoice(betaToolChoiceShell: BetaToolChoiceShell) =
+                toolChoice(ToolChoice.ofBetaToolChoiceShell(betaToolChoiceShell))
+
+            /**
+             * An array of tools the model may call while generating a response. You can specify
+             * which tool to use by setting the `tool_choice` parameter.
+             *
+             * We support the following categories of tools:
+             * - **Built-in tools**: Tools that are provided by OpenAI that extend the model's
+             *   capabilities, like
+             *   [web search](https://platform.openai.com/docs/guides/tools-web-search) or
+             *   [file search](https://platform.openai.com/docs/guides/tools-file-search). Learn
+             *   more about [built-in tools](https://platform.openai.com/docs/guides/tools).
+             * - **MCP Tools**: Integrations with third-party systems via custom MCP servers or
+             *   predefined connectors such as Google Drive and SharePoint. Learn more about
+             *   [MCP Tools](https://platform.openai.com/docs/guides/tools-connectors-mcp).
+             * - **Function calls (custom tools)**: Functions that are defined by you, enabling the
+             *   model to call your own code with strongly typed arguments and outputs. Learn more
+             *   about [function calling](https://platform.openai.com/docs/guides/function-calling).
+             *   You can also use custom tools to call your own code.
+             */
+            fun tools(tools: List<BetaTool>) = tools(JsonField.of(tools))
+
+            /**
+             * Sets [Builder.tools] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.tools] with a well-typed `List<BetaTool>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun tools(tools: JsonField<List<BetaTool>>) = apply {
+                this.tools = tools.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [BetaTool] to [tools].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addTool(tool: BetaTool) = apply {
+                tools =
+                    (tools ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("tools", it).add(tool)
+                    }
+            }
+
+            /** Alias for calling [addTool] with `BetaTool.ofFunction(function)`. */
+            fun addTool(function: BetaFunctionTool) = addTool(BetaTool.ofFunction(function))
+
+            /** Alias for calling [addTool] with `BetaTool.ofFileSearch(fileSearch)`. */
+            fun addTool(fileSearch: BetaFileSearchTool) = addTool(BetaTool.ofFileSearch(fileSearch))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaFileSearchTool.builder()
+             *     .vectorStoreIds(vectorStoreIds)
+             *     .build()
+             * ```
+             */
+            fun addFileSearchTool(vectorStoreIds: List<String>) =
+                addTool(BetaFileSearchTool.builder().vectorStoreIds(vectorStoreIds).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofComputer(computer)`. */
+            fun addTool(computer: BetaComputerTool) = addTool(BetaTool.ofComputer(computer))
+
+            /**
+             * Alias for calling [addTool] with `BetaTool.ofComputerUsePreview(computerUsePreview)`.
+             */
+            fun addTool(computerUsePreview: BetaComputerUsePreviewTool) =
+                addTool(BetaTool.ofComputerUsePreview(computerUsePreview))
+
+            /** Alias for calling [addTool] with `BetaTool.ofWebSearch(webSearch)`. */
+            fun addTool(webSearch: BetaWebSearchTool) = addTool(BetaTool.ofWebSearch(webSearch))
+
+            /** Alias for calling [addTool] with `BetaTool.ofMcp(mcp)`. */
+            fun addTool(mcp: BetaTool.Mcp) = addTool(BetaTool.ofMcp(mcp))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaTool.Mcp.builder()
+             *     .serverLabel(serverLabel)
+             *     .build()
+             * ```
+             */
+            fun addMcpTool(serverLabel: String) =
+                addTool(BetaTool.Mcp.builder().serverLabel(serverLabel).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofCodeInterpreter(codeInterpreter)`. */
+            fun addTool(codeInterpreter: BetaTool.CodeInterpreter) =
+                addTool(BetaTool.ofCodeInterpreter(codeInterpreter))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaTool.CodeInterpreter.builder()
+             *     .container(container)
+             *     .build()
+             * ```
+             */
+            fun addCodeInterpreterTool(container: BetaTool.CodeInterpreter.Container) =
+                addTool(BetaTool.CodeInterpreter.builder().container(container).build())
+
+            /**
+             * Alias for calling [addCodeInterpreterTool] with
+             * `BetaTool.CodeInterpreter.Container.ofString(string)`.
+             */
+            fun addCodeInterpreterTool(string: String) =
+                addCodeInterpreterTool(BetaTool.CodeInterpreter.Container.ofString(string))
+
+            /**
+             * Alias for calling [addCodeInterpreterTool] with
+             * `BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)`.
+             */
+            fun addCodeInterpreterTool(
+                codeInterpreterToolAuto: BetaTool.CodeInterpreter.Container.CodeInterpreterToolAuto
+            ) =
+                addCodeInterpreterTool(
+                    BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(
+                        codeInterpreterToolAuto
+                    )
+                )
+
+            /** Alias for calling [addTool] with `BetaTool.ofProgrammaticToolCalling()`. */
+            fun addToolProgrammaticToolCalling() = addTool(BetaTool.ofProgrammaticToolCalling())
+
+            /** Alias for calling [addTool] with `BetaTool.ofImageGeneration(imageGeneration)`. */
+            fun addTool(imageGeneration: BetaTool.ImageGeneration) =
+                addTool(BetaTool.ofImageGeneration(imageGeneration))
+
+            /** Alias for calling [addTool] with `BetaTool.ofLocalShell()`. */
+            fun addToolLocalShell() = addTool(BetaTool.ofLocalShell())
+
+            /** Alias for calling [addTool] with `BetaTool.ofShell(shell)`. */
+            fun addTool(shell: BetaFunctionShellTool) = addTool(BetaTool.ofShell(shell))
+
+            /** Alias for calling [addTool] with `BetaTool.ofCustom(custom)`. */
+            fun addTool(custom: BetaCustomTool) = addTool(BetaTool.ofCustom(custom))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaCustomTool.builder()
+             *     .name(name)
+             *     .build()
+             * ```
+             */
+            fun addCustomTool(name: String) = addTool(BetaCustomTool.builder().name(name).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofNamespace(namespace)`. */
+            fun addTool(namespace: BetaNamespaceTool) = addTool(BetaTool.ofNamespace(namespace))
+
+            /** Alias for calling [addTool] with `BetaTool.ofToolSearch(toolSearch)`. */
+            fun addTool(toolSearch: BetaToolSearchTool) = addTool(BetaTool.ofToolSearch(toolSearch))
+
+            /** Alias for calling [addTool] with `BetaTool.ofWebSearchPreview(webSearchPreview)`. */
+            fun addTool(webSearchPreview: BetaWebSearchPreviewTool) =
+                addTool(BetaTool.ofWebSearchPreview(webSearchPreview))
+
+            /** Alias for calling [addTool] with `BetaTool.ofApplyPatch(applyPatch)`. */
+            fun addTool(applyPatch: BetaApplyPatchTool) = addTool(BetaTool.ofApplyPatch(applyPatch))
+
+            /**
+             * An integer between 0 and 20 specifying the maximum number of most likely tokens to
+             * return at each token position, each with an associated log probability. In some
+             * cases, the number of returned tokens may be fewer than requested.
+             */
+            fun topLogprobs(topLogprobs: Long?) = topLogprobs(JsonField.ofNullable(topLogprobs))
+
+            /**
+             * Alias for [Builder.topLogprobs].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun topLogprobs(topLogprobs: Long) = topLogprobs(topLogprobs as Long?)
+
+            /** Alias for calling [Builder.topLogprobs] with `topLogprobs.orElse(null)`. */
+            fun topLogprobs(topLogprobs: Optional<Long>) = topLogprobs(topLogprobs.getOrNull())
+
+            /**
+             * Sets [Builder.topLogprobs] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.topLogprobs] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun topLogprobs(topLogprobs: JsonField<Long>) = apply { this.topLogprobs = topLogprobs }
+
+            /**
+             * An alternative to sampling with temperature, called nucleus sampling, where the model
+             * considers the results of the tokens with top_p probability mass. So 0.1 means only
+             * the tokens comprising the top 10% probability mass are considered.
+             *
+             * We generally recommend altering this or `temperature` but not both.
+             */
+            fun topP(topP: Double?) = topP(JsonField.ofNullable(topP))
+
+            /**
+             * Alias for [Builder.topP].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun topP(topP: Double) = topP(topP as Double?)
+
+            /** Alias for calling [Builder.topP] with `topP.orElse(null)`. */
+            fun topP(topP: Optional<Double>) = topP(topP.getOrNull())
+
+            /**
+             * Sets [Builder.topP] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.topP] with a well-typed [Double] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun topP(topP: JsonField<Double>) = apply { this.topP = topP }
+
+            /**
+             * The truncation strategy to use for the model response.
+             * - `auto`: If the input to this Response exceeds the model's context window size, the
+             *   model will truncate the response to fit the context window by dropping items from
+             *   the beginning of the conversation.
+             * - `disabled` (default): If the input size will exceed the context window size for a
+             *   model, the request will fail with a 400 error.
+             */
+            @Deprecated("deprecated")
+            fun truncation(truncation: Truncation?) = truncation(JsonField.ofNullable(truncation))
+
+            /** Alias for calling [Builder.truncation] with `truncation.orElse(null)`. */
+            @Deprecated("deprecated")
+            fun truncation(truncation: Optional<Truncation>) = truncation(truncation.getOrNull())
+
+            /**
+             * Sets [Builder.truncation] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.truncation] with a well-typed [Truncation] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            @Deprecated("deprecated")
+            fun truncation(truncation: JsonField<Truncation>) = apply {
+                this.truncation = truncation
+            }
+
+            /**
+             * This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+             * `prompt_cache_key` instead to maintain caching optimizations. 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#safety-identifiers).
+             */
+            @Deprecated("deprecated") fun user(user: String) = user(JsonField.of(user))
+
+            /**
+             * Sets [Builder.user] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.user] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            @Deprecated("deprecated") fun user(user: JsonField<String>) = apply { this.user = user }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ResponseCreate].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): ResponseCreate =
+                ResponseCreate(
+                    type,
+                    background,
+                    (contextManagement ?: JsonMissing.of()).map { it.toImmutable() },
+                    conversation,
+                    (include ?: JsonMissing.of()).map { it.toImmutable() },
+                    input,
+                    instructions,
+                    maxOutputTokens,
+                    maxToolCalls,
+                    metadata,
+                    model,
+                    moderation,
+                    multiAgent,
+                    parallelToolCalls,
+                    previousResponseId,
+                    prompt,
+                    promptCacheKey,
+                    promptCacheOptions,
+                    promptCacheRetention,
+                    reasoning,
+                    safetyIdentifier,
+                    serviceTier,
+                    store,
+                    stream,
+                    streamOptions,
+                    temperature,
+                    text,
+                    toolChoice,
+                    (tools ?: JsonMissing.of()).map { it.toImmutable() },
+                    topLogprobs,
+                    topP,
+                    truncation,
+                    user,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ResponseCreate = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _type().let {
+                if (it != JsonValue.from("response.create")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            background()
+            contextManagement().ifPresent { it.forEach { it.validate() } }
+            conversation().ifPresent { it.validate() }
+            include().ifPresent { it.forEach { it.validate() } }
+            input().ifPresent { it.validate() }
+            instructions()
+            maxOutputTokens()
+            maxToolCalls()
+            metadata().ifPresent { it.validate() }
+            model()
+            moderation().ifPresent { it.validate() }
+            multiAgent().ifPresent { it.validate() }
+            parallelToolCalls()
+            previousResponseId()
+            prompt().ifPresent { it.validate() }
+            promptCacheKey()
+            promptCacheOptions().ifPresent { it.validate() }
+            promptCacheRetention().ifPresent { it.validate() }
+            reasoning().ifPresent { it.validate() }
+            safetyIdentifier()
+            serviceTier().ifPresent { it.validate() }
+            store()
+            stream()
+            streamOptions().ifPresent { it.validate() }
+            temperature()
+            text().ifPresent { it.validate() }
+            toolChoice().ifPresent { it.validate() }
+            tools().ifPresent { it.forEach { it.validate() } }
+            topLogprobs()
+            topP()
+            truncation().ifPresent { it.validate() }
+            user()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            type.let { if (it == JsonValue.from("response.create")) 1 else 0 } +
+                (if (background.asKnown().isPresent) 1 else 0) +
+                (contextManagement.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (conversation.asKnown().getOrNull()?.validity() ?: 0) +
+                (include.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (input.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (instructions.asKnown().isPresent) 1 else 0) +
+                (if (maxOutputTokens.asKnown().isPresent) 1 else 0) +
+                (if (maxToolCalls.asKnown().isPresent) 1 else 0) +
+                (metadata.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (model.asKnown().isPresent) 1 else 0) +
+                (moderation.asKnown().getOrNull()?.validity() ?: 0) +
+                (multiAgent.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (parallelToolCalls.asKnown().isPresent) 1 else 0) +
+                (if (previousResponseId.asKnown().isPresent) 1 else 0) +
+                (prompt.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (promptCacheKey.asKnown().isPresent) 1 else 0) +
+                (promptCacheOptions.asKnown().getOrNull()?.validity() ?: 0) +
+                (promptCacheRetention.asKnown().getOrNull()?.validity() ?: 0) +
+                (reasoning.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (safetyIdentifier.asKnown().isPresent) 1 else 0) +
+                (serviceTier.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (store.asKnown().isPresent) 1 else 0) +
+                (if (stream.asKnown().isPresent) 1 else 0) +
+                (streamOptions.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (temperature.asKnown().isPresent) 1 else 0) +
+                (text.asKnown().getOrNull()?.validity() ?: 0) +
+                (toolChoice.asKnown().getOrNull()?.validity() ?: 0) +
+                (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (if (topLogprobs.asKnown().isPresent) 1 else 0) +
+                (if (topP.asKnown().isPresent) 1 else 0) +
+                (truncation.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (user.asKnown().isPresent) 1 else 0)
+
+        class ContextManagement
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val type: JsonField<String>,
+            private val compactThreshold: JsonField<Long>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("type") @ExcludeMissing type: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("compact_threshold")
+                @ExcludeMissing
+                compactThreshold: JsonField<Long> = JsonMissing.of(),
+            ) : this(type, compactThreshold, mutableMapOf())
+
+            /**
+             * The context management entry type. Currently only 'compaction' is supported.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun type(): String = type.getRequired("type")
+
+            /**
+             * Token threshold at which compaction should be triggered for this entry.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun compactThreshold(): Optional<Long> =
+                compactThreshold.getOptional("compact_threshold")
+
+            /**
+             * Returns the raw JSON value of [type].
+             *
+             * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<String> = type
+
+            /**
+             * Returns the raw JSON value of [compactThreshold].
+             *
+             * Unlike [compactThreshold], this method doesn't throw if the JSON field has an
+             * unexpected type.
+             */
+            @JsonProperty("compact_threshold")
+            @ExcludeMissing
+            fun _compactThreshold(): JsonField<Long> = compactThreshold
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [ContextManagement].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .type()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [ContextManagement]. */
+            class Builder internal constructor() {
+
+                private var type: JsonField<String>? = null
+                private var compactThreshold: JsonField<Long> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(contextManagement: ContextManagement) = apply {
+                    type = contextManagement.type
+                    compactThreshold = contextManagement.compactThreshold
+                    additionalProperties = contextManagement.additionalProperties.toMutableMap()
+                }
+
+                /** The context management entry type. Currently only 'compaction' is supported. */
+                fun type(type: String) = type(JsonField.of(type))
+
+                /**
+                 * Sets [Builder.type] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.type] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonField<String>) = apply { this.type = type }
+
+                /** Token threshold at which compaction should be triggered for this entry. */
+                fun compactThreshold(compactThreshold: Long?) =
+                    compactThreshold(JsonField.ofNullable(compactThreshold))
+
+                /**
+                 * Alias for [Builder.compactThreshold].
+                 *
+                 * This unboxed primitive overload exists for backwards compatibility.
+                 */
+                fun compactThreshold(compactThreshold: Long) =
+                    compactThreshold(compactThreshold as Long?)
+
+                /**
+                 * Alias for calling [Builder.compactThreshold] with
+                 * `compactThreshold.orElse(null)`.
+                 */
+                fun compactThreshold(compactThreshold: Optional<Long>) =
+                    compactThreshold(compactThreshold.getOrNull())
+
+                /**
+                 * Sets [Builder.compactThreshold] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.compactThreshold] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun compactThreshold(compactThreshold: JsonField<Long>) = apply {
+                    this.compactThreshold = compactThreshold
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [ContextManagement].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .type()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): ContextManagement =
+                    ContextManagement(
+                        checkRequired("type", type),
+                        compactThreshold,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): ContextManagement = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                type()
+                compactThreshold()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (type.asKnown().isPresent) 1 else 0) +
+                    (if (compactThreshold.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is ContextManagement &&
+                    type == other.type &&
+                    compactThreshold == other.compactThreshold &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(type, compactThreshold, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "ContextManagement{type=$type, compactThreshold=$compactThreshold, additionalProperties=$additionalProperties}"
+        }
+
+        /**
+         * The conversation that this response belongs to. Items from this conversation are
+         * prepended to `input_items` for this response request. Input items and output items from
+         * this response are automatically added to this conversation after this response completes.
+         */
+        @JsonDeserialize(using = Conversation.Deserializer::class)
+        @JsonSerialize(using = Conversation.Serializer::class)
+        class Conversation
+        private constructor(
+            private val id: String? = null,
+            private val betaResponseConversationParam: BetaResponseConversationParam? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /** The unique ID of the conversation. */
+            fun id(): Optional<String> = Optional.ofNullable(id)
+
+            /** The conversation that this response belongs to. */
+            fun betaResponseConversationParam(): Optional<BetaResponseConversationParam> =
+                Optional.ofNullable(betaResponseConversationParam)
+
+            fun isId(): Boolean = id != null
+
+            fun isBetaResponseConversationParam(): Boolean = betaResponseConversationParam != null
+
+            /** The unique ID of the conversation. */
+            fun asId(): String = id.getOrThrow("id")
+
+            /** The conversation that this response belongs to. */
+            fun asBetaResponseConversationParam(): BetaResponseConversationParam =
+                betaResponseConversationParam.getOrThrow("betaResponseConversationParam")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = conversation.accept(new Conversation.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitId(String id) {
+             *         return Optional.of(id.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    id != null -> visitor.visitId(id)
+                    betaResponseConversationParam != null ->
+                        visitor.visitBetaResponseConversationParam(betaResponseConversationParam)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Conversation = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitId(id: String) {}
+
+                        override fun visitBetaResponseConversationParam(
+                            betaResponseConversationParam: BetaResponseConversationParam
+                        ) {
+                            betaResponseConversationParam.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitId(id: String) = 1
+
+                        override fun visitBetaResponseConversationParam(
+                            betaResponseConversationParam: BetaResponseConversationParam
+                        ) = betaResponseConversationParam.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Conversation &&
+                    id == other.id &&
+                    betaResponseConversationParam == other.betaResponseConversationParam
+            }
+
+            override fun hashCode(): Int = Objects.hash(id, betaResponseConversationParam)
+
+            override fun toString(): String =
+                when {
+                    id != null -> "Conversation{id=$id}"
+                    betaResponseConversationParam != null ->
+                        "Conversation{betaResponseConversationParam=$betaResponseConversationParam}"
+                    _json != null -> "Conversation{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Conversation")
+                }
+
+            companion object {
+
+                /** The unique ID of the conversation. */
+                @JvmStatic fun ofId(id: String) = Conversation(id = id)
+
+                /** The conversation that this response belongs to. */
+                @JvmStatic
+                fun ofBetaResponseConversationParam(
+                    betaResponseConversationParam: BetaResponseConversationParam
+                ) = Conversation(betaResponseConversationParam = betaResponseConversationParam)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Conversation] to a value of
+             * type [T].
+             */
+            interface Visitor<out T> {
+
+                /** The unique ID of the conversation. */
+                fun visitId(id: String): T
+
+                /** The conversation that this response belongs to. */
+                fun visitBetaResponseConversationParam(
+                    betaResponseConversationParam: BetaResponseConversationParam
+                ): T
+
+                /**
+                 * Maps an unknown variant of [Conversation] to a value of type [T].
+                 *
+                 * An instance of [Conversation] can contain an unknown variant if it was
+                 * deserialized from data that doesn't match any known variant. For example, if the
+                 * SDK is on an older version than the API, then the API may respond with new
+                 * variants that the SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Conversation: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Conversation>(Conversation::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Conversation {
+                    val json = JsonValue.fromJsonNode(node)
+
+                    val bestMatches =
+                        sequenceOf(
+                                tryDeserialize(
+                                        node,
+                                        jacksonTypeRef<BetaResponseConversationParam>(),
+                                    )
+                                    ?.let {
+                                        Conversation(
+                                            betaResponseConversationParam = it,
+                                            _json = json,
+                                        )
+                                    },
+                                tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                    Conversation(id = it, _json = json)
+                                },
+                            )
+                            .filterNotNull()
+                            .allMaxBy { it.validity() }
+                            .toList()
+                    return when (bestMatches.size) {
+                        // This can happen if what we're deserializing is completely incompatible
+                        // with all the possible variants (e.g. deserializing from boolean).
+                        0 -> Conversation(_json = json)
+                        1 -> bestMatches.single()
+                        // If there's more than one match with the highest validity, then use the
+                        // first completely valid match, or simply the first match if none are
+                        // completely valid.
+                        else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                    }
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Conversation>(Conversation::class) {
+
+                override fun serialize(
+                    value: Conversation,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.id != null -> generator.writeObject(value.id)
+                        value.betaResponseConversationParam != null ->
+                            generator.writeObject(value.betaResponseConversationParam)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Conversation")
+                    }
+                }
+            }
+        }
+
+        /**
+         * Text, image, or file inputs to the model, used to generate a response.
+         *
+         * Learn more:
+         * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+         * - [Image inputs](https://platform.openai.com/docs/guides/images)
+         * - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
+         * - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
+         * - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+         */
+        @JsonDeserialize(using = Input.Deserializer::class)
+        @JsonSerialize(using = Input.Serializer::class)
+        class Input
+        private constructor(
+            private val text: String? = null,
+            private val betaResponse: List<BetaResponseInputItem>? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /** A text input to the model, equivalent to a text input with the `user` role. */
+            fun text(): Optional<String> = Optional.ofNullable(text)
+
+            /**
+             * A list of one or many input items to the model, containing different content types.
+             */
+            fun betaResponse(): Optional<List<BetaResponseInputItem>> =
+                Optional.ofNullable(betaResponse)
+
+            fun isText(): Boolean = text != null
+
+            fun isBetaResponse(): Boolean = betaResponse != null
+
+            /** A text input to the model, equivalent to a text input with the `user` role. */
+            fun asText(): String = text.getOrThrow("text")
+
+            /**
+             * A list of one or many input items to the model, containing different content types.
+             */
+            fun asBetaResponse(): List<BetaResponseInputItem> =
+                betaResponse.getOrThrow("betaResponse")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = input.accept(new Input.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitText(String text) {
+             *         return Optional.of(text.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    text != null -> visitor.visitText(text)
+                    betaResponse != null -> visitor.visitBetaResponse(betaResponse)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Input = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitText(text: String) {}
+
+                        override fun visitBetaResponse(betaResponse: List<BetaResponseInputItem>) {
+                            betaResponse.forEach { it.validate() }
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitText(text: String) = 1
+
+                        override fun visitBetaResponse(betaResponse: List<BetaResponseInputItem>) =
+                            betaResponse.sumOf { it.validity().toInt() }
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Input && text == other.text && betaResponse == other.betaResponse
+            }
+
+            override fun hashCode(): Int = Objects.hash(text, betaResponse)
+
+            override fun toString(): String =
+                when {
+                    text != null -> "Input{text=$text}"
+                    betaResponse != null -> "Input{betaResponse=$betaResponse}"
+                    _json != null -> "Input{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Input")
+                }
+
+            companion object {
+
+                /** A text input to the model, equivalent to a text input with the `user` role. */
+                @JvmStatic fun ofText(text: String) = Input(text = text)
+
+                /**
+                 * A list of one or many input items to the model, containing different content
+                 * types.
+                 */
+                @JvmStatic
+                fun ofBetaResponse(betaResponse: List<BetaResponseInputItem>) =
+                    Input(betaResponse = betaResponse.toImmutable())
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Input] to a value of type [T].
+             */
+            interface Visitor<out T> {
+
+                /** A text input to the model, equivalent to a text input with the `user` role. */
+                fun visitText(text: String): T
+
+                /**
+                 * A list of one or many input items to the model, containing different content
+                 * types.
+                 */
+                fun visitBetaResponse(betaResponse: List<BetaResponseInputItem>): T
+
+                /**
+                 * Maps an unknown variant of [Input] to a value of type [T].
+                 *
+                 * An instance of [Input] can contain an unknown variant if it was deserialized from
+                 * data that doesn't match any known variant. For example, if the SDK is on an older
+                 * version than the API, then the API may respond with new variants that the SDK is
+                 * unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Input: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Input>(Input::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Input {
+                    val json = JsonValue.fromJsonNode(node)
+
+                    val bestMatches =
+                        sequenceOf(
+                                tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                    Input(text = it, _json = json)
+                                },
+                                tryDeserialize(node, jacksonTypeRef<List<BetaResponseInputItem>>())
+                                    ?.let { Input(betaResponse = it, _json = json) },
+                            )
+                            .filterNotNull()
+                            .allMaxBy { it.validity() }
+                            .toList()
+                    return when (bestMatches.size) {
+                        // This can happen if what we're deserializing is completely incompatible
+                        // with all the possible variants (e.g. deserializing from boolean).
+                        0 -> Input(_json = json)
+                        1 -> bestMatches.single()
+                        // If there's more than one match with the highest validity, then use the
+                        // first completely valid match, or simply the first match if none are
+                        // completely valid.
+                        else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                    }
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Input>(Input::class) {
+
+                override fun serialize(
+                    value: Input,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.text != null -> generator.writeObject(value.text)
+                        value.betaResponse != null -> generator.writeObject(value.betaResponse)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Input")
+                    }
+                }
+            }
+        }
+
+        /**
+         * Set of 16 key-value pairs that can be attached to an object. This can be useful for
+         * storing additional information about the object in a structured format, and querying for
+         * objects via API or the dashboard.
+         *
+         * Keys are strings with a maximum length of 64 characters. Values are strings with a
+         * maximum length of 512 characters.
+         */
+        class Metadata
+        @JsonCreator
+        private constructor(
+            @com.fasterxml.jackson.annotation.JsonValue
+            private val additionalProperties: Map<String, JsonValue>
+        ) {
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /** Returns a mutable builder for constructing an instance of [Metadata]. */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Metadata]. */
+            class Builder internal constructor() {
+
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(metadata: Metadata) = apply {
+                    additionalProperties = metadata.additionalProperties.toMutableMap()
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Metadata].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): Metadata = Metadata(additionalProperties.toImmutable())
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Metadata = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                additionalProperties.count { (_, value) -> !value.isNull() && !value.isMissing() }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Metadata && additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() = "Metadata{additionalProperties=$additionalProperties}"
+        }
+
+        /**
+         * Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide range
+         * of models with different capabilities, performance characteristics, and price points.
+         * Refer to the [model guide](https://platform.openai.com/docs/models) to browse and compare
+         * available models.
+         */
+        class Model @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val GPT_5_6_SOL = of("gpt-5.6-sol")
+
+                @JvmField val GPT_5_6_TERRA = of("gpt-5.6-terra")
+
+                @JvmField val GPT_5_6_LUNA = of("gpt-5.6-luna")
+
+                @JvmField val GPT_5_4 = of("gpt-5.4")
+
+                @JvmField val GPT_5_4_MINI = of("gpt-5.4-mini")
+
+                @JvmField val GPT_5_4_NANO = of("gpt-5.4-nano")
+
+                @JvmField val GPT_5_4_MINI_2026_03_17 = of("gpt-5.4-mini-2026-03-17")
+
+                @JvmField val GPT_5_4_NANO_2026_03_17 = of("gpt-5.4-nano-2026-03-17")
+
+                @JvmField val GPT_5_3_CHAT_LATEST = of("gpt-5.3-chat-latest")
+
+                @JvmField val GPT_5_2 = of("gpt-5.2")
+
+                @JvmField val GPT_5_2_2025_12_11 = of("gpt-5.2-2025-12-11")
+
+                @JvmField val GPT_5_2_CHAT_LATEST = of("gpt-5.2-chat-latest")
+
+                @JvmField val GPT_5_2_PRO = of("gpt-5.2-pro")
+
+                @JvmField val GPT_5_2_PRO_2025_12_11 = of("gpt-5.2-pro-2025-12-11")
+
+                @JvmField val GPT_5_1 = of("gpt-5.1")
+
+                @JvmField val GPT_5_1_2025_11_13 = of("gpt-5.1-2025-11-13")
+
+                @JvmField val GPT_5_1_CODEX = of("gpt-5.1-codex")
+
+                @JvmField val GPT_5_1_MINI = of("gpt-5.1-mini")
+
+                @JvmField val GPT_5_1_CHAT_LATEST = of("gpt-5.1-chat-latest")
+
+                @JvmField val GPT_5 = of("gpt-5")
+
+                @JvmField val GPT_5_MINI = of("gpt-5-mini")
+
+                @JvmField val GPT_5_NANO = of("gpt-5-nano")
+
+                @JvmField val GPT_5_2025_08_07 = of("gpt-5-2025-08-07")
+
+                @JvmField val GPT_5_MINI_2025_08_07 = of("gpt-5-mini-2025-08-07")
+
+                @JvmField val GPT_5_NANO_2025_08_07 = of("gpt-5-nano-2025-08-07")
+
+                @JvmField val GPT_5_CHAT_LATEST = of("gpt-5-chat-latest")
+
+                @JvmField val GPT_4_1 = of("gpt-4.1")
+
+                @JvmField val GPT_4_1_MINI = of("gpt-4.1-mini")
+
+                @JvmField val GPT_4_1_NANO = of("gpt-4.1-nano")
+
+                @JvmField val GPT_4_1_2025_04_14 = of("gpt-4.1-2025-04-14")
+
+                @JvmField val GPT_4_1_MINI_2025_04_14 = of("gpt-4.1-mini-2025-04-14")
+
+                @JvmField val GPT_4_1_NANO_2025_04_14 = of("gpt-4.1-nano-2025-04-14")
+
+                @JvmField val O4_MINI = of("o4-mini")
+
+                @JvmField val O4_MINI_2025_04_16 = of("o4-mini-2025-04-16")
+
+                @JvmField val O3 = of("o3")
+
+                @JvmField val O3_2025_04_16 = of("o3-2025-04-16")
+
+                @JvmField val O3_MINI = of("o3-mini")
+
+                @JvmField val O3_MINI_2025_01_31 = of("o3-mini-2025-01-31")
+
+                @JvmField val O1 = of("o1")
+
+                @JvmField val O1_2024_12_17 = of("o1-2024-12-17")
+
+                @JvmField val O1_PREVIEW = of("o1-preview")
+
+                @JvmField val O1_PREVIEW_2024_09_12 = of("o1-preview-2024-09-12")
+
+                @JvmField val O1_MINI = of("o1-mini")
+
+                @JvmField val O1_MINI_2024_09_12 = of("o1-mini-2024-09-12")
+
+                @JvmField val GPT_4O = of("gpt-4o")
+
+                @JvmField val GPT_4O_2024_11_20 = of("gpt-4o-2024-11-20")
+
+                @JvmField val GPT_4O_2024_08_06 = of("gpt-4o-2024-08-06")
+
+                @JvmField val GPT_4O_2024_05_13 = of("gpt-4o-2024-05-13")
+
+                @JvmField val GPT_4O_AUDIO_PREVIEW = of("gpt-4o-audio-preview")
+
+                @JvmField
+                val GPT_4O_AUDIO_PREVIEW_2024_10_01 = of("gpt-4o-audio-preview-2024-10-01")
+
+                @JvmField
+                val GPT_4O_AUDIO_PREVIEW_2024_12_17 = of("gpt-4o-audio-preview-2024-12-17")
+
+                @JvmField
+                val GPT_4O_AUDIO_PREVIEW_2025_06_03 = of("gpt-4o-audio-preview-2025-06-03")
+
+                @JvmField val GPT_4O_MINI_AUDIO_PREVIEW = of("gpt-4o-mini-audio-preview")
+
+                @JvmField
+                val GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17 =
+                    of("gpt-4o-mini-audio-preview-2024-12-17")
+
+                @JvmField val GPT_4O_SEARCH_PREVIEW = of("gpt-4o-search-preview")
+
+                @JvmField val GPT_4O_MINI_SEARCH_PREVIEW = of("gpt-4o-mini-search-preview")
+
+                @JvmField
+                val GPT_4O_SEARCH_PREVIEW_2025_03_11 = of("gpt-4o-search-preview-2025-03-11")
+
+                @JvmField
+                val GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11 =
+                    of("gpt-4o-mini-search-preview-2025-03-11")
+
+                @JvmField val CHATGPT_4O_LATEST = of("chatgpt-4o-latest")
+
+                @JvmField val CODEX_MINI_LATEST = of("codex-mini-latest")
+
+                @JvmField val GPT_4O_MINI = of("gpt-4o-mini")
+
+                @JvmField val GPT_4O_MINI_2024_07_18 = of("gpt-4o-mini-2024-07-18")
+
+                @JvmField val GPT_4_TURBO = of("gpt-4-turbo")
+
+                @JvmField val GPT_4_TURBO_2024_04_09 = of("gpt-4-turbo-2024-04-09")
+
+                @JvmField val GPT_4_0125_PREVIEW = of("gpt-4-0125-preview")
+
+                @JvmField val GPT_4_TURBO_PREVIEW = of("gpt-4-turbo-preview")
+
+                @JvmField val GPT_4_1106_PREVIEW = of("gpt-4-1106-preview")
+
+                @JvmField val GPT_4_VISION_PREVIEW = of("gpt-4-vision-preview")
+
+                @JvmField val GPT_4 = of("gpt-4")
+
+                @JvmField val GPT_4_0314 = of("gpt-4-0314")
+
+                @JvmField val GPT_4_0613 = of("gpt-4-0613")
+
+                @JvmField val GPT_4_32K = of("gpt-4-32k")
+
+                @JvmField val GPT_4_32K_0314 = of("gpt-4-32k-0314")
+
+                @JvmField val GPT_4_32K_0613 = of("gpt-4-32k-0613")
+
+                @JvmField val GPT_3_5_TURBO = of("gpt-3.5-turbo")
+
+                @JvmField val GPT_3_5_TURBO_16K = of("gpt-3.5-turbo-16k")
+
+                @JvmField val GPT_3_5_TURBO_0301 = of("gpt-3.5-turbo-0301")
+
+                @JvmField val GPT_3_5_TURBO_0613 = of("gpt-3.5-turbo-0613")
+
+                @JvmField val GPT_3_5_TURBO_1106 = of("gpt-3.5-turbo-1106")
+
+                @JvmField val GPT_3_5_TURBO_0125 = of("gpt-3.5-turbo-0125")
+
+                @JvmField val GPT_3_5_TURBO_16K_0613 = of("gpt-3.5-turbo-16k-0613")
+
+                @JvmField val O1_PRO = of("o1-pro")
+
+                @JvmField val O1_PRO_2025_03_19 = of("o1-pro-2025-03-19")
+
+                @JvmField val O3_PRO = of("o3-pro")
+
+                @JvmField val O3_PRO_2025_06_10 = of("o3-pro-2025-06-10")
+
+                @JvmField val O3_DEEP_RESEARCH = of("o3-deep-research")
+
+                @JvmField val O3_DEEP_RESEARCH_2025_06_26 = of("o3-deep-research-2025-06-26")
+
+                @JvmField val O4_MINI_DEEP_RESEARCH = of("o4-mini-deep-research")
+
+                @JvmField
+                val O4_MINI_DEEP_RESEARCH_2025_06_26 = of("o4-mini-deep-research-2025-06-26")
+
+                @JvmField val COMPUTER_USE_PREVIEW = of("computer-use-preview")
+
+                @JvmField
+                val COMPUTER_USE_PREVIEW_2025_03_11 = of("computer-use-preview-2025-03-11")
+
+                @JvmField val GPT_5_CODEX = of("gpt-5-codex")
+
+                @JvmField val GPT_5_PRO = of("gpt-5-pro")
+
+                @JvmField val GPT_5_PRO_2025_10_06 = of("gpt-5-pro-2025-10-06")
+
+                @JvmField val GPT_5_1_CODEX_MAX = of("gpt-5.1-codex-max")
+
+                @JvmStatic fun of(value: String) = Model(JsonField.of(value))
+            }
+
+            /** An enum containing [Model]'s known values. */
+            enum class Known {
+                GPT_5_6_SOL,
+                GPT_5_6_TERRA,
+                GPT_5_6_LUNA,
+                GPT_5_4,
+                GPT_5_4_MINI,
+                GPT_5_4_NANO,
+                GPT_5_4_MINI_2026_03_17,
+                GPT_5_4_NANO_2026_03_17,
+                GPT_5_3_CHAT_LATEST,
+                GPT_5_2,
+                GPT_5_2_2025_12_11,
+                GPT_5_2_CHAT_LATEST,
+                GPT_5_2_PRO,
+                GPT_5_2_PRO_2025_12_11,
+                GPT_5_1,
+                GPT_5_1_2025_11_13,
+                GPT_5_1_CODEX,
+                GPT_5_1_MINI,
+                GPT_5_1_CHAT_LATEST,
+                GPT_5,
+                GPT_5_MINI,
+                GPT_5_NANO,
+                GPT_5_2025_08_07,
+                GPT_5_MINI_2025_08_07,
+                GPT_5_NANO_2025_08_07,
+                GPT_5_CHAT_LATEST,
+                GPT_4_1,
+                GPT_4_1_MINI,
+                GPT_4_1_NANO,
+                GPT_4_1_2025_04_14,
+                GPT_4_1_MINI_2025_04_14,
+                GPT_4_1_NANO_2025_04_14,
+                O4_MINI,
+                O4_MINI_2025_04_16,
+                O3,
+                O3_2025_04_16,
+                O3_MINI,
+                O3_MINI_2025_01_31,
+                O1,
+                O1_2024_12_17,
+                O1_PREVIEW,
+                O1_PREVIEW_2024_09_12,
+                O1_MINI,
+                O1_MINI_2024_09_12,
+                GPT_4O,
+                GPT_4O_2024_11_20,
+                GPT_4O_2024_08_06,
+                GPT_4O_2024_05_13,
+                GPT_4O_AUDIO_PREVIEW,
+                GPT_4O_AUDIO_PREVIEW_2024_10_01,
+                GPT_4O_AUDIO_PREVIEW_2024_12_17,
+                GPT_4O_AUDIO_PREVIEW_2025_06_03,
+                GPT_4O_MINI_AUDIO_PREVIEW,
+                GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17,
+                GPT_4O_SEARCH_PREVIEW,
+                GPT_4O_MINI_SEARCH_PREVIEW,
+                GPT_4O_SEARCH_PREVIEW_2025_03_11,
+                GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11,
+                CHATGPT_4O_LATEST,
+                CODEX_MINI_LATEST,
+                GPT_4O_MINI,
+                GPT_4O_MINI_2024_07_18,
+                GPT_4_TURBO,
+                GPT_4_TURBO_2024_04_09,
+                GPT_4_0125_PREVIEW,
+                GPT_4_TURBO_PREVIEW,
+                GPT_4_1106_PREVIEW,
+                GPT_4_VISION_PREVIEW,
+                GPT_4,
+                GPT_4_0314,
+                GPT_4_0613,
+                GPT_4_32K,
+                GPT_4_32K_0314,
+                GPT_4_32K_0613,
+                GPT_3_5_TURBO,
+                GPT_3_5_TURBO_16K,
+                GPT_3_5_TURBO_0301,
+                GPT_3_5_TURBO_0613,
+                GPT_3_5_TURBO_1106,
+                GPT_3_5_TURBO_0125,
+                GPT_3_5_TURBO_16K_0613,
+                O1_PRO,
+                O1_PRO_2025_03_19,
+                O3_PRO,
+                O3_PRO_2025_06_10,
+                O3_DEEP_RESEARCH,
+                O3_DEEP_RESEARCH_2025_06_26,
+                O4_MINI_DEEP_RESEARCH,
+                O4_MINI_DEEP_RESEARCH_2025_06_26,
+                COMPUTER_USE_PREVIEW,
+                COMPUTER_USE_PREVIEW_2025_03_11,
+                GPT_5_CODEX,
+                GPT_5_PRO,
+                GPT_5_PRO_2025_10_06,
+                GPT_5_1_CODEX_MAX,
+            }
+
+            /**
+             * An enum containing [Model]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Model] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                GPT_5_6_SOL,
+                GPT_5_6_TERRA,
+                GPT_5_6_LUNA,
+                GPT_5_4,
+                GPT_5_4_MINI,
+                GPT_5_4_NANO,
+                GPT_5_4_MINI_2026_03_17,
+                GPT_5_4_NANO_2026_03_17,
+                GPT_5_3_CHAT_LATEST,
+                GPT_5_2,
+                GPT_5_2_2025_12_11,
+                GPT_5_2_CHAT_LATEST,
+                GPT_5_2_PRO,
+                GPT_5_2_PRO_2025_12_11,
+                GPT_5_1,
+                GPT_5_1_2025_11_13,
+                GPT_5_1_CODEX,
+                GPT_5_1_MINI,
+                GPT_5_1_CHAT_LATEST,
+                GPT_5,
+                GPT_5_MINI,
+                GPT_5_NANO,
+                GPT_5_2025_08_07,
+                GPT_5_MINI_2025_08_07,
+                GPT_5_NANO_2025_08_07,
+                GPT_5_CHAT_LATEST,
+                GPT_4_1,
+                GPT_4_1_MINI,
+                GPT_4_1_NANO,
+                GPT_4_1_2025_04_14,
+                GPT_4_1_MINI_2025_04_14,
+                GPT_4_1_NANO_2025_04_14,
+                O4_MINI,
+                O4_MINI_2025_04_16,
+                O3,
+                O3_2025_04_16,
+                O3_MINI,
+                O3_MINI_2025_01_31,
+                O1,
+                O1_2024_12_17,
+                O1_PREVIEW,
+                O1_PREVIEW_2024_09_12,
+                O1_MINI,
+                O1_MINI_2024_09_12,
+                GPT_4O,
+                GPT_4O_2024_11_20,
+                GPT_4O_2024_08_06,
+                GPT_4O_2024_05_13,
+                GPT_4O_AUDIO_PREVIEW,
+                GPT_4O_AUDIO_PREVIEW_2024_10_01,
+                GPT_4O_AUDIO_PREVIEW_2024_12_17,
+                GPT_4O_AUDIO_PREVIEW_2025_06_03,
+                GPT_4O_MINI_AUDIO_PREVIEW,
+                GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17,
+                GPT_4O_SEARCH_PREVIEW,
+                GPT_4O_MINI_SEARCH_PREVIEW,
+                GPT_4O_SEARCH_PREVIEW_2025_03_11,
+                GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11,
+                CHATGPT_4O_LATEST,
+                CODEX_MINI_LATEST,
+                GPT_4O_MINI,
+                GPT_4O_MINI_2024_07_18,
+                GPT_4_TURBO,
+                GPT_4_TURBO_2024_04_09,
+                GPT_4_0125_PREVIEW,
+                GPT_4_TURBO_PREVIEW,
+                GPT_4_1106_PREVIEW,
+                GPT_4_VISION_PREVIEW,
+                GPT_4,
+                GPT_4_0314,
+                GPT_4_0613,
+                GPT_4_32K,
+                GPT_4_32K_0314,
+                GPT_4_32K_0613,
+                GPT_3_5_TURBO,
+                GPT_3_5_TURBO_16K,
+                GPT_3_5_TURBO_0301,
+                GPT_3_5_TURBO_0613,
+                GPT_3_5_TURBO_1106,
+                GPT_3_5_TURBO_0125,
+                GPT_3_5_TURBO_16K_0613,
+                O1_PRO,
+                O1_PRO_2025_03_19,
+                O3_PRO,
+                O3_PRO_2025_06_10,
+                O3_DEEP_RESEARCH,
+                O3_DEEP_RESEARCH_2025_06_26,
+                O4_MINI_DEEP_RESEARCH,
+                O4_MINI_DEEP_RESEARCH_2025_06_26,
+                COMPUTER_USE_PREVIEW,
+                COMPUTER_USE_PREVIEW_2025_03_11,
+                GPT_5_CODEX,
+                GPT_5_PRO,
+                GPT_5_PRO_2025_10_06,
+                GPT_5_1_CODEX_MAX,
+                /**
+                 * An enum member indicating that [Model] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    GPT_5_6_SOL -> Value.GPT_5_6_SOL
+                    GPT_5_6_TERRA -> Value.GPT_5_6_TERRA
+                    GPT_5_6_LUNA -> Value.GPT_5_6_LUNA
+                    GPT_5_4 -> Value.GPT_5_4
+                    GPT_5_4_MINI -> Value.GPT_5_4_MINI
+                    GPT_5_4_NANO -> Value.GPT_5_4_NANO
+                    GPT_5_4_MINI_2026_03_17 -> Value.GPT_5_4_MINI_2026_03_17
+                    GPT_5_4_NANO_2026_03_17 -> Value.GPT_5_4_NANO_2026_03_17
+                    GPT_5_3_CHAT_LATEST -> Value.GPT_5_3_CHAT_LATEST
+                    GPT_5_2 -> Value.GPT_5_2
+                    GPT_5_2_2025_12_11 -> Value.GPT_5_2_2025_12_11
+                    GPT_5_2_CHAT_LATEST -> Value.GPT_5_2_CHAT_LATEST
+                    GPT_5_2_PRO -> Value.GPT_5_2_PRO
+                    GPT_5_2_PRO_2025_12_11 -> Value.GPT_5_2_PRO_2025_12_11
+                    GPT_5_1 -> Value.GPT_5_1
+                    GPT_5_1_2025_11_13 -> Value.GPT_5_1_2025_11_13
+                    GPT_5_1_CODEX -> Value.GPT_5_1_CODEX
+                    GPT_5_1_MINI -> Value.GPT_5_1_MINI
+                    GPT_5_1_CHAT_LATEST -> Value.GPT_5_1_CHAT_LATEST
+                    GPT_5 -> Value.GPT_5
+                    GPT_5_MINI -> Value.GPT_5_MINI
+                    GPT_5_NANO -> Value.GPT_5_NANO
+                    GPT_5_2025_08_07 -> Value.GPT_5_2025_08_07
+                    GPT_5_MINI_2025_08_07 -> Value.GPT_5_MINI_2025_08_07
+                    GPT_5_NANO_2025_08_07 -> Value.GPT_5_NANO_2025_08_07
+                    GPT_5_CHAT_LATEST -> Value.GPT_5_CHAT_LATEST
+                    GPT_4_1 -> Value.GPT_4_1
+                    GPT_4_1_MINI -> Value.GPT_4_1_MINI
+                    GPT_4_1_NANO -> Value.GPT_4_1_NANO
+                    GPT_4_1_2025_04_14 -> Value.GPT_4_1_2025_04_14
+                    GPT_4_1_MINI_2025_04_14 -> Value.GPT_4_1_MINI_2025_04_14
+                    GPT_4_1_NANO_2025_04_14 -> Value.GPT_4_1_NANO_2025_04_14
+                    O4_MINI -> Value.O4_MINI
+                    O4_MINI_2025_04_16 -> Value.O4_MINI_2025_04_16
+                    O3 -> Value.O3
+                    O3_2025_04_16 -> Value.O3_2025_04_16
+                    O3_MINI -> Value.O3_MINI
+                    O3_MINI_2025_01_31 -> Value.O3_MINI_2025_01_31
+                    O1 -> Value.O1
+                    O1_2024_12_17 -> Value.O1_2024_12_17
+                    O1_PREVIEW -> Value.O1_PREVIEW
+                    O1_PREVIEW_2024_09_12 -> Value.O1_PREVIEW_2024_09_12
+                    O1_MINI -> Value.O1_MINI
+                    O1_MINI_2024_09_12 -> Value.O1_MINI_2024_09_12
+                    GPT_4O -> Value.GPT_4O
+                    GPT_4O_2024_11_20 -> Value.GPT_4O_2024_11_20
+                    GPT_4O_2024_08_06 -> Value.GPT_4O_2024_08_06
+                    GPT_4O_2024_05_13 -> Value.GPT_4O_2024_05_13
+                    GPT_4O_AUDIO_PREVIEW -> Value.GPT_4O_AUDIO_PREVIEW
+                    GPT_4O_AUDIO_PREVIEW_2024_10_01 -> Value.GPT_4O_AUDIO_PREVIEW_2024_10_01
+                    GPT_4O_AUDIO_PREVIEW_2024_12_17 -> Value.GPT_4O_AUDIO_PREVIEW_2024_12_17
+                    GPT_4O_AUDIO_PREVIEW_2025_06_03 -> Value.GPT_4O_AUDIO_PREVIEW_2025_06_03
+                    GPT_4O_MINI_AUDIO_PREVIEW -> Value.GPT_4O_MINI_AUDIO_PREVIEW
+                    GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17 ->
+                        Value.GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17
+                    GPT_4O_SEARCH_PREVIEW -> Value.GPT_4O_SEARCH_PREVIEW
+                    GPT_4O_MINI_SEARCH_PREVIEW -> Value.GPT_4O_MINI_SEARCH_PREVIEW
+                    GPT_4O_SEARCH_PREVIEW_2025_03_11 -> Value.GPT_4O_SEARCH_PREVIEW_2025_03_11
+                    GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11 ->
+                        Value.GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11
+                    CHATGPT_4O_LATEST -> Value.CHATGPT_4O_LATEST
+                    CODEX_MINI_LATEST -> Value.CODEX_MINI_LATEST
+                    GPT_4O_MINI -> Value.GPT_4O_MINI
+                    GPT_4O_MINI_2024_07_18 -> Value.GPT_4O_MINI_2024_07_18
+                    GPT_4_TURBO -> Value.GPT_4_TURBO
+                    GPT_4_TURBO_2024_04_09 -> Value.GPT_4_TURBO_2024_04_09
+                    GPT_4_0125_PREVIEW -> Value.GPT_4_0125_PREVIEW
+                    GPT_4_TURBO_PREVIEW -> Value.GPT_4_TURBO_PREVIEW
+                    GPT_4_1106_PREVIEW -> Value.GPT_4_1106_PREVIEW
+                    GPT_4_VISION_PREVIEW -> Value.GPT_4_VISION_PREVIEW
+                    GPT_4 -> Value.GPT_4
+                    GPT_4_0314 -> Value.GPT_4_0314
+                    GPT_4_0613 -> Value.GPT_4_0613
+                    GPT_4_32K -> Value.GPT_4_32K
+                    GPT_4_32K_0314 -> Value.GPT_4_32K_0314
+                    GPT_4_32K_0613 -> Value.GPT_4_32K_0613
+                    GPT_3_5_TURBO -> Value.GPT_3_5_TURBO
+                    GPT_3_5_TURBO_16K -> Value.GPT_3_5_TURBO_16K
+                    GPT_3_5_TURBO_0301 -> Value.GPT_3_5_TURBO_0301
+                    GPT_3_5_TURBO_0613 -> Value.GPT_3_5_TURBO_0613
+                    GPT_3_5_TURBO_1106 -> Value.GPT_3_5_TURBO_1106
+                    GPT_3_5_TURBO_0125 -> Value.GPT_3_5_TURBO_0125
+                    GPT_3_5_TURBO_16K_0613 -> Value.GPT_3_5_TURBO_16K_0613
+                    O1_PRO -> Value.O1_PRO
+                    O1_PRO_2025_03_19 -> Value.O1_PRO_2025_03_19
+                    O3_PRO -> Value.O3_PRO
+                    O3_PRO_2025_06_10 -> Value.O3_PRO_2025_06_10
+                    O3_DEEP_RESEARCH -> Value.O3_DEEP_RESEARCH
+                    O3_DEEP_RESEARCH_2025_06_26 -> Value.O3_DEEP_RESEARCH_2025_06_26
+                    O4_MINI_DEEP_RESEARCH -> Value.O4_MINI_DEEP_RESEARCH
+                    O4_MINI_DEEP_RESEARCH_2025_06_26 -> Value.O4_MINI_DEEP_RESEARCH_2025_06_26
+                    COMPUTER_USE_PREVIEW -> Value.COMPUTER_USE_PREVIEW
+                    COMPUTER_USE_PREVIEW_2025_03_11 -> Value.COMPUTER_USE_PREVIEW_2025_03_11
+                    GPT_5_CODEX -> Value.GPT_5_CODEX
+                    GPT_5_PRO -> Value.GPT_5_PRO
+                    GPT_5_PRO_2025_10_06 -> Value.GPT_5_PRO_2025_10_06
+                    GPT_5_1_CODEX_MAX -> Value.GPT_5_1_CODEX_MAX
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    GPT_5_6_SOL -> Known.GPT_5_6_SOL
+                    GPT_5_6_TERRA -> Known.GPT_5_6_TERRA
+                    GPT_5_6_LUNA -> Known.GPT_5_6_LUNA
+                    GPT_5_4 -> Known.GPT_5_4
+                    GPT_5_4_MINI -> Known.GPT_5_4_MINI
+                    GPT_5_4_NANO -> Known.GPT_5_4_NANO
+                    GPT_5_4_MINI_2026_03_17 -> Known.GPT_5_4_MINI_2026_03_17
+                    GPT_5_4_NANO_2026_03_17 -> Known.GPT_5_4_NANO_2026_03_17
+                    GPT_5_3_CHAT_LATEST -> Known.GPT_5_3_CHAT_LATEST
+                    GPT_5_2 -> Known.GPT_5_2
+                    GPT_5_2_2025_12_11 -> Known.GPT_5_2_2025_12_11
+                    GPT_5_2_CHAT_LATEST -> Known.GPT_5_2_CHAT_LATEST
+                    GPT_5_2_PRO -> Known.GPT_5_2_PRO
+                    GPT_5_2_PRO_2025_12_11 -> Known.GPT_5_2_PRO_2025_12_11
+                    GPT_5_1 -> Known.GPT_5_1
+                    GPT_5_1_2025_11_13 -> Known.GPT_5_1_2025_11_13
+                    GPT_5_1_CODEX -> Known.GPT_5_1_CODEX
+                    GPT_5_1_MINI -> Known.GPT_5_1_MINI
+                    GPT_5_1_CHAT_LATEST -> Known.GPT_5_1_CHAT_LATEST
+                    GPT_5 -> Known.GPT_5
+                    GPT_5_MINI -> Known.GPT_5_MINI
+                    GPT_5_NANO -> Known.GPT_5_NANO
+                    GPT_5_2025_08_07 -> Known.GPT_5_2025_08_07
+                    GPT_5_MINI_2025_08_07 -> Known.GPT_5_MINI_2025_08_07
+                    GPT_5_NANO_2025_08_07 -> Known.GPT_5_NANO_2025_08_07
+                    GPT_5_CHAT_LATEST -> Known.GPT_5_CHAT_LATEST
+                    GPT_4_1 -> Known.GPT_4_1
+                    GPT_4_1_MINI -> Known.GPT_4_1_MINI
+                    GPT_4_1_NANO -> Known.GPT_4_1_NANO
+                    GPT_4_1_2025_04_14 -> Known.GPT_4_1_2025_04_14
+                    GPT_4_1_MINI_2025_04_14 -> Known.GPT_4_1_MINI_2025_04_14
+                    GPT_4_1_NANO_2025_04_14 -> Known.GPT_4_1_NANO_2025_04_14
+                    O4_MINI -> Known.O4_MINI
+                    O4_MINI_2025_04_16 -> Known.O4_MINI_2025_04_16
+                    O3 -> Known.O3
+                    O3_2025_04_16 -> Known.O3_2025_04_16
+                    O3_MINI -> Known.O3_MINI
+                    O3_MINI_2025_01_31 -> Known.O3_MINI_2025_01_31
+                    O1 -> Known.O1
+                    O1_2024_12_17 -> Known.O1_2024_12_17
+                    O1_PREVIEW -> Known.O1_PREVIEW
+                    O1_PREVIEW_2024_09_12 -> Known.O1_PREVIEW_2024_09_12
+                    O1_MINI -> Known.O1_MINI
+                    O1_MINI_2024_09_12 -> Known.O1_MINI_2024_09_12
+                    GPT_4O -> Known.GPT_4O
+                    GPT_4O_2024_11_20 -> Known.GPT_4O_2024_11_20
+                    GPT_4O_2024_08_06 -> Known.GPT_4O_2024_08_06
+                    GPT_4O_2024_05_13 -> Known.GPT_4O_2024_05_13
+                    GPT_4O_AUDIO_PREVIEW -> Known.GPT_4O_AUDIO_PREVIEW
+                    GPT_4O_AUDIO_PREVIEW_2024_10_01 -> Known.GPT_4O_AUDIO_PREVIEW_2024_10_01
+                    GPT_4O_AUDIO_PREVIEW_2024_12_17 -> Known.GPT_4O_AUDIO_PREVIEW_2024_12_17
+                    GPT_4O_AUDIO_PREVIEW_2025_06_03 -> Known.GPT_4O_AUDIO_PREVIEW_2025_06_03
+                    GPT_4O_MINI_AUDIO_PREVIEW -> Known.GPT_4O_MINI_AUDIO_PREVIEW
+                    GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17 ->
+                        Known.GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17
+                    GPT_4O_SEARCH_PREVIEW -> Known.GPT_4O_SEARCH_PREVIEW
+                    GPT_4O_MINI_SEARCH_PREVIEW -> Known.GPT_4O_MINI_SEARCH_PREVIEW
+                    GPT_4O_SEARCH_PREVIEW_2025_03_11 -> Known.GPT_4O_SEARCH_PREVIEW_2025_03_11
+                    GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11 ->
+                        Known.GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11
+                    CHATGPT_4O_LATEST -> Known.CHATGPT_4O_LATEST
+                    CODEX_MINI_LATEST -> Known.CODEX_MINI_LATEST
+                    GPT_4O_MINI -> Known.GPT_4O_MINI
+                    GPT_4O_MINI_2024_07_18 -> Known.GPT_4O_MINI_2024_07_18
+                    GPT_4_TURBO -> Known.GPT_4_TURBO
+                    GPT_4_TURBO_2024_04_09 -> Known.GPT_4_TURBO_2024_04_09
+                    GPT_4_0125_PREVIEW -> Known.GPT_4_0125_PREVIEW
+                    GPT_4_TURBO_PREVIEW -> Known.GPT_4_TURBO_PREVIEW
+                    GPT_4_1106_PREVIEW -> Known.GPT_4_1106_PREVIEW
+                    GPT_4_VISION_PREVIEW -> Known.GPT_4_VISION_PREVIEW
+                    GPT_4 -> Known.GPT_4
+                    GPT_4_0314 -> Known.GPT_4_0314
+                    GPT_4_0613 -> Known.GPT_4_0613
+                    GPT_4_32K -> Known.GPT_4_32K
+                    GPT_4_32K_0314 -> Known.GPT_4_32K_0314
+                    GPT_4_32K_0613 -> Known.GPT_4_32K_0613
+                    GPT_3_5_TURBO -> Known.GPT_3_5_TURBO
+                    GPT_3_5_TURBO_16K -> Known.GPT_3_5_TURBO_16K
+                    GPT_3_5_TURBO_0301 -> Known.GPT_3_5_TURBO_0301
+                    GPT_3_5_TURBO_0613 -> Known.GPT_3_5_TURBO_0613
+                    GPT_3_5_TURBO_1106 -> Known.GPT_3_5_TURBO_1106
+                    GPT_3_5_TURBO_0125 -> Known.GPT_3_5_TURBO_0125
+                    GPT_3_5_TURBO_16K_0613 -> Known.GPT_3_5_TURBO_16K_0613
+                    O1_PRO -> Known.O1_PRO
+                    O1_PRO_2025_03_19 -> Known.O1_PRO_2025_03_19
+                    O3_PRO -> Known.O3_PRO
+                    O3_PRO_2025_06_10 -> Known.O3_PRO_2025_06_10
+                    O3_DEEP_RESEARCH -> Known.O3_DEEP_RESEARCH
+                    O3_DEEP_RESEARCH_2025_06_26 -> Known.O3_DEEP_RESEARCH_2025_06_26
+                    O4_MINI_DEEP_RESEARCH -> Known.O4_MINI_DEEP_RESEARCH
+                    O4_MINI_DEEP_RESEARCH_2025_06_26 -> Known.O4_MINI_DEEP_RESEARCH_2025_06_26
+                    COMPUTER_USE_PREVIEW -> Known.COMPUTER_USE_PREVIEW
+                    COMPUTER_USE_PREVIEW_2025_03_11 -> Known.COMPUTER_USE_PREVIEW_2025_03_11
+                    GPT_5_CODEX -> Known.GPT_5_CODEX
+                    GPT_5_PRO -> Known.GPT_5_PRO
+                    GPT_5_PRO_2025_10_06 -> Known.GPT_5_PRO_2025_10_06
+                    GPT_5_1_CODEX_MAX -> Known.GPT_5_1_CODEX_MAX
+                    else -> throw OpenAIInvalidDataException("Unknown Model: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Model = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Model && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** Configuration for running moderation on the input and output of this response. */
+        class Moderation
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val model: JsonField<String>,
+            private val policy: JsonField<Policy>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("model") @ExcludeMissing model: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("policy") @ExcludeMissing policy: JsonField<Policy> = JsonMissing.of(),
+            ) : this(model, policy, mutableMapOf())
+
+            /**
+             * The moderation model to use for moderated completions, e.g. 'omni-moderation-latest'.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun model(): String = model.getRequired("model")
+
+            /**
+             * The policy to apply to moderated response input and output.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun policy(): Optional<Policy> = policy.getOptional("policy")
+
+            /**
+             * Returns the raw JSON value of [model].
+             *
+             * Unlike [model], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("model") @ExcludeMissing fun _model(): JsonField<String> = model
+
+            /**
+             * Returns the raw JSON value of [policy].
+             *
+             * Unlike [policy], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("policy") @ExcludeMissing fun _policy(): JsonField<Policy> = policy
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Moderation].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .model()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Moderation]. */
+            class Builder internal constructor() {
+
+                private var model: JsonField<String>? = null
+                private var policy: JsonField<Policy> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(moderation: Moderation) = apply {
+                    model = moderation.model
+                    policy = moderation.policy
+                    additionalProperties = moderation.additionalProperties.toMutableMap()
+                }
+
+                /**
+                 * The moderation model to use for moderated completions, e.g.
+                 * 'omni-moderation-latest'.
+                 */
+                fun model(model: String) = model(JsonField.of(model))
+
+                /**
+                 * Sets [Builder.model] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.model] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun model(model: JsonField<String>) = apply { this.model = model }
+
+                /** The policy to apply to moderated response input and output. */
+                fun policy(policy: Policy?) = policy(JsonField.ofNullable(policy))
+
+                /** Alias for calling [Builder.policy] with `policy.orElse(null)`. */
+                fun policy(policy: Optional<Policy>) = policy(policy.getOrNull())
+
+                /**
+                 * Sets [Builder.policy] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.policy] with a well-typed [Policy] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun policy(policy: JsonField<Policy>) = apply { this.policy = policy }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Moderation].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .model()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Moderation =
+                    Moderation(
+                        checkRequired("model", model),
+                        policy,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Moderation = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                model()
+                policy().ifPresent { it.validate() }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (model.asKnown().isPresent) 1 else 0) +
+                    (policy.asKnown().getOrNull()?.validity() ?: 0)
+
+            /** The policy to apply to moderated response input and output. */
+            class Policy
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val input: JsonField<Input>,
+                private val output: JsonField<Output>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("input")
+                    @ExcludeMissing
+                    input: JsonField<Input> = JsonMissing.of(),
+                    @JsonProperty("output")
+                    @ExcludeMissing
+                    output: JsonField<Output> = JsonMissing.of(),
+                ) : this(input, output, mutableMapOf())
+
+                /**
+                 * The moderation policy for the response input.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun input(): Optional<Input> = input.getOptional("input")
+
+                /**
+                 * The moderation policy for the response output.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun output(): Optional<Output> = output.getOptional("output")
+
+                /**
+                 * Returns the raw JSON value of [input].
+                 *
+                 * Unlike [input], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("input") @ExcludeMissing fun _input(): JsonField<Input> = input
+
+                /**
+                 * Returns the raw JSON value of [output].
+                 *
+                 * Unlike [output], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<Output> = output
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /** Returns a mutable builder for constructing an instance of [Policy]. */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Policy]. */
+                class Builder internal constructor() {
+
+                    private var input: JsonField<Input> = JsonMissing.of()
+                    private var output: JsonField<Output> = JsonMissing.of()
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(policy: Policy) = apply {
+                        input = policy.input
+                        output = policy.output
+                        additionalProperties = policy.additionalProperties.toMutableMap()
+                    }
+
+                    /** The moderation policy for the response input. */
+                    fun input(input: Input?) = input(JsonField.ofNullable(input))
+
+                    /** Alias for calling [Builder.input] with `input.orElse(null)`. */
+                    fun input(input: Optional<Input>) = input(input.getOrNull())
+
+                    /**
+                     * Sets [Builder.input] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.input] with a well-typed [Input] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun input(input: JsonField<Input>) = apply { this.input = input }
+
+                    /** The moderation policy for the response output. */
+                    fun output(output: Output?) = output(JsonField.ofNullable(output))
+
+                    /** Alias for calling [Builder.output] with `output.orElse(null)`. */
+                    fun output(output: Optional<Output>) = output(output.getOrNull())
+
+                    /**
+                     * Sets [Builder.output] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.output] with a well-typed [Output] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun output(output: JsonField<Output>) = apply { this.output = output }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Policy].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     */
+                    fun build(): Policy = Policy(input, output, additionalProperties.toMutableMap())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Policy = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    input().ifPresent { it.validate() }
+                    output().ifPresent { it.validate() }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (input.asKnown().getOrNull()?.validity() ?: 0) +
+                        (output.asKnown().getOrNull()?.validity() ?: 0)
+
+                /** The moderation policy for the response input. */
+                class Input
+                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+                private constructor(
+                    private val mode: JsonField<Mode>,
+                    private val additionalProperties: MutableMap<String, JsonValue>,
+                ) {
+
+                    @JsonCreator
+                    private constructor(
+                        @JsonProperty("mode")
+                        @ExcludeMissing
+                        mode: JsonField<Mode> = JsonMissing.of()
+                    ) : this(mode, mutableMapOf())
+
+                    /**
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun mode(): Mode = mode.getRequired("mode")
+
+                    /**
+                     * Returns the raw JSON value of [mode].
+                     *
+                     * Unlike [mode], this method doesn't throw if the JSON field has an unexpected
+                     * type.
+                     */
+                    @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+                    @JsonAnySetter
+                    private fun putAdditionalProperty(key: String, value: JsonValue) {
+                        additionalProperties.put(key, value)
+                    }
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> =
+                        Collections.unmodifiableMap(additionalProperties)
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of [Input].
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .mode()
+                         * ```
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [Input]. */
+                    class Builder internal constructor() {
+
+                        private var mode: JsonField<Mode>? = null
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(input: Input) = apply {
+                            mode = input.mode
+                            additionalProperties = input.additionalProperties.toMutableMap()
+                        }
+
+                        fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+                        /**
+                         * Sets [Builder.mode] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.mode] with a well-typed [Mode] value
+                         * instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [Input].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .mode()
+                         * ```
+                         *
+                         * @throws IllegalStateException if any required field is unset.
+                         */
+                        fun build(): Input =
+                            Input(checkRequired("mode", mode), additionalProperties.toMutableMap())
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): Input = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        mode().validate()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int = (mode.asKnown().getOrNull()?.validity() ?: 0)
+
+                    class Mode
+                    @JsonCreator
+                    private constructor(private val value: JsonField<String>) : Enum {
+
+                        /**
+                         * Returns this class instance's raw value.
+                         *
+                         * This is usually only useful if this instance was deserialized from data
+                         * that doesn't match any known member, and you want to know that value. For
+                         * example, if the SDK is on an older version than the API, then the API may
+                         * respond with new members that the SDK is unaware of.
+                         */
+                        @com.fasterxml.jackson.annotation.JsonValue
+                        fun _value(): JsonField<String> = value
+
+                        companion object {
+
+                            @JvmField val SCORE = of("score")
+
+                            @JvmField val BLOCK = of("block")
+
+                            @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+                        }
+
+                        /** An enum containing [Mode]'s known values. */
+                        enum class Known {
+                            SCORE,
+                            BLOCK,
+                        }
+
+                        /**
+                         * An enum containing [Mode]'s known values, as well as an [_UNKNOWN]
+                         * member.
+                         *
+                         * An instance of [Mode] can contain an unknown value in a couple of cases:
+                         * - It was deserialized from data that doesn't match any known member. For
+                         *   example, if the SDK is on an older version than the API, then the API
+                         *   may respond with new members that the SDK is unaware of.
+                         * - It was constructed with an arbitrary value using the [of] method.
+                         */
+                        enum class Value {
+                            SCORE,
+                            BLOCK,
+                            /**
+                             * An enum member indicating that [Mode] was instantiated with an
+                             * unknown value.
+                             */
+                            _UNKNOWN,
+                        }
+
+                        /**
+                         * Returns an enum member corresponding to this class instance's value, or
+                         * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                         *
+                         * Use the [known] method instead if you're certain the value is always
+                         * known or if you want to throw for the unknown case.
+                         */
+                        fun value(): Value =
+                            when (this) {
+                                SCORE -> Value.SCORE
+                                BLOCK -> Value.BLOCK
+                                else -> Value._UNKNOWN
+                            }
+
+                        /**
+                         * Returns an enum member corresponding to this class instance's value.
+                         *
+                         * Use the [value] method instead if you're uncertain the value is always
+                         * known and don't want to throw for the unknown case.
+                         *
+                         * @throws OpenAIInvalidDataException if this class instance's value is a
+                         *   not a known member.
+                         */
+                        fun known(): Known =
+                            when (this) {
+                                SCORE -> Known.SCORE
+                                BLOCK -> Known.BLOCK
+                                else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                            }
+
+                        /**
+                         * Returns this class instance's primitive wire representation.
+                         *
+                         * This differs from the [toString] method because that method is primarily
+                         * for debugging and generally doesn't throw.
+                         *
+                         * @throws OpenAIInvalidDataException if this class instance's value does
+                         *   not have the expected primitive type.
+                         */
+                        fun asString(): String =
+                            _value().asString().orElseThrow {
+                                OpenAIInvalidDataException("Value is not a String")
+                            }
+
+                        private var validated: Boolean = false
+
+                        /**
+                         * Validates that the types of all values in this object match their
+                         * expected types recursively.
+                         *
+                         * This method is _not_ forwards compatible with new types from the API for
+                         * existing fields.
+                         *
+                         * @throws OpenAIInvalidDataException if any value type in this object
+                         *   doesn't match its expected type.
+                         */
+                        fun validate(): Mode = apply {
+                            if (validated) {
+                                return@apply
+                            }
+
+                            known()
+                            validated = true
+                        }
+
+                        fun isValid(): Boolean =
+                            try {
+                                validate()
+                                true
+                            } catch (e: OpenAIInvalidDataException) {
+                                false
+                            }
+
+                        /**
+                         * Returns a score indicating how many valid values are contained in this
+                         * object recursively.
+                         *
+                         * Used for best match union deserialization.
+                         */
+                        @JvmSynthetic
+                        internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                        override fun equals(other: Any?): Boolean {
+                            if (this === other) {
+                                return true
+                            }
+
+                            return other is Mode && value == other.value
+                        }
+
+                        override fun hashCode() = value.hashCode()
+
+                        override fun toString() = value.toString()
+                    }
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Input &&
+                            mode == other.mode &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "Input{mode=$mode, additionalProperties=$additionalProperties}"
+                }
+
+                /** The moderation policy for the response output. */
+                class Output
+                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+                private constructor(
+                    private val mode: JsonField<Mode>,
+                    private val additionalProperties: MutableMap<String, JsonValue>,
+                ) {
+
+                    @JsonCreator
+                    private constructor(
+                        @JsonProperty("mode")
+                        @ExcludeMissing
+                        mode: JsonField<Mode> = JsonMissing.of()
+                    ) : this(mode, mutableMapOf())
+
+                    /**
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   or is unexpectedly missing or null (e.g. if the server responded with an
+                     *   unexpected value).
+                     */
+                    fun mode(): Mode = mode.getRequired("mode")
+
+                    /**
+                     * Returns the raw JSON value of [mode].
+                     *
+                     * Unlike [mode], this method doesn't throw if the JSON field has an unexpected
+                     * type.
+                     */
+                    @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+                    @JsonAnySetter
+                    private fun putAdditionalProperty(key: String, value: JsonValue) {
+                        additionalProperties.put(key, value)
+                    }
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> =
+                        Collections.unmodifiableMap(additionalProperties)
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /**
+                         * Returns a mutable builder for constructing an instance of [Output].
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .mode()
+                         * ```
+                         */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [Output]. */
+                    class Builder internal constructor() {
+
+                        private var mode: JsonField<Mode>? = null
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(output: Output) = apply {
+                            mode = output.mode
+                            additionalProperties = output.additionalProperties.toMutableMap()
+                        }
+
+                        fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+                        /**
+                         * Sets [Builder.mode] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.mode] with a well-typed [Mode] value
+                         * instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [Output].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         *
+                         * The following fields are required:
+                         * ```java
+                         * .mode()
+                         * ```
+                         *
+                         * @throws IllegalStateException if any required field is unset.
+                         */
+                        fun build(): Output =
+                            Output(checkRequired("mode", mode), additionalProperties.toMutableMap())
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): Output = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        mode().validate()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int = (mode.asKnown().getOrNull()?.validity() ?: 0)
+
+                    class Mode
+                    @JsonCreator
+                    private constructor(private val value: JsonField<String>) : Enum {
+
+                        /**
+                         * Returns this class instance's raw value.
+                         *
+                         * This is usually only useful if this instance was deserialized from data
+                         * that doesn't match any known member, and you want to know that value. For
+                         * example, if the SDK is on an older version than the API, then the API may
+                         * respond with new members that the SDK is unaware of.
+                         */
+                        @com.fasterxml.jackson.annotation.JsonValue
+                        fun _value(): JsonField<String> = value
+
+                        companion object {
+
+                            @JvmField val SCORE = of("score")
+
+                            @JvmField val BLOCK = of("block")
+
+                            @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+                        }
+
+                        /** An enum containing [Mode]'s known values. */
+                        enum class Known {
+                            SCORE,
+                            BLOCK,
+                        }
+
+                        /**
+                         * An enum containing [Mode]'s known values, as well as an [_UNKNOWN]
+                         * member.
+                         *
+                         * An instance of [Mode] can contain an unknown value in a couple of cases:
+                         * - It was deserialized from data that doesn't match any known member. For
+                         *   example, if the SDK is on an older version than the API, then the API
+                         *   may respond with new members that the SDK is unaware of.
+                         * - It was constructed with an arbitrary value using the [of] method.
+                         */
+                        enum class Value {
+                            SCORE,
+                            BLOCK,
+                            /**
+                             * An enum member indicating that [Mode] was instantiated with an
+                             * unknown value.
+                             */
+                            _UNKNOWN,
+                        }
+
+                        /**
+                         * Returns an enum member corresponding to this class instance's value, or
+                         * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                         *
+                         * Use the [known] method instead if you're certain the value is always
+                         * known or if you want to throw for the unknown case.
+                         */
+                        fun value(): Value =
+                            when (this) {
+                                SCORE -> Value.SCORE
+                                BLOCK -> Value.BLOCK
+                                else -> Value._UNKNOWN
+                            }
+
+                        /**
+                         * Returns an enum member corresponding to this class instance's value.
+                         *
+                         * Use the [value] method instead if you're uncertain the value is always
+                         * known and don't want to throw for the unknown case.
+                         *
+                         * @throws OpenAIInvalidDataException if this class instance's value is a
+                         *   not a known member.
+                         */
+                        fun known(): Known =
+                            when (this) {
+                                SCORE -> Known.SCORE
+                                BLOCK -> Known.BLOCK
+                                else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                            }
+
+                        /**
+                         * Returns this class instance's primitive wire representation.
+                         *
+                         * This differs from the [toString] method because that method is primarily
+                         * for debugging and generally doesn't throw.
+                         *
+                         * @throws OpenAIInvalidDataException if this class instance's value does
+                         *   not have the expected primitive type.
+                         */
+                        fun asString(): String =
+                            _value().asString().orElseThrow {
+                                OpenAIInvalidDataException("Value is not a String")
+                            }
+
+                        private var validated: Boolean = false
+
+                        /**
+                         * Validates that the types of all values in this object match their
+                         * expected types recursively.
+                         *
+                         * This method is _not_ forwards compatible with new types from the API for
+                         * existing fields.
+                         *
+                         * @throws OpenAIInvalidDataException if any value type in this object
+                         *   doesn't match its expected type.
+                         */
+                        fun validate(): Mode = apply {
+                            if (validated) {
+                                return@apply
+                            }
+
+                            known()
+                            validated = true
+                        }
+
+                        fun isValid(): Boolean =
+                            try {
+                                validate()
+                                true
+                            } catch (e: OpenAIInvalidDataException) {
+                                false
+                            }
+
+                        /**
+                         * Returns a score indicating how many valid values are contained in this
+                         * object recursively.
+                         *
+                         * Used for best match union deserialization.
+                         */
+                        @JvmSynthetic
+                        internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                        override fun equals(other: Any?): Boolean {
+                            if (this === other) {
+                                return true
+                            }
+
+                            return other is Mode && value == other.value
+                        }
+
+                        override fun hashCode() = value.hashCode()
+
+                        override fun toString() = value.toString()
+                    }
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Output &&
+                            mode == other.mode &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "Output{mode=$mode, additionalProperties=$additionalProperties}"
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Policy &&
+                        input == other.input &&
+                        output == other.output &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(input, output, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Policy{input=$input, output=$output, additionalProperties=$additionalProperties}"
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Moderation &&
+                    model == other.model &&
+                    policy == other.policy &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(model, policy, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Moderation{model=$model, policy=$policy, additionalProperties=$additionalProperties}"
+        }
+
+        /** Configuration for server-hosted multi-agent execution. */
+        class MultiAgent
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val enabled: JsonField<Boolean>,
+            private val maxConcurrentSubagents: JsonField<Long>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("enabled")
+                @ExcludeMissing
+                enabled: JsonField<Boolean> = JsonMissing.of(),
+                @JsonProperty("max_concurrent_subagents")
+                @ExcludeMissing
+                maxConcurrentSubagents: JsonField<Long> = JsonMissing.of(),
+            ) : this(enabled, maxConcurrentSubagents, mutableMapOf())
+
+            /**
+             * Whether to enable server-hosted multi-agent execution for this response.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun enabled(): Boolean = enabled.getRequired("enabled")
+
+            /**
+             * `max_concurrent_subagents` sets the maximum number of subagents that can be active
+             * simultaneously across the entire agent tree. It includes all descendants—children,
+             * grandchildren, and deeper subagents—but excludes the root agent. The API does not
+             * impose a fixed upper bound on this setting. The default is `3`, which is recommended
+             * for most workloads. Multi-agent runs also have no fixed limit on tree depth or the
+             * total number of subagents created during a run.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun maxConcurrentSubagents(): Optional<Long> =
+                maxConcurrentSubagents.getOptional("max_concurrent_subagents")
+
+            /**
+             * Returns the raw JSON value of [enabled].
+             *
+             * Unlike [enabled], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("enabled") @ExcludeMissing fun _enabled(): JsonField<Boolean> = enabled
+
+            /**
+             * Returns the raw JSON value of [maxConcurrentSubagents].
+             *
+             * Unlike [maxConcurrentSubagents], this method doesn't throw if the JSON field has an
+             * unexpected type.
+             */
+            @JsonProperty("max_concurrent_subagents")
+            @ExcludeMissing
+            fun _maxConcurrentSubagents(): JsonField<Long> = maxConcurrentSubagents
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [MultiAgent].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .enabled()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [MultiAgent]. */
+            class Builder internal constructor() {
+
+                private var enabled: JsonField<Boolean>? = null
+                private var maxConcurrentSubagents: JsonField<Long> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(multiAgent: MultiAgent) = apply {
+                    enabled = multiAgent.enabled
+                    maxConcurrentSubagents = multiAgent.maxConcurrentSubagents
+                    additionalProperties = multiAgent.additionalProperties.toMutableMap()
+                }
+
+                /** Whether to enable server-hosted multi-agent execution for this response. */
+                fun enabled(enabled: Boolean) = enabled(JsonField.of(enabled))
+
+                /**
+                 * Sets [Builder.enabled] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.enabled] with a well-typed [Boolean] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun enabled(enabled: JsonField<Boolean>) = apply { this.enabled = enabled }
+
+                /**
+                 * `max_concurrent_subagents` sets the maximum number of subagents that can be
+                 * active simultaneously across the entire agent tree. It includes all
+                 * descendants—children, grandchildren, and deeper subagents—but excludes the root
+                 * agent. The API does not impose a fixed upper bound on this setting. The default
+                 * is `3`, which is recommended for most workloads. Multi-agent runs also have no
+                 * fixed limit on tree depth or the total number of subagents created during a run.
+                 */
+                fun maxConcurrentSubagents(maxConcurrentSubagents: Long) =
+                    maxConcurrentSubagents(JsonField.of(maxConcurrentSubagents))
+
+                /**
+                 * Sets [Builder.maxConcurrentSubagents] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.maxConcurrentSubagents] with a well-typed [Long]
+                 * value instead. This method is primarily for setting the field to an undocumented
+                 * or not yet supported value.
+                 */
+                fun maxConcurrentSubagents(maxConcurrentSubagents: JsonField<Long>) = apply {
+                    this.maxConcurrentSubagents = maxConcurrentSubagents
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [MultiAgent].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .enabled()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): MultiAgent =
+                    MultiAgent(
+                        checkRequired("enabled", enabled),
+                        maxConcurrentSubagents,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): MultiAgent = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                enabled()
+                maxConcurrentSubagents()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (enabled.asKnown().isPresent) 1 else 0) +
+                    (if (maxConcurrentSubagents.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is MultiAgent &&
+                    enabled == other.enabled &&
+                    maxConcurrentSubagents == other.maxConcurrentSubagents &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(enabled, maxConcurrentSubagents, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "MultiAgent{enabled=$enabled, maxConcurrentSubagents=$maxConcurrentSubagents, additionalProperties=$additionalProperties}"
+        }
+
+        /**
+         * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+         * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+         * content blocks with `prompt_cache_breakpoint`. Each request can write up to four
+         * breakpoints. For cache matching, OpenAI considers up to the latest 80 breakpoints in the
+         * conversation, without a content-block lookback limit. Set `mode` to `explicit` to disable
+         * the implicit breakpoint. The `ttl` defaults to `30m`, which is currently the only
+         * supported value. See the
+         * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+         * current details.
+         */
+        class PromptCacheOptions
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val mode: JsonField<Mode>,
+            private val ttl: JsonField<Ttl>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of(),
+                @JsonProperty("ttl") @ExcludeMissing ttl: JsonField<Ttl> = JsonMissing.of(),
+            ) : this(mode, ttl, mutableMapOf())
+
+            /**
+             * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults
+             * to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up
+             * to the latest three explicit breakpoints in the request. With `explicit`, OpenAI does
+             * not create an implicit breakpoint and writes up to the latest four explicit
+             * breakpoints. If there are no explicit breakpoints, the request does not use prompt
+             * caching.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun mode(): Optional<Mode> = mode.getOptional("mode")
+
+            /**
+             * The minimum lifetime applied to every implicit and explicit cache breakpoint written
+             * by the request. Defaults to `30m`, which is currently the only supported value. The
+             * backend may retain cache entries for longer.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun ttl(): Optional<Ttl> = ttl.getOptional("ttl")
+
+            /**
+             * Returns the raw JSON value of [mode].
+             *
+             * Unlike [mode], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+            /**
+             * Returns the raw JSON value of [ttl].
+             *
+             * Unlike [ttl], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("ttl") @ExcludeMissing fun _ttl(): JsonField<Ttl> = ttl
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [PromptCacheOptions].
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [PromptCacheOptions]. */
+            class Builder internal constructor() {
+
+                private var mode: JsonField<Mode> = JsonMissing.of()
+                private var ttl: JsonField<Ttl> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(promptCacheOptions: PromptCacheOptions) = apply {
+                    mode = promptCacheOptions.mode
+                    ttl = promptCacheOptions.ttl
+                    additionalProperties = promptCacheOptions.additionalProperties.toMutableMap()
+                }
+
+                /**
+                 * Controls whether OpenAI automatically creates an implicit cache breakpoint.
+                 * Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
+                 * and writes up to the latest three explicit breakpoints in the request. With
+                 * `explicit`, OpenAI does not create an implicit breakpoint and writes up to the
+                 * latest four explicit breakpoints. If there are no explicit breakpoints, the
+                 * request does not use prompt caching.
+                 */
+                fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+                /**
+                 * Sets [Builder.mode] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.mode] with a well-typed [Mode] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+                /**
+                 * The minimum lifetime applied to every implicit and explicit cache breakpoint
+                 * written by the request. Defaults to `30m`, which is currently the only supported
+                 * value. The backend may retain cache entries for longer.
+                 */
+                fun ttl(ttl: Ttl) = ttl(JsonField.of(ttl))
+
+                /**
+                 * Sets [Builder.ttl] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.ttl] with a well-typed [Ttl] value instead. This
+                 * method is primarily for setting the field to an undocumented or not yet supported
+                 * value.
+                 */
+                fun ttl(ttl: JsonField<Ttl>) = apply { this.ttl = ttl }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [PromptCacheOptions].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): PromptCacheOptions =
+                    PromptCacheOptions(mode, ttl, additionalProperties.toMutableMap())
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): PromptCacheOptions = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                mode().ifPresent { it.validate() }
+                ttl().ifPresent { it.validate() }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (mode.asKnown().getOrNull()?.validity() ?: 0) +
+                    (ttl.asKnown().getOrNull()?.validity() ?: 0)
+
+            /**
+             * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults
+             * to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up
+             * to the latest three explicit breakpoints in the request. With `explicit`, OpenAI does
+             * not create an implicit breakpoint and writes up to the latest four explicit
+             * breakpoints. If there are no explicit breakpoints, the request does not use prompt
+             * caching.
+             */
+            class Mode @JsonCreator private constructor(private val value: JsonField<String>) :
+                Enum {
+
+                /**
+                 * Returns this class instance's raw value.
+                 *
+                 * This is usually only useful if this instance was deserialized from data that
+                 * doesn't match any known member, and you want to know that value. For example, if
+                 * the SDK is on an older version than the API, then the API may respond with new
+                 * members that the SDK is unaware of.
+                 */
+                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+                companion object {
+
+                    @JvmField val IMPLICIT = of("implicit")
+
+                    @JvmField val EXPLICIT = of("explicit")
+
+                    @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+                }
+
+                /** An enum containing [Mode]'s known values. */
+                enum class Known {
+                    IMPLICIT,
+                    EXPLICIT,
+                }
+
+                /**
+                 * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+                 *
+                 * An instance of [Mode] can contain an unknown value in a couple of cases:
+                 * - It was deserialized from data that doesn't match any known member. For example,
+                 *   if the SDK is on an older version than the API, then the API may respond with
+                 *   new members that the SDK is unaware of.
+                 * - It was constructed with an arbitrary value using the [of] method.
+                 */
+                enum class Value {
+                    IMPLICIT,
+                    EXPLICIT,
+                    /**
+                     * An enum member indicating that [Mode] was instantiated with an unknown value.
+                     */
+                    _UNKNOWN,
+                }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value, or
+                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                 *
+                 * Use the [known] method instead if you're certain the value is always known or if
+                 * you want to throw for the unknown case.
+                 */
+                fun value(): Value =
+                    when (this) {
+                        IMPLICIT -> Value.IMPLICIT
+                        EXPLICIT -> Value.EXPLICIT
+                        else -> Value._UNKNOWN
+                    }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value.
+                 *
+                 * Use the [value] method instead if you're uncertain the value is always known and
+                 * don't want to throw for the unknown case.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                 *   known member.
+                 */
+                fun known(): Known =
+                    when (this) {
+                        IMPLICIT -> Known.IMPLICIT
+                        EXPLICIT -> Known.EXPLICIT
+                        else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                    }
+
+                /**
+                 * Returns this class instance's primitive wire representation.
+                 *
+                 * This differs from the [toString] method because that method is primarily for
+                 * debugging and generally doesn't throw.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value does not have
+                 *   the expected primitive type.
+                 */
+                fun asString(): String =
+                    _value().asString().orElseThrow {
+                        OpenAIInvalidDataException("Value is not a String")
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Mode = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    known()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Mode && value == other.value
+                }
+
+                override fun hashCode() = value.hashCode()
+
+                override fun toString() = value.toString()
+            }
+
+            /**
+             * The minimum lifetime applied to every implicit and explicit cache breakpoint written
+             * by the request. Defaults to `30m`, which is currently the only supported value. The
+             * backend may retain cache entries for longer.
+             */
+            class Ttl @JsonCreator private constructor(private val value: JsonField<String>) :
+                Enum {
+
+                /**
+                 * Returns this class instance's raw value.
+                 *
+                 * This is usually only useful if this instance was deserialized from data that
+                 * doesn't match any known member, and you want to know that value. For example, if
+                 * the SDK is on an older version than the API, then the API may respond with new
+                 * members that the SDK is unaware of.
+                 */
+                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+                companion object {
+
+                    @JvmField val _30M = of("30m")
+
+                    @JvmStatic fun of(value: String) = Ttl(JsonField.of(value))
+                }
+
+                /** An enum containing [Ttl]'s known values. */
+                enum class Known {
+                    _30M
+                }
+
+                /**
+                 * An enum containing [Ttl]'s known values, as well as an [_UNKNOWN] member.
+                 *
+                 * An instance of [Ttl] can contain an unknown value in a couple of cases:
+                 * - It was deserialized from data that doesn't match any known member. For example,
+                 *   if the SDK is on an older version than the API, then the API may respond with
+                 *   new members that the SDK is unaware of.
+                 * - It was constructed with an arbitrary value using the [of] method.
+                 */
+                enum class Value {
+                    _30M,
+                    /**
+                     * An enum member indicating that [Ttl] was instantiated with an unknown value.
+                     */
+                    _UNKNOWN,
+                }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value, or
+                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                 *
+                 * Use the [known] method instead if you're certain the value is always known or if
+                 * you want to throw for the unknown case.
+                 */
+                fun value(): Value =
+                    when (this) {
+                        _30M -> Value._30M
+                        else -> Value._UNKNOWN
+                    }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value.
+                 *
+                 * Use the [value] method instead if you're uncertain the value is always known and
+                 * don't want to throw for the unknown case.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                 *   known member.
+                 */
+                fun known(): Known =
+                    when (this) {
+                        _30M -> Known._30M
+                        else -> throw OpenAIInvalidDataException("Unknown Ttl: $value")
+                    }
+
+                /**
+                 * Returns this class instance's primitive wire representation.
+                 *
+                 * This differs from the [toString] method because that method is primarily for
+                 * debugging and generally doesn't throw.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value does not have
+                 *   the expected primitive type.
+                 */
+                fun asString(): String =
+                    _value().asString().orElseThrow {
+                        OpenAIInvalidDataException("Value is not a String")
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Ttl = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    known()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Ttl && value == other.value
+                }
+
+                override fun hashCode() = value.hashCode()
+
+                override fun toString() = value.toString()
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is PromptCacheOptions &&
+                    mode == other.mode &&
+                    ttl == other.ttl &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(mode, ttl, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "PromptCacheOptions{mode=$mode, ttl=$ttl, additionalProperties=$additionalProperties}"
+        }
+
+        /**
+         * Deprecated. Use `prompt_cache_options.ttl` instead.
+         *
+         * The retention policy for the prompt cache. Set to `24h` to enable extended prompt
+         * caching, which keeps cached prefixes active for longer, up to a maximum of 24 hours.
+         * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+         * This field expresses a maximum retention policy, while `prompt_cache_options.ttl`
+         * expresses a minimum cache lifetime. The two fields are independent and do not interact.
+         * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+         *
+         * For older models that support both `in_memory` and `24h`, the default depends on your
+         * organization's data retention policy:
+         * - Organizations without ZDR enabled default to `24h`.
+         * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is
+         *   not specified.
+         */
+        @Deprecated("deprecated")
+        class PromptCacheRetention
+        @JsonCreator
+        private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_MEMORY = of("in_memory")
+
+                @JvmField val _24H = of("24h")
+
+                @JvmStatic fun of(value: String) = PromptCacheRetention(JsonField.of(value))
+            }
+
+            /** An enum containing [PromptCacheRetention]'s known values. */
+            enum class Known {
+                IN_MEMORY,
+                _24H,
+            }
+
+            /**
+             * An enum containing [PromptCacheRetention]'s known values, as well as an [_UNKNOWN]
+             * member.
+             *
+             * An instance of [PromptCacheRetention] can contain an unknown value in a couple of
+             * cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_MEMORY,
+                _24H,
+                /**
+                 * An enum member indicating that [PromptCacheRetention] was instantiated with an
+                 * unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_MEMORY -> Value.IN_MEMORY
+                    _24H -> Value._24H
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_MEMORY -> Known.IN_MEMORY
+                    _24H -> Known._24H
+                    else -> throw OpenAIInvalidDataException("Unknown PromptCacheRetention: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): PromptCacheRetention = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is PromptCacheRetention && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * **gpt-5 and o-series models only**
+         *
+         * Configuration options for
+         * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+         */
+        class Reasoning
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val context: JsonField<Context>,
+            private val effort: JsonField<Effort>,
+            private val generateSummary: JsonField<GenerateSummary>,
+            private val mode: JsonField<Mode>,
+            private val summary: JsonField<Summary>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("context")
+                @ExcludeMissing
+                context: JsonField<Context> = JsonMissing.of(),
+                @JsonProperty("effort")
+                @ExcludeMissing
+                effort: JsonField<Effort> = JsonMissing.of(),
+                @JsonProperty("generate_summary")
+                @ExcludeMissing
+                generateSummary: JsonField<GenerateSummary> = JsonMissing.of(),
+                @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of(),
+                @JsonProperty("summary")
+                @ExcludeMissing
+                summary: JsonField<Summary> = JsonMissing.of(),
+            ) : this(context, effort, generateSummary, mode, summary, mutableMapOf())
+
+            /**
+             * Controls which reasoning items are rendered back to the model on later turns. When
+             * returned on a response, this is the effective reasoning context mode used for the
+             * response.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun context(): Optional<Context> = context.getOptional("context")
+
+            /**
+             * Constrains effort on reasoning for reasoning models. Currently supported values are
+             * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning
+             * effort can result in faster responses and fewer tokens used on reasoning in a
+             * response. Not all reasoning models support every value. See the
+             * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+             * model-specific support.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun effort(): Optional<Effort> = effort.getOptional("effort")
+
+            /**
+             * **Deprecated:** use `summary` instead.
+             *
+             * A summary of the reasoning performed by the model. This can be useful for debugging
+             * and understanding the model's reasoning process. One of `auto`, `concise`, or
+             * `detailed`.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            @Deprecated("deprecated")
+            fun generateSummary(): Optional<GenerateSummary> =
+                generateSummary.getOptional("generate_summary")
+
+            /**
+             * Controls the reasoning execution mode for the request.
+             *
+             * When returned on a response, this is the effective execution mode.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun mode(): Optional<Mode> = mode.getOptional("mode")
+
+            /**
+             * A summary of the reasoning performed by the model. This can be useful for debugging
+             * and understanding the model's reasoning process. One of `auto`, `concise`, or
+             * `detailed`.
+             *
+             * `concise` is supported for `computer-use-preview` models and all reasoning models
+             * after `gpt-5`.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun summary(): Optional<Summary> = summary.getOptional("summary")
+
+            /**
+             * Returns the raw JSON value of [context].
+             *
+             * Unlike [context], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("context") @ExcludeMissing fun _context(): JsonField<Context> = context
+
+            /**
+             * Returns the raw JSON value of [effort].
+             *
+             * Unlike [effort], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("effort") @ExcludeMissing fun _effort(): JsonField<Effort> = effort
+
+            /**
+             * Returns the raw JSON value of [generateSummary].
+             *
+             * Unlike [generateSummary], this method doesn't throw if the JSON field has an
+             * unexpected type.
+             */
+            @Deprecated("deprecated")
+            @JsonProperty("generate_summary")
+            @ExcludeMissing
+            fun _generateSummary(): JsonField<GenerateSummary> = generateSummary
+
+            /**
+             * Returns the raw JSON value of [mode].
+             *
+             * Unlike [mode], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+            /**
+             * Returns the raw JSON value of [summary].
+             *
+             * Unlike [summary], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("summary") @ExcludeMissing fun _summary(): JsonField<Summary> = summary
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /** Returns a mutable builder for constructing an instance of [Reasoning]. */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Reasoning]. */
+            class Builder internal constructor() {
+
+                private var context: JsonField<Context> = JsonMissing.of()
+                private var effort: JsonField<Effort> = JsonMissing.of()
+                private var generateSummary: JsonField<GenerateSummary> = JsonMissing.of()
+                private var mode: JsonField<Mode> = JsonMissing.of()
+                private var summary: JsonField<Summary> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(reasoning: Reasoning) = apply {
+                    context = reasoning.context
+                    effort = reasoning.effort
+                    generateSummary = reasoning.generateSummary
+                    mode = reasoning.mode
+                    summary = reasoning.summary
+                    additionalProperties = reasoning.additionalProperties.toMutableMap()
+                }
+
+                /**
+                 * Controls which reasoning items are rendered back to the model on later turns.
+                 * When returned on a response, this is the effective reasoning context mode used
+                 * for the response.
+                 */
+                fun context(context: Context?) = context(JsonField.ofNullable(context))
+
+                /** Alias for calling [Builder.context] with `context.orElse(null)`. */
+                fun context(context: Optional<Context>) = context(context.getOrNull())
+
+                /**
+                 * Sets [Builder.context] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.context] with a well-typed [Context] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun context(context: JsonField<Context>) = apply { this.context = context }
+
+                /**
+                 * Constrains effort on reasoning for reasoning models. Currently supported values
+                 * are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+                 * reasoning effort can result in faster responses and fewer tokens used on
+                 * reasoning in a response. Not all reasoning models support every value. See the
+                 * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                 * model-specific support.
+                 */
+                fun effort(effort: Effort?) = effort(JsonField.ofNullable(effort))
+
+                /** Alias for calling [Builder.effort] with `effort.orElse(null)`. */
+                fun effort(effort: Optional<Effort>) = effort(effort.getOrNull())
+
+                /**
+                 * Sets [Builder.effort] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.effort] with a well-typed [Effort] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun effort(effort: JsonField<Effort>) = apply { this.effort = effort }
+
+                /**
+                 * **Deprecated:** use `summary` instead.
+                 *
+                 * A summary of the reasoning performed by the model. This can be useful for
+                 * debugging and understanding the model's reasoning process. One of `auto`,
+                 * `concise`, or `detailed`.
+                 */
+                @Deprecated("deprecated")
+                fun generateSummary(generateSummary: GenerateSummary?) =
+                    generateSummary(JsonField.ofNullable(generateSummary))
+
+                /**
+                 * Alias for calling [Builder.generateSummary] with `generateSummary.orElse(null)`.
+                 */
+                @Deprecated("deprecated")
+                fun generateSummary(generateSummary: Optional<GenerateSummary>) =
+                    generateSummary(generateSummary.getOrNull())
+
+                /**
+                 * Sets [Builder.generateSummary] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.generateSummary] with a well-typed
+                 * [GenerateSummary] value instead. This method is primarily for setting the field
+                 * to an undocumented or not yet supported value.
+                 */
+                @Deprecated("deprecated")
+                fun generateSummary(generateSummary: JsonField<GenerateSummary>) = apply {
+                    this.generateSummary = generateSummary
+                }
+
+                /**
+                 * Controls the reasoning execution mode for the request.
+                 *
+                 * When returned on a response, this is the effective execution mode.
+                 */
+                fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+                /**
+                 * Sets [Builder.mode] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.mode] with a well-typed [Mode] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+                /**
+                 * Sets [mode] to an arbitrary [String].
+                 *
+                 * You should usually call [mode] with a well-typed [Mode] constant instead. This
+                 * method is primarily for setting the field to an undocumented or not yet supported
+                 * value.
+                 */
+                fun mode(value: String) = mode(Mode.of(value))
+
+                /**
+                 * A summary of the reasoning performed by the model. This can be useful for
+                 * debugging and understanding the model's reasoning process. One of `auto`,
+                 * `concise`, or `detailed`.
+                 *
+                 * `concise` is supported for `computer-use-preview` models and all reasoning models
+                 * after `gpt-5`.
+                 */
+                fun summary(summary: Summary?) = summary(JsonField.ofNullable(summary))
+
+                /** Alias for calling [Builder.summary] with `summary.orElse(null)`. */
+                fun summary(summary: Optional<Summary>) = summary(summary.getOrNull())
+
+                /**
+                 * Sets [Builder.summary] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.summary] with a well-typed [Summary] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun summary(summary: JsonField<Summary>) = apply { this.summary = summary }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Reasoning].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): Reasoning =
+                    Reasoning(
+                        context,
+                        effort,
+                        generateSummary,
+                        mode,
+                        summary,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Reasoning = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                context().ifPresent { it.validate() }
+                effort().ifPresent { it.validate() }
+                generateSummary().ifPresent { it.validate() }
+                mode()
+                summary().ifPresent { it.validate() }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (context.asKnown().getOrNull()?.validity() ?: 0) +
+                    (effort.asKnown().getOrNull()?.validity() ?: 0) +
+                    (generateSummary.asKnown().getOrNull()?.validity() ?: 0) +
+                    (if (mode.asKnown().isPresent) 1 else 0) +
+                    (summary.asKnown().getOrNull()?.validity() ?: 0)
+
+            /**
+             * Controls which reasoning items are rendered back to the model on later turns. When
+             * returned on a response, this is the effective reasoning context mode used for the
+             * response.
+             */
+            class Context @JsonCreator private constructor(private val value: JsonField<String>) :
+                Enum {
+
+                /**
+                 * Returns this class instance's raw value.
+                 *
+                 * This is usually only useful if this instance was deserialized from data that
+                 * doesn't match any known member, and you want to know that value. For example, if
+                 * the SDK is on an older version than the API, then the API may respond with new
+                 * members that the SDK is unaware of.
+                 */
+                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+                companion object {
+
+                    @JvmField val AUTO = of("auto")
+
+                    @JvmField val CURRENT_TURN = of("current_turn")
+
+                    @JvmField val ALL_TURNS = of("all_turns")
+
+                    @JvmStatic fun of(value: String) = Context(JsonField.of(value))
+                }
+
+                /** An enum containing [Context]'s known values. */
+                enum class Known {
+                    AUTO,
+                    CURRENT_TURN,
+                    ALL_TURNS,
+                }
+
+                /**
+                 * An enum containing [Context]'s known values, as well as an [_UNKNOWN] member.
+                 *
+                 * An instance of [Context] can contain an unknown value in a couple of cases:
+                 * - It was deserialized from data that doesn't match any known member. For example,
+                 *   if the SDK is on an older version than the API, then the API may respond with
+                 *   new members that the SDK is unaware of.
+                 * - It was constructed with an arbitrary value using the [of] method.
+                 */
+                enum class Value {
+                    AUTO,
+                    CURRENT_TURN,
+                    ALL_TURNS,
+                    /**
+                     * An enum member indicating that [Context] was instantiated with an unknown
+                     * value.
+                     */
+                    _UNKNOWN,
+                }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value, or
+                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                 *
+                 * Use the [known] method instead if you're certain the value is always known or if
+                 * you want to throw for the unknown case.
+                 */
+                fun value(): Value =
+                    when (this) {
+                        AUTO -> Value.AUTO
+                        CURRENT_TURN -> Value.CURRENT_TURN
+                        ALL_TURNS -> Value.ALL_TURNS
+                        else -> Value._UNKNOWN
+                    }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value.
+                 *
+                 * Use the [value] method instead if you're uncertain the value is always known and
+                 * don't want to throw for the unknown case.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                 *   known member.
+                 */
+                fun known(): Known =
+                    when (this) {
+                        AUTO -> Known.AUTO
+                        CURRENT_TURN -> Known.CURRENT_TURN
+                        ALL_TURNS -> Known.ALL_TURNS
+                        else -> throw OpenAIInvalidDataException("Unknown Context: $value")
+                    }
+
+                /**
+                 * Returns this class instance's primitive wire representation.
+                 *
+                 * This differs from the [toString] method because that method is primarily for
+                 * debugging and generally doesn't throw.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value does not have
+                 *   the expected primitive type.
+                 */
+                fun asString(): String =
+                    _value().asString().orElseThrow {
+                        OpenAIInvalidDataException("Value is not a String")
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Context = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    known()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Context && value == other.value
+                }
+
+                override fun hashCode() = value.hashCode()
+
+                override fun toString() = value.toString()
+            }
+
+            /**
+             * Constrains effort on reasoning for reasoning models. Currently supported values are
+             * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning
+             * effort can result in faster responses and fewer tokens used on reasoning in a
+             * response. Not all reasoning models support every value. See the
+             * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+             * model-specific support.
+             */
+            class Effort @JsonCreator private constructor(private val value: JsonField<String>) :
+                Enum {
+
+                /**
+                 * Returns this class instance's raw value.
+                 *
+                 * This is usually only useful if this instance was deserialized from data that
+                 * doesn't match any known member, and you want to know that value. For example, if
+                 * the SDK is on an older version than the API, then the API may respond with new
+                 * members that the SDK is unaware of.
+                 */
+                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+                companion object {
+
+                    @JvmField val NONE = of("none")
+
+                    @JvmField val MINIMAL = of("minimal")
+
+                    @JvmField val LOW = of("low")
+
+                    @JvmField val MEDIUM = of("medium")
+
+                    @JvmField val HIGH = of("high")
+
+                    @JvmField val XHIGH = of("xhigh")
+
+                    @JvmField val MAX = of("max")
+
+                    @JvmStatic fun of(value: String) = Effort(JsonField.of(value))
+                }
+
+                /** An enum containing [Effort]'s known values. */
+                enum class Known {
+                    NONE,
+                    MINIMAL,
+                    LOW,
+                    MEDIUM,
+                    HIGH,
+                    XHIGH,
+                    MAX,
+                }
+
+                /**
+                 * An enum containing [Effort]'s known values, as well as an [_UNKNOWN] member.
+                 *
+                 * An instance of [Effort] can contain an unknown value in a couple of cases:
+                 * - It was deserialized from data that doesn't match any known member. For example,
+                 *   if the SDK is on an older version than the API, then the API may respond with
+                 *   new members that the SDK is unaware of.
+                 * - It was constructed with an arbitrary value using the [of] method.
+                 */
+                enum class Value {
+                    NONE,
+                    MINIMAL,
+                    LOW,
+                    MEDIUM,
+                    HIGH,
+                    XHIGH,
+                    MAX,
+                    /**
+                     * An enum member indicating that [Effort] was instantiated with an unknown
+                     * value.
+                     */
+                    _UNKNOWN,
+                }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value, or
+                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                 *
+                 * Use the [known] method instead if you're certain the value is always known or if
+                 * you want to throw for the unknown case.
+                 */
+                fun value(): Value =
+                    when (this) {
+                        NONE -> Value.NONE
+                        MINIMAL -> Value.MINIMAL
+                        LOW -> Value.LOW
+                        MEDIUM -> Value.MEDIUM
+                        HIGH -> Value.HIGH
+                        XHIGH -> Value.XHIGH
+                        MAX -> Value.MAX
+                        else -> Value._UNKNOWN
+                    }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value.
+                 *
+                 * Use the [value] method instead if you're uncertain the value is always known and
+                 * don't want to throw for the unknown case.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                 *   known member.
+                 */
+                fun known(): Known =
+                    when (this) {
+                        NONE -> Known.NONE
+                        MINIMAL -> Known.MINIMAL
+                        LOW -> Known.LOW
+                        MEDIUM -> Known.MEDIUM
+                        HIGH -> Known.HIGH
+                        XHIGH -> Known.XHIGH
+                        MAX -> Known.MAX
+                        else -> throw OpenAIInvalidDataException("Unknown Effort: $value")
+                    }
+
+                /**
+                 * Returns this class instance's primitive wire representation.
+                 *
+                 * This differs from the [toString] method because that method is primarily for
+                 * debugging and generally doesn't throw.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value does not have
+                 *   the expected primitive type.
+                 */
+                fun asString(): String =
+                    _value().asString().orElseThrow {
+                        OpenAIInvalidDataException("Value is not a String")
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Effort = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    known()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Effort && value == other.value
+                }
+
+                override fun hashCode() = value.hashCode()
+
+                override fun toString() = value.toString()
+            }
+
+            /**
+             * **Deprecated:** use `summary` instead.
+             *
+             * A summary of the reasoning performed by the model. This can be useful for debugging
+             * and understanding the model's reasoning process. One of `auto`, `concise`, or
+             * `detailed`.
+             */
+            @Deprecated("deprecated")
+            class GenerateSummary
+            @JsonCreator
+            private constructor(private val value: JsonField<String>) : Enum {
+
+                /**
+                 * Returns this class instance's raw value.
+                 *
+                 * This is usually only useful if this instance was deserialized from data that
+                 * doesn't match any known member, and you want to know that value. For example, if
+                 * the SDK is on an older version than the API, then the API may respond with new
+                 * members that the SDK is unaware of.
+                 */
+                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+                companion object {
+
+                    @JvmField val AUTO = of("auto")
+
+                    @JvmField val CONCISE = of("concise")
+
+                    @JvmField val DETAILED = of("detailed")
+
+                    @JvmStatic fun of(value: String) = GenerateSummary(JsonField.of(value))
+                }
+
+                /** An enum containing [GenerateSummary]'s known values. */
+                enum class Known {
+                    AUTO,
+                    CONCISE,
+                    DETAILED,
+                }
+
+                /**
+                 * An enum containing [GenerateSummary]'s known values, as well as an [_UNKNOWN]
+                 * member.
+                 *
+                 * An instance of [GenerateSummary] can contain an unknown value in a couple of
+                 * cases:
+                 * - It was deserialized from data that doesn't match any known member. For example,
+                 *   if the SDK is on an older version than the API, then the API may respond with
+                 *   new members that the SDK is unaware of.
+                 * - It was constructed with an arbitrary value using the [of] method.
+                 */
+                enum class Value {
+                    AUTO,
+                    CONCISE,
+                    DETAILED,
+                    /**
+                     * An enum member indicating that [GenerateSummary] was instantiated with an
+                     * unknown value.
+                     */
+                    _UNKNOWN,
+                }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value, or
+                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                 *
+                 * Use the [known] method instead if you're certain the value is always known or if
+                 * you want to throw for the unknown case.
+                 */
+                fun value(): Value =
+                    when (this) {
+                        AUTO -> Value.AUTO
+                        CONCISE -> Value.CONCISE
+                        DETAILED -> Value.DETAILED
+                        else -> Value._UNKNOWN
+                    }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value.
+                 *
+                 * Use the [value] method instead if you're uncertain the value is always known and
+                 * don't want to throw for the unknown case.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                 *   known member.
+                 */
+                fun known(): Known =
+                    when (this) {
+                        AUTO -> Known.AUTO
+                        CONCISE -> Known.CONCISE
+                        DETAILED -> Known.DETAILED
+                        else -> throw OpenAIInvalidDataException("Unknown GenerateSummary: $value")
+                    }
+
+                /**
+                 * Returns this class instance's primitive wire representation.
+                 *
+                 * This differs from the [toString] method because that method is primarily for
+                 * debugging and generally doesn't throw.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value does not have
+                 *   the expected primitive type.
+                 */
+                fun asString(): String =
+                    _value().asString().orElseThrow {
+                        OpenAIInvalidDataException("Value is not a String")
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): GenerateSummary = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    known()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is GenerateSummary && value == other.value
+                }
+
+                override fun hashCode() = value.hashCode()
+
+                override fun toString() = value.toString()
+            }
+
+            /**
+             * Controls the reasoning execution mode for the request.
+             *
+             * When returned on a response, this is the effective execution mode.
+             */
+            class Mode @JsonCreator private constructor(private val value: JsonField<String>) :
+                Enum {
+
+                /**
+                 * Returns this class instance's raw value.
+                 *
+                 * This is usually only useful if this instance was deserialized from data that
+                 * doesn't match any known member, and you want to know that value. For example, if
+                 * the SDK is on an older version than the API, then the API may respond with new
+                 * members that the SDK is unaware of.
+                 */
+                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+                companion object {
+
+                    @JvmField val STANDARD = of("standard")
+
+                    @JvmField val PRO = of("pro")
+
+                    @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+                }
+
+                /** An enum containing [Mode]'s known values. */
+                enum class Known {
+                    STANDARD,
+                    PRO,
+                }
+
+                /**
+                 * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+                 *
+                 * An instance of [Mode] can contain an unknown value in a couple of cases:
+                 * - It was deserialized from data that doesn't match any known member. For example,
+                 *   if the SDK is on an older version than the API, then the API may respond with
+                 *   new members that the SDK is unaware of.
+                 * - It was constructed with an arbitrary value using the [of] method.
+                 */
+                enum class Value {
+                    STANDARD,
+                    PRO,
+                    /**
+                     * An enum member indicating that [Mode] was instantiated with an unknown value.
+                     */
+                    _UNKNOWN,
+                }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value, or
+                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                 *
+                 * Use the [known] method instead if you're certain the value is always known or if
+                 * you want to throw for the unknown case.
+                 */
+                fun value(): Value =
+                    when (this) {
+                        STANDARD -> Value.STANDARD
+                        PRO -> Value.PRO
+                        else -> Value._UNKNOWN
+                    }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value.
+                 *
+                 * Use the [value] method instead if you're uncertain the value is always known and
+                 * don't want to throw for the unknown case.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                 *   known member.
+                 */
+                fun known(): Known =
+                    when (this) {
+                        STANDARD -> Known.STANDARD
+                        PRO -> Known.PRO
+                        else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                    }
+
+                /**
+                 * Returns this class instance's primitive wire representation.
+                 *
+                 * This differs from the [toString] method because that method is primarily for
+                 * debugging and generally doesn't throw.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value does not have
+                 *   the expected primitive type.
+                 */
+                fun asString(): String =
+                    _value().asString().orElseThrow {
+                        OpenAIInvalidDataException("Value is not a String")
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Mode = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    known()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Mode && value == other.value
+                }
+
+                override fun hashCode() = value.hashCode()
+
+                override fun toString() = value.toString()
+            }
+
+            /**
+             * A summary of the reasoning performed by the model. This can be useful for debugging
+             * and understanding the model's reasoning process. One of `auto`, `concise`, or
+             * `detailed`.
+             *
+             * `concise` is supported for `computer-use-preview` models and all reasoning models
+             * after `gpt-5`.
+             */
+            class Summary @JsonCreator private constructor(private val value: JsonField<String>) :
+                Enum {
+
+                /**
+                 * Returns this class instance's raw value.
+                 *
+                 * This is usually only useful if this instance was deserialized from data that
+                 * doesn't match any known member, and you want to know that value. For example, if
+                 * the SDK is on an older version than the API, then the API may respond with new
+                 * members that the SDK is unaware of.
+                 */
+                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+                companion object {
+
+                    @JvmField val AUTO = of("auto")
+
+                    @JvmField val CONCISE = of("concise")
+
+                    @JvmField val DETAILED = of("detailed")
+
+                    @JvmStatic fun of(value: String) = Summary(JsonField.of(value))
+                }
+
+                /** An enum containing [Summary]'s known values. */
+                enum class Known {
+                    AUTO,
+                    CONCISE,
+                    DETAILED,
+                }
+
+                /**
+                 * An enum containing [Summary]'s known values, as well as an [_UNKNOWN] member.
+                 *
+                 * An instance of [Summary] can contain an unknown value in a couple of cases:
+                 * - It was deserialized from data that doesn't match any known member. For example,
+                 *   if the SDK is on an older version than the API, then the API may respond with
+                 *   new members that the SDK is unaware of.
+                 * - It was constructed with an arbitrary value using the [of] method.
+                 */
+                enum class Value {
+                    AUTO,
+                    CONCISE,
+                    DETAILED,
+                    /**
+                     * An enum member indicating that [Summary] was instantiated with an unknown
+                     * value.
+                     */
+                    _UNKNOWN,
+                }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value, or
+                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                 *
+                 * Use the [known] method instead if you're certain the value is always known or if
+                 * you want to throw for the unknown case.
+                 */
+                fun value(): Value =
+                    when (this) {
+                        AUTO -> Value.AUTO
+                        CONCISE -> Value.CONCISE
+                        DETAILED -> Value.DETAILED
+                        else -> Value._UNKNOWN
+                    }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value.
+                 *
+                 * Use the [value] method instead if you're uncertain the value is always known and
+                 * don't want to throw for the unknown case.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                 *   known member.
+                 */
+                fun known(): Known =
+                    when (this) {
+                        AUTO -> Known.AUTO
+                        CONCISE -> Known.CONCISE
+                        DETAILED -> Known.DETAILED
+                        else -> throw OpenAIInvalidDataException("Unknown Summary: $value")
+                    }
+
+                /**
+                 * Returns this class instance's primitive wire representation.
+                 *
+                 * This differs from the [toString] method because that method is primarily for
+                 * debugging and generally doesn't throw.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value does not have
+                 *   the expected primitive type.
+                 */
+                fun asString(): String =
+                    _value().asString().orElseThrow {
+                        OpenAIInvalidDataException("Value is not a String")
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Summary = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    known()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Summary && value == other.value
+                }
+
+                override fun hashCode() = value.hashCode()
+
+                override fun toString() = value.toString()
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Reasoning &&
+                    context == other.context &&
+                    effort == other.effort &&
+                    generateSummary == other.generateSummary &&
+                    mode == other.mode &&
+                    summary == other.summary &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(context, effort, generateSummary, mode, summary, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Reasoning{context=$context, effort=$effort, generateSummary=$generateSummary, mode=$mode, summary=$summary, additionalProperties=$additionalProperties}"
+        }
+
+        /**
+         * Specifies the processing type used for serving the request.
+         * - If set to 'auto', then the request will be processed with the service tier configured
+         *   in the Project settings. Unless otherwise configured, the Project will use 'default'.
+         * - If set to 'default', then the request will be processed with the standard pricing and
+         *   performance for the selected model.
+         * - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
+         *   '[priority](https://openai.com/api-priority-processing/)', then the request will be
+         *   processed with the corresponding service tier.
+         * - When not set, the default behavior is 'auto'.
+         *
+         *   When the `service_tier` parameter is set, the response body will include the
+         *   `service_tier` value based on the processing mode actually used to serve the request.
+         *   This response value may be different from the value set in the parameter.
+         */
+        class ServiceTier @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmField val DEFAULT = of("default")
+
+                @JvmField val FLEX = of("flex")
+
+                @JvmField val SCALE = of("scale")
+
+                @JvmField val PRIORITY = of("priority")
+
+                @JvmStatic fun of(value: String) = ServiceTier(JsonField.of(value))
+            }
+
+            /** An enum containing [ServiceTier]'s known values. */
+            enum class Known {
+                AUTO,
+                DEFAULT,
+                FLEX,
+                SCALE,
+                PRIORITY,
+            }
+
+            /**
+             * An enum containing [ServiceTier]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [ServiceTier] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                AUTO,
+                DEFAULT,
+                FLEX,
+                SCALE,
+                PRIORITY,
+                /**
+                 * An enum member indicating that [ServiceTier] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    AUTO -> Value.AUTO
+                    DEFAULT -> Value.DEFAULT
+                    FLEX -> Value.FLEX
+                    SCALE -> Value.SCALE
+                    PRIORITY -> Value.PRIORITY
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    AUTO -> Known.AUTO
+                    DEFAULT -> Known.DEFAULT
+                    FLEX -> Known.FLEX
+                    SCALE -> Known.SCALE
+                    PRIORITY -> Known.PRIORITY
+                    else -> throw OpenAIInvalidDataException("Unknown ServiceTier: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): ServiceTier = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is ServiceTier && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** Options for streaming responses. Only set this when you set `stream: true`. */
+        class StreamOptions
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val includeObfuscation: JsonField<Boolean>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("include_obfuscation")
+                @ExcludeMissing
+                includeObfuscation: JsonField<Boolean> = JsonMissing.of()
+            ) : this(includeObfuscation, mutableMapOf())
+
+            /**
+             * When true, stream obfuscation will be enabled. Stream obfuscation adds random
+             * characters to an `obfuscation` field on streaming delta events to normalize payload
+             * sizes as a mitigation to certain side-channel attacks. These obfuscation fields are
+             * included by default, but add a small amount of overhead to the data stream. You can
+             * set `include_obfuscation` to false to optimize for bandwidth if you trust the network
+             * links between your application and the OpenAI API.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun includeObfuscation(): Optional<Boolean> =
+                includeObfuscation.getOptional("include_obfuscation")
+
+            /**
+             * Returns the raw JSON value of [includeObfuscation].
+             *
+             * Unlike [includeObfuscation], this method doesn't throw if the JSON field has an
+             * unexpected type.
+             */
+            @JsonProperty("include_obfuscation")
+            @ExcludeMissing
+            fun _includeObfuscation(): JsonField<Boolean> = includeObfuscation
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /** Returns a mutable builder for constructing an instance of [StreamOptions]. */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [StreamOptions]. */
+            class Builder internal constructor() {
+
+                private var includeObfuscation: JsonField<Boolean> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(streamOptions: StreamOptions) = apply {
+                    includeObfuscation = streamOptions.includeObfuscation
+                    additionalProperties = streamOptions.additionalProperties.toMutableMap()
+                }
+
+                /**
+                 * When true, stream obfuscation will be enabled. Stream obfuscation adds random
+                 * characters to an `obfuscation` field on streaming delta events to normalize
+                 * payload sizes as a mitigation to certain side-channel attacks. These obfuscation
+                 * fields are included by default, but add a small amount of overhead to the data
+                 * stream. You can set `include_obfuscation` to false to optimize for bandwidth if
+                 * you trust the network links between your application and the OpenAI API.
+                 */
+                fun includeObfuscation(includeObfuscation: Boolean) =
+                    includeObfuscation(JsonField.of(includeObfuscation))
+
+                /**
+                 * Sets [Builder.includeObfuscation] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.includeObfuscation] with a well-typed [Boolean]
+                 * value instead. This method is primarily for setting the field to an undocumented
+                 * or not yet supported value.
+                 */
+                fun includeObfuscation(includeObfuscation: JsonField<Boolean>) = apply {
+                    this.includeObfuscation = includeObfuscation
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [StreamOptions].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): StreamOptions =
+                    StreamOptions(includeObfuscation, additionalProperties.toMutableMap())
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): StreamOptions = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                includeObfuscation()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int = (if (includeObfuscation.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is StreamOptions &&
+                    includeObfuscation == other.includeObfuscation &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(includeObfuscation, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "StreamOptions{includeObfuscation=$includeObfuscation, additionalProperties=$additionalProperties}"
+        }
+
+        /**
+         * How the model should select which tool (or tools) to use when generating a response. See
+         * the `tools` parameter to see how to specify which tools the model can call.
+         */
+        @JsonDeserialize(using = ToolChoice.Deserializer::class)
+        @JsonSerialize(using = ToolChoice.Serializer::class)
+        class ToolChoice
+        private constructor(
+            private val betaToolChoiceOptions: BetaToolChoiceOptions? = null,
+            private val betaToolChoiceAllowed: BetaToolChoiceAllowed? = null,
+            private val betaToolChoiceTypes: BetaToolChoiceTypes? = null,
+            private val betaToolChoiceFunction: BetaToolChoiceFunction? = null,
+            private val betaToolChoiceMcp: BetaToolChoiceMcp? = null,
+            private val betaToolChoiceCustom: BetaToolChoiceCustom? = null,
+            private val betaSpecificProgrammaticToolCallingParam: JsonValue? = null,
+            private val betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch? = null,
+            private val betaToolChoiceShell: BetaToolChoiceShell? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /**
+             * Controls which (if any) tool is called by the model.
+             *
+             * `none` means the model will not call any tool and instead generates a message.
+             *
+             * `auto` means the model can pick between generating a message or calling one or more
+             * tools.
+             *
+             * `required` means the model must call one or more tools.
+             */
+            fun betaToolChoiceOptions(): Optional<BetaToolChoiceOptions> =
+                Optional.ofNullable(betaToolChoiceOptions)
+
+            /** Constrains the tools available to the model to a pre-defined set. */
+            fun betaToolChoiceAllowed(): Optional<BetaToolChoiceAllowed> =
+                Optional.ofNullable(betaToolChoiceAllowed)
+
+            /**
+             * Indicates that the model should use a built-in tool to generate a response.
+             * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+             */
+            fun betaToolChoiceTypes(): Optional<BetaToolChoiceTypes> =
+                Optional.ofNullable(betaToolChoiceTypes)
+
+            /** Use this option to force the model to call a specific function. */
+            fun betaToolChoiceFunction(): Optional<BetaToolChoiceFunction> =
+                Optional.ofNullable(betaToolChoiceFunction)
+
+            /**
+             * Use this option to force the model to call a specific tool on a remote MCP server.
+             */
+            fun betaToolChoiceMcp(): Optional<BetaToolChoiceMcp> =
+                Optional.ofNullable(betaToolChoiceMcp)
+
+            /** Use this option to force the model to call a specific custom tool. */
+            fun betaToolChoiceCustom(): Optional<BetaToolChoiceCustom> =
+                Optional.ofNullable(betaToolChoiceCustom)
+
+            fun betaSpecificProgrammaticToolCallingParam(): Optional<JsonValue> =
+                Optional.ofNullable(betaSpecificProgrammaticToolCallingParam)
+
+            /** Forces the model to call the apply_patch tool when executing a tool call. */
+            fun betaToolChoiceApplyPatch(): Optional<BetaToolChoiceApplyPatch> =
+                Optional.ofNullable(betaToolChoiceApplyPatch)
+
+            /** Forces the model to call the shell tool when a tool call is required. */
+            fun betaToolChoiceShell(): Optional<BetaToolChoiceShell> =
+                Optional.ofNullable(betaToolChoiceShell)
+
+            fun isBetaToolChoiceOptions(): Boolean = betaToolChoiceOptions != null
+
+            fun isBetaToolChoiceAllowed(): Boolean = betaToolChoiceAllowed != null
+
+            fun isBetaToolChoiceTypes(): Boolean = betaToolChoiceTypes != null
+
+            fun isBetaToolChoiceFunction(): Boolean = betaToolChoiceFunction != null
+
+            fun isBetaToolChoiceMcp(): Boolean = betaToolChoiceMcp != null
+
+            fun isBetaToolChoiceCustom(): Boolean = betaToolChoiceCustom != null
+
+            fun isBetaSpecificProgrammaticToolCallingParam(): Boolean =
+                betaSpecificProgrammaticToolCallingParam != null
+
+            fun isBetaToolChoiceApplyPatch(): Boolean = betaToolChoiceApplyPatch != null
+
+            fun isBetaToolChoiceShell(): Boolean = betaToolChoiceShell != null
+
+            /**
+             * Controls which (if any) tool is called by the model.
+             *
+             * `none` means the model will not call any tool and instead generates a message.
+             *
+             * `auto` means the model can pick between generating a message or calling one or more
+             * tools.
+             *
+             * `required` means the model must call one or more tools.
+             */
+            fun asBetaToolChoiceOptions(): BetaToolChoiceOptions =
+                betaToolChoiceOptions.getOrThrow("betaToolChoiceOptions")
+
+            /** Constrains the tools available to the model to a pre-defined set. */
+            fun asBetaToolChoiceAllowed(): BetaToolChoiceAllowed =
+                betaToolChoiceAllowed.getOrThrow("betaToolChoiceAllowed")
+
+            /**
+             * Indicates that the model should use a built-in tool to generate a response.
+             * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+             */
+            fun asBetaToolChoiceTypes(): BetaToolChoiceTypes =
+                betaToolChoiceTypes.getOrThrow("betaToolChoiceTypes")
+
+            /** Use this option to force the model to call a specific function. */
+            fun asBetaToolChoiceFunction(): BetaToolChoiceFunction =
+                betaToolChoiceFunction.getOrThrow("betaToolChoiceFunction")
+
+            /**
+             * Use this option to force the model to call a specific tool on a remote MCP server.
+             */
+            fun asBetaToolChoiceMcp(): BetaToolChoiceMcp =
+                betaToolChoiceMcp.getOrThrow("betaToolChoiceMcp")
+
+            /** Use this option to force the model to call a specific custom tool. */
+            fun asBetaToolChoiceCustom(): BetaToolChoiceCustom =
+                betaToolChoiceCustom.getOrThrow("betaToolChoiceCustom")
+
+            fun asBetaSpecificProgrammaticToolCallingParam(): JsonValue =
+                betaSpecificProgrammaticToolCallingParam.getOrThrow(
+                    "betaSpecificProgrammaticToolCallingParam"
+                )
+
+            /** Forces the model to call the apply_patch tool when executing a tool call. */
+            fun asBetaToolChoiceApplyPatch(): BetaToolChoiceApplyPatch =
+                betaToolChoiceApplyPatch.getOrThrow("betaToolChoiceApplyPatch")
+
+            /** Forces the model to call the shell tool when a tool call is required. */
+            fun asBetaToolChoiceShell(): BetaToolChoiceShell =
+                betaToolChoiceShell.getOrThrow("betaToolChoiceShell")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = toolChoice.accept(new ToolChoice.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitBetaToolChoiceOptions(BetaToolChoiceOptions betaToolChoiceOptions) {
+             *         return Optional.of(betaToolChoiceOptions.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    betaToolChoiceOptions != null ->
+                        visitor.visitBetaToolChoiceOptions(betaToolChoiceOptions)
+                    betaToolChoiceAllowed != null ->
+                        visitor.visitBetaToolChoiceAllowed(betaToolChoiceAllowed)
+                    betaToolChoiceTypes != null ->
+                        visitor.visitBetaToolChoiceTypes(betaToolChoiceTypes)
+                    betaToolChoiceFunction != null ->
+                        visitor.visitBetaToolChoiceFunction(betaToolChoiceFunction)
+                    betaToolChoiceMcp != null -> visitor.visitBetaToolChoiceMcp(betaToolChoiceMcp)
+                    betaToolChoiceCustom != null ->
+                        visitor.visitBetaToolChoiceCustom(betaToolChoiceCustom)
+                    betaSpecificProgrammaticToolCallingParam != null ->
+                        visitor.visitBetaSpecificProgrammaticToolCallingParam(
+                            betaSpecificProgrammaticToolCallingParam
+                        )
+                    betaToolChoiceApplyPatch != null ->
+                        visitor.visitBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch)
+                    betaToolChoiceShell != null ->
+                        visitor.visitBetaToolChoiceShell(betaToolChoiceShell)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): ToolChoice = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitBetaToolChoiceOptions(
+                            betaToolChoiceOptions: BetaToolChoiceOptions
+                        ) {
+                            betaToolChoiceOptions.validate()
+                        }
+
+                        override fun visitBetaToolChoiceAllowed(
+                            betaToolChoiceAllowed: BetaToolChoiceAllowed
+                        ) {
+                            betaToolChoiceAllowed.validate()
+                        }
+
+                        override fun visitBetaToolChoiceTypes(
+                            betaToolChoiceTypes: BetaToolChoiceTypes
+                        ) {
+                            betaToolChoiceTypes.validate()
+                        }
+
+                        override fun visitBetaToolChoiceFunction(
+                            betaToolChoiceFunction: BetaToolChoiceFunction
+                        ) {
+                            betaToolChoiceFunction.validate()
+                        }
+
+                        override fun visitBetaToolChoiceMcp(betaToolChoiceMcp: BetaToolChoiceMcp) {
+                            betaToolChoiceMcp.validate()
+                        }
+
+                        override fun visitBetaToolChoiceCustom(
+                            betaToolChoiceCustom: BetaToolChoiceCustom
+                        ) {
+                            betaToolChoiceCustom.validate()
+                        }
+
+                        override fun visitBetaSpecificProgrammaticToolCallingParam(
+                            betaSpecificProgrammaticToolCallingParam: JsonValue
+                        ) {
+                            betaSpecificProgrammaticToolCallingParam.let {
+                                if (
+                                    it !=
+                                        JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                                ) {
+                                    throw OpenAIInvalidDataException(
+                                        "'betaSpecificProgrammaticToolCallingParam' is invalid, received $it"
+                                    )
+                                }
+                            }
+                        }
+
+                        override fun visitBetaToolChoiceApplyPatch(
+                            betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch
+                        ) {
+                            betaToolChoiceApplyPatch.validate()
+                        }
+
+                        override fun visitBetaToolChoiceShell(
+                            betaToolChoiceShell: BetaToolChoiceShell
+                        ) {
+                            betaToolChoiceShell.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitBetaToolChoiceOptions(
+                            betaToolChoiceOptions: BetaToolChoiceOptions
+                        ) = betaToolChoiceOptions.validity()
+
+                        override fun visitBetaToolChoiceAllowed(
+                            betaToolChoiceAllowed: BetaToolChoiceAllowed
+                        ) = betaToolChoiceAllowed.validity()
+
+                        override fun visitBetaToolChoiceTypes(
+                            betaToolChoiceTypes: BetaToolChoiceTypes
+                        ) = betaToolChoiceTypes.validity()
+
+                        override fun visitBetaToolChoiceFunction(
+                            betaToolChoiceFunction: BetaToolChoiceFunction
+                        ) = betaToolChoiceFunction.validity()
+
+                        override fun visitBetaToolChoiceMcp(betaToolChoiceMcp: BetaToolChoiceMcp) =
+                            betaToolChoiceMcp.validity()
+
+                        override fun visitBetaToolChoiceCustom(
+                            betaToolChoiceCustom: BetaToolChoiceCustom
+                        ) = betaToolChoiceCustom.validity()
+
+                        override fun visitBetaSpecificProgrammaticToolCallingParam(
+                            betaSpecificProgrammaticToolCallingParam: JsonValue
+                        ) =
+                            betaSpecificProgrammaticToolCallingParam.let {
+                                if (
+                                    it ==
+                                        JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                                )
+                                    1
+                                else 0
+                            }
+
+                        override fun visitBetaToolChoiceApplyPatch(
+                            betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch
+                        ) = betaToolChoiceApplyPatch.validity()
+
+                        override fun visitBetaToolChoiceShell(
+                            betaToolChoiceShell: BetaToolChoiceShell
+                        ) = betaToolChoiceShell.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is ToolChoice &&
+                    betaToolChoiceOptions == other.betaToolChoiceOptions &&
+                    betaToolChoiceAllowed == other.betaToolChoiceAllowed &&
+                    betaToolChoiceTypes == other.betaToolChoiceTypes &&
+                    betaToolChoiceFunction == other.betaToolChoiceFunction &&
+                    betaToolChoiceMcp == other.betaToolChoiceMcp &&
+                    betaToolChoiceCustom == other.betaToolChoiceCustom &&
+                    betaSpecificProgrammaticToolCallingParam ==
+                        other.betaSpecificProgrammaticToolCallingParam &&
+                    betaToolChoiceApplyPatch == other.betaToolChoiceApplyPatch &&
+                    betaToolChoiceShell == other.betaToolChoiceShell
+            }
+
+            override fun hashCode(): Int =
+                Objects.hash(
+                    betaToolChoiceOptions,
+                    betaToolChoiceAllowed,
+                    betaToolChoiceTypes,
+                    betaToolChoiceFunction,
+                    betaToolChoiceMcp,
+                    betaToolChoiceCustom,
+                    betaSpecificProgrammaticToolCallingParam,
+                    betaToolChoiceApplyPatch,
+                    betaToolChoiceShell,
+                )
+
+            override fun toString(): String =
+                when {
+                    betaToolChoiceOptions != null ->
+                        "ToolChoice{betaToolChoiceOptions=$betaToolChoiceOptions}"
+                    betaToolChoiceAllowed != null ->
+                        "ToolChoice{betaToolChoiceAllowed=$betaToolChoiceAllowed}"
+                    betaToolChoiceTypes != null ->
+                        "ToolChoice{betaToolChoiceTypes=$betaToolChoiceTypes}"
+                    betaToolChoiceFunction != null ->
+                        "ToolChoice{betaToolChoiceFunction=$betaToolChoiceFunction}"
+                    betaToolChoiceMcp != null -> "ToolChoice{betaToolChoiceMcp=$betaToolChoiceMcp}"
+                    betaToolChoiceCustom != null ->
+                        "ToolChoice{betaToolChoiceCustom=$betaToolChoiceCustom}"
+                    betaSpecificProgrammaticToolCallingParam != null ->
+                        "ToolChoice{betaSpecificProgrammaticToolCallingParam=$betaSpecificProgrammaticToolCallingParam}"
+                    betaToolChoiceApplyPatch != null ->
+                        "ToolChoice{betaToolChoiceApplyPatch=$betaToolChoiceApplyPatch}"
+                    betaToolChoiceShell != null ->
+                        "ToolChoice{betaToolChoiceShell=$betaToolChoiceShell}"
+                    _json != null -> "ToolChoice{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid ToolChoice")
+                }
+
+            companion object {
+
+                /**
+                 * Controls which (if any) tool is called by the model.
+                 *
+                 * `none` means the model will not call any tool and instead generates a message.
+                 *
+                 * `auto` means the model can pick between generating a message or calling one or
+                 * more tools.
+                 *
+                 * `required` means the model must call one or more tools.
+                 */
+                @JvmStatic
+                fun ofBetaToolChoiceOptions(betaToolChoiceOptions: BetaToolChoiceOptions) =
+                    ToolChoice(betaToolChoiceOptions = betaToolChoiceOptions)
+
+                /** Constrains the tools available to the model to a pre-defined set. */
+                @JvmStatic
+                fun ofBetaToolChoiceAllowed(betaToolChoiceAllowed: BetaToolChoiceAllowed) =
+                    ToolChoice(betaToolChoiceAllowed = betaToolChoiceAllowed)
+
+                /**
+                 * Indicates that the model should use a built-in tool to generate a response.
+                 * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+                 */
+                @JvmStatic
+                fun ofBetaToolChoiceTypes(betaToolChoiceTypes: BetaToolChoiceTypes) =
+                    ToolChoice(betaToolChoiceTypes = betaToolChoiceTypes)
+
+                /** Use this option to force the model to call a specific function. */
+                @JvmStatic
+                fun ofBetaToolChoiceFunction(betaToolChoiceFunction: BetaToolChoiceFunction) =
+                    ToolChoice(betaToolChoiceFunction = betaToolChoiceFunction)
+
+                /**
+                 * Use this option to force the model to call a specific tool on a remote MCP
+                 * server.
+                 */
+                @JvmStatic
+                fun ofBetaToolChoiceMcp(betaToolChoiceMcp: BetaToolChoiceMcp) =
+                    ToolChoice(betaToolChoiceMcp = betaToolChoiceMcp)
+
+                /** Use this option to force the model to call a specific custom tool. */
+                @JvmStatic
+                fun ofBetaToolChoiceCustom(betaToolChoiceCustom: BetaToolChoiceCustom) =
+                    ToolChoice(betaToolChoiceCustom = betaToolChoiceCustom)
+
+                @JvmStatic
+                fun ofBetaSpecificProgrammaticToolCallingParam() =
+                    ToolChoice(
+                        betaSpecificProgrammaticToolCallingParam =
+                            JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                    )
+
+                /** Forces the model to call the apply_patch tool when executing a tool call. */
+                @JvmStatic
+                fun ofBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch) =
+                    ToolChoice(betaToolChoiceApplyPatch = betaToolChoiceApplyPatch)
+
+                /** Forces the model to call the shell tool when a tool call is required. */
+                @JvmStatic
+                fun ofBetaToolChoiceShell(betaToolChoiceShell: BetaToolChoiceShell) =
+                    ToolChoice(betaToolChoiceShell = betaToolChoiceShell)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [ToolChoice] to a value of type
+             * [T].
+             */
+            interface Visitor<out T> {
+
+                /**
+                 * Controls which (if any) tool is called by the model.
+                 *
+                 * `none` means the model will not call any tool and instead generates a message.
+                 *
+                 * `auto` means the model can pick between generating a message or calling one or
+                 * more tools.
+                 *
+                 * `required` means the model must call one or more tools.
+                 */
+                fun visitBetaToolChoiceOptions(betaToolChoiceOptions: BetaToolChoiceOptions): T
+
+                /** Constrains the tools available to the model to a pre-defined set. */
+                fun visitBetaToolChoiceAllowed(betaToolChoiceAllowed: BetaToolChoiceAllowed): T
+
+                /**
+                 * Indicates that the model should use a built-in tool to generate a response.
+                 * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+                 */
+                fun visitBetaToolChoiceTypes(betaToolChoiceTypes: BetaToolChoiceTypes): T
+
+                /** Use this option to force the model to call a specific function. */
+                fun visitBetaToolChoiceFunction(betaToolChoiceFunction: BetaToolChoiceFunction): T
+
+                /**
+                 * Use this option to force the model to call a specific tool on a remote MCP
+                 * server.
+                 */
+                fun visitBetaToolChoiceMcp(betaToolChoiceMcp: BetaToolChoiceMcp): T
+
+                /** Use this option to force the model to call a specific custom tool. */
+                fun visitBetaToolChoiceCustom(betaToolChoiceCustom: BetaToolChoiceCustom): T
+
+                fun visitBetaSpecificProgrammaticToolCallingParam(
+                    betaSpecificProgrammaticToolCallingParam: JsonValue
+                ): T
+
+                /** Forces the model to call the apply_patch tool when executing a tool call. */
+                fun visitBetaToolChoiceApplyPatch(
+                    betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch
+                ): T
+
+                /** Forces the model to call the shell tool when a tool call is required. */
+                fun visitBetaToolChoiceShell(betaToolChoiceShell: BetaToolChoiceShell): T
+
+                /**
+                 * Maps an unknown variant of [ToolChoice] to a value of type [T].
+                 *
+                 * An instance of [ToolChoice] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown ToolChoice: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<ToolChoice>(ToolChoice::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): ToolChoice {
+                    val json = JsonValue.fromJsonNode(node)
+
+                    val bestMatches =
+                        sequenceOf(
+                                tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                    ?.let {
+                                        ToolChoice(
+                                            betaSpecificProgrammaticToolCallingParam = it,
+                                            _json = json,
+                                        )
+                                    }
+                                    ?.takeIf { it.isValid() },
+                                tryDeserialize(node, jacksonTypeRef<BetaToolChoiceOptions>())?.let {
+                                    ToolChoice(betaToolChoiceOptions = it, _json = json)
+                                },
+                                tryDeserialize(node, jacksonTypeRef<BetaToolChoiceAllowed>())?.let {
+                                    ToolChoice(betaToolChoiceAllowed = it, _json = json)
+                                },
+                                tryDeserialize(node, jacksonTypeRef<BetaToolChoiceTypes>())?.let {
+                                    ToolChoice(betaToolChoiceTypes = it, _json = json)
+                                },
+                                tryDeserialize(node, jacksonTypeRef<BetaToolChoiceFunction>())
+                                    ?.let { ToolChoice(betaToolChoiceFunction = it, _json = json) },
+                                tryDeserialize(node, jacksonTypeRef<BetaToolChoiceMcp>())?.let {
+                                    ToolChoice(betaToolChoiceMcp = it, _json = json)
+                                },
+                                tryDeserialize(node, jacksonTypeRef<BetaToolChoiceCustom>())?.let {
+                                    ToolChoice(betaToolChoiceCustom = it, _json = json)
+                                },
+                                tryDeserialize(node, jacksonTypeRef<BetaToolChoiceApplyPatch>())
+                                    ?.let {
+                                        ToolChoice(betaToolChoiceApplyPatch = it, _json = json)
+                                    },
+                                tryDeserialize(node, jacksonTypeRef<BetaToolChoiceShell>())?.let {
+                                    ToolChoice(betaToolChoiceShell = it, _json = json)
+                                },
+                            )
+                            .filterNotNull()
+                            .allMaxBy { it.validity() }
+                            .toList()
+                    return when (bestMatches.size) {
+                        // This can happen if what we're deserializing is completely incompatible
+                        // with all the possible variants (e.g. deserializing from boolean).
+                        0 -> ToolChoice(_json = json)
+                        1 -> bestMatches.single()
+                        // If there's more than one match with the highest validity, then use the
+                        // first completely valid match, or simply the first match if none are
+                        // completely valid.
+                        else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                    }
+                }
+            }
+
+            internal class Serializer : BaseSerializer<ToolChoice>(ToolChoice::class) {
+
+                override fun serialize(
+                    value: ToolChoice,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.betaToolChoiceOptions != null ->
+                            generator.writeObject(value.betaToolChoiceOptions)
+                        value.betaToolChoiceAllowed != null ->
+                            generator.writeObject(value.betaToolChoiceAllowed)
+                        value.betaToolChoiceTypes != null ->
+                            generator.writeObject(value.betaToolChoiceTypes)
+                        value.betaToolChoiceFunction != null ->
+                            generator.writeObject(value.betaToolChoiceFunction)
+                        value.betaToolChoiceMcp != null ->
+                            generator.writeObject(value.betaToolChoiceMcp)
+                        value.betaToolChoiceCustom != null ->
+                            generator.writeObject(value.betaToolChoiceCustom)
+                        value.betaSpecificProgrammaticToolCallingParam != null ->
+                            generator.writeObject(value.betaSpecificProgrammaticToolCallingParam)
+                        value.betaToolChoiceApplyPatch != null ->
+                            generator.writeObject(value.betaToolChoiceApplyPatch)
+                        value.betaToolChoiceShell != null ->
+                            generator.writeObject(value.betaToolChoiceShell)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid ToolChoice")
+                    }
+                }
+            }
+        }
+
+        /**
+         * The truncation strategy to use for the model response.
+         * - `auto`: If the input to this Response exceeds the model's context window size, the
+         *   model will truncate the response to fit the context window by dropping items from the
+         *   beginning of the conversation.
+         * - `disabled` (default): If the input size will exceed the context window size for a
+         *   model, the request will fail with a 400 error.
+         */
+        @Deprecated("deprecated")
+        class Truncation @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmField val DISABLED = of("disabled")
+
+                @JvmStatic fun of(value: String) = Truncation(JsonField.of(value))
+            }
+
+            /** An enum containing [Truncation]'s known values. */
+            enum class Known {
+                AUTO,
+                DISABLED,
+            }
+
+            /**
+             * An enum containing [Truncation]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Truncation] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                AUTO,
+                DISABLED,
+                /**
+                 * An enum member indicating that [Truncation] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    AUTO -> Value.AUTO
+                    DISABLED -> Value.DISABLED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    AUTO -> Known.AUTO
+                    DISABLED -> Known.DISABLED
+                    else -> throw OpenAIInvalidDataException("Unknown Truncation: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Truncation = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Truncation && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ResponseCreate &&
+                type == other.type &&
+                background == other.background &&
+                contextManagement == other.contextManagement &&
+                conversation == other.conversation &&
+                include == other.include &&
+                input == other.input &&
+                instructions == other.instructions &&
+                maxOutputTokens == other.maxOutputTokens &&
+                maxToolCalls == other.maxToolCalls &&
+                metadata == other.metadata &&
+                model == other.model &&
+                moderation == other.moderation &&
+                multiAgent == other.multiAgent &&
+                parallelToolCalls == other.parallelToolCalls &&
+                previousResponseId == other.previousResponseId &&
+                prompt == other.prompt &&
+                promptCacheKey == other.promptCacheKey &&
+                promptCacheOptions == other.promptCacheOptions &&
+                promptCacheRetention == other.promptCacheRetention &&
+                reasoning == other.reasoning &&
+                safetyIdentifier == other.safetyIdentifier &&
+                serviceTier == other.serviceTier &&
+                store == other.store &&
+                stream == other.stream &&
+                streamOptions == other.streamOptions &&
+                temperature == other.temperature &&
+                text == other.text &&
+                toolChoice == other.toolChoice &&
+                tools == other.tools &&
+                topLogprobs == other.topLogprobs &&
+                topP == other.topP &&
+                truncation == other.truncation &&
+                user == other.user &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                type,
+                background,
+                contextManagement,
+                conversation,
+                include,
+                input,
+                instructions,
+                maxOutputTokens,
+                maxToolCalls,
+                metadata,
+                model,
+                moderation,
+                multiAgent,
+                parallelToolCalls,
+                previousResponseId,
+                prompt,
+                promptCacheKey,
+                promptCacheOptions,
+                promptCacheRetention,
+                reasoning,
+                safetyIdentifier,
+                serviceTier,
+                store,
+                stream,
+                streamOptions,
+                temperature,
+                text,
+                toolChoice,
+                tools,
+                topLogprobs,
+                topP,
+                truncation,
+                user,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ResponseCreate{type=$type, background=$background, contextManagement=$contextManagement, conversation=$conversation, include=$include, input=$input, instructions=$instructions, maxOutputTokens=$maxOutputTokens, maxToolCalls=$maxToolCalls, metadata=$metadata, model=$model, moderation=$moderation, multiAgent=$multiAgent, parallelToolCalls=$parallelToolCalls, previousResponseId=$previousResponseId, prompt=$prompt, promptCacheKey=$promptCacheKey, promptCacheOptions=$promptCacheOptions, promptCacheRetention=$promptCacheRetention, reasoning=$reasoning, safetyIdentifier=$safetyIdentifier, serviceTier=$serviceTier, store=$store, stream=$stream, streamOptions=$streamOptions, temperature=$temperature, text=$text, toolChoice=$toolChoice, tools=$tools, topLogprobs=$topLogprobs, topP=$topP, truncation=$truncation, user=$user, additionalProperties=$additionalProperties}"
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponsesServerEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponsesServerEvent.kt
new file mode 100644
index 000000000..59cc6b8ef
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponsesServerEvent.kt
@@ -0,0 +1,2972 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.JsonValue
+import com.openai.core.getOrThrow
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Server events emitted by the Responses WebSocket server. */
+@JsonDeserialize(using = BetaResponsesServerEvent.Deserializer::class)
+@JsonSerialize(using = BetaResponsesServerEvent.Serializer::class)
+class BetaResponsesServerEvent
+private constructor(
+    private val responseAudioDelta: BetaResponseAudioDeltaEvent? = null,
+    private val responseAudioDone: BetaResponseAudioDoneEvent? = null,
+    private val responseAudioTranscriptDelta: BetaResponseAudioTranscriptDeltaEvent? = null,
+    private val responseAudioTranscriptDone: BetaResponseAudioTranscriptDoneEvent? = null,
+    private val responseCodeInterpreterCallCodeDelta:
+        BetaResponseCodeInterpreterCallCodeDeltaEvent? =
+        null,
+    private val responseCodeInterpreterCallCodeDone: BetaResponseCodeInterpreterCallCodeDoneEvent? =
+        null,
+    private val responseCodeInterpreterCallCompleted:
+        BetaResponseCodeInterpreterCallCompletedEvent? =
+        null,
+    private val responseCodeInterpreterCallInProgress:
+        BetaResponseCodeInterpreterCallInProgressEvent? =
+        null,
+    private val responseCodeInterpreterCallInterpreting:
+        BetaResponseCodeInterpreterCallInterpretingEvent? =
+        null,
+    private val responseCompleted: BetaResponseCompletedEvent? = null,
+    private val responseContentPartAdded: BetaResponseContentPartAddedEvent? = null,
+    private val responseContentPartDone: BetaResponseContentPartDoneEvent? = null,
+    private val responseCreated: BetaResponseCreatedEvent? = null,
+    private val error: BetaResponseErrorEvent? = null,
+    private val responseFileSearchCallCompleted: BetaResponseFileSearchCallCompletedEvent? = null,
+    private val responseFileSearchCallInProgress: BetaResponseFileSearchCallInProgressEvent? = null,
+    private val responseFileSearchCallSearching: BetaResponseFileSearchCallSearchingEvent? = null,
+    private val responseFunctionCallArgumentsDelta: BetaResponseFunctionCallArgumentsDeltaEvent? =
+        null,
+    private val responseFunctionCallArgumentsDone: BetaResponseFunctionCallArgumentsDoneEvent? =
+        null,
+    private val responseInProgress: BetaResponseInProgressEvent? = null,
+    private val responseFailed: BetaResponseFailedEvent? = null,
+    private val responseIncomplete: BetaResponseIncompleteEvent? = null,
+    private val responseOutputItemAdded: BetaResponseOutputItemAddedEvent? = null,
+    private val responseOutputItemDone: BetaResponseOutputItemDoneEvent? = null,
+    private val responseReasoningSummaryPartAdded: BetaResponseReasoningSummaryPartAddedEvent? =
+        null,
+    private val responseReasoningSummaryPartDone: BetaResponseReasoningSummaryPartDoneEvent? = null,
+    private val responseReasoningSummaryTextDelta: BetaResponseReasoningSummaryTextDeltaEvent? =
+        null,
+    private val responseReasoningSummaryTextDone: BetaResponseReasoningSummaryTextDoneEvent? = null,
+    private val responseReasoningTextDelta: BetaResponseReasoningTextDeltaEvent? = null,
+    private val responseReasoningTextDone: BetaResponseReasoningTextDoneEvent? = null,
+    private val responseRefusalDelta: BetaResponseRefusalDeltaEvent? = null,
+    private val responseRefusalDone: BetaResponseRefusalDoneEvent? = null,
+    private val responseOutputTextDelta: BetaResponseTextDeltaEvent? = null,
+    private val responseOutputTextDone: BetaResponseTextDoneEvent? = null,
+    private val responseWebSearchCallCompleted: BetaResponseWebSearchCallCompletedEvent? = null,
+    private val responseWebSearchCallInProgress: BetaResponseWebSearchCallInProgressEvent? = null,
+    private val responseWebSearchCallSearching: BetaResponseWebSearchCallSearchingEvent? = null,
+    private val responseImageGenerationCallCompleted: BetaResponseImageGenCallCompletedEvent? =
+        null,
+    private val responseImageGenerationCallGenerating: BetaResponseImageGenCallGeneratingEvent? =
+        null,
+    private val responseImageGenerationCallInProgress: BetaResponseImageGenCallInProgressEvent? =
+        null,
+    private val responseImageGenerationCallPartialImage:
+        BetaResponseImageGenCallPartialImageEvent? =
+        null,
+    private val responseMcpCallArgumentsDelta: BetaResponseMcpCallArgumentsDeltaEvent? = null,
+    private val responseMcpCallArgumentsDone: BetaResponseMcpCallArgumentsDoneEvent? = null,
+    private val responseMcpCallCompleted: BetaResponseMcpCallCompletedEvent? = null,
+    private val responseMcpCallFailed: BetaResponseMcpCallFailedEvent? = null,
+    private val responseMcpCallInProgress: BetaResponseMcpCallInProgressEvent? = null,
+    private val responseMcpListToolsCompleted: BetaResponseMcpListToolsCompletedEvent? = null,
+    private val responseMcpListToolsFailed: BetaResponseMcpListToolsFailedEvent? = null,
+    private val responseMcpListToolsInProgress: BetaResponseMcpListToolsInProgressEvent? = null,
+    private val responseOutputTextAnnotationAdded: BetaResponseOutputTextAnnotationAddedEvent? =
+        null,
+    private val responseQueued: BetaResponseQueuedEvent? = null,
+    private val responseCustomToolCallInputDelta: BetaResponseCustomToolCallInputDeltaEvent? = null,
+    private val responseCustomToolCallInputDone: BetaResponseCustomToolCallInputDoneEvent? = null,
+    private val responseInjectCreated: BetaResponseInjectCreatedEvent? = null,
+    private val responseInjectFailed: BetaResponseInjectFailedEvent? = null,
+    private val _json: JsonValue? = null,
+) {
+
+    /** Emitted when there is a partial audio response. */
+    fun responseAudioDelta(): Optional<BetaResponseAudioDeltaEvent> =
+        Optional.ofNullable(responseAudioDelta)
+
+    /** Emitted when the audio response is complete. */
+    fun responseAudioDone(): Optional<BetaResponseAudioDoneEvent> =
+        Optional.ofNullable(responseAudioDone)
+
+    /** Emitted when there is a partial transcript of audio. */
+    fun responseAudioTranscriptDelta(): Optional<BetaResponseAudioTranscriptDeltaEvent> =
+        Optional.ofNullable(responseAudioTranscriptDelta)
+
+    /** Emitted when the full audio transcript is completed. */
+    fun responseAudioTranscriptDone(): Optional<BetaResponseAudioTranscriptDoneEvent> =
+        Optional.ofNullable(responseAudioTranscriptDone)
+
+    /** Emitted when a partial code snippet is streamed by the code interpreter. */
+    fun responseCodeInterpreterCallCodeDelta():
+        Optional<BetaResponseCodeInterpreterCallCodeDeltaEvent> =
+        Optional.ofNullable(responseCodeInterpreterCallCodeDelta)
+
+    /** Emitted when the code snippet is finalized by the code interpreter. */
+    fun responseCodeInterpreterCallCodeDone():
+        Optional<BetaResponseCodeInterpreterCallCodeDoneEvent> =
+        Optional.ofNullable(responseCodeInterpreterCallCodeDone)
+
+    /** Emitted when the code interpreter call is completed. */
+    fun responseCodeInterpreterCallCompleted():
+        Optional<BetaResponseCodeInterpreterCallCompletedEvent> =
+        Optional.ofNullable(responseCodeInterpreterCallCompleted)
+
+    /** Emitted when a code interpreter call is in progress. */
+    fun responseCodeInterpreterCallInProgress():
+        Optional<BetaResponseCodeInterpreterCallInProgressEvent> =
+        Optional.ofNullable(responseCodeInterpreterCallInProgress)
+
+    /** Emitted when the code interpreter is actively interpreting the code snippet. */
+    fun responseCodeInterpreterCallInterpreting():
+        Optional<BetaResponseCodeInterpreterCallInterpretingEvent> =
+        Optional.ofNullable(responseCodeInterpreterCallInterpreting)
+
+    /** Emitted when the model response is complete. */
+    fun responseCompleted(): Optional<BetaResponseCompletedEvent> =
+        Optional.ofNullable(responseCompleted)
+
+    /** Emitted when a new content part is added. */
+    fun responseContentPartAdded(): Optional<BetaResponseContentPartAddedEvent> =
+        Optional.ofNullable(responseContentPartAdded)
+
+    /** Emitted when a content part is done. */
+    fun responseContentPartDone(): Optional<BetaResponseContentPartDoneEvent> =
+        Optional.ofNullable(responseContentPartDone)
+
+    /** An event that is emitted when a response is created. */
+    fun responseCreated(): Optional<BetaResponseCreatedEvent> = Optional.ofNullable(responseCreated)
+
+    /** Emitted when an error occurs. */
+    fun error(): Optional<BetaResponseErrorEvent> = Optional.ofNullable(error)
+
+    /** Emitted when a file search call is completed (results found). */
+    fun responseFileSearchCallCompleted(): Optional<BetaResponseFileSearchCallCompletedEvent> =
+        Optional.ofNullable(responseFileSearchCallCompleted)
+
+    /** Emitted when a file search call is initiated. */
+    fun responseFileSearchCallInProgress(): Optional<BetaResponseFileSearchCallInProgressEvent> =
+        Optional.ofNullable(responseFileSearchCallInProgress)
+
+    /** Emitted when a file search is currently searching. */
+    fun responseFileSearchCallSearching(): Optional<BetaResponseFileSearchCallSearchingEvent> =
+        Optional.ofNullable(responseFileSearchCallSearching)
+
+    /** Emitted when there is a partial function-call arguments delta. */
+    fun responseFunctionCallArgumentsDelta():
+        Optional<BetaResponseFunctionCallArgumentsDeltaEvent> =
+        Optional.ofNullable(responseFunctionCallArgumentsDelta)
+
+    /** Emitted when function-call arguments are finalized. */
+    fun responseFunctionCallArgumentsDone(): Optional<BetaResponseFunctionCallArgumentsDoneEvent> =
+        Optional.ofNullable(responseFunctionCallArgumentsDone)
+
+    /** Emitted when the response is in progress. */
+    fun responseInProgress(): Optional<BetaResponseInProgressEvent> =
+        Optional.ofNullable(responseInProgress)
+
+    /** An event that is emitted when a response fails. */
+    fun responseFailed(): Optional<BetaResponseFailedEvent> = Optional.ofNullable(responseFailed)
+
+    /** An event that is emitted when a response finishes as incomplete. */
+    fun responseIncomplete(): Optional<BetaResponseIncompleteEvent> =
+        Optional.ofNullable(responseIncomplete)
+
+    /** Emitted when a new output item is added. */
+    fun responseOutputItemAdded(): Optional<BetaResponseOutputItemAddedEvent> =
+        Optional.ofNullable(responseOutputItemAdded)
+
+    /** Emitted when an output item is marked done. */
+    fun responseOutputItemDone(): Optional<BetaResponseOutputItemDoneEvent> =
+        Optional.ofNullable(responseOutputItemDone)
+
+    /** Emitted when a new reasoning summary part is added. */
+    fun responseReasoningSummaryPartAdded(): Optional<BetaResponseReasoningSummaryPartAddedEvent> =
+        Optional.ofNullable(responseReasoningSummaryPartAdded)
+
+    /** Emitted when a reasoning summary part is completed. */
+    fun responseReasoningSummaryPartDone(): Optional<BetaResponseReasoningSummaryPartDoneEvent> =
+        Optional.ofNullable(responseReasoningSummaryPartDone)
+
+    /** Emitted when a delta is added to a reasoning summary text. */
+    fun responseReasoningSummaryTextDelta(): Optional<BetaResponseReasoningSummaryTextDeltaEvent> =
+        Optional.ofNullable(responseReasoningSummaryTextDelta)
+
+    /** Emitted when a reasoning summary text is completed. */
+    fun responseReasoningSummaryTextDone(): Optional<BetaResponseReasoningSummaryTextDoneEvent> =
+        Optional.ofNullable(responseReasoningSummaryTextDone)
+
+    /** Emitted when a delta is added to a reasoning text. */
+    fun responseReasoningTextDelta(): Optional<BetaResponseReasoningTextDeltaEvent> =
+        Optional.ofNullable(responseReasoningTextDelta)
+
+    /** Emitted when a reasoning text is completed. */
+    fun responseReasoningTextDone(): Optional<BetaResponseReasoningTextDoneEvent> =
+        Optional.ofNullable(responseReasoningTextDone)
+
+    /** Emitted when there is a partial refusal text. */
+    fun responseRefusalDelta(): Optional<BetaResponseRefusalDeltaEvent> =
+        Optional.ofNullable(responseRefusalDelta)
+
+    /** Emitted when refusal text is finalized. */
+    fun responseRefusalDone(): Optional<BetaResponseRefusalDoneEvent> =
+        Optional.ofNullable(responseRefusalDone)
+
+    /** Emitted when there is an additional text delta. */
+    fun responseOutputTextDelta(): Optional<BetaResponseTextDeltaEvent> =
+        Optional.ofNullable(responseOutputTextDelta)
+
+    /** Emitted when text content is finalized. */
+    fun responseOutputTextDone(): Optional<BetaResponseTextDoneEvent> =
+        Optional.ofNullable(responseOutputTextDone)
+
+    /** Emitted when a web search call is completed. */
+    fun responseWebSearchCallCompleted(): Optional<BetaResponseWebSearchCallCompletedEvent> =
+        Optional.ofNullable(responseWebSearchCallCompleted)
+
+    /** Emitted when a web search call is initiated. */
+    fun responseWebSearchCallInProgress(): Optional<BetaResponseWebSearchCallInProgressEvent> =
+        Optional.ofNullable(responseWebSearchCallInProgress)
+
+    /** Emitted when a web search call is executing. */
+    fun responseWebSearchCallSearching(): Optional<BetaResponseWebSearchCallSearchingEvent> =
+        Optional.ofNullable(responseWebSearchCallSearching)
+
+    /**
+     * Emitted when an image generation tool call has completed and the final image is available.
+     */
+    fun responseImageGenerationCallCompleted(): Optional<BetaResponseImageGenCallCompletedEvent> =
+        Optional.ofNullable(responseImageGenerationCallCompleted)
+
+    /**
+     * Emitted when an image generation tool call is actively generating an image (intermediate
+     * state).
+     */
+    fun responseImageGenerationCallGenerating(): Optional<BetaResponseImageGenCallGeneratingEvent> =
+        Optional.ofNullable(responseImageGenerationCallGenerating)
+
+    /** Emitted when an image generation tool call is in progress. */
+    fun responseImageGenerationCallInProgress(): Optional<BetaResponseImageGenCallInProgressEvent> =
+        Optional.ofNullable(responseImageGenerationCallInProgress)
+
+    /** Emitted when a partial image is available during image generation streaming. */
+    fun responseImageGenerationCallPartialImage():
+        Optional<BetaResponseImageGenCallPartialImageEvent> =
+        Optional.ofNullable(responseImageGenerationCallPartialImage)
+
+    /** Emitted when there is a delta (partial update) to the arguments of an MCP tool call. */
+    fun responseMcpCallArgumentsDelta(): Optional<BetaResponseMcpCallArgumentsDeltaEvent> =
+        Optional.ofNullable(responseMcpCallArgumentsDelta)
+
+    /** Emitted when the arguments for an MCP tool call are finalized. */
+    fun responseMcpCallArgumentsDone(): Optional<BetaResponseMcpCallArgumentsDoneEvent> =
+        Optional.ofNullable(responseMcpCallArgumentsDone)
+
+    /** Emitted when an MCP tool call has completed successfully. */
+    fun responseMcpCallCompleted(): Optional<BetaResponseMcpCallCompletedEvent> =
+        Optional.ofNullable(responseMcpCallCompleted)
+
+    /** Emitted when an MCP tool call has failed. */
+    fun responseMcpCallFailed(): Optional<BetaResponseMcpCallFailedEvent> =
+        Optional.ofNullable(responseMcpCallFailed)
+
+    /** Emitted when an MCP tool call is in progress. */
+    fun responseMcpCallInProgress(): Optional<BetaResponseMcpCallInProgressEvent> =
+        Optional.ofNullable(responseMcpCallInProgress)
+
+    /** Emitted when the list of available MCP tools has been successfully retrieved. */
+    fun responseMcpListToolsCompleted(): Optional<BetaResponseMcpListToolsCompletedEvent> =
+        Optional.ofNullable(responseMcpListToolsCompleted)
+
+    /** Emitted when the attempt to list available MCP tools has failed. */
+    fun responseMcpListToolsFailed(): Optional<BetaResponseMcpListToolsFailedEvent> =
+        Optional.ofNullable(responseMcpListToolsFailed)
+
+    /** Emitted when the system is in the process of retrieving the list of available MCP tools. */
+    fun responseMcpListToolsInProgress(): Optional<BetaResponseMcpListToolsInProgressEvent> =
+        Optional.ofNullable(responseMcpListToolsInProgress)
+
+    /** Emitted when an annotation is added to output text content. */
+    fun responseOutputTextAnnotationAdded(): Optional<BetaResponseOutputTextAnnotationAddedEvent> =
+        Optional.ofNullable(responseOutputTextAnnotationAdded)
+
+    /** Emitted when a response is queued and waiting to be processed. */
+    fun responseQueued(): Optional<BetaResponseQueuedEvent> = Optional.ofNullable(responseQueued)
+
+    /** Event representing a delta (partial update) to the input of a custom tool call. */
+    fun responseCustomToolCallInputDelta(): Optional<BetaResponseCustomToolCallInputDeltaEvent> =
+        Optional.ofNullable(responseCustomToolCallInputDelta)
+
+    /** Event indicating that input for a custom tool call is complete. */
+    fun responseCustomToolCallInputDone(): Optional<BetaResponseCustomToolCallInputDoneEvent> =
+        Optional.ofNullable(responseCustomToolCallInputDone)
+
+    /**
+     * Emitted when all injected input items were validated and committed to the active response.
+     */
+    fun responseInjectCreated(): Optional<BetaResponseInjectCreatedEvent> =
+        Optional.ofNullable(responseInjectCreated)
+
+    /**
+     * Emitted when injected input could not be committed to a response. The event returns the
+     * uncommitted raw input so the client can retry it in another response when appropriate.
+     */
+    fun responseInjectFailed(): Optional<BetaResponseInjectFailedEvent> =
+        Optional.ofNullable(responseInjectFailed)
+
+    fun isResponseAudioDelta(): Boolean = responseAudioDelta != null
+
+    fun isResponseAudioDone(): Boolean = responseAudioDone != null
+
+    fun isResponseAudioTranscriptDelta(): Boolean = responseAudioTranscriptDelta != null
+
+    fun isResponseAudioTranscriptDone(): Boolean = responseAudioTranscriptDone != null
+
+    fun isResponseCodeInterpreterCallCodeDelta(): Boolean =
+        responseCodeInterpreterCallCodeDelta != null
+
+    fun isResponseCodeInterpreterCallCodeDone(): Boolean =
+        responseCodeInterpreterCallCodeDone != null
+
+    fun isResponseCodeInterpreterCallCompleted(): Boolean =
+        responseCodeInterpreterCallCompleted != null
+
+    fun isResponseCodeInterpreterCallInProgress(): Boolean =
+        responseCodeInterpreterCallInProgress != null
+
+    fun isResponseCodeInterpreterCallInterpreting(): Boolean =
+        responseCodeInterpreterCallInterpreting != null
+
+    fun isResponseCompleted(): Boolean = responseCompleted != null
+
+    fun isResponseContentPartAdded(): Boolean = responseContentPartAdded != null
+
+    fun isResponseContentPartDone(): Boolean = responseContentPartDone != null
+
+    fun isResponseCreated(): Boolean = responseCreated != null
+
+    fun isError(): Boolean = error != null
+
+    fun isResponseFileSearchCallCompleted(): Boolean = responseFileSearchCallCompleted != null
+
+    fun isResponseFileSearchCallInProgress(): Boolean = responseFileSearchCallInProgress != null
+
+    fun isResponseFileSearchCallSearching(): Boolean = responseFileSearchCallSearching != null
+
+    fun isResponseFunctionCallArgumentsDelta(): Boolean = responseFunctionCallArgumentsDelta != null
+
+    fun isResponseFunctionCallArgumentsDone(): Boolean = responseFunctionCallArgumentsDone != null
+
+    fun isResponseInProgress(): Boolean = responseInProgress != null
+
+    fun isResponseFailed(): Boolean = responseFailed != null
+
+    fun isResponseIncomplete(): Boolean = responseIncomplete != null
+
+    fun isResponseOutputItemAdded(): Boolean = responseOutputItemAdded != null
+
+    fun isResponseOutputItemDone(): Boolean = responseOutputItemDone != null
+
+    fun isResponseReasoningSummaryPartAdded(): Boolean = responseReasoningSummaryPartAdded != null
+
+    fun isResponseReasoningSummaryPartDone(): Boolean = responseReasoningSummaryPartDone != null
+
+    fun isResponseReasoningSummaryTextDelta(): Boolean = responseReasoningSummaryTextDelta != null
+
+    fun isResponseReasoningSummaryTextDone(): Boolean = responseReasoningSummaryTextDone != null
+
+    fun isResponseReasoningTextDelta(): Boolean = responseReasoningTextDelta != null
+
+    fun isResponseReasoningTextDone(): Boolean = responseReasoningTextDone != null
+
+    fun isResponseRefusalDelta(): Boolean = responseRefusalDelta != null
+
+    fun isResponseRefusalDone(): Boolean = responseRefusalDone != null
+
+    fun isResponseOutputTextDelta(): Boolean = responseOutputTextDelta != null
+
+    fun isResponseOutputTextDone(): Boolean = responseOutputTextDone != null
+
+    fun isResponseWebSearchCallCompleted(): Boolean = responseWebSearchCallCompleted != null
+
+    fun isResponseWebSearchCallInProgress(): Boolean = responseWebSearchCallInProgress != null
+
+    fun isResponseWebSearchCallSearching(): Boolean = responseWebSearchCallSearching != null
+
+    fun isResponseImageGenerationCallCompleted(): Boolean =
+        responseImageGenerationCallCompleted != null
+
+    fun isResponseImageGenerationCallGenerating(): Boolean =
+        responseImageGenerationCallGenerating != null
+
+    fun isResponseImageGenerationCallInProgress(): Boolean =
+        responseImageGenerationCallInProgress != null
+
+    fun isResponseImageGenerationCallPartialImage(): Boolean =
+        responseImageGenerationCallPartialImage != null
+
+    fun isResponseMcpCallArgumentsDelta(): Boolean = responseMcpCallArgumentsDelta != null
+
+    fun isResponseMcpCallArgumentsDone(): Boolean = responseMcpCallArgumentsDone != null
+
+    fun isResponseMcpCallCompleted(): Boolean = responseMcpCallCompleted != null
+
+    fun isResponseMcpCallFailed(): Boolean = responseMcpCallFailed != null
+
+    fun isResponseMcpCallInProgress(): Boolean = responseMcpCallInProgress != null
+
+    fun isResponseMcpListToolsCompleted(): Boolean = responseMcpListToolsCompleted != null
+
+    fun isResponseMcpListToolsFailed(): Boolean = responseMcpListToolsFailed != null
+
+    fun isResponseMcpListToolsInProgress(): Boolean = responseMcpListToolsInProgress != null
+
+    fun isResponseOutputTextAnnotationAdded(): Boolean = responseOutputTextAnnotationAdded != null
+
+    fun isResponseQueued(): Boolean = responseQueued != null
+
+    fun isResponseCustomToolCallInputDelta(): Boolean = responseCustomToolCallInputDelta != null
+
+    fun isResponseCustomToolCallInputDone(): Boolean = responseCustomToolCallInputDone != null
+
+    fun isResponseInjectCreated(): Boolean = responseInjectCreated != null
+
+    fun isResponseInjectFailed(): Boolean = responseInjectFailed != null
+
+    /** Emitted when there is a partial audio response. */
+    fun asResponseAudioDelta(): BetaResponseAudioDeltaEvent =
+        responseAudioDelta.getOrThrow("responseAudioDelta")
+
+    /** Emitted when the audio response is complete. */
+    fun asResponseAudioDone(): BetaResponseAudioDoneEvent =
+        responseAudioDone.getOrThrow("responseAudioDone")
+
+    /** Emitted when there is a partial transcript of audio. */
+    fun asResponseAudioTranscriptDelta(): BetaResponseAudioTranscriptDeltaEvent =
+        responseAudioTranscriptDelta.getOrThrow("responseAudioTranscriptDelta")
+
+    /** Emitted when the full audio transcript is completed. */
+    fun asResponseAudioTranscriptDone(): BetaResponseAudioTranscriptDoneEvent =
+        responseAudioTranscriptDone.getOrThrow("responseAudioTranscriptDone")
+
+    /** Emitted when a partial code snippet is streamed by the code interpreter. */
+    fun asResponseCodeInterpreterCallCodeDelta(): BetaResponseCodeInterpreterCallCodeDeltaEvent =
+        responseCodeInterpreterCallCodeDelta.getOrThrow("responseCodeInterpreterCallCodeDelta")
+
+    /** Emitted when the code snippet is finalized by the code interpreter. */
+    fun asResponseCodeInterpreterCallCodeDone(): BetaResponseCodeInterpreterCallCodeDoneEvent =
+        responseCodeInterpreterCallCodeDone.getOrThrow("responseCodeInterpreterCallCodeDone")
+
+    /** Emitted when the code interpreter call is completed. */
+    fun asResponseCodeInterpreterCallCompleted(): BetaResponseCodeInterpreterCallCompletedEvent =
+        responseCodeInterpreterCallCompleted.getOrThrow("responseCodeInterpreterCallCompleted")
+
+    /** Emitted when a code interpreter call is in progress. */
+    fun asResponseCodeInterpreterCallInProgress(): BetaResponseCodeInterpreterCallInProgressEvent =
+        responseCodeInterpreterCallInProgress.getOrThrow("responseCodeInterpreterCallInProgress")
+
+    /** Emitted when the code interpreter is actively interpreting the code snippet. */
+    fun asResponseCodeInterpreterCallInterpreting():
+        BetaResponseCodeInterpreterCallInterpretingEvent =
+        responseCodeInterpreterCallInterpreting.getOrThrow(
+            "responseCodeInterpreterCallInterpreting"
+        )
+
+    /** Emitted when the model response is complete. */
+    fun asResponseCompleted(): BetaResponseCompletedEvent =
+        responseCompleted.getOrThrow("responseCompleted")
+
+    /** Emitted when a new content part is added. */
+    fun asResponseContentPartAdded(): BetaResponseContentPartAddedEvent =
+        responseContentPartAdded.getOrThrow("responseContentPartAdded")
+
+    /** Emitted when a content part is done. */
+    fun asResponseContentPartDone(): BetaResponseContentPartDoneEvent =
+        responseContentPartDone.getOrThrow("responseContentPartDone")
+
+    /** An event that is emitted when a response is created. */
+    fun asResponseCreated(): BetaResponseCreatedEvent =
+        responseCreated.getOrThrow("responseCreated")
+
+    /** Emitted when an error occurs. */
+    fun asError(): BetaResponseErrorEvent = error.getOrThrow("error")
+
+    /** Emitted when a file search call is completed (results found). */
+    fun asResponseFileSearchCallCompleted(): BetaResponseFileSearchCallCompletedEvent =
+        responseFileSearchCallCompleted.getOrThrow("responseFileSearchCallCompleted")
+
+    /** Emitted when a file search call is initiated. */
+    fun asResponseFileSearchCallInProgress(): BetaResponseFileSearchCallInProgressEvent =
+        responseFileSearchCallInProgress.getOrThrow("responseFileSearchCallInProgress")
+
+    /** Emitted when a file search is currently searching. */
+    fun asResponseFileSearchCallSearching(): BetaResponseFileSearchCallSearchingEvent =
+        responseFileSearchCallSearching.getOrThrow("responseFileSearchCallSearching")
+
+    /** Emitted when there is a partial function-call arguments delta. */
+    fun asResponseFunctionCallArgumentsDelta(): BetaResponseFunctionCallArgumentsDeltaEvent =
+        responseFunctionCallArgumentsDelta.getOrThrow("responseFunctionCallArgumentsDelta")
+
+    /** Emitted when function-call arguments are finalized. */
+    fun asResponseFunctionCallArgumentsDone(): BetaResponseFunctionCallArgumentsDoneEvent =
+        responseFunctionCallArgumentsDone.getOrThrow("responseFunctionCallArgumentsDone")
+
+    /** Emitted when the response is in progress. */
+    fun asResponseInProgress(): BetaResponseInProgressEvent =
+        responseInProgress.getOrThrow("responseInProgress")
+
+    /** An event that is emitted when a response fails. */
+    fun asResponseFailed(): BetaResponseFailedEvent = responseFailed.getOrThrow("responseFailed")
+
+    /** An event that is emitted when a response finishes as incomplete. */
+    fun asResponseIncomplete(): BetaResponseIncompleteEvent =
+        responseIncomplete.getOrThrow("responseIncomplete")
+
+    /** Emitted when a new output item is added. */
+    fun asResponseOutputItemAdded(): BetaResponseOutputItemAddedEvent =
+        responseOutputItemAdded.getOrThrow("responseOutputItemAdded")
+
+    /** Emitted when an output item is marked done. */
+    fun asResponseOutputItemDone(): BetaResponseOutputItemDoneEvent =
+        responseOutputItemDone.getOrThrow("responseOutputItemDone")
+
+    /** Emitted when a new reasoning summary part is added. */
+    fun asResponseReasoningSummaryPartAdded(): BetaResponseReasoningSummaryPartAddedEvent =
+        responseReasoningSummaryPartAdded.getOrThrow("responseReasoningSummaryPartAdded")
+
+    /** Emitted when a reasoning summary part is completed. */
+    fun asResponseReasoningSummaryPartDone(): BetaResponseReasoningSummaryPartDoneEvent =
+        responseReasoningSummaryPartDone.getOrThrow("responseReasoningSummaryPartDone")
+
+    /** Emitted when a delta is added to a reasoning summary text. */
+    fun asResponseReasoningSummaryTextDelta(): BetaResponseReasoningSummaryTextDeltaEvent =
+        responseReasoningSummaryTextDelta.getOrThrow("responseReasoningSummaryTextDelta")
+
+    /** Emitted when a reasoning summary text is completed. */
+    fun asResponseReasoningSummaryTextDone(): BetaResponseReasoningSummaryTextDoneEvent =
+        responseReasoningSummaryTextDone.getOrThrow("responseReasoningSummaryTextDone")
+
+    /** Emitted when a delta is added to a reasoning text. */
+    fun asResponseReasoningTextDelta(): BetaResponseReasoningTextDeltaEvent =
+        responseReasoningTextDelta.getOrThrow("responseReasoningTextDelta")
+
+    /** Emitted when a reasoning text is completed. */
+    fun asResponseReasoningTextDone(): BetaResponseReasoningTextDoneEvent =
+        responseReasoningTextDone.getOrThrow("responseReasoningTextDone")
+
+    /** Emitted when there is a partial refusal text. */
+    fun asResponseRefusalDelta(): BetaResponseRefusalDeltaEvent =
+        responseRefusalDelta.getOrThrow("responseRefusalDelta")
+
+    /** Emitted when refusal text is finalized. */
+    fun asResponseRefusalDone(): BetaResponseRefusalDoneEvent =
+        responseRefusalDone.getOrThrow("responseRefusalDone")
+
+    /** Emitted when there is an additional text delta. */
+    fun asResponseOutputTextDelta(): BetaResponseTextDeltaEvent =
+        responseOutputTextDelta.getOrThrow("responseOutputTextDelta")
+
+    /** Emitted when text content is finalized. */
+    fun asResponseOutputTextDone(): BetaResponseTextDoneEvent =
+        responseOutputTextDone.getOrThrow("responseOutputTextDone")
+
+    /** Emitted when a web search call is completed. */
+    fun asResponseWebSearchCallCompleted(): BetaResponseWebSearchCallCompletedEvent =
+        responseWebSearchCallCompleted.getOrThrow("responseWebSearchCallCompleted")
+
+    /** Emitted when a web search call is initiated. */
+    fun asResponseWebSearchCallInProgress(): BetaResponseWebSearchCallInProgressEvent =
+        responseWebSearchCallInProgress.getOrThrow("responseWebSearchCallInProgress")
+
+    /** Emitted when a web search call is executing. */
+    fun asResponseWebSearchCallSearching(): BetaResponseWebSearchCallSearchingEvent =
+        responseWebSearchCallSearching.getOrThrow("responseWebSearchCallSearching")
+
+    /**
+     * Emitted when an image generation tool call has completed and the final image is available.
+     */
+    fun asResponseImageGenerationCallCompleted(): BetaResponseImageGenCallCompletedEvent =
+        responseImageGenerationCallCompleted.getOrThrow("responseImageGenerationCallCompleted")
+
+    /**
+     * Emitted when an image generation tool call is actively generating an image (intermediate
+     * state).
+     */
+    fun asResponseImageGenerationCallGenerating(): BetaResponseImageGenCallGeneratingEvent =
+        responseImageGenerationCallGenerating.getOrThrow("responseImageGenerationCallGenerating")
+
+    /** Emitted when an image generation tool call is in progress. */
+    fun asResponseImageGenerationCallInProgress(): BetaResponseImageGenCallInProgressEvent =
+        responseImageGenerationCallInProgress.getOrThrow("responseImageGenerationCallInProgress")
+
+    /** Emitted when a partial image is available during image generation streaming. */
+    fun asResponseImageGenerationCallPartialImage(): BetaResponseImageGenCallPartialImageEvent =
+        responseImageGenerationCallPartialImage.getOrThrow(
+            "responseImageGenerationCallPartialImage"
+        )
+
+    /** Emitted when there is a delta (partial update) to the arguments of an MCP tool call. */
+    fun asResponseMcpCallArgumentsDelta(): BetaResponseMcpCallArgumentsDeltaEvent =
+        responseMcpCallArgumentsDelta.getOrThrow("responseMcpCallArgumentsDelta")
+
+    /** Emitted when the arguments for an MCP tool call are finalized. */
+    fun asResponseMcpCallArgumentsDone(): BetaResponseMcpCallArgumentsDoneEvent =
+        responseMcpCallArgumentsDone.getOrThrow("responseMcpCallArgumentsDone")
+
+    /** Emitted when an MCP tool call has completed successfully. */
+    fun asResponseMcpCallCompleted(): BetaResponseMcpCallCompletedEvent =
+        responseMcpCallCompleted.getOrThrow("responseMcpCallCompleted")
+
+    /** Emitted when an MCP tool call has failed. */
+    fun asResponseMcpCallFailed(): BetaResponseMcpCallFailedEvent =
+        responseMcpCallFailed.getOrThrow("responseMcpCallFailed")
+
+    /** Emitted when an MCP tool call is in progress. */
+    fun asResponseMcpCallInProgress(): BetaResponseMcpCallInProgressEvent =
+        responseMcpCallInProgress.getOrThrow("responseMcpCallInProgress")
+
+    /** Emitted when the list of available MCP tools has been successfully retrieved. */
+    fun asResponseMcpListToolsCompleted(): BetaResponseMcpListToolsCompletedEvent =
+        responseMcpListToolsCompleted.getOrThrow("responseMcpListToolsCompleted")
+
+    /** Emitted when the attempt to list available MCP tools has failed. */
+    fun asResponseMcpListToolsFailed(): BetaResponseMcpListToolsFailedEvent =
+        responseMcpListToolsFailed.getOrThrow("responseMcpListToolsFailed")
+
+    /** Emitted when the system is in the process of retrieving the list of available MCP tools. */
+    fun asResponseMcpListToolsInProgress(): BetaResponseMcpListToolsInProgressEvent =
+        responseMcpListToolsInProgress.getOrThrow("responseMcpListToolsInProgress")
+
+    /** Emitted when an annotation is added to output text content. */
+    fun asResponseOutputTextAnnotationAdded(): BetaResponseOutputTextAnnotationAddedEvent =
+        responseOutputTextAnnotationAdded.getOrThrow("responseOutputTextAnnotationAdded")
+
+    /** Emitted when a response is queued and waiting to be processed. */
+    fun asResponseQueued(): BetaResponseQueuedEvent = responseQueued.getOrThrow("responseQueued")
+
+    /** Event representing a delta (partial update) to the input of a custom tool call. */
+    fun asResponseCustomToolCallInputDelta(): BetaResponseCustomToolCallInputDeltaEvent =
+        responseCustomToolCallInputDelta.getOrThrow("responseCustomToolCallInputDelta")
+
+    /** Event indicating that input for a custom tool call is complete. */
+    fun asResponseCustomToolCallInputDone(): BetaResponseCustomToolCallInputDoneEvent =
+        responseCustomToolCallInputDone.getOrThrow("responseCustomToolCallInputDone")
+
+    /**
+     * Emitted when all injected input items were validated and committed to the active response.
+     */
+    fun asResponseInjectCreated(): BetaResponseInjectCreatedEvent =
+        responseInjectCreated.getOrThrow("responseInjectCreated")
+
+    /**
+     * Emitted when injected input could not be committed to a response. The event returns the
+     * uncommitted raw input so the client can retry it in another response when appropriate.
+     */
+    fun asResponseInjectFailed(): BetaResponseInjectFailedEvent =
+        responseInjectFailed.getOrThrow("responseInjectFailed")
+
+    fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+    /**
+     * Maps this instance's current variant to a value of type [T] using the given [visitor].
+     *
+     * Note that this method is _not_ forwards compatible with new variants from the API, unless
+     * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of the
+     * SDK gracefully, consider overriding [Visitor.unknown]:
+     * ```java
+     * import com.openai.core.JsonValue;
+     * import java.util.Optional;
+     *
+     * Optional<String> result = betaResponsesServerEvent.accept(new BetaResponsesServerEvent.Visitor<Optional<String>>() {
+     *     @Override
+     *     public Optional<String> visitResponseAudioDelta(BetaResponseAudioDeltaEvent responseAudioDelta) {
+     *         return Optional.of(responseAudioDelta.toString());
+     *     }
+     *
+     *     // ...
+     *
+     *     @Override
+     *     public Optional<String> unknown(JsonValue json) {
+     *         // Or inspect the `json`.
+     *         return Optional.empty();
+     *     }
+     * });
+     * ```
+     *
+     * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor] and
+     *   the current variant is unknown.
+     */
+    fun <T> accept(visitor: Visitor<T>): T =
+        when {
+            responseAudioDelta != null -> visitor.visitResponseAudioDelta(responseAudioDelta)
+            responseAudioDone != null -> visitor.visitResponseAudioDone(responseAudioDone)
+            responseAudioTranscriptDelta != null ->
+                visitor.visitResponseAudioTranscriptDelta(responseAudioTranscriptDelta)
+            responseAudioTranscriptDone != null ->
+                visitor.visitResponseAudioTranscriptDone(responseAudioTranscriptDone)
+            responseCodeInterpreterCallCodeDelta != null ->
+                visitor.visitResponseCodeInterpreterCallCodeDelta(
+                    responseCodeInterpreterCallCodeDelta
+                )
+            responseCodeInterpreterCallCodeDone != null ->
+                visitor.visitResponseCodeInterpreterCallCodeDone(
+                    responseCodeInterpreterCallCodeDone
+                )
+            responseCodeInterpreterCallCompleted != null ->
+                visitor.visitResponseCodeInterpreterCallCompleted(
+                    responseCodeInterpreterCallCompleted
+                )
+            responseCodeInterpreterCallInProgress != null ->
+                visitor.visitResponseCodeInterpreterCallInProgress(
+                    responseCodeInterpreterCallInProgress
+                )
+            responseCodeInterpreterCallInterpreting != null ->
+                visitor.visitResponseCodeInterpreterCallInterpreting(
+                    responseCodeInterpreterCallInterpreting
+                )
+            responseCompleted != null -> visitor.visitResponseCompleted(responseCompleted)
+            responseContentPartAdded != null ->
+                visitor.visitResponseContentPartAdded(responseContentPartAdded)
+            responseContentPartDone != null ->
+                visitor.visitResponseContentPartDone(responseContentPartDone)
+            responseCreated != null -> visitor.visitResponseCreated(responseCreated)
+            error != null -> visitor.visitError(error)
+            responseFileSearchCallCompleted != null ->
+                visitor.visitResponseFileSearchCallCompleted(responseFileSearchCallCompleted)
+            responseFileSearchCallInProgress != null ->
+                visitor.visitResponseFileSearchCallInProgress(responseFileSearchCallInProgress)
+            responseFileSearchCallSearching != null ->
+                visitor.visitResponseFileSearchCallSearching(responseFileSearchCallSearching)
+            responseFunctionCallArgumentsDelta != null ->
+                visitor.visitResponseFunctionCallArgumentsDelta(responseFunctionCallArgumentsDelta)
+            responseFunctionCallArgumentsDone != null ->
+                visitor.visitResponseFunctionCallArgumentsDone(responseFunctionCallArgumentsDone)
+            responseInProgress != null -> visitor.visitResponseInProgress(responseInProgress)
+            responseFailed != null -> visitor.visitResponseFailed(responseFailed)
+            responseIncomplete != null -> visitor.visitResponseIncomplete(responseIncomplete)
+            responseOutputItemAdded != null ->
+                visitor.visitResponseOutputItemAdded(responseOutputItemAdded)
+            responseOutputItemDone != null ->
+                visitor.visitResponseOutputItemDone(responseOutputItemDone)
+            responseReasoningSummaryPartAdded != null ->
+                visitor.visitResponseReasoningSummaryPartAdded(responseReasoningSummaryPartAdded)
+            responseReasoningSummaryPartDone != null ->
+                visitor.visitResponseReasoningSummaryPartDone(responseReasoningSummaryPartDone)
+            responseReasoningSummaryTextDelta != null ->
+                visitor.visitResponseReasoningSummaryTextDelta(responseReasoningSummaryTextDelta)
+            responseReasoningSummaryTextDone != null ->
+                visitor.visitResponseReasoningSummaryTextDone(responseReasoningSummaryTextDone)
+            responseReasoningTextDelta != null ->
+                visitor.visitResponseReasoningTextDelta(responseReasoningTextDelta)
+            responseReasoningTextDone != null ->
+                visitor.visitResponseReasoningTextDone(responseReasoningTextDone)
+            responseRefusalDelta != null -> visitor.visitResponseRefusalDelta(responseRefusalDelta)
+            responseRefusalDone != null -> visitor.visitResponseRefusalDone(responseRefusalDone)
+            responseOutputTextDelta != null ->
+                visitor.visitResponseOutputTextDelta(responseOutputTextDelta)
+            responseOutputTextDone != null ->
+                visitor.visitResponseOutputTextDone(responseOutputTextDone)
+            responseWebSearchCallCompleted != null ->
+                visitor.visitResponseWebSearchCallCompleted(responseWebSearchCallCompleted)
+            responseWebSearchCallInProgress != null ->
+                visitor.visitResponseWebSearchCallInProgress(responseWebSearchCallInProgress)
+            responseWebSearchCallSearching != null ->
+                visitor.visitResponseWebSearchCallSearching(responseWebSearchCallSearching)
+            responseImageGenerationCallCompleted != null ->
+                visitor.visitResponseImageGenerationCallCompleted(
+                    responseImageGenerationCallCompleted
+                )
+            responseImageGenerationCallGenerating != null ->
+                visitor.visitResponseImageGenerationCallGenerating(
+                    responseImageGenerationCallGenerating
+                )
+            responseImageGenerationCallInProgress != null ->
+                visitor.visitResponseImageGenerationCallInProgress(
+                    responseImageGenerationCallInProgress
+                )
+            responseImageGenerationCallPartialImage != null ->
+                visitor.visitResponseImageGenerationCallPartialImage(
+                    responseImageGenerationCallPartialImage
+                )
+            responseMcpCallArgumentsDelta != null ->
+                visitor.visitResponseMcpCallArgumentsDelta(responseMcpCallArgumentsDelta)
+            responseMcpCallArgumentsDone != null ->
+                visitor.visitResponseMcpCallArgumentsDone(responseMcpCallArgumentsDone)
+            responseMcpCallCompleted != null ->
+                visitor.visitResponseMcpCallCompleted(responseMcpCallCompleted)
+            responseMcpCallFailed != null ->
+                visitor.visitResponseMcpCallFailed(responseMcpCallFailed)
+            responseMcpCallInProgress != null ->
+                visitor.visitResponseMcpCallInProgress(responseMcpCallInProgress)
+            responseMcpListToolsCompleted != null ->
+                visitor.visitResponseMcpListToolsCompleted(responseMcpListToolsCompleted)
+            responseMcpListToolsFailed != null ->
+                visitor.visitResponseMcpListToolsFailed(responseMcpListToolsFailed)
+            responseMcpListToolsInProgress != null ->
+                visitor.visitResponseMcpListToolsInProgress(responseMcpListToolsInProgress)
+            responseOutputTextAnnotationAdded != null ->
+                visitor.visitResponseOutputTextAnnotationAdded(responseOutputTextAnnotationAdded)
+            responseQueued != null -> visitor.visitResponseQueued(responseQueued)
+            responseCustomToolCallInputDelta != null ->
+                visitor.visitResponseCustomToolCallInputDelta(responseCustomToolCallInputDelta)
+            responseCustomToolCallInputDone != null ->
+                visitor.visitResponseCustomToolCallInputDone(responseCustomToolCallInputDone)
+            responseInjectCreated != null ->
+                visitor.visitResponseInjectCreated(responseInjectCreated)
+            responseInjectFailed != null -> visitor.visitResponseInjectFailed(responseInjectFailed)
+            else -> visitor.unknown(_json)
+        }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponsesServerEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        accept(
+            object : Visitor<Unit> {
+                override fun visitResponseAudioDelta(
+                    responseAudioDelta: BetaResponseAudioDeltaEvent
+                ) {
+                    responseAudioDelta.validate()
+                }
+
+                override fun visitResponseAudioDone(responseAudioDone: BetaResponseAudioDoneEvent) {
+                    responseAudioDone.validate()
+                }
+
+                override fun visitResponseAudioTranscriptDelta(
+                    responseAudioTranscriptDelta: BetaResponseAudioTranscriptDeltaEvent
+                ) {
+                    responseAudioTranscriptDelta.validate()
+                }
+
+                override fun visitResponseAudioTranscriptDone(
+                    responseAudioTranscriptDone: BetaResponseAudioTranscriptDoneEvent
+                ) {
+                    responseAudioTranscriptDone.validate()
+                }
+
+                override fun visitResponseCodeInterpreterCallCodeDelta(
+                    responseCodeInterpreterCallCodeDelta:
+                        BetaResponseCodeInterpreterCallCodeDeltaEvent
+                ) {
+                    responseCodeInterpreterCallCodeDelta.validate()
+                }
+
+                override fun visitResponseCodeInterpreterCallCodeDone(
+                    responseCodeInterpreterCallCodeDone:
+                        BetaResponseCodeInterpreterCallCodeDoneEvent
+                ) {
+                    responseCodeInterpreterCallCodeDone.validate()
+                }
+
+                override fun visitResponseCodeInterpreterCallCompleted(
+                    responseCodeInterpreterCallCompleted:
+                        BetaResponseCodeInterpreterCallCompletedEvent
+                ) {
+                    responseCodeInterpreterCallCompleted.validate()
+                }
+
+                override fun visitResponseCodeInterpreterCallInProgress(
+                    responseCodeInterpreterCallInProgress:
+                        BetaResponseCodeInterpreterCallInProgressEvent
+                ) {
+                    responseCodeInterpreterCallInProgress.validate()
+                }
+
+                override fun visitResponseCodeInterpreterCallInterpreting(
+                    responseCodeInterpreterCallInterpreting:
+                        BetaResponseCodeInterpreterCallInterpretingEvent
+                ) {
+                    responseCodeInterpreterCallInterpreting.validate()
+                }
+
+                override fun visitResponseCompleted(responseCompleted: BetaResponseCompletedEvent) {
+                    responseCompleted.validate()
+                }
+
+                override fun visitResponseContentPartAdded(
+                    responseContentPartAdded: BetaResponseContentPartAddedEvent
+                ) {
+                    responseContentPartAdded.validate()
+                }
+
+                override fun visitResponseContentPartDone(
+                    responseContentPartDone: BetaResponseContentPartDoneEvent
+                ) {
+                    responseContentPartDone.validate()
+                }
+
+                override fun visitResponseCreated(responseCreated: BetaResponseCreatedEvent) {
+                    responseCreated.validate()
+                }
+
+                override fun visitError(error: BetaResponseErrorEvent) {
+                    error.validate()
+                }
+
+                override fun visitResponseFileSearchCallCompleted(
+                    responseFileSearchCallCompleted: BetaResponseFileSearchCallCompletedEvent
+                ) {
+                    responseFileSearchCallCompleted.validate()
+                }
+
+                override fun visitResponseFileSearchCallInProgress(
+                    responseFileSearchCallInProgress: BetaResponseFileSearchCallInProgressEvent
+                ) {
+                    responseFileSearchCallInProgress.validate()
+                }
+
+                override fun visitResponseFileSearchCallSearching(
+                    responseFileSearchCallSearching: BetaResponseFileSearchCallSearchingEvent
+                ) {
+                    responseFileSearchCallSearching.validate()
+                }
+
+                override fun visitResponseFunctionCallArgumentsDelta(
+                    responseFunctionCallArgumentsDelta: BetaResponseFunctionCallArgumentsDeltaEvent
+                ) {
+                    responseFunctionCallArgumentsDelta.validate()
+                }
+
+                override fun visitResponseFunctionCallArgumentsDone(
+                    responseFunctionCallArgumentsDone: BetaResponseFunctionCallArgumentsDoneEvent
+                ) {
+                    responseFunctionCallArgumentsDone.validate()
+                }
+
+                override fun visitResponseInProgress(
+                    responseInProgress: BetaResponseInProgressEvent
+                ) {
+                    responseInProgress.validate()
+                }
+
+                override fun visitResponseFailed(responseFailed: BetaResponseFailedEvent) {
+                    responseFailed.validate()
+                }
+
+                override fun visitResponseIncomplete(
+                    responseIncomplete: BetaResponseIncompleteEvent
+                ) {
+                    responseIncomplete.validate()
+                }
+
+                override fun visitResponseOutputItemAdded(
+                    responseOutputItemAdded: BetaResponseOutputItemAddedEvent
+                ) {
+                    responseOutputItemAdded.validate()
+                }
+
+                override fun visitResponseOutputItemDone(
+                    responseOutputItemDone: BetaResponseOutputItemDoneEvent
+                ) {
+                    responseOutputItemDone.validate()
+                }
+
+                override fun visitResponseReasoningSummaryPartAdded(
+                    responseReasoningSummaryPartAdded: BetaResponseReasoningSummaryPartAddedEvent
+                ) {
+                    responseReasoningSummaryPartAdded.validate()
+                }
+
+                override fun visitResponseReasoningSummaryPartDone(
+                    responseReasoningSummaryPartDone: BetaResponseReasoningSummaryPartDoneEvent
+                ) {
+                    responseReasoningSummaryPartDone.validate()
+                }
+
+                override fun visitResponseReasoningSummaryTextDelta(
+                    responseReasoningSummaryTextDelta: BetaResponseReasoningSummaryTextDeltaEvent
+                ) {
+                    responseReasoningSummaryTextDelta.validate()
+                }
+
+                override fun visitResponseReasoningSummaryTextDone(
+                    responseReasoningSummaryTextDone: BetaResponseReasoningSummaryTextDoneEvent
+                ) {
+                    responseReasoningSummaryTextDone.validate()
+                }
+
+                override fun visitResponseReasoningTextDelta(
+                    responseReasoningTextDelta: BetaResponseReasoningTextDeltaEvent
+                ) {
+                    responseReasoningTextDelta.validate()
+                }
+
+                override fun visitResponseReasoningTextDone(
+                    responseReasoningTextDone: BetaResponseReasoningTextDoneEvent
+                ) {
+                    responseReasoningTextDone.validate()
+                }
+
+                override fun visitResponseRefusalDelta(
+                    responseRefusalDelta: BetaResponseRefusalDeltaEvent
+                ) {
+                    responseRefusalDelta.validate()
+                }
+
+                override fun visitResponseRefusalDone(
+                    responseRefusalDone: BetaResponseRefusalDoneEvent
+                ) {
+                    responseRefusalDone.validate()
+                }
+
+                override fun visitResponseOutputTextDelta(
+                    responseOutputTextDelta: BetaResponseTextDeltaEvent
+                ) {
+                    responseOutputTextDelta.validate()
+                }
+
+                override fun visitResponseOutputTextDone(
+                    responseOutputTextDone: BetaResponseTextDoneEvent
+                ) {
+                    responseOutputTextDone.validate()
+                }
+
+                override fun visitResponseWebSearchCallCompleted(
+                    responseWebSearchCallCompleted: BetaResponseWebSearchCallCompletedEvent
+                ) {
+                    responseWebSearchCallCompleted.validate()
+                }
+
+                override fun visitResponseWebSearchCallInProgress(
+                    responseWebSearchCallInProgress: BetaResponseWebSearchCallInProgressEvent
+                ) {
+                    responseWebSearchCallInProgress.validate()
+                }
+
+                override fun visitResponseWebSearchCallSearching(
+                    responseWebSearchCallSearching: BetaResponseWebSearchCallSearchingEvent
+                ) {
+                    responseWebSearchCallSearching.validate()
+                }
+
+                override fun visitResponseImageGenerationCallCompleted(
+                    responseImageGenerationCallCompleted: BetaResponseImageGenCallCompletedEvent
+                ) {
+                    responseImageGenerationCallCompleted.validate()
+                }
+
+                override fun visitResponseImageGenerationCallGenerating(
+                    responseImageGenerationCallGenerating: BetaResponseImageGenCallGeneratingEvent
+                ) {
+                    responseImageGenerationCallGenerating.validate()
+                }
+
+                override fun visitResponseImageGenerationCallInProgress(
+                    responseImageGenerationCallInProgress: BetaResponseImageGenCallInProgressEvent
+                ) {
+                    responseImageGenerationCallInProgress.validate()
+                }
+
+                override fun visitResponseImageGenerationCallPartialImage(
+                    responseImageGenerationCallPartialImage:
+                        BetaResponseImageGenCallPartialImageEvent
+                ) {
+                    responseImageGenerationCallPartialImage.validate()
+                }
+
+                override fun visitResponseMcpCallArgumentsDelta(
+                    responseMcpCallArgumentsDelta: BetaResponseMcpCallArgumentsDeltaEvent
+                ) {
+                    responseMcpCallArgumentsDelta.validate()
+                }
+
+                override fun visitResponseMcpCallArgumentsDone(
+                    responseMcpCallArgumentsDone: BetaResponseMcpCallArgumentsDoneEvent
+                ) {
+                    responseMcpCallArgumentsDone.validate()
+                }
+
+                override fun visitResponseMcpCallCompleted(
+                    responseMcpCallCompleted: BetaResponseMcpCallCompletedEvent
+                ) {
+                    responseMcpCallCompleted.validate()
+                }
+
+                override fun visitResponseMcpCallFailed(
+                    responseMcpCallFailed: BetaResponseMcpCallFailedEvent
+                ) {
+                    responseMcpCallFailed.validate()
+                }
+
+                override fun visitResponseMcpCallInProgress(
+                    responseMcpCallInProgress: BetaResponseMcpCallInProgressEvent
+                ) {
+                    responseMcpCallInProgress.validate()
+                }
+
+                override fun visitResponseMcpListToolsCompleted(
+                    responseMcpListToolsCompleted: BetaResponseMcpListToolsCompletedEvent
+                ) {
+                    responseMcpListToolsCompleted.validate()
+                }
+
+                override fun visitResponseMcpListToolsFailed(
+                    responseMcpListToolsFailed: BetaResponseMcpListToolsFailedEvent
+                ) {
+                    responseMcpListToolsFailed.validate()
+                }
+
+                override fun visitResponseMcpListToolsInProgress(
+                    responseMcpListToolsInProgress: BetaResponseMcpListToolsInProgressEvent
+                ) {
+                    responseMcpListToolsInProgress.validate()
+                }
+
+                override fun visitResponseOutputTextAnnotationAdded(
+                    responseOutputTextAnnotationAdded: BetaResponseOutputTextAnnotationAddedEvent
+                ) {
+                    responseOutputTextAnnotationAdded.validate()
+                }
+
+                override fun visitResponseQueued(responseQueued: BetaResponseQueuedEvent) {
+                    responseQueued.validate()
+                }
+
+                override fun visitResponseCustomToolCallInputDelta(
+                    responseCustomToolCallInputDelta: BetaResponseCustomToolCallInputDeltaEvent
+                ) {
+                    responseCustomToolCallInputDelta.validate()
+                }
+
+                override fun visitResponseCustomToolCallInputDone(
+                    responseCustomToolCallInputDone: BetaResponseCustomToolCallInputDoneEvent
+                ) {
+                    responseCustomToolCallInputDone.validate()
+                }
+
+                override fun visitResponseInjectCreated(
+                    responseInjectCreated: BetaResponseInjectCreatedEvent
+                ) {
+                    responseInjectCreated.validate()
+                }
+
+                override fun visitResponseInjectFailed(
+                    responseInjectFailed: BetaResponseInjectFailedEvent
+                ) {
+                    responseInjectFailed.validate()
+                }
+            }
+        )
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        accept(
+            object : Visitor<Int> {
+                override fun visitResponseAudioDelta(
+                    responseAudioDelta: BetaResponseAudioDeltaEvent
+                ) = responseAudioDelta.validity()
+
+                override fun visitResponseAudioDone(responseAudioDone: BetaResponseAudioDoneEvent) =
+                    responseAudioDone.validity()
+
+                override fun visitResponseAudioTranscriptDelta(
+                    responseAudioTranscriptDelta: BetaResponseAudioTranscriptDeltaEvent
+                ) = responseAudioTranscriptDelta.validity()
+
+                override fun visitResponseAudioTranscriptDone(
+                    responseAudioTranscriptDone: BetaResponseAudioTranscriptDoneEvent
+                ) = responseAudioTranscriptDone.validity()
+
+                override fun visitResponseCodeInterpreterCallCodeDelta(
+                    responseCodeInterpreterCallCodeDelta:
+                        BetaResponseCodeInterpreterCallCodeDeltaEvent
+                ) = responseCodeInterpreterCallCodeDelta.validity()
+
+                override fun visitResponseCodeInterpreterCallCodeDone(
+                    responseCodeInterpreterCallCodeDone:
+                        BetaResponseCodeInterpreterCallCodeDoneEvent
+                ) = responseCodeInterpreterCallCodeDone.validity()
+
+                override fun visitResponseCodeInterpreterCallCompleted(
+                    responseCodeInterpreterCallCompleted:
+                        BetaResponseCodeInterpreterCallCompletedEvent
+                ) = responseCodeInterpreterCallCompleted.validity()
+
+                override fun visitResponseCodeInterpreterCallInProgress(
+                    responseCodeInterpreterCallInProgress:
+                        BetaResponseCodeInterpreterCallInProgressEvent
+                ) = responseCodeInterpreterCallInProgress.validity()
+
+                override fun visitResponseCodeInterpreterCallInterpreting(
+                    responseCodeInterpreterCallInterpreting:
+                        BetaResponseCodeInterpreterCallInterpretingEvent
+                ) = responseCodeInterpreterCallInterpreting.validity()
+
+                override fun visitResponseCompleted(responseCompleted: BetaResponseCompletedEvent) =
+                    responseCompleted.validity()
+
+                override fun visitResponseContentPartAdded(
+                    responseContentPartAdded: BetaResponseContentPartAddedEvent
+                ) = responseContentPartAdded.validity()
+
+                override fun visitResponseContentPartDone(
+                    responseContentPartDone: BetaResponseContentPartDoneEvent
+                ) = responseContentPartDone.validity()
+
+                override fun visitResponseCreated(responseCreated: BetaResponseCreatedEvent) =
+                    responseCreated.validity()
+
+                override fun visitError(error: BetaResponseErrorEvent) = error.validity()
+
+                override fun visitResponseFileSearchCallCompleted(
+                    responseFileSearchCallCompleted: BetaResponseFileSearchCallCompletedEvent
+                ) = responseFileSearchCallCompleted.validity()
+
+                override fun visitResponseFileSearchCallInProgress(
+                    responseFileSearchCallInProgress: BetaResponseFileSearchCallInProgressEvent
+                ) = responseFileSearchCallInProgress.validity()
+
+                override fun visitResponseFileSearchCallSearching(
+                    responseFileSearchCallSearching: BetaResponseFileSearchCallSearchingEvent
+                ) = responseFileSearchCallSearching.validity()
+
+                override fun visitResponseFunctionCallArgumentsDelta(
+                    responseFunctionCallArgumentsDelta: BetaResponseFunctionCallArgumentsDeltaEvent
+                ) = responseFunctionCallArgumentsDelta.validity()
+
+                override fun visitResponseFunctionCallArgumentsDone(
+                    responseFunctionCallArgumentsDone: BetaResponseFunctionCallArgumentsDoneEvent
+                ) = responseFunctionCallArgumentsDone.validity()
+
+                override fun visitResponseInProgress(
+                    responseInProgress: BetaResponseInProgressEvent
+                ) = responseInProgress.validity()
+
+                override fun visitResponseFailed(responseFailed: BetaResponseFailedEvent) =
+                    responseFailed.validity()
+
+                override fun visitResponseIncomplete(
+                    responseIncomplete: BetaResponseIncompleteEvent
+                ) = responseIncomplete.validity()
+
+                override fun visitResponseOutputItemAdded(
+                    responseOutputItemAdded: BetaResponseOutputItemAddedEvent
+                ) = responseOutputItemAdded.validity()
+
+                override fun visitResponseOutputItemDone(
+                    responseOutputItemDone: BetaResponseOutputItemDoneEvent
+                ) = responseOutputItemDone.validity()
+
+                override fun visitResponseReasoningSummaryPartAdded(
+                    responseReasoningSummaryPartAdded: BetaResponseReasoningSummaryPartAddedEvent
+                ) = responseReasoningSummaryPartAdded.validity()
+
+                override fun visitResponseReasoningSummaryPartDone(
+                    responseReasoningSummaryPartDone: BetaResponseReasoningSummaryPartDoneEvent
+                ) = responseReasoningSummaryPartDone.validity()
+
+                override fun visitResponseReasoningSummaryTextDelta(
+                    responseReasoningSummaryTextDelta: BetaResponseReasoningSummaryTextDeltaEvent
+                ) = responseReasoningSummaryTextDelta.validity()
+
+                override fun visitResponseReasoningSummaryTextDone(
+                    responseReasoningSummaryTextDone: BetaResponseReasoningSummaryTextDoneEvent
+                ) = responseReasoningSummaryTextDone.validity()
+
+                override fun visitResponseReasoningTextDelta(
+                    responseReasoningTextDelta: BetaResponseReasoningTextDeltaEvent
+                ) = responseReasoningTextDelta.validity()
+
+                override fun visitResponseReasoningTextDone(
+                    responseReasoningTextDone: BetaResponseReasoningTextDoneEvent
+                ) = responseReasoningTextDone.validity()
+
+                override fun visitResponseRefusalDelta(
+                    responseRefusalDelta: BetaResponseRefusalDeltaEvent
+                ) = responseRefusalDelta.validity()
+
+                override fun visitResponseRefusalDone(
+                    responseRefusalDone: BetaResponseRefusalDoneEvent
+                ) = responseRefusalDone.validity()
+
+                override fun visitResponseOutputTextDelta(
+                    responseOutputTextDelta: BetaResponseTextDeltaEvent
+                ) = responseOutputTextDelta.validity()
+
+                override fun visitResponseOutputTextDone(
+                    responseOutputTextDone: BetaResponseTextDoneEvent
+                ) = responseOutputTextDone.validity()
+
+                override fun visitResponseWebSearchCallCompleted(
+                    responseWebSearchCallCompleted: BetaResponseWebSearchCallCompletedEvent
+                ) = responseWebSearchCallCompleted.validity()
+
+                override fun visitResponseWebSearchCallInProgress(
+                    responseWebSearchCallInProgress: BetaResponseWebSearchCallInProgressEvent
+                ) = responseWebSearchCallInProgress.validity()
+
+                override fun visitResponseWebSearchCallSearching(
+                    responseWebSearchCallSearching: BetaResponseWebSearchCallSearchingEvent
+                ) = responseWebSearchCallSearching.validity()
+
+                override fun visitResponseImageGenerationCallCompleted(
+                    responseImageGenerationCallCompleted: BetaResponseImageGenCallCompletedEvent
+                ) = responseImageGenerationCallCompleted.validity()
+
+                override fun visitResponseImageGenerationCallGenerating(
+                    responseImageGenerationCallGenerating: BetaResponseImageGenCallGeneratingEvent
+                ) = responseImageGenerationCallGenerating.validity()
+
+                override fun visitResponseImageGenerationCallInProgress(
+                    responseImageGenerationCallInProgress: BetaResponseImageGenCallInProgressEvent
+                ) = responseImageGenerationCallInProgress.validity()
+
+                override fun visitResponseImageGenerationCallPartialImage(
+                    responseImageGenerationCallPartialImage:
+                        BetaResponseImageGenCallPartialImageEvent
+                ) = responseImageGenerationCallPartialImage.validity()
+
+                override fun visitResponseMcpCallArgumentsDelta(
+                    responseMcpCallArgumentsDelta: BetaResponseMcpCallArgumentsDeltaEvent
+                ) = responseMcpCallArgumentsDelta.validity()
+
+                override fun visitResponseMcpCallArgumentsDone(
+                    responseMcpCallArgumentsDone: BetaResponseMcpCallArgumentsDoneEvent
+                ) = responseMcpCallArgumentsDone.validity()
+
+                override fun visitResponseMcpCallCompleted(
+                    responseMcpCallCompleted: BetaResponseMcpCallCompletedEvent
+                ) = responseMcpCallCompleted.validity()
+
+                override fun visitResponseMcpCallFailed(
+                    responseMcpCallFailed: BetaResponseMcpCallFailedEvent
+                ) = responseMcpCallFailed.validity()
+
+                override fun visitResponseMcpCallInProgress(
+                    responseMcpCallInProgress: BetaResponseMcpCallInProgressEvent
+                ) = responseMcpCallInProgress.validity()
+
+                override fun visitResponseMcpListToolsCompleted(
+                    responseMcpListToolsCompleted: BetaResponseMcpListToolsCompletedEvent
+                ) = responseMcpListToolsCompleted.validity()
+
+                override fun visitResponseMcpListToolsFailed(
+                    responseMcpListToolsFailed: BetaResponseMcpListToolsFailedEvent
+                ) = responseMcpListToolsFailed.validity()
+
+                override fun visitResponseMcpListToolsInProgress(
+                    responseMcpListToolsInProgress: BetaResponseMcpListToolsInProgressEvent
+                ) = responseMcpListToolsInProgress.validity()
+
+                override fun visitResponseOutputTextAnnotationAdded(
+                    responseOutputTextAnnotationAdded: BetaResponseOutputTextAnnotationAddedEvent
+                ) = responseOutputTextAnnotationAdded.validity()
+
+                override fun visitResponseQueued(responseQueued: BetaResponseQueuedEvent) =
+                    responseQueued.validity()
+
+                override fun visitResponseCustomToolCallInputDelta(
+                    responseCustomToolCallInputDelta: BetaResponseCustomToolCallInputDeltaEvent
+                ) = responseCustomToolCallInputDelta.validity()
+
+                override fun visitResponseCustomToolCallInputDone(
+                    responseCustomToolCallInputDone: BetaResponseCustomToolCallInputDoneEvent
+                ) = responseCustomToolCallInputDone.validity()
+
+                override fun visitResponseInjectCreated(
+                    responseInjectCreated: BetaResponseInjectCreatedEvent
+                ) = responseInjectCreated.validity()
+
+                override fun visitResponseInjectFailed(
+                    responseInjectFailed: BetaResponseInjectFailedEvent
+                ) = responseInjectFailed.validity()
+
+                override fun unknown(json: JsonValue?) = 0
+            }
+        )
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponsesServerEvent &&
+            responseAudioDelta == other.responseAudioDelta &&
+            responseAudioDone == other.responseAudioDone &&
+            responseAudioTranscriptDelta == other.responseAudioTranscriptDelta &&
+            responseAudioTranscriptDone == other.responseAudioTranscriptDone &&
+            responseCodeInterpreterCallCodeDelta == other.responseCodeInterpreterCallCodeDelta &&
+            responseCodeInterpreterCallCodeDone == other.responseCodeInterpreterCallCodeDone &&
+            responseCodeInterpreterCallCompleted == other.responseCodeInterpreterCallCompleted &&
+            responseCodeInterpreterCallInProgress == other.responseCodeInterpreterCallInProgress &&
+            responseCodeInterpreterCallInterpreting ==
+                other.responseCodeInterpreterCallInterpreting &&
+            responseCompleted == other.responseCompleted &&
+            responseContentPartAdded == other.responseContentPartAdded &&
+            responseContentPartDone == other.responseContentPartDone &&
+            responseCreated == other.responseCreated &&
+            error == other.error &&
+            responseFileSearchCallCompleted == other.responseFileSearchCallCompleted &&
+            responseFileSearchCallInProgress == other.responseFileSearchCallInProgress &&
+            responseFileSearchCallSearching == other.responseFileSearchCallSearching &&
+            responseFunctionCallArgumentsDelta == other.responseFunctionCallArgumentsDelta &&
+            responseFunctionCallArgumentsDone == other.responseFunctionCallArgumentsDone &&
+            responseInProgress == other.responseInProgress &&
+            responseFailed == other.responseFailed &&
+            responseIncomplete == other.responseIncomplete &&
+            responseOutputItemAdded == other.responseOutputItemAdded &&
+            responseOutputItemDone == other.responseOutputItemDone &&
+            responseReasoningSummaryPartAdded == other.responseReasoningSummaryPartAdded &&
+            responseReasoningSummaryPartDone == other.responseReasoningSummaryPartDone &&
+            responseReasoningSummaryTextDelta == other.responseReasoningSummaryTextDelta &&
+            responseReasoningSummaryTextDone == other.responseReasoningSummaryTextDone &&
+            responseReasoningTextDelta == other.responseReasoningTextDelta &&
+            responseReasoningTextDone == other.responseReasoningTextDone &&
+            responseRefusalDelta == other.responseRefusalDelta &&
+            responseRefusalDone == other.responseRefusalDone &&
+            responseOutputTextDelta == other.responseOutputTextDelta &&
+            responseOutputTextDone == other.responseOutputTextDone &&
+            responseWebSearchCallCompleted == other.responseWebSearchCallCompleted &&
+            responseWebSearchCallInProgress == other.responseWebSearchCallInProgress &&
+            responseWebSearchCallSearching == other.responseWebSearchCallSearching &&
+            responseImageGenerationCallCompleted == other.responseImageGenerationCallCompleted &&
+            responseImageGenerationCallGenerating == other.responseImageGenerationCallGenerating &&
+            responseImageGenerationCallInProgress == other.responseImageGenerationCallInProgress &&
+            responseImageGenerationCallPartialImage ==
+                other.responseImageGenerationCallPartialImage &&
+            responseMcpCallArgumentsDelta == other.responseMcpCallArgumentsDelta &&
+            responseMcpCallArgumentsDone == other.responseMcpCallArgumentsDone &&
+            responseMcpCallCompleted == other.responseMcpCallCompleted &&
+            responseMcpCallFailed == other.responseMcpCallFailed &&
+            responseMcpCallInProgress == other.responseMcpCallInProgress &&
+            responseMcpListToolsCompleted == other.responseMcpListToolsCompleted &&
+            responseMcpListToolsFailed == other.responseMcpListToolsFailed &&
+            responseMcpListToolsInProgress == other.responseMcpListToolsInProgress &&
+            responseOutputTextAnnotationAdded == other.responseOutputTextAnnotationAdded &&
+            responseQueued == other.responseQueued &&
+            responseCustomToolCallInputDelta == other.responseCustomToolCallInputDelta &&
+            responseCustomToolCallInputDone == other.responseCustomToolCallInputDone &&
+            responseInjectCreated == other.responseInjectCreated &&
+            responseInjectFailed == other.responseInjectFailed
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(
+            responseAudioDelta,
+            responseAudioDone,
+            responseAudioTranscriptDelta,
+            responseAudioTranscriptDone,
+            responseCodeInterpreterCallCodeDelta,
+            responseCodeInterpreterCallCodeDone,
+            responseCodeInterpreterCallCompleted,
+            responseCodeInterpreterCallInProgress,
+            responseCodeInterpreterCallInterpreting,
+            responseCompleted,
+            responseContentPartAdded,
+            responseContentPartDone,
+            responseCreated,
+            error,
+            responseFileSearchCallCompleted,
+            responseFileSearchCallInProgress,
+            responseFileSearchCallSearching,
+            responseFunctionCallArgumentsDelta,
+            responseFunctionCallArgumentsDone,
+            responseInProgress,
+            responseFailed,
+            responseIncomplete,
+            responseOutputItemAdded,
+            responseOutputItemDone,
+            responseReasoningSummaryPartAdded,
+            responseReasoningSummaryPartDone,
+            responseReasoningSummaryTextDelta,
+            responseReasoningSummaryTextDone,
+            responseReasoningTextDelta,
+            responseReasoningTextDone,
+            responseRefusalDelta,
+            responseRefusalDone,
+            responseOutputTextDelta,
+            responseOutputTextDone,
+            responseWebSearchCallCompleted,
+            responseWebSearchCallInProgress,
+            responseWebSearchCallSearching,
+            responseImageGenerationCallCompleted,
+            responseImageGenerationCallGenerating,
+            responseImageGenerationCallInProgress,
+            responseImageGenerationCallPartialImage,
+            responseMcpCallArgumentsDelta,
+            responseMcpCallArgumentsDone,
+            responseMcpCallCompleted,
+            responseMcpCallFailed,
+            responseMcpCallInProgress,
+            responseMcpListToolsCompleted,
+            responseMcpListToolsFailed,
+            responseMcpListToolsInProgress,
+            responseOutputTextAnnotationAdded,
+            responseQueued,
+            responseCustomToolCallInputDelta,
+            responseCustomToolCallInputDone,
+            responseInjectCreated,
+            responseInjectFailed,
+        )
+
+    override fun toString(): String =
+        when {
+            responseAudioDelta != null ->
+                "BetaResponsesServerEvent{responseAudioDelta=$responseAudioDelta}"
+            responseAudioDone != null ->
+                "BetaResponsesServerEvent{responseAudioDone=$responseAudioDone}"
+            responseAudioTranscriptDelta != null ->
+                "BetaResponsesServerEvent{responseAudioTranscriptDelta=$responseAudioTranscriptDelta}"
+            responseAudioTranscriptDone != null ->
+                "BetaResponsesServerEvent{responseAudioTranscriptDone=$responseAudioTranscriptDone}"
+            responseCodeInterpreterCallCodeDelta != null ->
+                "BetaResponsesServerEvent{responseCodeInterpreterCallCodeDelta=$responseCodeInterpreterCallCodeDelta}"
+            responseCodeInterpreterCallCodeDone != null ->
+                "BetaResponsesServerEvent{responseCodeInterpreterCallCodeDone=$responseCodeInterpreterCallCodeDone}"
+            responseCodeInterpreterCallCompleted != null ->
+                "BetaResponsesServerEvent{responseCodeInterpreterCallCompleted=$responseCodeInterpreterCallCompleted}"
+            responseCodeInterpreterCallInProgress != null ->
+                "BetaResponsesServerEvent{responseCodeInterpreterCallInProgress=$responseCodeInterpreterCallInProgress}"
+            responseCodeInterpreterCallInterpreting != null ->
+                "BetaResponsesServerEvent{responseCodeInterpreterCallInterpreting=$responseCodeInterpreterCallInterpreting}"
+            responseCompleted != null ->
+                "BetaResponsesServerEvent{responseCompleted=$responseCompleted}"
+            responseContentPartAdded != null ->
+                "BetaResponsesServerEvent{responseContentPartAdded=$responseContentPartAdded}"
+            responseContentPartDone != null ->
+                "BetaResponsesServerEvent{responseContentPartDone=$responseContentPartDone}"
+            responseCreated != null -> "BetaResponsesServerEvent{responseCreated=$responseCreated}"
+            error != null -> "BetaResponsesServerEvent{error=$error}"
+            responseFileSearchCallCompleted != null ->
+                "BetaResponsesServerEvent{responseFileSearchCallCompleted=$responseFileSearchCallCompleted}"
+            responseFileSearchCallInProgress != null ->
+                "BetaResponsesServerEvent{responseFileSearchCallInProgress=$responseFileSearchCallInProgress}"
+            responseFileSearchCallSearching != null ->
+                "BetaResponsesServerEvent{responseFileSearchCallSearching=$responseFileSearchCallSearching}"
+            responseFunctionCallArgumentsDelta != null ->
+                "BetaResponsesServerEvent{responseFunctionCallArgumentsDelta=$responseFunctionCallArgumentsDelta}"
+            responseFunctionCallArgumentsDone != null ->
+                "BetaResponsesServerEvent{responseFunctionCallArgumentsDone=$responseFunctionCallArgumentsDone}"
+            responseInProgress != null ->
+                "BetaResponsesServerEvent{responseInProgress=$responseInProgress}"
+            responseFailed != null -> "BetaResponsesServerEvent{responseFailed=$responseFailed}"
+            responseIncomplete != null ->
+                "BetaResponsesServerEvent{responseIncomplete=$responseIncomplete}"
+            responseOutputItemAdded != null ->
+                "BetaResponsesServerEvent{responseOutputItemAdded=$responseOutputItemAdded}"
+            responseOutputItemDone != null ->
+                "BetaResponsesServerEvent{responseOutputItemDone=$responseOutputItemDone}"
+            responseReasoningSummaryPartAdded != null ->
+                "BetaResponsesServerEvent{responseReasoningSummaryPartAdded=$responseReasoningSummaryPartAdded}"
+            responseReasoningSummaryPartDone != null ->
+                "BetaResponsesServerEvent{responseReasoningSummaryPartDone=$responseReasoningSummaryPartDone}"
+            responseReasoningSummaryTextDelta != null ->
+                "BetaResponsesServerEvent{responseReasoningSummaryTextDelta=$responseReasoningSummaryTextDelta}"
+            responseReasoningSummaryTextDone != null ->
+                "BetaResponsesServerEvent{responseReasoningSummaryTextDone=$responseReasoningSummaryTextDone}"
+            responseReasoningTextDelta != null ->
+                "BetaResponsesServerEvent{responseReasoningTextDelta=$responseReasoningTextDelta}"
+            responseReasoningTextDone != null ->
+                "BetaResponsesServerEvent{responseReasoningTextDone=$responseReasoningTextDone}"
+            responseRefusalDelta != null ->
+                "BetaResponsesServerEvent{responseRefusalDelta=$responseRefusalDelta}"
+            responseRefusalDone != null ->
+                "BetaResponsesServerEvent{responseRefusalDone=$responseRefusalDone}"
+            responseOutputTextDelta != null ->
+                "BetaResponsesServerEvent{responseOutputTextDelta=$responseOutputTextDelta}"
+            responseOutputTextDone != null ->
+                "BetaResponsesServerEvent{responseOutputTextDone=$responseOutputTextDone}"
+            responseWebSearchCallCompleted != null ->
+                "BetaResponsesServerEvent{responseWebSearchCallCompleted=$responseWebSearchCallCompleted}"
+            responseWebSearchCallInProgress != null ->
+                "BetaResponsesServerEvent{responseWebSearchCallInProgress=$responseWebSearchCallInProgress}"
+            responseWebSearchCallSearching != null ->
+                "BetaResponsesServerEvent{responseWebSearchCallSearching=$responseWebSearchCallSearching}"
+            responseImageGenerationCallCompleted != null ->
+                "BetaResponsesServerEvent{responseImageGenerationCallCompleted=$responseImageGenerationCallCompleted}"
+            responseImageGenerationCallGenerating != null ->
+                "BetaResponsesServerEvent{responseImageGenerationCallGenerating=$responseImageGenerationCallGenerating}"
+            responseImageGenerationCallInProgress != null ->
+                "BetaResponsesServerEvent{responseImageGenerationCallInProgress=$responseImageGenerationCallInProgress}"
+            responseImageGenerationCallPartialImage != null ->
+                "BetaResponsesServerEvent{responseImageGenerationCallPartialImage=$responseImageGenerationCallPartialImage}"
+            responseMcpCallArgumentsDelta != null ->
+                "BetaResponsesServerEvent{responseMcpCallArgumentsDelta=$responseMcpCallArgumentsDelta}"
+            responseMcpCallArgumentsDone != null ->
+                "BetaResponsesServerEvent{responseMcpCallArgumentsDone=$responseMcpCallArgumentsDone}"
+            responseMcpCallCompleted != null ->
+                "BetaResponsesServerEvent{responseMcpCallCompleted=$responseMcpCallCompleted}"
+            responseMcpCallFailed != null ->
+                "BetaResponsesServerEvent{responseMcpCallFailed=$responseMcpCallFailed}"
+            responseMcpCallInProgress != null ->
+                "BetaResponsesServerEvent{responseMcpCallInProgress=$responseMcpCallInProgress}"
+            responseMcpListToolsCompleted != null ->
+                "BetaResponsesServerEvent{responseMcpListToolsCompleted=$responseMcpListToolsCompleted}"
+            responseMcpListToolsFailed != null ->
+                "BetaResponsesServerEvent{responseMcpListToolsFailed=$responseMcpListToolsFailed}"
+            responseMcpListToolsInProgress != null ->
+                "BetaResponsesServerEvent{responseMcpListToolsInProgress=$responseMcpListToolsInProgress}"
+            responseOutputTextAnnotationAdded != null ->
+                "BetaResponsesServerEvent{responseOutputTextAnnotationAdded=$responseOutputTextAnnotationAdded}"
+            responseQueued != null -> "BetaResponsesServerEvent{responseQueued=$responseQueued}"
+            responseCustomToolCallInputDelta != null ->
+                "BetaResponsesServerEvent{responseCustomToolCallInputDelta=$responseCustomToolCallInputDelta}"
+            responseCustomToolCallInputDone != null ->
+                "BetaResponsesServerEvent{responseCustomToolCallInputDone=$responseCustomToolCallInputDone}"
+            responseInjectCreated != null ->
+                "BetaResponsesServerEvent{responseInjectCreated=$responseInjectCreated}"
+            responseInjectFailed != null ->
+                "BetaResponsesServerEvent{responseInjectFailed=$responseInjectFailed}"
+            _json != null -> "BetaResponsesServerEvent{_unknown=$_json}"
+            else -> throw IllegalStateException("Invalid BetaResponsesServerEvent")
+        }
+
+    companion object {
+
+        /** Emitted when there is a partial audio response. */
+        @JvmStatic
+        fun ofResponseAudioDelta(responseAudioDelta: BetaResponseAudioDeltaEvent) =
+            BetaResponsesServerEvent(responseAudioDelta = responseAudioDelta)
+
+        /** Emitted when the audio response is complete. */
+        @JvmStatic
+        fun ofResponseAudioDone(responseAudioDone: BetaResponseAudioDoneEvent) =
+            BetaResponsesServerEvent(responseAudioDone = responseAudioDone)
+
+        /** Emitted when there is a partial transcript of audio. */
+        @JvmStatic
+        fun ofResponseAudioTranscriptDelta(
+            responseAudioTranscriptDelta: BetaResponseAudioTranscriptDeltaEvent
+        ) = BetaResponsesServerEvent(responseAudioTranscriptDelta = responseAudioTranscriptDelta)
+
+        /** Emitted when the full audio transcript is completed. */
+        @JvmStatic
+        fun ofResponseAudioTranscriptDone(
+            responseAudioTranscriptDone: BetaResponseAudioTranscriptDoneEvent
+        ) = BetaResponsesServerEvent(responseAudioTranscriptDone = responseAudioTranscriptDone)
+
+        /** Emitted when a partial code snippet is streamed by the code interpreter. */
+        @JvmStatic
+        fun ofResponseCodeInterpreterCallCodeDelta(
+            responseCodeInterpreterCallCodeDelta: BetaResponseCodeInterpreterCallCodeDeltaEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseCodeInterpreterCallCodeDelta = responseCodeInterpreterCallCodeDelta
+            )
+
+        /** Emitted when the code snippet is finalized by the code interpreter. */
+        @JvmStatic
+        fun ofResponseCodeInterpreterCallCodeDone(
+            responseCodeInterpreterCallCodeDone: BetaResponseCodeInterpreterCallCodeDoneEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseCodeInterpreterCallCodeDone = responseCodeInterpreterCallCodeDone
+            )
+
+        /** Emitted when the code interpreter call is completed. */
+        @JvmStatic
+        fun ofResponseCodeInterpreterCallCompleted(
+            responseCodeInterpreterCallCompleted: BetaResponseCodeInterpreterCallCompletedEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseCodeInterpreterCallCompleted = responseCodeInterpreterCallCompleted
+            )
+
+        /** Emitted when a code interpreter call is in progress. */
+        @JvmStatic
+        fun ofResponseCodeInterpreterCallInProgress(
+            responseCodeInterpreterCallInProgress: BetaResponseCodeInterpreterCallInProgressEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseCodeInterpreterCallInProgress = responseCodeInterpreterCallInProgress
+            )
+
+        /** Emitted when the code interpreter is actively interpreting the code snippet. */
+        @JvmStatic
+        fun ofResponseCodeInterpreterCallInterpreting(
+            responseCodeInterpreterCallInterpreting:
+                BetaResponseCodeInterpreterCallInterpretingEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseCodeInterpreterCallInterpreting = responseCodeInterpreterCallInterpreting
+            )
+
+        /** Emitted when the model response is complete. */
+        @JvmStatic
+        fun ofResponseCompleted(responseCompleted: BetaResponseCompletedEvent) =
+            BetaResponsesServerEvent(responseCompleted = responseCompleted)
+
+        /** Emitted when a new content part is added. */
+        @JvmStatic
+        fun ofResponseContentPartAdded(
+            responseContentPartAdded: BetaResponseContentPartAddedEvent
+        ) = BetaResponsesServerEvent(responseContentPartAdded = responseContentPartAdded)
+
+        /** Emitted when a content part is done. */
+        @JvmStatic
+        fun ofResponseContentPartDone(responseContentPartDone: BetaResponseContentPartDoneEvent) =
+            BetaResponsesServerEvent(responseContentPartDone = responseContentPartDone)
+
+        /** An event that is emitted when a response is created. */
+        @JvmStatic
+        fun ofResponseCreated(responseCreated: BetaResponseCreatedEvent) =
+            BetaResponsesServerEvent(responseCreated = responseCreated)
+
+        /** Emitted when an error occurs. */
+        @JvmStatic
+        fun ofError(error: BetaResponseErrorEvent) = BetaResponsesServerEvent(error = error)
+
+        /** Emitted when a file search call is completed (results found). */
+        @JvmStatic
+        fun ofResponseFileSearchCallCompleted(
+            responseFileSearchCallCompleted: BetaResponseFileSearchCallCompletedEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseFileSearchCallCompleted = responseFileSearchCallCompleted
+            )
+
+        /** Emitted when a file search call is initiated. */
+        @JvmStatic
+        fun ofResponseFileSearchCallInProgress(
+            responseFileSearchCallInProgress: BetaResponseFileSearchCallInProgressEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseFileSearchCallInProgress = responseFileSearchCallInProgress
+            )
+
+        /** Emitted when a file search is currently searching. */
+        @JvmStatic
+        fun ofResponseFileSearchCallSearching(
+            responseFileSearchCallSearching: BetaResponseFileSearchCallSearchingEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseFileSearchCallSearching = responseFileSearchCallSearching
+            )
+
+        /** Emitted when there is a partial function-call arguments delta. */
+        @JvmStatic
+        fun ofResponseFunctionCallArgumentsDelta(
+            responseFunctionCallArgumentsDelta: BetaResponseFunctionCallArgumentsDeltaEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseFunctionCallArgumentsDelta = responseFunctionCallArgumentsDelta
+            )
+
+        /** Emitted when function-call arguments are finalized. */
+        @JvmStatic
+        fun ofResponseFunctionCallArgumentsDone(
+            responseFunctionCallArgumentsDone: BetaResponseFunctionCallArgumentsDoneEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseFunctionCallArgumentsDone = responseFunctionCallArgumentsDone
+            )
+
+        /** Emitted when the response is in progress. */
+        @JvmStatic
+        fun ofResponseInProgress(responseInProgress: BetaResponseInProgressEvent) =
+            BetaResponsesServerEvent(responseInProgress = responseInProgress)
+
+        /** An event that is emitted when a response fails. */
+        @JvmStatic
+        fun ofResponseFailed(responseFailed: BetaResponseFailedEvent) =
+            BetaResponsesServerEvent(responseFailed = responseFailed)
+
+        /** An event that is emitted when a response finishes as incomplete. */
+        @JvmStatic
+        fun ofResponseIncomplete(responseIncomplete: BetaResponseIncompleteEvent) =
+            BetaResponsesServerEvent(responseIncomplete = responseIncomplete)
+
+        /** Emitted when a new output item is added. */
+        @JvmStatic
+        fun ofResponseOutputItemAdded(responseOutputItemAdded: BetaResponseOutputItemAddedEvent) =
+            BetaResponsesServerEvent(responseOutputItemAdded = responseOutputItemAdded)
+
+        /** Emitted when an output item is marked done. */
+        @JvmStatic
+        fun ofResponseOutputItemDone(responseOutputItemDone: BetaResponseOutputItemDoneEvent) =
+            BetaResponsesServerEvent(responseOutputItemDone = responseOutputItemDone)
+
+        /** Emitted when a new reasoning summary part is added. */
+        @JvmStatic
+        fun ofResponseReasoningSummaryPartAdded(
+            responseReasoningSummaryPartAdded: BetaResponseReasoningSummaryPartAddedEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseReasoningSummaryPartAdded = responseReasoningSummaryPartAdded
+            )
+
+        /** Emitted when a reasoning summary part is completed. */
+        @JvmStatic
+        fun ofResponseReasoningSummaryPartDone(
+            responseReasoningSummaryPartDone: BetaResponseReasoningSummaryPartDoneEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseReasoningSummaryPartDone = responseReasoningSummaryPartDone
+            )
+
+        /** Emitted when a delta is added to a reasoning summary text. */
+        @JvmStatic
+        fun ofResponseReasoningSummaryTextDelta(
+            responseReasoningSummaryTextDelta: BetaResponseReasoningSummaryTextDeltaEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseReasoningSummaryTextDelta = responseReasoningSummaryTextDelta
+            )
+
+        /** Emitted when a reasoning summary text is completed. */
+        @JvmStatic
+        fun ofResponseReasoningSummaryTextDone(
+            responseReasoningSummaryTextDone: BetaResponseReasoningSummaryTextDoneEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseReasoningSummaryTextDone = responseReasoningSummaryTextDone
+            )
+
+        /** Emitted when a delta is added to a reasoning text. */
+        @JvmStatic
+        fun ofResponseReasoningTextDelta(
+            responseReasoningTextDelta: BetaResponseReasoningTextDeltaEvent
+        ) = BetaResponsesServerEvent(responseReasoningTextDelta = responseReasoningTextDelta)
+
+        /** Emitted when a reasoning text is completed. */
+        @JvmStatic
+        fun ofResponseReasoningTextDone(
+            responseReasoningTextDone: BetaResponseReasoningTextDoneEvent
+        ) = BetaResponsesServerEvent(responseReasoningTextDone = responseReasoningTextDone)
+
+        /** Emitted when there is a partial refusal text. */
+        @JvmStatic
+        fun ofResponseRefusalDelta(responseRefusalDelta: BetaResponseRefusalDeltaEvent) =
+            BetaResponsesServerEvent(responseRefusalDelta = responseRefusalDelta)
+
+        /** Emitted when refusal text is finalized. */
+        @JvmStatic
+        fun ofResponseRefusalDone(responseRefusalDone: BetaResponseRefusalDoneEvent) =
+            BetaResponsesServerEvent(responseRefusalDone = responseRefusalDone)
+
+        /** Emitted when there is an additional text delta. */
+        @JvmStatic
+        fun ofResponseOutputTextDelta(responseOutputTextDelta: BetaResponseTextDeltaEvent) =
+            BetaResponsesServerEvent(responseOutputTextDelta = responseOutputTextDelta)
+
+        /** Emitted when text content is finalized. */
+        @JvmStatic
+        fun ofResponseOutputTextDone(responseOutputTextDone: BetaResponseTextDoneEvent) =
+            BetaResponsesServerEvent(responseOutputTextDone = responseOutputTextDone)
+
+        /** Emitted when a web search call is completed. */
+        @JvmStatic
+        fun ofResponseWebSearchCallCompleted(
+            responseWebSearchCallCompleted: BetaResponseWebSearchCallCompletedEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseWebSearchCallCompleted = responseWebSearchCallCompleted
+            )
+
+        /** Emitted when a web search call is initiated. */
+        @JvmStatic
+        fun ofResponseWebSearchCallInProgress(
+            responseWebSearchCallInProgress: BetaResponseWebSearchCallInProgressEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseWebSearchCallInProgress = responseWebSearchCallInProgress
+            )
+
+        /** Emitted when a web search call is executing. */
+        @JvmStatic
+        fun ofResponseWebSearchCallSearching(
+            responseWebSearchCallSearching: BetaResponseWebSearchCallSearchingEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseWebSearchCallSearching = responseWebSearchCallSearching
+            )
+
+        /**
+         * Emitted when an image generation tool call has completed and the final image is
+         * available.
+         */
+        @JvmStatic
+        fun ofResponseImageGenerationCallCompleted(
+            responseImageGenerationCallCompleted: BetaResponseImageGenCallCompletedEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseImageGenerationCallCompleted = responseImageGenerationCallCompleted
+            )
+
+        /**
+         * Emitted when an image generation tool call is actively generating an image (intermediate
+         * state).
+         */
+        @JvmStatic
+        fun ofResponseImageGenerationCallGenerating(
+            responseImageGenerationCallGenerating: BetaResponseImageGenCallGeneratingEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseImageGenerationCallGenerating = responseImageGenerationCallGenerating
+            )
+
+        /** Emitted when an image generation tool call is in progress. */
+        @JvmStatic
+        fun ofResponseImageGenerationCallInProgress(
+            responseImageGenerationCallInProgress: BetaResponseImageGenCallInProgressEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseImageGenerationCallInProgress = responseImageGenerationCallInProgress
+            )
+
+        /** Emitted when a partial image is available during image generation streaming. */
+        @JvmStatic
+        fun ofResponseImageGenerationCallPartialImage(
+            responseImageGenerationCallPartialImage: BetaResponseImageGenCallPartialImageEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseImageGenerationCallPartialImage = responseImageGenerationCallPartialImage
+            )
+
+        /** Emitted when there is a delta (partial update) to the arguments of an MCP tool call. */
+        @JvmStatic
+        fun ofResponseMcpCallArgumentsDelta(
+            responseMcpCallArgumentsDelta: BetaResponseMcpCallArgumentsDeltaEvent
+        ) = BetaResponsesServerEvent(responseMcpCallArgumentsDelta = responseMcpCallArgumentsDelta)
+
+        /** Emitted when the arguments for an MCP tool call are finalized. */
+        @JvmStatic
+        fun ofResponseMcpCallArgumentsDone(
+            responseMcpCallArgumentsDone: BetaResponseMcpCallArgumentsDoneEvent
+        ) = BetaResponsesServerEvent(responseMcpCallArgumentsDone = responseMcpCallArgumentsDone)
+
+        /** Emitted when an MCP tool call has completed successfully. */
+        @JvmStatic
+        fun ofResponseMcpCallCompleted(
+            responseMcpCallCompleted: BetaResponseMcpCallCompletedEvent
+        ) = BetaResponsesServerEvent(responseMcpCallCompleted = responseMcpCallCompleted)
+
+        /** Emitted when an MCP tool call has failed. */
+        @JvmStatic
+        fun ofResponseMcpCallFailed(responseMcpCallFailed: BetaResponseMcpCallFailedEvent) =
+            BetaResponsesServerEvent(responseMcpCallFailed = responseMcpCallFailed)
+
+        /** Emitted when an MCP tool call is in progress. */
+        @JvmStatic
+        fun ofResponseMcpCallInProgress(
+            responseMcpCallInProgress: BetaResponseMcpCallInProgressEvent
+        ) = BetaResponsesServerEvent(responseMcpCallInProgress = responseMcpCallInProgress)
+
+        /** Emitted when the list of available MCP tools has been successfully retrieved. */
+        @JvmStatic
+        fun ofResponseMcpListToolsCompleted(
+            responseMcpListToolsCompleted: BetaResponseMcpListToolsCompletedEvent
+        ) = BetaResponsesServerEvent(responseMcpListToolsCompleted = responseMcpListToolsCompleted)
+
+        /** Emitted when the attempt to list available MCP tools has failed. */
+        @JvmStatic
+        fun ofResponseMcpListToolsFailed(
+            responseMcpListToolsFailed: BetaResponseMcpListToolsFailedEvent
+        ) = BetaResponsesServerEvent(responseMcpListToolsFailed = responseMcpListToolsFailed)
+
+        /**
+         * Emitted when the system is in the process of retrieving the list of available MCP tools.
+         */
+        @JvmStatic
+        fun ofResponseMcpListToolsInProgress(
+            responseMcpListToolsInProgress: BetaResponseMcpListToolsInProgressEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseMcpListToolsInProgress = responseMcpListToolsInProgress
+            )
+
+        /** Emitted when an annotation is added to output text content. */
+        @JvmStatic
+        fun ofResponseOutputTextAnnotationAdded(
+            responseOutputTextAnnotationAdded: BetaResponseOutputTextAnnotationAddedEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseOutputTextAnnotationAdded = responseOutputTextAnnotationAdded
+            )
+
+        /** Emitted when a response is queued and waiting to be processed. */
+        @JvmStatic
+        fun ofResponseQueued(responseQueued: BetaResponseQueuedEvent) =
+            BetaResponsesServerEvent(responseQueued = responseQueued)
+
+        /** Event representing a delta (partial update) to the input of a custom tool call. */
+        @JvmStatic
+        fun ofResponseCustomToolCallInputDelta(
+            responseCustomToolCallInputDelta: BetaResponseCustomToolCallInputDeltaEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseCustomToolCallInputDelta = responseCustomToolCallInputDelta
+            )
+
+        /** Event indicating that input for a custom tool call is complete. */
+        @JvmStatic
+        fun ofResponseCustomToolCallInputDone(
+            responseCustomToolCallInputDone: BetaResponseCustomToolCallInputDoneEvent
+        ) =
+            BetaResponsesServerEvent(
+                responseCustomToolCallInputDone = responseCustomToolCallInputDone
+            )
+
+        /**
+         * Emitted when all injected input items were validated and committed to the active
+         * response.
+         */
+        @JvmStatic
+        fun ofResponseInjectCreated(responseInjectCreated: BetaResponseInjectCreatedEvent) =
+            BetaResponsesServerEvent(responseInjectCreated = responseInjectCreated)
+
+        /**
+         * Emitted when injected input could not be committed to a response. The event returns the
+         * uncommitted raw input so the client can retry it in another response when appropriate.
+         */
+        @JvmStatic
+        fun ofResponseInjectFailed(responseInjectFailed: BetaResponseInjectFailedEvent) =
+            BetaResponsesServerEvent(responseInjectFailed = responseInjectFailed)
+    }
+
+    /**
+     * An interface that defines how to map each variant of [BetaResponsesServerEvent] to a value of
+     * type [T].
+     */
+    interface Visitor<out T> {
+
+        /** Emitted when there is a partial audio response. */
+        fun visitResponseAudioDelta(responseAudioDelta: BetaResponseAudioDeltaEvent): T
+
+        /** Emitted when the audio response is complete. */
+        fun visitResponseAudioDone(responseAudioDone: BetaResponseAudioDoneEvent): T
+
+        /** Emitted when there is a partial transcript of audio. */
+        fun visitResponseAudioTranscriptDelta(
+            responseAudioTranscriptDelta: BetaResponseAudioTranscriptDeltaEvent
+        ): T
+
+        /** Emitted when the full audio transcript is completed. */
+        fun visitResponseAudioTranscriptDone(
+            responseAudioTranscriptDone: BetaResponseAudioTranscriptDoneEvent
+        ): T
+
+        /** Emitted when a partial code snippet is streamed by the code interpreter. */
+        fun visitResponseCodeInterpreterCallCodeDelta(
+            responseCodeInterpreterCallCodeDelta: BetaResponseCodeInterpreterCallCodeDeltaEvent
+        ): T
+
+        /** Emitted when the code snippet is finalized by the code interpreter. */
+        fun visitResponseCodeInterpreterCallCodeDone(
+            responseCodeInterpreterCallCodeDone: BetaResponseCodeInterpreterCallCodeDoneEvent
+        ): T
+
+        /** Emitted when the code interpreter call is completed. */
+        fun visitResponseCodeInterpreterCallCompleted(
+            responseCodeInterpreterCallCompleted: BetaResponseCodeInterpreterCallCompletedEvent
+        ): T
+
+        /** Emitted when a code interpreter call is in progress. */
+        fun visitResponseCodeInterpreterCallInProgress(
+            responseCodeInterpreterCallInProgress: BetaResponseCodeInterpreterCallInProgressEvent
+        ): T
+
+        /** Emitted when the code interpreter is actively interpreting the code snippet. */
+        fun visitResponseCodeInterpreterCallInterpreting(
+            responseCodeInterpreterCallInterpreting:
+                BetaResponseCodeInterpreterCallInterpretingEvent
+        ): T
+
+        /** Emitted when the model response is complete. */
+        fun visitResponseCompleted(responseCompleted: BetaResponseCompletedEvent): T
+
+        /** Emitted when a new content part is added. */
+        fun visitResponseContentPartAdded(
+            responseContentPartAdded: BetaResponseContentPartAddedEvent
+        ): T
+
+        /** Emitted when a content part is done. */
+        fun visitResponseContentPartDone(
+            responseContentPartDone: BetaResponseContentPartDoneEvent
+        ): T
+
+        /** An event that is emitted when a response is created. */
+        fun visitResponseCreated(responseCreated: BetaResponseCreatedEvent): T
+
+        /** Emitted when an error occurs. */
+        fun visitError(error: BetaResponseErrorEvent): T
+
+        /** Emitted when a file search call is completed (results found). */
+        fun visitResponseFileSearchCallCompleted(
+            responseFileSearchCallCompleted: BetaResponseFileSearchCallCompletedEvent
+        ): T
+
+        /** Emitted when a file search call is initiated. */
+        fun visitResponseFileSearchCallInProgress(
+            responseFileSearchCallInProgress: BetaResponseFileSearchCallInProgressEvent
+        ): T
+
+        /** Emitted when a file search is currently searching. */
+        fun visitResponseFileSearchCallSearching(
+            responseFileSearchCallSearching: BetaResponseFileSearchCallSearchingEvent
+        ): T
+
+        /** Emitted when there is a partial function-call arguments delta. */
+        fun visitResponseFunctionCallArgumentsDelta(
+            responseFunctionCallArgumentsDelta: BetaResponseFunctionCallArgumentsDeltaEvent
+        ): T
+
+        /** Emitted when function-call arguments are finalized. */
+        fun visitResponseFunctionCallArgumentsDone(
+            responseFunctionCallArgumentsDone: BetaResponseFunctionCallArgumentsDoneEvent
+        ): T
+
+        /** Emitted when the response is in progress. */
+        fun visitResponseInProgress(responseInProgress: BetaResponseInProgressEvent): T
+
+        /** An event that is emitted when a response fails. */
+        fun visitResponseFailed(responseFailed: BetaResponseFailedEvent): T
+
+        /** An event that is emitted when a response finishes as incomplete. */
+        fun visitResponseIncomplete(responseIncomplete: BetaResponseIncompleteEvent): T
+
+        /** Emitted when a new output item is added. */
+        fun visitResponseOutputItemAdded(
+            responseOutputItemAdded: BetaResponseOutputItemAddedEvent
+        ): T
+
+        /** Emitted when an output item is marked done. */
+        fun visitResponseOutputItemDone(responseOutputItemDone: BetaResponseOutputItemDoneEvent): T
+
+        /** Emitted when a new reasoning summary part is added. */
+        fun visitResponseReasoningSummaryPartAdded(
+            responseReasoningSummaryPartAdded: BetaResponseReasoningSummaryPartAddedEvent
+        ): T
+
+        /** Emitted when a reasoning summary part is completed. */
+        fun visitResponseReasoningSummaryPartDone(
+            responseReasoningSummaryPartDone: BetaResponseReasoningSummaryPartDoneEvent
+        ): T
+
+        /** Emitted when a delta is added to a reasoning summary text. */
+        fun visitResponseReasoningSummaryTextDelta(
+            responseReasoningSummaryTextDelta: BetaResponseReasoningSummaryTextDeltaEvent
+        ): T
+
+        /** Emitted when a reasoning summary text is completed. */
+        fun visitResponseReasoningSummaryTextDone(
+            responseReasoningSummaryTextDone: BetaResponseReasoningSummaryTextDoneEvent
+        ): T
+
+        /** Emitted when a delta is added to a reasoning text. */
+        fun visitResponseReasoningTextDelta(
+            responseReasoningTextDelta: BetaResponseReasoningTextDeltaEvent
+        ): T
+
+        /** Emitted when a reasoning text is completed. */
+        fun visitResponseReasoningTextDone(
+            responseReasoningTextDone: BetaResponseReasoningTextDoneEvent
+        ): T
+
+        /** Emitted when there is a partial refusal text. */
+        fun visitResponseRefusalDelta(responseRefusalDelta: BetaResponseRefusalDeltaEvent): T
+
+        /** Emitted when refusal text is finalized. */
+        fun visitResponseRefusalDone(responseRefusalDone: BetaResponseRefusalDoneEvent): T
+
+        /** Emitted when there is an additional text delta. */
+        fun visitResponseOutputTextDelta(responseOutputTextDelta: BetaResponseTextDeltaEvent): T
+
+        /** Emitted when text content is finalized. */
+        fun visitResponseOutputTextDone(responseOutputTextDone: BetaResponseTextDoneEvent): T
+
+        /** Emitted when a web search call is completed. */
+        fun visitResponseWebSearchCallCompleted(
+            responseWebSearchCallCompleted: BetaResponseWebSearchCallCompletedEvent
+        ): T
+
+        /** Emitted when a web search call is initiated. */
+        fun visitResponseWebSearchCallInProgress(
+            responseWebSearchCallInProgress: BetaResponseWebSearchCallInProgressEvent
+        ): T
+
+        /** Emitted when a web search call is executing. */
+        fun visitResponseWebSearchCallSearching(
+            responseWebSearchCallSearching: BetaResponseWebSearchCallSearchingEvent
+        ): T
+
+        /**
+         * Emitted when an image generation tool call has completed and the final image is
+         * available.
+         */
+        fun visitResponseImageGenerationCallCompleted(
+            responseImageGenerationCallCompleted: BetaResponseImageGenCallCompletedEvent
+        ): T
+
+        /**
+         * Emitted when an image generation tool call is actively generating an image (intermediate
+         * state).
+         */
+        fun visitResponseImageGenerationCallGenerating(
+            responseImageGenerationCallGenerating: BetaResponseImageGenCallGeneratingEvent
+        ): T
+
+        /** Emitted when an image generation tool call is in progress. */
+        fun visitResponseImageGenerationCallInProgress(
+            responseImageGenerationCallInProgress: BetaResponseImageGenCallInProgressEvent
+        ): T
+
+        /** Emitted when a partial image is available during image generation streaming. */
+        fun visitResponseImageGenerationCallPartialImage(
+            responseImageGenerationCallPartialImage: BetaResponseImageGenCallPartialImageEvent
+        ): T
+
+        /** Emitted when there is a delta (partial update) to the arguments of an MCP tool call. */
+        fun visitResponseMcpCallArgumentsDelta(
+            responseMcpCallArgumentsDelta: BetaResponseMcpCallArgumentsDeltaEvent
+        ): T
+
+        /** Emitted when the arguments for an MCP tool call are finalized. */
+        fun visitResponseMcpCallArgumentsDone(
+            responseMcpCallArgumentsDone: BetaResponseMcpCallArgumentsDoneEvent
+        ): T
+
+        /** Emitted when an MCP tool call has completed successfully. */
+        fun visitResponseMcpCallCompleted(
+            responseMcpCallCompleted: BetaResponseMcpCallCompletedEvent
+        ): T
+
+        /** Emitted when an MCP tool call has failed. */
+        fun visitResponseMcpCallFailed(responseMcpCallFailed: BetaResponseMcpCallFailedEvent): T
+
+        /** Emitted when an MCP tool call is in progress. */
+        fun visitResponseMcpCallInProgress(
+            responseMcpCallInProgress: BetaResponseMcpCallInProgressEvent
+        ): T
+
+        /** Emitted when the list of available MCP tools has been successfully retrieved. */
+        fun visitResponseMcpListToolsCompleted(
+            responseMcpListToolsCompleted: BetaResponseMcpListToolsCompletedEvent
+        ): T
+
+        /** Emitted when the attempt to list available MCP tools has failed. */
+        fun visitResponseMcpListToolsFailed(
+            responseMcpListToolsFailed: BetaResponseMcpListToolsFailedEvent
+        ): T
+
+        /**
+         * Emitted when the system is in the process of retrieving the list of available MCP tools.
+         */
+        fun visitResponseMcpListToolsInProgress(
+            responseMcpListToolsInProgress: BetaResponseMcpListToolsInProgressEvent
+        ): T
+
+        /** Emitted when an annotation is added to output text content. */
+        fun visitResponseOutputTextAnnotationAdded(
+            responseOutputTextAnnotationAdded: BetaResponseOutputTextAnnotationAddedEvent
+        ): T
+
+        /** Emitted when a response is queued and waiting to be processed. */
+        fun visitResponseQueued(responseQueued: BetaResponseQueuedEvent): T
+
+        /** Event representing a delta (partial update) to the input of a custom tool call. */
+        fun visitResponseCustomToolCallInputDelta(
+            responseCustomToolCallInputDelta: BetaResponseCustomToolCallInputDeltaEvent
+        ): T
+
+        /** Event indicating that input for a custom tool call is complete. */
+        fun visitResponseCustomToolCallInputDone(
+            responseCustomToolCallInputDone: BetaResponseCustomToolCallInputDoneEvent
+        ): T
+
+        /**
+         * Emitted when all injected input items were validated and committed to the active
+         * response.
+         */
+        fun visitResponseInjectCreated(responseInjectCreated: BetaResponseInjectCreatedEvent): T
+
+        /**
+         * Emitted when injected input could not be committed to a response. The event returns the
+         * uncommitted raw input so the client can retry it in another response when appropriate.
+         */
+        fun visitResponseInjectFailed(responseInjectFailed: BetaResponseInjectFailedEvent): T
+
+        /**
+         * Maps an unknown variant of [BetaResponsesServerEvent] to a value of type [T].
+         *
+         * An instance of [BetaResponsesServerEvent] can contain an unknown variant if it was
+         * deserialized from data that doesn't match any known variant. For example, if the SDK is
+         * on an older version than the API, then the API may respond with new variants that the SDK
+         * is unaware of.
+         *
+         * @throws OpenAIInvalidDataException in the default implementation.
+         */
+        fun unknown(json: JsonValue?): T {
+            throw OpenAIInvalidDataException("Unknown BetaResponsesServerEvent: $json")
+        }
+    }
+
+    internal class Deserializer :
+        BaseDeserializer<BetaResponsesServerEvent>(BetaResponsesServerEvent::class) {
+
+        override fun ObjectCodec.deserialize(node: JsonNode): BetaResponsesServerEvent {
+            val json = JsonValue.fromJsonNode(node)
+            val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+            when (type) {
+                "response.audio.delta" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseAudioDeltaEvent>())
+                        ?.let { BetaResponsesServerEvent(responseAudioDelta = it, _json = json) }
+                        ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.audio.done" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseAudioDoneEvent>())?.let {
+                        BetaResponsesServerEvent(responseAudioDone = it, _json = json)
+                    } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.audio.transcript.delta" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseAudioTranscriptDeltaEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseAudioTranscriptDelta = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.audio.transcript.done" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseAudioTranscriptDoneEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(responseAudioTranscriptDone = it, _json = json)
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.code_interpreter_call_code.delta" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCodeInterpreterCallCodeDeltaEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseCodeInterpreterCallCodeDelta = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.code_interpreter_call_code.done" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCodeInterpreterCallCodeDoneEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseCodeInterpreterCallCodeDone = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.code_interpreter_call.completed" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCodeInterpreterCallCompletedEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseCodeInterpreterCallCompleted = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.code_interpreter_call.in_progress" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCodeInterpreterCallInProgressEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseCodeInterpreterCallInProgress = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.code_interpreter_call.interpreting" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCodeInterpreterCallInterpretingEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseCodeInterpreterCallInterpreting = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.completed" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseCompletedEvent>())?.let {
+                        BetaResponsesServerEvent(responseCompleted = it, _json = json)
+                    } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.content_part.added" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseContentPartAddedEvent>())
+                        ?.let {
+                            BetaResponsesServerEvent(responseContentPartAdded = it, _json = json)
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.content_part.done" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseContentPartDoneEvent>())
+                        ?.let {
+                            BetaResponsesServerEvent(responseContentPartDone = it, _json = json)
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.created" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseCreatedEvent>())?.let {
+                        BetaResponsesServerEvent(responseCreated = it, _json = json)
+                    } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "error" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseErrorEvent>())?.let {
+                        BetaResponsesServerEvent(error = it, _json = json)
+                    } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.file_search_call.completed" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseFileSearchCallCompletedEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseFileSearchCallCompleted = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.file_search_call.in_progress" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseFileSearchCallInProgressEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseFileSearchCallInProgress = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.file_search_call.searching" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseFileSearchCallSearchingEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseFileSearchCallSearching = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.function_call_arguments.delta" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseFunctionCallArgumentsDeltaEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseFunctionCallArgumentsDelta = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.function_call_arguments.done" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseFunctionCallArgumentsDoneEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseFunctionCallArgumentsDone = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.in_progress" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseInProgressEvent>())
+                        ?.let { BetaResponsesServerEvent(responseInProgress = it, _json = json) }
+                        ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.failed" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseFailedEvent>())?.let {
+                        BetaResponsesServerEvent(responseFailed = it, _json = json)
+                    } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.incomplete" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseIncompleteEvent>())
+                        ?.let { BetaResponsesServerEvent(responseIncomplete = it, _json = json) }
+                        ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.output_item.added" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseOutputItemAddedEvent>())
+                        ?.let {
+                            BetaResponsesServerEvent(responseOutputItemAdded = it, _json = json)
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.output_item.done" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseOutputItemDoneEvent>())
+                        ?.let {
+                            BetaResponsesServerEvent(responseOutputItemDone = it, _json = json)
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.reasoning_summary_part.added" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseReasoningSummaryPartAddedEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseReasoningSummaryPartAdded = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.reasoning_summary_part.done" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseReasoningSummaryPartDoneEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseReasoningSummaryPartDone = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.reasoning_summary_text.delta" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseReasoningSummaryTextDeltaEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseReasoningSummaryTextDelta = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.reasoning_summary_text.done" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseReasoningSummaryTextDoneEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseReasoningSummaryTextDone = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.reasoning_text.delta" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseReasoningTextDeltaEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(responseReasoningTextDelta = it, _json = json)
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.reasoning_text.done" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseReasoningTextDoneEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(responseReasoningTextDone = it, _json = json)
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.refusal.delta" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseRefusalDeltaEvent>())
+                        ?.let { BetaResponsesServerEvent(responseRefusalDelta = it, _json = json) }
+                        ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.refusal.done" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseRefusalDoneEvent>())
+                        ?.let { BetaResponsesServerEvent(responseRefusalDone = it, _json = json) }
+                        ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.output_text.delta" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseTextDeltaEvent>())?.let {
+                        BetaResponsesServerEvent(responseOutputTextDelta = it, _json = json)
+                    } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.output_text.done" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseTextDoneEvent>())?.let {
+                        BetaResponsesServerEvent(responseOutputTextDone = it, _json = json)
+                    } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.web_search_call.completed" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseWebSearchCallCompletedEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseWebSearchCallCompleted = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.web_search_call.in_progress" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseWebSearchCallInProgressEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseWebSearchCallInProgress = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.web_search_call.searching" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseWebSearchCallSearchingEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseWebSearchCallSearching = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.image_generation_call.completed" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseImageGenCallCompletedEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseImageGenerationCallCompleted = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.image_generation_call.generating" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseImageGenCallGeneratingEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseImageGenerationCallGenerating = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.image_generation_call.in_progress" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseImageGenCallInProgressEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseImageGenerationCallInProgress = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.image_generation_call.partial_image" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseImageGenCallPartialImageEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseImageGenerationCallPartialImage = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.mcp_call_arguments.delta" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseMcpCallArgumentsDeltaEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseMcpCallArgumentsDelta = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.mcp_call_arguments.done" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseMcpCallArgumentsDoneEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseMcpCallArgumentsDone = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.mcp_call.completed" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseMcpCallCompletedEvent>())
+                        ?.let {
+                            BetaResponsesServerEvent(responseMcpCallCompleted = it, _json = json)
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.mcp_call.failed" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseMcpCallFailedEvent>())
+                        ?.let { BetaResponsesServerEvent(responseMcpCallFailed = it, _json = json) }
+                        ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.mcp_call.in_progress" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseMcpCallInProgressEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(responseMcpCallInProgress = it, _json = json)
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.mcp_list_tools.completed" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseMcpListToolsCompletedEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseMcpListToolsCompleted = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.mcp_list_tools.failed" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseMcpListToolsFailedEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(responseMcpListToolsFailed = it, _json = json)
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.mcp_list_tools.in_progress" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseMcpListToolsInProgressEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseMcpListToolsInProgress = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.output_text.annotation.added" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseOutputTextAnnotationAddedEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseOutputTextAnnotationAdded = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.queued" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseQueuedEvent>())?.let {
+                        BetaResponsesServerEvent(responseQueued = it, _json = json)
+                    } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.custom_tool_call_input.delta" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCustomToolCallInputDeltaEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseCustomToolCallInputDelta = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.custom_tool_call_input.done" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<BetaResponseCustomToolCallInputDoneEvent>(),
+                        )
+                        ?.let {
+                            BetaResponsesServerEvent(
+                                responseCustomToolCallInputDone = it,
+                                _json = json,
+                            )
+                        } ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.inject.created" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseInjectCreatedEvent>())
+                        ?.let { BetaResponsesServerEvent(responseInjectCreated = it, _json = json) }
+                        ?: BetaResponsesServerEvent(_json = json)
+                }
+                "response.inject.failed" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaResponseInjectFailedEvent>())
+                        ?.let { BetaResponsesServerEvent(responseInjectFailed = it, _json = json) }
+                        ?: BetaResponsesServerEvent(_json = json)
+                }
+            }
+
+            return BetaResponsesServerEvent(_json = json)
+        }
+    }
+
+    internal class Serializer :
+        BaseSerializer<BetaResponsesServerEvent>(BetaResponsesServerEvent::class) {
+
+        override fun serialize(
+            value: BetaResponsesServerEvent,
+            generator: JsonGenerator,
+            provider: SerializerProvider,
+        ) {
+            when {
+                value.responseAudioDelta != null -> generator.writeObject(value.responseAudioDelta)
+                value.responseAudioDone != null -> generator.writeObject(value.responseAudioDone)
+                value.responseAudioTranscriptDelta != null ->
+                    generator.writeObject(value.responseAudioTranscriptDelta)
+                value.responseAudioTranscriptDone != null ->
+                    generator.writeObject(value.responseAudioTranscriptDone)
+                value.responseCodeInterpreterCallCodeDelta != null ->
+                    generator.writeObject(value.responseCodeInterpreterCallCodeDelta)
+                value.responseCodeInterpreterCallCodeDone != null ->
+                    generator.writeObject(value.responseCodeInterpreterCallCodeDone)
+                value.responseCodeInterpreterCallCompleted != null ->
+                    generator.writeObject(value.responseCodeInterpreterCallCompleted)
+                value.responseCodeInterpreterCallInProgress != null ->
+                    generator.writeObject(value.responseCodeInterpreterCallInProgress)
+                value.responseCodeInterpreterCallInterpreting != null ->
+                    generator.writeObject(value.responseCodeInterpreterCallInterpreting)
+                value.responseCompleted != null -> generator.writeObject(value.responseCompleted)
+                value.responseContentPartAdded != null ->
+                    generator.writeObject(value.responseContentPartAdded)
+                value.responseContentPartDone != null ->
+                    generator.writeObject(value.responseContentPartDone)
+                value.responseCreated != null -> generator.writeObject(value.responseCreated)
+                value.error != null -> generator.writeObject(value.error)
+                value.responseFileSearchCallCompleted != null ->
+                    generator.writeObject(value.responseFileSearchCallCompleted)
+                value.responseFileSearchCallInProgress != null ->
+                    generator.writeObject(value.responseFileSearchCallInProgress)
+                value.responseFileSearchCallSearching != null ->
+                    generator.writeObject(value.responseFileSearchCallSearching)
+                value.responseFunctionCallArgumentsDelta != null ->
+                    generator.writeObject(value.responseFunctionCallArgumentsDelta)
+                value.responseFunctionCallArgumentsDone != null ->
+                    generator.writeObject(value.responseFunctionCallArgumentsDone)
+                value.responseInProgress != null -> generator.writeObject(value.responseInProgress)
+                value.responseFailed != null -> generator.writeObject(value.responseFailed)
+                value.responseIncomplete != null -> generator.writeObject(value.responseIncomplete)
+                value.responseOutputItemAdded != null ->
+                    generator.writeObject(value.responseOutputItemAdded)
+                value.responseOutputItemDone != null ->
+                    generator.writeObject(value.responseOutputItemDone)
+                value.responseReasoningSummaryPartAdded != null ->
+                    generator.writeObject(value.responseReasoningSummaryPartAdded)
+                value.responseReasoningSummaryPartDone != null ->
+                    generator.writeObject(value.responseReasoningSummaryPartDone)
+                value.responseReasoningSummaryTextDelta != null ->
+                    generator.writeObject(value.responseReasoningSummaryTextDelta)
+                value.responseReasoningSummaryTextDone != null ->
+                    generator.writeObject(value.responseReasoningSummaryTextDone)
+                value.responseReasoningTextDelta != null ->
+                    generator.writeObject(value.responseReasoningTextDelta)
+                value.responseReasoningTextDone != null ->
+                    generator.writeObject(value.responseReasoningTextDone)
+                value.responseRefusalDelta != null ->
+                    generator.writeObject(value.responseRefusalDelta)
+                value.responseRefusalDone != null ->
+                    generator.writeObject(value.responseRefusalDone)
+                value.responseOutputTextDelta != null ->
+                    generator.writeObject(value.responseOutputTextDelta)
+                value.responseOutputTextDone != null ->
+                    generator.writeObject(value.responseOutputTextDone)
+                value.responseWebSearchCallCompleted != null ->
+                    generator.writeObject(value.responseWebSearchCallCompleted)
+                value.responseWebSearchCallInProgress != null ->
+                    generator.writeObject(value.responseWebSearchCallInProgress)
+                value.responseWebSearchCallSearching != null ->
+                    generator.writeObject(value.responseWebSearchCallSearching)
+                value.responseImageGenerationCallCompleted != null ->
+                    generator.writeObject(value.responseImageGenerationCallCompleted)
+                value.responseImageGenerationCallGenerating != null ->
+                    generator.writeObject(value.responseImageGenerationCallGenerating)
+                value.responseImageGenerationCallInProgress != null ->
+                    generator.writeObject(value.responseImageGenerationCallInProgress)
+                value.responseImageGenerationCallPartialImage != null ->
+                    generator.writeObject(value.responseImageGenerationCallPartialImage)
+                value.responseMcpCallArgumentsDelta != null ->
+                    generator.writeObject(value.responseMcpCallArgumentsDelta)
+                value.responseMcpCallArgumentsDone != null ->
+                    generator.writeObject(value.responseMcpCallArgumentsDone)
+                value.responseMcpCallCompleted != null ->
+                    generator.writeObject(value.responseMcpCallCompleted)
+                value.responseMcpCallFailed != null ->
+                    generator.writeObject(value.responseMcpCallFailed)
+                value.responseMcpCallInProgress != null ->
+                    generator.writeObject(value.responseMcpCallInProgress)
+                value.responseMcpListToolsCompleted != null ->
+                    generator.writeObject(value.responseMcpListToolsCompleted)
+                value.responseMcpListToolsFailed != null ->
+                    generator.writeObject(value.responseMcpListToolsFailed)
+                value.responseMcpListToolsInProgress != null ->
+                    generator.writeObject(value.responseMcpListToolsInProgress)
+                value.responseOutputTextAnnotationAdded != null ->
+                    generator.writeObject(value.responseOutputTextAnnotationAdded)
+                value.responseQueued != null -> generator.writeObject(value.responseQueued)
+                value.responseCustomToolCallInputDelta != null ->
+                    generator.writeObject(value.responseCustomToolCallInputDelta)
+                value.responseCustomToolCallInputDone != null ->
+                    generator.writeObject(value.responseCustomToolCallInputDone)
+                value.responseInjectCreated != null ->
+                    generator.writeObject(value.responseInjectCreated)
+                value.responseInjectFailed != null ->
+                    generator.writeObject(value.responseInjectFailed)
+                value._json != null -> generator.writeObject(value._json)
+                else -> throw IllegalStateException("Invalid BetaResponsesServerEvent")
+            }
+        }
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaSkillReference.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaSkillReference.kt
new file mode 100644
index 000000000..e17e7cea5
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaSkillReference.kt
@@ -0,0 +1,257 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+
+class BetaSkillReference
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val skillId: JsonField<String>,
+    private val type: JsonValue,
+    private val version: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("skill_id") @ExcludeMissing skillId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("version") @ExcludeMissing version: JsonField<String> = JsonMissing.of(),
+    ) : this(skillId, type, version, mutableMapOf())
+
+    /**
+     * The ID of the referenced skill.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun skillId(): String = skillId.getRequired("skill_id")
+
+    /**
+     * References a skill created with the /v1/skills endpoint.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("skill_reference")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Optional skill version. Use a positive integer or 'latest'. Omit for default.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun version(): Optional<String> = version.getOptional("version")
+
+    /**
+     * Returns the raw JSON value of [skillId].
+     *
+     * Unlike [skillId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("skill_id") @ExcludeMissing fun _skillId(): JsonField<String> = skillId
+
+    /**
+     * Returns the raw JSON value of [version].
+     *
+     * Unlike [version], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("version") @ExcludeMissing fun _version(): JsonField<String> = version
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaSkillReference].
+         *
+         * The following fields are required:
+         * ```java
+         * .skillId()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaSkillReference]. */
+    class Builder internal constructor() {
+
+        private var skillId: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("skill_reference")
+        private var version: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaSkillReference: BetaSkillReference) = apply {
+            skillId = betaSkillReference.skillId
+            type = betaSkillReference.type
+            version = betaSkillReference.version
+            additionalProperties = betaSkillReference.additionalProperties.toMutableMap()
+        }
+
+        /** The ID of the referenced skill. */
+        fun skillId(skillId: String) = skillId(JsonField.of(skillId))
+
+        /**
+         * Sets [Builder.skillId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.skillId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun skillId(skillId: JsonField<String>) = apply { this.skillId = skillId }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("skill_reference")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** Optional skill version. Use a positive integer or 'latest'. Omit for default. */
+        fun version(version: String) = version(JsonField.of(version))
+
+        /**
+         * Sets [Builder.version] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.version] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun version(version: JsonField<String>) = apply { this.version = version }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaSkillReference].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .skillId()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaSkillReference =
+            BetaSkillReference(
+                checkRequired("skillId", skillId),
+                type,
+                version,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaSkillReference = apply {
+        if (validated) {
+            return@apply
+        }
+
+        skillId()
+        _type().let {
+            if (it != JsonValue.from("skill_reference")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        version()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (skillId.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("skill_reference")) 1 else 0 } +
+            (if (version.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaSkillReference &&
+            skillId == other.skillId &&
+            type == other.type &&
+            version == other.version &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(skillId, type, version, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaSkillReference{skillId=$skillId, type=$type, version=$version, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaTool.kt
new file mode 100644
index 000000000..58a28573f
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaTool.kt
@@ -0,0 +1,7168 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.allMaxBy
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** A tool that can be used to generate a response. */
+@JsonDeserialize(using = BetaTool.Deserializer::class)
+@JsonSerialize(using = BetaTool.Serializer::class)
+class BetaTool
+private constructor(
+    private val function: BetaFunctionTool? = null,
+    private val fileSearch: BetaFileSearchTool? = null,
+    private val computer: BetaComputerTool? = null,
+    private val computerUsePreview: BetaComputerUsePreviewTool? = null,
+    private val webSearch: BetaWebSearchTool? = null,
+    private val mcp: Mcp? = null,
+    private val codeInterpreter: CodeInterpreter? = null,
+    private val programmaticToolCalling: JsonValue? = null,
+    private val imageGeneration: ImageGeneration? = null,
+    private val localShell: JsonValue? = null,
+    private val shell: BetaFunctionShellTool? = null,
+    private val custom: BetaCustomTool? = null,
+    private val namespace: BetaNamespaceTool? = null,
+    private val toolSearch: BetaToolSearchTool? = null,
+    private val webSearchPreview: BetaWebSearchPreviewTool? = null,
+    private val applyPatch: BetaApplyPatchTool? = null,
+    private val _json: JsonValue? = null,
+) {
+
+    /**
+     * Defines a function in your own code the model can choose to call. Learn more about
+     * [function calling](https://platform.openai.com/docs/guides/function-calling).
+     */
+    fun function(): Optional<BetaFunctionTool> = Optional.ofNullable(function)
+
+    /**
+     * A tool that searches for relevant content from uploaded files. Learn more about the
+     * [file search tool](https://platform.openai.com/docs/guides/tools-file-search).
+     */
+    fun fileSearch(): Optional<BetaFileSearchTool> = Optional.ofNullable(fileSearch)
+
+    /**
+     * A tool that controls a virtual computer. Learn more about the
+     * [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+     */
+    fun computer(): Optional<BetaComputerTool> = Optional.ofNullable(computer)
+
+    /**
+     * A tool that controls a virtual computer. Learn more about the
+     * [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+     */
+    fun computerUsePreview(): Optional<BetaComputerUsePreviewTool> =
+        Optional.ofNullable(computerUsePreview)
+
+    /**
+     * Search the Internet for sources related to the prompt. Learn more about the
+     * [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+     */
+    fun webSearch(): Optional<BetaWebSearchTool> = Optional.ofNullable(webSearch)
+
+    /**
+     * Give the model access to additional tools via remote Model Context Protocol (MCP) servers.
+     * [Learn more about MCP](https://platform.openai.com/docs/guides/tools-remote-mcp).
+     */
+    fun mcp(): Optional<Mcp> = Optional.ofNullable(mcp)
+
+    /** A tool that runs Python code to help generate a response to a prompt. */
+    fun codeInterpreter(): Optional<CodeInterpreter> = Optional.ofNullable(codeInterpreter)
+
+    fun programmaticToolCalling(): Optional<JsonValue> =
+        Optional.ofNullable(programmaticToolCalling)
+
+    /** A tool that generates images using the GPT image models. */
+    fun imageGeneration(): Optional<ImageGeneration> = Optional.ofNullable(imageGeneration)
+
+    /** A tool that allows the model to execute shell commands in a local environment. */
+    fun localShell(): Optional<JsonValue> = Optional.ofNullable(localShell)
+
+    /** A tool that allows the model to execute shell commands. */
+    fun shell(): Optional<BetaFunctionShellTool> = Optional.ofNullable(shell)
+
+    /**
+     * A custom tool that processes input using a specified format. Learn more about
+     * [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
+     */
+    fun custom(): Optional<BetaCustomTool> = Optional.ofNullable(custom)
+
+    /** Groups function/custom tools under a shared namespace. */
+    fun namespace(): Optional<BetaNamespaceTool> = Optional.ofNullable(namespace)
+
+    /** Hosted or BYOT tool search configuration for deferred tools. */
+    fun toolSearch(): Optional<BetaToolSearchTool> = Optional.ofNullable(toolSearch)
+
+    /**
+     * This tool searches the web for relevant results to use in a response. Learn more about the
+     * [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+     */
+    fun webSearchPreview(): Optional<BetaWebSearchPreviewTool> =
+        Optional.ofNullable(webSearchPreview)
+
+    /** Allows the assistant to create, delete, or update files using unified diffs. */
+    fun applyPatch(): Optional<BetaApplyPatchTool> = Optional.ofNullable(applyPatch)
+
+    fun isFunction(): Boolean = function != null
+
+    fun isFileSearch(): Boolean = fileSearch != null
+
+    fun isComputer(): Boolean = computer != null
+
+    fun isComputerUsePreview(): Boolean = computerUsePreview != null
+
+    fun isWebSearch(): Boolean = webSearch != null
+
+    fun isMcp(): Boolean = mcp != null
+
+    fun isCodeInterpreter(): Boolean = codeInterpreter != null
+
+    fun isProgrammaticToolCalling(): Boolean = programmaticToolCalling != null
+
+    fun isImageGeneration(): Boolean = imageGeneration != null
+
+    fun isLocalShell(): Boolean = localShell != null
+
+    fun isShell(): Boolean = shell != null
+
+    fun isCustom(): Boolean = custom != null
+
+    fun isNamespace(): Boolean = namespace != null
+
+    fun isToolSearch(): Boolean = toolSearch != null
+
+    fun isWebSearchPreview(): Boolean = webSearchPreview != null
+
+    fun isApplyPatch(): Boolean = applyPatch != null
+
+    /**
+     * Defines a function in your own code the model can choose to call. Learn more about
+     * [function calling](https://platform.openai.com/docs/guides/function-calling).
+     */
+    fun asFunction(): BetaFunctionTool = function.getOrThrow("function")
+
+    /**
+     * A tool that searches for relevant content from uploaded files. Learn more about the
+     * [file search tool](https://platform.openai.com/docs/guides/tools-file-search).
+     */
+    fun asFileSearch(): BetaFileSearchTool = fileSearch.getOrThrow("fileSearch")
+
+    /**
+     * A tool that controls a virtual computer. Learn more about the
+     * [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+     */
+    fun asComputer(): BetaComputerTool = computer.getOrThrow("computer")
+
+    /**
+     * A tool that controls a virtual computer. Learn more about the
+     * [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+     */
+    fun asComputerUsePreview(): BetaComputerUsePreviewTool =
+        computerUsePreview.getOrThrow("computerUsePreview")
+
+    /**
+     * Search the Internet for sources related to the prompt. Learn more about the
+     * [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+     */
+    fun asWebSearch(): BetaWebSearchTool = webSearch.getOrThrow("webSearch")
+
+    /**
+     * Give the model access to additional tools via remote Model Context Protocol (MCP) servers.
+     * [Learn more about MCP](https://platform.openai.com/docs/guides/tools-remote-mcp).
+     */
+    fun asMcp(): Mcp = mcp.getOrThrow("mcp")
+
+    /** A tool that runs Python code to help generate a response to a prompt. */
+    fun asCodeInterpreter(): CodeInterpreter = codeInterpreter.getOrThrow("codeInterpreter")
+
+    fun asProgrammaticToolCalling(): JsonValue =
+        programmaticToolCalling.getOrThrow("programmaticToolCalling")
+
+    /** A tool that generates images using the GPT image models. */
+    fun asImageGeneration(): ImageGeneration = imageGeneration.getOrThrow("imageGeneration")
+
+    /** A tool that allows the model to execute shell commands in a local environment. */
+    fun asLocalShell(): JsonValue = localShell.getOrThrow("localShell")
+
+    /** A tool that allows the model to execute shell commands. */
+    fun asShell(): BetaFunctionShellTool = shell.getOrThrow("shell")
+
+    /**
+     * A custom tool that processes input using a specified format. Learn more about
+     * [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
+     */
+    fun asCustom(): BetaCustomTool = custom.getOrThrow("custom")
+
+    /** Groups function/custom tools under a shared namespace. */
+    fun asNamespace(): BetaNamespaceTool = namespace.getOrThrow("namespace")
+
+    /** Hosted or BYOT tool search configuration for deferred tools. */
+    fun asToolSearch(): BetaToolSearchTool = toolSearch.getOrThrow("toolSearch")
+
+    /**
+     * This tool searches the web for relevant results to use in a response. Learn more about the
+     * [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+     */
+    fun asWebSearchPreview(): BetaWebSearchPreviewTool =
+        webSearchPreview.getOrThrow("webSearchPreview")
+
+    /** Allows the assistant to create, delete, or update files using unified diffs. */
+    fun asApplyPatch(): BetaApplyPatchTool = applyPatch.getOrThrow("applyPatch")
+
+    fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+    /**
+     * Maps this instance's current variant to a value of type [T] using the given [visitor].
+     *
+     * Note that this method is _not_ forwards compatible with new variants from the API, unless
+     * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of the
+     * SDK gracefully, consider overriding [Visitor.unknown]:
+     * ```java
+     * import com.openai.core.JsonValue;
+     * import java.util.Optional;
+     *
+     * Optional<String> result = betaTool.accept(new BetaTool.Visitor<Optional<String>>() {
+     *     @Override
+     *     public Optional<String> visitFunction(BetaFunctionTool function) {
+     *         return Optional.of(function.toString());
+     *     }
+     *
+     *     // ...
+     *
+     *     @Override
+     *     public Optional<String> unknown(JsonValue json) {
+     *         // Or inspect the `json`.
+     *         return Optional.empty();
+     *     }
+     * });
+     * ```
+     *
+     * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor] and
+     *   the current variant is unknown.
+     */
+    fun <T> accept(visitor: Visitor<T>): T =
+        when {
+            function != null -> visitor.visitFunction(function)
+            fileSearch != null -> visitor.visitFileSearch(fileSearch)
+            computer != null -> visitor.visitComputer(computer)
+            computerUsePreview != null -> visitor.visitComputerUsePreview(computerUsePreview)
+            webSearch != null -> visitor.visitWebSearch(webSearch)
+            mcp != null -> visitor.visitMcp(mcp)
+            codeInterpreter != null -> visitor.visitCodeInterpreter(codeInterpreter)
+            programmaticToolCalling != null ->
+                visitor.visitProgrammaticToolCalling(programmaticToolCalling)
+            imageGeneration != null -> visitor.visitImageGeneration(imageGeneration)
+            localShell != null -> visitor.visitLocalShell(localShell)
+            shell != null -> visitor.visitShell(shell)
+            custom != null -> visitor.visitCustom(custom)
+            namespace != null -> visitor.visitNamespace(namespace)
+            toolSearch != null -> visitor.visitToolSearch(toolSearch)
+            webSearchPreview != null -> visitor.visitWebSearchPreview(webSearchPreview)
+            applyPatch != null -> visitor.visitApplyPatch(applyPatch)
+            else -> visitor.unknown(_json)
+        }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaTool = apply {
+        if (validated) {
+            return@apply
+        }
+
+        accept(
+            object : Visitor<Unit> {
+                override fun visitFunction(function: BetaFunctionTool) {
+                    function.validate()
+                }
+
+                override fun visitFileSearch(fileSearch: BetaFileSearchTool) {
+                    fileSearch.validate()
+                }
+
+                override fun visitComputer(computer: BetaComputerTool) {
+                    computer.validate()
+                }
+
+                override fun visitComputerUsePreview(
+                    computerUsePreview: BetaComputerUsePreviewTool
+                ) {
+                    computerUsePreview.validate()
+                }
+
+                override fun visitWebSearch(webSearch: BetaWebSearchTool) {
+                    webSearch.validate()
+                }
+
+                override fun visitMcp(mcp: Mcp) {
+                    mcp.validate()
+                }
+
+                override fun visitCodeInterpreter(codeInterpreter: CodeInterpreter) {
+                    codeInterpreter.validate()
+                }
+
+                override fun visitProgrammaticToolCalling(programmaticToolCalling: JsonValue) {
+                    programmaticToolCalling.let {
+                        if (it != JsonValue.from(mapOf("type" to "programmatic_tool_calling"))) {
+                            throw OpenAIInvalidDataException(
+                                "'programmaticToolCalling' is invalid, received $it"
+                            )
+                        }
+                    }
+                }
+
+                override fun visitImageGeneration(imageGeneration: ImageGeneration) {
+                    imageGeneration.validate()
+                }
+
+                override fun visitLocalShell(localShell: JsonValue) {
+                    localShell.let {
+                        if (it != JsonValue.from(mapOf("type" to "local_shell"))) {
+                            throw OpenAIInvalidDataException(
+                                "'localShell' is invalid, received $it"
+                            )
+                        }
+                    }
+                }
+
+                override fun visitShell(shell: BetaFunctionShellTool) {
+                    shell.validate()
+                }
+
+                override fun visitCustom(custom: BetaCustomTool) {
+                    custom.validate()
+                }
+
+                override fun visitNamespace(namespace: BetaNamespaceTool) {
+                    namespace.validate()
+                }
+
+                override fun visitToolSearch(toolSearch: BetaToolSearchTool) {
+                    toolSearch.validate()
+                }
+
+                override fun visitWebSearchPreview(webSearchPreview: BetaWebSearchPreviewTool) {
+                    webSearchPreview.validate()
+                }
+
+                override fun visitApplyPatch(applyPatch: BetaApplyPatchTool) {
+                    applyPatch.validate()
+                }
+            }
+        )
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        accept(
+            object : Visitor<Int> {
+                override fun visitFunction(function: BetaFunctionTool) = function.validity()
+
+                override fun visitFileSearch(fileSearch: BetaFileSearchTool) = fileSearch.validity()
+
+                override fun visitComputer(computer: BetaComputerTool) = computer.validity()
+
+                override fun visitComputerUsePreview(
+                    computerUsePreview: BetaComputerUsePreviewTool
+                ) = computerUsePreview.validity()
+
+                override fun visitWebSearch(webSearch: BetaWebSearchTool) = webSearch.validity()
+
+                override fun visitMcp(mcp: Mcp) = mcp.validity()
+
+                override fun visitCodeInterpreter(codeInterpreter: CodeInterpreter) =
+                    codeInterpreter.validity()
+
+                override fun visitProgrammaticToolCalling(programmaticToolCalling: JsonValue) =
+                    programmaticToolCalling.let {
+                        if (it == JsonValue.from(mapOf("type" to "programmatic_tool_calling"))) 1
+                        else 0
+                    }
+
+                override fun visitImageGeneration(imageGeneration: ImageGeneration) =
+                    imageGeneration.validity()
+
+                override fun visitLocalShell(localShell: JsonValue) =
+                    localShell.let {
+                        if (it == JsonValue.from(mapOf("type" to "local_shell"))) 1 else 0
+                    }
+
+                override fun visitShell(shell: BetaFunctionShellTool) = shell.validity()
+
+                override fun visitCustom(custom: BetaCustomTool) = custom.validity()
+
+                override fun visitNamespace(namespace: BetaNamespaceTool) = namespace.validity()
+
+                override fun visitToolSearch(toolSearch: BetaToolSearchTool) = toolSearch.validity()
+
+                override fun visitWebSearchPreview(webSearchPreview: BetaWebSearchPreviewTool) =
+                    webSearchPreview.validity()
+
+                override fun visitApplyPatch(applyPatch: BetaApplyPatchTool) = applyPatch.validity()
+
+                override fun unknown(json: JsonValue?) = 0
+            }
+        )
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaTool &&
+            function == other.function &&
+            fileSearch == other.fileSearch &&
+            computer == other.computer &&
+            computerUsePreview == other.computerUsePreview &&
+            webSearch == other.webSearch &&
+            mcp == other.mcp &&
+            codeInterpreter == other.codeInterpreter &&
+            programmaticToolCalling == other.programmaticToolCalling &&
+            imageGeneration == other.imageGeneration &&
+            localShell == other.localShell &&
+            shell == other.shell &&
+            custom == other.custom &&
+            namespace == other.namespace &&
+            toolSearch == other.toolSearch &&
+            webSearchPreview == other.webSearchPreview &&
+            applyPatch == other.applyPatch
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(
+            function,
+            fileSearch,
+            computer,
+            computerUsePreview,
+            webSearch,
+            mcp,
+            codeInterpreter,
+            programmaticToolCalling,
+            imageGeneration,
+            localShell,
+            shell,
+            custom,
+            namespace,
+            toolSearch,
+            webSearchPreview,
+            applyPatch,
+        )
+
+    override fun toString(): String =
+        when {
+            function != null -> "BetaTool{function=$function}"
+            fileSearch != null -> "BetaTool{fileSearch=$fileSearch}"
+            computer != null -> "BetaTool{computer=$computer}"
+            computerUsePreview != null -> "BetaTool{computerUsePreview=$computerUsePreview}"
+            webSearch != null -> "BetaTool{webSearch=$webSearch}"
+            mcp != null -> "BetaTool{mcp=$mcp}"
+            codeInterpreter != null -> "BetaTool{codeInterpreter=$codeInterpreter}"
+            programmaticToolCalling != null ->
+                "BetaTool{programmaticToolCalling=$programmaticToolCalling}"
+            imageGeneration != null -> "BetaTool{imageGeneration=$imageGeneration}"
+            localShell != null -> "BetaTool{localShell=$localShell}"
+            shell != null -> "BetaTool{shell=$shell}"
+            custom != null -> "BetaTool{custom=$custom}"
+            namespace != null -> "BetaTool{namespace=$namespace}"
+            toolSearch != null -> "BetaTool{toolSearch=$toolSearch}"
+            webSearchPreview != null -> "BetaTool{webSearchPreview=$webSearchPreview}"
+            applyPatch != null -> "BetaTool{applyPatch=$applyPatch}"
+            _json != null -> "BetaTool{_unknown=$_json}"
+            else -> throw IllegalStateException("Invalid BetaTool")
+        }
+
+    companion object {
+
+        /**
+         * Defines a function in your own code the model can choose to call. Learn more about
+         * [function calling](https://platform.openai.com/docs/guides/function-calling).
+         */
+        @JvmStatic fun ofFunction(function: BetaFunctionTool) = BetaTool(function = function)
+
+        /**
+         * A tool that searches for relevant content from uploaded files. Learn more about the
+         * [file search tool](https://platform.openai.com/docs/guides/tools-file-search).
+         */
+        @JvmStatic
+        fun ofFileSearch(fileSearch: BetaFileSearchTool) = BetaTool(fileSearch = fileSearch)
+
+        /**
+         * A tool that controls a virtual computer. Learn more about the
+         * [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+         */
+        @JvmStatic fun ofComputer(computer: BetaComputerTool) = BetaTool(computer = computer)
+
+        /**
+         * A tool that controls a virtual computer. Learn more about the
+         * [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+         */
+        @JvmStatic
+        fun ofComputerUsePreview(computerUsePreview: BetaComputerUsePreviewTool) =
+            BetaTool(computerUsePreview = computerUsePreview)
+
+        /**
+         * Search the Internet for sources related to the prompt. Learn more about the
+         * [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+         */
+        @JvmStatic fun ofWebSearch(webSearch: BetaWebSearchTool) = BetaTool(webSearch = webSearch)
+
+        /**
+         * Give the model access to additional tools via remote Model Context Protocol (MCP)
+         * servers.
+         * [Learn more about MCP](https://platform.openai.com/docs/guides/tools-remote-mcp).
+         */
+        @JvmStatic fun ofMcp(mcp: Mcp) = BetaTool(mcp = mcp)
+
+        /** A tool that runs Python code to help generate a response to a prompt. */
+        @JvmStatic
+        fun ofCodeInterpreter(codeInterpreter: CodeInterpreter) =
+            BetaTool(codeInterpreter = codeInterpreter)
+
+        @JvmStatic
+        fun ofProgrammaticToolCalling() =
+            BetaTool(
+                programmaticToolCalling =
+                    JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+            )
+
+        /** A tool that generates images using the GPT image models. */
+        @JvmStatic
+        fun ofImageGeneration(imageGeneration: ImageGeneration) =
+            BetaTool(imageGeneration = imageGeneration)
+
+        /** A tool that allows the model to execute shell commands in a local environment. */
+        @JvmStatic
+        fun ofLocalShell() = BetaTool(localShell = JsonValue.from(mapOf("type" to "local_shell")))
+
+        /** A tool that allows the model to execute shell commands. */
+        @JvmStatic fun ofShell(shell: BetaFunctionShellTool) = BetaTool(shell = shell)
+
+        /**
+         * A custom tool that processes input using a specified format. Learn more about
+         * [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
+         */
+        @JvmStatic fun ofCustom(custom: BetaCustomTool) = BetaTool(custom = custom)
+
+        /** Groups function/custom tools under a shared namespace. */
+        @JvmStatic fun ofNamespace(namespace: BetaNamespaceTool) = BetaTool(namespace = namespace)
+
+        /** Hosted or BYOT tool search configuration for deferred tools. */
+        @JvmStatic
+        fun ofToolSearch(toolSearch: BetaToolSearchTool) = BetaTool(toolSearch = toolSearch)
+
+        /**
+         * This tool searches the web for relevant results to use in a response. Learn more about
+         * the [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+         */
+        @JvmStatic
+        fun ofWebSearchPreview(webSearchPreview: BetaWebSearchPreviewTool) =
+            BetaTool(webSearchPreview = webSearchPreview)
+
+        /** Allows the assistant to create, delete, or update files using unified diffs. */
+        @JvmStatic
+        fun ofApplyPatch(applyPatch: BetaApplyPatchTool) = BetaTool(applyPatch = applyPatch)
+    }
+
+    /** An interface that defines how to map each variant of [BetaTool] to a value of type [T]. */
+    interface Visitor<out T> {
+
+        /**
+         * Defines a function in your own code the model can choose to call. Learn more about
+         * [function calling](https://platform.openai.com/docs/guides/function-calling).
+         */
+        fun visitFunction(function: BetaFunctionTool): T
+
+        /**
+         * A tool that searches for relevant content from uploaded files. Learn more about the
+         * [file search tool](https://platform.openai.com/docs/guides/tools-file-search).
+         */
+        fun visitFileSearch(fileSearch: BetaFileSearchTool): T
+
+        /**
+         * A tool that controls a virtual computer. Learn more about the
+         * [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+         */
+        fun visitComputer(computer: BetaComputerTool): T
+
+        /**
+         * A tool that controls a virtual computer. Learn more about the
+         * [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
+         */
+        fun visitComputerUsePreview(computerUsePreview: BetaComputerUsePreviewTool): T
+
+        /**
+         * Search the Internet for sources related to the prompt. Learn more about the
+         * [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+         */
+        fun visitWebSearch(webSearch: BetaWebSearchTool): T
+
+        /**
+         * Give the model access to additional tools via remote Model Context Protocol (MCP)
+         * servers.
+         * [Learn more about MCP](https://platform.openai.com/docs/guides/tools-remote-mcp).
+         */
+        fun visitMcp(mcp: Mcp): T
+
+        /** A tool that runs Python code to help generate a response to a prompt. */
+        fun visitCodeInterpreter(codeInterpreter: CodeInterpreter): T
+
+        fun visitProgrammaticToolCalling(programmaticToolCalling: JsonValue): T
+
+        /** A tool that generates images using the GPT image models. */
+        fun visitImageGeneration(imageGeneration: ImageGeneration): T
+
+        /** A tool that allows the model to execute shell commands in a local environment. */
+        fun visitLocalShell(localShell: JsonValue): T
+
+        /** A tool that allows the model to execute shell commands. */
+        fun visitShell(shell: BetaFunctionShellTool): T
+
+        /**
+         * A custom tool that processes input using a specified format. Learn more about
+         * [custom tools](https://platform.openai.com/docs/guides/function-calling#custom-tools)
+         */
+        fun visitCustom(custom: BetaCustomTool): T
+
+        /** Groups function/custom tools under a shared namespace. */
+        fun visitNamespace(namespace: BetaNamespaceTool): T
+
+        /** Hosted or BYOT tool search configuration for deferred tools. */
+        fun visitToolSearch(toolSearch: BetaToolSearchTool): T
+
+        /**
+         * This tool searches the web for relevant results to use in a response. Learn more about
+         * the [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+         */
+        fun visitWebSearchPreview(webSearchPreview: BetaWebSearchPreviewTool): T
+
+        /** Allows the assistant to create, delete, or update files using unified diffs. */
+        fun visitApplyPatch(applyPatch: BetaApplyPatchTool): T
+
+        /**
+         * Maps an unknown variant of [BetaTool] to a value of type [T].
+         *
+         * An instance of [BetaTool] can contain an unknown variant if it was deserialized from data
+         * that doesn't match any known variant. For example, if the SDK is on an older version than
+         * the API, then the API may respond with new variants that the SDK is unaware of.
+         *
+         * @throws OpenAIInvalidDataException in the default implementation.
+         */
+        fun unknown(json: JsonValue?): T {
+            throw OpenAIInvalidDataException("Unknown BetaTool: $json")
+        }
+    }
+
+    internal class Deserializer : BaseDeserializer<BetaTool>(BetaTool::class) {
+
+        override fun ObjectCodec.deserialize(node: JsonNode): BetaTool {
+            val json = JsonValue.fromJsonNode(node)
+            val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+            when (type) {
+                "function" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaFunctionTool>())?.let {
+                        BetaTool(function = it, _json = json)
+                    } ?: BetaTool(_json = json)
+                }
+                "file_search" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaFileSearchTool>())?.let {
+                        BetaTool(fileSearch = it, _json = json)
+                    } ?: BetaTool(_json = json)
+                }
+                "computer" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaComputerTool>())?.let {
+                        BetaTool(computer = it, _json = json)
+                    } ?: BetaTool(_json = json)
+                }
+                "computer_use_preview" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaComputerUsePreviewTool>())?.let {
+                        BetaTool(computerUsePreview = it, _json = json)
+                    } ?: BetaTool(_json = json)
+                }
+                "mcp" -> {
+                    return tryDeserialize(node, jacksonTypeRef<Mcp>())?.let {
+                        BetaTool(mcp = it, _json = json)
+                    } ?: BetaTool(_json = json)
+                }
+                "code_interpreter" -> {
+                    return tryDeserialize(node, jacksonTypeRef<CodeInterpreter>())?.let {
+                        BetaTool(codeInterpreter = it, _json = json)
+                    } ?: BetaTool(_json = json)
+                }
+                "programmatic_tool_calling" -> {
+                    return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                        ?.let { BetaTool(programmaticToolCalling = it, _json = json) }
+                        ?.takeIf { it.isValid() } ?: BetaTool(_json = json)
+                }
+                "image_generation" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ImageGeneration>())?.let {
+                        BetaTool(imageGeneration = it, _json = json)
+                    } ?: BetaTool(_json = json)
+                }
+                "local_shell" -> {
+                    return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                        ?.let { BetaTool(localShell = it, _json = json) }
+                        ?.takeIf { it.isValid() } ?: BetaTool(_json = json)
+                }
+                "shell" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaFunctionShellTool>())?.let {
+                        BetaTool(shell = it, _json = json)
+                    } ?: BetaTool(_json = json)
+                }
+                "custom" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaCustomTool>())?.let {
+                        BetaTool(custom = it, _json = json)
+                    } ?: BetaTool(_json = json)
+                }
+                "namespace" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaNamespaceTool>())?.let {
+                        BetaTool(namespace = it, _json = json)
+                    } ?: BetaTool(_json = json)
+                }
+                "tool_search" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaToolSearchTool>())?.let {
+                        BetaTool(toolSearch = it, _json = json)
+                    } ?: BetaTool(_json = json)
+                }
+                "apply_patch" -> {
+                    return tryDeserialize(node, jacksonTypeRef<BetaApplyPatchTool>())?.let {
+                        BetaTool(applyPatch = it, _json = json)
+                    } ?: BetaTool(_json = json)
+                }
+            }
+
+            val bestMatches =
+                sequenceOf(
+                        tryDeserialize(node, jacksonTypeRef<BetaWebSearchTool>())?.let {
+                            BetaTool(webSearch = it, _json = json)
+                        },
+                        tryDeserialize(node, jacksonTypeRef<BetaWebSearchPreviewTool>())?.let {
+                            BetaTool(webSearchPreview = it, _json = json)
+                        },
+                    )
+                    .filterNotNull()
+                    .allMaxBy { it.validity() }
+                    .toList()
+            return when (bestMatches.size) {
+                // This can happen if what we're deserializing is completely incompatible with all
+                // the possible variants (e.g. deserializing from boolean).
+                0 -> BetaTool(_json = json)
+                1 -> bestMatches.single()
+                // If there's more than one match with the highest validity, then use the first
+                // completely valid match, or simply the first match if none are completely valid.
+                else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+            }
+        }
+    }
+
+    internal class Serializer : BaseSerializer<BetaTool>(BetaTool::class) {
+
+        override fun serialize(
+            value: BetaTool,
+            generator: JsonGenerator,
+            provider: SerializerProvider,
+        ) {
+            when {
+                value.function != null -> generator.writeObject(value.function)
+                value.fileSearch != null -> generator.writeObject(value.fileSearch)
+                value.computer != null -> generator.writeObject(value.computer)
+                value.computerUsePreview != null -> generator.writeObject(value.computerUsePreview)
+                value.webSearch != null -> generator.writeObject(value.webSearch)
+                value.mcp != null -> generator.writeObject(value.mcp)
+                value.codeInterpreter != null -> generator.writeObject(value.codeInterpreter)
+                value.programmaticToolCalling != null ->
+                    generator.writeObject(value.programmaticToolCalling)
+                value.imageGeneration != null -> generator.writeObject(value.imageGeneration)
+                value.localShell != null -> generator.writeObject(value.localShell)
+                value.shell != null -> generator.writeObject(value.shell)
+                value.custom != null -> generator.writeObject(value.custom)
+                value.namespace != null -> generator.writeObject(value.namespace)
+                value.toolSearch != null -> generator.writeObject(value.toolSearch)
+                value.webSearchPreview != null -> generator.writeObject(value.webSearchPreview)
+                value.applyPatch != null -> generator.writeObject(value.applyPatch)
+                value._json != null -> generator.writeObject(value._json)
+                else -> throw IllegalStateException("Invalid BetaTool")
+            }
+        }
+    }
+
+    /**
+     * Give the model access to additional tools via remote Model Context Protocol (MCP) servers.
+     * [Learn more about MCP](https://platform.openai.com/docs/guides/tools-remote-mcp).
+     */
+    class Mcp
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val serverLabel: JsonField<String>,
+        private val type: JsonValue,
+        private val allowedCallers: JsonField<List<AllowedCaller>>,
+        private val allowedTools: JsonField<AllowedTools>,
+        private val authorization: JsonField<String>,
+        private val connectorId: JsonField<ConnectorId>,
+        private val deferLoading: JsonField<Boolean>,
+        private val headers: JsonField<Headers>,
+        private val requireApproval: JsonField<RequireApproval>,
+        private val serverDescription: JsonField<String>,
+        private val serverUrl: JsonField<String>,
+        private val tunnelId: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("server_label")
+            @ExcludeMissing
+            serverLabel: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("allowed_callers")
+            @ExcludeMissing
+            allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
+            @JsonProperty("allowed_tools")
+            @ExcludeMissing
+            allowedTools: JsonField<AllowedTools> = JsonMissing.of(),
+            @JsonProperty("authorization")
+            @ExcludeMissing
+            authorization: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("connector_id")
+            @ExcludeMissing
+            connectorId: JsonField<ConnectorId> = JsonMissing.of(),
+            @JsonProperty("defer_loading")
+            @ExcludeMissing
+            deferLoading: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("headers") @ExcludeMissing headers: JsonField<Headers> = JsonMissing.of(),
+            @JsonProperty("require_approval")
+            @ExcludeMissing
+            requireApproval: JsonField<RequireApproval> = JsonMissing.of(),
+            @JsonProperty("server_description")
+            @ExcludeMissing
+            serverDescription: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("server_url")
+            @ExcludeMissing
+            serverUrl: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("tunnel_id")
+            @ExcludeMissing
+            tunnelId: JsonField<String> = JsonMissing.of(),
+        ) : this(
+            serverLabel,
+            type,
+            allowedCallers,
+            allowedTools,
+            authorization,
+            connectorId,
+            deferLoading,
+            headers,
+            requireApproval,
+            serverDescription,
+            serverUrl,
+            tunnelId,
+            mutableMapOf(),
+        )
+
+        /**
+         * A label for this MCP server, used to identify it in tool calls.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun serverLabel(): String = serverLabel.getRequired("server_label")
+
+        /**
+         * The type of the MCP tool. Always `mcp`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("mcp")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The tool invocation context(s).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun allowedCallers(): Optional<List<AllowedCaller>> =
+            allowedCallers.getOptional("allowed_callers")
+
+        /**
+         * List of allowed tool names or a filter object.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun allowedTools(): Optional<AllowedTools> = allowedTools.getOptional("allowed_tools")
+
+        /**
+         * An OAuth access token that can be used with a remote MCP server, either with a custom MCP
+         * server URL or a service connector. Your application must handle the OAuth authorization
+         * flow and provide the token here.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun authorization(): Optional<String> = authorization.getOptional("authorization")
+
+        /**
+         * Identifier for service connectors, like those available in ChatGPT. One of `server_url`,
+         * `connector_id`, or `tunnel_id` must be provided. Learn more about service connectors
+         * [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
+         *
+         * Currently supported `connector_id` values are:
+         * - Dropbox: `connector_dropbox`
+         * - Gmail: `connector_gmail`
+         * - Google Calendar: `connector_googlecalendar`
+         * - Google Drive: `connector_googledrive`
+         * - Microsoft Teams: `connector_microsoftteams`
+         * - Outlook Calendar: `connector_outlookcalendar`
+         * - Outlook Email: `connector_outlookemail`
+         * - SharePoint: `connector_sharepoint`
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun connectorId(): Optional<ConnectorId> = connectorId.getOptional("connector_id")
+
+        /**
+         * Whether this MCP tool is deferred and discovered via tool search.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun deferLoading(): Optional<Boolean> = deferLoading.getOptional("defer_loading")
+
+        /**
+         * Optional HTTP headers to send to the MCP server. Use for authentication or other
+         * purposes.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun headers(): Optional<Headers> = headers.getOptional("headers")
+
+        /**
+         * Specify which of the MCP server's tools require approval.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun requireApproval(): Optional<RequireApproval> =
+            requireApproval.getOptional("require_approval")
+
+        /**
+         * Optional description of the MCP server, used to provide more context.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun serverDescription(): Optional<String> =
+            serverDescription.getOptional("server_description")
+
+        /**
+         * The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id` must be
+         * provided.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun serverUrl(): Optional<String> = serverUrl.getOptional("server_url")
+
+        /**
+         * The Secure MCP Tunnel ID to use instead of a direct server URL. One of `server_url`,
+         * `connector_id`, or `tunnel_id` must be provided.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun tunnelId(): Optional<String> = tunnelId.getOptional("tunnel_id")
+
+        /**
+         * Returns the raw JSON value of [serverLabel].
+         *
+         * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("server_label")
+        @ExcludeMissing
+        fun _serverLabel(): JsonField<String> = serverLabel
+
+        /**
+         * Returns the raw JSON value of [allowedCallers].
+         *
+         * Unlike [allowedCallers], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("allowed_callers")
+        @ExcludeMissing
+        fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
+        /**
+         * Returns the raw JSON value of [allowedTools].
+         *
+         * Unlike [allowedTools], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("allowed_tools")
+        @ExcludeMissing
+        fun _allowedTools(): JsonField<AllowedTools> = allowedTools
+
+        /**
+         * Returns the raw JSON value of [authorization].
+         *
+         * Unlike [authorization], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("authorization")
+        @ExcludeMissing
+        fun _authorization(): JsonField<String> = authorization
+
+        /**
+         * Returns the raw JSON value of [connectorId].
+         *
+         * Unlike [connectorId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("connector_id")
+        @ExcludeMissing
+        fun _connectorId(): JsonField<ConnectorId> = connectorId
+
+        /**
+         * Returns the raw JSON value of [deferLoading].
+         *
+         * Unlike [deferLoading], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("defer_loading")
+        @ExcludeMissing
+        fun _deferLoading(): JsonField<Boolean> = deferLoading
+
+        /**
+         * Returns the raw JSON value of [headers].
+         *
+         * Unlike [headers], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("headers") @ExcludeMissing fun _headers(): JsonField<Headers> = headers
+
+        /**
+         * Returns the raw JSON value of [requireApproval].
+         *
+         * Unlike [requireApproval], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("require_approval")
+        @ExcludeMissing
+        fun _requireApproval(): JsonField<RequireApproval> = requireApproval
+
+        /**
+         * Returns the raw JSON value of [serverDescription].
+         *
+         * Unlike [serverDescription], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("server_description")
+        @ExcludeMissing
+        fun _serverDescription(): JsonField<String> = serverDescription
+
+        /**
+         * Returns the raw JSON value of [serverUrl].
+         *
+         * Unlike [serverUrl], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("server_url") @ExcludeMissing fun _serverUrl(): JsonField<String> = serverUrl
+
+        /**
+         * Returns the raw JSON value of [tunnelId].
+         *
+         * Unlike [tunnelId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("tunnel_id") @ExcludeMissing fun _tunnelId(): JsonField<String> = tunnelId
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Mcp].
+             *
+             * The following fields are required:
+             * ```java
+             * .serverLabel()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Mcp]. */
+        class Builder internal constructor() {
+
+            private var serverLabel: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("mcp")
+            private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
+            private var allowedTools: JsonField<AllowedTools> = JsonMissing.of()
+            private var authorization: JsonField<String> = JsonMissing.of()
+            private var connectorId: JsonField<ConnectorId> = JsonMissing.of()
+            private var deferLoading: JsonField<Boolean> = JsonMissing.of()
+            private var headers: JsonField<Headers> = JsonMissing.of()
+            private var requireApproval: JsonField<RequireApproval> = JsonMissing.of()
+            private var serverDescription: JsonField<String> = JsonMissing.of()
+            private var serverUrl: JsonField<String> = JsonMissing.of()
+            private var tunnelId: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(mcp: Mcp) = apply {
+                serverLabel = mcp.serverLabel
+                type = mcp.type
+                allowedCallers = mcp.allowedCallers.map { it.toMutableList() }
+                allowedTools = mcp.allowedTools
+                authorization = mcp.authorization
+                connectorId = mcp.connectorId
+                deferLoading = mcp.deferLoading
+                headers = mcp.headers
+                requireApproval = mcp.requireApproval
+                serverDescription = mcp.serverDescription
+                serverUrl = mcp.serverUrl
+                tunnelId = mcp.tunnelId
+                additionalProperties = mcp.additionalProperties.toMutableMap()
+            }
+
+            /** A label for this MCP server, used to identify it in tool calls. */
+            fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
+
+            /**
+             * Sets [Builder.serverLabel] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serverLabel] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun serverLabel(serverLabel: JsonField<String>) = apply {
+                this.serverLabel = serverLabel
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("mcp")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The tool invocation context(s). */
+            fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+                allowedCallers(JsonField.ofNullable(allowedCallers))
+
+            /** Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`. */
+            fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+                allowedCallers(allowedCallers.getOrNull())
+
+            /**
+             * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.allowedCallers] with a well-typed
+             * `List<AllowedCaller>` value instead. This method is primarily for setting the field
+             * to an undocumented or not yet supported value.
+             */
+            fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+                this.allowedCallers = allowedCallers.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [AllowedCaller] to [allowedCallers].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+                allowedCallers =
+                    (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("allowedCallers", it).add(allowedCaller)
+                    }
+            }
+
+            /** List of allowed tool names or a filter object. */
+            fun allowedTools(allowedTools: AllowedTools?) =
+                allowedTools(JsonField.ofNullable(allowedTools))
+
+            /** Alias for calling [Builder.allowedTools] with `allowedTools.orElse(null)`. */
+            fun allowedTools(allowedTools: Optional<AllowedTools>) =
+                allowedTools(allowedTools.getOrNull())
+
+            /**
+             * Sets [Builder.allowedTools] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.allowedTools] with a well-typed [AllowedTools] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun allowedTools(allowedTools: JsonField<AllowedTools>) = apply {
+                this.allowedTools = allowedTools
+            }
+
+            /** Alias for calling [allowedTools] with `AllowedTools.ofMcp(mcp)`. */
+            fun allowedToolsOfMcp(mcp: List<String>) = allowedTools(AllowedTools.ofMcp(mcp))
+
+            /**
+             * Alias for calling [allowedTools] with `AllowedTools.ofMcpToolFilter(mcpToolFilter)`.
+             */
+            fun allowedTools(mcpToolFilter: AllowedTools.McpToolFilter) =
+                allowedTools(AllowedTools.ofMcpToolFilter(mcpToolFilter))
+
+            /**
+             * An OAuth access token that can be used with a remote MCP server, either with a custom
+             * MCP server URL or a service connector. Your application must handle the OAuth
+             * authorization flow and provide the token here.
+             */
+            fun authorization(authorization: String) = authorization(JsonField.of(authorization))
+
+            /**
+             * Sets [Builder.authorization] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.authorization] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun authorization(authorization: JsonField<String>) = apply {
+                this.authorization = authorization
+            }
+
+            /**
+             * Identifier for service connectors, like those available in ChatGPT. One of
+             * `server_url`, `connector_id`, or `tunnel_id` must be provided. Learn more about
+             * service connectors
+             * [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
+             *
+             * Currently supported `connector_id` values are:
+             * - Dropbox: `connector_dropbox`
+             * - Gmail: `connector_gmail`
+             * - Google Calendar: `connector_googlecalendar`
+             * - Google Drive: `connector_googledrive`
+             * - Microsoft Teams: `connector_microsoftteams`
+             * - Outlook Calendar: `connector_outlookcalendar`
+             * - Outlook Email: `connector_outlookemail`
+             * - SharePoint: `connector_sharepoint`
+             */
+            fun connectorId(connectorId: ConnectorId) = connectorId(JsonField.of(connectorId))
+
+            /**
+             * Sets [Builder.connectorId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.connectorId] with a well-typed [ConnectorId] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun connectorId(connectorId: JsonField<ConnectorId>) = apply {
+                this.connectorId = connectorId
+            }
+
+            /** Whether this MCP tool is deferred and discovered via tool search. */
+            fun deferLoading(deferLoading: Boolean) = deferLoading(JsonField.of(deferLoading))
+
+            /**
+             * Sets [Builder.deferLoading] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.deferLoading] with a well-typed [Boolean] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun deferLoading(deferLoading: JsonField<Boolean>) = apply {
+                this.deferLoading = deferLoading
+            }
+
+            /**
+             * Optional HTTP headers to send to the MCP server. Use for authentication or other
+             * purposes.
+             */
+            fun headers(headers: Headers?) = headers(JsonField.ofNullable(headers))
+
+            /** Alias for calling [Builder.headers] with `headers.orElse(null)`. */
+            fun headers(headers: Optional<Headers>) = headers(headers.getOrNull())
+
+            /**
+             * Sets [Builder.headers] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.headers] with a well-typed [Headers] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun headers(headers: JsonField<Headers>) = apply { this.headers = headers }
+
+            /** Specify which of the MCP server's tools require approval. */
+            fun requireApproval(requireApproval: RequireApproval?) =
+                requireApproval(JsonField.ofNullable(requireApproval))
+
+            /** Alias for calling [Builder.requireApproval] with `requireApproval.orElse(null)`. */
+            fun requireApproval(requireApproval: Optional<RequireApproval>) =
+                requireApproval(requireApproval.getOrNull())
+
+            /**
+             * Sets [Builder.requireApproval] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.requireApproval] with a well-typed [RequireApproval]
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            fun requireApproval(requireApproval: JsonField<RequireApproval>) = apply {
+                this.requireApproval = requireApproval
+            }
+
+            /**
+             * Alias for calling [requireApproval] with
+             * `RequireApproval.ofMcpToolApprovalFilter(mcpToolApprovalFilter)`.
+             */
+            fun requireApproval(mcpToolApprovalFilter: RequireApproval.McpToolApprovalFilter) =
+                requireApproval(RequireApproval.ofMcpToolApprovalFilter(mcpToolApprovalFilter))
+
+            /**
+             * Alias for calling [requireApproval] with
+             * `RequireApproval.ofMcpToolApprovalSetting(mcpToolApprovalSetting)`.
+             */
+            fun requireApproval(mcpToolApprovalSetting: RequireApproval.McpToolApprovalSetting) =
+                requireApproval(RequireApproval.ofMcpToolApprovalSetting(mcpToolApprovalSetting))
+
+            /** Optional description of the MCP server, used to provide more context. */
+            fun serverDescription(serverDescription: String) =
+                serverDescription(JsonField.of(serverDescription))
+
+            /**
+             * Sets [Builder.serverDescription] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serverDescription] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun serverDescription(serverDescription: JsonField<String>) = apply {
+                this.serverDescription = serverDescription
+            }
+
+            /**
+             * The URL for the MCP server. One of `server_url`, `connector_id`, or `tunnel_id` must
+             * be provided.
+             */
+            fun serverUrl(serverUrl: String) = serverUrl(JsonField.of(serverUrl))
+
+            /**
+             * Sets [Builder.serverUrl] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serverUrl] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun serverUrl(serverUrl: JsonField<String>) = apply { this.serverUrl = serverUrl }
+
+            /**
+             * The Secure MCP Tunnel ID to use instead of a direct server URL. One of `server_url`,
+             * `connector_id`, or `tunnel_id` must be provided.
+             */
+            fun tunnelId(tunnelId: String) = tunnelId(JsonField.of(tunnelId))
+
+            /**
+             * Sets [Builder.tunnelId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.tunnelId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun tunnelId(tunnelId: JsonField<String>) = apply { this.tunnelId = tunnelId }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Mcp].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .serverLabel()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Mcp =
+                Mcp(
+                    checkRequired("serverLabel", serverLabel),
+                    type,
+                    (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
+                    allowedTools,
+                    authorization,
+                    connectorId,
+                    deferLoading,
+                    headers,
+                    requireApproval,
+                    serverDescription,
+                    serverUrl,
+                    tunnelId,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Mcp = apply {
+            if (validated) {
+                return@apply
+            }
+
+            serverLabel()
+            _type().let {
+                if (it != JsonValue.from("mcp")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            allowedCallers().ifPresent { it.forEach { it.validate() } }
+            allowedTools().ifPresent { it.validate() }
+            authorization()
+            connectorId().ifPresent { it.validate() }
+            deferLoading()
+            headers().ifPresent { it.validate() }
+            requireApproval().ifPresent { it.validate() }
+            serverDescription()
+            serverUrl()
+            tunnelId()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (serverLabel.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("mcp")) 1 else 0 } +
+                (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (allowedTools.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (authorization.asKnown().isPresent) 1 else 0) +
+                (connectorId.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (deferLoading.asKnown().isPresent) 1 else 0) +
+                (headers.asKnown().getOrNull()?.validity() ?: 0) +
+                (requireApproval.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (serverDescription.asKnown().isPresent) 1 else 0) +
+                (if (serverUrl.asKnown().isPresent) 1 else 0) +
+                (if (tunnelId.asKnown().isPresent) 1 else 0)
+
+        class AllowedCaller @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val DIRECT = of("direct")
+
+                @JvmField val PROGRAMMATIC = of("programmatic")
+
+                @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+            }
+
+            /** An enum containing [AllowedCaller]'s known values. */
+            enum class Known {
+                DIRECT,
+                PROGRAMMATIC,
+            }
+
+            /**
+             * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                DIRECT,
+                PROGRAMMATIC,
+                /**
+                 * An enum member indicating that [AllowedCaller] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    DIRECT -> Value.DIRECT
+                    PROGRAMMATIC -> Value.PROGRAMMATIC
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    DIRECT -> Known.DIRECT
+                    PROGRAMMATIC -> Known.PROGRAMMATIC
+                    else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): AllowedCaller = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is AllowedCaller && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** List of allowed tool names or a filter object. */
+        @JsonDeserialize(using = AllowedTools.Deserializer::class)
+        @JsonSerialize(using = AllowedTools.Serializer::class)
+        class AllowedTools
+        private constructor(
+            private val mcp: List<String>? = null,
+            private val mcpToolFilter: McpToolFilter? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /** A string array of allowed tool names */
+            fun mcp(): Optional<List<String>> = Optional.ofNullable(mcp)
+
+            /** A filter object to specify which tools are allowed. */
+            fun mcpToolFilter(): Optional<McpToolFilter> = Optional.ofNullable(mcpToolFilter)
+
+            fun isMcp(): Boolean = mcp != null
+
+            fun isMcpToolFilter(): Boolean = mcpToolFilter != null
+
+            /** A string array of allowed tool names */
+            fun asMcp(): List<String> = mcp.getOrThrow("mcp")
+
+            /** A filter object to specify which tools are allowed. */
+            fun asMcpToolFilter(): McpToolFilter = mcpToolFilter.getOrThrow("mcpToolFilter")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = allowedTools.accept(new AllowedTools.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitMcp(List<String> mcp) {
+             *         return Optional.of(mcp.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    mcp != null -> visitor.visitMcp(mcp)
+                    mcpToolFilter != null -> visitor.visitMcpToolFilter(mcpToolFilter)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): AllowedTools = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitMcp(mcp: List<String>) {}
+
+                        override fun visitMcpToolFilter(mcpToolFilter: McpToolFilter) {
+                            mcpToolFilter.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitMcp(mcp: List<String>) = mcp.size
+
+                        override fun visitMcpToolFilter(mcpToolFilter: McpToolFilter) =
+                            mcpToolFilter.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is AllowedTools &&
+                    mcp == other.mcp &&
+                    mcpToolFilter == other.mcpToolFilter
+            }
+
+            override fun hashCode(): Int = Objects.hash(mcp, mcpToolFilter)
+
+            override fun toString(): String =
+                when {
+                    mcp != null -> "AllowedTools{mcp=$mcp}"
+                    mcpToolFilter != null -> "AllowedTools{mcpToolFilter=$mcpToolFilter}"
+                    _json != null -> "AllowedTools{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid AllowedTools")
+                }
+
+            companion object {
+
+                /** A string array of allowed tool names */
+                @JvmStatic fun ofMcp(mcp: List<String>) = AllowedTools(mcp = mcp.toImmutable())
+
+                /** A filter object to specify which tools are allowed. */
+                @JvmStatic
+                fun ofMcpToolFilter(mcpToolFilter: McpToolFilter) =
+                    AllowedTools(mcpToolFilter = mcpToolFilter)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [AllowedTools] to a value of
+             * type [T].
+             */
+            interface Visitor<out T> {
+
+                /** A string array of allowed tool names */
+                fun visitMcp(mcp: List<String>): T
+
+                /** A filter object to specify which tools are allowed. */
+                fun visitMcpToolFilter(mcpToolFilter: McpToolFilter): T
+
+                /**
+                 * Maps an unknown variant of [AllowedTools] to a value of type [T].
+                 *
+                 * An instance of [AllowedTools] can contain an unknown variant if it was
+                 * deserialized from data that doesn't match any known variant. For example, if the
+                 * SDK is on an older version than the API, then the API may respond with new
+                 * variants that the SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown AllowedTools: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<AllowedTools>(AllowedTools::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): AllowedTools {
+                    val json = JsonValue.fromJsonNode(node)
+
+                    val bestMatches =
+                        sequenceOf(
+                                tryDeserialize(node, jacksonTypeRef<McpToolFilter>())?.let {
+                                    AllowedTools(mcpToolFilter = it, _json = json)
+                                },
+                                tryDeserialize(node, jacksonTypeRef<List<String>>())?.let {
+                                    AllowedTools(mcp = it, _json = json)
+                                },
+                            )
+                            .filterNotNull()
+                            .allMaxBy { it.validity() }
+                            .toList()
+                    return when (bestMatches.size) {
+                        // This can happen if what we're deserializing is completely incompatible
+                        // with all the possible variants (e.g. deserializing from boolean).
+                        0 -> AllowedTools(_json = json)
+                        1 -> bestMatches.single()
+                        // If there's more than one match with the highest validity, then use the
+                        // first completely valid match, or simply the first match if none are
+                        // completely valid.
+                        else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                    }
+                }
+            }
+
+            internal class Serializer : BaseSerializer<AllowedTools>(AllowedTools::class) {
+
+                override fun serialize(
+                    value: AllowedTools,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.mcp != null -> generator.writeObject(value.mcp)
+                        value.mcpToolFilter != null -> generator.writeObject(value.mcpToolFilter)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid AllowedTools")
+                    }
+                }
+            }
+
+            /** A filter object to specify which tools are allowed. */
+            class McpToolFilter
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val readOnly: JsonField<Boolean>,
+                private val toolNames: JsonField<List<String>>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("read_only")
+                    @ExcludeMissing
+                    readOnly: JsonField<Boolean> = JsonMissing.of(),
+                    @JsonProperty("tool_names")
+                    @ExcludeMissing
+                    toolNames: JsonField<List<String>> = JsonMissing.of(),
+                ) : this(readOnly, toolNames, mutableMapOf())
+
+                /**
+                 * Indicates whether or not a tool modifies data or is read-only. If an MCP server
+                 * is
+                 * [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+                 * it will match this filter.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun readOnly(): Optional<Boolean> = readOnly.getOptional("read_only")
+
+                /**
+                 * List of allowed tool names.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun toolNames(): Optional<List<String>> = toolNames.getOptional("tool_names")
+
+                /**
+                 * Returns the raw JSON value of [readOnly].
+                 *
+                 * Unlike [readOnly], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("read_only")
+                @ExcludeMissing
+                fun _readOnly(): JsonField<Boolean> = readOnly
+
+                /**
+                 * Returns the raw JSON value of [toolNames].
+                 *
+                 * Unlike [toolNames], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("tool_names")
+                @ExcludeMissing
+                fun _toolNames(): JsonField<List<String>> = toolNames
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [McpToolFilter].
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [McpToolFilter]. */
+                class Builder internal constructor() {
+
+                    private var readOnly: JsonField<Boolean> = JsonMissing.of()
+                    private var toolNames: JsonField<MutableList<String>>? = null
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(mcpToolFilter: McpToolFilter) = apply {
+                        readOnly = mcpToolFilter.readOnly
+                        toolNames = mcpToolFilter.toolNames.map { it.toMutableList() }
+                        additionalProperties = mcpToolFilter.additionalProperties.toMutableMap()
+                    }
+
+                    /**
+                     * Indicates whether or not a tool modifies data or is read-only. If an MCP
+                     * server is
+                     * [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+                     * it will match this filter.
+                     */
+                    fun readOnly(readOnly: Boolean) = readOnly(JsonField.of(readOnly))
+
+                    /**
+                     * Sets [Builder.readOnly] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.readOnly] with a well-typed [Boolean] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun readOnly(readOnly: JsonField<Boolean>) = apply { this.readOnly = readOnly }
+
+                    /** List of allowed tool names. */
+                    fun toolNames(toolNames: List<String>) = toolNames(JsonField.of(toolNames))
+
+                    /**
+                     * Sets [Builder.toolNames] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.toolNames] with a well-typed `List<String>`
+                     * value instead. This method is primarily for setting the field to an
+                     * undocumented or not yet supported value.
+                     */
+                    fun toolNames(toolNames: JsonField<List<String>>) = apply {
+                        this.toolNames = toolNames.map { it.toMutableList() }
+                    }
+
+                    /**
+                     * Adds a single [String] to [toolNames].
+                     *
+                     * @throws IllegalStateException if the field was previously set to a non-list.
+                     */
+                    fun addToolName(toolName: String) = apply {
+                        toolNames =
+                            (toolNames ?: JsonField.of(mutableListOf())).also {
+                                checkKnown("toolNames", it).add(toolName)
+                            }
+                    }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [McpToolFilter].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     */
+                    fun build(): McpToolFilter =
+                        McpToolFilter(
+                            readOnly,
+                            (toolNames ?: JsonMissing.of()).map { it.toImmutable() },
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): McpToolFilter = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    readOnly()
+                    toolNames()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (readOnly.asKnown().isPresent) 1 else 0) +
+                        (toolNames.asKnown().getOrNull()?.size ?: 0)
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is McpToolFilter &&
+                        readOnly == other.readOnly &&
+                        toolNames == other.toolNames &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(readOnly, toolNames, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "McpToolFilter{readOnly=$readOnly, toolNames=$toolNames, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        /**
+         * Identifier for service connectors, like those available in ChatGPT. One of `server_url`,
+         * `connector_id`, or `tunnel_id` must be provided. Learn more about service connectors
+         * [here](https://platform.openai.com/docs/guides/tools-remote-mcp#connectors).
+         *
+         * Currently supported `connector_id` values are:
+         * - Dropbox: `connector_dropbox`
+         * - Gmail: `connector_gmail`
+         * - Google Calendar: `connector_googlecalendar`
+         * - Google Drive: `connector_googledrive`
+         * - Microsoft Teams: `connector_microsoftteams`
+         * - Outlook Calendar: `connector_outlookcalendar`
+         * - Outlook Email: `connector_outlookemail`
+         * - SharePoint: `connector_sharepoint`
+         */
+        class ConnectorId @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val CONNECTOR_DROPBOX = of("connector_dropbox")
+
+                @JvmField val CONNECTOR_GMAIL = of("connector_gmail")
+
+                @JvmField val CONNECTOR_GOOGLECALENDAR = of("connector_googlecalendar")
+
+                @JvmField val CONNECTOR_GOOGLEDRIVE = of("connector_googledrive")
+
+                @JvmField val CONNECTOR_MICROSOFTTEAMS = of("connector_microsoftteams")
+
+                @JvmField val CONNECTOR_OUTLOOKCALENDAR = of("connector_outlookcalendar")
+
+                @JvmField val CONNECTOR_OUTLOOKEMAIL = of("connector_outlookemail")
+
+                @JvmField val CONNECTOR_SHAREPOINT = of("connector_sharepoint")
+
+                @JvmStatic fun of(value: String) = ConnectorId(JsonField.of(value))
+            }
+
+            /** An enum containing [ConnectorId]'s known values. */
+            enum class Known {
+                CONNECTOR_DROPBOX,
+                CONNECTOR_GMAIL,
+                CONNECTOR_GOOGLECALENDAR,
+                CONNECTOR_GOOGLEDRIVE,
+                CONNECTOR_MICROSOFTTEAMS,
+                CONNECTOR_OUTLOOKCALENDAR,
+                CONNECTOR_OUTLOOKEMAIL,
+                CONNECTOR_SHAREPOINT,
+            }
+
+            /**
+             * An enum containing [ConnectorId]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [ConnectorId] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                CONNECTOR_DROPBOX,
+                CONNECTOR_GMAIL,
+                CONNECTOR_GOOGLECALENDAR,
+                CONNECTOR_GOOGLEDRIVE,
+                CONNECTOR_MICROSOFTTEAMS,
+                CONNECTOR_OUTLOOKCALENDAR,
+                CONNECTOR_OUTLOOKEMAIL,
+                CONNECTOR_SHAREPOINT,
+                /**
+                 * An enum member indicating that [ConnectorId] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    CONNECTOR_DROPBOX -> Value.CONNECTOR_DROPBOX
+                    CONNECTOR_GMAIL -> Value.CONNECTOR_GMAIL
+                    CONNECTOR_GOOGLECALENDAR -> Value.CONNECTOR_GOOGLECALENDAR
+                    CONNECTOR_GOOGLEDRIVE -> Value.CONNECTOR_GOOGLEDRIVE
+                    CONNECTOR_MICROSOFTTEAMS -> Value.CONNECTOR_MICROSOFTTEAMS
+                    CONNECTOR_OUTLOOKCALENDAR -> Value.CONNECTOR_OUTLOOKCALENDAR
+                    CONNECTOR_OUTLOOKEMAIL -> Value.CONNECTOR_OUTLOOKEMAIL
+                    CONNECTOR_SHAREPOINT -> Value.CONNECTOR_SHAREPOINT
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    CONNECTOR_DROPBOX -> Known.CONNECTOR_DROPBOX
+                    CONNECTOR_GMAIL -> Known.CONNECTOR_GMAIL
+                    CONNECTOR_GOOGLECALENDAR -> Known.CONNECTOR_GOOGLECALENDAR
+                    CONNECTOR_GOOGLEDRIVE -> Known.CONNECTOR_GOOGLEDRIVE
+                    CONNECTOR_MICROSOFTTEAMS -> Known.CONNECTOR_MICROSOFTTEAMS
+                    CONNECTOR_OUTLOOKCALENDAR -> Known.CONNECTOR_OUTLOOKCALENDAR
+                    CONNECTOR_OUTLOOKEMAIL -> Known.CONNECTOR_OUTLOOKEMAIL
+                    CONNECTOR_SHAREPOINT -> Known.CONNECTOR_SHAREPOINT
+                    else -> throw OpenAIInvalidDataException("Unknown ConnectorId: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): ConnectorId = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is ConnectorId && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * Optional HTTP headers to send to the MCP server. Use for authentication or other
+         * purposes.
+         */
+        class Headers
+        @JsonCreator
+        private constructor(
+            @com.fasterxml.jackson.annotation.JsonValue
+            private val additionalProperties: Map<String, JsonValue>
+        ) {
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /** Returns a mutable builder for constructing an instance of [Headers]. */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Headers]. */
+            class Builder internal constructor() {
+
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(headers: Headers) = apply {
+                    additionalProperties = headers.additionalProperties.toMutableMap()
+                }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Headers].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): Headers = Headers(additionalProperties.toImmutable())
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Headers = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                additionalProperties.count { (_, value) -> !value.isNull() && !value.isMissing() }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Headers && additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() = "Headers{additionalProperties=$additionalProperties}"
+        }
+
+        /** Specify which of the MCP server's tools require approval. */
+        @JsonDeserialize(using = RequireApproval.Deserializer::class)
+        @JsonSerialize(using = RequireApproval.Serializer::class)
+        class RequireApproval
+        private constructor(
+            private val mcpToolApprovalFilter: McpToolApprovalFilter? = null,
+            private val mcpToolApprovalSetting: McpToolApprovalSetting? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /**
+             * Specify which of the MCP server's tools require approval. Can be `always`, `never`,
+             * or a filter object associated with tools that require approval.
+             */
+            fun mcpToolApprovalFilter(): Optional<McpToolApprovalFilter> =
+                Optional.ofNullable(mcpToolApprovalFilter)
+
+            /**
+             * Specify a single approval policy for all tools. One of `always` or `never`. When set
+             * to `always`, all tools will require approval. When set to `never`, all tools will not
+             * require approval.
+             */
+            fun mcpToolApprovalSetting(): Optional<McpToolApprovalSetting> =
+                Optional.ofNullable(mcpToolApprovalSetting)
+
+            fun isMcpToolApprovalFilter(): Boolean = mcpToolApprovalFilter != null
+
+            fun isMcpToolApprovalSetting(): Boolean = mcpToolApprovalSetting != null
+
+            /**
+             * Specify which of the MCP server's tools require approval. Can be `always`, `never`,
+             * or a filter object associated with tools that require approval.
+             */
+            fun asMcpToolApprovalFilter(): McpToolApprovalFilter =
+                mcpToolApprovalFilter.getOrThrow("mcpToolApprovalFilter")
+
+            /**
+             * Specify a single approval policy for all tools. One of `always` or `never`. When set
+             * to `always`, all tools will require approval. When set to `never`, all tools will not
+             * require approval.
+             */
+            fun asMcpToolApprovalSetting(): McpToolApprovalSetting =
+                mcpToolApprovalSetting.getOrThrow("mcpToolApprovalSetting")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = requireApproval.accept(new RequireApproval.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitMcpToolApprovalFilter(McpToolApprovalFilter mcpToolApprovalFilter) {
+             *         return Optional.of(mcpToolApprovalFilter.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    mcpToolApprovalFilter != null ->
+                        visitor.visitMcpToolApprovalFilter(mcpToolApprovalFilter)
+                    mcpToolApprovalSetting != null ->
+                        visitor.visitMcpToolApprovalSetting(mcpToolApprovalSetting)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): RequireApproval = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitMcpToolApprovalFilter(
+                            mcpToolApprovalFilter: McpToolApprovalFilter
+                        ) {
+                            mcpToolApprovalFilter.validate()
+                        }
+
+                        override fun visitMcpToolApprovalSetting(
+                            mcpToolApprovalSetting: McpToolApprovalSetting
+                        ) {
+                            mcpToolApprovalSetting.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitMcpToolApprovalFilter(
+                            mcpToolApprovalFilter: McpToolApprovalFilter
+                        ) = mcpToolApprovalFilter.validity()
+
+                        override fun visitMcpToolApprovalSetting(
+                            mcpToolApprovalSetting: McpToolApprovalSetting
+                        ) = mcpToolApprovalSetting.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is RequireApproval &&
+                    mcpToolApprovalFilter == other.mcpToolApprovalFilter &&
+                    mcpToolApprovalSetting == other.mcpToolApprovalSetting
+            }
+
+            override fun hashCode(): Int =
+                Objects.hash(mcpToolApprovalFilter, mcpToolApprovalSetting)
+
+            override fun toString(): String =
+                when {
+                    mcpToolApprovalFilter != null ->
+                        "RequireApproval{mcpToolApprovalFilter=$mcpToolApprovalFilter}"
+                    mcpToolApprovalSetting != null ->
+                        "RequireApproval{mcpToolApprovalSetting=$mcpToolApprovalSetting}"
+                    _json != null -> "RequireApproval{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid RequireApproval")
+                }
+
+            companion object {
+
+                /**
+                 * Specify which of the MCP server's tools require approval. Can be `always`,
+                 * `never`, or a filter object associated with tools that require approval.
+                 */
+                @JvmStatic
+                fun ofMcpToolApprovalFilter(mcpToolApprovalFilter: McpToolApprovalFilter) =
+                    RequireApproval(mcpToolApprovalFilter = mcpToolApprovalFilter)
+
+                /**
+                 * Specify a single approval policy for all tools. One of `always` or `never`. When
+                 * set to `always`, all tools will require approval. When set to `never`, all tools
+                 * will not require approval.
+                 */
+                @JvmStatic
+                fun ofMcpToolApprovalSetting(mcpToolApprovalSetting: McpToolApprovalSetting) =
+                    RequireApproval(mcpToolApprovalSetting = mcpToolApprovalSetting)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [RequireApproval] to a value of
+             * type [T].
+             */
+            interface Visitor<out T> {
+
+                /**
+                 * Specify which of the MCP server's tools require approval. Can be `always`,
+                 * `never`, or a filter object associated with tools that require approval.
+                 */
+                fun visitMcpToolApprovalFilter(mcpToolApprovalFilter: McpToolApprovalFilter): T
+
+                /**
+                 * Specify a single approval policy for all tools. One of `always` or `never`. When
+                 * set to `always`, all tools will require approval. When set to `never`, all tools
+                 * will not require approval.
+                 */
+                fun visitMcpToolApprovalSetting(mcpToolApprovalSetting: McpToolApprovalSetting): T
+
+                /**
+                 * Maps an unknown variant of [RequireApproval] to a value of type [T].
+                 *
+                 * An instance of [RequireApproval] can contain an unknown variant if it was
+                 * deserialized from data that doesn't match any known variant. For example, if the
+                 * SDK is on an older version than the API, then the API may respond with new
+                 * variants that the SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown RequireApproval: $json")
+                }
+            }
+
+            internal class Deserializer :
+                BaseDeserializer<RequireApproval>(RequireApproval::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): RequireApproval {
+                    val json = JsonValue.fromJsonNode(node)
+
+                    val bestMatches =
+                        sequenceOf(
+                                tryDeserialize(node, jacksonTypeRef<McpToolApprovalFilter>())?.let {
+                                    RequireApproval(mcpToolApprovalFilter = it, _json = json)
+                                },
+                                tryDeserialize(node, jacksonTypeRef<McpToolApprovalSetting>())
+                                    ?.let {
+                                        RequireApproval(mcpToolApprovalSetting = it, _json = json)
+                                    },
+                            )
+                            .filterNotNull()
+                            .allMaxBy { it.validity() }
+                            .toList()
+                    return when (bestMatches.size) {
+                        // This can happen if what we're deserializing is completely incompatible
+                        // with all the possible variants (e.g. deserializing from boolean).
+                        0 -> RequireApproval(_json = json)
+                        1 -> bestMatches.single()
+                        // If there's more than one match with the highest validity, then use the
+                        // first completely valid match, or simply the first match if none are
+                        // completely valid.
+                        else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                    }
+                }
+            }
+
+            internal class Serializer : BaseSerializer<RequireApproval>(RequireApproval::class) {
+
+                override fun serialize(
+                    value: RequireApproval,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.mcpToolApprovalFilter != null ->
+                            generator.writeObject(value.mcpToolApprovalFilter)
+                        value.mcpToolApprovalSetting != null ->
+                            generator.writeObject(value.mcpToolApprovalSetting)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid RequireApproval")
+                    }
+                }
+            }
+
+            /**
+             * Specify which of the MCP server's tools require approval. Can be `always`, `never`,
+             * or a filter object associated with tools that require approval.
+             */
+            class McpToolApprovalFilter
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val always: JsonField<Always>,
+                private val never: JsonField<Never>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("always")
+                    @ExcludeMissing
+                    always: JsonField<Always> = JsonMissing.of(),
+                    @JsonProperty("never")
+                    @ExcludeMissing
+                    never: JsonField<Never> = JsonMissing.of(),
+                ) : this(always, never, mutableMapOf())
+
+                /**
+                 * A filter object to specify which tools are allowed.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun always(): Optional<Always> = always.getOptional("always")
+
+                /**
+                 * A filter object to specify which tools are allowed.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun never(): Optional<Never> = never.getOptional("never")
+
+                /**
+                 * Returns the raw JSON value of [always].
+                 *
+                 * Unlike [always], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("always") @ExcludeMissing fun _always(): JsonField<Always> = always
+
+                /**
+                 * Returns the raw JSON value of [never].
+                 *
+                 * Unlike [never], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("never") @ExcludeMissing fun _never(): JsonField<Never> = never
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of
+                     * [McpToolApprovalFilter].
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [McpToolApprovalFilter]. */
+                class Builder internal constructor() {
+
+                    private var always: JsonField<Always> = JsonMissing.of()
+                    private var never: JsonField<Never> = JsonMissing.of()
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(mcpToolApprovalFilter: McpToolApprovalFilter) = apply {
+                        always = mcpToolApprovalFilter.always
+                        never = mcpToolApprovalFilter.never
+                        additionalProperties =
+                            mcpToolApprovalFilter.additionalProperties.toMutableMap()
+                    }
+
+                    /** A filter object to specify which tools are allowed. */
+                    fun always(always: Always) = always(JsonField.of(always))
+
+                    /**
+                     * Sets [Builder.always] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.always] with a well-typed [Always] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun always(always: JsonField<Always>) = apply { this.always = always }
+
+                    /** A filter object to specify which tools are allowed. */
+                    fun never(never: Never) = never(JsonField.of(never))
+
+                    /**
+                     * Sets [Builder.never] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.never] with a well-typed [Never] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun never(never: JsonField<Never>) = apply { this.never = never }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [McpToolApprovalFilter].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     */
+                    fun build(): McpToolApprovalFilter =
+                        McpToolApprovalFilter(always, never, additionalProperties.toMutableMap())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): McpToolApprovalFilter = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    always().ifPresent { it.validate() }
+                    never().ifPresent { it.validate() }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (always.asKnown().getOrNull()?.validity() ?: 0) +
+                        (never.asKnown().getOrNull()?.validity() ?: 0)
+
+                /** A filter object to specify which tools are allowed. */
+                class Always
+                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+                private constructor(
+                    private val readOnly: JsonField<Boolean>,
+                    private val toolNames: JsonField<List<String>>,
+                    private val additionalProperties: MutableMap<String, JsonValue>,
+                ) {
+
+                    @JsonCreator
+                    private constructor(
+                        @JsonProperty("read_only")
+                        @ExcludeMissing
+                        readOnly: JsonField<Boolean> = JsonMissing.of(),
+                        @JsonProperty("tool_names")
+                        @ExcludeMissing
+                        toolNames: JsonField<List<String>> = JsonMissing.of(),
+                    ) : this(readOnly, toolNames, mutableMapOf())
+
+                    /**
+                     * Indicates whether or not a tool modifies data or is read-only. If an MCP
+                     * server is
+                     * [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+                     * it will match this filter.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   (e.g. if the server responded with an unexpected value).
+                     */
+                    fun readOnly(): Optional<Boolean> = readOnly.getOptional("read_only")
+
+                    /**
+                     * List of allowed tool names.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   (e.g. if the server responded with an unexpected value).
+                     */
+                    fun toolNames(): Optional<List<String>> = toolNames.getOptional("tool_names")
+
+                    /**
+                     * Returns the raw JSON value of [readOnly].
+                     *
+                     * Unlike [readOnly], this method doesn't throw if the JSON field has an
+                     * unexpected type.
+                     */
+                    @JsonProperty("read_only")
+                    @ExcludeMissing
+                    fun _readOnly(): JsonField<Boolean> = readOnly
+
+                    /**
+                     * Returns the raw JSON value of [toolNames].
+                     *
+                     * Unlike [toolNames], this method doesn't throw if the JSON field has an
+                     * unexpected type.
+                     */
+                    @JsonProperty("tool_names")
+                    @ExcludeMissing
+                    fun _toolNames(): JsonField<List<String>> = toolNames
+
+                    @JsonAnySetter
+                    private fun putAdditionalProperty(key: String, value: JsonValue) {
+                        additionalProperties.put(key, value)
+                    }
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> =
+                        Collections.unmodifiableMap(additionalProperties)
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /** Returns a mutable builder for constructing an instance of [Always]. */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [Always]. */
+                    class Builder internal constructor() {
+
+                        private var readOnly: JsonField<Boolean> = JsonMissing.of()
+                        private var toolNames: JsonField<MutableList<String>>? = null
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(always: Always) = apply {
+                            readOnly = always.readOnly
+                            toolNames = always.toolNames.map { it.toMutableList() }
+                            additionalProperties = always.additionalProperties.toMutableMap()
+                        }
+
+                        /**
+                         * Indicates whether or not a tool modifies data or is read-only. If an MCP
+                         * server is
+                         * [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+                         * it will match this filter.
+                         */
+                        fun readOnly(readOnly: Boolean) = readOnly(JsonField.of(readOnly))
+
+                        /**
+                         * Sets [Builder.readOnly] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.readOnly] with a well-typed [Boolean]
+                         * value instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun readOnly(readOnly: JsonField<Boolean>) = apply {
+                            this.readOnly = readOnly
+                        }
+
+                        /** List of allowed tool names. */
+                        fun toolNames(toolNames: List<String>) = toolNames(JsonField.of(toolNames))
+
+                        /**
+                         * Sets [Builder.toolNames] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.toolNames] with a well-typed
+                         * `List<String>` value instead. This method is primarily for setting the
+                         * field to an undocumented or not yet supported value.
+                         */
+                        fun toolNames(toolNames: JsonField<List<String>>) = apply {
+                            this.toolNames = toolNames.map { it.toMutableList() }
+                        }
+
+                        /**
+                         * Adds a single [String] to [toolNames].
+                         *
+                         * @throws IllegalStateException if the field was previously set to a
+                         *   non-list.
+                         */
+                        fun addToolName(toolName: String) = apply {
+                            toolNames =
+                                (toolNames ?: JsonField.of(mutableListOf())).also {
+                                    checkKnown("toolNames", it).add(toolName)
+                                }
+                        }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [Always].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         */
+                        fun build(): Always =
+                            Always(
+                                readOnly,
+                                (toolNames ?: JsonMissing.of()).map { it.toImmutable() },
+                                additionalProperties.toMutableMap(),
+                            )
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): Always = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        readOnly()
+                        toolNames()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        (if (readOnly.asKnown().isPresent) 1 else 0) +
+                            (toolNames.asKnown().getOrNull()?.size ?: 0)
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Always &&
+                            readOnly == other.readOnly &&
+                            toolNames == other.toolNames &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy {
+                        Objects.hash(readOnly, toolNames, additionalProperties)
+                    }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "Always{readOnly=$readOnly, toolNames=$toolNames, additionalProperties=$additionalProperties}"
+                }
+
+                /** A filter object to specify which tools are allowed. */
+                class Never
+                @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+                private constructor(
+                    private val readOnly: JsonField<Boolean>,
+                    private val toolNames: JsonField<List<String>>,
+                    private val additionalProperties: MutableMap<String, JsonValue>,
+                ) {
+
+                    @JsonCreator
+                    private constructor(
+                        @JsonProperty("read_only")
+                        @ExcludeMissing
+                        readOnly: JsonField<Boolean> = JsonMissing.of(),
+                        @JsonProperty("tool_names")
+                        @ExcludeMissing
+                        toolNames: JsonField<List<String>> = JsonMissing.of(),
+                    ) : this(readOnly, toolNames, mutableMapOf())
+
+                    /**
+                     * Indicates whether or not a tool modifies data or is read-only. If an MCP
+                     * server is
+                     * [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+                     * it will match this filter.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   (e.g. if the server responded with an unexpected value).
+                     */
+                    fun readOnly(): Optional<Boolean> = readOnly.getOptional("read_only")
+
+                    /**
+                     * List of allowed tool names.
+                     *
+                     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
+                     *   (e.g. if the server responded with an unexpected value).
+                     */
+                    fun toolNames(): Optional<List<String>> = toolNames.getOptional("tool_names")
+
+                    /**
+                     * Returns the raw JSON value of [readOnly].
+                     *
+                     * Unlike [readOnly], this method doesn't throw if the JSON field has an
+                     * unexpected type.
+                     */
+                    @JsonProperty("read_only")
+                    @ExcludeMissing
+                    fun _readOnly(): JsonField<Boolean> = readOnly
+
+                    /**
+                     * Returns the raw JSON value of [toolNames].
+                     *
+                     * Unlike [toolNames], this method doesn't throw if the JSON field has an
+                     * unexpected type.
+                     */
+                    @JsonProperty("tool_names")
+                    @ExcludeMissing
+                    fun _toolNames(): JsonField<List<String>> = toolNames
+
+                    @JsonAnySetter
+                    private fun putAdditionalProperty(key: String, value: JsonValue) {
+                        additionalProperties.put(key, value)
+                    }
+
+                    @JsonAnyGetter
+                    @ExcludeMissing
+                    fun _additionalProperties(): Map<String, JsonValue> =
+                        Collections.unmodifiableMap(additionalProperties)
+
+                    fun toBuilder() = Builder().from(this)
+
+                    companion object {
+
+                        /** Returns a mutable builder for constructing an instance of [Never]. */
+                        @JvmStatic fun builder() = Builder()
+                    }
+
+                    /** A builder for [Never]. */
+                    class Builder internal constructor() {
+
+                        private var readOnly: JsonField<Boolean> = JsonMissing.of()
+                        private var toolNames: JsonField<MutableList<String>>? = null
+                        private var additionalProperties: MutableMap<String, JsonValue> =
+                            mutableMapOf()
+
+                        @JvmSynthetic
+                        internal fun from(never: Never) = apply {
+                            readOnly = never.readOnly
+                            toolNames = never.toolNames.map { it.toMutableList() }
+                            additionalProperties = never.additionalProperties.toMutableMap()
+                        }
+
+                        /**
+                         * Indicates whether or not a tool modifies data or is read-only. If an MCP
+                         * server is
+                         * [annotated with `readOnlyHint`](https://modelcontextprotocol.io/specification/2025-06-18/schema#toolannotations-readonlyhint),
+                         * it will match this filter.
+                         */
+                        fun readOnly(readOnly: Boolean) = readOnly(JsonField.of(readOnly))
+
+                        /**
+                         * Sets [Builder.readOnly] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.readOnly] with a well-typed [Boolean]
+                         * value instead. This method is primarily for setting the field to an
+                         * undocumented or not yet supported value.
+                         */
+                        fun readOnly(readOnly: JsonField<Boolean>) = apply {
+                            this.readOnly = readOnly
+                        }
+
+                        /** List of allowed tool names. */
+                        fun toolNames(toolNames: List<String>) = toolNames(JsonField.of(toolNames))
+
+                        /**
+                         * Sets [Builder.toolNames] to an arbitrary JSON value.
+                         *
+                         * You should usually call [Builder.toolNames] with a well-typed
+                         * `List<String>` value instead. This method is primarily for setting the
+                         * field to an undocumented or not yet supported value.
+                         */
+                        fun toolNames(toolNames: JsonField<List<String>>) = apply {
+                            this.toolNames = toolNames.map { it.toMutableList() }
+                        }
+
+                        /**
+                         * Adds a single [String] to [toolNames].
+                         *
+                         * @throws IllegalStateException if the field was previously set to a
+                         *   non-list.
+                         */
+                        fun addToolName(toolName: String) = apply {
+                            toolNames =
+                                (toolNames ?: JsonField.of(mutableListOf())).also {
+                                    checkKnown("toolNames", it).add(toolName)
+                                }
+                        }
+
+                        fun additionalProperties(additionalProperties: Map<String, JsonValue>) =
+                            apply {
+                                this.additionalProperties.clear()
+                                putAllAdditionalProperties(additionalProperties)
+                            }
+
+                        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                            additionalProperties.put(key, value)
+                        }
+
+                        fun putAllAdditionalProperties(
+                            additionalProperties: Map<String, JsonValue>
+                        ) = apply { this.additionalProperties.putAll(additionalProperties) }
+
+                        fun removeAdditionalProperty(key: String) = apply {
+                            additionalProperties.remove(key)
+                        }
+
+                        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                            keys.forEach(::removeAdditionalProperty)
+                        }
+
+                        /**
+                         * Returns an immutable instance of [Never].
+                         *
+                         * Further updates to this [Builder] will not mutate the returned instance.
+                         */
+                        fun build(): Never =
+                            Never(
+                                readOnly,
+                                (toolNames ?: JsonMissing.of()).map { it.toImmutable() },
+                                additionalProperties.toMutableMap(),
+                            )
+                    }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): Never = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        readOnly()
+                        toolNames()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        (if (readOnly.asKnown().isPresent) 1 else 0) +
+                            (toolNames.asKnown().getOrNull()?.size ?: 0)
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Never &&
+                            readOnly == other.readOnly &&
+                            toolNames == other.toolNames &&
+                            additionalProperties == other.additionalProperties
+                    }
+
+                    private val hashCode: Int by lazy {
+                        Objects.hash(readOnly, toolNames, additionalProperties)
+                    }
+
+                    override fun hashCode(): Int = hashCode
+
+                    override fun toString() =
+                        "Never{readOnly=$readOnly, toolNames=$toolNames, additionalProperties=$additionalProperties}"
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is McpToolApprovalFilter &&
+                        always == other.always &&
+                        never == other.never &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(always, never, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "McpToolApprovalFilter{always=$always, never=$never, additionalProperties=$additionalProperties}"
+            }
+
+            /**
+             * Specify a single approval policy for all tools. One of `always` or `never`. When set
+             * to `always`, all tools will require approval. When set to `never`, all tools will not
+             * require approval.
+             */
+            class McpToolApprovalSetting
+            @JsonCreator
+            private constructor(private val value: JsonField<String>) : Enum {
+
+                /**
+                 * Returns this class instance's raw value.
+                 *
+                 * This is usually only useful if this instance was deserialized from data that
+                 * doesn't match any known member, and you want to know that value. For example, if
+                 * the SDK is on an older version than the API, then the API may respond with new
+                 * members that the SDK is unaware of.
+                 */
+                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+                companion object {
+
+                    @JvmField val ALWAYS = of("always")
+
+                    @JvmField val NEVER = of("never")
+
+                    @JvmStatic fun of(value: String) = McpToolApprovalSetting(JsonField.of(value))
+                }
+
+                /** An enum containing [McpToolApprovalSetting]'s known values. */
+                enum class Known {
+                    ALWAYS,
+                    NEVER,
+                }
+
+                /**
+                 * An enum containing [McpToolApprovalSetting]'s known values, as well as an
+                 * [_UNKNOWN] member.
+                 *
+                 * An instance of [McpToolApprovalSetting] can contain an unknown value in a couple
+                 * of cases:
+                 * - It was deserialized from data that doesn't match any known member. For example,
+                 *   if the SDK is on an older version than the API, then the API may respond with
+                 *   new members that the SDK is unaware of.
+                 * - It was constructed with an arbitrary value using the [of] method.
+                 */
+                enum class Value {
+                    ALWAYS,
+                    NEVER,
+                    /**
+                     * An enum member indicating that [McpToolApprovalSetting] was instantiated with
+                     * an unknown value.
+                     */
+                    _UNKNOWN,
+                }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value, or
+                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                 *
+                 * Use the [known] method instead if you're certain the value is always known or if
+                 * you want to throw for the unknown case.
+                 */
+                fun value(): Value =
+                    when (this) {
+                        ALWAYS -> Value.ALWAYS
+                        NEVER -> Value.NEVER
+                        else -> Value._UNKNOWN
+                    }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value.
+                 *
+                 * Use the [value] method instead if you're uncertain the value is always known and
+                 * don't want to throw for the unknown case.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                 *   known member.
+                 */
+                fun known(): Known =
+                    when (this) {
+                        ALWAYS -> Known.ALWAYS
+                        NEVER -> Known.NEVER
+                        else ->
+                            throw OpenAIInvalidDataException(
+                                "Unknown McpToolApprovalSetting: $value"
+                            )
+                    }
+
+                /**
+                 * Returns this class instance's primitive wire representation.
+                 *
+                 * This differs from the [toString] method because that method is primarily for
+                 * debugging and generally doesn't throw.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value does not have
+                 *   the expected primitive type.
+                 */
+                fun asString(): String =
+                    _value().asString().orElseThrow {
+                        OpenAIInvalidDataException("Value is not a String")
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): McpToolApprovalSetting = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    known()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is McpToolApprovalSetting && value == other.value
+                }
+
+                override fun hashCode() = value.hashCode()
+
+                override fun toString() = value.toString()
+            }
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Mcp &&
+                serverLabel == other.serverLabel &&
+                type == other.type &&
+                allowedCallers == other.allowedCallers &&
+                allowedTools == other.allowedTools &&
+                authorization == other.authorization &&
+                connectorId == other.connectorId &&
+                deferLoading == other.deferLoading &&
+                headers == other.headers &&
+                requireApproval == other.requireApproval &&
+                serverDescription == other.serverDescription &&
+                serverUrl == other.serverUrl &&
+                tunnelId == other.tunnelId &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                serverLabel,
+                type,
+                allowedCallers,
+                allowedTools,
+                authorization,
+                connectorId,
+                deferLoading,
+                headers,
+                requireApproval,
+                serverDescription,
+                serverUrl,
+                tunnelId,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Mcp{serverLabel=$serverLabel, type=$type, allowedCallers=$allowedCallers, allowedTools=$allowedTools, authorization=$authorization, connectorId=$connectorId, deferLoading=$deferLoading, headers=$headers, requireApproval=$requireApproval, serverDescription=$serverDescription, serverUrl=$serverUrl, tunnelId=$tunnelId, additionalProperties=$additionalProperties}"
+    }
+
+    /** A tool that runs Python code to help generate a response to a prompt. */
+    class CodeInterpreter
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val container: JsonField<Container>,
+        private val type: JsonValue,
+        private val allowedCallers: JsonField<List<AllowedCaller>>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("container")
+            @ExcludeMissing
+            container: JsonField<Container> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("allowed_callers")
+            @ExcludeMissing
+            allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
+        ) : this(container, type, allowedCallers, mutableMapOf())
+
+        /**
+         * The code interpreter container. Can be a container ID or an object that specifies
+         * uploaded file IDs to make available to your code, along with an optional `memory_limit`
+         * setting.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun container(): Container = container.getRequired("container")
+
+        /**
+         * The type of the code interpreter tool. Always `code_interpreter`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("code_interpreter")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The tool invocation context(s).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun allowedCallers(): Optional<List<AllowedCaller>> =
+            allowedCallers.getOptional("allowed_callers")
+
+        /**
+         * Returns the raw JSON value of [container].
+         *
+         * Unlike [container], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("container")
+        @ExcludeMissing
+        fun _container(): JsonField<Container> = container
+
+        /**
+         * Returns the raw JSON value of [allowedCallers].
+         *
+         * Unlike [allowedCallers], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("allowed_callers")
+        @ExcludeMissing
+        fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [CodeInterpreter].
+             *
+             * The following fields are required:
+             * ```java
+             * .container()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [CodeInterpreter]. */
+        class Builder internal constructor() {
+
+            private var container: JsonField<Container>? = null
+            private var type: JsonValue = JsonValue.from("code_interpreter")
+            private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(codeInterpreter: CodeInterpreter) = apply {
+                container = codeInterpreter.container
+                type = codeInterpreter.type
+                allowedCallers = codeInterpreter.allowedCallers.map { it.toMutableList() }
+                additionalProperties = codeInterpreter.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * The code interpreter container. Can be a container ID or an object that specifies
+             * uploaded file IDs to make available to your code, along with an optional
+             * `memory_limit` setting.
+             */
+            fun container(container: Container) = container(JsonField.of(container))
+
+            /**
+             * Sets [Builder.container] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.container] with a well-typed [Container] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun container(container: JsonField<Container>) = apply { this.container = container }
+
+            /** Alias for calling [container] with `Container.ofString(string)`. */
+            fun container(string: String) = container(Container.ofString(string))
+
+            /**
+             * Alias for calling [container] with
+             * `Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)`.
+             */
+            fun container(codeInterpreterToolAuto: Container.CodeInterpreterToolAuto) =
+                container(Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto))
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("code_interpreter")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** The tool invocation context(s). */
+            fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+                allowedCallers(JsonField.ofNullable(allowedCallers))
+
+            /** Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`. */
+            fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+                allowedCallers(allowedCallers.getOrNull())
+
+            /**
+             * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.allowedCallers] with a well-typed
+             * `List<AllowedCaller>` value instead. This method is primarily for setting the field
+             * to an undocumented or not yet supported value.
+             */
+            fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+                this.allowedCallers = allowedCallers.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [AllowedCaller] to [allowedCallers].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+                allowedCallers =
+                    (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("allowedCallers", it).add(allowedCaller)
+                    }
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [CodeInterpreter].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .container()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): CodeInterpreter =
+                CodeInterpreter(
+                    checkRequired("container", container),
+                    type,
+                    (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): CodeInterpreter = apply {
+            if (validated) {
+                return@apply
+            }
+
+            container().validate()
+            _type().let {
+                if (it != JsonValue.from("code_interpreter")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            allowedCallers().ifPresent { it.forEach { it.validate() } }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (container.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("code_interpreter")) 1 else 0 } +
+                (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+        /**
+         * The code interpreter container. Can be a container ID or an object that specifies
+         * uploaded file IDs to make available to your code, along with an optional `memory_limit`
+         * setting.
+         */
+        @JsonDeserialize(using = Container.Deserializer::class)
+        @JsonSerialize(using = Container.Serializer::class)
+        class Container
+        private constructor(
+            private val string: String? = null,
+            private val codeInterpreterToolAuto: CodeInterpreterToolAuto? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /** The container ID. */
+            fun string(): Optional<String> = Optional.ofNullable(string)
+
+            /**
+             * Configuration for a code interpreter container. Optionally specify the IDs of the
+             * files to run the code on.
+             */
+            fun codeInterpreterToolAuto(): Optional<CodeInterpreterToolAuto> =
+                Optional.ofNullable(codeInterpreterToolAuto)
+
+            fun isString(): Boolean = string != null
+
+            fun isCodeInterpreterToolAuto(): Boolean = codeInterpreterToolAuto != null
+
+            /** The container ID. */
+            fun asString(): String = string.getOrThrow("string")
+
+            /**
+             * Configuration for a code interpreter container. Optionally specify the IDs of the
+             * files to run the code on.
+             */
+            fun asCodeInterpreterToolAuto(): CodeInterpreterToolAuto =
+                codeInterpreterToolAuto.getOrThrow("codeInterpreterToolAuto")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = container.accept(new Container.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitString(String string) {
+             *         return Optional.of(string.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    string != null -> visitor.visitString(string)
+                    codeInterpreterToolAuto != null ->
+                        visitor.visitCodeInterpreterToolAuto(codeInterpreterToolAuto)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Container = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitString(string: String) {}
+
+                        override fun visitCodeInterpreterToolAuto(
+                            codeInterpreterToolAuto: CodeInterpreterToolAuto
+                        ) {
+                            codeInterpreterToolAuto.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitString(string: String) = 1
+
+                        override fun visitCodeInterpreterToolAuto(
+                            codeInterpreterToolAuto: CodeInterpreterToolAuto
+                        ) = codeInterpreterToolAuto.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Container &&
+                    string == other.string &&
+                    codeInterpreterToolAuto == other.codeInterpreterToolAuto
+            }
+
+            override fun hashCode(): Int = Objects.hash(string, codeInterpreterToolAuto)
+
+            override fun toString(): String =
+                when {
+                    string != null -> "Container{string=$string}"
+                    codeInterpreterToolAuto != null ->
+                        "Container{codeInterpreterToolAuto=$codeInterpreterToolAuto}"
+                    _json != null -> "Container{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Container")
+                }
+
+            companion object {
+
+                /** The container ID. */
+                @JvmStatic fun ofString(string: String) = Container(string = string)
+
+                /**
+                 * Configuration for a code interpreter container. Optionally specify the IDs of the
+                 * files to run the code on.
+                 */
+                @JvmStatic
+                fun ofCodeInterpreterToolAuto(codeInterpreterToolAuto: CodeInterpreterToolAuto) =
+                    Container(codeInterpreterToolAuto = codeInterpreterToolAuto)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Container] to a value of type
+             * [T].
+             */
+            interface Visitor<out T> {
+
+                /** The container ID. */
+                fun visitString(string: String): T
+
+                /**
+                 * Configuration for a code interpreter container. Optionally specify the IDs of the
+                 * files to run the code on.
+                 */
+                fun visitCodeInterpreterToolAuto(
+                    codeInterpreterToolAuto: CodeInterpreterToolAuto
+                ): T
+
+                /**
+                 * Maps an unknown variant of [Container] to a value of type [T].
+                 *
+                 * An instance of [Container] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Container: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Container>(Container::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Container {
+                    val json = JsonValue.fromJsonNode(node)
+
+                    val bestMatches =
+                        sequenceOf(
+                                tryDeserialize(node, jacksonTypeRef<CodeInterpreterToolAuto>())
+                                    ?.let { Container(codeInterpreterToolAuto = it, _json = json) },
+                                tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                    Container(string = it, _json = json)
+                                },
+                            )
+                            .filterNotNull()
+                            .allMaxBy { it.validity() }
+                            .toList()
+                    return when (bestMatches.size) {
+                        // This can happen if what we're deserializing is completely incompatible
+                        // with all the possible variants (e.g. deserializing from boolean).
+                        0 -> Container(_json = json)
+                        1 -> bestMatches.single()
+                        // If there's more than one match with the highest validity, then use the
+                        // first completely valid match, or simply the first match if none are
+                        // completely valid.
+                        else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                    }
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Container>(Container::class) {
+
+                override fun serialize(
+                    value: Container,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.string != null -> generator.writeObject(value.string)
+                        value.codeInterpreterToolAuto != null ->
+                            generator.writeObject(value.codeInterpreterToolAuto)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Container")
+                    }
+                }
+            }
+
+            /**
+             * Configuration for a code interpreter container. Optionally specify the IDs of the
+             * files to run the code on.
+             */
+            class CodeInterpreterToolAuto
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val type: JsonValue,
+                private val fileIds: JsonField<List<String>>,
+                private val memoryLimit: JsonField<MemoryLimit>,
+                private val networkPolicy: JsonField<NetworkPolicy>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                    @JsonProperty("file_ids")
+                    @ExcludeMissing
+                    fileIds: JsonField<List<String>> = JsonMissing.of(),
+                    @JsonProperty("memory_limit")
+                    @ExcludeMissing
+                    memoryLimit: JsonField<MemoryLimit> = JsonMissing.of(),
+                    @JsonProperty("network_policy")
+                    @ExcludeMissing
+                    networkPolicy: JsonField<NetworkPolicy> = JsonMissing.of(),
+                ) : this(type, fileIds, memoryLimit, networkPolicy, mutableMapOf())
+
+                /**
+                 * Always `auto`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("auto")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * An optional list of uploaded files to make available to your code.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun fileIds(): Optional<List<String>> = fileIds.getOptional("file_ids")
+
+                /**
+                 * The memory limit for the code interpreter container.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun memoryLimit(): Optional<MemoryLimit> = memoryLimit.getOptional("memory_limit")
+
+                /**
+                 * Network access policy for the container.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
+                 *   if the server responded with an unexpected value).
+                 */
+                fun networkPolicy(): Optional<NetworkPolicy> =
+                    networkPolicy.getOptional("network_policy")
+
+                /**
+                 * Returns the raw JSON value of [fileIds].
+                 *
+                 * Unlike [fileIds], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("file_ids")
+                @ExcludeMissing
+                fun _fileIds(): JsonField<List<String>> = fileIds
+
+                /**
+                 * Returns the raw JSON value of [memoryLimit].
+                 *
+                 * Unlike [memoryLimit], this method doesn't throw if the JSON field has an
+                 * unexpected type.
+                 */
+                @JsonProperty("memory_limit")
+                @ExcludeMissing
+                fun _memoryLimit(): JsonField<MemoryLimit> = memoryLimit
+
+                /**
+                 * Returns the raw JSON value of [networkPolicy].
+                 *
+                 * Unlike [networkPolicy], this method doesn't throw if the JSON field has an
+                 * unexpected type.
+                 */
+                @JsonProperty("network_policy")
+                @ExcludeMissing
+                fun _networkPolicy(): JsonField<NetworkPolicy> = networkPolicy
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of
+                     * [CodeInterpreterToolAuto].
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [CodeInterpreterToolAuto]. */
+                class Builder internal constructor() {
+
+                    private var type: JsonValue = JsonValue.from("auto")
+                    private var fileIds: JsonField<MutableList<String>>? = null
+                    private var memoryLimit: JsonField<MemoryLimit> = JsonMissing.of()
+                    private var networkPolicy: JsonField<NetworkPolicy> = JsonMissing.of()
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(codeInterpreterToolAuto: CodeInterpreterToolAuto) = apply {
+                        type = codeInterpreterToolAuto.type
+                        fileIds = codeInterpreterToolAuto.fileIds.map { it.toMutableList() }
+                        memoryLimit = codeInterpreterToolAuto.memoryLimit
+                        networkPolicy = codeInterpreterToolAuto.networkPolicy
+                        additionalProperties =
+                            codeInterpreterToolAuto.additionalProperties.toMutableMap()
+                    }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("auto")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    /** An optional list of uploaded files to make available to your code. */
+                    fun fileIds(fileIds: List<String>) = fileIds(JsonField.of(fileIds))
+
+                    /**
+                     * Sets [Builder.fileIds] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.fileIds] with a well-typed `List<String>`
+                     * value instead. This method is primarily for setting the field to an
+                     * undocumented or not yet supported value.
+                     */
+                    fun fileIds(fileIds: JsonField<List<String>>) = apply {
+                        this.fileIds = fileIds.map { it.toMutableList() }
+                    }
+
+                    /**
+                     * Adds a single [String] to [fileIds].
+                     *
+                     * @throws IllegalStateException if the field was previously set to a non-list.
+                     */
+                    fun addFileId(fileId: String) = apply {
+                        fileIds =
+                            (fileIds ?: JsonField.of(mutableListOf())).also {
+                                checkKnown("fileIds", it).add(fileId)
+                            }
+                    }
+
+                    /** The memory limit for the code interpreter container. */
+                    fun memoryLimit(memoryLimit: MemoryLimit?) =
+                        memoryLimit(JsonField.ofNullable(memoryLimit))
+
+                    /** Alias for calling [Builder.memoryLimit] with `memoryLimit.orElse(null)`. */
+                    fun memoryLimit(memoryLimit: Optional<MemoryLimit>) =
+                        memoryLimit(memoryLimit.getOrNull())
+
+                    /**
+                     * Sets [Builder.memoryLimit] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.memoryLimit] with a well-typed [MemoryLimit]
+                     * value instead. This method is primarily for setting the field to an
+                     * undocumented or not yet supported value.
+                     */
+                    fun memoryLimit(memoryLimit: JsonField<MemoryLimit>) = apply {
+                        this.memoryLimit = memoryLimit
+                    }
+
+                    /** Network access policy for the container. */
+                    fun networkPolicy(networkPolicy: NetworkPolicy) =
+                        networkPolicy(JsonField.of(networkPolicy))
+
+                    /**
+                     * Sets [Builder.networkPolicy] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.networkPolicy] with a well-typed
+                     * [NetworkPolicy] value instead. This method is primarily for setting the field
+                     * to an undocumented or not yet supported value.
+                     */
+                    fun networkPolicy(networkPolicy: JsonField<NetworkPolicy>) = apply {
+                        this.networkPolicy = networkPolicy
+                    }
+
+                    /**
+                     * Alias for calling [networkPolicy] with `NetworkPolicy.ofDisabled(disabled)`.
+                     */
+                    fun networkPolicy(disabled: BetaContainerNetworkPolicyDisabled) =
+                        networkPolicy(NetworkPolicy.ofDisabled(disabled))
+
+                    /**
+                     * Alias for calling [networkPolicy] with
+                     * `NetworkPolicy.ofAllowlist(allowlist)`.
+                     */
+                    fun networkPolicy(allowlist: BetaContainerNetworkPolicyAllowlist) =
+                        networkPolicy(NetworkPolicy.ofAllowlist(allowlist))
+
+                    /**
+                     * Alias for calling [networkPolicy] with the following:
+                     * ```java
+                     * BetaContainerNetworkPolicyAllowlist.builder()
+                     *     .allowedDomains(allowedDomains)
+                     *     .build()
+                     * ```
+                     */
+                    fun allowlistNetworkPolicy(allowedDomains: List<String>) =
+                        networkPolicy(
+                            BetaContainerNetworkPolicyAllowlist.builder()
+                                .allowedDomains(allowedDomains)
+                                .build()
+                        )
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [CodeInterpreterToolAuto].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     */
+                    fun build(): CodeInterpreterToolAuto =
+                        CodeInterpreterToolAuto(
+                            type,
+                            (fileIds ?: JsonMissing.of()).map { it.toImmutable() },
+                            memoryLimit,
+                            networkPolicy,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): CodeInterpreterToolAuto = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    _type().let {
+                        if (it != JsonValue.from("auto")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    fileIds()
+                    memoryLimit().ifPresent { it.validate() }
+                    networkPolicy().ifPresent { it.validate() }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    type.let { if (it == JsonValue.from("auto")) 1 else 0 } +
+                        (fileIds.asKnown().getOrNull()?.size ?: 0) +
+                        (memoryLimit.asKnown().getOrNull()?.validity() ?: 0) +
+                        (networkPolicy.asKnown().getOrNull()?.validity() ?: 0)
+
+                /** The memory limit for the code interpreter container. */
+                class MemoryLimit
+                @JsonCreator
+                private constructor(private val value: JsonField<String>) : Enum {
+
+                    /**
+                     * Returns this class instance's raw value.
+                     *
+                     * This is usually only useful if this instance was deserialized from data that
+                     * doesn't match any known member, and you want to know that value. For example,
+                     * if the SDK is on an older version than the API, then the API may respond with
+                     * new members that the SDK is unaware of.
+                     */
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    fun _value(): JsonField<String> = value
+
+                    companion object {
+
+                        @JvmField val _1G = of("1g")
+
+                        @JvmField val _4G = of("4g")
+
+                        @JvmField val _16G = of("16g")
+
+                        @JvmField val _64G = of("64g")
+
+                        @JvmStatic fun of(value: String) = MemoryLimit(JsonField.of(value))
+                    }
+
+                    /** An enum containing [MemoryLimit]'s known values. */
+                    enum class Known {
+                        _1G,
+                        _4G,
+                        _16G,
+                        _64G,
+                    }
+
+                    /**
+                     * An enum containing [MemoryLimit]'s known values, as well as an [_UNKNOWN]
+                     * member.
+                     *
+                     * An instance of [MemoryLimit] can contain an unknown value in a couple of
+                     * cases:
+                     * - It was deserialized from data that doesn't match any known member. For
+                     *   example, if the SDK is on an older version than the API, then the API may
+                     *   respond with new members that the SDK is unaware of.
+                     * - It was constructed with an arbitrary value using the [of] method.
+                     */
+                    enum class Value {
+                        _1G,
+                        _4G,
+                        _16G,
+                        _64G,
+                        /**
+                         * An enum member indicating that [MemoryLimit] was instantiated with an
+                         * unknown value.
+                         */
+                        _UNKNOWN,
+                    }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value, or
+                     * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                     *
+                     * Use the [known] method instead if you're certain the value is always known or
+                     * if you want to throw for the unknown case.
+                     */
+                    fun value(): Value =
+                        when (this) {
+                            _1G -> Value._1G
+                            _4G -> Value._4G
+                            _16G -> Value._16G
+                            _64G -> Value._64G
+                            else -> Value._UNKNOWN
+                        }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value.
+                     *
+                     * Use the [value] method instead if you're uncertain the value is always known
+                     * and don't want to throw for the unknown case.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                     *   known member.
+                     */
+                    fun known(): Known =
+                        when (this) {
+                            _1G -> Known._1G
+                            _4G -> Known._4G
+                            _16G -> Known._16G
+                            _64G -> Known._64G
+                            else -> throw OpenAIInvalidDataException("Unknown MemoryLimit: $value")
+                        }
+
+                    /**
+                     * Returns this class instance's primitive wire representation.
+                     *
+                     * This differs from the [toString] method because that method is primarily for
+                     * debugging and generally doesn't throw.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value does not
+                     *   have the expected primitive type.
+                     */
+                    fun asString(): String =
+                        _value().asString().orElseThrow {
+                            OpenAIInvalidDataException("Value is not a String")
+                        }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): MemoryLimit = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        known()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is MemoryLimit && value == other.value
+                    }
+
+                    override fun hashCode() = value.hashCode()
+
+                    override fun toString() = value.toString()
+                }
+
+                /** Network access policy for the container. */
+                @JsonDeserialize(using = NetworkPolicy.Deserializer::class)
+                @JsonSerialize(using = NetworkPolicy.Serializer::class)
+                class NetworkPolicy
+                private constructor(
+                    private val disabled: BetaContainerNetworkPolicyDisabled? = null,
+                    private val allowlist: BetaContainerNetworkPolicyAllowlist? = null,
+                    private val _json: JsonValue? = null,
+                ) {
+
+                    fun disabled(): Optional<BetaContainerNetworkPolicyDisabled> =
+                        Optional.ofNullable(disabled)
+
+                    fun allowlist(): Optional<BetaContainerNetworkPolicyAllowlist> =
+                        Optional.ofNullable(allowlist)
+
+                    fun isDisabled(): Boolean = disabled != null
+
+                    fun isAllowlist(): Boolean = allowlist != null
+
+                    fun asDisabled(): BetaContainerNetworkPolicyDisabled =
+                        disabled.getOrThrow("disabled")
+
+                    fun asAllowlist(): BetaContainerNetworkPolicyAllowlist =
+                        allowlist.getOrThrow("allowlist")
+
+                    fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+                    /**
+                     * Maps this instance's current variant to a value of type [T] using the given
+                     * [visitor].
+                     *
+                     * Note that this method is _not_ forwards compatible with new variants from the
+                     * API, unless [visitor] overrides [Visitor.unknown]. To handle variants not
+                     * known to this version of the SDK gracefully, consider overriding
+                     * [Visitor.unknown]:
+                     * ```java
+                     * import com.openai.core.JsonValue;
+                     * import java.util.Optional;
+                     *
+                     * Optional<String> result = networkPolicy.accept(new NetworkPolicy.Visitor<Optional<String>>() {
+                     *     @Override
+                     *     public Optional<String> visitDisabled(BetaContainerNetworkPolicyDisabled disabled) {
+                     *         return Optional.of(disabled.toString());
+                     *     }
+                     *
+                     *     // ...
+                     *
+                     *     @Override
+                     *     public Optional<String> unknown(JsonValue json) {
+                     *         // Or inspect the `json`.
+                     *         return Optional.empty();
+                     *     }
+                     * });
+                     * ```
+                     *
+                     * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+                     *   [visitor] and the current variant is unknown.
+                     */
+                    fun <T> accept(visitor: Visitor<T>): T =
+                        when {
+                            disabled != null -> visitor.visitDisabled(disabled)
+                            allowlist != null -> visitor.visitAllowlist(allowlist)
+                            else -> visitor.unknown(_json)
+                        }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): NetworkPolicy = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        accept(
+                            object : Visitor<Unit> {
+                                override fun visitDisabled(
+                                    disabled: BetaContainerNetworkPolicyDisabled
+                                ) {
+                                    disabled.validate()
+                                }
+
+                                override fun visitAllowlist(
+                                    allowlist: BetaContainerNetworkPolicyAllowlist
+                                ) {
+                                    allowlist.validate()
+                                }
+                            }
+                        )
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int =
+                        accept(
+                            object : Visitor<Int> {
+                                override fun visitDisabled(
+                                    disabled: BetaContainerNetworkPolicyDisabled
+                                ) = disabled.validity()
+
+                                override fun visitAllowlist(
+                                    allowlist: BetaContainerNetworkPolicyAllowlist
+                                ) = allowlist.validity()
+
+                                override fun unknown(json: JsonValue?) = 0
+                            }
+                        )
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is NetworkPolicy &&
+                            disabled == other.disabled &&
+                            allowlist == other.allowlist
+                    }
+
+                    override fun hashCode(): Int = Objects.hash(disabled, allowlist)
+
+                    override fun toString(): String =
+                        when {
+                            disabled != null -> "NetworkPolicy{disabled=$disabled}"
+                            allowlist != null -> "NetworkPolicy{allowlist=$allowlist}"
+                            _json != null -> "NetworkPolicy{_unknown=$_json}"
+                            else -> throw IllegalStateException("Invalid NetworkPolicy")
+                        }
+
+                    companion object {
+
+                        @JvmStatic
+                        fun ofDisabled(disabled: BetaContainerNetworkPolicyDisabled) =
+                            NetworkPolicy(disabled = disabled)
+
+                        @JvmStatic
+                        fun ofAllowlist(allowlist: BetaContainerNetworkPolicyAllowlist) =
+                            NetworkPolicy(allowlist = allowlist)
+                    }
+
+                    /**
+                     * An interface that defines how to map each variant of [NetworkPolicy] to a
+                     * value of type [T].
+                     */
+                    interface Visitor<out T> {
+
+                        fun visitDisabled(disabled: BetaContainerNetworkPolicyDisabled): T
+
+                        fun visitAllowlist(allowlist: BetaContainerNetworkPolicyAllowlist): T
+
+                        /**
+                         * Maps an unknown variant of [NetworkPolicy] to a value of type [T].
+                         *
+                         * An instance of [NetworkPolicy] can contain an unknown variant if it was
+                         * deserialized from data that doesn't match any known variant. For example,
+                         * if the SDK is on an older version than the API, then the API may respond
+                         * with new variants that the SDK is unaware of.
+                         *
+                         * @throws OpenAIInvalidDataException in the default implementation.
+                         */
+                        fun unknown(json: JsonValue?): T {
+                            throw OpenAIInvalidDataException("Unknown NetworkPolicy: $json")
+                        }
+                    }
+
+                    internal class Deserializer :
+                        BaseDeserializer<NetworkPolicy>(NetworkPolicy::class) {
+
+                        override fun ObjectCodec.deserialize(node: JsonNode): NetworkPolicy {
+                            val json = JsonValue.fromJsonNode(node)
+                            val type =
+                                json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                            when (type) {
+                                "disabled" -> {
+                                    return tryDeserialize(
+                                            node,
+                                            jacksonTypeRef<BetaContainerNetworkPolicyDisabled>(),
+                                        )
+                                        ?.let { NetworkPolicy(disabled = it, _json = json) }
+                                        ?: NetworkPolicy(_json = json)
+                                }
+                                "allowlist" -> {
+                                    return tryDeserialize(
+                                            node,
+                                            jacksonTypeRef<BetaContainerNetworkPolicyAllowlist>(),
+                                        )
+                                        ?.let { NetworkPolicy(allowlist = it, _json = json) }
+                                        ?: NetworkPolicy(_json = json)
+                                }
+                            }
+
+                            return NetworkPolicy(_json = json)
+                        }
+                    }
+
+                    internal class Serializer :
+                        BaseSerializer<NetworkPolicy>(NetworkPolicy::class) {
+
+                        override fun serialize(
+                            value: NetworkPolicy,
+                            generator: JsonGenerator,
+                            provider: SerializerProvider,
+                        ) {
+                            when {
+                                value.disabled != null -> generator.writeObject(value.disabled)
+                                value.allowlist != null -> generator.writeObject(value.allowlist)
+                                value._json != null -> generator.writeObject(value._json)
+                                else -> throw IllegalStateException("Invalid NetworkPolicy")
+                            }
+                        }
+                    }
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is CodeInterpreterToolAuto &&
+                        type == other.type &&
+                        fileIds == other.fileIds &&
+                        memoryLimit == other.memoryLimit &&
+                        networkPolicy == other.networkPolicy &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(type, fileIds, memoryLimit, networkPolicy, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "CodeInterpreterToolAuto{type=$type, fileIds=$fileIds, memoryLimit=$memoryLimit, networkPolicy=$networkPolicy, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        class AllowedCaller @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val DIRECT = of("direct")
+
+                @JvmField val PROGRAMMATIC = of("programmatic")
+
+                @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+            }
+
+            /** An enum containing [AllowedCaller]'s known values. */
+            enum class Known {
+                DIRECT,
+                PROGRAMMATIC,
+            }
+
+            /**
+             * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                DIRECT,
+                PROGRAMMATIC,
+                /**
+                 * An enum member indicating that [AllowedCaller] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    DIRECT -> Value.DIRECT
+                    PROGRAMMATIC -> Value.PROGRAMMATIC
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    DIRECT -> Known.DIRECT
+                    PROGRAMMATIC -> Known.PROGRAMMATIC
+                    else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): AllowedCaller = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is AllowedCaller && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is CodeInterpreter &&
+                container == other.container &&
+                type == other.type &&
+                allowedCallers == other.allowedCallers &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(container, type, allowedCallers, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "CodeInterpreter{container=$container, type=$type, allowedCallers=$allowedCallers, additionalProperties=$additionalProperties}"
+    }
+
+    /** A tool that generates images using the GPT image models. */
+    class ImageGeneration
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val type: JsonValue,
+        private val action: JsonField<Action>,
+        private val background: JsonField<Background>,
+        private val inputFidelity: JsonField<InputFidelity>,
+        private val inputImageMask: JsonField<InputImageMask>,
+        private val model: JsonField<Model>,
+        private val moderation: JsonField<Moderation>,
+        private val outputCompression: JsonField<Long>,
+        private val outputFormat: JsonField<OutputFormat>,
+        private val partialImages: JsonField<Long>,
+        private val quality: JsonField<Quality>,
+        private val size: JsonField<Size>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
+            @JsonProperty("background")
+            @ExcludeMissing
+            background: JsonField<Background> = JsonMissing.of(),
+            @JsonProperty("input_fidelity")
+            @ExcludeMissing
+            inputFidelity: JsonField<InputFidelity> = JsonMissing.of(),
+            @JsonProperty("input_image_mask")
+            @ExcludeMissing
+            inputImageMask: JsonField<InputImageMask> = JsonMissing.of(),
+            @JsonProperty("model") @ExcludeMissing model: JsonField<Model> = JsonMissing.of(),
+            @JsonProperty("moderation")
+            @ExcludeMissing
+            moderation: JsonField<Moderation> = JsonMissing.of(),
+            @JsonProperty("output_compression")
+            @ExcludeMissing
+            outputCompression: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("output_format")
+            @ExcludeMissing
+            outputFormat: JsonField<OutputFormat> = JsonMissing.of(),
+            @JsonProperty("partial_images")
+            @ExcludeMissing
+            partialImages: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("quality") @ExcludeMissing quality: JsonField<Quality> = JsonMissing.of(),
+            @JsonProperty("size") @ExcludeMissing size: JsonField<Size> = JsonMissing.of(),
+        ) : this(
+            type,
+            action,
+            background,
+            inputFidelity,
+            inputImageMask,
+            model,
+            moderation,
+            outputCompression,
+            outputFormat,
+            partialImages,
+            quality,
+            size,
+            mutableMapOf(),
+        )
+
+        /**
+         * The type of the image generation tool. Always `image_generation`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("image_generation")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Whether to generate a new image or edit an existing image. Default: `auto`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun action(): Optional<Action> = action.getOptional("action")
+
+        /**
+         * Allows to set transparency for the background of the generated image(s). This parameter
+         * is only supported for GPT image models that support transparent backgrounds. Must be one
+         * of `transparent`, `opaque`, or `auto` (default value). When `auto` is used, the model
+         * will automatically determine the best background for the image.
+         *
+         * `gpt-image-2` and `gpt-image-2-2026-04-21` do not support transparent backgrounds.
+         * Requests with `background` set to `transparent` will return an error for these models;
+         * use `opaque` or `auto` instead.
+         *
+         * If `transparent`, the output format needs to support transparency, so it should be set to
+         * either `png` (default value) or `webp`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun background(): Optional<Background> = background.getOptional("background")
+
+        /**
+         * Control how much effort the model will exert to match the style and features, especially
+         * facial features, of input images. This parameter is only supported for `gpt-image-1` and
+         * `gpt-image-1.5` and later models, unsupported for `gpt-image-1-mini`. Supports `high` and
+         * `low`. Defaults to `low`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun inputFidelity(): Optional<InputFidelity> = inputFidelity.getOptional("input_fidelity")
+
+        /**
+         * Optional mask for inpainting. Contains `image_url` (string, optional) and `file_id`
+         * (string, optional).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun inputImageMask(): Optional<InputImageMask> =
+            inputImageMask.getOptional("input_image_mask")
+
+        /**
+         * The image generation model to use. Default: `gpt-image-1`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun model(): Optional<Model> = model.getOptional("model")
+
+        /**
+         * Moderation level for the generated image. Default: `auto`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun moderation(): Optional<Moderation> = moderation.getOptional("moderation")
+
+        /**
+         * Compression level for the output image. Default: 100.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun outputCompression(): Optional<Long> =
+            outputCompression.getOptional("output_compression")
+
+        /**
+         * The output format of the generated image. One of `png`, `webp`, or `jpeg`. Default:
+         * `png`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun outputFormat(): Optional<OutputFormat> = outputFormat.getOptional("output_format")
+
+        /**
+         * Number of partial images to generate in streaming mode, from 0 (default value) to 3.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun partialImages(): Optional<Long> = partialImages.getOptional("partial_images")
+
+        /**
+         * The quality of the generated image. One of `low`, `medium`, `high`, or `auto`. Default:
+         * `auto`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun quality(): Optional<Quality> = quality.getOptional("quality")
+
+        /**
+         * The size of the generated images. For `gpt-image-2` and `gpt-image-2-2026-04-21`,
+         * arbitrary resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
+         * Width and height must both be divisible by 16 and the requested aspect ratio must be
+         * between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and the maximum
+         * supported resolution is `3840x2160`. The requested size must also satisfy the model's
+         * current pixel and edge limits. The standard sizes `1024x1024`, `1536x1024`, and
+         * `1024x1536` are supported by the GPT image models; `auto` is supported for models that
+         * allow automatic sizing. For `dall-e-2`, use one of `256x256`, `512x512`, or `1024x1024`.
+         * For `dall-e-3`, use one of `1024x1024`, `1792x1024`, or `1024x1792`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun size(): Optional<Size> = size.getOptional("size")
+
+        /**
+         * Returns the raw JSON value of [action].
+         *
+         * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+
+        /**
+         * Returns the raw JSON value of [background].
+         *
+         * Unlike [background], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("background")
+        @ExcludeMissing
+        fun _background(): JsonField<Background> = background
+
+        /**
+         * Returns the raw JSON value of [inputFidelity].
+         *
+         * Unlike [inputFidelity], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("input_fidelity")
+        @ExcludeMissing
+        fun _inputFidelity(): JsonField<InputFidelity> = inputFidelity
+
+        /**
+         * Returns the raw JSON value of [inputImageMask].
+         *
+         * Unlike [inputImageMask], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("input_image_mask")
+        @ExcludeMissing
+        fun _inputImageMask(): JsonField<InputImageMask> = inputImageMask
+
+        /**
+         * Returns the raw JSON value of [model].
+         *
+         * Unlike [model], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("model") @ExcludeMissing fun _model(): JsonField<Model> = model
+
+        /**
+         * Returns the raw JSON value of [moderation].
+         *
+         * Unlike [moderation], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("moderation")
+        @ExcludeMissing
+        fun _moderation(): JsonField<Moderation> = moderation
+
+        /**
+         * Returns the raw JSON value of [outputCompression].
+         *
+         * Unlike [outputCompression], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("output_compression")
+        @ExcludeMissing
+        fun _outputCompression(): JsonField<Long> = outputCompression
+
+        /**
+         * Returns the raw JSON value of [outputFormat].
+         *
+         * Unlike [outputFormat], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("output_format")
+        @ExcludeMissing
+        fun _outputFormat(): JsonField<OutputFormat> = outputFormat
+
+        /**
+         * Returns the raw JSON value of [partialImages].
+         *
+         * Unlike [partialImages], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("partial_images")
+        @ExcludeMissing
+        fun _partialImages(): JsonField<Long> = partialImages
+
+        /**
+         * Returns the raw JSON value of [quality].
+         *
+         * Unlike [quality], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("quality") @ExcludeMissing fun _quality(): JsonField<Quality> = quality
+
+        /**
+         * Returns the raw JSON value of [size].
+         *
+         * Unlike [size], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("size") @ExcludeMissing fun _size(): JsonField<Size> = size
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [ImageGeneration]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ImageGeneration]. */
+        class Builder internal constructor() {
+
+            private var type: JsonValue = JsonValue.from("image_generation")
+            private var action: JsonField<Action> = JsonMissing.of()
+            private var background: JsonField<Background> = JsonMissing.of()
+            private var inputFidelity: JsonField<InputFidelity> = JsonMissing.of()
+            private var inputImageMask: JsonField<InputImageMask> = JsonMissing.of()
+            private var model: JsonField<Model> = JsonMissing.of()
+            private var moderation: JsonField<Moderation> = JsonMissing.of()
+            private var outputCompression: JsonField<Long> = JsonMissing.of()
+            private var outputFormat: JsonField<OutputFormat> = JsonMissing.of()
+            private var partialImages: JsonField<Long> = JsonMissing.of()
+            private var quality: JsonField<Quality> = JsonMissing.of()
+            private var size: JsonField<Size> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(imageGeneration: ImageGeneration) = apply {
+                type = imageGeneration.type
+                action = imageGeneration.action
+                background = imageGeneration.background
+                inputFidelity = imageGeneration.inputFidelity
+                inputImageMask = imageGeneration.inputImageMask
+                model = imageGeneration.model
+                moderation = imageGeneration.moderation
+                outputCompression = imageGeneration.outputCompression
+                outputFormat = imageGeneration.outputFormat
+                partialImages = imageGeneration.partialImages
+                quality = imageGeneration.quality
+                size = imageGeneration.size
+                additionalProperties = imageGeneration.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("image_generation")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** Whether to generate a new image or edit an existing image. Default: `auto`. */
+            fun action(action: Action) = action(JsonField.of(action))
+
+            /**
+             * Sets [Builder.action] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.action] with a well-typed [Action] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun action(action: JsonField<Action>) = apply { this.action = action }
+
+            /**
+             * Allows to set transparency for the background of the generated image(s). This
+             * parameter is only supported for GPT image models that support transparent
+             * backgrounds. Must be one of `transparent`, `opaque`, or `auto` (default value). When
+             * `auto` is used, the model will automatically determine the best background for the
+             * image.
+             *
+             * `gpt-image-2` and `gpt-image-2-2026-04-21` do not support transparent backgrounds.
+             * Requests with `background` set to `transparent` will return an error for these
+             * models; use `opaque` or `auto` instead.
+             *
+             * If `transparent`, the output format needs to support transparency, so it should be
+             * set to either `png` (default value) or `webp`.
+             */
+            fun background(background: Background) = background(JsonField.of(background))
+
+            /**
+             * Sets [Builder.background] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.background] with a well-typed [Background] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun background(background: JsonField<Background>) = apply {
+                this.background = background
+            }
+
+            /**
+             * Control how much effort the model will exert to match the style and features,
+             * especially facial features, of input images. This parameter is only supported for
+             * `gpt-image-1` and `gpt-image-1.5` and later models, unsupported for
+             * `gpt-image-1-mini`. Supports `high` and `low`. Defaults to `low`.
+             */
+            fun inputFidelity(inputFidelity: InputFidelity?) =
+                inputFidelity(JsonField.ofNullable(inputFidelity))
+
+            /** Alias for calling [Builder.inputFidelity] with `inputFidelity.orElse(null)`. */
+            fun inputFidelity(inputFidelity: Optional<InputFidelity>) =
+                inputFidelity(inputFidelity.getOrNull())
+
+            /**
+             * Sets [Builder.inputFidelity] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.inputFidelity] with a well-typed [InputFidelity]
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            fun inputFidelity(inputFidelity: JsonField<InputFidelity>) = apply {
+                this.inputFidelity = inputFidelity
+            }
+
+            /**
+             * Optional mask for inpainting. Contains `image_url` (string, optional) and `file_id`
+             * (string, optional).
+             */
+            fun inputImageMask(inputImageMask: InputImageMask) =
+                inputImageMask(JsonField.of(inputImageMask))
+
+            /**
+             * Sets [Builder.inputImageMask] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.inputImageMask] with a well-typed [InputImageMask]
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            fun inputImageMask(inputImageMask: JsonField<InputImageMask>) = apply {
+                this.inputImageMask = inputImageMask
+            }
+
+            /** The image generation model to use. Default: `gpt-image-1`. */
+            fun model(model: Model) = model(JsonField.of(model))
+
+            /**
+             * Sets [Builder.model] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.model] with a well-typed [Model] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun model(model: JsonField<Model>) = apply { this.model = model }
+
+            /**
+             * Sets [model] to an arbitrary [String].
+             *
+             * You should usually call [model] with a well-typed [Model] constant instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun model(value: String) = model(Model.of(value))
+
+            /** Moderation level for the generated image. Default: `auto`. */
+            fun moderation(moderation: Moderation) = moderation(JsonField.of(moderation))
+
+            /**
+             * Sets [Builder.moderation] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.moderation] with a well-typed [Moderation] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun moderation(moderation: JsonField<Moderation>) = apply {
+                this.moderation = moderation
+            }
+
+            /** Compression level for the output image. Default: 100. */
+            fun outputCompression(outputCompression: Long) =
+                outputCompression(JsonField.of(outputCompression))
+
+            /**
+             * Sets [Builder.outputCompression] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.outputCompression] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun outputCompression(outputCompression: JsonField<Long>) = apply {
+                this.outputCompression = outputCompression
+            }
+
+            /**
+             * The output format of the generated image. One of `png`, `webp`, or `jpeg`. Default:
+             * `png`.
+             */
+            fun outputFormat(outputFormat: OutputFormat) = outputFormat(JsonField.of(outputFormat))
+
+            /**
+             * Sets [Builder.outputFormat] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.outputFormat] with a well-typed [OutputFormat] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun outputFormat(outputFormat: JsonField<OutputFormat>) = apply {
+                this.outputFormat = outputFormat
+            }
+
+            /**
+             * Number of partial images to generate in streaming mode, from 0 (default value) to 3.
+             */
+            fun partialImages(partialImages: Long) = partialImages(JsonField.of(partialImages))
+
+            /**
+             * Sets [Builder.partialImages] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.partialImages] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun partialImages(partialImages: JsonField<Long>) = apply {
+                this.partialImages = partialImages
+            }
+
+            /**
+             * The quality of the generated image. One of `low`, `medium`, `high`, or `auto`.
+             * Default: `auto`.
+             */
+            fun quality(quality: Quality) = quality(JsonField.of(quality))
+
+            /**
+             * Sets [Builder.quality] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.quality] with a well-typed [Quality] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun quality(quality: JsonField<Quality>) = apply { this.quality = quality }
+
+            /**
+             * The size of the generated images. For `gpt-image-2` and `gpt-image-2-2026-04-21`,
+             * arbitrary resolutions are supported as `WIDTHxHEIGHT` strings, for example
+             * `1536x864`. Width and height must both be divisible by 16 and the requested aspect
+             * ratio must be between 1:3 and 3:1. Resolutions above `2560x1440` are experimental,
+             * and the maximum supported resolution is `3840x2160`. The requested size must also
+             * satisfy the model's current pixel and edge limits. The standard sizes `1024x1024`,
+             * `1536x1024`, and `1024x1536` are supported by the GPT image models; `auto` is
+             * supported for models that allow automatic sizing. For `dall-e-2`, use one of
+             * `256x256`, `512x512`, or `1024x1024`. For `dall-e-3`, use one of `1024x1024`,
+             * `1792x1024`, or `1024x1792`.
+             */
+            fun size(size: Size) = size(JsonField.of(size))
+
+            /**
+             * Sets [Builder.size] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.size] with a well-typed [Size] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun size(size: JsonField<Size>) = apply { this.size = size }
+
+            /**
+             * Sets [size] to an arbitrary [String].
+             *
+             * You should usually call [size] with a well-typed [Size] constant instead. This method
+             * is primarily for setting the field to an undocumented or not yet supported value.
+             */
+            fun size(value: String) = size(Size.of(value))
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ImageGeneration].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): ImageGeneration =
+                ImageGeneration(
+                    type,
+                    action,
+                    background,
+                    inputFidelity,
+                    inputImageMask,
+                    model,
+                    moderation,
+                    outputCompression,
+                    outputFormat,
+                    partialImages,
+                    quality,
+                    size,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ImageGeneration = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _type().let {
+                if (it != JsonValue.from("image_generation")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            action().ifPresent { it.validate() }
+            background().ifPresent { it.validate() }
+            inputFidelity().ifPresent { it.validate() }
+            inputImageMask().ifPresent { it.validate() }
+            model()
+            moderation().ifPresent { it.validate() }
+            outputCompression()
+            outputFormat().ifPresent { it.validate() }
+            partialImages()
+            quality().ifPresent { it.validate() }
+            size()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            type.let { if (it == JsonValue.from("image_generation")) 1 else 0 } +
+                (action.asKnown().getOrNull()?.validity() ?: 0) +
+                (background.asKnown().getOrNull()?.validity() ?: 0) +
+                (inputFidelity.asKnown().getOrNull()?.validity() ?: 0) +
+                (inputImageMask.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (model.asKnown().isPresent) 1 else 0) +
+                (moderation.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (outputCompression.asKnown().isPresent) 1 else 0) +
+                (outputFormat.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (partialImages.asKnown().isPresent) 1 else 0) +
+                (quality.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (size.asKnown().isPresent) 1 else 0)
+
+        /** Whether to generate a new image or edit an existing image. Default: `auto`. */
+        class Action @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val GENERATE = of("generate")
+
+                @JvmField val EDIT = of("edit")
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmStatic fun of(value: String) = Action(JsonField.of(value))
+            }
+
+            /** An enum containing [Action]'s known values. */
+            enum class Known {
+                GENERATE,
+                EDIT,
+                AUTO,
+            }
+
+            /**
+             * An enum containing [Action]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Action] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                GENERATE,
+                EDIT,
+                AUTO,
+                /**
+                 * An enum member indicating that [Action] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    GENERATE -> Value.GENERATE
+                    EDIT -> Value.EDIT
+                    AUTO -> Value.AUTO
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    GENERATE -> Known.GENERATE
+                    EDIT -> Known.EDIT
+                    AUTO -> Known.AUTO
+                    else -> throw OpenAIInvalidDataException("Unknown Action: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Action = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Action && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * Allows to set transparency for the background of the generated image(s). This parameter
+         * is only supported for GPT image models that support transparent backgrounds. Must be one
+         * of `transparent`, `opaque`, or `auto` (default value). When `auto` is used, the model
+         * will automatically determine the best background for the image.
+         *
+         * `gpt-image-2` and `gpt-image-2-2026-04-21` do not support transparent backgrounds.
+         * Requests with `background` set to `transparent` will return an error for these models;
+         * use `opaque` or `auto` instead.
+         *
+         * If `transparent`, the output format needs to support transparency, so it should be set to
+         * either `png` (default value) or `webp`.
+         */
+        class Background @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val TRANSPARENT = of("transparent")
+
+                @JvmField val OPAQUE = of("opaque")
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmStatic fun of(value: String) = Background(JsonField.of(value))
+            }
+
+            /** An enum containing [Background]'s known values. */
+            enum class Known {
+                TRANSPARENT,
+                OPAQUE,
+                AUTO,
+            }
+
+            /**
+             * An enum containing [Background]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Background] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                TRANSPARENT,
+                OPAQUE,
+                AUTO,
+                /**
+                 * An enum member indicating that [Background] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    TRANSPARENT -> Value.TRANSPARENT
+                    OPAQUE -> Value.OPAQUE
+                    AUTO -> Value.AUTO
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    TRANSPARENT -> Known.TRANSPARENT
+                    OPAQUE -> Known.OPAQUE
+                    AUTO -> Known.AUTO
+                    else -> throw OpenAIInvalidDataException("Unknown Background: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Background = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Background && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * Control how much effort the model will exert to match the style and features, especially
+         * facial features, of input images. This parameter is only supported for `gpt-image-1` and
+         * `gpt-image-1.5` and later models, unsupported for `gpt-image-1-mini`. Supports `high` and
+         * `low`. Defaults to `low`.
+         */
+        class InputFidelity @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val HIGH = of("high")
+
+                @JvmField val LOW = of("low")
+
+                @JvmStatic fun of(value: String) = InputFidelity(JsonField.of(value))
+            }
+
+            /** An enum containing [InputFidelity]'s known values. */
+            enum class Known {
+                HIGH,
+                LOW,
+            }
+
+            /**
+             * An enum containing [InputFidelity]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [InputFidelity] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                HIGH,
+                LOW,
+                /**
+                 * An enum member indicating that [InputFidelity] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    HIGH -> Value.HIGH
+                    LOW -> Value.LOW
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    HIGH -> Known.HIGH
+                    LOW -> Known.LOW
+                    else -> throw OpenAIInvalidDataException("Unknown InputFidelity: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): InputFidelity = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is InputFidelity && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * Optional mask for inpainting. Contains `image_url` (string, optional) and `file_id`
+         * (string, optional).
+         */
+        class InputImageMask
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val fileId: JsonField<String>,
+            private val imageUrl: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("file_id")
+                @ExcludeMissing
+                fileId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("image_url")
+                @ExcludeMissing
+                imageUrl: JsonField<String> = JsonMissing.of(),
+            ) : this(fileId, imageUrl, mutableMapOf())
+
+            /**
+             * File ID for the mask image.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun fileId(): Optional<String> = fileId.getOptional("file_id")
+
+            /**
+             * Base64-encoded mask image.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun imageUrl(): Optional<String> = imageUrl.getOptional("image_url")
+
+            /**
+             * Returns the raw JSON value of [fileId].
+             *
+             * Unlike [fileId], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("file_id") @ExcludeMissing fun _fileId(): JsonField<String> = fileId
+
+            /**
+             * Returns the raw JSON value of [imageUrl].
+             *
+             * Unlike [imageUrl], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("image_url") @ExcludeMissing fun _imageUrl(): JsonField<String> = imageUrl
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /** Returns a mutable builder for constructing an instance of [InputImageMask]. */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [InputImageMask]. */
+            class Builder internal constructor() {
+
+                private var fileId: JsonField<String> = JsonMissing.of()
+                private var imageUrl: JsonField<String> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(inputImageMask: InputImageMask) = apply {
+                    fileId = inputImageMask.fileId
+                    imageUrl = inputImageMask.imageUrl
+                    additionalProperties = inputImageMask.additionalProperties.toMutableMap()
+                }
+
+                /** File ID for the mask image. */
+                fun fileId(fileId: String) = fileId(JsonField.of(fileId))
+
+                /**
+                 * Sets [Builder.fileId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.fileId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun fileId(fileId: JsonField<String>) = apply { this.fileId = fileId }
+
+                /** Base64-encoded mask image. */
+                fun imageUrl(imageUrl: String) = imageUrl(JsonField.of(imageUrl))
+
+                /**
+                 * Sets [Builder.imageUrl] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.imageUrl] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun imageUrl(imageUrl: JsonField<String>) = apply { this.imageUrl = imageUrl }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [InputImageMask].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): InputImageMask =
+                    InputImageMask(fileId, imageUrl, additionalProperties.toMutableMap())
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): InputImageMask = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                fileId()
+                imageUrl()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (fileId.asKnown().isPresent) 1 else 0) +
+                    (if (imageUrl.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is InputImageMask &&
+                    fileId == other.fileId &&
+                    imageUrl == other.imageUrl &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(fileId, imageUrl, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "InputImageMask{fileId=$fileId, imageUrl=$imageUrl, additionalProperties=$additionalProperties}"
+        }
+
+        /** The image generation model to use. Default: `gpt-image-1`. */
+        class Model @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val GPT_IMAGE_1 = of("gpt-image-1")
+
+                @JvmField val GPT_IMAGE_1_MINI = of("gpt-image-1-mini")
+
+                @JvmField val GPT_IMAGE_2 = of("gpt-image-2")
+
+                @JvmField val GPT_IMAGE_2_2026_04_21 = of("gpt-image-2-2026-04-21")
+
+                @JvmField val GPT_IMAGE_1_5 = of("gpt-image-1.5")
+
+                @JvmField val CHATGPT_IMAGE_LATEST = of("chatgpt-image-latest")
+
+                @JvmStatic fun of(value: String) = Model(JsonField.of(value))
+            }
+
+            /** An enum containing [Model]'s known values. */
+            enum class Known {
+                GPT_IMAGE_1,
+                GPT_IMAGE_1_MINI,
+                GPT_IMAGE_2,
+                GPT_IMAGE_2_2026_04_21,
+                GPT_IMAGE_1_5,
+                CHATGPT_IMAGE_LATEST,
+            }
+
+            /**
+             * An enum containing [Model]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Model] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                GPT_IMAGE_1,
+                GPT_IMAGE_1_MINI,
+                GPT_IMAGE_2,
+                GPT_IMAGE_2_2026_04_21,
+                GPT_IMAGE_1_5,
+                CHATGPT_IMAGE_LATEST,
+                /**
+                 * An enum member indicating that [Model] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    GPT_IMAGE_1 -> Value.GPT_IMAGE_1
+                    GPT_IMAGE_1_MINI -> Value.GPT_IMAGE_1_MINI
+                    GPT_IMAGE_2 -> Value.GPT_IMAGE_2
+                    GPT_IMAGE_2_2026_04_21 -> Value.GPT_IMAGE_2_2026_04_21
+                    GPT_IMAGE_1_5 -> Value.GPT_IMAGE_1_5
+                    CHATGPT_IMAGE_LATEST -> Value.CHATGPT_IMAGE_LATEST
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    GPT_IMAGE_1 -> Known.GPT_IMAGE_1
+                    GPT_IMAGE_1_MINI -> Known.GPT_IMAGE_1_MINI
+                    GPT_IMAGE_2 -> Known.GPT_IMAGE_2
+                    GPT_IMAGE_2_2026_04_21 -> Known.GPT_IMAGE_2_2026_04_21
+                    GPT_IMAGE_1_5 -> Known.GPT_IMAGE_1_5
+                    CHATGPT_IMAGE_LATEST -> Known.CHATGPT_IMAGE_LATEST
+                    else -> throw OpenAIInvalidDataException("Unknown Model: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Model = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Model && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** Moderation level for the generated image. Default: `auto`. */
+        class Moderation @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmField val LOW = of("low")
+
+                @JvmStatic fun of(value: String) = Moderation(JsonField.of(value))
+            }
+
+            /** An enum containing [Moderation]'s known values. */
+            enum class Known {
+                AUTO,
+                LOW,
+            }
+
+            /**
+             * An enum containing [Moderation]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Moderation] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                AUTO,
+                LOW,
+                /**
+                 * An enum member indicating that [Moderation] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    AUTO -> Value.AUTO
+                    LOW -> Value.LOW
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    AUTO -> Known.AUTO
+                    LOW -> Known.LOW
+                    else -> throw OpenAIInvalidDataException("Unknown Moderation: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Moderation = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Moderation && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * The output format of the generated image. One of `png`, `webp`, or `jpeg`. Default:
+         * `png`.
+         */
+        class OutputFormat @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val PNG = of("png")
+
+                @JvmField val WEBP = of("webp")
+
+                @JvmField val JPEG = of("jpeg")
+
+                @JvmStatic fun of(value: String) = OutputFormat(JsonField.of(value))
+            }
+
+            /** An enum containing [OutputFormat]'s known values. */
+            enum class Known {
+                PNG,
+                WEBP,
+                JPEG,
+            }
+
+            /**
+             * An enum containing [OutputFormat]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [OutputFormat] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                PNG,
+                WEBP,
+                JPEG,
+                /**
+                 * An enum member indicating that [OutputFormat] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    PNG -> Value.PNG
+                    WEBP -> Value.WEBP
+                    JPEG -> Value.JPEG
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    PNG -> Known.PNG
+                    WEBP -> Known.WEBP
+                    JPEG -> Known.JPEG
+                    else -> throw OpenAIInvalidDataException("Unknown OutputFormat: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): OutputFormat = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is OutputFormat && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * The quality of the generated image. One of `low`, `medium`, `high`, or `auto`. Default:
+         * `auto`.
+         */
+        class Quality @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val LOW = of("low")
+
+                @JvmField val MEDIUM = of("medium")
+
+                @JvmField val HIGH = of("high")
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmStatic fun of(value: String) = Quality(JsonField.of(value))
+            }
+
+            /** An enum containing [Quality]'s known values. */
+            enum class Known {
+                LOW,
+                MEDIUM,
+                HIGH,
+                AUTO,
+            }
+
+            /**
+             * An enum containing [Quality]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Quality] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                LOW,
+                MEDIUM,
+                HIGH,
+                AUTO,
+                /**
+                 * An enum member indicating that [Quality] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    LOW -> Value.LOW
+                    MEDIUM -> Value.MEDIUM
+                    HIGH -> Value.HIGH
+                    AUTO -> Value.AUTO
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    LOW -> Known.LOW
+                    MEDIUM -> Known.MEDIUM
+                    HIGH -> Known.HIGH
+                    AUTO -> Known.AUTO
+                    else -> throw OpenAIInvalidDataException("Unknown Quality: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Quality = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Quality && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * The size of the generated images. For `gpt-image-2` and `gpt-image-2-2026-04-21`,
+         * arbitrary resolutions are supported as `WIDTHxHEIGHT` strings, for example `1536x864`.
+         * Width and height must both be divisible by 16 and the requested aspect ratio must be
+         * between 1:3 and 3:1. Resolutions above `2560x1440` are experimental, and the maximum
+         * supported resolution is `3840x2160`. The requested size must also satisfy the model's
+         * current pixel and edge limits. The standard sizes `1024x1024`, `1536x1024`, and
+         * `1024x1536` are supported by the GPT image models; `auto` is supported for models that
+         * allow automatic sizing. For `dall-e-2`, use one of `256x256`, `512x512`, or `1024x1024`.
+         * For `dall-e-3`, use one of `1024x1024`, `1792x1024`, or `1024x1792`.
+         */
+        class Size @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val _1024X1024 = of("1024x1024")
+
+                @JvmField val _1024X1536 = of("1024x1536")
+
+                @JvmField val _1536X1024 = of("1536x1024")
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmStatic fun of(value: String) = Size(JsonField.of(value))
+            }
+
+            /** An enum containing [Size]'s known values. */
+            enum class Known {
+                _1024X1024,
+                _1024X1536,
+                _1536X1024,
+                AUTO,
+            }
+
+            /**
+             * An enum containing [Size]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Size] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                _1024X1024,
+                _1024X1536,
+                _1536X1024,
+                AUTO,
+                /** An enum member indicating that [Size] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    _1024X1024 -> Value._1024X1024
+                    _1024X1536 -> Value._1024X1536
+                    _1536X1024 -> Value._1536X1024
+                    AUTO -> Value.AUTO
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    _1024X1024 -> Known._1024X1024
+                    _1024X1536 -> Known._1024X1536
+                    _1536X1024 -> Known._1536X1024
+                    AUTO -> Known.AUTO
+                    else -> throw OpenAIInvalidDataException("Unknown Size: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Size = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Size && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ImageGeneration &&
+                type == other.type &&
+                action == other.action &&
+                background == other.background &&
+                inputFidelity == other.inputFidelity &&
+                inputImageMask == other.inputImageMask &&
+                model == other.model &&
+                moderation == other.moderation &&
+                outputCompression == other.outputCompression &&
+                outputFormat == other.outputFormat &&
+                partialImages == other.partialImages &&
+                quality == other.quality &&
+                size == other.size &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                type,
+                action,
+                background,
+                inputFidelity,
+                inputImageMask,
+                model,
+                moderation,
+                outputCompression,
+                outputFormat,
+                partialImages,
+                quality,
+                size,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ImageGeneration{type=$type, action=$action, background=$background, inputFidelity=$inputFidelity, inputImageMask=$inputImageMask, model=$model, moderation=$moderation, outputCompression=$outputCompression, outputFormat=$outputFormat, partialImages=$partialImages, quality=$quality, size=$size, additionalProperties=$additionalProperties}"
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceAllowed.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceAllowed.kt
new file mode 100644
index 000000000..8a7c7f461
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceAllowed.kt
@@ -0,0 +1,556 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import kotlin.jvm.optionals.getOrNull
+
+/** Constrains the tools available to the model to a pre-defined set. */
+class BetaToolChoiceAllowed
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val mode: JsonField<Mode>,
+    private val tools: JsonField<List<Tool>>,
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of(),
+        @JsonProperty("tools") @ExcludeMissing tools: JsonField<List<Tool>> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+    ) : this(mode, tools, type, mutableMapOf())
+
+    /**
+     * Constrains the tools available to the model to a pre-defined set.
+     *
+     * `auto` allows the model to pick from among the allowed tools and generate a message.
+     *
+     * `required` requires the model to call one or more of the allowed tools.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun mode(): Mode = mode.getRequired("mode")
+
+    /**
+     * A list of tool definitions that the model should be allowed to call.
+     *
+     * For the Responses API, the list of tool definitions might look like:
+     * ```json
+     * [
+     *   { "type": "function", "name": "get_weather" },
+     *   { "type": "mcp", "server_label": "deepwiki" },
+     *   { "type": "image_generation" }
+     * ]
+     * ```
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun tools(): List<Tool> = tools.getRequired("tools")
+
+    /**
+     * Allowed tool configuration type. Always `allowed_tools`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("allowed_tools")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Returns the raw JSON value of [mode].
+     *
+     * Unlike [mode], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+    /**
+     * Returns the raw JSON value of [tools].
+     *
+     * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<Tool>> = tools
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaToolChoiceAllowed].
+         *
+         * The following fields are required:
+         * ```java
+         * .mode()
+         * .tools()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaToolChoiceAllowed]. */
+    class Builder internal constructor() {
+
+        private var mode: JsonField<Mode>? = null
+        private var tools: JsonField<MutableList<Tool>>? = null
+        private var type: JsonValue = JsonValue.from("allowed_tools")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaToolChoiceAllowed: BetaToolChoiceAllowed) = apply {
+            mode = betaToolChoiceAllowed.mode
+            tools = betaToolChoiceAllowed.tools.map { it.toMutableList() }
+            type = betaToolChoiceAllowed.type
+            additionalProperties = betaToolChoiceAllowed.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * Constrains the tools available to the model to a pre-defined set.
+         *
+         * `auto` allows the model to pick from among the allowed tools and generate a message.
+         *
+         * `required` requires the model to call one or more of the allowed tools.
+         */
+        fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+        /**
+         * Sets [Builder.mode] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.mode] with a well-typed [Mode] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+        /**
+         * A list of tool definitions that the model should be allowed to call.
+         *
+         * For the Responses API, the list of tool definitions might look like:
+         * ```json
+         * [
+         *   { "type": "function", "name": "get_weather" },
+         *   { "type": "mcp", "server_label": "deepwiki" },
+         *   { "type": "image_generation" }
+         * ]
+         * ```
+         */
+        fun tools(tools: List<Tool>) = tools(JsonField.of(tools))
+
+        /**
+         * Sets [Builder.tools] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.tools] with a well-typed `List<Tool>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun tools(tools: JsonField<List<Tool>>) = apply {
+            this.tools = tools.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [Tool] to [tools].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addTool(tool: Tool) = apply {
+            tools =
+                (tools ?: JsonField.of(mutableListOf())).also { checkKnown("tools", it).add(tool) }
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("allowed_tools")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaToolChoiceAllowed].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .mode()
+         * .tools()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaToolChoiceAllowed =
+            BetaToolChoiceAllowed(
+                checkRequired("mode", mode),
+                checkRequired("tools", tools).map { it.toImmutable() },
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaToolChoiceAllowed = apply {
+        if (validated) {
+            return@apply
+        }
+
+        mode().validate()
+        tools().forEach { it.validate() }
+        _type().let {
+            if (it != JsonValue.from("allowed_tools")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (mode.asKnown().getOrNull()?.validity() ?: 0) +
+            (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            type.let { if (it == JsonValue.from("allowed_tools")) 1 else 0 }
+
+    /**
+     * Constrains the tools available to the model to a pre-defined set.
+     *
+     * `auto` allows the model to pick from among the allowed tools and generate a message.
+     *
+     * `required` requires the model to call one or more of the allowed tools.
+     */
+    class Mode @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val AUTO = of("auto")
+
+            @JvmField val REQUIRED = of("required")
+
+            @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+        }
+
+        /** An enum containing [Mode]'s known values. */
+        enum class Known {
+            AUTO,
+            REQUIRED,
+        }
+
+        /**
+         * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Mode] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            AUTO,
+            REQUIRED,
+            /** An enum member indicating that [Mode] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                AUTO -> Value.AUTO
+                REQUIRED -> Value.REQUIRED
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                AUTO -> Known.AUTO
+                REQUIRED -> Known.REQUIRED
+                else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Mode = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Mode && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** A tool definition that the model should be allowed to call. */
+    class Tool
+    @JsonCreator
+    private constructor(
+        @com.fasterxml.jackson.annotation.JsonValue
+        private val additionalProperties: Map<String, JsonValue>
+    ) {
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Tool]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Tool]. */
+        class Builder internal constructor() {
+
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(tool: Tool) = apply {
+                additionalProperties = tool.additionalProperties.toMutableMap()
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Tool].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Tool = Tool(additionalProperties.toImmutable())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Tool = apply {
+            if (validated) {
+                return@apply
+            }
+
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            additionalProperties.count { (_, value) -> !value.isNull() && !value.isMissing() }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Tool && additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() = "Tool{additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaToolChoiceAllowed &&
+            mode == other.mode &&
+            tools == other.tools &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(mode, tools, type, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaToolChoiceAllowed{mode=$mode, tools=$tools, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceApplyPatch.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceApplyPatch.kt
new file mode 100644
index 000000000..34eaac269
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceApplyPatch.kt
@@ -0,0 +1,169 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+
+/** Forces the model to call the apply_patch tool when executing a tool call. */
+class BetaToolChoiceApplyPatch
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of()
+    ) : this(type, mutableMapOf())
+
+    /**
+     * The tool to call. Always `apply_patch`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("apply_patch")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [BetaToolChoiceApplyPatch]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaToolChoiceApplyPatch]. */
+    class Builder internal constructor() {
+
+        private var type: JsonValue = JsonValue.from("apply_patch")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch) = apply {
+            type = betaToolChoiceApplyPatch.type
+            additionalProperties = betaToolChoiceApplyPatch.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("apply_patch")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaToolChoiceApplyPatch].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): BetaToolChoiceApplyPatch =
+            BetaToolChoiceApplyPatch(type, additionalProperties.toMutableMap())
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaToolChoiceApplyPatch = apply {
+        if (validated) {
+            return@apply
+        }
+
+        _type().let {
+            if (it != JsonValue.from("apply_patch")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int = type.let { if (it == JsonValue.from("apply_patch")) 1 else 0 }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaToolChoiceApplyPatch &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(type, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaToolChoiceApplyPatch{type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceCustom.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceCustom.kt
new file mode 100644
index 000000000..6edc79056
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceCustom.kt
@@ -0,0 +1,223 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+
+/** Use this option to force the model to call a specific custom tool. */
+class BetaToolChoiceCustom
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val name: JsonField<String>,
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+    ) : this(name, type, mutableMapOf())
+
+    /**
+     * The name of the custom tool to call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun name(): String = name.getRequired("name")
+
+    /**
+     * For custom tool calling, the type is always `custom`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("custom")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaToolChoiceCustom].
+         *
+         * The following fields are required:
+         * ```java
+         * .name()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaToolChoiceCustom]. */
+    class Builder internal constructor() {
+
+        private var name: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("custom")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaToolChoiceCustom: BetaToolChoiceCustom) = apply {
+            name = betaToolChoiceCustom.name
+            type = betaToolChoiceCustom.type
+            additionalProperties = betaToolChoiceCustom.additionalProperties.toMutableMap()
+        }
+
+        /** The name of the custom tool to call. */
+        fun name(name: String) = name(JsonField.of(name))
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("custom")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaToolChoiceCustom].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .name()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaToolChoiceCustom =
+            BetaToolChoiceCustom(
+                checkRequired("name", name),
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaToolChoiceCustom = apply {
+        if (validated) {
+            return@apply
+        }
+
+        name()
+        _type().let {
+            if (it != JsonValue.from("custom")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (name.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("custom")) 1 else 0 }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaToolChoiceCustom &&
+            name == other.name &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(name, type, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaToolChoiceCustom{name=$name, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceFunction.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceFunction.kt
new file mode 100644
index 000000000..2cb9f8a09
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceFunction.kt
@@ -0,0 +1,223 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+
+/** Use this option to force the model to call a specific function. */
+class BetaToolChoiceFunction
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val name: JsonField<String>,
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+    ) : this(name, type, mutableMapOf())
+
+    /**
+     * The name of the function to call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun name(): String = name.getRequired("name")
+
+    /**
+     * For function calling, the type is always `function`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("function")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaToolChoiceFunction].
+         *
+         * The following fields are required:
+         * ```java
+         * .name()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaToolChoiceFunction]. */
+    class Builder internal constructor() {
+
+        private var name: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("function")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaToolChoiceFunction: BetaToolChoiceFunction) = apply {
+            name = betaToolChoiceFunction.name
+            type = betaToolChoiceFunction.type
+            additionalProperties = betaToolChoiceFunction.additionalProperties.toMutableMap()
+        }
+
+        /** The name of the function to call. */
+        fun name(name: String) = name(JsonField.of(name))
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("function")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaToolChoiceFunction].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .name()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaToolChoiceFunction =
+            BetaToolChoiceFunction(
+                checkRequired("name", name),
+                type,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaToolChoiceFunction = apply {
+        if (validated) {
+            return@apply
+        }
+
+        name()
+        _type().let {
+            if (it != JsonValue.from("function")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (name.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("function")) 1 else 0 }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaToolChoiceFunction &&
+            name == other.name &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(name, type, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaToolChoiceFunction{name=$name, type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceMcp.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceMcp.kt
new file mode 100644
index 000000000..aca3c9d44
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceMcp.kt
@@ -0,0 +1,269 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Use this option to force the model to call a specific tool on a remote MCP server. */
+class BetaToolChoiceMcp
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val serverLabel: JsonField<String>,
+    private val type: JsonValue,
+    private val name: JsonField<String>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("server_label")
+        @ExcludeMissing
+        serverLabel: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+    ) : this(serverLabel, type, name, mutableMapOf())
+
+    /**
+     * The label of the MCP server to use.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun serverLabel(): String = serverLabel.getRequired("server_label")
+
+    /**
+     * For MCP tools, the type is always `mcp`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("mcp")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The name of the tool to call on the server.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun name(): Optional<String> = name.getOptional("name")
+
+    /**
+     * Returns the raw JSON value of [serverLabel].
+     *
+     * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("server_label")
+    @ExcludeMissing
+    fun _serverLabel(): JsonField<String> = serverLabel
+
+    /**
+     * Returns the raw JSON value of [name].
+     *
+     * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaToolChoiceMcp].
+         *
+         * The following fields are required:
+         * ```java
+         * .serverLabel()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaToolChoiceMcp]. */
+    class Builder internal constructor() {
+
+        private var serverLabel: JsonField<String>? = null
+        private var type: JsonValue = JsonValue.from("mcp")
+        private var name: JsonField<String> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaToolChoiceMcp: BetaToolChoiceMcp) = apply {
+            serverLabel = betaToolChoiceMcp.serverLabel
+            type = betaToolChoiceMcp.type
+            name = betaToolChoiceMcp.name
+            additionalProperties = betaToolChoiceMcp.additionalProperties.toMutableMap()
+        }
+
+        /** The label of the MCP server to use. */
+        fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
+
+        /**
+         * Sets [Builder.serverLabel] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.serverLabel] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun serverLabel(serverLabel: JsonField<String>) = apply { this.serverLabel = serverLabel }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("mcp")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The name of the tool to call on the server. */
+        fun name(name: String?) = name(JsonField.ofNullable(name))
+
+        /** Alias for calling [Builder.name] with `name.orElse(null)`. */
+        fun name(name: Optional<String>) = name(name.getOrNull())
+
+        /**
+         * Sets [Builder.name] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.name] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun name(name: JsonField<String>) = apply { this.name = name }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaToolChoiceMcp].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .serverLabel()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaToolChoiceMcp =
+            BetaToolChoiceMcp(
+                checkRequired("serverLabel", serverLabel),
+                type,
+                name,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaToolChoiceMcp = apply {
+        if (validated) {
+            return@apply
+        }
+
+        serverLabel()
+        _type().let {
+            if (it != JsonValue.from("mcp")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        name()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (serverLabel.asKnown().isPresent) 1 else 0) +
+            type.let { if (it == JsonValue.from("mcp")) 1 else 0 } +
+            (if (name.asKnown().isPresent) 1 else 0)
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaToolChoiceMcp &&
+            serverLabel == other.serverLabel &&
+            type == other.type &&
+            name == other.name &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(serverLabel, type, name, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaToolChoiceMcp{serverLabel=$serverLabel, type=$type, name=$name, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceOptions.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceOptions.kt
new file mode 100644
index 000000000..5b8986c42
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceOptions.kt
@@ -0,0 +1,157 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.openai.core.Enum
+import com.openai.core.JsonField
+import com.openai.errors.OpenAIInvalidDataException
+
+/**
+ * Controls which (if any) tool is called by the model.
+ *
+ * `none` means the model will not call any tool and instead generates a message.
+ *
+ * `auto` means the model can pick between generating a message or calling one or more tools.
+ *
+ * `required` means the model must call one or more tools.
+ */
+class BetaToolChoiceOptions @JsonCreator private constructor(private val value: JsonField<String>) :
+    Enum {
+
+    /**
+     * Returns this class instance's raw value.
+     *
+     * This is usually only useful if this instance was deserialized from data that doesn't match
+     * any known member, and you want to know that value. For example, if the SDK is on an older
+     * version than the API, then the API may respond with new members that the SDK is unaware of.
+     */
+    @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+    companion object {
+
+        @JvmField val NONE = of("none")
+
+        @JvmField val AUTO = of("auto")
+
+        @JvmField val REQUIRED = of("required")
+
+        @JvmStatic fun of(value: String) = BetaToolChoiceOptions(JsonField.of(value))
+    }
+
+    /** An enum containing [BetaToolChoiceOptions]'s known values. */
+    enum class Known {
+        NONE,
+        AUTO,
+        REQUIRED,
+    }
+
+    /**
+     * An enum containing [BetaToolChoiceOptions]'s known values, as well as an [_UNKNOWN] member.
+     *
+     * An instance of [BetaToolChoiceOptions] can contain an unknown value in a couple of cases:
+     * - It was deserialized from data that doesn't match any known member. For example, if the SDK
+     *   is on an older version than the API, then the API may respond with new members that the SDK
+     *   is unaware of.
+     * - It was constructed with an arbitrary value using the [of] method.
+     */
+    enum class Value {
+        NONE,
+        AUTO,
+        REQUIRED,
+        /**
+         * An enum member indicating that [BetaToolChoiceOptions] was instantiated with an unknown
+         * value.
+         */
+        _UNKNOWN,
+    }
+
+    /**
+     * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN] if
+     * the class was instantiated with an unknown value.
+     *
+     * Use the [known] method instead if you're certain the value is always known or if you want to
+     * throw for the unknown case.
+     */
+    fun value(): Value =
+        when (this) {
+            NONE -> Value.NONE
+            AUTO -> Value.AUTO
+            REQUIRED -> Value.REQUIRED
+            else -> Value._UNKNOWN
+        }
+
+    /**
+     * Returns an enum member corresponding to this class instance's value.
+     *
+     * Use the [value] method instead if you're uncertain the value is always known and don't want
+     * to throw for the unknown case.
+     *
+     * @throws OpenAIInvalidDataException if this class instance's value is a not a known member.
+     */
+    fun known(): Known =
+        when (this) {
+            NONE -> Known.NONE
+            AUTO -> Known.AUTO
+            REQUIRED -> Known.REQUIRED
+            else -> throw OpenAIInvalidDataException("Unknown BetaToolChoiceOptions: $value")
+        }
+
+    /**
+     * Returns this class instance's primitive wire representation.
+     *
+     * This differs from the [toString] method because that method is primarily for debugging and
+     * generally doesn't throw.
+     *
+     * @throws OpenAIInvalidDataException if this class instance's value does not have the expected
+     *   primitive type.
+     */
+    fun asString(): String =
+        _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaToolChoiceOptions = apply {
+        if (validated) {
+            return@apply
+        }
+
+        known()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaToolChoiceOptions && value == other.value
+    }
+
+    override fun hashCode() = value.hashCode()
+
+    override fun toString() = value.toString()
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceShell.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceShell.kt
new file mode 100644
index 000000000..4c5487763
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceShell.kt
@@ -0,0 +1,169 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+
+/** Forces the model to call the shell tool when a tool call is required. */
+class BetaToolChoiceShell
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of()
+    ) : this(type, mutableMapOf())
+
+    /**
+     * The tool to call. Always `shell`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("shell")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [BetaToolChoiceShell]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaToolChoiceShell]. */
+    class Builder internal constructor() {
+
+        private var type: JsonValue = JsonValue.from("shell")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaToolChoiceShell: BetaToolChoiceShell) = apply {
+            type = betaToolChoiceShell.type
+            additionalProperties = betaToolChoiceShell.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("shell")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaToolChoiceShell].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): BetaToolChoiceShell =
+            BetaToolChoiceShell(type, additionalProperties.toMutableMap())
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaToolChoiceShell = apply {
+        if (validated) {
+            return@apply
+        }
+
+        _type().let {
+            if (it != JsonValue.from("shell")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int = type.let { if (it == JsonValue.from("shell")) 1 else 0 }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaToolChoiceShell &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(type, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaToolChoiceShell{type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceTypes.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceTypes.kt
new file mode 100644
index 000000000..fa6e6c00a
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolChoiceTypes.kt
@@ -0,0 +1,389 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Indicates that the model should use a built-in tool to generate a response.
+ * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+ */
+class BetaToolChoiceTypes
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonField<Type>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of()
+    ) : this(type, mutableMapOf())
+
+    /**
+     * The type of hosted tool the model should to use. Learn more about
+     * [built-in tools](https://platform.openai.com/docs/guides/tools).
+     *
+     * Allowed values are:
+     * - `file_search`
+     * - `web_search_preview`
+     * - `computer`
+     * - `computer_use_preview`
+     * - `computer_use`
+     * - `code_interpreter`
+     * - `image_generation`
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun type(): Type = type.getRequired("type")
+
+    /**
+     * Returns the raw JSON value of [type].
+     *
+     * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaToolChoiceTypes].
+         *
+         * The following fields are required:
+         * ```java
+         * .type()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaToolChoiceTypes]. */
+    class Builder internal constructor() {
+
+        private var type: JsonField<Type>? = null
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaToolChoiceTypes: BetaToolChoiceTypes) = apply {
+            type = betaToolChoiceTypes.type
+            additionalProperties = betaToolChoiceTypes.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * The type of hosted tool the model should to use. Learn more about
+         * [built-in tools](https://platform.openai.com/docs/guides/tools).
+         *
+         * Allowed values are:
+         * - `file_search`
+         * - `web_search_preview`
+         * - `computer`
+         * - `computer_use_preview`
+         * - `computer_use`
+         * - `code_interpreter`
+         * - `image_generation`
+         */
+        fun type(type: Type) = type(JsonField.of(type))
+
+        /**
+         * Sets [Builder.type] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.type] with a well-typed [Type] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun type(type: JsonField<Type>) = apply { this.type = type }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaToolChoiceTypes].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .type()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaToolChoiceTypes =
+            BetaToolChoiceTypes(checkRequired("type", type), additionalProperties.toMutableMap())
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaToolChoiceTypes = apply {
+        if (validated) {
+            return@apply
+        }
+
+        type().validate()
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic internal fun validity(): Int = (type.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * The type of hosted tool the model should to use. Learn more about
+     * [built-in tools](https://platform.openai.com/docs/guides/tools).
+     *
+     * Allowed values are:
+     * - `file_search`
+     * - `web_search_preview`
+     * - `computer`
+     * - `computer_use_preview`
+     * - `computer_use`
+     * - `code_interpreter`
+     * - `image_generation`
+     */
+    class Type @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val FILE_SEARCH = of("file_search")
+
+            @JvmField val WEB_SEARCH_PREVIEW = of("web_search_preview")
+
+            @JvmField val COMPUTER = of("computer")
+
+            @JvmField val COMPUTER_USE_PREVIEW = of("computer_use_preview")
+
+            @JvmField val COMPUTER_USE = of("computer_use")
+
+            @JvmField val WEB_SEARCH_PREVIEW_2025_03_11 = of("web_search_preview_2025_03_11")
+
+            @JvmField val IMAGE_GENERATION = of("image_generation")
+
+            @JvmField val CODE_INTERPRETER = of("code_interpreter")
+
+            @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+        }
+
+        /** An enum containing [Type]'s known values. */
+        enum class Known {
+            FILE_SEARCH,
+            WEB_SEARCH_PREVIEW,
+            COMPUTER,
+            COMPUTER_USE_PREVIEW,
+            COMPUTER_USE,
+            WEB_SEARCH_PREVIEW_2025_03_11,
+            IMAGE_GENERATION,
+            CODE_INTERPRETER,
+        }
+
+        /**
+         * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Type] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            FILE_SEARCH,
+            WEB_SEARCH_PREVIEW,
+            COMPUTER,
+            COMPUTER_USE_PREVIEW,
+            COMPUTER_USE,
+            WEB_SEARCH_PREVIEW_2025_03_11,
+            IMAGE_GENERATION,
+            CODE_INTERPRETER,
+            /** An enum member indicating that [Type] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                FILE_SEARCH -> Value.FILE_SEARCH
+                WEB_SEARCH_PREVIEW -> Value.WEB_SEARCH_PREVIEW
+                COMPUTER -> Value.COMPUTER
+                COMPUTER_USE_PREVIEW -> Value.COMPUTER_USE_PREVIEW
+                COMPUTER_USE -> Value.COMPUTER_USE
+                WEB_SEARCH_PREVIEW_2025_03_11 -> Value.WEB_SEARCH_PREVIEW_2025_03_11
+                IMAGE_GENERATION -> Value.IMAGE_GENERATION
+                CODE_INTERPRETER -> Value.CODE_INTERPRETER
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                FILE_SEARCH -> Known.FILE_SEARCH
+                WEB_SEARCH_PREVIEW -> Known.WEB_SEARCH_PREVIEW
+                COMPUTER -> Known.COMPUTER
+                COMPUTER_USE_PREVIEW -> Known.COMPUTER_USE_PREVIEW
+                COMPUTER_USE -> Known.COMPUTER_USE
+                WEB_SEARCH_PREVIEW_2025_03_11 -> Known.WEB_SEARCH_PREVIEW_2025_03_11
+                IMAGE_GENERATION -> Known.IMAGE_GENERATION
+                CODE_INTERPRETER -> Known.CODE_INTERPRETER
+                else -> throw OpenAIInvalidDataException("Unknown Type: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Type = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Type && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaToolChoiceTypes &&
+            type == other.type &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(type, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaToolChoiceTypes{type=$type, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolSearchTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolSearchTool.kt
new file mode 100644
index 000000000..a4b40d877
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaToolSearchTool.kt
@@ -0,0 +1,412 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Hosted or BYOT tool search configuration for deferred tools. */
+class BetaToolSearchTool
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonValue,
+    private val description: JsonField<String>,
+    private val execution: JsonField<Execution>,
+    private val parameters: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("description")
+        @ExcludeMissing
+        description: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("execution")
+        @ExcludeMissing
+        execution: JsonField<Execution> = JsonMissing.of(),
+        @JsonProperty("parameters") @ExcludeMissing parameters: JsonValue = JsonMissing.of(),
+    ) : this(type, description, execution, parameters, mutableMapOf())
+
+    /**
+     * The type of the tool. Always `tool_search`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("tool_search")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * Description shown to the model for a client-executed tool search tool.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun description(): Optional<String> = description.getOptional("description")
+
+    /**
+     * Whether tool search is executed by the server or by the client.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun execution(): Optional<Execution> = execution.getOptional("execution")
+
+    /**
+     * Parameter schema for a client-executed tool search tool.
+     *
+     * This arbitrary value can be deserialized into a custom type using the `convert` method:
+     * ```java
+     * MyClass myObject = betaToolSearchTool.parameters().convert(MyClass.class);
+     * ```
+     */
+    @JsonProperty("parameters") @ExcludeMissing fun _parameters(): JsonValue = parameters
+
+    /**
+     * Returns the raw JSON value of [description].
+     *
+     * Unlike [description], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("description") @ExcludeMissing fun _description(): JsonField<String> = description
+
+    /**
+     * Returns the raw JSON value of [execution].
+     *
+     * Unlike [execution], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("execution") @ExcludeMissing fun _execution(): JsonField<Execution> = execution
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /** Returns a mutable builder for constructing an instance of [BetaToolSearchTool]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaToolSearchTool]. */
+    class Builder internal constructor() {
+
+        private var type: JsonValue = JsonValue.from("tool_search")
+        private var description: JsonField<String> = JsonMissing.of()
+        private var execution: JsonField<Execution> = JsonMissing.of()
+        private var parameters: JsonValue = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaToolSearchTool: BetaToolSearchTool) = apply {
+            type = betaToolSearchTool.type
+            description = betaToolSearchTool.description
+            execution = betaToolSearchTool.execution
+            parameters = betaToolSearchTool.parameters
+            additionalProperties = betaToolSearchTool.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("tool_search")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** Description shown to the model for a client-executed tool search tool. */
+        fun description(description: String?) = description(JsonField.ofNullable(description))
+
+        /** Alias for calling [Builder.description] with `description.orElse(null)`. */
+        fun description(description: Optional<String>) = description(description.getOrNull())
+
+        /**
+         * Sets [Builder.description] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.description] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun description(description: JsonField<String>) = apply { this.description = description }
+
+        /** Whether tool search is executed by the server or by the client. */
+        fun execution(execution: Execution) = execution(JsonField.of(execution))
+
+        /**
+         * Sets [Builder.execution] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.execution] with a well-typed [Execution] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun execution(execution: JsonField<Execution>) = apply { this.execution = execution }
+
+        /** Parameter schema for a client-executed tool search tool. */
+        fun parameters(parameters: JsonValue) = apply { this.parameters = parameters }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaToolSearchTool].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): BetaToolSearchTool =
+            BetaToolSearchTool(
+                type,
+                description,
+                execution,
+                parameters,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaToolSearchTool = apply {
+        if (validated) {
+            return@apply
+        }
+
+        _type().let {
+            if (it != JsonValue.from("tool_search")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        description()
+        execution().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        type.let { if (it == JsonValue.from("tool_search")) 1 else 0 } +
+            (if (description.asKnown().isPresent) 1 else 0) +
+            (execution.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** Whether tool search is executed by the server or by the client. */
+    class Execution @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val SERVER = of("server")
+
+            @JvmField val CLIENT = of("client")
+
+            @JvmStatic fun of(value: String) = Execution(JsonField.of(value))
+        }
+
+        /** An enum containing [Execution]'s known values. */
+        enum class Known {
+            SERVER,
+            CLIENT,
+        }
+
+        /**
+         * An enum containing [Execution]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Execution] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            SERVER,
+            CLIENT,
+            /**
+             * An enum member indicating that [Execution] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                SERVER -> Value.SERVER
+                CLIENT -> Value.CLIENT
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                SERVER -> Known.SERVER
+                CLIENT -> Known.CLIENT
+                else -> throw OpenAIInvalidDataException("Unknown Execution: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Execution = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Execution && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaToolSearchTool &&
+            type == other.type &&
+            description == other.description &&
+            execution == other.execution &&
+            parameters == other.parameters &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(type, description, execution, parameters, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaToolSearchTool{type=$type, description=$description, execution=$execution, parameters=$parameters, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaWebSearchPreviewTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaWebSearchPreviewTool.kt
new file mode 100644
index 000000000..5f85219f9
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaWebSearchPreviewTool.kt
@@ -0,0 +1,1099 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * This tool searches the web for relevant results to use in a response. Learn more about the
+ * [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+ */
+class BetaWebSearchPreviewTool
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonField<Type>,
+    private val searchContentTypes: JsonField<List<SearchContentType>>,
+    private val searchContextSize: JsonField<SearchContextSize>,
+    private val userLocation: JsonField<UserLocation>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
+        @JsonProperty("search_content_types")
+        @ExcludeMissing
+        searchContentTypes: JsonField<List<SearchContentType>> = JsonMissing.of(),
+        @JsonProperty("search_context_size")
+        @ExcludeMissing
+        searchContextSize: JsonField<SearchContextSize> = JsonMissing.of(),
+        @JsonProperty("user_location")
+        @ExcludeMissing
+        userLocation: JsonField<UserLocation> = JsonMissing.of(),
+    ) : this(type, searchContentTypes, searchContextSize, userLocation, mutableMapOf())
+
+    /**
+     * The type of the web search tool. One of `web_search_preview` or
+     * `web_search_preview_2025_03_11`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun type(): Type = type.getRequired("type")
+
+    /**
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun searchContentTypes(): Optional<List<SearchContentType>> =
+        searchContentTypes.getOptional("search_content_types")
+
+    /**
+     * High level guidance for the amount of context window space to use for the search. One of
+     * `low`, `medium`, or `high`. `medium` is the default.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun searchContextSize(): Optional<SearchContextSize> =
+        searchContextSize.getOptional("search_context_size")
+
+    /**
+     * The user's location.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun userLocation(): Optional<UserLocation> = userLocation.getOptional("user_location")
+
+    /**
+     * Returns the raw JSON value of [type].
+     *
+     * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+
+    /**
+     * Returns the raw JSON value of [searchContentTypes].
+     *
+     * Unlike [searchContentTypes], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("search_content_types")
+    @ExcludeMissing
+    fun _searchContentTypes(): JsonField<List<SearchContentType>> = searchContentTypes
+
+    /**
+     * Returns the raw JSON value of [searchContextSize].
+     *
+     * Unlike [searchContextSize], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("search_context_size")
+    @ExcludeMissing
+    fun _searchContextSize(): JsonField<SearchContextSize> = searchContextSize
+
+    /**
+     * Returns the raw JSON value of [userLocation].
+     *
+     * Unlike [userLocation], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("user_location")
+    @ExcludeMissing
+    fun _userLocation(): JsonField<UserLocation> = userLocation
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaWebSearchPreviewTool].
+         *
+         * The following fields are required:
+         * ```java
+         * .type()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaWebSearchPreviewTool]. */
+    class Builder internal constructor() {
+
+        private var type: JsonField<Type>? = null
+        private var searchContentTypes: JsonField<MutableList<SearchContentType>>? = null
+        private var searchContextSize: JsonField<SearchContextSize> = JsonMissing.of()
+        private var userLocation: JsonField<UserLocation> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaWebSearchPreviewTool: BetaWebSearchPreviewTool) = apply {
+            type = betaWebSearchPreviewTool.type
+            searchContentTypes =
+                betaWebSearchPreviewTool.searchContentTypes.map { it.toMutableList() }
+            searchContextSize = betaWebSearchPreviewTool.searchContextSize
+            userLocation = betaWebSearchPreviewTool.userLocation
+            additionalProperties = betaWebSearchPreviewTool.additionalProperties.toMutableMap()
+        }
+
+        /**
+         * The type of the web search tool. One of `web_search_preview` or
+         * `web_search_preview_2025_03_11`.
+         */
+        fun type(type: Type) = type(JsonField.of(type))
+
+        /**
+         * Sets [Builder.type] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.type] with a well-typed [Type] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun type(type: JsonField<Type>) = apply { this.type = type }
+
+        fun searchContentTypes(searchContentTypes: List<SearchContentType>) =
+            searchContentTypes(JsonField.of(searchContentTypes))
+
+        /**
+         * Sets [Builder.searchContentTypes] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.searchContentTypes] with a well-typed
+         * `List<SearchContentType>` value instead. This method is primarily for setting the field
+         * to an undocumented or not yet supported value.
+         */
+        fun searchContentTypes(searchContentTypes: JsonField<List<SearchContentType>>) = apply {
+            this.searchContentTypes = searchContentTypes.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [SearchContentType] to [searchContentTypes].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addSearchContentType(searchContentType: SearchContentType) = apply {
+            searchContentTypes =
+                (searchContentTypes ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("searchContentTypes", it).add(searchContentType)
+                }
+        }
+
+        /**
+         * High level guidance for the amount of context window space to use for the search. One of
+         * `low`, `medium`, or `high`. `medium` is the default.
+         */
+        fun searchContextSize(searchContextSize: SearchContextSize) =
+            searchContextSize(JsonField.of(searchContextSize))
+
+        /**
+         * Sets [Builder.searchContextSize] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.searchContextSize] with a well-typed [SearchContextSize]
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun searchContextSize(searchContextSize: JsonField<SearchContextSize>) = apply {
+            this.searchContextSize = searchContextSize
+        }
+
+        /** The user's location. */
+        fun userLocation(userLocation: UserLocation?) =
+            userLocation(JsonField.ofNullable(userLocation))
+
+        /** Alias for calling [Builder.userLocation] with `userLocation.orElse(null)`. */
+        fun userLocation(userLocation: Optional<UserLocation>) =
+            userLocation(userLocation.getOrNull())
+
+        /**
+         * Sets [Builder.userLocation] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.userLocation] with a well-typed [UserLocation] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun userLocation(userLocation: JsonField<UserLocation>) = apply {
+            this.userLocation = userLocation
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaWebSearchPreviewTool].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .type()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaWebSearchPreviewTool =
+            BetaWebSearchPreviewTool(
+                checkRequired("type", type),
+                (searchContentTypes ?: JsonMissing.of()).map { it.toImmutable() },
+                searchContextSize,
+                userLocation,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaWebSearchPreviewTool = apply {
+        if (validated) {
+            return@apply
+        }
+
+        type().validate()
+        searchContentTypes().ifPresent { it.forEach { it.validate() } }
+        searchContextSize().ifPresent { it.validate() }
+        userLocation().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (type.asKnown().getOrNull()?.validity() ?: 0) +
+            (searchContentTypes.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (searchContextSize.asKnown().getOrNull()?.validity() ?: 0) +
+            (userLocation.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * The type of the web search tool. One of `web_search_preview` or
+     * `web_search_preview_2025_03_11`.
+     */
+    class Type @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val WEB_SEARCH_PREVIEW = of("web_search_preview")
+
+            @JvmField val WEB_SEARCH_PREVIEW_2025_03_11 = of("web_search_preview_2025_03_11")
+
+            @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+        }
+
+        /** An enum containing [Type]'s known values. */
+        enum class Known {
+            WEB_SEARCH_PREVIEW,
+            WEB_SEARCH_PREVIEW_2025_03_11,
+        }
+
+        /**
+         * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Type] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            WEB_SEARCH_PREVIEW,
+            WEB_SEARCH_PREVIEW_2025_03_11,
+            /** An enum member indicating that [Type] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                WEB_SEARCH_PREVIEW -> Value.WEB_SEARCH_PREVIEW
+                WEB_SEARCH_PREVIEW_2025_03_11 -> Value.WEB_SEARCH_PREVIEW_2025_03_11
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                WEB_SEARCH_PREVIEW -> Known.WEB_SEARCH_PREVIEW
+                WEB_SEARCH_PREVIEW_2025_03_11 -> Known.WEB_SEARCH_PREVIEW_2025_03_11
+                else -> throw OpenAIInvalidDataException("Unknown Type: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Type = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Type && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    class SearchContentType @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val TEXT = of("text")
+
+            @JvmField val IMAGE = of("image")
+
+            @JvmStatic fun of(value: String) = SearchContentType(JsonField.of(value))
+        }
+
+        /** An enum containing [SearchContentType]'s known values. */
+        enum class Known {
+            TEXT,
+            IMAGE,
+        }
+
+        /**
+         * An enum containing [SearchContentType]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [SearchContentType] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            TEXT,
+            IMAGE,
+            /**
+             * An enum member indicating that [SearchContentType] was instantiated with an unknown
+             * value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                TEXT -> Value.TEXT
+                IMAGE -> Value.IMAGE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                TEXT -> Known.TEXT
+                IMAGE -> Known.IMAGE
+                else -> throw OpenAIInvalidDataException("Unknown SearchContentType: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): SearchContentType = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is SearchContentType && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /**
+     * High level guidance for the amount of context window space to use for the search. One of
+     * `low`, `medium`, or `high`. `medium` is the default.
+     */
+    class SearchContextSize @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val LOW = of("low")
+
+            @JvmField val MEDIUM = of("medium")
+
+            @JvmField val HIGH = of("high")
+
+            @JvmStatic fun of(value: String) = SearchContextSize(JsonField.of(value))
+        }
+
+        /** An enum containing [SearchContextSize]'s known values. */
+        enum class Known {
+            LOW,
+            MEDIUM,
+            HIGH,
+        }
+
+        /**
+         * An enum containing [SearchContextSize]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [SearchContextSize] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            LOW,
+            MEDIUM,
+            HIGH,
+            /**
+             * An enum member indicating that [SearchContextSize] was instantiated with an unknown
+             * value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                LOW -> Value.LOW
+                MEDIUM -> Value.MEDIUM
+                HIGH -> Value.HIGH
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                LOW -> Known.LOW
+                MEDIUM -> Known.MEDIUM
+                HIGH -> Known.HIGH
+                else -> throw OpenAIInvalidDataException("Unknown SearchContextSize: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): SearchContextSize = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is SearchContextSize && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The user's location. */
+    class UserLocation
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val type: JsonValue,
+        private val city: JsonField<String>,
+        private val country: JsonField<String>,
+        private val region: JsonField<String>,
+        private val timezone: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("city") @ExcludeMissing city: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("country") @ExcludeMissing country: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("region") @ExcludeMissing region: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("timezone") @ExcludeMissing timezone: JsonField<String> = JsonMissing.of(),
+        ) : this(type, city, country, region, timezone, mutableMapOf())
+
+        /**
+         * The type of location approximation. Always `approximate`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("approximate")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Free text input for the city of the user, e.g. `San Francisco`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun city(): Optional<String> = city.getOptional("city")
+
+        /**
+         * The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of the user,
+         * e.g. `US`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun country(): Optional<String> = country.getOptional("country")
+
+        /**
+         * Free text input for the region of the user, e.g. `California`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun region(): Optional<String> = region.getOptional("region")
+
+        /**
+         * The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the user, e.g.
+         * `America/Los_Angeles`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun timezone(): Optional<String> = timezone.getOptional("timezone")
+
+        /**
+         * Returns the raw JSON value of [city].
+         *
+         * Unlike [city], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("city") @ExcludeMissing fun _city(): JsonField<String> = city
+
+        /**
+         * Returns the raw JSON value of [country].
+         *
+         * Unlike [country], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("country") @ExcludeMissing fun _country(): JsonField<String> = country
+
+        /**
+         * Returns the raw JSON value of [region].
+         *
+         * Unlike [region], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("region") @ExcludeMissing fun _region(): JsonField<String> = region
+
+        /**
+         * Returns the raw JSON value of [timezone].
+         *
+         * Unlike [timezone], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("timezone") @ExcludeMissing fun _timezone(): JsonField<String> = timezone
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [UserLocation]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [UserLocation]. */
+        class Builder internal constructor() {
+
+            private var type: JsonValue = JsonValue.from("approximate")
+            private var city: JsonField<String> = JsonMissing.of()
+            private var country: JsonField<String> = JsonMissing.of()
+            private var region: JsonField<String> = JsonMissing.of()
+            private var timezone: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(userLocation: UserLocation) = apply {
+                type = userLocation.type
+                city = userLocation.city
+                country = userLocation.country
+                region = userLocation.region
+                timezone = userLocation.timezone
+                additionalProperties = userLocation.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("approximate")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /** Free text input for the city of the user, e.g. `San Francisco`. */
+            fun city(city: String?) = city(JsonField.ofNullable(city))
+
+            /** Alias for calling [Builder.city] with `city.orElse(null)`. */
+            fun city(city: Optional<String>) = city(city.getOrNull())
+
+            /**
+             * Sets [Builder.city] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.city] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun city(city: JsonField<String>) = apply { this.city = city }
+
+            /**
+             * The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of the
+             * user, e.g. `US`.
+             */
+            fun country(country: String?) = country(JsonField.ofNullable(country))
+
+            /** Alias for calling [Builder.country] with `country.orElse(null)`. */
+            fun country(country: Optional<String>) = country(country.getOrNull())
+
+            /**
+             * Sets [Builder.country] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.country] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun country(country: JsonField<String>) = apply { this.country = country }
+
+            /** Free text input for the region of the user, e.g. `California`. */
+            fun region(region: String?) = region(JsonField.ofNullable(region))
+
+            /** Alias for calling [Builder.region] with `region.orElse(null)`. */
+            fun region(region: Optional<String>) = region(region.getOrNull())
+
+            /**
+             * Sets [Builder.region] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.region] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun region(region: JsonField<String>) = apply { this.region = region }
+
+            /**
+             * The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the user,
+             * e.g. `America/Los_Angeles`.
+             */
+            fun timezone(timezone: String?) = timezone(JsonField.ofNullable(timezone))
+
+            /** Alias for calling [Builder.timezone] with `timezone.orElse(null)`. */
+            fun timezone(timezone: Optional<String>) = timezone(timezone.getOrNull())
+
+            /**
+             * Sets [Builder.timezone] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.timezone] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun timezone(timezone: JsonField<String>) = apply { this.timezone = timezone }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [UserLocation].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): UserLocation =
+                UserLocation(
+                    type,
+                    city,
+                    country,
+                    region,
+                    timezone,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): UserLocation = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _type().let {
+                if (it != JsonValue.from("approximate")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            city()
+            country()
+            region()
+            timezone()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            type.let { if (it == JsonValue.from("approximate")) 1 else 0 } +
+                (if (city.asKnown().isPresent) 1 else 0) +
+                (if (country.asKnown().isPresent) 1 else 0) +
+                (if (region.asKnown().isPresent) 1 else 0) +
+                (if (timezone.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is UserLocation &&
+                type == other.type &&
+                city == other.city &&
+                country == other.country &&
+                region == other.region &&
+                timezone == other.timezone &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(type, city, country, region, timezone, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "UserLocation{type=$type, city=$city, country=$country, region=$region, timezone=$timezone, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaWebSearchPreviewTool &&
+            type == other.type &&
+            searchContentTypes == other.searchContentTypes &&
+            searchContextSize == other.searchContextSize &&
+            userLocation == other.userLocation &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(
+            type,
+            searchContentTypes,
+            searchContextSize,
+            userLocation,
+            additionalProperties,
+        )
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaWebSearchPreviewTool{type=$type, searchContentTypes=$searchContentTypes, searchContextSize=$searchContextSize, userLocation=$userLocation, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaWebSearchTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaWebSearchTool.kt
new file mode 100644
index 000000000..f27d52175
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaWebSearchTool.kt
@@ -0,0 +1,1249 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Search the Internet for sources related to the prompt. Learn more about the
+ * [web search tool](https://platform.openai.com/docs/guides/tools-web-search).
+ */
+class BetaWebSearchTool
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val type: JsonField<Type>,
+    private val filters: JsonField<Filters>,
+    private val searchContextSize: JsonField<SearchContextSize>,
+    private val userLocation: JsonField<UserLocation>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
+        @JsonProperty("filters") @ExcludeMissing filters: JsonField<Filters> = JsonMissing.of(),
+        @JsonProperty("search_context_size")
+        @ExcludeMissing
+        searchContextSize: JsonField<SearchContextSize> = JsonMissing.of(),
+        @JsonProperty("user_location")
+        @ExcludeMissing
+        userLocation: JsonField<UserLocation> = JsonMissing.of(),
+    ) : this(type, filters, searchContextSize, userLocation, mutableMapOf())
+
+    /**
+     * The type of the web search tool. One of `web_search` or `web_search_2025_08_26`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun type(): Type = type.getRequired("type")
+
+    /**
+     * Filters for the search.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun filters(): Optional<Filters> = filters.getOptional("filters")
+
+    /**
+     * High level guidance for the amount of context window space to use for the search. One of
+     * `low`, `medium`, or `high`. `medium` is the default.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun searchContextSize(): Optional<SearchContextSize> =
+        searchContextSize.getOptional("search_context_size")
+
+    /**
+     * The approximate location of the user.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun userLocation(): Optional<UserLocation> = userLocation.getOptional("user_location")
+
+    /**
+     * Returns the raw JSON value of [type].
+     *
+     * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+
+    /**
+     * Returns the raw JSON value of [filters].
+     *
+     * Unlike [filters], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("filters") @ExcludeMissing fun _filters(): JsonField<Filters> = filters
+
+    /**
+     * Returns the raw JSON value of [searchContextSize].
+     *
+     * Unlike [searchContextSize], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("search_context_size")
+    @ExcludeMissing
+    fun _searchContextSize(): JsonField<SearchContextSize> = searchContextSize
+
+    /**
+     * Returns the raw JSON value of [userLocation].
+     *
+     * Unlike [userLocation], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("user_location")
+    @ExcludeMissing
+    fun _userLocation(): JsonField<UserLocation> = userLocation
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaWebSearchTool].
+         *
+         * The following fields are required:
+         * ```java
+         * .type()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaWebSearchTool]. */
+    class Builder internal constructor() {
+
+        private var type: JsonField<Type>? = null
+        private var filters: JsonField<Filters> = JsonMissing.of()
+        private var searchContextSize: JsonField<SearchContextSize> = JsonMissing.of()
+        private var userLocation: JsonField<UserLocation> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaWebSearchTool: BetaWebSearchTool) = apply {
+            type = betaWebSearchTool.type
+            filters = betaWebSearchTool.filters
+            searchContextSize = betaWebSearchTool.searchContextSize
+            userLocation = betaWebSearchTool.userLocation
+            additionalProperties = betaWebSearchTool.additionalProperties.toMutableMap()
+        }
+
+        /** The type of the web search tool. One of `web_search` or `web_search_2025_08_26`. */
+        fun type(type: Type) = type(JsonField.of(type))
+
+        /**
+         * Sets [Builder.type] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.type] with a well-typed [Type] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun type(type: JsonField<Type>) = apply { this.type = type }
+
+        /** Filters for the search. */
+        fun filters(filters: Filters?) = filters(JsonField.ofNullable(filters))
+
+        /** Alias for calling [Builder.filters] with `filters.orElse(null)`. */
+        fun filters(filters: Optional<Filters>) = filters(filters.getOrNull())
+
+        /**
+         * Sets [Builder.filters] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.filters] with a well-typed [Filters] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun filters(filters: JsonField<Filters>) = apply { this.filters = filters }
+
+        /**
+         * High level guidance for the amount of context window space to use for the search. One of
+         * `low`, `medium`, or `high`. `medium` is the default.
+         */
+        fun searchContextSize(searchContextSize: SearchContextSize) =
+            searchContextSize(JsonField.of(searchContextSize))
+
+        /**
+         * Sets [Builder.searchContextSize] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.searchContextSize] with a well-typed [SearchContextSize]
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun searchContextSize(searchContextSize: JsonField<SearchContextSize>) = apply {
+            this.searchContextSize = searchContextSize
+        }
+
+        /** The approximate location of the user. */
+        fun userLocation(userLocation: UserLocation?) =
+            userLocation(JsonField.ofNullable(userLocation))
+
+        /** Alias for calling [Builder.userLocation] with `userLocation.orElse(null)`. */
+        fun userLocation(userLocation: Optional<UserLocation>) =
+            userLocation(userLocation.getOrNull())
+
+        /**
+         * Sets [Builder.userLocation] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.userLocation] with a well-typed [UserLocation] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun userLocation(userLocation: JsonField<UserLocation>) = apply {
+            this.userLocation = userLocation
+        }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaWebSearchTool].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .type()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaWebSearchTool =
+            BetaWebSearchTool(
+                checkRequired("type", type),
+                filters,
+                searchContextSize,
+                userLocation,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaWebSearchTool = apply {
+        if (validated) {
+            return@apply
+        }
+
+        type().validate()
+        filters().ifPresent { it.validate() }
+        searchContextSize().ifPresent { it.validate() }
+        userLocation().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (type.asKnown().getOrNull()?.validity() ?: 0) +
+            (filters.asKnown().getOrNull()?.validity() ?: 0) +
+            (searchContextSize.asKnown().getOrNull()?.validity() ?: 0) +
+            (userLocation.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** The type of the web search tool. One of `web_search` or `web_search_2025_08_26`. */
+    class Type @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val WEB_SEARCH = of("web_search")
+
+            @JvmField val WEB_SEARCH_2025_08_26 = of("web_search_2025_08_26")
+
+            @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+        }
+
+        /** An enum containing [Type]'s known values. */
+        enum class Known {
+            WEB_SEARCH,
+            WEB_SEARCH_2025_08_26,
+        }
+
+        /**
+         * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Type] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            WEB_SEARCH,
+            WEB_SEARCH_2025_08_26,
+            /** An enum member indicating that [Type] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                WEB_SEARCH -> Value.WEB_SEARCH
+                WEB_SEARCH_2025_08_26 -> Value.WEB_SEARCH_2025_08_26
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                WEB_SEARCH -> Known.WEB_SEARCH
+                WEB_SEARCH_2025_08_26 -> Known.WEB_SEARCH_2025_08_26
+                else -> throw OpenAIInvalidDataException("Unknown Type: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Type = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Type && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** Filters for the search. */
+    class Filters
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val allowedDomains: JsonField<List<String>>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("allowed_domains")
+            @ExcludeMissing
+            allowedDomains: JsonField<List<String>> = JsonMissing.of()
+        ) : this(allowedDomains, mutableMapOf())
+
+        /**
+         * Allowed domains for the search. If not provided, all domains are allowed. Subdomains of
+         * the provided domains are allowed as well.
+         *
+         * Example: `["pubmed.ncbi.nlm.nih.gov"]`
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun allowedDomains(): Optional<List<String>> = allowedDomains.getOptional("allowed_domains")
+
+        /**
+         * Returns the raw JSON value of [allowedDomains].
+         *
+         * Unlike [allowedDomains], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("allowed_domains")
+        @ExcludeMissing
+        fun _allowedDomains(): JsonField<List<String>> = allowedDomains
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Filters]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Filters]. */
+        class Builder internal constructor() {
+
+            private var allowedDomains: JsonField<MutableList<String>>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(filters: Filters) = apply {
+                allowedDomains = filters.allowedDomains.map { it.toMutableList() }
+                additionalProperties = filters.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Allowed domains for the search. If not provided, all domains are allowed. Subdomains
+             * of the provided domains are allowed as well.
+             *
+             * Example: `["pubmed.ncbi.nlm.nih.gov"]`
+             */
+            fun allowedDomains(allowedDomains: List<String>?) =
+                allowedDomains(JsonField.ofNullable(allowedDomains))
+
+            /** Alias for calling [Builder.allowedDomains] with `allowedDomains.orElse(null)`. */
+            fun allowedDomains(allowedDomains: Optional<List<String>>) =
+                allowedDomains(allowedDomains.getOrNull())
+
+            /**
+             * Sets [Builder.allowedDomains] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.allowedDomains] with a well-typed `List<String>`
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            fun allowedDomains(allowedDomains: JsonField<List<String>>) = apply {
+                this.allowedDomains = allowedDomains.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [String] to [allowedDomains].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addAllowedDomain(allowedDomain: String) = apply {
+                allowedDomains =
+                    (allowedDomains ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("allowedDomains", it).add(allowedDomain)
+                    }
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Filters].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Filters =
+                Filters(
+                    (allowedDomains ?: JsonMissing.of()).map { it.toImmutable() },
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Filters = apply {
+            if (validated) {
+                return@apply
+            }
+
+            allowedDomains()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = (allowedDomains.asKnown().getOrNull()?.size ?: 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Filters &&
+                allowedDomains == other.allowedDomains &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(allowedDomains, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Filters{allowedDomains=$allowedDomains, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * High level guidance for the amount of context window space to use for the search. One of
+     * `low`, `medium`, or `high`. `medium` is the default.
+     */
+    class SearchContextSize @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val LOW = of("low")
+
+            @JvmField val MEDIUM = of("medium")
+
+            @JvmField val HIGH = of("high")
+
+            @JvmStatic fun of(value: String) = SearchContextSize(JsonField.of(value))
+        }
+
+        /** An enum containing [SearchContextSize]'s known values. */
+        enum class Known {
+            LOW,
+            MEDIUM,
+            HIGH,
+        }
+
+        /**
+         * An enum containing [SearchContextSize]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [SearchContextSize] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            LOW,
+            MEDIUM,
+            HIGH,
+            /**
+             * An enum member indicating that [SearchContextSize] was instantiated with an unknown
+             * value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                LOW -> Value.LOW
+                MEDIUM -> Value.MEDIUM
+                HIGH -> Value.HIGH
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                LOW -> Known.LOW
+                MEDIUM -> Known.MEDIUM
+                HIGH -> Known.HIGH
+                else -> throw OpenAIInvalidDataException("Unknown SearchContextSize: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): SearchContextSize = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is SearchContextSize && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The approximate location of the user. */
+    class UserLocation
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val city: JsonField<String>,
+        private val country: JsonField<String>,
+        private val region: JsonField<String>,
+        private val timezone: JsonField<String>,
+        private val type: JsonField<Type>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("city") @ExcludeMissing city: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("country") @ExcludeMissing country: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("region") @ExcludeMissing region: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("timezone")
+            @ExcludeMissing
+            timezone: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
+        ) : this(city, country, region, timezone, type, mutableMapOf())
+
+        /**
+         * Free text input for the city of the user, e.g. `San Francisco`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun city(): Optional<String> = city.getOptional("city")
+
+        /**
+         * The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of the user,
+         * e.g. `US`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun country(): Optional<String> = country.getOptional("country")
+
+        /**
+         * Free text input for the region of the user, e.g. `California`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun region(): Optional<String> = region.getOptional("region")
+
+        /**
+         * The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the user, e.g.
+         * `America/Los_Angeles`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun timezone(): Optional<String> = timezone.getOptional("timezone")
+
+        /**
+         * The type of location approximation. Always `approximate`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun type(): Optional<Type> = type.getOptional("type")
+
+        /**
+         * Returns the raw JSON value of [city].
+         *
+         * Unlike [city], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("city") @ExcludeMissing fun _city(): JsonField<String> = city
+
+        /**
+         * Returns the raw JSON value of [country].
+         *
+         * Unlike [country], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("country") @ExcludeMissing fun _country(): JsonField<String> = country
+
+        /**
+         * Returns the raw JSON value of [region].
+         *
+         * Unlike [region], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("region") @ExcludeMissing fun _region(): JsonField<String> = region
+
+        /**
+         * Returns the raw JSON value of [timezone].
+         *
+         * Unlike [timezone], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("timezone") @ExcludeMissing fun _timezone(): JsonField<String> = timezone
+
+        /**
+         * Returns the raw JSON value of [type].
+         *
+         * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [UserLocation]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [UserLocation]. */
+        class Builder internal constructor() {
+
+            private var city: JsonField<String> = JsonMissing.of()
+            private var country: JsonField<String> = JsonMissing.of()
+            private var region: JsonField<String> = JsonMissing.of()
+            private var timezone: JsonField<String> = JsonMissing.of()
+            private var type: JsonField<Type> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(userLocation: UserLocation) = apply {
+                city = userLocation.city
+                country = userLocation.country
+                region = userLocation.region
+                timezone = userLocation.timezone
+                type = userLocation.type
+                additionalProperties = userLocation.additionalProperties.toMutableMap()
+            }
+
+            /** Free text input for the city of the user, e.g. `San Francisco`. */
+            fun city(city: String?) = city(JsonField.ofNullable(city))
+
+            /** Alias for calling [Builder.city] with `city.orElse(null)`. */
+            fun city(city: Optional<String>) = city(city.getOrNull())
+
+            /**
+             * Sets [Builder.city] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.city] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun city(city: JsonField<String>) = apply { this.city = city }
+
+            /**
+             * The two-letter [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1) of the
+             * user, e.g. `US`.
+             */
+            fun country(country: String?) = country(JsonField.ofNullable(country))
+
+            /** Alias for calling [Builder.country] with `country.orElse(null)`. */
+            fun country(country: Optional<String>) = country(country.getOrNull())
+
+            /**
+             * Sets [Builder.country] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.country] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun country(country: JsonField<String>) = apply { this.country = country }
+
+            /** Free text input for the region of the user, e.g. `California`. */
+            fun region(region: String?) = region(JsonField.ofNullable(region))
+
+            /** Alias for calling [Builder.region] with `region.orElse(null)`. */
+            fun region(region: Optional<String>) = region(region.getOrNull())
+
+            /**
+             * Sets [Builder.region] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.region] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun region(region: JsonField<String>) = apply { this.region = region }
+
+            /**
+             * The [IANA timezone](https://timeapi.io/documentation/iana-timezones) of the user,
+             * e.g. `America/Los_Angeles`.
+             */
+            fun timezone(timezone: String?) = timezone(JsonField.ofNullable(timezone))
+
+            /** Alias for calling [Builder.timezone] with `timezone.orElse(null)`. */
+            fun timezone(timezone: Optional<String>) = timezone(timezone.getOrNull())
+
+            /**
+             * Sets [Builder.timezone] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.timezone] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun timezone(timezone: JsonField<String>) = apply { this.timezone = timezone }
+
+            /** The type of location approximation. Always `approximate`. */
+            fun type(type: Type) = type(JsonField.of(type))
+
+            /**
+             * Sets [Builder.type] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.type] with a well-typed [Type] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun type(type: JsonField<Type>) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [UserLocation].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): UserLocation =
+                UserLocation(
+                    city,
+                    country,
+                    region,
+                    timezone,
+                    type,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): UserLocation = apply {
+            if (validated) {
+                return@apply
+            }
+
+            city()
+            country()
+            region()
+            timezone()
+            type().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (city.asKnown().isPresent) 1 else 0) +
+                (if (country.asKnown().isPresent) 1 else 0) +
+                (if (region.asKnown().isPresent) 1 else 0) +
+                (if (timezone.asKnown().isPresent) 1 else 0) +
+                (type.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The type of location approximation. Always `approximate`. */
+        class Type @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val APPROXIMATE = of("approximate")
+
+                @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+            }
+
+            /** An enum containing [Type]'s known values. */
+            enum class Known {
+                APPROXIMATE
+            }
+
+            /**
+             * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Type] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                APPROXIMATE,
+                /** An enum member indicating that [Type] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    APPROXIMATE -> Value.APPROXIMATE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    APPROXIMATE -> Known.APPROXIMATE
+                    else -> throw OpenAIInvalidDataException("Unknown Type: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Type = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Type && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is UserLocation &&
+                city == other.city &&
+                country == other.country &&
+                region == other.region &&
+                timezone == other.timezone &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(city, country, region, timezone, type, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "UserLocation{city=$city, country=$country, region=$region, timezone=$timezone, type=$type, additionalProperties=$additionalProperties}"
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaWebSearchTool &&
+            type == other.type &&
+            filters == other.filters &&
+            searchContextSize == other.searchContextSize &&
+            userLocation == other.userLocation &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(type, filters, searchContextSize, userLocation, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaWebSearchTool{type=$type, filters=$filters, searchContextSize=$searchContextSize, userLocation=$userLocation, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseCancelParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseCancelParams.kt
new file mode 100644
index 000000000..be44a0b4f
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseCancelParams.kt
@@ -0,0 +1,396 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.openai.core.Enum
+import com.openai.core.JsonField
+import com.openai.core.JsonValue
+import com.openai.core.Params
+import com.openai.core.http.Headers
+import com.openai.core.http.QueryParams
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Cancels a model response with the given ID. Only responses created with the `background`
+ * parameter set to `true` can be cancelled.
+ * [Learn more](https://platform.openai.com/docs/guides/background).
+ */
+class ResponseCancelParams
+private constructor(
+    private val responseId: String?,
+    private val betas: List<Beta>?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+    private val additionalBodyProperties: Map<String, JsonValue>,
+) : Params {
+
+    fun responseId(): Optional<String> = Optional.ofNullable(responseId)
+
+    fun betas(): Optional<List<Beta>> = Optional.ofNullable(betas)
+
+    /** Additional body properties to send with the request. */
+    fun _additionalBodyProperties(): Map<String, JsonValue> = additionalBodyProperties
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): ResponseCancelParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [ResponseCancelParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ResponseCancelParams]. */
+    class Builder internal constructor() {
+
+        private var responseId: String? = null
+        private var betas: MutableList<Beta>? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+        private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(responseCancelParams: ResponseCancelParams) = apply {
+            responseId = responseCancelParams.responseId
+            betas = responseCancelParams.betas?.toMutableList()
+            additionalHeaders = responseCancelParams.additionalHeaders.toBuilder()
+            additionalQueryParams = responseCancelParams.additionalQueryParams.toBuilder()
+            additionalBodyProperties = responseCancelParams.additionalBodyProperties.toMutableMap()
+        }
+
+        fun responseId(responseId: String?) = apply { this.responseId = responseId }
+
+        /** Alias for calling [Builder.responseId] with `responseId.orElse(null)`. */
+        fun responseId(responseId: Optional<String>) = responseId(responseId.getOrNull())
+
+        fun betas(betas: List<Beta>?) = apply { this.betas = betas?.toMutableList() }
+
+        /** Alias for calling [Builder.betas] with `betas.orElse(null)`. */
+        fun betas(betas: Optional<List<Beta>>) = betas(betas.getOrNull())
+
+        /**
+         * Adds a single [Beta] to [betas].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addBeta(beta: Beta) = apply { betas = (betas ?: mutableListOf()).apply { add(beta) } }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            this.additionalBodyProperties.clear()
+            putAllAdditionalBodyProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            additionalBodyProperties.put(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                this.additionalBodyProperties.putAll(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply {
+            additionalBodyProperties.remove(key)
+        }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalBodyProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [ResponseCancelParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ResponseCancelParams =
+            ResponseCancelParams(
+                responseId,
+                betas?.toImmutable(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+                additionalBodyProperties.toImmutable(),
+            )
+    }
+
+    fun _body(): Optional<Map<String, JsonValue>> =
+        Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> responseId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers =
+        Headers.builder()
+            .apply {
+                betas?.forEach { put("openai-beta", it.toString()) }
+                putAll(additionalHeaders)
+            }
+            .build()
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Beta @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val RESPONSES_MULTI_AGENT_V1 = of("responses_multi_agent=v1")
+
+            @JvmStatic fun of(value: String) = Beta(JsonField.of(value))
+        }
+
+        /** An enum containing [Beta]'s known values. */
+        enum class Known {
+            RESPONSES_MULTI_AGENT_V1
+        }
+
+        /**
+         * An enum containing [Beta]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Beta] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            RESPONSES_MULTI_AGENT_V1,
+            /** An enum member indicating that [Beta] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                RESPONSES_MULTI_AGENT_V1 -> Value.RESPONSES_MULTI_AGENT_V1
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                RESPONSES_MULTI_AGENT_V1 -> Known.RESPONSES_MULTI_AGENT_V1
+                else -> throw OpenAIInvalidDataException("Unknown Beta: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Beta = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Beta && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ResponseCancelParams &&
+            responseId == other.responseId &&
+            betas == other.betas &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams &&
+            additionalBodyProperties == other.additionalBodyProperties
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(
+            responseId,
+            betas,
+            additionalHeaders,
+            additionalQueryParams,
+            additionalBodyProperties,
+        )
+
+    override fun toString() =
+        "ResponseCancelParams{responseId=$responseId, betas=$betas, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseCompactParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseCompactParams.kt
new file mode 100644
index 000000000..1974fb8e5
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseCompactParams.kt
@@ -0,0 +1,3060 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.Params
+import com.openai.core.allMaxBy
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.http.Headers
+import com.openai.core.http.QueryParams
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Compact a conversation. Returns a compacted response object.
+ *
+ * Learn when and how to compact long-running conversations in the
+ * [conversation state guide](https://platform.openai.com/docs/guides/conversation-state#managing-the-context-window).
+ * For ZDR-compatible compaction details, see
+ * [Compaction (advanced)](https://platform.openai.com/docs/guides/conversation-state#compaction-advanced).
+ */
+class ResponseCompactParams
+private constructor(
+    private val betas: List<Beta>?,
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun betas(): Optional<List<Beta>> = Optional.ofNullable(betas)
+
+    /**
+     * Model ID used to generate the response, like `gpt-5` or `o3`. OpenAI offers a wide range of
+     * models with different capabilities, performance characteristics, and price points. Refer to
+     * the [model guide](https://platform.openai.com/docs/models) to browse and compare available
+     * models.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun model(): Optional<Model> = body.model()
+
+    /**
+     * Text, image, or file inputs to the model, used to generate a response
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun input(): Optional<Input> = body.input()
+
+    /**
+     * A system (or developer) message inserted into the model's context. When used along with
+     * `previous_response_id`, the instructions from a previous response will not be carried over to
+     * the next response. This makes it simple to swap out system (or developer) messages in new
+     * responses.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun instructions(): Optional<String> = body.instructions()
+
+    /**
+     * The unique ID of the previous response to the model. Use this to create multi-turn
+     * conversations. Learn more about
+     * [conversation state](https://platform.openai.com/docs/guides/conversation-state). Cannot be
+     * used in conjunction with `conversation`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun previousResponseId(): Optional<String> = body.previousResponseId()
+
+    /**
+     * A key to use when reading from or writing to the prompt cache.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheKey(): Optional<String> = body.promptCacheKey()
+
+    /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+     * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+     * content blocks with `prompt_cache_breakpoint`. Each request can write up to four breakpoints.
+     * For cache matching, OpenAI considers up to the latest 80 breakpoints in the conversation,
+     * without a content-block lookback limit. Set `mode` to `explicit` to disable the implicit
+     * breakpoint. The `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for current
+     * details.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheOptions(): Optional<PromptCacheOptions> = body.promptCacheOptions()
+
+    /**
+     * How long to retain a prompt cache entry created by this request.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    @Deprecated("deprecated")
+    fun promptCacheRetention(): Optional<PromptCacheRetention> = body.promptCacheRetention()
+
+    /**
+     * The service tier to use for this request.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun serviceTier(): Optional<ServiceTier> = body.serviceTier()
+
+    /**
+     * Returns the raw JSON value of [model].
+     *
+     * Unlike [model], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _model(): JsonField<Model> = body._model()
+
+    /**
+     * Returns the raw JSON value of [input].
+     *
+     * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _input(): JsonField<Input> = body._input()
+
+    /**
+     * Returns the raw JSON value of [instructions].
+     *
+     * Unlike [instructions], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _instructions(): JsonField<String> = body._instructions()
+
+    /**
+     * Returns the raw JSON value of [previousResponseId].
+     *
+     * Unlike [previousResponseId], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    fun _previousResponseId(): JsonField<String> = body._previousResponseId()
+
+    /**
+     * Returns the raw JSON value of [promptCacheKey].
+     *
+     * Unlike [promptCacheKey], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _promptCacheKey(): JsonField<String> = body._promptCacheKey()
+
+    /**
+     * Returns the raw JSON value of [promptCacheOptions].
+     *
+     * Unlike [promptCacheOptions], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    fun _promptCacheOptions(): JsonField<PromptCacheOptions> = body._promptCacheOptions()
+
+    /**
+     * Returns the raw JSON value of [promptCacheRetention].
+     *
+     * Unlike [promptCacheRetention], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @Deprecated("deprecated")
+    fun _promptCacheRetention(): JsonField<PromptCacheRetention> = body._promptCacheRetention()
+
+    /**
+     * Returns the raw JSON value of [serviceTier].
+     *
+     * Unlike [serviceTier], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _serviceTier(): JsonField<ServiceTier> = body._serviceTier()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [ResponseCompactParams].
+         *
+         * The following fields are required:
+         * ```java
+         * .model()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ResponseCompactParams]. */
+    class Builder internal constructor() {
+
+        private var betas: MutableList<Beta>? = null
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(responseCompactParams: ResponseCompactParams) = apply {
+            betas = responseCompactParams.betas?.toMutableList()
+            body = responseCompactParams.body.toBuilder()
+            additionalHeaders = responseCompactParams.additionalHeaders.toBuilder()
+            additionalQueryParams = responseCompactParams.additionalQueryParams.toBuilder()
+        }
+
+        fun betas(betas: List<Beta>?) = apply { this.betas = betas?.toMutableList() }
+
+        /** Alias for calling [Builder.betas] with `betas.orElse(null)`. */
+        fun betas(betas: Optional<List<Beta>>) = betas(betas.getOrNull())
+
+        /**
+         * Adds a single [Beta] to [betas].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addBeta(beta: Beta) = apply { betas = (betas ?: mutableListOf()).apply { add(beta) } }
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [model]
+         * - [input]
+         * - [instructions]
+         * - [previousResponseId]
+         * - [promptCacheKey]
+         * - etc.
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /**
+         * Model ID used to generate the response, like `gpt-5` or `o3`. OpenAI offers a wide range
+         * of models with different capabilities, performance characteristics, and price points.
+         * Refer to the [model guide](https://platform.openai.com/docs/models) to browse and compare
+         * available models.
+         */
+        fun model(model: Model?) = apply { body.model(model) }
+
+        /** Alias for calling [Builder.model] with `model.orElse(null)`. */
+        fun model(model: Optional<Model>) = model(model.getOrNull())
+
+        /**
+         * Sets [Builder.model] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.model] with a well-typed [Model] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun model(model: JsonField<Model>) = apply { body.model(model) }
+
+        /**
+         * Sets [model] to an arbitrary [String].
+         *
+         * You should usually call [model] with a well-typed [Model] constant instead. This method
+         * is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun model(value: String) = apply { body.model(value) }
+
+        /** Text, image, or file inputs to the model, used to generate a response */
+        fun input(input: Input?) = apply { body.input(input) }
+
+        /** Alias for calling [Builder.input] with `input.orElse(null)`. */
+        fun input(input: Optional<Input>) = input(input.getOrNull())
+
+        /**
+         * Sets [Builder.input] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.input] with a well-typed [Input] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun input(input: JsonField<Input>) = apply { body.input(input) }
+
+        /** Alias for calling [input] with `Input.ofString(string)`. */
+        fun input(string: String) = apply { body.input(string) }
+
+        /**
+         * Alias for calling [input] with `Input.ofBetaResponseInputItems(betaResponseInputItems)`.
+         */
+        fun inputOfBetaResponseInputItems(betaResponseInputItems: List<BetaResponseInputItem>) =
+            apply {
+                body.inputOfBetaResponseInputItems(betaResponseInputItems)
+            }
+
+        /**
+         * A system (or developer) message inserted into the model's context. When used along with
+         * `previous_response_id`, the instructions from a previous response will not be carried
+         * over to the next response. This makes it simple to swap out system (or developer)
+         * messages in new responses.
+         */
+        fun instructions(instructions: String?) = apply { body.instructions(instructions) }
+
+        /** Alias for calling [Builder.instructions] with `instructions.orElse(null)`. */
+        fun instructions(instructions: Optional<String>) = instructions(instructions.getOrNull())
+
+        /**
+         * Sets [Builder.instructions] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.instructions] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun instructions(instructions: JsonField<String>) = apply {
+            body.instructions(instructions)
+        }
+
+        /**
+         * The unique ID of the previous response to the model. Use this to create multi-turn
+         * conversations. Learn more about
+         * [conversation state](https://platform.openai.com/docs/guides/conversation-state). Cannot
+         * be used in conjunction with `conversation`.
+         */
+        fun previousResponseId(previousResponseId: String?) = apply {
+            body.previousResponseId(previousResponseId)
+        }
+
+        /**
+         * Alias for calling [Builder.previousResponseId] with `previousResponseId.orElse(null)`.
+         */
+        fun previousResponseId(previousResponseId: Optional<String>) =
+            previousResponseId(previousResponseId.getOrNull())
+
+        /**
+         * Sets [Builder.previousResponseId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.previousResponseId] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun previousResponseId(previousResponseId: JsonField<String>) = apply {
+            body.previousResponseId(previousResponseId)
+        }
+
+        /** A key to use when reading from or writing to the prompt cache. */
+        fun promptCacheKey(promptCacheKey: String?) = apply { body.promptCacheKey(promptCacheKey) }
+
+        /** Alias for calling [Builder.promptCacheKey] with `promptCacheKey.orElse(null)`. */
+        fun promptCacheKey(promptCacheKey: Optional<String>) =
+            promptCacheKey(promptCacheKey.getOrNull())
+
+        /**
+         * Sets [Builder.promptCacheKey] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheKey] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun promptCacheKey(promptCacheKey: JsonField<String>) = apply {
+            body.promptCacheKey(promptCacheKey)
+        }
+
+        /**
+         * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+         * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+         * content blocks with `prompt_cache_breakpoint`. Each request can write up to four
+         * breakpoints. For cache matching, OpenAI considers up to the latest 80 breakpoints in the
+         * conversation, without a content-block lookback limit. Set `mode` to `explicit` to disable
+         * the implicit breakpoint. The `ttl` defaults to `30m`, which is currently the only
+         * supported value. See the
+         * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+         * current details.
+         */
+        fun promptCacheOptions(promptCacheOptions: PromptCacheOptions?) = apply {
+            body.promptCacheOptions(promptCacheOptions)
+        }
+
+        /**
+         * Alias for calling [Builder.promptCacheOptions] with `promptCacheOptions.orElse(null)`.
+         */
+        fun promptCacheOptions(promptCacheOptions: Optional<PromptCacheOptions>) =
+            promptCacheOptions(promptCacheOptions.getOrNull())
+
+        /**
+         * Sets [Builder.promptCacheOptions] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheOptions] with a well-typed
+         * [PromptCacheOptions] value instead. This method is primarily for setting the field to an
+         * undocumented or not yet supported value.
+         */
+        fun promptCacheOptions(promptCacheOptions: JsonField<PromptCacheOptions>) = apply {
+            body.promptCacheOptions(promptCacheOptions)
+        }
+
+        /** How long to retain a prompt cache entry created by this request. */
+        @Deprecated("deprecated")
+        fun promptCacheRetention(promptCacheRetention: PromptCacheRetention?) = apply {
+            body.promptCacheRetention(promptCacheRetention)
+        }
+
+        /**
+         * Alias for calling [Builder.promptCacheRetention] with
+         * `promptCacheRetention.orElse(null)`.
+         */
+        @Deprecated("deprecated")
+        fun promptCacheRetention(promptCacheRetention: Optional<PromptCacheRetention>) =
+            promptCacheRetention(promptCacheRetention.getOrNull())
+
+        /**
+         * Sets [Builder.promptCacheRetention] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheRetention] with a well-typed
+         * [PromptCacheRetention] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        @Deprecated("deprecated")
+        fun promptCacheRetention(promptCacheRetention: JsonField<PromptCacheRetention>) = apply {
+            body.promptCacheRetention(promptCacheRetention)
+        }
+
+        /** The service tier to use for this request. */
+        fun serviceTier(serviceTier: ServiceTier?) = apply { body.serviceTier(serviceTier) }
+
+        /** Alias for calling [Builder.serviceTier] with `serviceTier.orElse(null)`. */
+        fun serviceTier(serviceTier: Optional<ServiceTier>) = serviceTier(serviceTier.getOrNull())
+
+        /**
+         * Sets [Builder.serviceTier] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.serviceTier] with a well-typed [ServiceTier] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun serviceTier(serviceTier: JsonField<ServiceTier>) = apply {
+            body.serviceTier(serviceTier)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [ResponseCompactParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .model()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): ResponseCompactParams =
+            ResponseCompactParams(
+                betas?.toImmutable(),
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Body = body
+
+    override fun _headers(): Headers =
+        Headers.builder()
+            .apply {
+                betas?.forEach { put("openai-beta", it.toString()) }
+                putAll(additionalHeaders)
+            }
+            .build()
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val model: JsonField<Model>,
+        private val input: JsonField<Input>,
+        private val instructions: JsonField<String>,
+        private val previousResponseId: JsonField<String>,
+        private val promptCacheKey: JsonField<String>,
+        private val promptCacheOptions: JsonField<PromptCacheOptions>,
+        private val promptCacheRetention: JsonField<PromptCacheRetention>,
+        private val serviceTier: JsonField<ServiceTier>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("model") @ExcludeMissing model: JsonField<Model> = JsonMissing.of(),
+            @JsonProperty("input") @ExcludeMissing input: JsonField<Input> = JsonMissing.of(),
+            @JsonProperty("instructions")
+            @ExcludeMissing
+            instructions: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("previous_response_id")
+            @ExcludeMissing
+            previousResponseId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("prompt_cache_key")
+            @ExcludeMissing
+            promptCacheKey: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("prompt_cache_options")
+            @ExcludeMissing
+            promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of(),
+            @JsonProperty("prompt_cache_retention")
+            @ExcludeMissing
+            promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of(),
+            @JsonProperty("service_tier")
+            @ExcludeMissing
+            serviceTier: JsonField<ServiceTier> = JsonMissing.of(),
+        ) : this(
+            model,
+            input,
+            instructions,
+            previousResponseId,
+            promptCacheKey,
+            promptCacheOptions,
+            promptCacheRetention,
+            serviceTier,
+            mutableMapOf(),
+        )
+
+        /**
+         * Model ID used to generate the response, like `gpt-5` or `o3`. OpenAI offers a wide range
+         * of models with different capabilities, performance characteristics, and price points.
+         * Refer to the [model guide](https://platform.openai.com/docs/models) to browse and compare
+         * available models.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun model(): Optional<Model> = model.getOptional("model")
+
+        /**
+         * Text, image, or file inputs to the model, used to generate a response
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun input(): Optional<Input> = input.getOptional("input")
+
+        /**
+         * A system (or developer) message inserted into the model's context. When used along with
+         * `previous_response_id`, the instructions from a previous response will not be carried
+         * over to the next response. This makes it simple to swap out system (or developer)
+         * messages in new responses.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun instructions(): Optional<String> = instructions.getOptional("instructions")
+
+        /**
+         * The unique ID of the previous response to the model. Use this to create multi-turn
+         * conversations. Learn more about
+         * [conversation state](https://platform.openai.com/docs/guides/conversation-state). Cannot
+         * be used in conjunction with `conversation`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun previousResponseId(): Optional<String> =
+            previousResponseId.getOptional("previous_response_id")
+
+        /**
+         * A key to use when reading from or writing to the prompt cache.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun promptCacheKey(): Optional<String> = promptCacheKey.getOptional("prompt_cache_key")
+
+        /**
+         * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+         * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+         * content blocks with `prompt_cache_breakpoint`. Each request can write up to four
+         * breakpoints. For cache matching, OpenAI considers up to the latest 80 breakpoints in the
+         * conversation, without a content-block lookback limit. Set `mode` to `explicit` to disable
+         * the implicit breakpoint. The `ttl` defaults to `30m`, which is currently the only
+         * supported value. See the
+         * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+         * current details.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun promptCacheOptions(): Optional<PromptCacheOptions> =
+            promptCacheOptions.getOptional("prompt_cache_options")
+
+        /**
+         * How long to retain a prompt cache entry created by this request.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        @Deprecated("deprecated")
+        fun promptCacheRetention(): Optional<PromptCacheRetention> =
+            promptCacheRetention.getOptional("prompt_cache_retention")
+
+        /**
+         * The service tier to use for this request.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun serviceTier(): Optional<ServiceTier> = serviceTier.getOptional("service_tier")
+
+        /**
+         * Returns the raw JSON value of [model].
+         *
+         * Unlike [model], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("model") @ExcludeMissing fun _model(): JsonField<Model> = model
+
+        /**
+         * Returns the raw JSON value of [input].
+         *
+         * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("input") @ExcludeMissing fun _input(): JsonField<Input> = input
+
+        /**
+         * Returns the raw JSON value of [instructions].
+         *
+         * Unlike [instructions], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("instructions")
+        @ExcludeMissing
+        fun _instructions(): JsonField<String> = instructions
+
+        /**
+         * Returns the raw JSON value of [previousResponseId].
+         *
+         * Unlike [previousResponseId], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @JsonProperty("previous_response_id")
+        @ExcludeMissing
+        fun _previousResponseId(): JsonField<String> = previousResponseId
+
+        /**
+         * Returns the raw JSON value of [promptCacheKey].
+         *
+         * Unlike [promptCacheKey], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("prompt_cache_key")
+        @ExcludeMissing
+        fun _promptCacheKey(): JsonField<String> = promptCacheKey
+
+        /**
+         * Returns the raw JSON value of [promptCacheOptions].
+         *
+         * Unlike [promptCacheOptions], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @JsonProperty("prompt_cache_options")
+        @ExcludeMissing
+        fun _promptCacheOptions(): JsonField<PromptCacheOptions> = promptCacheOptions
+
+        /**
+         * Returns the raw JSON value of [promptCacheRetention].
+         *
+         * Unlike [promptCacheRetention], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @Deprecated("deprecated")
+        @JsonProperty("prompt_cache_retention")
+        @ExcludeMissing
+        fun _promptCacheRetention(): JsonField<PromptCacheRetention> = promptCacheRetention
+
+        /**
+         * Returns the raw JSON value of [serviceTier].
+         *
+         * Unlike [serviceTier], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("service_tier")
+        @ExcludeMissing
+        fun _serviceTier(): JsonField<ServiceTier> = serviceTier
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Body].
+             *
+             * The following fields are required:
+             * ```java
+             * .model()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var model: JsonField<Model>? = null
+            private var input: JsonField<Input> = JsonMissing.of()
+            private var instructions: JsonField<String> = JsonMissing.of()
+            private var previousResponseId: JsonField<String> = JsonMissing.of()
+            private var promptCacheKey: JsonField<String> = JsonMissing.of()
+            private var promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of()
+            private var promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of()
+            private var serviceTier: JsonField<ServiceTier> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                model = body.model
+                input = body.input
+                instructions = body.instructions
+                previousResponseId = body.previousResponseId
+                promptCacheKey = body.promptCacheKey
+                promptCacheOptions = body.promptCacheOptions
+                promptCacheRetention = body.promptCacheRetention
+                serviceTier = body.serviceTier
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Model ID used to generate the response, like `gpt-5` or `o3`. OpenAI offers a wide
+             * range of models with different capabilities, performance characteristics, and price
+             * points. Refer to the [model guide](https://platform.openai.com/docs/models) to browse
+             * and compare available models.
+             */
+            fun model(model: Model?) = model(JsonField.ofNullable(model))
+
+            /** Alias for calling [Builder.model] with `model.orElse(null)`. */
+            fun model(model: Optional<Model>) = model(model.getOrNull())
+
+            /**
+             * Sets [Builder.model] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.model] with a well-typed [Model] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun model(model: JsonField<Model>) = apply { this.model = model }
+
+            /**
+             * Sets [model] to an arbitrary [String].
+             *
+             * You should usually call [model] with a well-typed [Model] constant instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun model(value: String) = model(Model.of(value))
+
+            /** Text, image, or file inputs to the model, used to generate a response */
+            fun input(input: Input?) = input(JsonField.ofNullable(input))
+
+            /** Alias for calling [Builder.input] with `input.orElse(null)`. */
+            fun input(input: Optional<Input>) = input(input.getOrNull())
+
+            /**
+             * Sets [Builder.input] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.input] with a well-typed [Input] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun input(input: JsonField<Input>) = apply { this.input = input }
+
+            /** Alias for calling [input] with `Input.ofString(string)`. */
+            fun input(string: String) = input(Input.ofString(string))
+
+            /**
+             * Alias for calling [input] with
+             * `Input.ofBetaResponseInputItems(betaResponseInputItems)`.
+             */
+            fun inputOfBetaResponseInputItems(betaResponseInputItems: List<BetaResponseInputItem>) =
+                input(Input.ofBetaResponseInputItems(betaResponseInputItems))
+
+            /**
+             * A system (or developer) message inserted into the model's context. When used along
+             * with `previous_response_id`, the instructions from a previous response will not be
+             * carried over to the next response. This makes it simple to swap out system (or
+             * developer) messages in new responses.
+             */
+            fun instructions(instructions: String?) =
+                instructions(JsonField.ofNullable(instructions))
+
+            /** Alias for calling [Builder.instructions] with `instructions.orElse(null)`. */
+            fun instructions(instructions: Optional<String>) =
+                instructions(instructions.getOrNull())
+
+            /**
+             * Sets [Builder.instructions] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.instructions] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun instructions(instructions: JsonField<String>) = apply {
+                this.instructions = instructions
+            }
+
+            /**
+             * The unique ID of the previous response to the model. Use this to create multi-turn
+             * conversations. Learn more about
+             * [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+             * Cannot be used in conjunction with `conversation`.
+             */
+            fun previousResponseId(previousResponseId: String?) =
+                previousResponseId(JsonField.ofNullable(previousResponseId))
+
+            /**
+             * Alias for calling [Builder.previousResponseId] with
+             * `previousResponseId.orElse(null)`.
+             */
+            fun previousResponseId(previousResponseId: Optional<String>) =
+                previousResponseId(previousResponseId.getOrNull())
+
+            /**
+             * Sets [Builder.previousResponseId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.previousResponseId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun previousResponseId(previousResponseId: JsonField<String>) = apply {
+                this.previousResponseId = previousResponseId
+            }
+
+            /** A key to use when reading from or writing to the prompt cache. */
+            fun promptCacheKey(promptCacheKey: String?) =
+                promptCacheKey(JsonField.ofNullable(promptCacheKey))
+
+            /** Alias for calling [Builder.promptCacheKey] with `promptCacheKey.orElse(null)`. */
+            fun promptCacheKey(promptCacheKey: Optional<String>) =
+                promptCacheKey(promptCacheKey.getOrNull())
+
+            /**
+             * Sets [Builder.promptCacheKey] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.promptCacheKey] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun promptCacheKey(promptCacheKey: JsonField<String>) = apply {
+                this.promptCacheKey = promptCacheKey
+            }
+
+            /**
+             * Options for prompt caching. Supported for `gpt-5.6` and later models. By default,
+             * OpenAI automatically chooses one implicit cache breakpoint. You can add explicit
+             * breakpoints to content blocks with `prompt_cache_breakpoint`. Each request can write
+             * up to four breakpoints. For cache matching, OpenAI considers up to the latest 80
+             * breakpoints in the conversation, without a content-block lookback limit. Set `mode`
+             * to `explicit` to disable the implicit breakpoint. The `ttl` defaults to `30m`, which
+             * is currently the only supported value. See the
+             * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+             * current details.
+             */
+            fun promptCacheOptions(promptCacheOptions: PromptCacheOptions?) =
+                promptCacheOptions(JsonField.ofNullable(promptCacheOptions))
+
+            /**
+             * Alias for calling [Builder.promptCacheOptions] with
+             * `promptCacheOptions.orElse(null)`.
+             */
+            fun promptCacheOptions(promptCacheOptions: Optional<PromptCacheOptions>) =
+                promptCacheOptions(promptCacheOptions.getOrNull())
+
+            /**
+             * Sets [Builder.promptCacheOptions] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.promptCacheOptions] with a well-typed
+             * [PromptCacheOptions] value instead. This method is primarily for setting the field to
+             * an undocumented or not yet supported value.
+             */
+            fun promptCacheOptions(promptCacheOptions: JsonField<PromptCacheOptions>) = apply {
+                this.promptCacheOptions = promptCacheOptions
+            }
+
+            /** How long to retain a prompt cache entry created by this request. */
+            @Deprecated("deprecated")
+            fun promptCacheRetention(promptCacheRetention: PromptCacheRetention?) =
+                promptCacheRetention(JsonField.ofNullable(promptCacheRetention))
+
+            /**
+             * Alias for calling [Builder.promptCacheRetention] with
+             * `promptCacheRetention.orElse(null)`.
+             */
+            @Deprecated("deprecated")
+            fun promptCacheRetention(promptCacheRetention: Optional<PromptCacheRetention>) =
+                promptCacheRetention(promptCacheRetention.getOrNull())
+
+            /**
+             * Sets [Builder.promptCacheRetention] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.promptCacheRetention] with a well-typed
+             * [PromptCacheRetention] value instead. This method is primarily for setting the field
+             * to an undocumented or not yet supported value.
+             */
+            @Deprecated("deprecated")
+            fun promptCacheRetention(promptCacheRetention: JsonField<PromptCacheRetention>) =
+                apply {
+                    this.promptCacheRetention = promptCacheRetention
+                }
+
+            /** The service tier to use for this request. */
+            fun serviceTier(serviceTier: ServiceTier?) =
+                serviceTier(JsonField.ofNullable(serviceTier))
+
+            /** Alias for calling [Builder.serviceTier] with `serviceTier.orElse(null)`. */
+            fun serviceTier(serviceTier: Optional<ServiceTier>) =
+                serviceTier(serviceTier.getOrNull())
+
+            /**
+             * Sets [Builder.serviceTier] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serviceTier] with a well-typed [ServiceTier] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun serviceTier(serviceTier: JsonField<ServiceTier>) = apply {
+                this.serviceTier = serviceTier
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .model()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Body =
+                Body(
+                    checkRequired("model", model),
+                    input,
+                    instructions,
+                    previousResponseId,
+                    promptCacheKey,
+                    promptCacheOptions,
+                    promptCacheRetention,
+                    serviceTier,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            model()
+            input().ifPresent { it.validate() }
+            instructions()
+            previousResponseId()
+            promptCacheKey()
+            promptCacheOptions().ifPresent { it.validate() }
+            promptCacheRetention().ifPresent { it.validate() }
+            serviceTier().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (model.asKnown().isPresent) 1 else 0) +
+                (input.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (instructions.asKnown().isPresent) 1 else 0) +
+                (if (previousResponseId.asKnown().isPresent) 1 else 0) +
+                (if (promptCacheKey.asKnown().isPresent) 1 else 0) +
+                (promptCacheOptions.asKnown().getOrNull()?.validity() ?: 0) +
+                (promptCacheRetention.asKnown().getOrNull()?.validity() ?: 0) +
+                (serviceTier.asKnown().getOrNull()?.validity() ?: 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                model == other.model &&
+                input == other.input &&
+                instructions == other.instructions &&
+                previousResponseId == other.previousResponseId &&
+                promptCacheKey == other.promptCacheKey &&
+                promptCacheOptions == other.promptCacheOptions &&
+                promptCacheRetention == other.promptCacheRetention &&
+                serviceTier == other.serviceTier &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                model,
+                input,
+                instructions,
+                previousResponseId,
+                promptCacheKey,
+                promptCacheOptions,
+                promptCacheRetention,
+                serviceTier,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Body{model=$model, input=$input, instructions=$instructions, previousResponseId=$previousResponseId, promptCacheKey=$promptCacheKey, promptCacheOptions=$promptCacheOptions, promptCacheRetention=$promptCacheRetention, serviceTier=$serviceTier, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Model ID used to generate the response, like `gpt-5` or `o3`. OpenAI offers a wide range of
+     * models with different capabilities, performance characteristics, and price points. Refer to
+     * the [model guide](https://platform.openai.com/docs/models) to browse and compare available
+     * models.
+     */
+    class Model @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val GPT_5_6_SOL = of("gpt-5.6-sol")
+
+            @JvmField val GPT_5_6_TERRA = of("gpt-5.6-terra")
+
+            @JvmField val GPT_5_6_LUNA = of("gpt-5.6-luna")
+
+            @JvmField val GPT_5_4 = of("gpt-5.4")
+
+            @JvmField val GPT_5_4_MINI = of("gpt-5.4-mini")
+
+            @JvmField val GPT_5_4_NANO = of("gpt-5.4-nano")
+
+            @JvmField val GPT_5_4_MINI_2026_03_17 = of("gpt-5.4-mini-2026-03-17")
+
+            @JvmField val GPT_5_4_NANO_2026_03_17 = of("gpt-5.4-nano-2026-03-17")
+
+            @JvmField val GPT_5_3_CHAT_LATEST = of("gpt-5.3-chat-latest")
+
+            @JvmField val GPT_5_2 = of("gpt-5.2")
+
+            @JvmField val GPT_5_2_2025_12_11 = of("gpt-5.2-2025-12-11")
+
+            @JvmField val GPT_5_2_CHAT_LATEST = of("gpt-5.2-chat-latest")
+
+            @JvmField val GPT_5_2_PRO = of("gpt-5.2-pro")
+
+            @JvmField val GPT_5_2_PRO_2025_12_11 = of("gpt-5.2-pro-2025-12-11")
+
+            @JvmField val GPT_5_1 = of("gpt-5.1")
+
+            @JvmField val GPT_5_1_2025_11_13 = of("gpt-5.1-2025-11-13")
+
+            @JvmField val GPT_5_1_CODEX = of("gpt-5.1-codex")
+
+            @JvmField val GPT_5_1_MINI = of("gpt-5.1-mini")
+
+            @JvmField val GPT_5_1_CHAT_LATEST = of("gpt-5.1-chat-latest")
+
+            @JvmField val GPT_5 = of("gpt-5")
+
+            @JvmField val GPT_5_MINI = of("gpt-5-mini")
+
+            @JvmField val GPT_5_NANO = of("gpt-5-nano")
+
+            @JvmField val GPT_5_2025_08_07 = of("gpt-5-2025-08-07")
+
+            @JvmField val GPT_5_MINI_2025_08_07 = of("gpt-5-mini-2025-08-07")
+
+            @JvmField val GPT_5_NANO_2025_08_07 = of("gpt-5-nano-2025-08-07")
+
+            @JvmField val GPT_5_CHAT_LATEST = of("gpt-5-chat-latest")
+
+            @JvmField val GPT_4_1 = of("gpt-4.1")
+
+            @JvmField val GPT_4_1_MINI = of("gpt-4.1-mini")
+
+            @JvmField val GPT_4_1_NANO = of("gpt-4.1-nano")
+
+            @JvmField val GPT_4_1_2025_04_14 = of("gpt-4.1-2025-04-14")
+
+            @JvmField val GPT_4_1_MINI_2025_04_14 = of("gpt-4.1-mini-2025-04-14")
+
+            @JvmField val GPT_4_1_NANO_2025_04_14 = of("gpt-4.1-nano-2025-04-14")
+
+            @JvmField val O4_MINI = of("o4-mini")
+
+            @JvmField val O4_MINI_2025_04_16 = of("o4-mini-2025-04-16")
+
+            @JvmField val O3 = of("o3")
+
+            @JvmField val O3_2025_04_16 = of("o3-2025-04-16")
+
+            @JvmField val O3_MINI = of("o3-mini")
+
+            @JvmField val O3_MINI_2025_01_31 = of("o3-mini-2025-01-31")
+
+            @JvmField val O1 = of("o1")
+
+            @JvmField val O1_2024_12_17 = of("o1-2024-12-17")
+
+            @JvmField val O1_PREVIEW = of("o1-preview")
+
+            @JvmField val O1_PREVIEW_2024_09_12 = of("o1-preview-2024-09-12")
+
+            @JvmField val O1_MINI = of("o1-mini")
+
+            @JvmField val O1_MINI_2024_09_12 = of("o1-mini-2024-09-12")
+
+            @JvmField val GPT_4O = of("gpt-4o")
+
+            @JvmField val GPT_4O_2024_11_20 = of("gpt-4o-2024-11-20")
+
+            @JvmField val GPT_4O_2024_08_06 = of("gpt-4o-2024-08-06")
+
+            @JvmField val GPT_4O_2024_05_13 = of("gpt-4o-2024-05-13")
+
+            @JvmField val GPT_4O_AUDIO_PREVIEW = of("gpt-4o-audio-preview")
+
+            @JvmField val GPT_4O_AUDIO_PREVIEW_2024_10_01 = of("gpt-4o-audio-preview-2024-10-01")
+
+            @JvmField val GPT_4O_AUDIO_PREVIEW_2024_12_17 = of("gpt-4o-audio-preview-2024-12-17")
+
+            @JvmField val GPT_4O_AUDIO_PREVIEW_2025_06_03 = of("gpt-4o-audio-preview-2025-06-03")
+
+            @JvmField val GPT_4O_MINI_AUDIO_PREVIEW = of("gpt-4o-mini-audio-preview")
+
+            @JvmField
+            val GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17 = of("gpt-4o-mini-audio-preview-2024-12-17")
+
+            @JvmField val GPT_4O_SEARCH_PREVIEW = of("gpt-4o-search-preview")
+
+            @JvmField val GPT_4O_MINI_SEARCH_PREVIEW = of("gpt-4o-mini-search-preview")
+
+            @JvmField val GPT_4O_SEARCH_PREVIEW_2025_03_11 = of("gpt-4o-search-preview-2025-03-11")
+
+            @JvmField
+            val GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11 = of("gpt-4o-mini-search-preview-2025-03-11")
+
+            @JvmField val CHATGPT_4O_LATEST = of("chatgpt-4o-latest")
+
+            @JvmField val CODEX_MINI_LATEST = of("codex-mini-latest")
+
+            @JvmField val GPT_4O_MINI = of("gpt-4o-mini")
+
+            @JvmField val GPT_4O_MINI_2024_07_18 = of("gpt-4o-mini-2024-07-18")
+
+            @JvmField val GPT_4_TURBO = of("gpt-4-turbo")
+
+            @JvmField val GPT_4_TURBO_2024_04_09 = of("gpt-4-turbo-2024-04-09")
+
+            @JvmField val GPT_4_0125_PREVIEW = of("gpt-4-0125-preview")
+
+            @JvmField val GPT_4_TURBO_PREVIEW = of("gpt-4-turbo-preview")
+
+            @JvmField val GPT_4_1106_PREVIEW = of("gpt-4-1106-preview")
+
+            @JvmField val GPT_4_VISION_PREVIEW = of("gpt-4-vision-preview")
+
+            @JvmField val GPT_4 = of("gpt-4")
+
+            @JvmField val GPT_4_0314 = of("gpt-4-0314")
+
+            @JvmField val GPT_4_0613 = of("gpt-4-0613")
+
+            @JvmField val GPT_4_32K = of("gpt-4-32k")
+
+            @JvmField val GPT_4_32K_0314 = of("gpt-4-32k-0314")
+
+            @JvmField val GPT_4_32K_0613 = of("gpt-4-32k-0613")
+
+            @JvmField val GPT_3_5_TURBO = of("gpt-3.5-turbo")
+
+            @JvmField val GPT_3_5_TURBO_16K = of("gpt-3.5-turbo-16k")
+
+            @JvmField val GPT_3_5_TURBO_0301 = of("gpt-3.5-turbo-0301")
+
+            @JvmField val GPT_3_5_TURBO_0613 = of("gpt-3.5-turbo-0613")
+
+            @JvmField val GPT_3_5_TURBO_1106 = of("gpt-3.5-turbo-1106")
+
+            @JvmField val GPT_3_5_TURBO_0125 = of("gpt-3.5-turbo-0125")
+
+            @JvmField val GPT_3_5_TURBO_16K_0613 = of("gpt-3.5-turbo-16k-0613")
+
+            @JvmField val O1_PRO = of("o1-pro")
+
+            @JvmField val O1_PRO_2025_03_19 = of("o1-pro-2025-03-19")
+
+            @JvmField val O3_PRO = of("o3-pro")
+
+            @JvmField val O3_PRO_2025_06_10 = of("o3-pro-2025-06-10")
+
+            @JvmField val O3_DEEP_RESEARCH = of("o3-deep-research")
+
+            @JvmField val O3_DEEP_RESEARCH_2025_06_26 = of("o3-deep-research-2025-06-26")
+
+            @JvmField val O4_MINI_DEEP_RESEARCH = of("o4-mini-deep-research")
+
+            @JvmField val O4_MINI_DEEP_RESEARCH_2025_06_26 = of("o4-mini-deep-research-2025-06-26")
+
+            @JvmField val COMPUTER_USE_PREVIEW = of("computer-use-preview")
+
+            @JvmField val COMPUTER_USE_PREVIEW_2025_03_11 = of("computer-use-preview-2025-03-11")
+
+            @JvmField val GPT_5_CODEX = of("gpt-5-codex")
+
+            @JvmField val GPT_5_PRO = of("gpt-5-pro")
+
+            @JvmField val GPT_5_PRO_2025_10_06 = of("gpt-5-pro-2025-10-06")
+
+            @JvmField val GPT_5_1_CODEX_MAX = of("gpt-5.1-codex-max")
+
+            @JvmStatic fun of(value: String) = Model(JsonField.of(value))
+        }
+
+        /** An enum containing [Model]'s known values. */
+        enum class Known {
+            GPT_5_6_SOL,
+            GPT_5_6_TERRA,
+            GPT_5_6_LUNA,
+            GPT_5_4,
+            GPT_5_4_MINI,
+            GPT_5_4_NANO,
+            GPT_5_4_MINI_2026_03_17,
+            GPT_5_4_NANO_2026_03_17,
+            GPT_5_3_CHAT_LATEST,
+            GPT_5_2,
+            GPT_5_2_2025_12_11,
+            GPT_5_2_CHAT_LATEST,
+            GPT_5_2_PRO,
+            GPT_5_2_PRO_2025_12_11,
+            GPT_5_1,
+            GPT_5_1_2025_11_13,
+            GPT_5_1_CODEX,
+            GPT_5_1_MINI,
+            GPT_5_1_CHAT_LATEST,
+            GPT_5,
+            GPT_5_MINI,
+            GPT_5_NANO,
+            GPT_5_2025_08_07,
+            GPT_5_MINI_2025_08_07,
+            GPT_5_NANO_2025_08_07,
+            GPT_5_CHAT_LATEST,
+            GPT_4_1,
+            GPT_4_1_MINI,
+            GPT_4_1_NANO,
+            GPT_4_1_2025_04_14,
+            GPT_4_1_MINI_2025_04_14,
+            GPT_4_1_NANO_2025_04_14,
+            O4_MINI,
+            O4_MINI_2025_04_16,
+            O3,
+            O3_2025_04_16,
+            O3_MINI,
+            O3_MINI_2025_01_31,
+            O1,
+            O1_2024_12_17,
+            O1_PREVIEW,
+            O1_PREVIEW_2024_09_12,
+            O1_MINI,
+            O1_MINI_2024_09_12,
+            GPT_4O,
+            GPT_4O_2024_11_20,
+            GPT_4O_2024_08_06,
+            GPT_4O_2024_05_13,
+            GPT_4O_AUDIO_PREVIEW,
+            GPT_4O_AUDIO_PREVIEW_2024_10_01,
+            GPT_4O_AUDIO_PREVIEW_2024_12_17,
+            GPT_4O_AUDIO_PREVIEW_2025_06_03,
+            GPT_4O_MINI_AUDIO_PREVIEW,
+            GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17,
+            GPT_4O_SEARCH_PREVIEW,
+            GPT_4O_MINI_SEARCH_PREVIEW,
+            GPT_4O_SEARCH_PREVIEW_2025_03_11,
+            GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11,
+            CHATGPT_4O_LATEST,
+            CODEX_MINI_LATEST,
+            GPT_4O_MINI,
+            GPT_4O_MINI_2024_07_18,
+            GPT_4_TURBO,
+            GPT_4_TURBO_2024_04_09,
+            GPT_4_0125_PREVIEW,
+            GPT_4_TURBO_PREVIEW,
+            GPT_4_1106_PREVIEW,
+            GPT_4_VISION_PREVIEW,
+            GPT_4,
+            GPT_4_0314,
+            GPT_4_0613,
+            GPT_4_32K,
+            GPT_4_32K_0314,
+            GPT_4_32K_0613,
+            GPT_3_5_TURBO,
+            GPT_3_5_TURBO_16K,
+            GPT_3_5_TURBO_0301,
+            GPT_3_5_TURBO_0613,
+            GPT_3_5_TURBO_1106,
+            GPT_3_5_TURBO_0125,
+            GPT_3_5_TURBO_16K_0613,
+            O1_PRO,
+            O1_PRO_2025_03_19,
+            O3_PRO,
+            O3_PRO_2025_06_10,
+            O3_DEEP_RESEARCH,
+            O3_DEEP_RESEARCH_2025_06_26,
+            O4_MINI_DEEP_RESEARCH,
+            O4_MINI_DEEP_RESEARCH_2025_06_26,
+            COMPUTER_USE_PREVIEW,
+            COMPUTER_USE_PREVIEW_2025_03_11,
+            GPT_5_CODEX,
+            GPT_5_PRO,
+            GPT_5_PRO_2025_10_06,
+            GPT_5_1_CODEX_MAX,
+        }
+
+        /**
+         * An enum containing [Model]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Model] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            GPT_5_6_SOL,
+            GPT_5_6_TERRA,
+            GPT_5_6_LUNA,
+            GPT_5_4,
+            GPT_5_4_MINI,
+            GPT_5_4_NANO,
+            GPT_5_4_MINI_2026_03_17,
+            GPT_5_4_NANO_2026_03_17,
+            GPT_5_3_CHAT_LATEST,
+            GPT_5_2,
+            GPT_5_2_2025_12_11,
+            GPT_5_2_CHAT_LATEST,
+            GPT_5_2_PRO,
+            GPT_5_2_PRO_2025_12_11,
+            GPT_5_1,
+            GPT_5_1_2025_11_13,
+            GPT_5_1_CODEX,
+            GPT_5_1_MINI,
+            GPT_5_1_CHAT_LATEST,
+            GPT_5,
+            GPT_5_MINI,
+            GPT_5_NANO,
+            GPT_5_2025_08_07,
+            GPT_5_MINI_2025_08_07,
+            GPT_5_NANO_2025_08_07,
+            GPT_5_CHAT_LATEST,
+            GPT_4_1,
+            GPT_4_1_MINI,
+            GPT_4_1_NANO,
+            GPT_4_1_2025_04_14,
+            GPT_4_1_MINI_2025_04_14,
+            GPT_4_1_NANO_2025_04_14,
+            O4_MINI,
+            O4_MINI_2025_04_16,
+            O3,
+            O3_2025_04_16,
+            O3_MINI,
+            O3_MINI_2025_01_31,
+            O1,
+            O1_2024_12_17,
+            O1_PREVIEW,
+            O1_PREVIEW_2024_09_12,
+            O1_MINI,
+            O1_MINI_2024_09_12,
+            GPT_4O,
+            GPT_4O_2024_11_20,
+            GPT_4O_2024_08_06,
+            GPT_4O_2024_05_13,
+            GPT_4O_AUDIO_PREVIEW,
+            GPT_4O_AUDIO_PREVIEW_2024_10_01,
+            GPT_4O_AUDIO_PREVIEW_2024_12_17,
+            GPT_4O_AUDIO_PREVIEW_2025_06_03,
+            GPT_4O_MINI_AUDIO_PREVIEW,
+            GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17,
+            GPT_4O_SEARCH_PREVIEW,
+            GPT_4O_MINI_SEARCH_PREVIEW,
+            GPT_4O_SEARCH_PREVIEW_2025_03_11,
+            GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11,
+            CHATGPT_4O_LATEST,
+            CODEX_MINI_LATEST,
+            GPT_4O_MINI,
+            GPT_4O_MINI_2024_07_18,
+            GPT_4_TURBO,
+            GPT_4_TURBO_2024_04_09,
+            GPT_4_0125_PREVIEW,
+            GPT_4_TURBO_PREVIEW,
+            GPT_4_1106_PREVIEW,
+            GPT_4_VISION_PREVIEW,
+            GPT_4,
+            GPT_4_0314,
+            GPT_4_0613,
+            GPT_4_32K,
+            GPT_4_32K_0314,
+            GPT_4_32K_0613,
+            GPT_3_5_TURBO,
+            GPT_3_5_TURBO_16K,
+            GPT_3_5_TURBO_0301,
+            GPT_3_5_TURBO_0613,
+            GPT_3_5_TURBO_1106,
+            GPT_3_5_TURBO_0125,
+            GPT_3_5_TURBO_16K_0613,
+            O1_PRO,
+            O1_PRO_2025_03_19,
+            O3_PRO,
+            O3_PRO_2025_06_10,
+            O3_DEEP_RESEARCH,
+            O3_DEEP_RESEARCH_2025_06_26,
+            O4_MINI_DEEP_RESEARCH,
+            O4_MINI_DEEP_RESEARCH_2025_06_26,
+            COMPUTER_USE_PREVIEW,
+            COMPUTER_USE_PREVIEW_2025_03_11,
+            GPT_5_CODEX,
+            GPT_5_PRO,
+            GPT_5_PRO_2025_10_06,
+            GPT_5_1_CODEX_MAX,
+            /** An enum member indicating that [Model] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                GPT_5_6_SOL -> Value.GPT_5_6_SOL
+                GPT_5_6_TERRA -> Value.GPT_5_6_TERRA
+                GPT_5_6_LUNA -> Value.GPT_5_6_LUNA
+                GPT_5_4 -> Value.GPT_5_4
+                GPT_5_4_MINI -> Value.GPT_5_4_MINI
+                GPT_5_4_NANO -> Value.GPT_5_4_NANO
+                GPT_5_4_MINI_2026_03_17 -> Value.GPT_5_4_MINI_2026_03_17
+                GPT_5_4_NANO_2026_03_17 -> Value.GPT_5_4_NANO_2026_03_17
+                GPT_5_3_CHAT_LATEST -> Value.GPT_5_3_CHAT_LATEST
+                GPT_5_2 -> Value.GPT_5_2
+                GPT_5_2_2025_12_11 -> Value.GPT_5_2_2025_12_11
+                GPT_5_2_CHAT_LATEST -> Value.GPT_5_2_CHAT_LATEST
+                GPT_5_2_PRO -> Value.GPT_5_2_PRO
+                GPT_5_2_PRO_2025_12_11 -> Value.GPT_5_2_PRO_2025_12_11
+                GPT_5_1 -> Value.GPT_5_1
+                GPT_5_1_2025_11_13 -> Value.GPT_5_1_2025_11_13
+                GPT_5_1_CODEX -> Value.GPT_5_1_CODEX
+                GPT_5_1_MINI -> Value.GPT_5_1_MINI
+                GPT_5_1_CHAT_LATEST -> Value.GPT_5_1_CHAT_LATEST
+                GPT_5 -> Value.GPT_5
+                GPT_5_MINI -> Value.GPT_5_MINI
+                GPT_5_NANO -> Value.GPT_5_NANO
+                GPT_5_2025_08_07 -> Value.GPT_5_2025_08_07
+                GPT_5_MINI_2025_08_07 -> Value.GPT_5_MINI_2025_08_07
+                GPT_5_NANO_2025_08_07 -> Value.GPT_5_NANO_2025_08_07
+                GPT_5_CHAT_LATEST -> Value.GPT_5_CHAT_LATEST
+                GPT_4_1 -> Value.GPT_4_1
+                GPT_4_1_MINI -> Value.GPT_4_1_MINI
+                GPT_4_1_NANO -> Value.GPT_4_1_NANO
+                GPT_4_1_2025_04_14 -> Value.GPT_4_1_2025_04_14
+                GPT_4_1_MINI_2025_04_14 -> Value.GPT_4_1_MINI_2025_04_14
+                GPT_4_1_NANO_2025_04_14 -> Value.GPT_4_1_NANO_2025_04_14
+                O4_MINI -> Value.O4_MINI
+                O4_MINI_2025_04_16 -> Value.O4_MINI_2025_04_16
+                O3 -> Value.O3
+                O3_2025_04_16 -> Value.O3_2025_04_16
+                O3_MINI -> Value.O3_MINI
+                O3_MINI_2025_01_31 -> Value.O3_MINI_2025_01_31
+                O1 -> Value.O1
+                O1_2024_12_17 -> Value.O1_2024_12_17
+                O1_PREVIEW -> Value.O1_PREVIEW
+                O1_PREVIEW_2024_09_12 -> Value.O1_PREVIEW_2024_09_12
+                O1_MINI -> Value.O1_MINI
+                O1_MINI_2024_09_12 -> Value.O1_MINI_2024_09_12
+                GPT_4O -> Value.GPT_4O
+                GPT_4O_2024_11_20 -> Value.GPT_4O_2024_11_20
+                GPT_4O_2024_08_06 -> Value.GPT_4O_2024_08_06
+                GPT_4O_2024_05_13 -> Value.GPT_4O_2024_05_13
+                GPT_4O_AUDIO_PREVIEW -> Value.GPT_4O_AUDIO_PREVIEW
+                GPT_4O_AUDIO_PREVIEW_2024_10_01 -> Value.GPT_4O_AUDIO_PREVIEW_2024_10_01
+                GPT_4O_AUDIO_PREVIEW_2024_12_17 -> Value.GPT_4O_AUDIO_PREVIEW_2024_12_17
+                GPT_4O_AUDIO_PREVIEW_2025_06_03 -> Value.GPT_4O_AUDIO_PREVIEW_2025_06_03
+                GPT_4O_MINI_AUDIO_PREVIEW -> Value.GPT_4O_MINI_AUDIO_PREVIEW
+                GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17 -> Value.GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17
+                GPT_4O_SEARCH_PREVIEW -> Value.GPT_4O_SEARCH_PREVIEW
+                GPT_4O_MINI_SEARCH_PREVIEW -> Value.GPT_4O_MINI_SEARCH_PREVIEW
+                GPT_4O_SEARCH_PREVIEW_2025_03_11 -> Value.GPT_4O_SEARCH_PREVIEW_2025_03_11
+                GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11 -> Value.GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11
+                CHATGPT_4O_LATEST -> Value.CHATGPT_4O_LATEST
+                CODEX_MINI_LATEST -> Value.CODEX_MINI_LATEST
+                GPT_4O_MINI -> Value.GPT_4O_MINI
+                GPT_4O_MINI_2024_07_18 -> Value.GPT_4O_MINI_2024_07_18
+                GPT_4_TURBO -> Value.GPT_4_TURBO
+                GPT_4_TURBO_2024_04_09 -> Value.GPT_4_TURBO_2024_04_09
+                GPT_4_0125_PREVIEW -> Value.GPT_4_0125_PREVIEW
+                GPT_4_TURBO_PREVIEW -> Value.GPT_4_TURBO_PREVIEW
+                GPT_4_1106_PREVIEW -> Value.GPT_4_1106_PREVIEW
+                GPT_4_VISION_PREVIEW -> Value.GPT_4_VISION_PREVIEW
+                GPT_4 -> Value.GPT_4
+                GPT_4_0314 -> Value.GPT_4_0314
+                GPT_4_0613 -> Value.GPT_4_0613
+                GPT_4_32K -> Value.GPT_4_32K
+                GPT_4_32K_0314 -> Value.GPT_4_32K_0314
+                GPT_4_32K_0613 -> Value.GPT_4_32K_0613
+                GPT_3_5_TURBO -> Value.GPT_3_5_TURBO
+                GPT_3_5_TURBO_16K -> Value.GPT_3_5_TURBO_16K
+                GPT_3_5_TURBO_0301 -> Value.GPT_3_5_TURBO_0301
+                GPT_3_5_TURBO_0613 -> Value.GPT_3_5_TURBO_0613
+                GPT_3_5_TURBO_1106 -> Value.GPT_3_5_TURBO_1106
+                GPT_3_5_TURBO_0125 -> Value.GPT_3_5_TURBO_0125
+                GPT_3_5_TURBO_16K_0613 -> Value.GPT_3_5_TURBO_16K_0613
+                O1_PRO -> Value.O1_PRO
+                O1_PRO_2025_03_19 -> Value.O1_PRO_2025_03_19
+                O3_PRO -> Value.O3_PRO
+                O3_PRO_2025_06_10 -> Value.O3_PRO_2025_06_10
+                O3_DEEP_RESEARCH -> Value.O3_DEEP_RESEARCH
+                O3_DEEP_RESEARCH_2025_06_26 -> Value.O3_DEEP_RESEARCH_2025_06_26
+                O4_MINI_DEEP_RESEARCH -> Value.O4_MINI_DEEP_RESEARCH
+                O4_MINI_DEEP_RESEARCH_2025_06_26 -> Value.O4_MINI_DEEP_RESEARCH_2025_06_26
+                COMPUTER_USE_PREVIEW -> Value.COMPUTER_USE_PREVIEW
+                COMPUTER_USE_PREVIEW_2025_03_11 -> Value.COMPUTER_USE_PREVIEW_2025_03_11
+                GPT_5_CODEX -> Value.GPT_5_CODEX
+                GPT_5_PRO -> Value.GPT_5_PRO
+                GPT_5_PRO_2025_10_06 -> Value.GPT_5_PRO_2025_10_06
+                GPT_5_1_CODEX_MAX -> Value.GPT_5_1_CODEX_MAX
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                GPT_5_6_SOL -> Known.GPT_5_6_SOL
+                GPT_5_6_TERRA -> Known.GPT_5_6_TERRA
+                GPT_5_6_LUNA -> Known.GPT_5_6_LUNA
+                GPT_5_4 -> Known.GPT_5_4
+                GPT_5_4_MINI -> Known.GPT_5_4_MINI
+                GPT_5_4_NANO -> Known.GPT_5_4_NANO
+                GPT_5_4_MINI_2026_03_17 -> Known.GPT_5_4_MINI_2026_03_17
+                GPT_5_4_NANO_2026_03_17 -> Known.GPT_5_4_NANO_2026_03_17
+                GPT_5_3_CHAT_LATEST -> Known.GPT_5_3_CHAT_LATEST
+                GPT_5_2 -> Known.GPT_5_2
+                GPT_5_2_2025_12_11 -> Known.GPT_5_2_2025_12_11
+                GPT_5_2_CHAT_LATEST -> Known.GPT_5_2_CHAT_LATEST
+                GPT_5_2_PRO -> Known.GPT_5_2_PRO
+                GPT_5_2_PRO_2025_12_11 -> Known.GPT_5_2_PRO_2025_12_11
+                GPT_5_1 -> Known.GPT_5_1
+                GPT_5_1_2025_11_13 -> Known.GPT_5_1_2025_11_13
+                GPT_5_1_CODEX -> Known.GPT_5_1_CODEX
+                GPT_5_1_MINI -> Known.GPT_5_1_MINI
+                GPT_5_1_CHAT_LATEST -> Known.GPT_5_1_CHAT_LATEST
+                GPT_5 -> Known.GPT_5
+                GPT_5_MINI -> Known.GPT_5_MINI
+                GPT_5_NANO -> Known.GPT_5_NANO
+                GPT_5_2025_08_07 -> Known.GPT_5_2025_08_07
+                GPT_5_MINI_2025_08_07 -> Known.GPT_5_MINI_2025_08_07
+                GPT_5_NANO_2025_08_07 -> Known.GPT_5_NANO_2025_08_07
+                GPT_5_CHAT_LATEST -> Known.GPT_5_CHAT_LATEST
+                GPT_4_1 -> Known.GPT_4_1
+                GPT_4_1_MINI -> Known.GPT_4_1_MINI
+                GPT_4_1_NANO -> Known.GPT_4_1_NANO
+                GPT_4_1_2025_04_14 -> Known.GPT_4_1_2025_04_14
+                GPT_4_1_MINI_2025_04_14 -> Known.GPT_4_1_MINI_2025_04_14
+                GPT_4_1_NANO_2025_04_14 -> Known.GPT_4_1_NANO_2025_04_14
+                O4_MINI -> Known.O4_MINI
+                O4_MINI_2025_04_16 -> Known.O4_MINI_2025_04_16
+                O3 -> Known.O3
+                O3_2025_04_16 -> Known.O3_2025_04_16
+                O3_MINI -> Known.O3_MINI
+                O3_MINI_2025_01_31 -> Known.O3_MINI_2025_01_31
+                O1 -> Known.O1
+                O1_2024_12_17 -> Known.O1_2024_12_17
+                O1_PREVIEW -> Known.O1_PREVIEW
+                O1_PREVIEW_2024_09_12 -> Known.O1_PREVIEW_2024_09_12
+                O1_MINI -> Known.O1_MINI
+                O1_MINI_2024_09_12 -> Known.O1_MINI_2024_09_12
+                GPT_4O -> Known.GPT_4O
+                GPT_4O_2024_11_20 -> Known.GPT_4O_2024_11_20
+                GPT_4O_2024_08_06 -> Known.GPT_4O_2024_08_06
+                GPT_4O_2024_05_13 -> Known.GPT_4O_2024_05_13
+                GPT_4O_AUDIO_PREVIEW -> Known.GPT_4O_AUDIO_PREVIEW
+                GPT_4O_AUDIO_PREVIEW_2024_10_01 -> Known.GPT_4O_AUDIO_PREVIEW_2024_10_01
+                GPT_4O_AUDIO_PREVIEW_2024_12_17 -> Known.GPT_4O_AUDIO_PREVIEW_2024_12_17
+                GPT_4O_AUDIO_PREVIEW_2025_06_03 -> Known.GPT_4O_AUDIO_PREVIEW_2025_06_03
+                GPT_4O_MINI_AUDIO_PREVIEW -> Known.GPT_4O_MINI_AUDIO_PREVIEW
+                GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17 -> Known.GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17
+                GPT_4O_SEARCH_PREVIEW -> Known.GPT_4O_SEARCH_PREVIEW
+                GPT_4O_MINI_SEARCH_PREVIEW -> Known.GPT_4O_MINI_SEARCH_PREVIEW
+                GPT_4O_SEARCH_PREVIEW_2025_03_11 -> Known.GPT_4O_SEARCH_PREVIEW_2025_03_11
+                GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11 -> Known.GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11
+                CHATGPT_4O_LATEST -> Known.CHATGPT_4O_LATEST
+                CODEX_MINI_LATEST -> Known.CODEX_MINI_LATEST
+                GPT_4O_MINI -> Known.GPT_4O_MINI
+                GPT_4O_MINI_2024_07_18 -> Known.GPT_4O_MINI_2024_07_18
+                GPT_4_TURBO -> Known.GPT_4_TURBO
+                GPT_4_TURBO_2024_04_09 -> Known.GPT_4_TURBO_2024_04_09
+                GPT_4_0125_PREVIEW -> Known.GPT_4_0125_PREVIEW
+                GPT_4_TURBO_PREVIEW -> Known.GPT_4_TURBO_PREVIEW
+                GPT_4_1106_PREVIEW -> Known.GPT_4_1106_PREVIEW
+                GPT_4_VISION_PREVIEW -> Known.GPT_4_VISION_PREVIEW
+                GPT_4 -> Known.GPT_4
+                GPT_4_0314 -> Known.GPT_4_0314
+                GPT_4_0613 -> Known.GPT_4_0613
+                GPT_4_32K -> Known.GPT_4_32K
+                GPT_4_32K_0314 -> Known.GPT_4_32K_0314
+                GPT_4_32K_0613 -> Known.GPT_4_32K_0613
+                GPT_3_5_TURBO -> Known.GPT_3_5_TURBO
+                GPT_3_5_TURBO_16K -> Known.GPT_3_5_TURBO_16K
+                GPT_3_5_TURBO_0301 -> Known.GPT_3_5_TURBO_0301
+                GPT_3_5_TURBO_0613 -> Known.GPT_3_5_TURBO_0613
+                GPT_3_5_TURBO_1106 -> Known.GPT_3_5_TURBO_1106
+                GPT_3_5_TURBO_0125 -> Known.GPT_3_5_TURBO_0125
+                GPT_3_5_TURBO_16K_0613 -> Known.GPT_3_5_TURBO_16K_0613
+                O1_PRO -> Known.O1_PRO
+                O1_PRO_2025_03_19 -> Known.O1_PRO_2025_03_19
+                O3_PRO -> Known.O3_PRO
+                O3_PRO_2025_06_10 -> Known.O3_PRO_2025_06_10
+                O3_DEEP_RESEARCH -> Known.O3_DEEP_RESEARCH
+                O3_DEEP_RESEARCH_2025_06_26 -> Known.O3_DEEP_RESEARCH_2025_06_26
+                O4_MINI_DEEP_RESEARCH -> Known.O4_MINI_DEEP_RESEARCH
+                O4_MINI_DEEP_RESEARCH_2025_06_26 -> Known.O4_MINI_DEEP_RESEARCH_2025_06_26
+                COMPUTER_USE_PREVIEW -> Known.COMPUTER_USE_PREVIEW
+                COMPUTER_USE_PREVIEW_2025_03_11 -> Known.COMPUTER_USE_PREVIEW_2025_03_11
+                GPT_5_CODEX -> Known.GPT_5_CODEX
+                GPT_5_PRO -> Known.GPT_5_PRO
+                GPT_5_PRO_2025_10_06 -> Known.GPT_5_PRO_2025_10_06
+                GPT_5_1_CODEX_MAX -> Known.GPT_5_1_CODEX_MAX
+                else -> throw OpenAIInvalidDataException("Unknown Model: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Model = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Model && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** Text, image, or file inputs to the model, used to generate a response */
+    @JsonDeserialize(using = Input.Deserializer::class)
+    @JsonSerialize(using = Input.Serializer::class)
+    class Input
+    private constructor(
+        private val string: String? = null,
+        private val betaResponseInputItems: List<BetaResponseInputItem>? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** A text input to the model, equivalent to a text input with the `user` role. */
+        fun string(): Optional<String> = Optional.ofNullable(string)
+
+        /** A list of one or many input items to the model, containing different content types. */
+        fun betaResponseInputItems(): Optional<List<BetaResponseInputItem>> =
+            Optional.ofNullable(betaResponseInputItems)
+
+        fun isString(): Boolean = string != null
+
+        fun isBetaResponseInputItems(): Boolean = betaResponseInputItems != null
+
+        /** A text input to the model, equivalent to a text input with the `user` role. */
+        fun asString(): String = string.getOrThrow("string")
+
+        /** A list of one or many input items to the model, containing different content types. */
+        fun asBetaResponseInputItems(): List<BetaResponseInputItem> =
+            betaResponseInputItems.getOrThrow("betaResponseInputItems")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = input.accept(new Input.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitString(String string) {
+         *         return Optional.of(string.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                string != null -> visitor.visitString(string)
+                betaResponseInputItems != null ->
+                    visitor.visitBetaResponseInputItems(betaResponseInputItems)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Input = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitString(string: String) {}
+
+                    override fun visitBetaResponseInputItems(
+                        betaResponseInputItems: List<BetaResponseInputItem>
+                    ) {
+                        betaResponseInputItems.forEach { it.validate() }
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitString(string: String) = 1
+
+                    override fun visitBetaResponseInputItems(
+                        betaResponseInputItems: List<BetaResponseInputItem>
+                    ) = betaResponseInputItems.sumOf { it.validity().toInt() }
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Input &&
+                string == other.string &&
+                betaResponseInputItems == other.betaResponseInputItems
+        }
+
+        override fun hashCode(): Int = Objects.hash(string, betaResponseInputItems)
+
+        override fun toString(): String =
+            when {
+                string != null -> "Input{string=$string}"
+                betaResponseInputItems != null ->
+                    "Input{betaResponseInputItems=$betaResponseInputItems}"
+                _json != null -> "Input{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Input")
+            }
+
+        companion object {
+
+            /** A text input to the model, equivalent to a text input with the `user` role. */
+            @JvmStatic fun ofString(string: String) = Input(string = string)
+
+            /**
+             * A list of one or many input items to the model, containing different content types.
+             */
+            @JvmStatic
+            fun ofBetaResponseInputItems(betaResponseInputItems: List<BetaResponseInputItem>) =
+                Input(betaResponseInputItems = betaResponseInputItems.toImmutable())
+        }
+
+        /** An interface that defines how to map each variant of [Input] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            /** A text input to the model, equivalent to a text input with the `user` role. */
+            fun visitString(string: String): T
+
+            /**
+             * A list of one or many input items to the model, containing different content types.
+             */
+            fun visitBetaResponseInputItems(betaResponseInputItems: List<BetaResponseInputItem>): T
+
+            /**
+             * Maps an unknown variant of [Input] to a value of type [T].
+             *
+             * An instance of [Input] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Input: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Input>(Input::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Input {
+                val json = JsonValue.fromJsonNode(node)
+
+                val bestMatches =
+                    sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                Input(string = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<List<BetaResponseInputItem>>())
+                                ?.let { Input(betaResponseInputItems = it, _json = json) },
+                        )
+                        .filterNotNull()
+                        .allMaxBy { it.validity() }
+                        .toList()
+                return when (bestMatches.size) {
+                    // This can happen if what we're deserializing is completely incompatible with
+                    // all the possible variants (e.g. deserializing from boolean).
+                    0 -> Input(_json = json)
+                    1 -> bestMatches.single()
+                    // If there's more than one match with the highest validity, then use the first
+                    // completely valid match, or simply the first match if none are completely
+                    // valid.
+                    else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                }
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Input>(Input::class) {
+
+            override fun serialize(
+                value: Input,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.string != null -> generator.writeObject(value.string)
+                    value.betaResponseInputItems != null ->
+                        generator.writeObject(value.betaResponseInputItems)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Input")
+                }
+            }
+        }
+    }
+
+    /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+     * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+     * content blocks with `prompt_cache_breakpoint`. Each request can write up to four breakpoints.
+     * For cache matching, OpenAI considers up to the latest 80 breakpoints in the conversation,
+     * without a content-block lookback limit. Set `mode` to `explicit` to disable the implicit
+     * breakpoint. The `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for current
+     * details.
+     */
+    class PromptCacheOptions
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonField<Mode>,
+        private val ttl: JsonField<Ttl>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of(),
+            @JsonProperty("ttl") @ExcludeMissing ttl: JsonField<Ttl> = JsonMissing.of(),
+        ) : this(mode, ttl, mutableMapOf())
+
+        /**
+         * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults to
+         * `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up to the
+         * latest three explicit breakpoints in the request. With `explicit`, OpenAI does not create
+         * an implicit breakpoint and writes up to the latest four explicit breakpoints. If there
+         * are no explicit breakpoints, the request does not use prompt caching.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun mode(): Optional<Mode> = mode.getOptional("mode")
+
+        /**
+         * The minimum lifetime applied to every implicit and explicit cache breakpoint written by
+         * the request. Defaults to `30m`, which is currently the only supported value. The backend
+         * may retain cache entries for longer.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun ttl(): Optional<Ttl> = ttl.getOptional("ttl")
+
+        /**
+         * Returns the raw JSON value of [mode].
+         *
+         * Unlike [mode], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+        /**
+         * Returns the raw JSON value of [ttl].
+         *
+         * Unlike [ttl], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("ttl") @ExcludeMissing fun _ttl(): JsonField<Ttl> = ttl
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [PromptCacheOptions]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheOptions]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonField<Mode> = JsonMissing.of()
+            private var ttl: JsonField<Ttl> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheOptions: PromptCacheOptions) = apply {
+                mode = promptCacheOptions.mode
+                ttl = promptCacheOptions.ttl
+                additionalProperties = promptCacheOptions.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults
+             * to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up
+             * to the latest three explicit breakpoints in the request. With `explicit`, OpenAI does
+             * not create an implicit breakpoint and writes up to the latest four explicit
+             * breakpoints. If there are no explicit breakpoints, the request does not use prompt
+             * caching.
+             */
+            fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+            /**
+             * Sets [Builder.mode] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.mode] with a well-typed [Mode] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+            /**
+             * The minimum lifetime applied to every implicit and explicit cache breakpoint written
+             * by the request. Defaults to `30m`, which is currently the only supported value. The
+             * backend may retain cache entries for longer.
+             */
+            fun ttl(ttl: Ttl) = ttl(JsonField.of(ttl))
+
+            /**
+             * Sets [Builder.ttl] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.ttl] with a well-typed [Ttl] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun ttl(ttl: JsonField<Ttl>) = apply { this.ttl = ttl }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheOptions].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheOptions =
+                PromptCacheOptions(mode, ttl, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheOptions = apply {
+            if (validated) {
+                return@apply
+            }
+
+            mode().ifPresent { it.validate() }
+            ttl().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (mode.asKnown().getOrNull()?.validity() ?: 0) +
+                (ttl.asKnown().getOrNull()?.validity() ?: 0)
+
+        /**
+         * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults to
+         * `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up to the
+         * latest three explicit breakpoints in the request. With `explicit`, OpenAI does not create
+         * an implicit breakpoint and writes up to the latest four explicit breakpoints. If there
+         * are no explicit breakpoints, the request does not use prompt caching.
+         */
+        class Mode @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IMPLICIT = of("implicit")
+
+                @JvmField val EXPLICIT = of("explicit")
+
+                @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+            }
+
+            /** An enum containing [Mode]'s known values. */
+            enum class Known {
+                IMPLICIT,
+                EXPLICIT,
+            }
+
+            /**
+             * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Mode] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IMPLICIT,
+                EXPLICIT,
+                /** An enum member indicating that [Mode] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IMPLICIT -> Value.IMPLICIT
+                    EXPLICIT -> Value.EXPLICIT
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IMPLICIT -> Known.IMPLICIT
+                    EXPLICIT -> Known.EXPLICIT
+                    else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Mode = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Mode && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * The minimum lifetime applied to every implicit and explicit cache breakpoint written by
+         * the request. Defaults to `30m`, which is currently the only supported value. The backend
+         * may retain cache entries for longer.
+         */
+        class Ttl @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val _30M = of("30m")
+
+                @JvmStatic fun of(value: String) = Ttl(JsonField.of(value))
+            }
+
+            /** An enum containing [Ttl]'s known values. */
+            enum class Known {
+                _30M
+            }
+
+            /**
+             * An enum containing [Ttl]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Ttl] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                _30M,
+                /** An enum member indicating that [Ttl] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    _30M -> Value._30M
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    _30M -> Known._30M
+                    else -> throw OpenAIInvalidDataException("Unknown Ttl: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Ttl = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Ttl && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheOptions &&
+                mode == other.mode &&
+                ttl == other.ttl &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, ttl, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheOptions{mode=$mode, ttl=$ttl, additionalProperties=$additionalProperties}"
+    }
+
+    /** How long to retain a prompt cache entry created by this request. */
+    @Deprecated("deprecated")
+    class PromptCacheRetention
+    @JsonCreator
+    private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_MEMORY = of("in_memory")
+
+            @JvmField val _24H = of("24h")
+
+            @JvmStatic fun of(value: String) = PromptCacheRetention(JsonField.of(value))
+        }
+
+        /** An enum containing [PromptCacheRetention]'s known values. */
+        enum class Known {
+            IN_MEMORY,
+            _24H,
+        }
+
+        /**
+         * An enum containing [PromptCacheRetention]'s known values, as well as an [_UNKNOWN]
+         * member.
+         *
+         * An instance of [PromptCacheRetention] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_MEMORY,
+            _24H,
+            /**
+             * An enum member indicating that [PromptCacheRetention] was instantiated with an
+             * unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_MEMORY -> Value.IN_MEMORY
+                _24H -> Value._24H
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_MEMORY -> Known.IN_MEMORY
+                _24H -> Known._24H
+                else -> throw OpenAIInvalidDataException("Unknown PromptCacheRetention: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheRetention = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheRetention && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** The service tier to use for this request. */
+    class ServiceTier @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val AUTO = of("auto")
+
+            @JvmField val DEFAULT = of("default")
+
+            @JvmField val FLEX = of("flex")
+
+            @JvmField val PRIORITY = of("priority")
+
+            @JvmStatic fun of(value: String) = ServiceTier(JsonField.of(value))
+        }
+
+        /** An enum containing [ServiceTier]'s known values. */
+        enum class Known {
+            AUTO,
+            DEFAULT,
+            FLEX,
+            PRIORITY,
+        }
+
+        /**
+         * An enum containing [ServiceTier]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [ServiceTier] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            AUTO,
+            DEFAULT,
+            FLEX,
+            PRIORITY,
+            /**
+             * An enum member indicating that [ServiceTier] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                AUTO -> Value.AUTO
+                DEFAULT -> Value.DEFAULT
+                FLEX -> Value.FLEX
+                PRIORITY -> Value.PRIORITY
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                AUTO -> Known.AUTO
+                DEFAULT -> Known.DEFAULT
+                FLEX -> Known.FLEX
+                PRIORITY -> Known.PRIORITY
+                else -> throw OpenAIInvalidDataException("Unknown ServiceTier: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ServiceTier = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ServiceTier && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    class Beta @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val RESPONSES_MULTI_AGENT_V1 = of("responses_multi_agent=v1")
+
+            @JvmStatic fun of(value: String) = Beta(JsonField.of(value))
+        }
+
+        /** An enum containing [Beta]'s known values. */
+        enum class Known {
+            RESPONSES_MULTI_AGENT_V1
+        }
+
+        /**
+         * An enum containing [Beta]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Beta] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            RESPONSES_MULTI_AGENT_V1,
+            /** An enum member indicating that [Beta] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                RESPONSES_MULTI_AGENT_V1 -> Value.RESPONSES_MULTI_AGENT_V1
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                RESPONSES_MULTI_AGENT_V1 -> Known.RESPONSES_MULTI_AGENT_V1
+                else -> throw OpenAIInvalidDataException("Unknown Beta: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Beta = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Beta && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ResponseCompactParams &&
+            betas == other.betas &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(betas, body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "ResponseCompactParams{betas=$betas, body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseCreateParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseCreateParams.kt
new file mode 100644
index 000000000..bd6f55557
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseCreateParams.kt
@@ -0,0 +1,9777 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.Params
+import com.openai.core.allMaxBy
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
+import com.openai.core.http.Headers
+import com.openai.core.http.QueryParams
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Creates a model response. Provide [text](https://platform.openai.com/docs/guides/text) or
+ * [image](https://platform.openai.com/docs/guides/images) inputs to generate
+ * [text](https://platform.openai.com/docs/guides/text) or
+ * [JSON](https://platform.openai.com/docs/guides/structured-outputs) outputs. Have the model call
+ * your own [custom code](https://platform.openai.com/docs/guides/function-calling) or use built-in
+ * [tools](https://platform.openai.com/docs/guides/tools) like
+ * [web search](https://platform.openai.com/docs/guides/tools-web-search) or
+ * [file search](https://platform.openai.com/docs/guides/tools-file-search) to use your own data as
+ * input for the model's response.
+ */
+class ResponseCreateParams
+private constructor(
+    private val betas: List<Beta>?,
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun betas(): Optional<List<Beta>> = Optional.ofNullable(betas)
+
+    /**
+     * Whether to run the model response in the background.
+     * [Learn more](https://platform.openai.com/docs/guides/background).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun background(): Optional<Boolean> = body.background()
+
+    /**
+     * Context management configuration for this request.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun contextManagement(): Optional<List<ContextManagement>> = body.contextManagement()
+
+    /**
+     * The conversation that this response belongs to. Items from this conversation are prepended to
+     * `input_items` for this response request. Input items and output items from this response are
+     * automatically added to this conversation after this response completes.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun conversation(): Optional<Conversation> = body.conversation()
+
+    /**
+     * Specify additional output data to include in the model response. Currently supported values
+     * are:
+     * - `web_search_call.action.sources`: Include the sources of the web search tool call.
+     * - `code_interpreter_call.outputs`: Includes the outputs of python code execution in code
+     *   interpreter tool call items.
+     * - `computer_call_output.output.image_url`: Include image urls from the computer call output.
+     * - `file_search_call.results`: Include the search results of the file search tool call.
+     * - `message.input_image.image_url`: Include image urls from the input message.
+     * - `message.output_text.logprobs`: Include logprobs with assistant messages.
+     * - `reasoning.encrypted_content`: Includes an encrypted version of reasoning tokens in
+     *   reasoning item outputs. This enables reasoning items to be used in multi-turn conversations
+     *   when using the Responses API statelessly (like when the `store` parameter is set to
+     *   `false`, or when an organization is enrolled in the zero data retention program).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun include(): Optional<List<BetaResponseIncludable>> = body.include()
+
+    /**
+     * Text, image, or file inputs to the model, used to generate a response.
+     *
+     * Learn more:
+     * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+     * - [Image inputs](https://platform.openai.com/docs/guides/images)
+     * - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
+     * - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
+     * - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun input(): Optional<Input> = body.input()
+
+    /**
+     * A system (or developer) message inserted into the model's context.
+     *
+     * When using along with `previous_response_id`, the instructions from a previous response will
+     * not be carried over to the next response. This makes it simple to swap out system (or
+     * developer) messages in new responses.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun instructions(): Optional<String> = body.instructions()
+
+    /**
+     * An upper bound for the number of tokens that can be generated for a response, including
+     * visible output tokens and
+     * [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun maxOutputTokens(): Optional<Long> = body.maxOutputTokens()
+
+    /**
+     * The maximum number of total calls to built-in tools that can be processed in a response. This
+     * maximum number applies across all built-in tool calls, not per individual tool. Any further
+     * attempts to call a tool by the model will be ignored.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun maxToolCalls(): Optional<Long> = body.maxToolCalls()
+
+    /**
+     * Set of 16 key-value pairs that can be attached to an object. This can be useful for storing
+     * additional information about the object in a structured format, and querying for objects via
+     * API or the dashboard.
+     *
+     * Keys are strings with a maximum length of 64 characters. Values are strings with a maximum
+     * length of 512 characters.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun metadata(): Optional<Metadata> = body.metadata()
+
+    /**
+     * Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide range of
+     * models with different capabilities, performance characteristics, and price points. Refer to
+     * the [model guide](https://platform.openai.com/docs/models) to browse and compare available
+     * models.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun model(): Optional<Model> = body.model()
+
+    /**
+     * Configuration for running moderation on the input and output of this response.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun moderation(): Optional<Moderation> = body.moderation()
+
+    /**
+     * Configuration for server-hosted multi-agent execution.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun multiAgent(): Optional<MultiAgent> = body.multiAgent()
+
+    /**
+     * Whether to allow the model to run tool calls in parallel.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun parallelToolCalls(): Optional<Boolean> = body.parallelToolCalls()
+
+    /**
+     * The unique ID of the previous response to the model. Use this to create multi-turn
+     * conversations. Learn more about
+     * [conversation state](https://platform.openai.com/docs/guides/conversation-state). Cannot be
+     * used in conjunction with `conversation`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun previousResponseId(): Optional<String> = body.previousResponseId()
+
+    /**
+     * Reference to a prompt template and its variables.
+     * [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun prompt(): Optional<BetaResponsePrompt> = body.prompt()
+
+    /**
+     * Used by OpenAI to cache responses for similar requests to optimize your cache hit rates.
+     * Replaces the `user` field.
+     * [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheKey(): Optional<String> = body.promptCacheKey()
+
+    /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+     * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+     * content blocks with `prompt_cache_breakpoint`. Each request can write up to four breakpoints.
+     * For cache matching, OpenAI considers up to the latest 80 breakpoints in the conversation,
+     * without a content-block lookback limit. Set `mode` to `explicit` to disable the implicit
+     * breakpoint. The `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for current
+     * details.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheOptions(): Optional<PromptCacheOptions> = body.promptCacheOptions()
+
+    /**
+     * Deprecated. Use `prompt_cache_options.ttl` instead.
+     *
+     * The retention policy for the prompt cache. Set to `24h` to enable extended prompt caching,
+     * which keeps cached prefixes active for longer, up to a maximum of 24 hours.
+     * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+     * This field expresses a maximum retention policy, while `prompt_cache_options.ttl` expresses a
+     * minimum cache lifetime. The two fields are independent and do not interact. For `gpt-5.5`,
+     * `gpt-5.5-pro`, and future models, only `24h` is supported.
+     *
+     * For older models that support both `in_memory` and `24h`, the default depends on your
+     * organization's data retention policy:
+     * - Organizations without ZDR enabled default to `24h`.
+     * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is not
+     *   specified.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    @Deprecated("deprecated")
+    fun promptCacheRetention(): Optional<PromptCacheRetention> = body.promptCacheRetention()
+
+    /**
+     * **gpt-5 and o-series models only**
+     *
+     * Configuration options for
+     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun reasoning(): Optional<Reasoning> = body.reasoning()
+
+    /**
+     * A stable identifier used to help detect users of your application that may be violating
+     * OpenAI's usage policies. The IDs should be a string that uniquely identifies each user, with
+     * a maximum length of 64 characters. We recommend hashing their username or email address, in
+     * order to avoid sending us any identifying information.
+     * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun safetyIdentifier(): Optional<String> = body.safetyIdentifier()
+
+    /**
+     * Specifies the processing type used for serving the request.
+     * - If set to 'auto', then the request will be processed with the service tier configured in
+     *   the Project settings. Unless otherwise configured, the Project will use 'default'.
+     * - If set to 'default', then the request will be processed with the standard pricing and
+     *   performance for the selected model.
+     * - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
+     *   '[priority](https://openai.com/api-priority-processing/)', then the request will be
+     *   processed with the corresponding service tier.
+     * - When not set, the default behavior is 'auto'.
+     *
+     *   When the `service_tier` parameter is set, the response body will include the `service_tier`
+     *   value based on the processing mode actually used to serve the request. This response value
+     *   may be different from the value set in the parameter.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun serviceTier(): Optional<ServiceTier> = body.serviceTier()
+
+    /**
+     * Whether to store the generated model response for later retrieval via API.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun store(): Optional<Boolean> = body.store()
+
+    /**
+     * Options for streaming responses. Only set this when you set `stream: true`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun streamOptions(): Optional<StreamOptions> = body.streamOptions()
+
+    /**
+     * What sampling temperature to use, between 0 and 2. Higher values like 0.8 will make the
+     * output more random, while lower values like 0.2 will make it more focused and deterministic.
+     * We generally recommend altering this or `top_p` but not both.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun temperature(): Optional<Double> = body.temperature()
+
+    /**
+     * Configuration options for a text response from the model. Can be plain text or structured
+     * JSON data. Learn more:
+     * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+     * - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun text(): Optional<BetaResponseTextConfig> = body.text()
+
+    /**
+     * How the model should select which tool (or tools) to use when generating a response. See the
+     * `tools` parameter to see how to specify which tools the model can call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun toolChoice(): Optional<ToolChoice> = body.toolChoice()
+
+    /**
+     * An array of tools the model may call while generating a response. You can specify which tool
+     * to use by setting the `tool_choice` parameter.
+     *
+     * We support the following categories of tools:
+     * - **Built-in tools**: Tools that are provided by OpenAI that extend the model's capabilities,
+     *   like [web search](https://platform.openai.com/docs/guides/tools-web-search) or
+     *   [file search](https://platform.openai.com/docs/guides/tools-file-search). Learn more about
+     *   [built-in tools](https://platform.openai.com/docs/guides/tools).
+     * - **MCP Tools**: Integrations with third-party systems via custom MCP servers or predefined
+     *   connectors such as Google Drive and SharePoint. Learn more about
+     *   [MCP Tools](https://platform.openai.com/docs/guides/tools-connectors-mcp).
+     * - **Function calls (custom tools)**: Functions that are defined by you, enabling the model to
+     *   call your own code with strongly typed arguments and outputs. Learn more about
+     *   [function calling](https://platform.openai.com/docs/guides/function-calling). You can also
+     *   use custom tools to call your own code.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun tools(): Optional<List<BetaTool>> = body.tools()
+
+    /**
+     * An integer between 0 and 20 specifying the maximum number of most likely tokens to return at
+     * each token position, each with an associated log probability. In some cases, the number of
+     * returned tokens may be fewer than requested.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun topLogprobs(): Optional<Long> = body.topLogprobs()
+
+    /**
+     * An alternative to sampling with temperature, called nucleus sampling, where the model
+     * considers the results of the tokens with top_p probability mass. So 0.1 means only the tokens
+     * comprising the top 10% probability mass are considered.
+     *
+     * We generally recommend altering this or `temperature` but not both.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun topP(): Optional<Double> = body.topP()
+
+    /**
+     * The truncation strategy to use for the model response.
+     * - `auto`: If the input to this Response exceeds the model's context window size, the model
+     *   will truncate the response to fit the context window by dropping items from the beginning
+     *   of the conversation.
+     * - `disabled` (default): If the input size will exceed the context window size for a model,
+     *   the request will fail with a 400 error.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    @Deprecated("deprecated") fun truncation(): Optional<Truncation> = body.truncation()
+
+    /**
+     * This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+     * `prompt_cache_key` instead to maintain caching optimizations. 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#safety-identifiers).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    @Deprecated("deprecated") fun user(): Optional<String> = body.user()
+
+    /**
+     * Returns the raw JSON value of [background].
+     *
+     * Unlike [background], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _background(): JsonField<Boolean> = body._background()
+
+    /**
+     * Returns the raw JSON value of [contextManagement].
+     *
+     * Unlike [contextManagement], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    fun _contextManagement(): JsonField<List<ContextManagement>> = body._contextManagement()
+
+    /**
+     * Returns the raw JSON value of [conversation].
+     *
+     * Unlike [conversation], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _conversation(): JsonField<Conversation> = body._conversation()
+
+    /**
+     * Returns the raw JSON value of [include].
+     *
+     * Unlike [include], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _include(): JsonField<List<BetaResponseIncludable>> = body._include()
+
+    /**
+     * Returns the raw JSON value of [input].
+     *
+     * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _input(): JsonField<Input> = body._input()
+
+    /**
+     * Returns the raw JSON value of [instructions].
+     *
+     * Unlike [instructions], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _instructions(): JsonField<String> = body._instructions()
+
+    /**
+     * Returns the raw JSON value of [maxOutputTokens].
+     *
+     * Unlike [maxOutputTokens], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _maxOutputTokens(): JsonField<Long> = body._maxOutputTokens()
+
+    /**
+     * Returns the raw JSON value of [maxToolCalls].
+     *
+     * Unlike [maxToolCalls], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _maxToolCalls(): JsonField<Long> = body._maxToolCalls()
+
+    /**
+     * Returns the raw JSON value of [metadata].
+     *
+     * Unlike [metadata], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _metadata(): JsonField<Metadata> = body._metadata()
+
+    /**
+     * Returns the raw JSON value of [model].
+     *
+     * Unlike [model], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _model(): JsonField<Model> = body._model()
+
+    /**
+     * Returns the raw JSON value of [moderation].
+     *
+     * Unlike [moderation], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _moderation(): JsonField<Moderation> = body._moderation()
+
+    /**
+     * Returns the raw JSON value of [multiAgent].
+     *
+     * Unlike [multiAgent], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _multiAgent(): JsonField<MultiAgent> = body._multiAgent()
+
+    /**
+     * Returns the raw JSON value of [parallelToolCalls].
+     *
+     * Unlike [parallelToolCalls], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    fun _parallelToolCalls(): JsonField<Boolean> = body._parallelToolCalls()
+
+    /**
+     * Returns the raw JSON value of [previousResponseId].
+     *
+     * Unlike [previousResponseId], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    fun _previousResponseId(): JsonField<String> = body._previousResponseId()
+
+    /**
+     * Returns the raw JSON value of [prompt].
+     *
+     * Unlike [prompt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _prompt(): JsonField<BetaResponsePrompt> = body._prompt()
+
+    /**
+     * Returns the raw JSON value of [promptCacheKey].
+     *
+     * Unlike [promptCacheKey], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _promptCacheKey(): JsonField<String> = body._promptCacheKey()
+
+    /**
+     * Returns the raw JSON value of [promptCacheOptions].
+     *
+     * Unlike [promptCacheOptions], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    fun _promptCacheOptions(): JsonField<PromptCacheOptions> = body._promptCacheOptions()
+
+    /**
+     * Returns the raw JSON value of [promptCacheRetention].
+     *
+     * Unlike [promptCacheRetention], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @Deprecated("deprecated")
+    fun _promptCacheRetention(): JsonField<PromptCacheRetention> = body._promptCacheRetention()
+
+    /**
+     * Returns the raw JSON value of [reasoning].
+     *
+     * Unlike [reasoning], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _reasoning(): JsonField<Reasoning> = body._reasoning()
+
+    /**
+     * Returns the raw JSON value of [safetyIdentifier].
+     *
+     * Unlike [safetyIdentifier], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    fun _safetyIdentifier(): JsonField<String> = body._safetyIdentifier()
+
+    /**
+     * Returns the raw JSON value of [serviceTier].
+     *
+     * Unlike [serviceTier], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _serviceTier(): JsonField<ServiceTier> = body._serviceTier()
+
+    /**
+     * Returns the raw JSON value of [store].
+     *
+     * Unlike [store], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _store(): JsonField<Boolean> = body._store()
+
+    /**
+     * Returns the raw JSON value of [streamOptions].
+     *
+     * Unlike [streamOptions], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _streamOptions(): JsonField<StreamOptions> = body._streamOptions()
+
+    /**
+     * Returns the raw JSON value of [temperature].
+     *
+     * Unlike [temperature], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _temperature(): JsonField<Double> = body._temperature()
+
+    /**
+     * Returns the raw JSON value of [text].
+     *
+     * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _text(): JsonField<BetaResponseTextConfig> = body._text()
+
+    /**
+     * Returns the raw JSON value of [toolChoice].
+     *
+     * Unlike [toolChoice], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _toolChoice(): JsonField<ToolChoice> = body._toolChoice()
+
+    /**
+     * Returns the raw JSON value of [tools].
+     *
+     * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _tools(): JsonField<List<BetaTool>> = body._tools()
+
+    /**
+     * Returns the raw JSON value of [topLogprobs].
+     *
+     * Unlike [topLogprobs], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _topLogprobs(): JsonField<Long> = body._topLogprobs()
+
+    /**
+     * Returns the raw JSON value of [topP].
+     *
+     * Unlike [topP], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _topP(): JsonField<Double> = body._topP()
+
+    /**
+     * Returns the raw JSON value of [truncation].
+     *
+     * Unlike [truncation], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @Deprecated("deprecated") fun _truncation(): JsonField<Truncation> = body._truncation()
+
+    /**
+     * Returns the raw JSON value of [user].
+     *
+     * Unlike [user], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @Deprecated("deprecated") fun _user(): JsonField<String> = body._user()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): ResponseCreateParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [ResponseCreateParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ResponseCreateParams]. */
+    class Builder internal constructor() {
+
+        private var betas: MutableList<Beta>? = null
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(responseCreateParams: ResponseCreateParams) = apply {
+            betas = responseCreateParams.betas?.toMutableList()
+            body = responseCreateParams.body.toBuilder()
+            additionalHeaders = responseCreateParams.additionalHeaders.toBuilder()
+            additionalQueryParams = responseCreateParams.additionalQueryParams.toBuilder()
+        }
+
+        fun betas(betas: List<Beta>?) = apply { this.betas = betas?.toMutableList() }
+
+        /** Alias for calling [Builder.betas] with `betas.orElse(null)`. */
+        fun betas(betas: Optional<List<Beta>>) = betas(betas.getOrNull())
+
+        /**
+         * Adds a single [Beta] to [betas].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addBeta(beta: Beta) = apply { betas = (betas ?: mutableListOf()).apply { add(beta) } }
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [background]
+         * - [contextManagement]
+         * - [conversation]
+         * - [include]
+         * - [input]
+         * - etc.
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /**
+         * Whether to run the model response in the background.
+         * [Learn more](https://platform.openai.com/docs/guides/background).
+         */
+        fun background(background: Boolean?) = apply { body.background(background) }
+
+        /**
+         * Alias for [Builder.background].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun background(background: Boolean) = background(background as Boolean?)
+
+        /** Alias for calling [Builder.background] with `background.orElse(null)`. */
+        fun background(background: Optional<Boolean>) = background(background.getOrNull())
+
+        /**
+         * Sets [Builder.background] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.background] with a well-typed [Boolean] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun background(background: JsonField<Boolean>) = apply { body.background(background) }
+
+        /** Context management configuration for this request. */
+        fun contextManagement(contextManagement: List<ContextManagement>?) = apply {
+            body.contextManagement(contextManagement)
+        }
+
+        /** Alias for calling [Builder.contextManagement] with `contextManagement.orElse(null)`. */
+        fun contextManagement(contextManagement: Optional<List<ContextManagement>>) =
+            contextManagement(contextManagement.getOrNull())
+
+        /**
+         * Sets [Builder.contextManagement] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.contextManagement] with a well-typed
+         * `List<ContextManagement>` value instead. This method is primarily for setting the field
+         * to an undocumented or not yet supported value.
+         */
+        fun contextManagement(contextManagement: JsonField<List<ContextManagement>>) = apply {
+            body.contextManagement(contextManagement)
+        }
+
+        /**
+         * Adds a single [ContextManagement] to [Builder.contextManagement].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addContextManagement(contextManagement: ContextManagement) = apply {
+            body.addContextManagement(contextManagement)
+        }
+
+        /**
+         * The conversation that this response belongs to. Items from this conversation are
+         * prepended to `input_items` for this response request. Input items and output items from
+         * this response are automatically added to this conversation after this response completes.
+         */
+        fun conversation(conversation: Conversation?) = apply { body.conversation(conversation) }
+
+        /** Alias for calling [Builder.conversation] with `conversation.orElse(null)`. */
+        fun conversation(conversation: Optional<Conversation>) =
+            conversation(conversation.getOrNull())
+
+        /**
+         * Sets [Builder.conversation] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.conversation] with a well-typed [Conversation] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun conversation(conversation: JsonField<Conversation>) = apply {
+            body.conversation(conversation)
+        }
+
+        /** Alias for calling [conversation] with `Conversation.ofId(id)`. */
+        fun conversation(id: String) = apply { body.conversation(id) }
+
+        /**
+         * Alias for calling [conversation] with
+         * `Conversation.ofBetaResponseConversationParam(betaResponseConversationParam)`.
+         */
+        fun conversation(betaResponseConversationParam: BetaResponseConversationParam) = apply {
+            body.conversation(betaResponseConversationParam)
+        }
+
+        /**
+         * Specify additional output data to include in the model response. Currently supported
+         * values are:
+         * - `web_search_call.action.sources`: Include the sources of the web search tool call.
+         * - `code_interpreter_call.outputs`: Includes the outputs of python code execution in code
+         *   interpreter tool call items.
+         * - `computer_call_output.output.image_url`: Include image urls from the computer call
+         *   output.
+         * - `file_search_call.results`: Include the search results of the file search tool call.
+         * - `message.input_image.image_url`: Include image urls from the input message.
+         * - `message.output_text.logprobs`: Include logprobs with assistant messages.
+         * - `reasoning.encrypted_content`: Includes an encrypted version of reasoning tokens in
+         *   reasoning item outputs. This enables reasoning items to be used in multi-turn
+         *   conversations when using the Responses API statelessly (like when the `store` parameter
+         *   is set to `false`, or when an organization is enrolled in the zero data retention
+         *   program).
+         */
+        fun include(include: List<BetaResponseIncludable>?) = apply { body.include(include) }
+
+        /** Alias for calling [Builder.include] with `include.orElse(null)`. */
+        fun include(include: Optional<List<BetaResponseIncludable>>) = include(include.getOrNull())
+
+        /**
+         * Sets [Builder.include] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.include] with a well-typed
+         * `List<BetaResponseIncludable>` value instead. This method is primarily for setting the
+         * field to an undocumented or not yet supported value.
+         */
+        fun include(include: JsonField<List<BetaResponseIncludable>>) = apply {
+            body.include(include)
+        }
+
+        /**
+         * Adds a single [BetaResponseIncludable] to [Builder.include].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addInclude(include: BetaResponseIncludable) = apply { body.addInclude(include) }
+
+        /**
+         * Text, image, or file inputs to the model, used to generate a response.
+         *
+         * Learn more:
+         * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+         * - [Image inputs](https://platform.openai.com/docs/guides/images)
+         * - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
+         * - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
+         * - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+         */
+        fun input(input: Input) = apply { body.input(input) }
+
+        /**
+         * Sets [Builder.input] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.input] with a well-typed [Input] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun input(input: JsonField<Input>) = apply { body.input(input) }
+
+        /** Alias for calling [input] with `Input.ofText(text)`. */
+        fun input(text: String) = apply { body.input(text) }
+
+        /** Alias for calling [input] with `Input.ofBetaResponse(betaResponse)`. */
+        fun inputOfBetaResponse(betaResponse: List<BetaResponseInputItem>) = apply {
+            body.inputOfBetaResponse(betaResponse)
+        }
+
+        /**
+         * A system (or developer) message inserted into the model's context.
+         *
+         * When using along with `previous_response_id`, the instructions from a previous response
+         * will not be carried over to the next response. This makes it simple to swap out system
+         * (or developer) messages in new responses.
+         */
+        fun instructions(instructions: String?) = apply { body.instructions(instructions) }
+
+        /** Alias for calling [Builder.instructions] with `instructions.orElse(null)`. */
+        fun instructions(instructions: Optional<String>) = instructions(instructions.getOrNull())
+
+        /**
+         * Sets [Builder.instructions] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.instructions] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun instructions(instructions: JsonField<String>) = apply {
+            body.instructions(instructions)
+        }
+
+        /**
+         * An upper bound for the number of tokens that can be generated for a response, including
+         * visible output tokens and
+         * [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
+         */
+        fun maxOutputTokens(maxOutputTokens: Long?) = apply {
+            body.maxOutputTokens(maxOutputTokens)
+        }
+
+        /**
+         * Alias for [Builder.maxOutputTokens].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun maxOutputTokens(maxOutputTokens: Long) = maxOutputTokens(maxOutputTokens as Long?)
+
+        /** Alias for calling [Builder.maxOutputTokens] with `maxOutputTokens.orElse(null)`. */
+        fun maxOutputTokens(maxOutputTokens: Optional<Long>) =
+            maxOutputTokens(maxOutputTokens.getOrNull())
+
+        /**
+         * Sets [Builder.maxOutputTokens] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.maxOutputTokens] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun maxOutputTokens(maxOutputTokens: JsonField<Long>) = apply {
+            body.maxOutputTokens(maxOutputTokens)
+        }
+
+        /**
+         * The maximum number of total calls to built-in tools that can be processed in a response.
+         * This maximum number applies across all built-in tool calls, not per individual tool. Any
+         * further attempts to call a tool by the model will be ignored.
+         */
+        fun maxToolCalls(maxToolCalls: Long?) = apply { body.maxToolCalls(maxToolCalls) }
+
+        /**
+         * Alias for [Builder.maxToolCalls].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun maxToolCalls(maxToolCalls: Long) = maxToolCalls(maxToolCalls as Long?)
+
+        /** Alias for calling [Builder.maxToolCalls] with `maxToolCalls.orElse(null)`. */
+        fun maxToolCalls(maxToolCalls: Optional<Long>) = maxToolCalls(maxToolCalls.getOrNull())
+
+        /**
+         * Sets [Builder.maxToolCalls] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.maxToolCalls] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun maxToolCalls(maxToolCalls: JsonField<Long>) = apply { body.maxToolCalls(maxToolCalls) }
+
+        /**
+         * Set of 16 key-value pairs that can be attached to an object. This can be useful for
+         * storing additional information about the object in a structured format, and querying for
+         * objects via API or the dashboard.
+         *
+         * Keys are strings with a maximum length of 64 characters. Values are strings with a
+         * maximum length of 512 characters.
+         */
+        fun metadata(metadata: Metadata?) = apply { body.metadata(metadata) }
+
+        /** Alias for calling [Builder.metadata] with `metadata.orElse(null)`. */
+        fun metadata(metadata: Optional<Metadata>) = metadata(metadata.getOrNull())
+
+        /**
+         * Sets [Builder.metadata] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.metadata] with a well-typed [Metadata] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun metadata(metadata: JsonField<Metadata>) = apply { body.metadata(metadata) }
+
+        /**
+         * Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide range
+         * of models with different capabilities, performance characteristics, and price points.
+         * Refer to the [model guide](https://platform.openai.com/docs/models) to browse and compare
+         * available models.
+         */
+        fun model(model: Model) = apply { body.model(model) }
+
+        /**
+         * Sets [Builder.model] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.model] with a well-typed [Model] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun model(model: JsonField<Model>) = apply { body.model(model) }
+
+        /**
+         * Sets [model] to an arbitrary [String].
+         *
+         * You should usually call [model] with a well-typed [Model] constant instead. This method
+         * is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun model(value: String) = apply { body.model(value) }
+
+        /** Configuration for running moderation on the input and output of this response. */
+        fun moderation(moderation: Moderation?) = apply { body.moderation(moderation) }
+
+        /** Alias for calling [Builder.moderation] with `moderation.orElse(null)`. */
+        fun moderation(moderation: Optional<Moderation>) = moderation(moderation.getOrNull())
+
+        /**
+         * Sets [Builder.moderation] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.moderation] with a well-typed [Moderation] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun moderation(moderation: JsonField<Moderation>) = apply { body.moderation(moderation) }
+
+        /** Configuration for server-hosted multi-agent execution. */
+        fun multiAgent(multiAgent: MultiAgent?) = apply { body.multiAgent(multiAgent) }
+
+        /** Alias for calling [Builder.multiAgent] with `multiAgent.orElse(null)`. */
+        fun multiAgent(multiAgent: Optional<MultiAgent>) = multiAgent(multiAgent.getOrNull())
+
+        /**
+         * Sets [Builder.multiAgent] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.multiAgent] with a well-typed [MultiAgent] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun multiAgent(multiAgent: JsonField<MultiAgent>) = apply { body.multiAgent(multiAgent) }
+
+        /** Whether to allow the model to run tool calls in parallel. */
+        fun parallelToolCalls(parallelToolCalls: Boolean?) = apply {
+            body.parallelToolCalls(parallelToolCalls)
+        }
+
+        /**
+         * Alias for [Builder.parallelToolCalls].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun parallelToolCalls(parallelToolCalls: Boolean) =
+            parallelToolCalls(parallelToolCalls as Boolean?)
+
+        /** Alias for calling [Builder.parallelToolCalls] with `parallelToolCalls.orElse(null)`. */
+        fun parallelToolCalls(parallelToolCalls: Optional<Boolean>) =
+            parallelToolCalls(parallelToolCalls.getOrNull())
+
+        /**
+         * Sets [Builder.parallelToolCalls] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.parallelToolCalls] with a well-typed [Boolean] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun parallelToolCalls(parallelToolCalls: JsonField<Boolean>) = apply {
+            body.parallelToolCalls(parallelToolCalls)
+        }
+
+        /**
+         * The unique ID of the previous response to the model. Use this to create multi-turn
+         * conversations. Learn more about
+         * [conversation state](https://platform.openai.com/docs/guides/conversation-state). Cannot
+         * be used in conjunction with `conversation`.
+         */
+        fun previousResponseId(previousResponseId: String?) = apply {
+            body.previousResponseId(previousResponseId)
+        }
+
+        /**
+         * Alias for calling [Builder.previousResponseId] with `previousResponseId.orElse(null)`.
+         */
+        fun previousResponseId(previousResponseId: Optional<String>) =
+            previousResponseId(previousResponseId.getOrNull())
+
+        /**
+         * Sets [Builder.previousResponseId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.previousResponseId] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun previousResponseId(previousResponseId: JsonField<String>) = apply {
+            body.previousResponseId(previousResponseId)
+        }
+
+        /**
+         * Reference to a prompt template and its variables.
+         * [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+         */
+        fun prompt(prompt: BetaResponsePrompt?) = apply { body.prompt(prompt) }
+
+        /** Alias for calling [Builder.prompt] with `prompt.orElse(null)`. */
+        fun prompt(prompt: Optional<BetaResponsePrompt>) = prompt(prompt.getOrNull())
+
+        /**
+         * Sets [Builder.prompt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.prompt] with a well-typed [BetaResponsePrompt] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun prompt(prompt: JsonField<BetaResponsePrompt>) = apply { body.prompt(prompt) }
+
+        /**
+         * Used by OpenAI to cache responses for similar requests to optimize your cache hit rates.
+         * Replaces the `user` field.
+         * [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+         */
+        fun promptCacheKey(promptCacheKey: String) = apply { body.promptCacheKey(promptCacheKey) }
+
+        /**
+         * Sets [Builder.promptCacheKey] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheKey] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun promptCacheKey(promptCacheKey: JsonField<String>) = apply {
+            body.promptCacheKey(promptCacheKey)
+        }
+
+        /**
+         * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+         * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+         * content blocks with `prompt_cache_breakpoint`. Each request can write up to four
+         * breakpoints. For cache matching, OpenAI considers up to the latest 80 breakpoints in the
+         * conversation, without a content-block lookback limit. Set `mode` to `explicit` to disable
+         * the implicit breakpoint. The `ttl` defaults to `30m`, which is currently the only
+         * supported value. See the
+         * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+         * current details.
+         */
+        fun promptCacheOptions(promptCacheOptions: PromptCacheOptions) = apply {
+            body.promptCacheOptions(promptCacheOptions)
+        }
+
+        /**
+         * Sets [Builder.promptCacheOptions] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheOptions] with a well-typed
+         * [PromptCacheOptions] value instead. This method is primarily for setting the field to an
+         * undocumented or not yet supported value.
+         */
+        fun promptCacheOptions(promptCacheOptions: JsonField<PromptCacheOptions>) = apply {
+            body.promptCacheOptions(promptCacheOptions)
+        }
+
+        /**
+         * Deprecated. Use `prompt_cache_options.ttl` instead.
+         *
+         * The retention policy for the prompt cache. Set to `24h` to enable extended prompt
+         * caching, which keeps cached prefixes active for longer, up to a maximum of 24 hours.
+         * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+         * This field expresses a maximum retention policy, while `prompt_cache_options.ttl`
+         * expresses a minimum cache lifetime. The two fields are independent and do not interact.
+         * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+         *
+         * For older models that support both `in_memory` and `24h`, the default depends on your
+         * organization's data retention policy:
+         * - Organizations without ZDR enabled default to `24h`.
+         * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is
+         *   not specified.
+         */
+        @Deprecated("deprecated")
+        fun promptCacheRetention(promptCacheRetention: PromptCacheRetention?) = apply {
+            body.promptCacheRetention(promptCacheRetention)
+        }
+
+        /**
+         * Alias for calling [Builder.promptCacheRetention] with
+         * `promptCacheRetention.orElse(null)`.
+         */
+        @Deprecated("deprecated")
+        fun promptCacheRetention(promptCacheRetention: Optional<PromptCacheRetention>) =
+            promptCacheRetention(promptCacheRetention.getOrNull())
+
+        /**
+         * Sets [Builder.promptCacheRetention] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheRetention] with a well-typed
+         * [PromptCacheRetention] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        @Deprecated("deprecated")
+        fun promptCacheRetention(promptCacheRetention: JsonField<PromptCacheRetention>) = apply {
+            body.promptCacheRetention(promptCacheRetention)
+        }
+
+        /**
+         * **gpt-5 and o-series models only**
+         *
+         * Configuration options for
+         * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+         */
+        fun reasoning(reasoning: Reasoning?) = apply { body.reasoning(reasoning) }
+
+        /** Alias for calling [Builder.reasoning] with `reasoning.orElse(null)`. */
+        fun reasoning(reasoning: Optional<Reasoning>) = reasoning(reasoning.getOrNull())
+
+        /**
+         * Sets [Builder.reasoning] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.reasoning] with a well-typed [Reasoning] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun reasoning(reasoning: JsonField<Reasoning>) = apply { body.reasoning(reasoning) }
+
+        /**
+         * A stable identifier used to help detect users of your application that may be violating
+         * OpenAI's usage policies. The IDs should be a string that uniquely identifies each user,
+         * with a maximum length of 64 characters. We recommend hashing their username or email
+         * address, in order to avoid sending us any identifying information.
+         * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+         */
+        fun safetyIdentifier(safetyIdentifier: String) = apply {
+            body.safetyIdentifier(safetyIdentifier)
+        }
+
+        /**
+         * Sets [Builder.safetyIdentifier] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.safetyIdentifier] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun safetyIdentifier(safetyIdentifier: JsonField<String>) = apply {
+            body.safetyIdentifier(safetyIdentifier)
+        }
+
+        /**
+         * Specifies the processing type used for serving the request.
+         * - If set to 'auto', then the request will be processed with the service tier configured
+         *   in the Project settings. Unless otherwise configured, the Project will use 'default'.
+         * - If set to 'default', then the request will be processed with the standard pricing and
+         *   performance for the selected model.
+         * - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
+         *   '[priority](https://openai.com/api-priority-processing/)', then the request will be
+         *   processed with the corresponding service tier.
+         * - When not set, the default behavior is 'auto'.
+         *
+         *   When the `service_tier` parameter is set, the response body will include the
+         *   `service_tier` value based on the processing mode actually used to serve the request.
+         *   This response value may be different from the value set in the parameter.
+         */
+        fun serviceTier(serviceTier: ServiceTier?) = apply { body.serviceTier(serviceTier) }
+
+        /** Alias for calling [Builder.serviceTier] with `serviceTier.orElse(null)`. */
+        fun serviceTier(serviceTier: Optional<ServiceTier>) = serviceTier(serviceTier.getOrNull())
+
+        /**
+         * Sets [Builder.serviceTier] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.serviceTier] with a well-typed [ServiceTier] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun serviceTier(serviceTier: JsonField<ServiceTier>) = apply {
+            body.serviceTier(serviceTier)
+        }
+
+        /** Whether to store the generated model response for later retrieval via API. */
+        fun store(store: Boolean?) = apply { body.store(store) }
+
+        /**
+         * Alias for [Builder.store].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun store(store: Boolean) = store(store as Boolean?)
+
+        /** Alias for calling [Builder.store] with `store.orElse(null)`. */
+        fun store(store: Optional<Boolean>) = store(store.getOrNull())
+
+        /**
+         * Sets [Builder.store] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.store] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun store(store: JsonField<Boolean>) = apply { body.store(store) }
+
+        /** Options for streaming responses. Only set this when you set `stream: true`. */
+        fun streamOptions(streamOptions: StreamOptions?) = apply {
+            body.streamOptions(streamOptions)
+        }
+
+        /** Alias for calling [Builder.streamOptions] with `streamOptions.orElse(null)`. */
+        fun streamOptions(streamOptions: Optional<StreamOptions>) =
+            streamOptions(streamOptions.getOrNull())
+
+        /**
+         * Sets [Builder.streamOptions] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.streamOptions] with a well-typed [StreamOptions] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun streamOptions(streamOptions: JsonField<StreamOptions>) = apply {
+            body.streamOptions(streamOptions)
+        }
+
+        /**
+         * What sampling temperature to use, between 0 and 2. Higher values like 0.8 will make the
+         * output more random, while lower values like 0.2 will make it more focused and
+         * deterministic. We generally recommend altering this or `top_p` but not both.
+         */
+        fun temperature(temperature: Double?) = apply { body.temperature(temperature) }
+
+        /**
+         * Alias for [Builder.temperature].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun temperature(temperature: Double) = temperature(temperature as Double?)
+
+        /** Alias for calling [Builder.temperature] with `temperature.orElse(null)`. */
+        fun temperature(temperature: Optional<Double>) = temperature(temperature.getOrNull())
+
+        /**
+         * Sets [Builder.temperature] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.temperature] with a well-typed [Double] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun temperature(temperature: JsonField<Double>) = apply { body.temperature(temperature) }
+
+        /**
+         * Configuration options for a text response from the model. Can be plain text or structured
+         * JSON data. Learn more:
+         * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+         * - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+         */
+        fun text(text: BetaResponseTextConfig) = apply { body.text(text) }
+
+        /**
+         * Sets [Builder.text] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.text] with a well-typed [BetaResponseTextConfig] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun text(text: JsonField<BetaResponseTextConfig>) = apply { body.text(text) }
+
+        /**
+         * How the model should select which tool (or tools) to use when generating a response. See
+         * the `tools` parameter to see how to specify which tools the model can call.
+         */
+        fun toolChoice(toolChoice: ToolChoice) = apply { body.toolChoice(toolChoice) }
+
+        /**
+         * Sets [Builder.toolChoice] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.toolChoice] with a well-typed [ToolChoice] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun toolChoice(toolChoice: JsonField<ToolChoice>) = apply { body.toolChoice(toolChoice) }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceOptions(betaToolChoiceOptions)`.
+         */
+        fun toolChoice(betaToolChoiceOptions: BetaToolChoiceOptions) = apply {
+            body.toolChoice(betaToolChoiceOptions)
+        }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceAllowed(betaToolChoiceAllowed)`.
+         */
+        fun toolChoice(betaToolChoiceAllowed: BetaToolChoiceAllowed) = apply {
+            body.toolChoice(betaToolChoiceAllowed)
+        }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceTypes(betaToolChoiceTypes)`.
+         */
+        fun toolChoice(betaToolChoiceTypes: BetaToolChoiceTypes) = apply {
+            body.toolChoice(betaToolChoiceTypes)
+        }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceFunction(betaToolChoiceFunction)`.
+         */
+        fun toolChoice(betaToolChoiceFunction: BetaToolChoiceFunction) = apply {
+            body.toolChoice(betaToolChoiceFunction)
+        }
+
+        /**
+         * Alias for calling [toolChoice] with `ToolChoice.ofBetaToolChoiceMcp(betaToolChoiceMcp)`.
+         */
+        fun toolChoice(betaToolChoiceMcp: BetaToolChoiceMcp) = apply {
+            body.toolChoice(betaToolChoiceMcp)
+        }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceCustom(betaToolChoiceCustom)`.
+         */
+        fun toolChoice(betaToolChoiceCustom: BetaToolChoiceCustom) = apply {
+            body.toolChoice(betaToolChoiceCustom)
+        }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaSpecificProgrammaticToolCallingParam()`.
+         */
+        fun toolChoiceBetaSpecificProgrammaticToolCallingParam() = apply {
+            body.toolChoiceBetaSpecificProgrammaticToolCallingParam()
+        }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch)`.
+         */
+        fun toolChoice(betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch) = apply {
+            body.toolChoice(betaToolChoiceApplyPatch)
+        }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceShell(betaToolChoiceShell)`.
+         */
+        fun toolChoice(betaToolChoiceShell: BetaToolChoiceShell) = apply {
+            body.toolChoice(betaToolChoiceShell)
+        }
+
+        /**
+         * An array of tools the model may call while generating a response. You can specify which
+         * tool to use by setting the `tool_choice` parameter.
+         *
+         * We support the following categories of tools:
+         * - **Built-in tools**: Tools that are provided by OpenAI that extend the model's
+         *   capabilities, like
+         *   [web search](https://platform.openai.com/docs/guides/tools-web-search) or
+         *   [file search](https://platform.openai.com/docs/guides/tools-file-search). Learn more
+         *   about [built-in tools](https://platform.openai.com/docs/guides/tools).
+         * - **MCP Tools**: Integrations with third-party systems via custom MCP servers or
+         *   predefined connectors such as Google Drive and SharePoint. Learn more about
+         *   [MCP Tools](https://platform.openai.com/docs/guides/tools-connectors-mcp).
+         * - **Function calls (custom tools)**: Functions that are defined by you, enabling the
+         *   model to call your own code with strongly typed arguments and outputs. Learn more about
+         *   [function calling](https://platform.openai.com/docs/guides/function-calling). You can
+         *   also use custom tools to call your own code.
+         */
+        fun tools(tools: List<BetaTool>) = apply { body.tools(tools) }
+
+        /**
+         * Sets [Builder.tools] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.tools] with a well-typed `List<BetaTool>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun tools(tools: JsonField<List<BetaTool>>) = apply { body.tools(tools) }
+
+        /**
+         * Adds a single [BetaTool] to [tools].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addTool(tool: BetaTool) = apply { body.addTool(tool) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofFunction(function)`. */
+        fun addTool(function: BetaFunctionTool) = apply { body.addTool(function) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofFileSearch(fileSearch)`. */
+        fun addTool(fileSearch: BetaFileSearchTool) = apply { body.addTool(fileSearch) }
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaFileSearchTool.builder()
+         *     .vectorStoreIds(vectorStoreIds)
+         *     .build()
+         * ```
+         */
+        fun addFileSearchTool(vectorStoreIds: List<String>) = apply {
+            body.addFileSearchTool(vectorStoreIds)
+        }
+
+        /** Alias for calling [addTool] with `BetaTool.ofComputer(computer)`. */
+        fun addTool(computer: BetaComputerTool) = apply { body.addTool(computer) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofComputerUsePreview(computerUsePreview)`. */
+        fun addTool(computerUsePreview: BetaComputerUsePreviewTool) = apply {
+            body.addTool(computerUsePreview)
+        }
+
+        /** Alias for calling [addTool] with `BetaTool.ofWebSearch(webSearch)`. */
+        fun addTool(webSearch: BetaWebSearchTool) = apply { body.addTool(webSearch) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofMcp(mcp)`. */
+        fun addTool(mcp: BetaTool.Mcp) = apply { body.addTool(mcp) }
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaTool.Mcp.builder()
+         *     .serverLabel(serverLabel)
+         *     .build()
+         * ```
+         */
+        fun addMcpTool(serverLabel: String) = apply { body.addMcpTool(serverLabel) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofCodeInterpreter(codeInterpreter)`. */
+        fun addTool(codeInterpreter: BetaTool.CodeInterpreter) = apply {
+            body.addTool(codeInterpreter)
+        }
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaTool.CodeInterpreter.builder()
+         *     .container(container)
+         *     .build()
+         * ```
+         */
+        fun addCodeInterpreterTool(container: BetaTool.CodeInterpreter.Container) = apply {
+            body.addCodeInterpreterTool(container)
+        }
+
+        /**
+         * Alias for calling [addCodeInterpreterTool] with
+         * `BetaTool.CodeInterpreter.Container.ofString(string)`.
+         */
+        fun addCodeInterpreterTool(string: String) = apply { body.addCodeInterpreterTool(string) }
+
+        /**
+         * Alias for calling [addCodeInterpreterTool] with
+         * `BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)`.
+         */
+        fun addCodeInterpreterTool(
+            codeInterpreterToolAuto: BetaTool.CodeInterpreter.Container.CodeInterpreterToolAuto
+        ) = apply { body.addCodeInterpreterTool(codeInterpreterToolAuto) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofProgrammaticToolCalling()`. */
+        fun addToolProgrammaticToolCalling() = apply { body.addToolProgrammaticToolCalling() }
+
+        /** Alias for calling [addTool] with `BetaTool.ofImageGeneration(imageGeneration)`. */
+        fun addTool(imageGeneration: BetaTool.ImageGeneration) = apply {
+            body.addTool(imageGeneration)
+        }
+
+        /** Alias for calling [addTool] with `BetaTool.ofLocalShell()`. */
+        fun addToolLocalShell() = apply { body.addToolLocalShell() }
+
+        /** Alias for calling [addTool] with `BetaTool.ofShell(shell)`. */
+        fun addTool(shell: BetaFunctionShellTool) = apply { body.addTool(shell) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofCustom(custom)`. */
+        fun addTool(custom: BetaCustomTool) = apply { body.addTool(custom) }
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaCustomTool.builder()
+         *     .name(name)
+         *     .build()
+         * ```
+         */
+        fun addCustomTool(name: String) = apply { body.addCustomTool(name) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofNamespace(namespace)`. */
+        fun addTool(namespace: BetaNamespaceTool) = apply { body.addTool(namespace) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofToolSearch(toolSearch)`. */
+        fun addTool(toolSearch: BetaToolSearchTool) = apply { body.addTool(toolSearch) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofWebSearchPreview(webSearchPreview)`. */
+        fun addTool(webSearchPreview: BetaWebSearchPreviewTool) = apply {
+            body.addTool(webSearchPreview)
+        }
+
+        /** Alias for calling [addTool] with `BetaTool.ofApplyPatch(applyPatch)`. */
+        fun addTool(applyPatch: BetaApplyPatchTool) = apply { body.addTool(applyPatch) }
+
+        /**
+         * An integer between 0 and 20 specifying the maximum number of most likely tokens to return
+         * at each token position, each with an associated log probability. In some cases, the
+         * number of returned tokens may be fewer than requested.
+         */
+        fun topLogprobs(topLogprobs: Long?) = apply { body.topLogprobs(topLogprobs) }
+
+        /**
+         * Alias for [Builder.topLogprobs].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun topLogprobs(topLogprobs: Long) = topLogprobs(topLogprobs as Long?)
+
+        /** Alias for calling [Builder.topLogprobs] with `topLogprobs.orElse(null)`. */
+        fun topLogprobs(topLogprobs: Optional<Long>) = topLogprobs(topLogprobs.getOrNull())
+
+        /**
+         * Sets [Builder.topLogprobs] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.topLogprobs] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun topLogprobs(topLogprobs: JsonField<Long>) = apply { body.topLogprobs(topLogprobs) }
+
+        /**
+         * An alternative to sampling with temperature, called nucleus sampling, where the model
+         * considers the results of the tokens with top_p probability mass. So 0.1 means only the
+         * tokens comprising the top 10% probability mass are considered.
+         *
+         * We generally recommend altering this or `temperature` but not both.
+         */
+        fun topP(topP: Double?) = apply { body.topP(topP) }
+
+        /**
+         * Alias for [Builder.topP].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun topP(topP: Double) = topP(topP as Double?)
+
+        /** Alias for calling [Builder.topP] with `topP.orElse(null)`. */
+        fun topP(topP: Optional<Double>) = topP(topP.getOrNull())
+
+        /**
+         * Sets [Builder.topP] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.topP] with a well-typed [Double] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun topP(topP: JsonField<Double>) = apply { body.topP(topP) }
+
+        /**
+         * The truncation strategy to use for the model response.
+         * - `auto`: If the input to this Response exceeds the model's context window size, the
+         *   model will truncate the response to fit the context window by dropping items from the
+         *   beginning of the conversation.
+         * - `disabled` (default): If the input size will exceed the context window size for a
+         *   model, the request will fail with a 400 error.
+         */
+        @Deprecated("deprecated")
+        fun truncation(truncation: Truncation?) = apply { body.truncation(truncation) }
+
+        /** Alias for calling [Builder.truncation] with `truncation.orElse(null)`. */
+        @Deprecated("deprecated")
+        fun truncation(truncation: Optional<Truncation>) = truncation(truncation.getOrNull())
+
+        /**
+         * Sets [Builder.truncation] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.truncation] with a well-typed [Truncation] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        @Deprecated("deprecated")
+        fun truncation(truncation: JsonField<Truncation>) = apply { body.truncation(truncation) }
+
+        /**
+         * This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+         * `prompt_cache_key` instead to maintain caching optimizations. 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#safety-identifiers).
+         */
+        @Deprecated("deprecated") fun user(user: String) = apply { body.user(user) }
+
+        /**
+         * Sets [Builder.user] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.user] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        @Deprecated("deprecated") fun user(user: JsonField<String>) = apply { body.user(user) }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [ResponseCreateParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ResponseCreateParams =
+            ResponseCreateParams(
+                betas?.toImmutable(),
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Body = body
+
+    override fun _headers(): Headers =
+        Headers.builder()
+            .apply {
+                betas?.forEach { put("openai-beta", it.toString()) }
+                putAll(additionalHeaders)
+            }
+            .build()
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val background: JsonField<Boolean>,
+        private val contextManagement: JsonField<List<ContextManagement>>,
+        private val conversation: JsonField<Conversation>,
+        private val include: JsonField<List<BetaResponseIncludable>>,
+        private val input: JsonField<Input>,
+        private val instructions: JsonField<String>,
+        private val maxOutputTokens: JsonField<Long>,
+        private val maxToolCalls: JsonField<Long>,
+        private val metadata: JsonField<Metadata>,
+        private val model: JsonField<Model>,
+        private val moderation: JsonField<Moderation>,
+        private val multiAgent: JsonField<MultiAgent>,
+        private val parallelToolCalls: JsonField<Boolean>,
+        private val previousResponseId: JsonField<String>,
+        private val prompt: JsonField<BetaResponsePrompt>,
+        private val promptCacheKey: JsonField<String>,
+        private val promptCacheOptions: JsonField<PromptCacheOptions>,
+        private val promptCacheRetention: JsonField<PromptCacheRetention>,
+        private val reasoning: JsonField<Reasoning>,
+        private val safetyIdentifier: JsonField<String>,
+        private val serviceTier: JsonField<ServiceTier>,
+        private val store: JsonField<Boolean>,
+        private val streamOptions: JsonField<StreamOptions>,
+        private val temperature: JsonField<Double>,
+        private val text: JsonField<BetaResponseTextConfig>,
+        private val toolChoice: JsonField<ToolChoice>,
+        private val tools: JsonField<List<BetaTool>>,
+        private val topLogprobs: JsonField<Long>,
+        private val topP: JsonField<Double>,
+        private val truncation: JsonField<Truncation>,
+        private val user: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("background")
+            @ExcludeMissing
+            background: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("context_management")
+            @ExcludeMissing
+            contextManagement: JsonField<List<ContextManagement>> = JsonMissing.of(),
+            @JsonProperty("conversation")
+            @ExcludeMissing
+            conversation: JsonField<Conversation> = JsonMissing.of(),
+            @JsonProperty("include")
+            @ExcludeMissing
+            include: JsonField<List<BetaResponseIncludable>> = JsonMissing.of(),
+            @JsonProperty("input") @ExcludeMissing input: JsonField<Input> = JsonMissing.of(),
+            @JsonProperty("instructions")
+            @ExcludeMissing
+            instructions: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("max_output_tokens")
+            @ExcludeMissing
+            maxOutputTokens: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("max_tool_calls")
+            @ExcludeMissing
+            maxToolCalls: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("metadata")
+            @ExcludeMissing
+            metadata: JsonField<Metadata> = JsonMissing.of(),
+            @JsonProperty("model") @ExcludeMissing model: JsonField<Model> = JsonMissing.of(),
+            @JsonProperty("moderation")
+            @ExcludeMissing
+            moderation: JsonField<Moderation> = JsonMissing.of(),
+            @JsonProperty("multi_agent")
+            @ExcludeMissing
+            multiAgent: JsonField<MultiAgent> = JsonMissing.of(),
+            @JsonProperty("parallel_tool_calls")
+            @ExcludeMissing
+            parallelToolCalls: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("previous_response_id")
+            @ExcludeMissing
+            previousResponseId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("prompt")
+            @ExcludeMissing
+            prompt: JsonField<BetaResponsePrompt> = JsonMissing.of(),
+            @JsonProperty("prompt_cache_key")
+            @ExcludeMissing
+            promptCacheKey: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("prompt_cache_options")
+            @ExcludeMissing
+            promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of(),
+            @JsonProperty("prompt_cache_retention")
+            @ExcludeMissing
+            promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of(),
+            @JsonProperty("reasoning")
+            @ExcludeMissing
+            reasoning: JsonField<Reasoning> = JsonMissing.of(),
+            @JsonProperty("safety_identifier")
+            @ExcludeMissing
+            safetyIdentifier: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("service_tier")
+            @ExcludeMissing
+            serviceTier: JsonField<ServiceTier> = JsonMissing.of(),
+            @JsonProperty("store") @ExcludeMissing store: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("stream_options")
+            @ExcludeMissing
+            streamOptions: JsonField<StreamOptions> = JsonMissing.of(),
+            @JsonProperty("temperature")
+            @ExcludeMissing
+            temperature: JsonField<Double> = JsonMissing.of(),
+            @JsonProperty("text")
+            @ExcludeMissing
+            text: JsonField<BetaResponseTextConfig> = JsonMissing.of(),
+            @JsonProperty("tool_choice")
+            @ExcludeMissing
+            toolChoice: JsonField<ToolChoice> = JsonMissing.of(),
+            @JsonProperty("tools")
+            @ExcludeMissing
+            tools: JsonField<List<BetaTool>> = JsonMissing.of(),
+            @JsonProperty("top_logprobs")
+            @ExcludeMissing
+            topLogprobs: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("top_p") @ExcludeMissing topP: JsonField<Double> = JsonMissing.of(),
+            @JsonProperty("truncation")
+            @ExcludeMissing
+            truncation: JsonField<Truncation> = JsonMissing.of(),
+            @JsonProperty("user") @ExcludeMissing user: JsonField<String> = JsonMissing.of(),
+        ) : this(
+            background,
+            contextManagement,
+            conversation,
+            include,
+            input,
+            instructions,
+            maxOutputTokens,
+            maxToolCalls,
+            metadata,
+            model,
+            moderation,
+            multiAgent,
+            parallelToolCalls,
+            previousResponseId,
+            prompt,
+            promptCacheKey,
+            promptCacheOptions,
+            promptCacheRetention,
+            reasoning,
+            safetyIdentifier,
+            serviceTier,
+            store,
+            streamOptions,
+            temperature,
+            text,
+            toolChoice,
+            tools,
+            topLogprobs,
+            topP,
+            truncation,
+            user,
+            mutableMapOf(),
+        )
+
+        /**
+         * Whether to run the model response in the background.
+         * [Learn more](https://platform.openai.com/docs/guides/background).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun background(): Optional<Boolean> = background.getOptional("background")
+
+        /**
+         * Context management configuration for this request.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun contextManagement(): Optional<List<ContextManagement>> =
+            contextManagement.getOptional("context_management")
+
+        /**
+         * The conversation that this response belongs to. Items from this conversation are
+         * prepended to `input_items` for this response request. Input items and output items from
+         * this response are automatically added to this conversation after this response completes.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun conversation(): Optional<Conversation> = conversation.getOptional("conversation")
+
+        /**
+         * Specify additional output data to include in the model response. Currently supported
+         * values are:
+         * - `web_search_call.action.sources`: Include the sources of the web search tool call.
+         * - `code_interpreter_call.outputs`: Includes the outputs of python code execution in code
+         *   interpreter tool call items.
+         * - `computer_call_output.output.image_url`: Include image urls from the computer call
+         *   output.
+         * - `file_search_call.results`: Include the search results of the file search tool call.
+         * - `message.input_image.image_url`: Include image urls from the input message.
+         * - `message.output_text.logprobs`: Include logprobs with assistant messages.
+         * - `reasoning.encrypted_content`: Includes an encrypted version of reasoning tokens in
+         *   reasoning item outputs. This enables reasoning items to be used in multi-turn
+         *   conversations when using the Responses API statelessly (like when the `store` parameter
+         *   is set to `false`, or when an organization is enrolled in the zero data retention
+         *   program).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun include(): Optional<List<BetaResponseIncludable>> = include.getOptional("include")
+
+        /**
+         * Text, image, or file inputs to the model, used to generate a response.
+         *
+         * Learn more:
+         * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+         * - [Image inputs](https://platform.openai.com/docs/guides/images)
+         * - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
+         * - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
+         * - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun input(): Optional<Input> = input.getOptional("input")
+
+        /**
+         * A system (or developer) message inserted into the model's context.
+         *
+         * When using along with `previous_response_id`, the instructions from a previous response
+         * will not be carried over to the next response. This makes it simple to swap out system
+         * (or developer) messages in new responses.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun instructions(): Optional<String> = instructions.getOptional("instructions")
+
+        /**
+         * An upper bound for the number of tokens that can be generated for a response, including
+         * visible output tokens and
+         * [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun maxOutputTokens(): Optional<Long> = maxOutputTokens.getOptional("max_output_tokens")
+
+        /**
+         * The maximum number of total calls to built-in tools that can be processed in a response.
+         * This maximum number applies across all built-in tool calls, not per individual tool. Any
+         * further attempts to call a tool by the model will be ignored.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun maxToolCalls(): Optional<Long> = maxToolCalls.getOptional("max_tool_calls")
+
+        /**
+         * Set of 16 key-value pairs that can be attached to an object. This can be useful for
+         * storing additional information about the object in a structured format, and querying for
+         * objects via API or the dashboard.
+         *
+         * Keys are strings with a maximum length of 64 characters. Values are strings with a
+         * maximum length of 512 characters.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun metadata(): Optional<Metadata> = metadata.getOptional("metadata")
+
+        /**
+         * Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide range
+         * of models with different capabilities, performance characteristics, and price points.
+         * Refer to the [model guide](https://platform.openai.com/docs/models) to browse and compare
+         * available models.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun model(): Optional<Model> = model.getOptional("model")
+
+        /**
+         * Configuration for running moderation on the input and output of this response.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun moderation(): Optional<Moderation> = moderation.getOptional("moderation")
+
+        /**
+         * Configuration for server-hosted multi-agent execution.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun multiAgent(): Optional<MultiAgent> = multiAgent.getOptional("multi_agent")
+
+        /**
+         * Whether to allow the model to run tool calls in parallel.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun parallelToolCalls(): Optional<Boolean> =
+            parallelToolCalls.getOptional("parallel_tool_calls")
+
+        /**
+         * The unique ID of the previous response to the model. Use this to create multi-turn
+         * conversations. Learn more about
+         * [conversation state](https://platform.openai.com/docs/guides/conversation-state). Cannot
+         * be used in conjunction with `conversation`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun previousResponseId(): Optional<String> =
+            previousResponseId.getOptional("previous_response_id")
+
+        /**
+         * Reference to a prompt template and its variables.
+         * [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun prompt(): Optional<BetaResponsePrompt> = prompt.getOptional("prompt")
+
+        /**
+         * Used by OpenAI to cache responses for similar requests to optimize your cache hit rates.
+         * Replaces the `user` field.
+         * [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun promptCacheKey(): Optional<String> = promptCacheKey.getOptional("prompt_cache_key")
+
+        /**
+         * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+         * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+         * content blocks with `prompt_cache_breakpoint`. Each request can write up to four
+         * breakpoints. For cache matching, OpenAI considers up to the latest 80 breakpoints in the
+         * conversation, without a content-block lookback limit. Set `mode` to `explicit` to disable
+         * the implicit breakpoint. The `ttl` defaults to `30m`, which is currently the only
+         * supported value. See the
+         * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+         * current details.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun promptCacheOptions(): Optional<PromptCacheOptions> =
+            promptCacheOptions.getOptional("prompt_cache_options")
+
+        /**
+         * Deprecated. Use `prompt_cache_options.ttl` instead.
+         *
+         * The retention policy for the prompt cache. Set to `24h` to enable extended prompt
+         * caching, which keeps cached prefixes active for longer, up to a maximum of 24 hours.
+         * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+         * This field expresses a maximum retention policy, while `prompt_cache_options.ttl`
+         * expresses a minimum cache lifetime. The two fields are independent and do not interact.
+         * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+         *
+         * For older models that support both `in_memory` and `24h`, the default depends on your
+         * organization's data retention policy:
+         * - Organizations without ZDR enabled default to `24h`.
+         * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is
+         *   not specified.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        @Deprecated("deprecated")
+        fun promptCacheRetention(): Optional<PromptCacheRetention> =
+            promptCacheRetention.getOptional("prompt_cache_retention")
+
+        /**
+         * **gpt-5 and o-series models only**
+         *
+         * Configuration options for
+         * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun reasoning(): Optional<Reasoning> = reasoning.getOptional("reasoning")
+
+        /**
+         * A stable identifier used to help detect users of your application that may be violating
+         * OpenAI's usage policies. The IDs should be a string that uniquely identifies each user,
+         * with a maximum length of 64 characters. We recommend hashing their username or email
+         * address, in order to avoid sending us any identifying information.
+         * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun safetyIdentifier(): Optional<String> = safetyIdentifier.getOptional("safety_identifier")
+
+        /**
+         * Specifies the processing type used for serving the request.
+         * - If set to 'auto', then the request will be processed with the service tier configured
+         *   in the Project settings. Unless otherwise configured, the Project will use 'default'.
+         * - If set to 'default', then the request will be processed with the standard pricing and
+         *   performance for the selected model.
+         * - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
+         *   '[priority](https://openai.com/api-priority-processing/)', then the request will be
+         *   processed with the corresponding service tier.
+         * - When not set, the default behavior is 'auto'.
+         *
+         *   When the `service_tier` parameter is set, the response body will include the
+         *   `service_tier` value based on the processing mode actually used to serve the request.
+         *   This response value may be different from the value set in the parameter.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun serviceTier(): Optional<ServiceTier> = serviceTier.getOptional("service_tier")
+
+        /**
+         * Whether to store the generated model response for later retrieval via API.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun store(): Optional<Boolean> = store.getOptional("store")
+
+        /**
+         * Options for streaming responses. Only set this when you set `stream: true`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun streamOptions(): Optional<StreamOptions> = streamOptions.getOptional("stream_options")
+
+        /**
+         * What sampling temperature to use, between 0 and 2. Higher values like 0.8 will make the
+         * output more random, while lower values like 0.2 will make it more focused and
+         * deterministic. We generally recommend altering this or `top_p` but not both.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun temperature(): Optional<Double> = temperature.getOptional("temperature")
+
+        /**
+         * Configuration options for a text response from the model. Can be plain text or structured
+         * JSON data. Learn more:
+         * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+         * - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun text(): Optional<BetaResponseTextConfig> = text.getOptional("text")
+
+        /**
+         * How the model should select which tool (or tools) to use when generating a response. See
+         * the `tools` parameter to see how to specify which tools the model can call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun toolChoice(): Optional<ToolChoice> = toolChoice.getOptional("tool_choice")
+
+        /**
+         * An array of tools the model may call while generating a response. You can specify which
+         * tool to use by setting the `tool_choice` parameter.
+         *
+         * We support the following categories of tools:
+         * - **Built-in tools**: Tools that are provided by OpenAI that extend the model's
+         *   capabilities, like
+         *   [web search](https://platform.openai.com/docs/guides/tools-web-search) or
+         *   [file search](https://platform.openai.com/docs/guides/tools-file-search). Learn more
+         *   about [built-in tools](https://platform.openai.com/docs/guides/tools).
+         * - **MCP Tools**: Integrations with third-party systems via custom MCP servers or
+         *   predefined connectors such as Google Drive and SharePoint. Learn more about
+         *   [MCP Tools](https://platform.openai.com/docs/guides/tools-connectors-mcp).
+         * - **Function calls (custom tools)**: Functions that are defined by you, enabling the
+         *   model to call your own code with strongly typed arguments and outputs. Learn more about
+         *   [function calling](https://platform.openai.com/docs/guides/function-calling). You can
+         *   also use custom tools to call your own code.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun tools(): Optional<List<BetaTool>> = tools.getOptional("tools")
+
+        /**
+         * An integer between 0 and 20 specifying the maximum number of most likely tokens to return
+         * at each token position, each with an associated log probability. In some cases, the
+         * number of returned tokens may be fewer than requested.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun topLogprobs(): Optional<Long> = topLogprobs.getOptional("top_logprobs")
+
+        /**
+         * An alternative to sampling with temperature, called nucleus sampling, where the model
+         * considers the results of the tokens with top_p probability mass. So 0.1 means only the
+         * tokens comprising the top 10% probability mass are considered.
+         *
+         * We generally recommend altering this or `temperature` but not both.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun topP(): Optional<Double> = topP.getOptional("top_p")
+
+        /**
+         * The truncation strategy to use for the model response.
+         * - `auto`: If the input to this Response exceeds the model's context window size, the
+         *   model will truncate the response to fit the context window by dropping items from the
+         *   beginning of the conversation.
+         * - `disabled` (default): If the input size will exceed the context window size for a
+         *   model, the request will fail with a 400 error.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        @Deprecated("deprecated")
+        fun truncation(): Optional<Truncation> = truncation.getOptional("truncation")
+
+        /**
+         * This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+         * `prompt_cache_key` instead to maintain caching optimizations. 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#safety-identifiers).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        @Deprecated("deprecated") fun user(): Optional<String> = user.getOptional("user")
+
+        /**
+         * Returns the raw JSON value of [background].
+         *
+         * Unlike [background], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("background")
+        @ExcludeMissing
+        fun _background(): JsonField<Boolean> = background
+
+        /**
+         * Returns the raw JSON value of [contextManagement].
+         *
+         * Unlike [contextManagement], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("context_management")
+        @ExcludeMissing
+        fun _contextManagement(): JsonField<List<ContextManagement>> = contextManagement
+
+        /**
+         * Returns the raw JSON value of [conversation].
+         *
+         * Unlike [conversation], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("conversation")
+        @ExcludeMissing
+        fun _conversation(): JsonField<Conversation> = conversation
+
+        /**
+         * Returns the raw JSON value of [include].
+         *
+         * Unlike [include], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("include")
+        @ExcludeMissing
+        fun _include(): JsonField<List<BetaResponseIncludable>> = include
+
+        /**
+         * Returns the raw JSON value of [input].
+         *
+         * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("input") @ExcludeMissing fun _input(): JsonField<Input> = input
+
+        /**
+         * Returns the raw JSON value of [instructions].
+         *
+         * Unlike [instructions], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("instructions")
+        @ExcludeMissing
+        fun _instructions(): JsonField<String> = instructions
+
+        /**
+         * Returns the raw JSON value of [maxOutputTokens].
+         *
+         * Unlike [maxOutputTokens], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("max_output_tokens")
+        @ExcludeMissing
+        fun _maxOutputTokens(): JsonField<Long> = maxOutputTokens
+
+        /**
+         * Returns the raw JSON value of [maxToolCalls].
+         *
+         * Unlike [maxToolCalls], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("max_tool_calls")
+        @ExcludeMissing
+        fun _maxToolCalls(): JsonField<Long> = maxToolCalls
+
+        /**
+         * Returns the raw JSON value of [metadata].
+         *
+         * Unlike [metadata], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("metadata") @ExcludeMissing fun _metadata(): JsonField<Metadata> = metadata
+
+        /**
+         * Returns the raw JSON value of [model].
+         *
+         * Unlike [model], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("model") @ExcludeMissing fun _model(): JsonField<Model> = model
+
+        /**
+         * Returns the raw JSON value of [moderation].
+         *
+         * Unlike [moderation], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("moderation")
+        @ExcludeMissing
+        fun _moderation(): JsonField<Moderation> = moderation
+
+        /**
+         * Returns the raw JSON value of [multiAgent].
+         *
+         * Unlike [multiAgent], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("multi_agent")
+        @ExcludeMissing
+        fun _multiAgent(): JsonField<MultiAgent> = multiAgent
+
+        /**
+         * Returns the raw JSON value of [parallelToolCalls].
+         *
+         * Unlike [parallelToolCalls], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("parallel_tool_calls")
+        @ExcludeMissing
+        fun _parallelToolCalls(): JsonField<Boolean> = parallelToolCalls
+
+        /**
+         * Returns the raw JSON value of [previousResponseId].
+         *
+         * Unlike [previousResponseId], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @JsonProperty("previous_response_id")
+        @ExcludeMissing
+        fun _previousResponseId(): JsonField<String> = previousResponseId
+
+        /**
+         * Returns the raw JSON value of [prompt].
+         *
+         * Unlike [prompt], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("prompt")
+        @ExcludeMissing
+        fun _prompt(): JsonField<BetaResponsePrompt> = prompt
+
+        /**
+         * Returns the raw JSON value of [promptCacheKey].
+         *
+         * Unlike [promptCacheKey], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("prompt_cache_key")
+        @ExcludeMissing
+        fun _promptCacheKey(): JsonField<String> = promptCacheKey
+
+        /**
+         * Returns the raw JSON value of [promptCacheOptions].
+         *
+         * Unlike [promptCacheOptions], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @JsonProperty("prompt_cache_options")
+        @ExcludeMissing
+        fun _promptCacheOptions(): JsonField<PromptCacheOptions> = promptCacheOptions
+
+        /**
+         * Returns the raw JSON value of [promptCacheRetention].
+         *
+         * Unlike [promptCacheRetention], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @Deprecated("deprecated")
+        @JsonProperty("prompt_cache_retention")
+        @ExcludeMissing
+        fun _promptCacheRetention(): JsonField<PromptCacheRetention> = promptCacheRetention
+
+        /**
+         * Returns the raw JSON value of [reasoning].
+         *
+         * Unlike [reasoning], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("reasoning")
+        @ExcludeMissing
+        fun _reasoning(): JsonField<Reasoning> = reasoning
+
+        /**
+         * Returns the raw JSON value of [safetyIdentifier].
+         *
+         * Unlike [safetyIdentifier], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("safety_identifier")
+        @ExcludeMissing
+        fun _safetyIdentifier(): JsonField<String> = safetyIdentifier
+
+        /**
+         * Returns the raw JSON value of [serviceTier].
+         *
+         * Unlike [serviceTier], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("service_tier")
+        @ExcludeMissing
+        fun _serviceTier(): JsonField<ServiceTier> = serviceTier
+
+        /**
+         * Returns the raw JSON value of [store].
+         *
+         * Unlike [store], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("store") @ExcludeMissing fun _store(): JsonField<Boolean> = store
+
+        /**
+         * Returns the raw JSON value of [streamOptions].
+         *
+         * Unlike [streamOptions], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("stream_options")
+        @ExcludeMissing
+        fun _streamOptions(): JsonField<StreamOptions> = streamOptions
+
+        /**
+         * Returns the raw JSON value of [temperature].
+         *
+         * Unlike [temperature], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("temperature")
+        @ExcludeMissing
+        fun _temperature(): JsonField<Double> = temperature
+
+        /**
+         * Returns the raw JSON value of [text].
+         *
+         * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<BetaResponseTextConfig> = text
+
+        /**
+         * Returns the raw JSON value of [toolChoice].
+         *
+         * Unlike [toolChoice], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("tool_choice")
+        @ExcludeMissing
+        fun _toolChoice(): JsonField<ToolChoice> = toolChoice
+
+        /**
+         * Returns the raw JSON value of [tools].
+         *
+         * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<BetaTool>> = tools
+
+        /**
+         * Returns the raw JSON value of [topLogprobs].
+         *
+         * Unlike [topLogprobs], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("top_logprobs")
+        @ExcludeMissing
+        fun _topLogprobs(): JsonField<Long> = topLogprobs
+
+        /**
+         * Returns the raw JSON value of [topP].
+         *
+         * Unlike [topP], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("top_p") @ExcludeMissing fun _topP(): JsonField<Double> = topP
+
+        /**
+         * Returns the raw JSON value of [truncation].
+         *
+         * Unlike [truncation], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @Deprecated("deprecated")
+        @JsonProperty("truncation")
+        @ExcludeMissing
+        fun _truncation(): JsonField<Truncation> = truncation
+
+        /**
+         * Returns the raw JSON value of [user].
+         *
+         * Unlike [user], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @Deprecated("deprecated")
+        @JsonProperty("user")
+        @ExcludeMissing
+        fun _user(): JsonField<String> = user
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Body]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var background: JsonField<Boolean> = JsonMissing.of()
+            private var contextManagement: JsonField<MutableList<ContextManagement>>? = null
+            private var conversation: JsonField<Conversation> = JsonMissing.of()
+            private var include: JsonField<MutableList<BetaResponseIncludable>>? = null
+            private var input: JsonField<Input> = JsonMissing.of()
+            private var instructions: JsonField<String> = JsonMissing.of()
+            private var maxOutputTokens: JsonField<Long> = JsonMissing.of()
+            private var maxToolCalls: JsonField<Long> = JsonMissing.of()
+            private var metadata: JsonField<Metadata> = JsonMissing.of()
+            private var model: JsonField<Model> = JsonMissing.of()
+            private var moderation: JsonField<Moderation> = JsonMissing.of()
+            private var multiAgent: JsonField<MultiAgent> = JsonMissing.of()
+            private var parallelToolCalls: JsonField<Boolean> = JsonMissing.of()
+            private var previousResponseId: JsonField<String> = JsonMissing.of()
+            private var prompt: JsonField<BetaResponsePrompt> = JsonMissing.of()
+            private var promptCacheKey: JsonField<String> = JsonMissing.of()
+            private var promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of()
+            private var promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of()
+            private var reasoning: JsonField<Reasoning> = JsonMissing.of()
+            private var safetyIdentifier: JsonField<String> = JsonMissing.of()
+            private var serviceTier: JsonField<ServiceTier> = JsonMissing.of()
+            private var store: JsonField<Boolean> = JsonMissing.of()
+            private var streamOptions: JsonField<StreamOptions> = JsonMissing.of()
+            private var temperature: JsonField<Double> = JsonMissing.of()
+            private var text: JsonField<BetaResponseTextConfig> = JsonMissing.of()
+            private var toolChoice: JsonField<ToolChoice> = JsonMissing.of()
+            private var tools: JsonField<MutableList<BetaTool>>? = null
+            private var topLogprobs: JsonField<Long> = JsonMissing.of()
+            private var topP: JsonField<Double> = JsonMissing.of()
+            private var truncation: JsonField<Truncation> = JsonMissing.of()
+            private var user: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                background = body.background
+                contextManagement = body.contextManagement.map { it.toMutableList() }
+                conversation = body.conversation
+                include = body.include.map { it.toMutableList() }
+                input = body.input
+                instructions = body.instructions
+                maxOutputTokens = body.maxOutputTokens
+                maxToolCalls = body.maxToolCalls
+                metadata = body.metadata
+                model = body.model
+                moderation = body.moderation
+                multiAgent = body.multiAgent
+                parallelToolCalls = body.parallelToolCalls
+                previousResponseId = body.previousResponseId
+                prompt = body.prompt
+                promptCacheKey = body.promptCacheKey
+                promptCacheOptions = body.promptCacheOptions
+                promptCacheRetention = body.promptCacheRetention
+                reasoning = body.reasoning
+                safetyIdentifier = body.safetyIdentifier
+                serviceTier = body.serviceTier
+                store = body.store
+                streamOptions = body.streamOptions
+                temperature = body.temperature
+                text = body.text
+                toolChoice = body.toolChoice
+                tools = body.tools.map { it.toMutableList() }
+                topLogprobs = body.topLogprobs
+                topP = body.topP
+                truncation = body.truncation
+                user = body.user
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Whether to run the model response in the background.
+             * [Learn more](https://platform.openai.com/docs/guides/background).
+             */
+            fun background(background: Boolean?) = background(JsonField.ofNullable(background))
+
+            /**
+             * Alias for [Builder.background].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun background(background: Boolean) = background(background as Boolean?)
+
+            /** Alias for calling [Builder.background] with `background.orElse(null)`. */
+            fun background(background: Optional<Boolean>) = background(background.getOrNull())
+
+            /**
+             * Sets [Builder.background] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.background] with a well-typed [Boolean] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun background(background: JsonField<Boolean>) = apply { this.background = background }
+
+            /** Context management configuration for this request. */
+            fun contextManagement(contextManagement: List<ContextManagement>?) =
+                contextManagement(JsonField.ofNullable(contextManagement))
+
+            /**
+             * Alias for calling [Builder.contextManagement] with `contextManagement.orElse(null)`.
+             */
+            fun contextManagement(contextManagement: Optional<List<ContextManagement>>) =
+                contextManagement(contextManagement.getOrNull())
+
+            /**
+             * Sets [Builder.contextManagement] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.contextManagement] with a well-typed
+             * `List<ContextManagement>` value instead. This method is primarily for setting the
+             * field to an undocumented or not yet supported value.
+             */
+            fun contextManagement(contextManagement: JsonField<List<ContextManagement>>) = apply {
+                this.contextManagement = contextManagement.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [ContextManagement] to [Builder.contextManagement].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addContextManagement(contextManagement: ContextManagement) = apply {
+                this.contextManagement =
+                    (this.contextManagement ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("contextManagement", it).add(contextManagement)
+                    }
+            }
+
+            /**
+             * The conversation that this response belongs to. Items from this conversation are
+             * prepended to `input_items` for this response request. Input items and output items
+             * from this response are automatically added to this conversation after this response
+             * completes.
+             */
+            fun conversation(conversation: Conversation?) =
+                conversation(JsonField.ofNullable(conversation))
+
+            /** Alias for calling [Builder.conversation] with `conversation.orElse(null)`. */
+            fun conversation(conversation: Optional<Conversation>) =
+                conversation(conversation.getOrNull())
+
+            /**
+             * Sets [Builder.conversation] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.conversation] with a well-typed [Conversation] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun conversation(conversation: JsonField<Conversation>) = apply {
+                this.conversation = conversation
+            }
+
+            /** Alias for calling [conversation] with `Conversation.ofId(id)`. */
+            fun conversation(id: String) = conversation(Conversation.ofId(id))
+
+            /**
+             * Alias for calling [conversation] with
+             * `Conversation.ofBetaResponseConversationParam(betaResponseConversationParam)`.
+             */
+            fun conversation(betaResponseConversationParam: BetaResponseConversationParam) =
+                conversation(
+                    Conversation.ofBetaResponseConversationParam(betaResponseConversationParam)
+                )
+
+            /**
+             * Specify additional output data to include in the model response. Currently supported
+             * values are:
+             * - `web_search_call.action.sources`: Include the sources of the web search tool call.
+             * - `code_interpreter_call.outputs`: Includes the outputs of python code execution in
+             *   code interpreter tool call items.
+             * - `computer_call_output.output.image_url`: Include image urls from the computer call
+             *   output.
+             * - `file_search_call.results`: Include the search results of the file search tool
+             *   call.
+             * - `message.input_image.image_url`: Include image urls from the input message.
+             * - `message.output_text.logprobs`: Include logprobs with assistant messages.
+             * - `reasoning.encrypted_content`: Includes an encrypted version of reasoning tokens in
+             *   reasoning item outputs. This enables reasoning items to be used in multi-turn
+             *   conversations when using the Responses API statelessly (like when the `store`
+             *   parameter is set to `false`, or when an organization is enrolled in the zero data
+             *   retention program).
+             */
+            fun include(include: List<BetaResponseIncludable>?) =
+                include(JsonField.ofNullable(include))
+
+            /** Alias for calling [Builder.include] with `include.orElse(null)`. */
+            fun include(include: Optional<List<BetaResponseIncludable>>) =
+                include(include.getOrNull())
+
+            /**
+             * Sets [Builder.include] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.include] with a well-typed
+             * `List<BetaResponseIncludable>` value instead. This method is primarily for setting
+             * the field to an undocumented or not yet supported value.
+             */
+            fun include(include: JsonField<List<BetaResponseIncludable>>) = apply {
+                this.include = include.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [BetaResponseIncludable] to [Builder.include].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addInclude(include: BetaResponseIncludable) = apply {
+                this.include =
+                    (this.include ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("include", it).add(include)
+                    }
+            }
+
+            /**
+             * Text, image, or file inputs to the model, used to generate a response.
+             *
+             * Learn more:
+             * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+             * - [Image inputs](https://platform.openai.com/docs/guides/images)
+             * - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
+             * - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
+             * - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+             */
+            fun input(input: Input) = input(JsonField.of(input))
+
+            /**
+             * Sets [Builder.input] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.input] with a well-typed [Input] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun input(input: JsonField<Input>) = apply { this.input = input }
+
+            /** Alias for calling [input] with `Input.ofText(text)`. */
+            fun input(text: String) = input(Input.ofText(text))
+
+            /** Alias for calling [input] with `Input.ofBetaResponse(betaResponse)`. */
+            fun inputOfBetaResponse(betaResponse: List<BetaResponseInputItem>) =
+                input(Input.ofBetaResponse(betaResponse))
+
+            /**
+             * A system (or developer) message inserted into the model's context.
+             *
+             * When using along with `previous_response_id`, the instructions from a previous
+             * response will not be carried over to the next response. This makes it simple to swap
+             * out system (or developer) messages in new responses.
+             */
+            fun instructions(instructions: String?) =
+                instructions(JsonField.ofNullable(instructions))
+
+            /** Alias for calling [Builder.instructions] with `instructions.orElse(null)`. */
+            fun instructions(instructions: Optional<String>) =
+                instructions(instructions.getOrNull())
+
+            /**
+             * Sets [Builder.instructions] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.instructions] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun instructions(instructions: JsonField<String>) = apply {
+                this.instructions = instructions
+            }
+
+            /**
+             * An upper bound for the number of tokens that can be generated for a response,
+             * including visible output tokens and
+             * [reasoning tokens](https://platform.openai.com/docs/guides/reasoning).
+             */
+            fun maxOutputTokens(maxOutputTokens: Long?) =
+                maxOutputTokens(JsonField.ofNullable(maxOutputTokens))
+
+            /**
+             * Alias for [Builder.maxOutputTokens].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun maxOutputTokens(maxOutputTokens: Long) = maxOutputTokens(maxOutputTokens as Long?)
+
+            /** Alias for calling [Builder.maxOutputTokens] with `maxOutputTokens.orElse(null)`. */
+            fun maxOutputTokens(maxOutputTokens: Optional<Long>) =
+                maxOutputTokens(maxOutputTokens.getOrNull())
+
+            /**
+             * Sets [Builder.maxOutputTokens] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.maxOutputTokens] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun maxOutputTokens(maxOutputTokens: JsonField<Long>) = apply {
+                this.maxOutputTokens = maxOutputTokens
+            }
+
+            /**
+             * The maximum number of total calls to built-in tools that can be processed in a
+             * response. This maximum number applies across all built-in tool calls, not per
+             * individual tool. Any further attempts to call a tool by the model will be ignored.
+             */
+            fun maxToolCalls(maxToolCalls: Long?) = maxToolCalls(JsonField.ofNullable(maxToolCalls))
+
+            /**
+             * Alias for [Builder.maxToolCalls].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun maxToolCalls(maxToolCalls: Long) = maxToolCalls(maxToolCalls as Long?)
+
+            /** Alias for calling [Builder.maxToolCalls] with `maxToolCalls.orElse(null)`. */
+            fun maxToolCalls(maxToolCalls: Optional<Long>) = maxToolCalls(maxToolCalls.getOrNull())
+
+            /**
+             * Sets [Builder.maxToolCalls] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.maxToolCalls] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun maxToolCalls(maxToolCalls: JsonField<Long>) = apply {
+                this.maxToolCalls = maxToolCalls
+            }
+
+            /**
+             * Set of 16 key-value pairs that can be attached to an object. This can be useful for
+             * storing additional information about the object in a structured format, and querying
+             * for objects via API or the dashboard.
+             *
+             * Keys are strings with a maximum length of 64 characters. Values are strings with a
+             * maximum length of 512 characters.
+             */
+            fun metadata(metadata: Metadata?) = metadata(JsonField.ofNullable(metadata))
+
+            /** Alias for calling [Builder.metadata] with `metadata.orElse(null)`. */
+            fun metadata(metadata: Optional<Metadata>) = metadata(metadata.getOrNull())
+
+            /**
+             * Sets [Builder.metadata] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.metadata] with a well-typed [Metadata] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun metadata(metadata: JsonField<Metadata>) = apply { this.metadata = metadata }
+
+            /**
+             * Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide
+             * range of models with different capabilities, performance characteristics, and price
+             * points. Refer to the [model guide](https://platform.openai.com/docs/models) to browse
+             * and compare available models.
+             */
+            fun model(model: Model) = model(JsonField.of(model))
+
+            /**
+             * Sets [Builder.model] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.model] with a well-typed [Model] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun model(model: JsonField<Model>) = apply { this.model = model }
+
+            /**
+             * Sets [model] to an arbitrary [String].
+             *
+             * You should usually call [model] with a well-typed [Model] constant instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun model(value: String) = model(Model.of(value))
+
+            /** Configuration for running moderation on the input and output of this response. */
+            fun moderation(moderation: Moderation?) = moderation(JsonField.ofNullable(moderation))
+
+            /** Alias for calling [Builder.moderation] with `moderation.orElse(null)`. */
+            fun moderation(moderation: Optional<Moderation>) = moderation(moderation.getOrNull())
+
+            /**
+             * Sets [Builder.moderation] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.moderation] with a well-typed [Moderation] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun moderation(moderation: JsonField<Moderation>) = apply {
+                this.moderation = moderation
+            }
+
+            /** Configuration for server-hosted multi-agent execution. */
+            fun multiAgent(multiAgent: MultiAgent?) = multiAgent(JsonField.ofNullable(multiAgent))
+
+            /** Alias for calling [Builder.multiAgent] with `multiAgent.orElse(null)`. */
+            fun multiAgent(multiAgent: Optional<MultiAgent>) = multiAgent(multiAgent.getOrNull())
+
+            /**
+             * Sets [Builder.multiAgent] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.multiAgent] with a well-typed [MultiAgent] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun multiAgent(multiAgent: JsonField<MultiAgent>) = apply {
+                this.multiAgent = multiAgent
+            }
+
+            /** Whether to allow the model to run tool calls in parallel. */
+            fun parallelToolCalls(parallelToolCalls: Boolean?) =
+                parallelToolCalls(JsonField.ofNullable(parallelToolCalls))
+
+            /**
+             * Alias for [Builder.parallelToolCalls].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun parallelToolCalls(parallelToolCalls: Boolean) =
+                parallelToolCalls(parallelToolCalls as Boolean?)
+
+            /**
+             * Alias for calling [Builder.parallelToolCalls] with `parallelToolCalls.orElse(null)`.
+             */
+            fun parallelToolCalls(parallelToolCalls: Optional<Boolean>) =
+                parallelToolCalls(parallelToolCalls.getOrNull())
+
+            /**
+             * Sets [Builder.parallelToolCalls] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.parallelToolCalls] with a well-typed [Boolean] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun parallelToolCalls(parallelToolCalls: JsonField<Boolean>) = apply {
+                this.parallelToolCalls = parallelToolCalls
+            }
+
+            /**
+             * The unique ID of the previous response to the model. Use this to create multi-turn
+             * conversations. Learn more about
+             * [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+             * Cannot be used in conjunction with `conversation`.
+             */
+            fun previousResponseId(previousResponseId: String?) =
+                previousResponseId(JsonField.ofNullable(previousResponseId))
+
+            /**
+             * Alias for calling [Builder.previousResponseId] with
+             * `previousResponseId.orElse(null)`.
+             */
+            fun previousResponseId(previousResponseId: Optional<String>) =
+                previousResponseId(previousResponseId.getOrNull())
+
+            /**
+             * Sets [Builder.previousResponseId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.previousResponseId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun previousResponseId(previousResponseId: JsonField<String>) = apply {
+                this.previousResponseId = previousResponseId
+            }
+
+            /**
+             * Reference to a prompt template and its variables.
+             * [Learn more](https://platform.openai.com/docs/guides/text?api-mode=responses#reusable-prompts).
+             */
+            fun prompt(prompt: BetaResponsePrompt?) = prompt(JsonField.ofNullable(prompt))
+
+            /** Alias for calling [Builder.prompt] with `prompt.orElse(null)`. */
+            fun prompt(prompt: Optional<BetaResponsePrompt>) = prompt(prompt.getOrNull())
+
+            /**
+             * Sets [Builder.prompt] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.prompt] with a well-typed [BetaResponsePrompt] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun prompt(prompt: JsonField<BetaResponsePrompt>) = apply { this.prompt = prompt }
+
+            /**
+             * Used by OpenAI to cache responses for similar requests to optimize your cache hit
+             * rates. Replaces the `user` field.
+             * [Learn more](https://platform.openai.com/docs/guides/prompt-caching).
+             */
+            fun promptCacheKey(promptCacheKey: String) =
+                promptCacheKey(JsonField.of(promptCacheKey))
+
+            /**
+             * Sets [Builder.promptCacheKey] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.promptCacheKey] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun promptCacheKey(promptCacheKey: JsonField<String>) = apply {
+                this.promptCacheKey = promptCacheKey
+            }
+
+            /**
+             * Options for prompt caching. Supported for `gpt-5.6` and later models. By default,
+             * OpenAI automatically chooses one implicit cache breakpoint. You can add explicit
+             * breakpoints to content blocks with `prompt_cache_breakpoint`. Each request can write
+             * up to four breakpoints. For cache matching, OpenAI considers up to the latest 80
+             * breakpoints in the conversation, without a content-block lookback limit. Set `mode`
+             * to `explicit` to disable the implicit breakpoint. The `ttl` defaults to `30m`, which
+             * is currently the only supported value. See the
+             * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+             * current details.
+             */
+            fun promptCacheOptions(promptCacheOptions: PromptCacheOptions) =
+                promptCacheOptions(JsonField.of(promptCacheOptions))
+
+            /**
+             * Sets [Builder.promptCacheOptions] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.promptCacheOptions] with a well-typed
+             * [PromptCacheOptions] value instead. This method is primarily for setting the field to
+             * an undocumented or not yet supported value.
+             */
+            fun promptCacheOptions(promptCacheOptions: JsonField<PromptCacheOptions>) = apply {
+                this.promptCacheOptions = promptCacheOptions
+            }
+
+            /**
+             * Deprecated. Use `prompt_cache_options.ttl` instead.
+             *
+             * The retention policy for the prompt cache. Set to `24h` to enable extended prompt
+             * caching, which keeps cached prefixes active for longer, up to a maximum of 24 hours.
+             * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+             * This field expresses a maximum retention policy, while `prompt_cache_options.ttl`
+             * expresses a minimum cache lifetime. The two fields are independent and do not
+             * interact. For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+             *
+             * For older models that support both `in_memory` and `24h`, the default depends on your
+             * organization's data retention policy:
+             * - Organizations without ZDR enabled default to `24h`.
+             * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention`
+             *   is not specified.
+             */
+            @Deprecated("deprecated")
+            fun promptCacheRetention(promptCacheRetention: PromptCacheRetention?) =
+                promptCacheRetention(JsonField.ofNullable(promptCacheRetention))
+
+            /**
+             * Alias for calling [Builder.promptCacheRetention] with
+             * `promptCacheRetention.orElse(null)`.
+             */
+            @Deprecated("deprecated")
+            fun promptCacheRetention(promptCacheRetention: Optional<PromptCacheRetention>) =
+                promptCacheRetention(promptCacheRetention.getOrNull())
+
+            /**
+             * Sets [Builder.promptCacheRetention] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.promptCacheRetention] with a well-typed
+             * [PromptCacheRetention] value instead. This method is primarily for setting the field
+             * to an undocumented or not yet supported value.
+             */
+            @Deprecated("deprecated")
+            fun promptCacheRetention(promptCacheRetention: JsonField<PromptCacheRetention>) =
+                apply {
+                    this.promptCacheRetention = promptCacheRetention
+                }
+
+            /**
+             * **gpt-5 and o-series models only**
+             *
+             * Configuration options for
+             * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+             */
+            fun reasoning(reasoning: Reasoning?) = reasoning(JsonField.ofNullable(reasoning))
+
+            /** Alias for calling [Builder.reasoning] with `reasoning.orElse(null)`. */
+            fun reasoning(reasoning: Optional<Reasoning>) = reasoning(reasoning.getOrNull())
+
+            /**
+             * Sets [Builder.reasoning] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.reasoning] with a well-typed [Reasoning] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun reasoning(reasoning: JsonField<Reasoning>) = apply { this.reasoning = reasoning }
+
+            /**
+             * A stable identifier used to help detect users of your application that may be
+             * violating OpenAI's usage policies. The IDs should be a string that uniquely
+             * identifies each user, with a maximum length of 64 characters. We recommend hashing
+             * their username or email address, in order to avoid sending us any identifying
+             * information.
+             * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#safety-identifiers).
+             */
+            fun safetyIdentifier(safetyIdentifier: String) =
+                safetyIdentifier(JsonField.of(safetyIdentifier))
+
+            /**
+             * Sets [Builder.safetyIdentifier] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.safetyIdentifier] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun safetyIdentifier(safetyIdentifier: JsonField<String>) = apply {
+                this.safetyIdentifier = safetyIdentifier
+            }
+
+            /**
+             * Specifies the processing type used for serving the request.
+             * - If set to 'auto', then the request will be processed with the service tier
+             *   configured in the Project settings. Unless otherwise configured, the Project will
+             *   use 'default'.
+             * - If set to 'default', then the request will be processed with the standard pricing
+             *   and performance for the selected model.
+             * - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
+             *   '[priority](https://openai.com/api-priority-processing/)', then the request will be
+             *   processed with the corresponding service tier.
+             * - When not set, the default behavior is 'auto'.
+             *
+             *   When the `service_tier` parameter is set, the response body will include the
+             *   `service_tier` value based on the processing mode actually used to serve the
+             *   request. This response value may be different from the value set in the parameter.
+             */
+            fun serviceTier(serviceTier: ServiceTier?) =
+                serviceTier(JsonField.ofNullable(serviceTier))
+
+            /** Alias for calling [Builder.serviceTier] with `serviceTier.orElse(null)`. */
+            fun serviceTier(serviceTier: Optional<ServiceTier>) =
+                serviceTier(serviceTier.getOrNull())
+
+            /**
+             * Sets [Builder.serviceTier] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serviceTier] with a well-typed [ServiceTier] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun serviceTier(serviceTier: JsonField<ServiceTier>) = apply {
+                this.serviceTier = serviceTier
+            }
+
+            /** Whether to store the generated model response for later retrieval via API. */
+            fun store(store: Boolean?) = store(JsonField.ofNullable(store))
+
+            /**
+             * Alias for [Builder.store].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun store(store: Boolean) = store(store as Boolean?)
+
+            /** Alias for calling [Builder.store] with `store.orElse(null)`. */
+            fun store(store: Optional<Boolean>) = store(store.getOrNull())
+
+            /**
+             * Sets [Builder.store] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.store] with a well-typed [Boolean] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun store(store: JsonField<Boolean>) = apply { this.store = store }
+
+            /** Options for streaming responses. Only set this when you set `stream: true`. */
+            fun streamOptions(streamOptions: StreamOptions?) =
+                streamOptions(JsonField.ofNullable(streamOptions))
+
+            /** Alias for calling [Builder.streamOptions] with `streamOptions.orElse(null)`. */
+            fun streamOptions(streamOptions: Optional<StreamOptions>) =
+                streamOptions(streamOptions.getOrNull())
+
+            /**
+             * Sets [Builder.streamOptions] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.streamOptions] with a well-typed [StreamOptions]
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            fun streamOptions(streamOptions: JsonField<StreamOptions>) = apply {
+                this.streamOptions = streamOptions
+            }
+
+            /**
+             * What sampling temperature to use, between 0 and 2. Higher values like 0.8 will make
+             * the output more random, while lower values like 0.2 will make it more focused and
+             * deterministic. We generally recommend altering this or `top_p` but not both.
+             */
+            fun temperature(temperature: Double?) = temperature(JsonField.ofNullable(temperature))
+
+            /**
+             * Alias for [Builder.temperature].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun temperature(temperature: Double) = temperature(temperature as Double?)
+
+            /** Alias for calling [Builder.temperature] with `temperature.orElse(null)`. */
+            fun temperature(temperature: Optional<Double>) = temperature(temperature.getOrNull())
+
+            /**
+             * Sets [Builder.temperature] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.temperature] with a well-typed [Double] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun temperature(temperature: JsonField<Double>) = apply {
+                this.temperature = temperature
+            }
+
+            /**
+             * Configuration options for a text response from the model. Can be plain text or
+             * structured JSON data. Learn more:
+             * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+             * - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+             */
+            fun text(text: BetaResponseTextConfig) = text(JsonField.of(text))
+
+            /**
+             * Sets [Builder.text] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.text] with a well-typed [BetaResponseTextConfig]
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            fun text(text: JsonField<BetaResponseTextConfig>) = apply { this.text = text }
+
+            /**
+             * How the model should select which tool (or tools) to use when generating a response.
+             * See the `tools` parameter to see how to specify which tools the model can call.
+             */
+            fun toolChoice(toolChoice: ToolChoice) = toolChoice(JsonField.of(toolChoice))
+
+            /**
+             * Sets [Builder.toolChoice] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.toolChoice] with a well-typed [ToolChoice] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun toolChoice(toolChoice: JsonField<ToolChoice>) = apply {
+                this.toolChoice = toolChoice
+            }
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceOptions(betaToolChoiceOptions)`.
+             */
+            fun toolChoice(betaToolChoiceOptions: BetaToolChoiceOptions) =
+                toolChoice(ToolChoice.ofBetaToolChoiceOptions(betaToolChoiceOptions))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceAllowed(betaToolChoiceAllowed)`.
+             */
+            fun toolChoice(betaToolChoiceAllowed: BetaToolChoiceAllowed) =
+                toolChoice(ToolChoice.ofBetaToolChoiceAllowed(betaToolChoiceAllowed))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceTypes(betaToolChoiceTypes)`.
+             */
+            fun toolChoice(betaToolChoiceTypes: BetaToolChoiceTypes) =
+                toolChoice(ToolChoice.ofBetaToolChoiceTypes(betaToolChoiceTypes))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceFunction(betaToolChoiceFunction)`.
+             */
+            fun toolChoice(betaToolChoiceFunction: BetaToolChoiceFunction) =
+                toolChoice(ToolChoice.ofBetaToolChoiceFunction(betaToolChoiceFunction))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceMcp(betaToolChoiceMcp)`.
+             */
+            fun toolChoice(betaToolChoiceMcp: BetaToolChoiceMcp) =
+                toolChoice(ToolChoice.ofBetaToolChoiceMcp(betaToolChoiceMcp))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceCustom(betaToolChoiceCustom)`.
+             */
+            fun toolChoice(betaToolChoiceCustom: BetaToolChoiceCustom) =
+                toolChoice(ToolChoice.ofBetaToolChoiceCustom(betaToolChoiceCustom))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaSpecificProgrammaticToolCallingParam()`.
+             */
+            fun toolChoiceBetaSpecificProgrammaticToolCallingParam() =
+                toolChoice(ToolChoice.ofBetaSpecificProgrammaticToolCallingParam())
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch)`.
+             */
+            fun toolChoice(betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch) =
+                toolChoice(ToolChoice.ofBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceShell(betaToolChoiceShell)`.
+             */
+            fun toolChoice(betaToolChoiceShell: BetaToolChoiceShell) =
+                toolChoice(ToolChoice.ofBetaToolChoiceShell(betaToolChoiceShell))
+
+            /**
+             * An array of tools the model may call while generating a response. You can specify
+             * which tool to use by setting the `tool_choice` parameter.
+             *
+             * We support the following categories of tools:
+             * - **Built-in tools**: Tools that are provided by OpenAI that extend the model's
+             *   capabilities, like
+             *   [web search](https://platform.openai.com/docs/guides/tools-web-search) or
+             *   [file search](https://platform.openai.com/docs/guides/tools-file-search). Learn
+             *   more about [built-in tools](https://platform.openai.com/docs/guides/tools).
+             * - **MCP Tools**: Integrations with third-party systems via custom MCP servers or
+             *   predefined connectors such as Google Drive and SharePoint. Learn more about
+             *   [MCP Tools](https://platform.openai.com/docs/guides/tools-connectors-mcp).
+             * - **Function calls (custom tools)**: Functions that are defined by you, enabling the
+             *   model to call your own code with strongly typed arguments and outputs. Learn more
+             *   about [function calling](https://platform.openai.com/docs/guides/function-calling).
+             *   You can also use custom tools to call your own code.
+             */
+            fun tools(tools: List<BetaTool>) = tools(JsonField.of(tools))
+
+            /**
+             * Sets [Builder.tools] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.tools] with a well-typed `List<BetaTool>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun tools(tools: JsonField<List<BetaTool>>) = apply {
+                this.tools = tools.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [BetaTool] to [tools].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addTool(tool: BetaTool) = apply {
+                tools =
+                    (tools ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("tools", it).add(tool)
+                    }
+            }
+
+            /** Alias for calling [addTool] with `BetaTool.ofFunction(function)`. */
+            fun addTool(function: BetaFunctionTool) = addTool(BetaTool.ofFunction(function))
+
+            /** Alias for calling [addTool] with `BetaTool.ofFileSearch(fileSearch)`. */
+            fun addTool(fileSearch: BetaFileSearchTool) = addTool(BetaTool.ofFileSearch(fileSearch))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaFileSearchTool.builder()
+             *     .vectorStoreIds(vectorStoreIds)
+             *     .build()
+             * ```
+             */
+            fun addFileSearchTool(vectorStoreIds: List<String>) =
+                addTool(BetaFileSearchTool.builder().vectorStoreIds(vectorStoreIds).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofComputer(computer)`. */
+            fun addTool(computer: BetaComputerTool) = addTool(BetaTool.ofComputer(computer))
+
+            /**
+             * Alias for calling [addTool] with `BetaTool.ofComputerUsePreview(computerUsePreview)`.
+             */
+            fun addTool(computerUsePreview: BetaComputerUsePreviewTool) =
+                addTool(BetaTool.ofComputerUsePreview(computerUsePreview))
+
+            /** Alias for calling [addTool] with `BetaTool.ofWebSearch(webSearch)`. */
+            fun addTool(webSearch: BetaWebSearchTool) = addTool(BetaTool.ofWebSearch(webSearch))
+
+            /** Alias for calling [addTool] with `BetaTool.ofMcp(mcp)`. */
+            fun addTool(mcp: BetaTool.Mcp) = addTool(BetaTool.ofMcp(mcp))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaTool.Mcp.builder()
+             *     .serverLabel(serverLabel)
+             *     .build()
+             * ```
+             */
+            fun addMcpTool(serverLabel: String) =
+                addTool(BetaTool.Mcp.builder().serverLabel(serverLabel).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofCodeInterpreter(codeInterpreter)`. */
+            fun addTool(codeInterpreter: BetaTool.CodeInterpreter) =
+                addTool(BetaTool.ofCodeInterpreter(codeInterpreter))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaTool.CodeInterpreter.builder()
+             *     .container(container)
+             *     .build()
+             * ```
+             */
+            fun addCodeInterpreterTool(container: BetaTool.CodeInterpreter.Container) =
+                addTool(BetaTool.CodeInterpreter.builder().container(container).build())
+
+            /**
+             * Alias for calling [addCodeInterpreterTool] with
+             * `BetaTool.CodeInterpreter.Container.ofString(string)`.
+             */
+            fun addCodeInterpreterTool(string: String) =
+                addCodeInterpreterTool(BetaTool.CodeInterpreter.Container.ofString(string))
+
+            /**
+             * Alias for calling [addCodeInterpreterTool] with
+             * `BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)`.
+             */
+            fun addCodeInterpreterTool(
+                codeInterpreterToolAuto: BetaTool.CodeInterpreter.Container.CodeInterpreterToolAuto
+            ) =
+                addCodeInterpreterTool(
+                    BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(
+                        codeInterpreterToolAuto
+                    )
+                )
+
+            /** Alias for calling [addTool] with `BetaTool.ofProgrammaticToolCalling()`. */
+            fun addToolProgrammaticToolCalling() = addTool(BetaTool.ofProgrammaticToolCalling())
+
+            /** Alias for calling [addTool] with `BetaTool.ofImageGeneration(imageGeneration)`. */
+            fun addTool(imageGeneration: BetaTool.ImageGeneration) =
+                addTool(BetaTool.ofImageGeneration(imageGeneration))
+
+            /** Alias for calling [addTool] with `BetaTool.ofLocalShell()`. */
+            fun addToolLocalShell() = addTool(BetaTool.ofLocalShell())
+
+            /** Alias for calling [addTool] with `BetaTool.ofShell(shell)`. */
+            fun addTool(shell: BetaFunctionShellTool) = addTool(BetaTool.ofShell(shell))
+
+            /** Alias for calling [addTool] with `BetaTool.ofCustom(custom)`. */
+            fun addTool(custom: BetaCustomTool) = addTool(BetaTool.ofCustom(custom))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaCustomTool.builder()
+             *     .name(name)
+             *     .build()
+             * ```
+             */
+            fun addCustomTool(name: String) = addTool(BetaCustomTool.builder().name(name).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofNamespace(namespace)`. */
+            fun addTool(namespace: BetaNamespaceTool) = addTool(BetaTool.ofNamespace(namespace))
+
+            /** Alias for calling [addTool] with `BetaTool.ofToolSearch(toolSearch)`. */
+            fun addTool(toolSearch: BetaToolSearchTool) = addTool(BetaTool.ofToolSearch(toolSearch))
+
+            /** Alias for calling [addTool] with `BetaTool.ofWebSearchPreview(webSearchPreview)`. */
+            fun addTool(webSearchPreview: BetaWebSearchPreviewTool) =
+                addTool(BetaTool.ofWebSearchPreview(webSearchPreview))
+
+            /** Alias for calling [addTool] with `BetaTool.ofApplyPatch(applyPatch)`. */
+            fun addTool(applyPatch: BetaApplyPatchTool) = addTool(BetaTool.ofApplyPatch(applyPatch))
+
+            /**
+             * An integer between 0 and 20 specifying the maximum number of most likely tokens to
+             * return at each token position, each with an associated log probability. In some
+             * cases, the number of returned tokens may be fewer than requested.
+             */
+            fun topLogprobs(topLogprobs: Long?) = topLogprobs(JsonField.ofNullable(topLogprobs))
+
+            /**
+             * Alias for [Builder.topLogprobs].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun topLogprobs(topLogprobs: Long) = topLogprobs(topLogprobs as Long?)
+
+            /** Alias for calling [Builder.topLogprobs] with `topLogprobs.orElse(null)`. */
+            fun topLogprobs(topLogprobs: Optional<Long>) = topLogprobs(topLogprobs.getOrNull())
+
+            /**
+             * Sets [Builder.topLogprobs] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.topLogprobs] with a well-typed [Long] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun topLogprobs(topLogprobs: JsonField<Long>) = apply { this.topLogprobs = topLogprobs }
+
+            /**
+             * An alternative to sampling with temperature, called nucleus sampling, where the model
+             * considers the results of the tokens with top_p probability mass. So 0.1 means only
+             * the tokens comprising the top 10% probability mass are considered.
+             *
+             * We generally recommend altering this or `temperature` but not both.
+             */
+            fun topP(topP: Double?) = topP(JsonField.ofNullable(topP))
+
+            /**
+             * Alias for [Builder.topP].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun topP(topP: Double) = topP(topP as Double?)
+
+            /** Alias for calling [Builder.topP] with `topP.orElse(null)`. */
+            fun topP(topP: Optional<Double>) = topP(topP.getOrNull())
+
+            /**
+             * Sets [Builder.topP] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.topP] with a well-typed [Double] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun topP(topP: JsonField<Double>) = apply { this.topP = topP }
+
+            /**
+             * The truncation strategy to use for the model response.
+             * - `auto`: If the input to this Response exceeds the model's context window size, the
+             *   model will truncate the response to fit the context window by dropping items from
+             *   the beginning of the conversation.
+             * - `disabled` (default): If the input size will exceed the context window size for a
+             *   model, the request will fail with a 400 error.
+             */
+            @Deprecated("deprecated")
+            fun truncation(truncation: Truncation?) = truncation(JsonField.ofNullable(truncation))
+
+            /** Alias for calling [Builder.truncation] with `truncation.orElse(null)`. */
+            @Deprecated("deprecated")
+            fun truncation(truncation: Optional<Truncation>) = truncation(truncation.getOrNull())
+
+            /**
+             * Sets [Builder.truncation] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.truncation] with a well-typed [Truncation] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            @Deprecated("deprecated")
+            fun truncation(truncation: JsonField<Truncation>) = apply {
+                this.truncation = truncation
+            }
+
+            /**
+             * This field is being replaced by `safety_identifier` and `prompt_cache_key`. Use
+             * `prompt_cache_key` instead to maintain caching optimizations. 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#safety-identifiers).
+             */
+            @Deprecated("deprecated") fun user(user: String) = user(JsonField.of(user))
+
+            /**
+             * Sets [Builder.user] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.user] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            @Deprecated("deprecated") fun user(user: JsonField<String>) = apply { this.user = user }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Body =
+                Body(
+                    background,
+                    (contextManagement ?: JsonMissing.of()).map { it.toImmutable() },
+                    conversation,
+                    (include ?: JsonMissing.of()).map { it.toImmutable() },
+                    input,
+                    instructions,
+                    maxOutputTokens,
+                    maxToolCalls,
+                    metadata,
+                    model,
+                    moderation,
+                    multiAgent,
+                    parallelToolCalls,
+                    previousResponseId,
+                    prompt,
+                    promptCacheKey,
+                    promptCacheOptions,
+                    promptCacheRetention,
+                    reasoning,
+                    safetyIdentifier,
+                    serviceTier,
+                    store,
+                    streamOptions,
+                    temperature,
+                    text,
+                    toolChoice,
+                    (tools ?: JsonMissing.of()).map { it.toImmutable() },
+                    topLogprobs,
+                    topP,
+                    truncation,
+                    user,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            background()
+            contextManagement().ifPresent { it.forEach { it.validate() } }
+            conversation().ifPresent { it.validate() }
+            include().ifPresent { it.forEach { it.validate() } }
+            input().ifPresent { it.validate() }
+            instructions()
+            maxOutputTokens()
+            maxToolCalls()
+            metadata().ifPresent { it.validate() }
+            model()
+            moderation().ifPresent { it.validate() }
+            multiAgent().ifPresent { it.validate() }
+            parallelToolCalls()
+            previousResponseId()
+            prompt().ifPresent { it.validate() }
+            promptCacheKey()
+            promptCacheOptions().ifPresent { it.validate() }
+            promptCacheRetention().ifPresent { it.validate() }
+            reasoning().ifPresent { it.validate() }
+            safetyIdentifier()
+            serviceTier().ifPresent { it.validate() }
+            store()
+            streamOptions().ifPresent { it.validate() }
+            temperature()
+            text().ifPresent { it.validate() }
+            toolChoice().ifPresent { it.validate() }
+            tools().ifPresent { it.forEach { it.validate() } }
+            topLogprobs()
+            topP()
+            truncation().ifPresent { it.validate() }
+            user()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (background.asKnown().isPresent) 1 else 0) +
+                (contextManagement.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (conversation.asKnown().getOrNull()?.validity() ?: 0) +
+                (include.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (input.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (instructions.asKnown().isPresent) 1 else 0) +
+                (if (maxOutputTokens.asKnown().isPresent) 1 else 0) +
+                (if (maxToolCalls.asKnown().isPresent) 1 else 0) +
+                (metadata.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (model.asKnown().isPresent) 1 else 0) +
+                (moderation.asKnown().getOrNull()?.validity() ?: 0) +
+                (multiAgent.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (parallelToolCalls.asKnown().isPresent) 1 else 0) +
+                (if (previousResponseId.asKnown().isPresent) 1 else 0) +
+                (prompt.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (promptCacheKey.asKnown().isPresent) 1 else 0) +
+                (promptCacheOptions.asKnown().getOrNull()?.validity() ?: 0) +
+                (promptCacheRetention.asKnown().getOrNull()?.validity() ?: 0) +
+                (reasoning.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (safetyIdentifier.asKnown().isPresent) 1 else 0) +
+                (serviceTier.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (store.asKnown().isPresent) 1 else 0) +
+                (streamOptions.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (temperature.asKnown().isPresent) 1 else 0) +
+                (text.asKnown().getOrNull()?.validity() ?: 0) +
+                (toolChoice.asKnown().getOrNull()?.validity() ?: 0) +
+                (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (if (topLogprobs.asKnown().isPresent) 1 else 0) +
+                (if (topP.asKnown().isPresent) 1 else 0) +
+                (truncation.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (user.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                background == other.background &&
+                contextManagement == other.contextManagement &&
+                conversation == other.conversation &&
+                include == other.include &&
+                input == other.input &&
+                instructions == other.instructions &&
+                maxOutputTokens == other.maxOutputTokens &&
+                maxToolCalls == other.maxToolCalls &&
+                metadata == other.metadata &&
+                model == other.model &&
+                moderation == other.moderation &&
+                multiAgent == other.multiAgent &&
+                parallelToolCalls == other.parallelToolCalls &&
+                previousResponseId == other.previousResponseId &&
+                prompt == other.prompt &&
+                promptCacheKey == other.promptCacheKey &&
+                promptCacheOptions == other.promptCacheOptions &&
+                promptCacheRetention == other.promptCacheRetention &&
+                reasoning == other.reasoning &&
+                safetyIdentifier == other.safetyIdentifier &&
+                serviceTier == other.serviceTier &&
+                store == other.store &&
+                streamOptions == other.streamOptions &&
+                temperature == other.temperature &&
+                text == other.text &&
+                toolChoice == other.toolChoice &&
+                tools == other.tools &&
+                topLogprobs == other.topLogprobs &&
+                topP == other.topP &&
+                truncation == other.truncation &&
+                user == other.user &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                background,
+                contextManagement,
+                conversation,
+                include,
+                input,
+                instructions,
+                maxOutputTokens,
+                maxToolCalls,
+                metadata,
+                model,
+                moderation,
+                multiAgent,
+                parallelToolCalls,
+                previousResponseId,
+                prompt,
+                promptCacheKey,
+                promptCacheOptions,
+                promptCacheRetention,
+                reasoning,
+                safetyIdentifier,
+                serviceTier,
+                store,
+                streamOptions,
+                temperature,
+                text,
+                toolChoice,
+                tools,
+                topLogprobs,
+                topP,
+                truncation,
+                user,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Body{background=$background, contextManagement=$contextManagement, conversation=$conversation, include=$include, input=$input, instructions=$instructions, maxOutputTokens=$maxOutputTokens, maxToolCalls=$maxToolCalls, metadata=$metadata, model=$model, moderation=$moderation, multiAgent=$multiAgent, parallelToolCalls=$parallelToolCalls, previousResponseId=$previousResponseId, prompt=$prompt, promptCacheKey=$promptCacheKey, promptCacheOptions=$promptCacheOptions, promptCacheRetention=$promptCacheRetention, reasoning=$reasoning, safetyIdentifier=$safetyIdentifier, serviceTier=$serviceTier, store=$store, streamOptions=$streamOptions, temperature=$temperature, text=$text, toolChoice=$toolChoice, tools=$tools, topLogprobs=$topLogprobs, topP=$topP, truncation=$truncation, user=$user, additionalProperties=$additionalProperties}"
+    }
+
+    class ContextManagement
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val type: JsonField<String>,
+        private val compactThreshold: JsonField<Long>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("type") @ExcludeMissing type: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("compact_threshold")
+            @ExcludeMissing
+            compactThreshold: JsonField<Long> = JsonMissing.of(),
+        ) : this(type, compactThreshold, mutableMapOf())
+
+        /**
+         * The context management entry type. Currently only 'compaction' is supported.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun type(): String = type.getRequired("type")
+
+        /**
+         * Token threshold at which compaction should be triggered for this entry.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun compactThreshold(): Optional<Long> = compactThreshold.getOptional("compact_threshold")
+
+        /**
+         * Returns the raw JSON value of [type].
+         *
+         * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<String> = type
+
+        /**
+         * Returns the raw JSON value of [compactThreshold].
+         *
+         * Unlike [compactThreshold], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("compact_threshold")
+        @ExcludeMissing
+        fun _compactThreshold(): JsonField<Long> = compactThreshold
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ContextManagement].
+             *
+             * The following fields are required:
+             * ```java
+             * .type()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ContextManagement]. */
+        class Builder internal constructor() {
+
+            private var type: JsonField<String>? = null
+            private var compactThreshold: JsonField<Long> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(contextManagement: ContextManagement) = apply {
+                type = contextManagement.type
+                compactThreshold = contextManagement.compactThreshold
+                additionalProperties = contextManagement.additionalProperties.toMutableMap()
+            }
+
+            /** The context management entry type. Currently only 'compaction' is supported. */
+            fun type(type: String) = type(JsonField.of(type))
+
+            /**
+             * Sets [Builder.type] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.type] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun type(type: JsonField<String>) = apply { this.type = type }
+
+            /** Token threshold at which compaction should be triggered for this entry. */
+            fun compactThreshold(compactThreshold: Long?) =
+                compactThreshold(JsonField.ofNullable(compactThreshold))
+
+            /**
+             * Alias for [Builder.compactThreshold].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun compactThreshold(compactThreshold: Long) =
+                compactThreshold(compactThreshold as Long?)
+
+            /**
+             * Alias for calling [Builder.compactThreshold] with `compactThreshold.orElse(null)`.
+             */
+            fun compactThreshold(compactThreshold: Optional<Long>) =
+                compactThreshold(compactThreshold.getOrNull())
+
+            /**
+             * Sets [Builder.compactThreshold] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.compactThreshold] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun compactThreshold(compactThreshold: JsonField<Long>) = apply {
+                this.compactThreshold = compactThreshold
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ContextManagement].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .type()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ContextManagement =
+                ContextManagement(
+                    checkRequired("type", type),
+                    compactThreshold,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ContextManagement = apply {
+            if (validated) {
+                return@apply
+            }
+
+            type()
+            compactThreshold()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (type.asKnown().isPresent) 1 else 0) +
+                (if (compactThreshold.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ContextManagement &&
+                type == other.type &&
+                compactThreshold == other.compactThreshold &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(type, compactThreshold, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ContextManagement{type=$type, compactThreshold=$compactThreshold, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * The conversation that this response belongs to. Items from this conversation are prepended to
+     * `input_items` for this response request. Input items and output items from this response are
+     * automatically added to this conversation after this response completes.
+     */
+    @JsonDeserialize(using = Conversation.Deserializer::class)
+    @JsonSerialize(using = Conversation.Serializer::class)
+    class Conversation
+    private constructor(
+        private val id: String? = null,
+        private val betaResponseConversationParam: BetaResponseConversationParam? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** The unique ID of the conversation. */
+        fun id(): Optional<String> = Optional.ofNullable(id)
+
+        /** The conversation that this response belongs to. */
+        fun betaResponseConversationParam(): Optional<BetaResponseConversationParam> =
+            Optional.ofNullable(betaResponseConversationParam)
+
+        fun isId(): Boolean = id != null
+
+        fun isBetaResponseConversationParam(): Boolean = betaResponseConversationParam != null
+
+        /** The unique ID of the conversation. */
+        fun asId(): String = id.getOrThrow("id")
+
+        /** The conversation that this response belongs to. */
+        fun asBetaResponseConversationParam(): BetaResponseConversationParam =
+            betaResponseConversationParam.getOrThrow("betaResponseConversationParam")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = conversation.accept(new Conversation.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitId(String id) {
+         *         return Optional.of(id.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                id != null -> visitor.visitId(id)
+                betaResponseConversationParam != null ->
+                    visitor.visitBetaResponseConversationParam(betaResponseConversationParam)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Conversation = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitId(id: String) {}
+
+                    override fun visitBetaResponseConversationParam(
+                        betaResponseConversationParam: BetaResponseConversationParam
+                    ) {
+                        betaResponseConversationParam.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitId(id: String) = 1
+
+                    override fun visitBetaResponseConversationParam(
+                        betaResponseConversationParam: BetaResponseConversationParam
+                    ) = betaResponseConversationParam.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Conversation &&
+                id == other.id &&
+                betaResponseConversationParam == other.betaResponseConversationParam
+        }
+
+        override fun hashCode(): Int = Objects.hash(id, betaResponseConversationParam)
+
+        override fun toString(): String =
+            when {
+                id != null -> "Conversation{id=$id}"
+                betaResponseConversationParam != null ->
+                    "Conversation{betaResponseConversationParam=$betaResponseConversationParam}"
+                _json != null -> "Conversation{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Conversation")
+            }
+
+        companion object {
+
+            /** The unique ID of the conversation. */
+            @JvmStatic fun ofId(id: String) = Conversation(id = id)
+
+            /** The conversation that this response belongs to. */
+            @JvmStatic
+            fun ofBetaResponseConversationParam(
+                betaResponseConversationParam: BetaResponseConversationParam
+            ) = Conversation(betaResponseConversationParam = betaResponseConversationParam)
+        }
+
+        /**
+         * An interface that defines how to map each variant of [Conversation] to a value of type
+         * [T].
+         */
+        interface Visitor<out T> {
+
+            /** The unique ID of the conversation. */
+            fun visitId(id: String): T
+
+            /** The conversation that this response belongs to. */
+            fun visitBetaResponseConversationParam(
+                betaResponseConversationParam: BetaResponseConversationParam
+            ): T
+
+            /**
+             * Maps an unknown variant of [Conversation] to a value of type [T].
+             *
+             * An instance of [Conversation] can contain an unknown variant if it was deserialized
+             * from data that doesn't match any known variant. For example, if the SDK is on an
+             * older version than the API, then the API may respond with new variants that the SDK
+             * is unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Conversation: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Conversation>(Conversation::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Conversation {
+                val json = JsonValue.fromJsonNode(node)
+
+                val bestMatches =
+                    sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<BetaResponseConversationParam>())
+                                ?.let {
+                                    Conversation(betaResponseConversationParam = it, _json = json)
+                                },
+                            tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                Conversation(id = it, _json = json)
+                            },
+                        )
+                        .filterNotNull()
+                        .allMaxBy { it.validity() }
+                        .toList()
+                return when (bestMatches.size) {
+                    // This can happen if what we're deserializing is completely incompatible with
+                    // all the possible variants (e.g. deserializing from boolean).
+                    0 -> Conversation(_json = json)
+                    1 -> bestMatches.single()
+                    // If there's more than one match with the highest validity, then use the first
+                    // completely valid match, or simply the first match if none are completely
+                    // valid.
+                    else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                }
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Conversation>(Conversation::class) {
+
+            override fun serialize(
+                value: Conversation,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.id != null -> generator.writeObject(value.id)
+                    value.betaResponseConversationParam != null ->
+                        generator.writeObject(value.betaResponseConversationParam)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Conversation")
+                }
+            }
+        }
+    }
+
+    /**
+     * Text, image, or file inputs to the model, used to generate a response.
+     *
+     * Learn more:
+     * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+     * - [Image inputs](https://platform.openai.com/docs/guides/images)
+     * - [File inputs](https://platform.openai.com/docs/guides/pdf-files)
+     * - [Conversation state](https://platform.openai.com/docs/guides/conversation-state)
+     * - [Function calling](https://platform.openai.com/docs/guides/function-calling)
+     */
+    @JsonDeserialize(using = Input.Deserializer::class)
+    @JsonSerialize(using = Input.Serializer::class)
+    class Input
+    private constructor(
+        private val text: String? = null,
+        private val betaResponse: List<BetaResponseInputItem>? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** A text input to the model, equivalent to a text input with the `user` role. */
+        fun text(): Optional<String> = Optional.ofNullable(text)
+
+        /** A list of one or many input items to the model, containing different content types. */
+        fun betaResponse(): Optional<List<BetaResponseInputItem>> =
+            Optional.ofNullable(betaResponse)
+
+        fun isText(): Boolean = text != null
+
+        fun isBetaResponse(): Boolean = betaResponse != null
+
+        /** A text input to the model, equivalent to a text input with the `user` role. */
+        fun asText(): String = text.getOrThrow("text")
+
+        /** A list of one or many input items to the model, containing different content types. */
+        fun asBetaResponse(): List<BetaResponseInputItem> = betaResponse.getOrThrow("betaResponse")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = input.accept(new Input.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitText(String text) {
+         *         return Optional.of(text.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                text != null -> visitor.visitText(text)
+                betaResponse != null -> visitor.visitBetaResponse(betaResponse)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Input = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitText(text: String) {}
+
+                    override fun visitBetaResponse(betaResponse: List<BetaResponseInputItem>) {
+                        betaResponse.forEach { it.validate() }
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitText(text: String) = 1
+
+                    override fun visitBetaResponse(betaResponse: List<BetaResponseInputItem>) =
+                        betaResponse.sumOf { it.validity().toInt() }
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Input && text == other.text && betaResponse == other.betaResponse
+        }
+
+        override fun hashCode(): Int = Objects.hash(text, betaResponse)
+
+        override fun toString(): String =
+            when {
+                text != null -> "Input{text=$text}"
+                betaResponse != null -> "Input{betaResponse=$betaResponse}"
+                _json != null -> "Input{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Input")
+            }
+
+        companion object {
+
+            /** A text input to the model, equivalent to a text input with the `user` role. */
+            @JvmStatic fun ofText(text: String) = Input(text = text)
+
+            /**
+             * A list of one or many input items to the model, containing different content types.
+             */
+            @JvmStatic
+            fun ofBetaResponse(betaResponse: List<BetaResponseInputItem>) =
+                Input(betaResponse = betaResponse.toImmutable())
+        }
+
+        /** An interface that defines how to map each variant of [Input] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            /** A text input to the model, equivalent to a text input with the `user` role. */
+            fun visitText(text: String): T
+
+            /**
+             * A list of one or many input items to the model, containing different content types.
+             */
+            fun visitBetaResponse(betaResponse: List<BetaResponseInputItem>): T
+
+            /**
+             * Maps an unknown variant of [Input] to a value of type [T].
+             *
+             * An instance of [Input] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Input: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Input>(Input::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Input {
+                val json = JsonValue.fromJsonNode(node)
+
+                val bestMatches =
+                    sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                Input(text = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<List<BetaResponseInputItem>>())
+                                ?.let { Input(betaResponse = it, _json = json) },
+                        )
+                        .filterNotNull()
+                        .allMaxBy { it.validity() }
+                        .toList()
+                return when (bestMatches.size) {
+                    // This can happen if what we're deserializing is completely incompatible with
+                    // all the possible variants (e.g. deserializing from boolean).
+                    0 -> Input(_json = json)
+                    1 -> bestMatches.single()
+                    // If there's more than one match with the highest validity, then use the first
+                    // completely valid match, or simply the first match if none are completely
+                    // valid.
+                    else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                }
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Input>(Input::class) {
+
+            override fun serialize(
+                value: Input,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.text != null -> generator.writeObject(value.text)
+                    value.betaResponse != null -> generator.writeObject(value.betaResponse)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Input")
+                }
+            }
+        }
+    }
+
+    /**
+     * Set of 16 key-value pairs that can be attached to an object. This can be useful for storing
+     * additional information about the object in a structured format, and querying for objects via
+     * API or the dashboard.
+     *
+     * Keys are strings with a maximum length of 64 characters. Values are strings with a maximum
+     * length of 512 characters.
+     */
+    class Metadata
+    @JsonCreator
+    private constructor(
+        @com.fasterxml.jackson.annotation.JsonValue
+        private val additionalProperties: Map<String, JsonValue>
+    ) {
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Metadata]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Metadata]. */
+        class Builder internal constructor() {
+
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(metadata: Metadata) = apply {
+                additionalProperties = metadata.additionalProperties.toMutableMap()
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Metadata].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Metadata = Metadata(additionalProperties.toImmutable())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Metadata = apply {
+            if (validated) {
+                return@apply
+            }
+
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            additionalProperties.count { (_, value) -> !value.isNull() && !value.isMissing() }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Metadata && additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() = "Metadata{additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide range of
+     * models with different capabilities, performance characteristics, and price points. Refer to
+     * the [model guide](https://platform.openai.com/docs/models) to browse and compare available
+     * models.
+     */
+    class Model @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val GPT_5_6_SOL = of("gpt-5.6-sol")
+
+            @JvmField val GPT_5_6_TERRA = of("gpt-5.6-terra")
+
+            @JvmField val GPT_5_6_LUNA = of("gpt-5.6-luna")
+
+            @JvmField val GPT_5_4 = of("gpt-5.4")
+
+            @JvmField val GPT_5_4_MINI = of("gpt-5.4-mini")
+
+            @JvmField val GPT_5_4_NANO = of("gpt-5.4-nano")
+
+            @JvmField val GPT_5_4_MINI_2026_03_17 = of("gpt-5.4-mini-2026-03-17")
+
+            @JvmField val GPT_5_4_NANO_2026_03_17 = of("gpt-5.4-nano-2026-03-17")
+
+            @JvmField val GPT_5_3_CHAT_LATEST = of("gpt-5.3-chat-latest")
+
+            @JvmField val GPT_5_2 = of("gpt-5.2")
+
+            @JvmField val GPT_5_2_2025_12_11 = of("gpt-5.2-2025-12-11")
+
+            @JvmField val GPT_5_2_CHAT_LATEST = of("gpt-5.2-chat-latest")
+
+            @JvmField val GPT_5_2_PRO = of("gpt-5.2-pro")
+
+            @JvmField val GPT_5_2_PRO_2025_12_11 = of("gpt-5.2-pro-2025-12-11")
+
+            @JvmField val GPT_5_1 = of("gpt-5.1")
+
+            @JvmField val GPT_5_1_2025_11_13 = of("gpt-5.1-2025-11-13")
+
+            @JvmField val GPT_5_1_CODEX = of("gpt-5.1-codex")
+
+            @JvmField val GPT_5_1_MINI = of("gpt-5.1-mini")
+
+            @JvmField val GPT_5_1_CHAT_LATEST = of("gpt-5.1-chat-latest")
+
+            @JvmField val GPT_5 = of("gpt-5")
+
+            @JvmField val GPT_5_MINI = of("gpt-5-mini")
+
+            @JvmField val GPT_5_NANO = of("gpt-5-nano")
+
+            @JvmField val GPT_5_2025_08_07 = of("gpt-5-2025-08-07")
+
+            @JvmField val GPT_5_MINI_2025_08_07 = of("gpt-5-mini-2025-08-07")
+
+            @JvmField val GPT_5_NANO_2025_08_07 = of("gpt-5-nano-2025-08-07")
+
+            @JvmField val GPT_5_CHAT_LATEST = of("gpt-5-chat-latest")
+
+            @JvmField val GPT_4_1 = of("gpt-4.1")
+
+            @JvmField val GPT_4_1_MINI = of("gpt-4.1-mini")
+
+            @JvmField val GPT_4_1_NANO = of("gpt-4.1-nano")
+
+            @JvmField val GPT_4_1_2025_04_14 = of("gpt-4.1-2025-04-14")
+
+            @JvmField val GPT_4_1_MINI_2025_04_14 = of("gpt-4.1-mini-2025-04-14")
+
+            @JvmField val GPT_4_1_NANO_2025_04_14 = of("gpt-4.1-nano-2025-04-14")
+
+            @JvmField val O4_MINI = of("o4-mini")
+
+            @JvmField val O4_MINI_2025_04_16 = of("o4-mini-2025-04-16")
+
+            @JvmField val O3 = of("o3")
+
+            @JvmField val O3_2025_04_16 = of("o3-2025-04-16")
+
+            @JvmField val O3_MINI = of("o3-mini")
+
+            @JvmField val O3_MINI_2025_01_31 = of("o3-mini-2025-01-31")
+
+            @JvmField val O1 = of("o1")
+
+            @JvmField val O1_2024_12_17 = of("o1-2024-12-17")
+
+            @JvmField val O1_PREVIEW = of("o1-preview")
+
+            @JvmField val O1_PREVIEW_2024_09_12 = of("o1-preview-2024-09-12")
+
+            @JvmField val O1_MINI = of("o1-mini")
+
+            @JvmField val O1_MINI_2024_09_12 = of("o1-mini-2024-09-12")
+
+            @JvmField val GPT_4O = of("gpt-4o")
+
+            @JvmField val GPT_4O_2024_11_20 = of("gpt-4o-2024-11-20")
+
+            @JvmField val GPT_4O_2024_08_06 = of("gpt-4o-2024-08-06")
+
+            @JvmField val GPT_4O_2024_05_13 = of("gpt-4o-2024-05-13")
+
+            @JvmField val GPT_4O_AUDIO_PREVIEW = of("gpt-4o-audio-preview")
+
+            @JvmField val GPT_4O_AUDIO_PREVIEW_2024_10_01 = of("gpt-4o-audio-preview-2024-10-01")
+
+            @JvmField val GPT_4O_AUDIO_PREVIEW_2024_12_17 = of("gpt-4o-audio-preview-2024-12-17")
+
+            @JvmField val GPT_4O_AUDIO_PREVIEW_2025_06_03 = of("gpt-4o-audio-preview-2025-06-03")
+
+            @JvmField val GPT_4O_MINI_AUDIO_PREVIEW = of("gpt-4o-mini-audio-preview")
+
+            @JvmField
+            val GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17 = of("gpt-4o-mini-audio-preview-2024-12-17")
+
+            @JvmField val GPT_4O_SEARCH_PREVIEW = of("gpt-4o-search-preview")
+
+            @JvmField val GPT_4O_MINI_SEARCH_PREVIEW = of("gpt-4o-mini-search-preview")
+
+            @JvmField val GPT_4O_SEARCH_PREVIEW_2025_03_11 = of("gpt-4o-search-preview-2025-03-11")
+
+            @JvmField
+            val GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11 = of("gpt-4o-mini-search-preview-2025-03-11")
+
+            @JvmField val CHATGPT_4O_LATEST = of("chatgpt-4o-latest")
+
+            @JvmField val CODEX_MINI_LATEST = of("codex-mini-latest")
+
+            @JvmField val GPT_4O_MINI = of("gpt-4o-mini")
+
+            @JvmField val GPT_4O_MINI_2024_07_18 = of("gpt-4o-mini-2024-07-18")
+
+            @JvmField val GPT_4_TURBO = of("gpt-4-turbo")
+
+            @JvmField val GPT_4_TURBO_2024_04_09 = of("gpt-4-turbo-2024-04-09")
+
+            @JvmField val GPT_4_0125_PREVIEW = of("gpt-4-0125-preview")
+
+            @JvmField val GPT_4_TURBO_PREVIEW = of("gpt-4-turbo-preview")
+
+            @JvmField val GPT_4_1106_PREVIEW = of("gpt-4-1106-preview")
+
+            @JvmField val GPT_4_VISION_PREVIEW = of("gpt-4-vision-preview")
+
+            @JvmField val GPT_4 = of("gpt-4")
+
+            @JvmField val GPT_4_0314 = of("gpt-4-0314")
+
+            @JvmField val GPT_4_0613 = of("gpt-4-0613")
+
+            @JvmField val GPT_4_32K = of("gpt-4-32k")
+
+            @JvmField val GPT_4_32K_0314 = of("gpt-4-32k-0314")
+
+            @JvmField val GPT_4_32K_0613 = of("gpt-4-32k-0613")
+
+            @JvmField val GPT_3_5_TURBO = of("gpt-3.5-turbo")
+
+            @JvmField val GPT_3_5_TURBO_16K = of("gpt-3.5-turbo-16k")
+
+            @JvmField val GPT_3_5_TURBO_0301 = of("gpt-3.5-turbo-0301")
+
+            @JvmField val GPT_3_5_TURBO_0613 = of("gpt-3.5-turbo-0613")
+
+            @JvmField val GPT_3_5_TURBO_1106 = of("gpt-3.5-turbo-1106")
+
+            @JvmField val GPT_3_5_TURBO_0125 = of("gpt-3.5-turbo-0125")
+
+            @JvmField val GPT_3_5_TURBO_16K_0613 = of("gpt-3.5-turbo-16k-0613")
+
+            @JvmField val O1_PRO = of("o1-pro")
+
+            @JvmField val O1_PRO_2025_03_19 = of("o1-pro-2025-03-19")
+
+            @JvmField val O3_PRO = of("o3-pro")
+
+            @JvmField val O3_PRO_2025_06_10 = of("o3-pro-2025-06-10")
+
+            @JvmField val O3_DEEP_RESEARCH = of("o3-deep-research")
+
+            @JvmField val O3_DEEP_RESEARCH_2025_06_26 = of("o3-deep-research-2025-06-26")
+
+            @JvmField val O4_MINI_DEEP_RESEARCH = of("o4-mini-deep-research")
+
+            @JvmField val O4_MINI_DEEP_RESEARCH_2025_06_26 = of("o4-mini-deep-research-2025-06-26")
+
+            @JvmField val COMPUTER_USE_PREVIEW = of("computer-use-preview")
+
+            @JvmField val COMPUTER_USE_PREVIEW_2025_03_11 = of("computer-use-preview-2025-03-11")
+
+            @JvmField val GPT_5_CODEX = of("gpt-5-codex")
+
+            @JvmField val GPT_5_PRO = of("gpt-5-pro")
+
+            @JvmField val GPT_5_PRO_2025_10_06 = of("gpt-5-pro-2025-10-06")
+
+            @JvmField val GPT_5_1_CODEX_MAX = of("gpt-5.1-codex-max")
+
+            @JvmStatic fun of(value: String) = Model(JsonField.of(value))
+        }
+
+        /** An enum containing [Model]'s known values. */
+        enum class Known {
+            GPT_5_6_SOL,
+            GPT_5_6_TERRA,
+            GPT_5_6_LUNA,
+            GPT_5_4,
+            GPT_5_4_MINI,
+            GPT_5_4_NANO,
+            GPT_5_4_MINI_2026_03_17,
+            GPT_5_4_NANO_2026_03_17,
+            GPT_5_3_CHAT_LATEST,
+            GPT_5_2,
+            GPT_5_2_2025_12_11,
+            GPT_5_2_CHAT_LATEST,
+            GPT_5_2_PRO,
+            GPT_5_2_PRO_2025_12_11,
+            GPT_5_1,
+            GPT_5_1_2025_11_13,
+            GPT_5_1_CODEX,
+            GPT_5_1_MINI,
+            GPT_5_1_CHAT_LATEST,
+            GPT_5,
+            GPT_5_MINI,
+            GPT_5_NANO,
+            GPT_5_2025_08_07,
+            GPT_5_MINI_2025_08_07,
+            GPT_5_NANO_2025_08_07,
+            GPT_5_CHAT_LATEST,
+            GPT_4_1,
+            GPT_4_1_MINI,
+            GPT_4_1_NANO,
+            GPT_4_1_2025_04_14,
+            GPT_4_1_MINI_2025_04_14,
+            GPT_4_1_NANO_2025_04_14,
+            O4_MINI,
+            O4_MINI_2025_04_16,
+            O3,
+            O3_2025_04_16,
+            O3_MINI,
+            O3_MINI_2025_01_31,
+            O1,
+            O1_2024_12_17,
+            O1_PREVIEW,
+            O1_PREVIEW_2024_09_12,
+            O1_MINI,
+            O1_MINI_2024_09_12,
+            GPT_4O,
+            GPT_4O_2024_11_20,
+            GPT_4O_2024_08_06,
+            GPT_4O_2024_05_13,
+            GPT_4O_AUDIO_PREVIEW,
+            GPT_4O_AUDIO_PREVIEW_2024_10_01,
+            GPT_4O_AUDIO_PREVIEW_2024_12_17,
+            GPT_4O_AUDIO_PREVIEW_2025_06_03,
+            GPT_4O_MINI_AUDIO_PREVIEW,
+            GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17,
+            GPT_4O_SEARCH_PREVIEW,
+            GPT_4O_MINI_SEARCH_PREVIEW,
+            GPT_4O_SEARCH_PREVIEW_2025_03_11,
+            GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11,
+            CHATGPT_4O_LATEST,
+            CODEX_MINI_LATEST,
+            GPT_4O_MINI,
+            GPT_4O_MINI_2024_07_18,
+            GPT_4_TURBO,
+            GPT_4_TURBO_2024_04_09,
+            GPT_4_0125_PREVIEW,
+            GPT_4_TURBO_PREVIEW,
+            GPT_4_1106_PREVIEW,
+            GPT_4_VISION_PREVIEW,
+            GPT_4,
+            GPT_4_0314,
+            GPT_4_0613,
+            GPT_4_32K,
+            GPT_4_32K_0314,
+            GPT_4_32K_0613,
+            GPT_3_5_TURBO,
+            GPT_3_5_TURBO_16K,
+            GPT_3_5_TURBO_0301,
+            GPT_3_5_TURBO_0613,
+            GPT_3_5_TURBO_1106,
+            GPT_3_5_TURBO_0125,
+            GPT_3_5_TURBO_16K_0613,
+            O1_PRO,
+            O1_PRO_2025_03_19,
+            O3_PRO,
+            O3_PRO_2025_06_10,
+            O3_DEEP_RESEARCH,
+            O3_DEEP_RESEARCH_2025_06_26,
+            O4_MINI_DEEP_RESEARCH,
+            O4_MINI_DEEP_RESEARCH_2025_06_26,
+            COMPUTER_USE_PREVIEW,
+            COMPUTER_USE_PREVIEW_2025_03_11,
+            GPT_5_CODEX,
+            GPT_5_PRO,
+            GPT_5_PRO_2025_10_06,
+            GPT_5_1_CODEX_MAX,
+        }
+
+        /**
+         * An enum containing [Model]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Model] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            GPT_5_6_SOL,
+            GPT_5_6_TERRA,
+            GPT_5_6_LUNA,
+            GPT_5_4,
+            GPT_5_4_MINI,
+            GPT_5_4_NANO,
+            GPT_5_4_MINI_2026_03_17,
+            GPT_5_4_NANO_2026_03_17,
+            GPT_5_3_CHAT_LATEST,
+            GPT_5_2,
+            GPT_5_2_2025_12_11,
+            GPT_5_2_CHAT_LATEST,
+            GPT_5_2_PRO,
+            GPT_5_2_PRO_2025_12_11,
+            GPT_5_1,
+            GPT_5_1_2025_11_13,
+            GPT_5_1_CODEX,
+            GPT_5_1_MINI,
+            GPT_5_1_CHAT_LATEST,
+            GPT_5,
+            GPT_5_MINI,
+            GPT_5_NANO,
+            GPT_5_2025_08_07,
+            GPT_5_MINI_2025_08_07,
+            GPT_5_NANO_2025_08_07,
+            GPT_5_CHAT_LATEST,
+            GPT_4_1,
+            GPT_4_1_MINI,
+            GPT_4_1_NANO,
+            GPT_4_1_2025_04_14,
+            GPT_4_1_MINI_2025_04_14,
+            GPT_4_1_NANO_2025_04_14,
+            O4_MINI,
+            O4_MINI_2025_04_16,
+            O3,
+            O3_2025_04_16,
+            O3_MINI,
+            O3_MINI_2025_01_31,
+            O1,
+            O1_2024_12_17,
+            O1_PREVIEW,
+            O1_PREVIEW_2024_09_12,
+            O1_MINI,
+            O1_MINI_2024_09_12,
+            GPT_4O,
+            GPT_4O_2024_11_20,
+            GPT_4O_2024_08_06,
+            GPT_4O_2024_05_13,
+            GPT_4O_AUDIO_PREVIEW,
+            GPT_4O_AUDIO_PREVIEW_2024_10_01,
+            GPT_4O_AUDIO_PREVIEW_2024_12_17,
+            GPT_4O_AUDIO_PREVIEW_2025_06_03,
+            GPT_4O_MINI_AUDIO_PREVIEW,
+            GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17,
+            GPT_4O_SEARCH_PREVIEW,
+            GPT_4O_MINI_SEARCH_PREVIEW,
+            GPT_4O_SEARCH_PREVIEW_2025_03_11,
+            GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11,
+            CHATGPT_4O_LATEST,
+            CODEX_MINI_LATEST,
+            GPT_4O_MINI,
+            GPT_4O_MINI_2024_07_18,
+            GPT_4_TURBO,
+            GPT_4_TURBO_2024_04_09,
+            GPT_4_0125_PREVIEW,
+            GPT_4_TURBO_PREVIEW,
+            GPT_4_1106_PREVIEW,
+            GPT_4_VISION_PREVIEW,
+            GPT_4,
+            GPT_4_0314,
+            GPT_4_0613,
+            GPT_4_32K,
+            GPT_4_32K_0314,
+            GPT_4_32K_0613,
+            GPT_3_5_TURBO,
+            GPT_3_5_TURBO_16K,
+            GPT_3_5_TURBO_0301,
+            GPT_3_5_TURBO_0613,
+            GPT_3_5_TURBO_1106,
+            GPT_3_5_TURBO_0125,
+            GPT_3_5_TURBO_16K_0613,
+            O1_PRO,
+            O1_PRO_2025_03_19,
+            O3_PRO,
+            O3_PRO_2025_06_10,
+            O3_DEEP_RESEARCH,
+            O3_DEEP_RESEARCH_2025_06_26,
+            O4_MINI_DEEP_RESEARCH,
+            O4_MINI_DEEP_RESEARCH_2025_06_26,
+            COMPUTER_USE_PREVIEW,
+            COMPUTER_USE_PREVIEW_2025_03_11,
+            GPT_5_CODEX,
+            GPT_5_PRO,
+            GPT_5_PRO_2025_10_06,
+            GPT_5_1_CODEX_MAX,
+            /** An enum member indicating that [Model] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                GPT_5_6_SOL -> Value.GPT_5_6_SOL
+                GPT_5_6_TERRA -> Value.GPT_5_6_TERRA
+                GPT_5_6_LUNA -> Value.GPT_5_6_LUNA
+                GPT_5_4 -> Value.GPT_5_4
+                GPT_5_4_MINI -> Value.GPT_5_4_MINI
+                GPT_5_4_NANO -> Value.GPT_5_4_NANO
+                GPT_5_4_MINI_2026_03_17 -> Value.GPT_5_4_MINI_2026_03_17
+                GPT_5_4_NANO_2026_03_17 -> Value.GPT_5_4_NANO_2026_03_17
+                GPT_5_3_CHAT_LATEST -> Value.GPT_5_3_CHAT_LATEST
+                GPT_5_2 -> Value.GPT_5_2
+                GPT_5_2_2025_12_11 -> Value.GPT_5_2_2025_12_11
+                GPT_5_2_CHAT_LATEST -> Value.GPT_5_2_CHAT_LATEST
+                GPT_5_2_PRO -> Value.GPT_5_2_PRO
+                GPT_5_2_PRO_2025_12_11 -> Value.GPT_5_2_PRO_2025_12_11
+                GPT_5_1 -> Value.GPT_5_1
+                GPT_5_1_2025_11_13 -> Value.GPT_5_1_2025_11_13
+                GPT_5_1_CODEX -> Value.GPT_5_1_CODEX
+                GPT_5_1_MINI -> Value.GPT_5_1_MINI
+                GPT_5_1_CHAT_LATEST -> Value.GPT_5_1_CHAT_LATEST
+                GPT_5 -> Value.GPT_5
+                GPT_5_MINI -> Value.GPT_5_MINI
+                GPT_5_NANO -> Value.GPT_5_NANO
+                GPT_5_2025_08_07 -> Value.GPT_5_2025_08_07
+                GPT_5_MINI_2025_08_07 -> Value.GPT_5_MINI_2025_08_07
+                GPT_5_NANO_2025_08_07 -> Value.GPT_5_NANO_2025_08_07
+                GPT_5_CHAT_LATEST -> Value.GPT_5_CHAT_LATEST
+                GPT_4_1 -> Value.GPT_4_1
+                GPT_4_1_MINI -> Value.GPT_4_1_MINI
+                GPT_4_1_NANO -> Value.GPT_4_1_NANO
+                GPT_4_1_2025_04_14 -> Value.GPT_4_1_2025_04_14
+                GPT_4_1_MINI_2025_04_14 -> Value.GPT_4_1_MINI_2025_04_14
+                GPT_4_1_NANO_2025_04_14 -> Value.GPT_4_1_NANO_2025_04_14
+                O4_MINI -> Value.O4_MINI
+                O4_MINI_2025_04_16 -> Value.O4_MINI_2025_04_16
+                O3 -> Value.O3
+                O3_2025_04_16 -> Value.O3_2025_04_16
+                O3_MINI -> Value.O3_MINI
+                O3_MINI_2025_01_31 -> Value.O3_MINI_2025_01_31
+                O1 -> Value.O1
+                O1_2024_12_17 -> Value.O1_2024_12_17
+                O1_PREVIEW -> Value.O1_PREVIEW
+                O1_PREVIEW_2024_09_12 -> Value.O1_PREVIEW_2024_09_12
+                O1_MINI -> Value.O1_MINI
+                O1_MINI_2024_09_12 -> Value.O1_MINI_2024_09_12
+                GPT_4O -> Value.GPT_4O
+                GPT_4O_2024_11_20 -> Value.GPT_4O_2024_11_20
+                GPT_4O_2024_08_06 -> Value.GPT_4O_2024_08_06
+                GPT_4O_2024_05_13 -> Value.GPT_4O_2024_05_13
+                GPT_4O_AUDIO_PREVIEW -> Value.GPT_4O_AUDIO_PREVIEW
+                GPT_4O_AUDIO_PREVIEW_2024_10_01 -> Value.GPT_4O_AUDIO_PREVIEW_2024_10_01
+                GPT_4O_AUDIO_PREVIEW_2024_12_17 -> Value.GPT_4O_AUDIO_PREVIEW_2024_12_17
+                GPT_4O_AUDIO_PREVIEW_2025_06_03 -> Value.GPT_4O_AUDIO_PREVIEW_2025_06_03
+                GPT_4O_MINI_AUDIO_PREVIEW -> Value.GPT_4O_MINI_AUDIO_PREVIEW
+                GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17 -> Value.GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17
+                GPT_4O_SEARCH_PREVIEW -> Value.GPT_4O_SEARCH_PREVIEW
+                GPT_4O_MINI_SEARCH_PREVIEW -> Value.GPT_4O_MINI_SEARCH_PREVIEW
+                GPT_4O_SEARCH_PREVIEW_2025_03_11 -> Value.GPT_4O_SEARCH_PREVIEW_2025_03_11
+                GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11 -> Value.GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11
+                CHATGPT_4O_LATEST -> Value.CHATGPT_4O_LATEST
+                CODEX_MINI_LATEST -> Value.CODEX_MINI_LATEST
+                GPT_4O_MINI -> Value.GPT_4O_MINI
+                GPT_4O_MINI_2024_07_18 -> Value.GPT_4O_MINI_2024_07_18
+                GPT_4_TURBO -> Value.GPT_4_TURBO
+                GPT_4_TURBO_2024_04_09 -> Value.GPT_4_TURBO_2024_04_09
+                GPT_4_0125_PREVIEW -> Value.GPT_4_0125_PREVIEW
+                GPT_4_TURBO_PREVIEW -> Value.GPT_4_TURBO_PREVIEW
+                GPT_4_1106_PREVIEW -> Value.GPT_4_1106_PREVIEW
+                GPT_4_VISION_PREVIEW -> Value.GPT_4_VISION_PREVIEW
+                GPT_4 -> Value.GPT_4
+                GPT_4_0314 -> Value.GPT_4_0314
+                GPT_4_0613 -> Value.GPT_4_0613
+                GPT_4_32K -> Value.GPT_4_32K
+                GPT_4_32K_0314 -> Value.GPT_4_32K_0314
+                GPT_4_32K_0613 -> Value.GPT_4_32K_0613
+                GPT_3_5_TURBO -> Value.GPT_3_5_TURBO
+                GPT_3_5_TURBO_16K -> Value.GPT_3_5_TURBO_16K
+                GPT_3_5_TURBO_0301 -> Value.GPT_3_5_TURBO_0301
+                GPT_3_5_TURBO_0613 -> Value.GPT_3_5_TURBO_0613
+                GPT_3_5_TURBO_1106 -> Value.GPT_3_5_TURBO_1106
+                GPT_3_5_TURBO_0125 -> Value.GPT_3_5_TURBO_0125
+                GPT_3_5_TURBO_16K_0613 -> Value.GPT_3_5_TURBO_16K_0613
+                O1_PRO -> Value.O1_PRO
+                O1_PRO_2025_03_19 -> Value.O1_PRO_2025_03_19
+                O3_PRO -> Value.O3_PRO
+                O3_PRO_2025_06_10 -> Value.O3_PRO_2025_06_10
+                O3_DEEP_RESEARCH -> Value.O3_DEEP_RESEARCH
+                O3_DEEP_RESEARCH_2025_06_26 -> Value.O3_DEEP_RESEARCH_2025_06_26
+                O4_MINI_DEEP_RESEARCH -> Value.O4_MINI_DEEP_RESEARCH
+                O4_MINI_DEEP_RESEARCH_2025_06_26 -> Value.O4_MINI_DEEP_RESEARCH_2025_06_26
+                COMPUTER_USE_PREVIEW -> Value.COMPUTER_USE_PREVIEW
+                COMPUTER_USE_PREVIEW_2025_03_11 -> Value.COMPUTER_USE_PREVIEW_2025_03_11
+                GPT_5_CODEX -> Value.GPT_5_CODEX
+                GPT_5_PRO -> Value.GPT_5_PRO
+                GPT_5_PRO_2025_10_06 -> Value.GPT_5_PRO_2025_10_06
+                GPT_5_1_CODEX_MAX -> Value.GPT_5_1_CODEX_MAX
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                GPT_5_6_SOL -> Known.GPT_5_6_SOL
+                GPT_5_6_TERRA -> Known.GPT_5_6_TERRA
+                GPT_5_6_LUNA -> Known.GPT_5_6_LUNA
+                GPT_5_4 -> Known.GPT_5_4
+                GPT_5_4_MINI -> Known.GPT_5_4_MINI
+                GPT_5_4_NANO -> Known.GPT_5_4_NANO
+                GPT_5_4_MINI_2026_03_17 -> Known.GPT_5_4_MINI_2026_03_17
+                GPT_5_4_NANO_2026_03_17 -> Known.GPT_5_4_NANO_2026_03_17
+                GPT_5_3_CHAT_LATEST -> Known.GPT_5_3_CHAT_LATEST
+                GPT_5_2 -> Known.GPT_5_2
+                GPT_5_2_2025_12_11 -> Known.GPT_5_2_2025_12_11
+                GPT_5_2_CHAT_LATEST -> Known.GPT_5_2_CHAT_LATEST
+                GPT_5_2_PRO -> Known.GPT_5_2_PRO
+                GPT_5_2_PRO_2025_12_11 -> Known.GPT_5_2_PRO_2025_12_11
+                GPT_5_1 -> Known.GPT_5_1
+                GPT_5_1_2025_11_13 -> Known.GPT_5_1_2025_11_13
+                GPT_5_1_CODEX -> Known.GPT_5_1_CODEX
+                GPT_5_1_MINI -> Known.GPT_5_1_MINI
+                GPT_5_1_CHAT_LATEST -> Known.GPT_5_1_CHAT_LATEST
+                GPT_5 -> Known.GPT_5
+                GPT_5_MINI -> Known.GPT_5_MINI
+                GPT_5_NANO -> Known.GPT_5_NANO
+                GPT_5_2025_08_07 -> Known.GPT_5_2025_08_07
+                GPT_5_MINI_2025_08_07 -> Known.GPT_5_MINI_2025_08_07
+                GPT_5_NANO_2025_08_07 -> Known.GPT_5_NANO_2025_08_07
+                GPT_5_CHAT_LATEST -> Known.GPT_5_CHAT_LATEST
+                GPT_4_1 -> Known.GPT_4_1
+                GPT_4_1_MINI -> Known.GPT_4_1_MINI
+                GPT_4_1_NANO -> Known.GPT_4_1_NANO
+                GPT_4_1_2025_04_14 -> Known.GPT_4_1_2025_04_14
+                GPT_4_1_MINI_2025_04_14 -> Known.GPT_4_1_MINI_2025_04_14
+                GPT_4_1_NANO_2025_04_14 -> Known.GPT_4_1_NANO_2025_04_14
+                O4_MINI -> Known.O4_MINI
+                O4_MINI_2025_04_16 -> Known.O4_MINI_2025_04_16
+                O3 -> Known.O3
+                O3_2025_04_16 -> Known.O3_2025_04_16
+                O3_MINI -> Known.O3_MINI
+                O3_MINI_2025_01_31 -> Known.O3_MINI_2025_01_31
+                O1 -> Known.O1
+                O1_2024_12_17 -> Known.O1_2024_12_17
+                O1_PREVIEW -> Known.O1_PREVIEW
+                O1_PREVIEW_2024_09_12 -> Known.O1_PREVIEW_2024_09_12
+                O1_MINI -> Known.O1_MINI
+                O1_MINI_2024_09_12 -> Known.O1_MINI_2024_09_12
+                GPT_4O -> Known.GPT_4O
+                GPT_4O_2024_11_20 -> Known.GPT_4O_2024_11_20
+                GPT_4O_2024_08_06 -> Known.GPT_4O_2024_08_06
+                GPT_4O_2024_05_13 -> Known.GPT_4O_2024_05_13
+                GPT_4O_AUDIO_PREVIEW -> Known.GPT_4O_AUDIO_PREVIEW
+                GPT_4O_AUDIO_PREVIEW_2024_10_01 -> Known.GPT_4O_AUDIO_PREVIEW_2024_10_01
+                GPT_4O_AUDIO_PREVIEW_2024_12_17 -> Known.GPT_4O_AUDIO_PREVIEW_2024_12_17
+                GPT_4O_AUDIO_PREVIEW_2025_06_03 -> Known.GPT_4O_AUDIO_PREVIEW_2025_06_03
+                GPT_4O_MINI_AUDIO_PREVIEW -> Known.GPT_4O_MINI_AUDIO_PREVIEW
+                GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17 -> Known.GPT_4O_MINI_AUDIO_PREVIEW_2024_12_17
+                GPT_4O_SEARCH_PREVIEW -> Known.GPT_4O_SEARCH_PREVIEW
+                GPT_4O_MINI_SEARCH_PREVIEW -> Known.GPT_4O_MINI_SEARCH_PREVIEW
+                GPT_4O_SEARCH_PREVIEW_2025_03_11 -> Known.GPT_4O_SEARCH_PREVIEW_2025_03_11
+                GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11 -> Known.GPT_4O_MINI_SEARCH_PREVIEW_2025_03_11
+                CHATGPT_4O_LATEST -> Known.CHATGPT_4O_LATEST
+                CODEX_MINI_LATEST -> Known.CODEX_MINI_LATEST
+                GPT_4O_MINI -> Known.GPT_4O_MINI
+                GPT_4O_MINI_2024_07_18 -> Known.GPT_4O_MINI_2024_07_18
+                GPT_4_TURBO -> Known.GPT_4_TURBO
+                GPT_4_TURBO_2024_04_09 -> Known.GPT_4_TURBO_2024_04_09
+                GPT_4_0125_PREVIEW -> Known.GPT_4_0125_PREVIEW
+                GPT_4_TURBO_PREVIEW -> Known.GPT_4_TURBO_PREVIEW
+                GPT_4_1106_PREVIEW -> Known.GPT_4_1106_PREVIEW
+                GPT_4_VISION_PREVIEW -> Known.GPT_4_VISION_PREVIEW
+                GPT_4 -> Known.GPT_4
+                GPT_4_0314 -> Known.GPT_4_0314
+                GPT_4_0613 -> Known.GPT_4_0613
+                GPT_4_32K -> Known.GPT_4_32K
+                GPT_4_32K_0314 -> Known.GPT_4_32K_0314
+                GPT_4_32K_0613 -> Known.GPT_4_32K_0613
+                GPT_3_5_TURBO -> Known.GPT_3_5_TURBO
+                GPT_3_5_TURBO_16K -> Known.GPT_3_5_TURBO_16K
+                GPT_3_5_TURBO_0301 -> Known.GPT_3_5_TURBO_0301
+                GPT_3_5_TURBO_0613 -> Known.GPT_3_5_TURBO_0613
+                GPT_3_5_TURBO_1106 -> Known.GPT_3_5_TURBO_1106
+                GPT_3_5_TURBO_0125 -> Known.GPT_3_5_TURBO_0125
+                GPT_3_5_TURBO_16K_0613 -> Known.GPT_3_5_TURBO_16K_0613
+                O1_PRO -> Known.O1_PRO
+                O1_PRO_2025_03_19 -> Known.O1_PRO_2025_03_19
+                O3_PRO -> Known.O3_PRO
+                O3_PRO_2025_06_10 -> Known.O3_PRO_2025_06_10
+                O3_DEEP_RESEARCH -> Known.O3_DEEP_RESEARCH
+                O3_DEEP_RESEARCH_2025_06_26 -> Known.O3_DEEP_RESEARCH_2025_06_26
+                O4_MINI_DEEP_RESEARCH -> Known.O4_MINI_DEEP_RESEARCH
+                O4_MINI_DEEP_RESEARCH_2025_06_26 -> Known.O4_MINI_DEEP_RESEARCH_2025_06_26
+                COMPUTER_USE_PREVIEW -> Known.COMPUTER_USE_PREVIEW
+                COMPUTER_USE_PREVIEW_2025_03_11 -> Known.COMPUTER_USE_PREVIEW_2025_03_11
+                GPT_5_CODEX -> Known.GPT_5_CODEX
+                GPT_5_PRO -> Known.GPT_5_PRO
+                GPT_5_PRO_2025_10_06 -> Known.GPT_5_PRO_2025_10_06
+                GPT_5_1_CODEX_MAX -> Known.GPT_5_1_CODEX_MAX
+                else -> throw OpenAIInvalidDataException("Unknown Model: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Model = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Model && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** Configuration for running moderation on the input and output of this response. */
+    class Moderation
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val model: JsonField<String>,
+        private val policy: JsonField<Policy>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("model") @ExcludeMissing model: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("policy") @ExcludeMissing policy: JsonField<Policy> = JsonMissing.of(),
+        ) : this(model, policy, mutableMapOf())
+
+        /**
+         * The moderation model to use for moderated completions, e.g. 'omni-moderation-latest'.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun model(): String = model.getRequired("model")
+
+        /**
+         * The policy to apply to moderated response input and output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun policy(): Optional<Policy> = policy.getOptional("policy")
+
+        /**
+         * Returns the raw JSON value of [model].
+         *
+         * Unlike [model], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("model") @ExcludeMissing fun _model(): JsonField<String> = model
+
+        /**
+         * Returns the raw JSON value of [policy].
+         *
+         * Unlike [policy], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("policy") @ExcludeMissing fun _policy(): JsonField<Policy> = policy
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Moderation].
+             *
+             * The following fields are required:
+             * ```java
+             * .model()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Moderation]. */
+        class Builder internal constructor() {
+
+            private var model: JsonField<String>? = null
+            private var policy: JsonField<Policy> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(moderation: Moderation) = apply {
+                model = moderation.model
+                policy = moderation.policy
+                additionalProperties = moderation.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * The moderation model to use for moderated completions, e.g. 'omni-moderation-latest'.
+             */
+            fun model(model: String) = model(JsonField.of(model))
+
+            /**
+             * Sets [Builder.model] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.model] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun model(model: JsonField<String>) = apply { this.model = model }
+
+            /** The policy to apply to moderated response input and output. */
+            fun policy(policy: Policy?) = policy(JsonField.ofNullable(policy))
+
+            /** Alias for calling [Builder.policy] with `policy.orElse(null)`. */
+            fun policy(policy: Optional<Policy>) = policy(policy.getOrNull())
+
+            /**
+             * Sets [Builder.policy] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.policy] with a well-typed [Policy] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun policy(policy: JsonField<Policy>) = apply { this.policy = policy }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Moderation].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .model()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Moderation =
+                Moderation(
+                    checkRequired("model", model),
+                    policy,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Moderation = apply {
+            if (validated) {
+                return@apply
+            }
+
+            model()
+            policy().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (model.asKnown().isPresent) 1 else 0) +
+                (policy.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The policy to apply to moderated response input and output. */
+        class Policy
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val input: JsonField<Input>,
+            private val output: JsonField<Output>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("input") @ExcludeMissing input: JsonField<Input> = JsonMissing.of(),
+                @JsonProperty("output") @ExcludeMissing output: JsonField<Output> = JsonMissing.of(),
+            ) : this(input, output, mutableMapOf())
+
+            /**
+             * The moderation policy for the response input.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun input(): Optional<Input> = input.getOptional("input")
+
+            /**
+             * The moderation policy for the response output.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun output(): Optional<Output> = output.getOptional("output")
+
+            /**
+             * Returns the raw JSON value of [input].
+             *
+             * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("input") @ExcludeMissing fun _input(): JsonField<Input> = input
+
+            /**
+             * Returns the raw JSON value of [output].
+             *
+             * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<Output> = output
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /** Returns a mutable builder for constructing an instance of [Policy]. */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Policy]. */
+            class Builder internal constructor() {
+
+                private var input: JsonField<Input> = JsonMissing.of()
+                private var output: JsonField<Output> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(policy: Policy) = apply {
+                    input = policy.input
+                    output = policy.output
+                    additionalProperties = policy.additionalProperties.toMutableMap()
+                }
+
+                /** The moderation policy for the response input. */
+                fun input(input: Input?) = input(JsonField.ofNullable(input))
+
+                /** Alias for calling [Builder.input] with `input.orElse(null)`. */
+                fun input(input: Optional<Input>) = input(input.getOrNull())
+
+                /**
+                 * Sets [Builder.input] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.input] with a well-typed [Input] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun input(input: JsonField<Input>) = apply { this.input = input }
+
+                /** The moderation policy for the response output. */
+                fun output(output: Output?) = output(JsonField.ofNullable(output))
+
+                /** Alias for calling [Builder.output] with `output.orElse(null)`. */
+                fun output(output: Optional<Output>) = output(output.getOrNull())
+
+                /**
+                 * Sets [Builder.output] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.output] with a well-typed [Output] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun output(output: JsonField<Output>) = apply { this.output = output }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Policy].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): Policy = Policy(input, output, additionalProperties.toMutableMap())
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Policy = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                input().ifPresent { it.validate() }
+                output().ifPresent { it.validate() }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (input.asKnown().getOrNull()?.validity() ?: 0) +
+                    (output.asKnown().getOrNull()?.validity() ?: 0)
+
+            /** The moderation policy for the response input. */
+            class Input
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val mode: JsonField<Mode>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of()
+                ) : this(mode, mutableMapOf())
+
+                /**
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun mode(): Mode = mode.getRequired("mode")
+
+                /**
+                 * Returns the raw JSON value of [mode].
+                 *
+                 * Unlike [mode], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Input].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .mode()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Input]. */
+                class Builder internal constructor() {
+
+                    private var mode: JsonField<Mode>? = null
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(input: Input) = apply {
+                        mode = input.mode
+                        additionalProperties = input.additionalProperties.toMutableMap()
+                    }
+
+                    fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+                    /**
+                     * Sets [Builder.mode] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.mode] with a well-typed [Mode] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Input].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .mode()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Input =
+                        Input(checkRequired("mode", mode), additionalProperties.toMutableMap())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Input = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    mode().validate()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int = (mode.asKnown().getOrNull()?.validity() ?: 0)
+
+                class Mode @JsonCreator private constructor(private val value: JsonField<String>) :
+                    Enum {
+
+                    /**
+                     * Returns this class instance's raw value.
+                     *
+                     * This is usually only useful if this instance was deserialized from data that
+                     * doesn't match any known member, and you want to know that value. For example,
+                     * if the SDK is on an older version than the API, then the API may respond with
+                     * new members that the SDK is unaware of.
+                     */
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    fun _value(): JsonField<String> = value
+
+                    companion object {
+
+                        @JvmField val SCORE = of("score")
+
+                        @JvmField val BLOCK = of("block")
+
+                        @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+                    }
+
+                    /** An enum containing [Mode]'s known values. */
+                    enum class Known {
+                        SCORE,
+                        BLOCK,
+                    }
+
+                    /**
+                     * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+                     *
+                     * An instance of [Mode] can contain an unknown value in a couple of cases:
+                     * - It was deserialized from data that doesn't match any known member. For
+                     *   example, if the SDK is on an older version than the API, then the API may
+                     *   respond with new members that the SDK is unaware of.
+                     * - It was constructed with an arbitrary value using the [of] method.
+                     */
+                    enum class Value {
+                        SCORE,
+                        BLOCK,
+                        /**
+                         * An enum member indicating that [Mode] was instantiated with an unknown
+                         * value.
+                         */
+                        _UNKNOWN,
+                    }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value, or
+                     * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                     *
+                     * Use the [known] method instead if you're certain the value is always known or
+                     * if you want to throw for the unknown case.
+                     */
+                    fun value(): Value =
+                        when (this) {
+                            SCORE -> Value.SCORE
+                            BLOCK -> Value.BLOCK
+                            else -> Value._UNKNOWN
+                        }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value.
+                     *
+                     * Use the [value] method instead if you're uncertain the value is always known
+                     * and don't want to throw for the unknown case.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                     *   known member.
+                     */
+                    fun known(): Known =
+                        when (this) {
+                            SCORE -> Known.SCORE
+                            BLOCK -> Known.BLOCK
+                            else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                        }
+
+                    /**
+                     * Returns this class instance's primitive wire representation.
+                     *
+                     * This differs from the [toString] method because that method is primarily for
+                     * debugging and generally doesn't throw.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value does not
+                     *   have the expected primitive type.
+                     */
+                    fun asString(): String =
+                        _value().asString().orElseThrow {
+                            OpenAIInvalidDataException("Value is not a String")
+                        }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): Mode = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        known()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Mode && value == other.value
+                    }
+
+                    override fun hashCode() = value.hashCode()
+
+                    override fun toString() = value.toString()
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Input &&
+                        mode == other.mode &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Input{mode=$mode, additionalProperties=$additionalProperties}"
+            }
+
+            /** The moderation policy for the response output. */
+            class Output
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val mode: JsonField<Mode>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of()
+                ) : this(mode, mutableMapOf())
+
+                /**
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun mode(): Mode = mode.getRequired("mode")
+
+                /**
+                 * Returns the raw JSON value of [mode].
+                 *
+                 * Unlike [mode], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Output].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .mode()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Output]. */
+                class Builder internal constructor() {
+
+                    private var mode: JsonField<Mode>? = null
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(output: Output) = apply {
+                        mode = output.mode
+                        additionalProperties = output.additionalProperties.toMutableMap()
+                    }
+
+                    fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+                    /**
+                     * Sets [Builder.mode] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.mode] with a well-typed [Mode] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Output].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .mode()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Output =
+                        Output(checkRequired("mode", mode), additionalProperties.toMutableMap())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Output = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    mode().validate()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int = (mode.asKnown().getOrNull()?.validity() ?: 0)
+
+                class Mode @JsonCreator private constructor(private val value: JsonField<String>) :
+                    Enum {
+
+                    /**
+                     * Returns this class instance's raw value.
+                     *
+                     * This is usually only useful if this instance was deserialized from data that
+                     * doesn't match any known member, and you want to know that value. For example,
+                     * if the SDK is on an older version than the API, then the API may respond with
+                     * new members that the SDK is unaware of.
+                     */
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    fun _value(): JsonField<String> = value
+
+                    companion object {
+
+                        @JvmField val SCORE = of("score")
+
+                        @JvmField val BLOCK = of("block")
+
+                        @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+                    }
+
+                    /** An enum containing [Mode]'s known values. */
+                    enum class Known {
+                        SCORE,
+                        BLOCK,
+                    }
+
+                    /**
+                     * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+                     *
+                     * An instance of [Mode] can contain an unknown value in a couple of cases:
+                     * - It was deserialized from data that doesn't match any known member. For
+                     *   example, if the SDK is on an older version than the API, then the API may
+                     *   respond with new members that the SDK is unaware of.
+                     * - It was constructed with an arbitrary value using the [of] method.
+                     */
+                    enum class Value {
+                        SCORE,
+                        BLOCK,
+                        /**
+                         * An enum member indicating that [Mode] was instantiated with an unknown
+                         * value.
+                         */
+                        _UNKNOWN,
+                    }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value, or
+                     * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                     *
+                     * Use the [known] method instead if you're certain the value is always known or
+                     * if you want to throw for the unknown case.
+                     */
+                    fun value(): Value =
+                        when (this) {
+                            SCORE -> Value.SCORE
+                            BLOCK -> Value.BLOCK
+                            else -> Value._UNKNOWN
+                        }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value.
+                     *
+                     * Use the [value] method instead if you're uncertain the value is always known
+                     * and don't want to throw for the unknown case.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                     *   known member.
+                     */
+                    fun known(): Known =
+                        when (this) {
+                            SCORE -> Known.SCORE
+                            BLOCK -> Known.BLOCK
+                            else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                        }
+
+                    /**
+                     * Returns this class instance's primitive wire representation.
+                     *
+                     * This differs from the [toString] method because that method is primarily for
+                     * debugging and generally doesn't throw.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value does not
+                     *   have the expected primitive type.
+                     */
+                    fun asString(): String =
+                        _value().asString().orElseThrow {
+                            OpenAIInvalidDataException("Value is not a String")
+                        }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): Mode = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        known()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Mode && value == other.value
+                    }
+
+                    override fun hashCode() = value.hashCode()
+
+                    override fun toString() = value.toString()
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Output &&
+                        mode == other.mode &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Output{mode=$mode, additionalProperties=$additionalProperties}"
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Policy &&
+                    input == other.input &&
+                    output == other.output &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(input, output, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Policy{input=$input, output=$output, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Moderation &&
+                model == other.model &&
+                policy == other.policy &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(model, policy, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Moderation{model=$model, policy=$policy, additionalProperties=$additionalProperties}"
+    }
+
+    /** Configuration for server-hosted multi-agent execution. */
+    class MultiAgent
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val enabled: JsonField<Boolean>,
+        private val maxConcurrentSubagents: JsonField<Long>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("enabled") @ExcludeMissing enabled: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("max_concurrent_subagents")
+            @ExcludeMissing
+            maxConcurrentSubagents: JsonField<Long> = JsonMissing.of(),
+        ) : this(enabled, maxConcurrentSubagents, mutableMapOf())
+
+        /**
+         * Whether to enable server-hosted multi-agent execution for this response.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun enabled(): Boolean = enabled.getRequired("enabled")
+
+        /**
+         * `max_concurrent_subagents` sets the maximum number of subagents that can be active
+         * simultaneously across the entire agent tree. It includes all descendants—children,
+         * grandchildren, and deeper subagents—but excludes the root agent. The API does not impose
+         * a fixed upper bound on this setting. The default is `3`, which is recommended for most
+         * workloads. Multi-agent runs also have no fixed limit on tree depth or the total number of
+         * subagents created during a run.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun maxConcurrentSubagents(): Optional<Long> =
+            maxConcurrentSubagents.getOptional("max_concurrent_subagents")
+
+        /**
+         * Returns the raw JSON value of [enabled].
+         *
+         * Unlike [enabled], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("enabled") @ExcludeMissing fun _enabled(): JsonField<Boolean> = enabled
+
+        /**
+         * Returns the raw JSON value of [maxConcurrentSubagents].
+         *
+         * Unlike [maxConcurrentSubagents], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @JsonProperty("max_concurrent_subagents")
+        @ExcludeMissing
+        fun _maxConcurrentSubagents(): JsonField<Long> = maxConcurrentSubagents
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [MultiAgent].
+             *
+             * The following fields are required:
+             * ```java
+             * .enabled()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [MultiAgent]. */
+        class Builder internal constructor() {
+
+            private var enabled: JsonField<Boolean>? = null
+            private var maxConcurrentSubagents: JsonField<Long> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(multiAgent: MultiAgent) = apply {
+                enabled = multiAgent.enabled
+                maxConcurrentSubagents = multiAgent.maxConcurrentSubagents
+                additionalProperties = multiAgent.additionalProperties.toMutableMap()
+            }
+
+            /** Whether to enable server-hosted multi-agent execution for this response. */
+            fun enabled(enabled: Boolean) = enabled(JsonField.of(enabled))
+
+            /**
+             * Sets [Builder.enabled] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.enabled] with a well-typed [Boolean] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun enabled(enabled: JsonField<Boolean>) = apply { this.enabled = enabled }
+
+            /**
+             * `max_concurrent_subagents` sets the maximum number of subagents that can be active
+             * simultaneously across the entire agent tree. It includes all descendants—children,
+             * grandchildren, and deeper subagents—but excludes the root agent. The API does not
+             * impose a fixed upper bound on this setting. The default is `3`, which is recommended
+             * for most workloads. Multi-agent runs also have no fixed limit on tree depth or the
+             * total number of subagents created during a run.
+             */
+            fun maxConcurrentSubagents(maxConcurrentSubagents: Long) =
+                maxConcurrentSubagents(JsonField.of(maxConcurrentSubagents))
+
+            /**
+             * Sets [Builder.maxConcurrentSubagents] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.maxConcurrentSubagents] with a well-typed [Long]
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            fun maxConcurrentSubagents(maxConcurrentSubagents: JsonField<Long>) = apply {
+                this.maxConcurrentSubagents = maxConcurrentSubagents
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [MultiAgent].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .enabled()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): MultiAgent =
+                MultiAgent(
+                    checkRequired("enabled", enabled),
+                    maxConcurrentSubagents,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): MultiAgent = apply {
+            if (validated) {
+                return@apply
+            }
+
+            enabled()
+            maxConcurrentSubagents()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (enabled.asKnown().isPresent) 1 else 0) +
+                (if (maxConcurrentSubagents.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is MultiAgent &&
+                enabled == other.enabled &&
+                maxConcurrentSubagents == other.maxConcurrentSubagents &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(enabled, maxConcurrentSubagents, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "MultiAgent{enabled=$enabled, maxConcurrentSubagents=$maxConcurrentSubagents, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+     * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+     * content blocks with `prompt_cache_breakpoint`. Each request can write up to four breakpoints.
+     * For cache matching, OpenAI considers up to the latest 80 breakpoints in the conversation,
+     * without a content-block lookback limit. Set `mode` to `explicit` to disable the implicit
+     * breakpoint. The `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for current
+     * details.
+     */
+    class PromptCacheOptions
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonField<Mode>,
+        private val ttl: JsonField<Ttl>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of(),
+            @JsonProperty("ttl") @ExcludeMissing ttl: JsonField<Ttl> = JsonMissing.of(),
+        ) : this(mode, ttl, mutableMapOf())
+
+        /**
+         * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults to
+         * `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up to the
+         * latest three explicit breakpoints in the request. With `explicit`, OpenAI does not create
+         * an implicit breakpoint and writes up to the latest four explicit breakpoints. If there
+         * are no explicit breakpoints, the request does not use prompt caching.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun mode(): Optional<Mode> = mode.getOptional("mode")
+
+        /**
+         * The minimum lifetime applied to every implicit and explicit cache breakpoint written by
+         * the request. Defaults to `30m`, which is currently the only supported value. The backend
+         * may retain cache entries for longer.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun ttl(): Optional<Ttl> = ttl.getOptional("ttl")
+
+        /**
+         * Returns the raw JSON value of [mode].
+         *
+         * Unlike [mode], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+        /**
+         * Returns the raw JSON value of [ttl].
+         *
+         * Unlike [ttl], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("ttl") @ExcludeMissing fun _ttl(): JsonField<Ttl> = ttl
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [PromptCacheOptions]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheOptions]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonField<Mode> = JsonMissing.of()
+            private var ttl: JsonField<Ttl> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheOptions: PromptCacheOptions) = apply {
+                mode = promptCacheOptions.mode
+                ttl = promptCacheOptions.ttl
+                additionalProperties = promptCacheOptions.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults
+             * to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up
+             * to the latest three explicit breakpoints in the request. With `explicit`, OpenAI does
+             * not create an implicit breakpoint and writes up to the latest four explicit
+             * breakpoints. If there are no explicit breakpoints, the request does not use prompt
+             * caching.
+             */
+            fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+            /**
+             * Sets [Builder.mode] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.mode] with a well-typed [Mode] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+            /**
+             * The minimum lifetime applied to every implicit and explicit cache breakpoint written
+             * by the request. Defaults to `30m`, which is currently the only supported value. The
+             * backend may retain cache entries for longer.
+             */
+            fun ttl(ttl: Ttl) = ttl(JsonField.of(ttl))
+
+            /**
+             * Sets [Builder.ttl] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.ttl] with a well-typed [Ttl] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun ttl(ttl: JsonField<Ttl>) = apply { this.ttl = ttl }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheOptions].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheOptions =
+                PromptCacheOptions(mode, ttl, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheOptions = apply {
+            if (validated) {
+                return@apply
+            }
+
+            mode().ifPresent { it.validate() }
+            ttl().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (mode.asKnown().getOrNull()?.validity() ?: 0) +
+                (ttl.asKnown().getOrNull()?.validity() ?: 0)
+
+        /**
+         * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults to
+         * `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up to the
+         * latest three explicit breakpoints in the request. With `explicit`, OpenAI does not create
+         * an implicit breakpoint and writes up to the latest four explicit breakpoints. If there
+         * are no explicit breakpoints, the request does not use prompt caching.
+         */
+        class Mode @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IMPLICIT = of("implicit")
+
+                @JvmField val EXPLICIT = of("explicit")
+
+                @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+            }
+
+            /** An enum containing [Mode]'s known values. */
+            enum class Known {
+                IMPLICIT,
+                EXPLICIT,
+            }
+
+            /**
+             * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Mode] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IMPLICIT,
+                EXPLICIT,
+                /** An enum member indicating that [Mode] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IMPLICIT -> Value.IMPLICIT
+                    EXPLICIT -> Value.EXPLICIT
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IMPLICIT -> Known.IMPLICIT
+                    EXPLICIT -> Known.EXPLICIT
+                    else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Mode = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Mode && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * The minimum lifetime applied to every implicit and explicit cache breakpoint written by
+         * the request. Defaults to `30m`, which is currently the only supported value. The backend
+         * may retain cache entries for longer.
+         */
+        class Ttl @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val _30M = of("30m")
+
+                @JvmStatic fun of(value: String) = Ttl(JsonField.of(value))
+            }
+
+            /** An enum containing [Ttl]'s known values. */
+            enum class Known {
+                _30M
+            }
+
+            /**
+             * An enum containing [Ttl]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Ttl] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                _30M,
+                /** An enum member indicating that [Ttl] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    _30M -> Value._30M
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    _30M -> Known._30M
+                    else -> throw OpenAIInvalidDataException("Unknown Ttl: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Ttl = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Ttl && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheOptions &&
+                mode == other.mode &&
+                ttl == other.ttl &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, ttl, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheOptions{mode=$mode, ttl=$ttl, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Deprecated. Use `prompt_cache_options.ttl` instead.
+     *
+     * The retention policy for the prompt cache. Set to `24h` to enable extended prompt caching,
+     * which keeps cached prefixes active for longer, up to a maximum of 24 hours.
+     * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+     * This field expresses a maximum retention policy, while `prompt_cache_options.ttl` expresses a
+     * minimum cache lifetime. The two fields are independent and do not interact. For `gpt-5.5`,
+     * `gpt-5.5-pro`, and future models, only `24h` is supported.
+     *
+     * For older models that support both `in_memory` and `24h`, the default depends on your
+     * organization's data retention policy:
+     * - Organizations without ZDR enabled default to `24h`.
+     * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is not
+     *   specified.
+     */
+    @Deprecated("deprecated")
+    class PromptCacheRetention
+    @JsonCreator
+    private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_MEMORY = of("in_memory")
+
+            @JvmField val _24H = of("24h")
+
+            @JvmStatic fun of(value: String) = PromptCacheRetention(JsonField.of(value))
+        }
+
+        /** An enum containing [PromptCacheRetention]'s known values. */
+        enum class Known {
+            IN_MEMORY,
+            _24H,
+        }
+
+        /**
+         * An enum containing [PromptCacheRetention]'s known values, as well as an [_UNKNOWN]
+         * member.
+         *
+         * An instance of [PromptCacheRetention] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_MEMORY,
+            _24H,
+            /**
+             * An enum member indicating that [PromptCacheRetention] was instantiated with an
+             * unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_MEMORY -> Value.IN_MEMORY
+                _24H -> Value._24H
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_MEMORY -> Known.IN_MEMORY
+                _24H -> Known._24H
+                else -> throw OpenAIInvalidDataException("Unknown PromptCacheRetention: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheRetention = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheRetention && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /**
+     * **gpt-5 and o-series models only**
+     *
+     * Configuration options for
+     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+     */
+    class Reasoning
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val context: JsonField<Context>,
+        private val effort: JsonField<Effort>,
+        private val generateSummary: JsonField<GenerateSummary>,
+        private val mode: JsonField<Mode>,
+        private val summary: JsonField<Summary>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("context") @ExcludeMissing context: JsonField<Context> = JsonMissing.of(),
+            @JsonProperty("effort") @ExcludeMissing effort: JsonField<Effort> = JsonMissing.of(),
+            @JsonProperty("generate_summary")
+            @ExcludeMissing
+            generateSummary: JsonField<GenerateSummary> = JsonMissing.of(),
+            @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of(),
+            @JsonProperty("summary") @ExcludeMissing summary: JsonField<Summary> = JsonMissing.of(),
+        ) : this(context, effort, generateSummary, mode, summary, mutableMapOf())
+
+        /**
+         * Controls which reasoning items are rendered back to the model on later turns. When
+         * returned on a response, this is the effective reasoning context mode used for the
+         * response.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun context(): Optional<Context> = context.getOptional("context")
+
+        /**
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun effort(): Optional<Effort> = effort.getOptional("effort")
+
+        /**
+         * **Deprecated:** use `summary` instead.
+         *
+         * A summary of the reasoning performed by the model. This can be useful for debugging and
+         * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        @Deprecated("deprecated")
+        fun generateSummary(): Optional<GenerateSummary> =
+            generateSummary.getOptional("generate_summary")
+
+        /**
+         * Controls the reasoning execution mode for the request.
+         *
+         * When returned on a response, this is the effective execution mode.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun mode(): Optional<Mode> = mode.getOptional("mode")
+
+        /**
+         * A summary of the reasoning performed by the model. This can be useful for debugging and
+         * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
+         *
+         * `concise` is supported for `computer-use-preview` models and all reasoning models after
+         * `gpt-5`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun summary(): Optional<Summary> = summary.getOptional("summary")
+
+        /**
+         * Returns the raw JSON value of [context].
+         *
+         * Unlike [context], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("context") @ExcludeMissing fun _context(): JsonField<Context> = context
+
+        /**
+         * Returns the raw JSON value of [effort].
+         *
+         * Unlike [effort], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("effort") @ExcludeMissing fun _effort(): JsonField<Effort> = effort
+
+        /**
+         * Returns the raw JSON value of [generateSummary].
+         *
+         * Unlike [generateSummary], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @Deprecated("deprecated")
+        @JsonProperty("generate_summary")
+        @ExcludeMissing
+        fun _generateSummary(): JsonField<GenerateSummary> = generateSummary
+
+        /**
+         * Returns the raw JSON value of [mode].
+         *
+         * Unlike [mode], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+        /**
+         * Returns the raw JSON value of [summary].
+         *
+         * Unlike [summary], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("summary") @ExcludeMissing fun _summary(): JsonField<Summary> = summary
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Reasoning]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Reasoning]. */
+        class Builder internal constructor() {
+
+            private var context: JsonField<Context> = JsonMissing.of()
+            private var effort: JsonField<Effort> = JsonMissing.of()
+            private var generateSummary: JsonField<GenerateSummary> = JsonMissing.of()
+            private var mode: JsonField<Mode> = JsonMissing.of()
+            private var summary: JsonField<Summary> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(reasoning: Reasoning) = apply {
+                context = reasoning.context
+                effort = reasoning.effort
+                generateSummary = reasoning.generateSummary
+                mode = reasoning.mode
+                summary = reasoning.summary
+                additionalProperties = reasoning.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Controls which reasoning items are rendered back to the model on later turns. When
+             * returned on a response, this is the effective reasoning context mode used for the
+             * response.
+             */
+            fun context(context: Context?) = context(JsonField.ofNullable(context))
+
+            /** Alias for calling [Builder.context] with `context.orElse(null)`. */
+            fun context(context: Optional<Context>) = context(context.getOrNull())
+
+            /**
+             * Sets [Builder.context] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.context] with a well-typed [Context] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun context(context: JsonField<Context>) = apply { this.context = context }
+
+            /**
+             * Constrains effort on reasoning for reasoning models. Currently supported values are
+             * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning
+             * effort can result in faster responses and fewer tokens used on reasoning in a
+             * response. Not all reasoning models support every value. See the
+             * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+             * model-specific support.
+             */
+            fun effort(effort: Effort?) = effort(JsonField.ofNullable(effort))
+
+            /** Alias for calling [Builder.effort] with `effort.orElse(null)`. */
+            fun effort(effort: Optional<Effort>) = effort(effort.getOrNull())
+
+            /**
+             * Sets [Builder.effort] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.effort] with a well-typed [Effort] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun effort(effort: JsonField<Effort>) = apply { this.effort = effort }
+
+            /**
+             * **Deprecated:** use `summary` instead.
+             *
+             * A summary of the reasoning performed by the model. This can be useful for debugging
+             * and understanding the model's reasoning process. One of `auto`, `concise`, or
+             * `detailed`.
+             */
+            @Deprecated("deprecated")
+            fun generateSummary(generateSummary: GenerateSummary?) =
+                generateSummary(JsonField.ofNullable(generateSummary))
+
+            /** Alias for calling [Builder.generateSummary] with `generateSummary.orElse(null)`. */
+            @Deprecated("deprecated")
+            fun generateSummary(generateSummary: Optional<GenerateSummary>) =
+                generateSummary(generateSummary.getOrNull())
+
+            /**
+             * Sets [Builder.generateSummary] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.generateSummary] with a well-typed [GenerateSummary]
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            @Deprecated("deprecated")
+            fun generateSummary(generateSummary: JsonField<GenerateSummary>) = apply {
+                this.generateSummary = generateSummary
+            }
+
+            /**
+             * Controls the reasoning execution mode for the request.
+             *
+             * When returned on a response, this is the effective execution mode.
+             */
+            fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+            /**
+             * Sets [Builder.mode] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.mode] with a well-typed [Mode] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+            /**
+             * Sets [mode] to an arbitrary [String].
+             *
+             * You should usually call [mode] with a well-typed [Mode] constant instead. This method
+             * is primarily for setting the field to an undocumented or not yet supported value.
+             */
+            fun mode(value: String) = mode(Mode.of(value))
+
+            /**
+             * A summary of the reasoning performed by the model. This can be useful for debugging
+             * and understanding the model's reasoning process. One of `auto`, `concise`, or
+             * `detailed`.
+             *
+             * `concise` is supported for `computer-use-preview` models and all reasoning models
+             * after `gpt-5`.
+             */
+            fun summary(summary: Summary?) = summary(JsonField.ofNullable(summary))
+
+            /** Alias for calling [Builder.summary] with `summary.orElse(null)`. */
+            fun summary(summary: Optional<Summary>) = summary(summary.getOrNull())
+
+            /**
+             * Sets [Builder.summary] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.summary] with a well-typed [Summary] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun summary(summary: JsonField<Summary>) = apply { this.summary = summary }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Reasoning].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Reasoning =
+                Reasoning(
+                    context,
+                    effort,
+                    generateSummary,
+                    mode,
+                    summary,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Reasoning = apply {
+            if (validated) {
+                return@apply
+            }
+
+            context().ifPresent { it.validate() }
+            effort().ifPresent { it.validate() }
+            generateSummary().ifPresent { it.validate() }
+            mode()
+            summary().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (context.asKnown().getOrNull()?.validity() ?: 0) +
+                (effort.asKnown().getOrNull()?.validity() ?: 0) +
+                (generateSummary.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (mode.asKnown().isPresent) 1 else 0) +
+                (summary.asKnown().getOrNull()?.validity() ?: 0)
+
+        /**
+         * Controls which reasoning items are rendered back to the model on later turns. When
+         * returned on a response, this is the effective reasoning context mode used for the
+         * response.
+         */
+        class Context @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmField val CURRENT_TURN = of("current_turn")
+
+                @JvmField val ALL_TURNS = of("all_turns")
+
+                @JvmStatic fun of(value: String) = Context(JsonField.of(value))
+            }
+
+            /** An enum containing [Context]'s known values. */
+            enum class Known {
+                AUTO,
+                CURRENT_TURN,
+                ALL_TURNS,
+            }
+
+            /**
+             * An enum containing [Context]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Context] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                AUTO,
+                CURRENT_TURN,
+                ALL_TURNS,
+                /**
+                 * An enum member indicating that [Context] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    AUTO -> Value.AUTO
+                    CURRENT_TURN -> Value.CURRENT_TURN
+                    ALL_TURNS -> Value.ALL_TURNS
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    AUTO -> Known.AUTO
+                    CURRENT_TURN -> Known.CURRENT_TURN
+                    ALL_TURNS -> Known.ALL_TURNS
+                    else -> throw OpenAIInvalidDataException("Unknown Context: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Context = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Context && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
+         */
+        class Effort @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val NONE = of("none")
+
+                @JvmField val MINIMAL = of("minimal")
+
+                @JvmField val LOW = of("low")
+
+                @JvmField val MEDIUM = of("medium")
+
+                @JvmField val HIGH = of("high")
+
+                @JvmField val XHIGH = of("xhigh")
+
+                @JvmField val MAX = of("max")
+
+                @JvmStatic fun of(value: String) = Effort(JsonField.of(value))
+            }
+
+            /** An enum containing [Effort]'s known values. */
+            enum class Known {
+                NONE,
+                MINIMAL,
+                LOW,
+                MEDIUM,
+                HIGH,
+                XHIGH,
+                MAX,
+            }
+
+            /**
+             * An enum containing [Effort]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Effort] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                NONE,
+                MINIMAL,
+                LOW,
+                MEDIUM,
+                HIGH,
+                XHIGH,
+                MAX,
+                /**
+                 * An enum member indicating that [Effort] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    NONE -> Value.NONE
+                    MINIMAL -> Value.MINIMAL
+                    LOW -> Value.LOW
+                    MEDIUM -> Value.MEDIUM
+                    HIGH -> Value.HIGH
+                    XHIGH -> Value.XHIGH
+                    MAX -> Value.MAX
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    NONE -> Known.NONE
+                    MINIMAL -> Known.MINIMAL
+                    LOW -> Known.LOW
+                    MEDIUM -> Known.MEDIUM
+                    HIGH -> Known.HIGH
+                    XHIGH -> Known.XHIGH
+                    MAX -> Known.MAX
+                    else -> throw OpenAIInvalidDataException("Unknown Effort: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Effort = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Effort && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * **Deprecated:** use `summary` instead.
+         *
+         * A summary of the reasoning performed by the model. This can be useful for debugging and
+         * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
+         */
+        @Deprecated("deprecated")
+        class GenerateSummary
+        @JsonCreator
+        private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmField val CONCISE = of("concise")
+
+                @JvmField val DETAILED = of("detailed")
+
+                @JvmStatic fun of(value: String) = GenerateSummary(JsonField.of(value))
+            }
+
+            /** An enum containing [GenerateSummary]'s known values. */
+            enum class Known {
+                AUTO,
+                CONCISE,
+                DETAILED,
+            }
+
+            /**
+             * An enum containing [GenerateSummary]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [GenerateSummary] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                AUTO,
+                CONCISE,
+                DETAILED,
+                /**
+                 * An enum member indicating that [GenerateSummary] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    AUTO -> Value.AUTO
+                    CONCISE -> Value.CONCISE
+                    DETAILED -> Value.DETAILED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    AUTO -> Known.AUTO
+                    CONCISE -> Known.CONCISE
+                    DETAILED -> Known.DETAILED
+                    else -> throw OpenAIInvalidDataException("Unknown GenerateSummary: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): GenerateSummary = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is GenerateSummary && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * Controls the reasoning execution mode for the request.
+         *
+         * When returned on a response, this is the effective execution mode.
+         */
+        class Mode @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val STANDARD = of("standard")
+
+                @JvmField val PRO = of("pro")
+
+                @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+            }
+
+            /** An enum containing [Mode]'s known values. */
+            enum class Known {
+                STANDARD,
+                PRO,
+            }
+
+            /**
+             * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Mode] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                STANDARD,
+                PRO,
+                /** An enum member indicating that [Mode] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    STANDARD -> Value.STANDARD
+                    PRO -> Value.PRO
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    STANDARD -> Known.STANDARD
+                    PRO -> Known.PRO
+                    else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Mode = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Mode && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * A summary of the reasoning performed by the model. This can be useful for debugging and
+         * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
+         *
+         * `concise` is supported for `computer-use-preview` models and all reasoning models after
+         * `gpt-5`.
+         */
+        class Summary @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmField val CONCISE = of("concise")
+
+                @JvmField val DETAILED = of("detailed")
+
+                @JvmStatic fun of(value: String) = Summary(JsonField.of(value))
+            }
+
+            /** An enum containing [Summary]'s known values. */
+            enum class Known {
+                AUTO,
+                CONCISE,
+                DETAILED,
+            }
+
+            /**
+             * An enum containing [Summary]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Summary] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                AUTO,
+                CONCISE,
+                DETAILED,
+                /**
+                 * An enum member indicating that [Summary] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    AUTO -> Value.AUTO
+                    CONCISE -> Value.CONCISE
+                    DETAILED -> Value.DETAILED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    AUTO -> Known.AUTO
+                    CONCISE -> Known.CONCISE
+                    DETAILED -> Known.DETAILED
+                    else -> throw OpenAIInvalidDataException("Unknown Summary: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Summary = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Summary && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Reasoning &&
+                context == other.context &&
+                effort == other.effort &&
+                generateSummary == other.generateSummary &&
+                mode == other.mode &&
+                summary == other.summary &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(context, effort, generateSummary, mode, summary, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Reasoning{context=$context, effort=$effort, generateSummary=$generateSummary, mode=$mode, summary=$summary, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Specifies the processing type used for serving the request.
+     * - If set to 'auto', then the request will be processed with the service tier configured in
+     *   the Project settings. Unless otherwise configured, the Project will use 'default'.
+     * - If set to 'default', then the request will be processed with the standard pricing and
+     *   performance for the selected model.
+     * - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
+     *   '[priority](https://openai.com/api-priority-processing/)', then the request will be
+     *   processed with the corresponding service tier.
+     * - When not set, the default behavior is 'auto'.
+     *
+     *   When the `service_tier` parameter is set, the response body will include the `service_tier`
+     *   value based on the processing mode actually used to serve the request. This response value
+     *   may be different from the value set in the parameter.
+     */
+    class ServiceTier @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val AUTO = of("auto")
+
+            @JvmField val DEFAULT = of("default")
+
+            @JvmField val FLEX = of("flex")
+
+            @JvmField val SCALE = of("scale")
+
+            @JvmField val PRIORITY = of("priority")
+
+            @JvmStatic fun of(value: String) = ServiceTier(JsonField.of(value))
+        }
+
+        /** An enum containing [ServiceTier]'s known values. */
+        enum class Known {
+            AUTO,
+            DEFAULT,
+            FLEX,
+            SCALE,
+            PRIORITY,
+        }
+
+        /**
+         * An enum containing [ServiceTier]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [ServiceTier] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            AUTO,
+            DEFAULT,
+            FLEX,
+            SCALE,
+            PRIORITY,
+            /**
+             * An enum member indicating that [ServiceTier] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                AUTO -> Value.AUTO
+                DEFAULT -> Value.DEFAULT
+                FLEX -> Value.FLEX
+                SCALE -> Value.SCALE
+                PRIORITY -> Value.PRIORITY
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                AUTO -> Known.AUTO
+                DEFAULT -> Known.DEFAULT
+                FLEX -> Known.FLEX
+                SCALE -> Known.SCALE
+                PRIORITY -> Known.PRIORITY
+                else -> throw OpenAIInvalidDataException("Unknown ServiceTier: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ServiceTier = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ServiceTier && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /** Options for streaming responses. Only set this when you set `stream: true`. */
+    class StreamOptions
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val includeObfuscation: JsonField<Boolean>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("include_obfuscation")
+            @ExcludeMissing
+            includeObfuscation: JsonField<Boolean> = JsonMissing.of()
+        ) : this(includeObfuscation, mutableMapOf())
+
+        /**
+         * When true, stream obfuscation will be enabled. Stream obfuscation adds random characters
+         * to an `obfuscation` field on streaming delta events to normalize payload sizes as a
+         * mitigation to certain side-channel attacks. These obfuscation fields are included by
+         * default, but add a small amount of overhead to the data stream. You can set
+         * `include_obfuscation` to false to optimize for bandwidth if you trust the network links
+         * between your application and the OpenAI API.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun includeObfuscation(): Optional<Boolean> =
+            includeObfuscation.getOptional("include_obfuscation")
+
+        /**
+         * Returns the raw JSON value of [includeObfuscation].
+         *
+         * Unlike [includeObfuscation], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @JsonProperty("include_obfuscation")
+        @ExcludeMissing
+        fun _includeObfuscation(): JsonField<Boolean> = includeObfuscation
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [StreamOptions]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [StreamOptions]. */
+        class Builder internal constructor() {
+
+            private var includeObfuscation: JsonField<Boolean> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(streamOptions: StreamOptions) = apply {
+                includeObfuscation = streamOptions.includeObfuscation
+                additionalProperties = streamOptions.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * When true, stream obfuscation will be enabled. Stream obfuscation adds random
+             * characters to an `obfuscation` field on streaming delta events to normalize payload
+             * sizes as a mitigation to certain side-channel attacks. These obfuscation fields are
+             * included by default, but add a small amount of overhead to the data stream. You can
+             * set `include_obfuscation` to false to optimize for bandwidth if you trust the network
+             * links between your application and the OpenAI API.
+             */
+            fun includeObfuscation(includeObfuscation: Boolean) =
+                includeObfuscation(JsonField.of(includeObfuscation))
+
+            /**
+             * Sets [Builder.includeObfuscation] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.includeObfuscation] with a well-typed [Boolean]
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            fun includeObfuscation(includeObfuscation: JsonField<Boolean>) = apply {
+                this.includeObfuscation = includeObfuscation
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [StreamOptions].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): StreamOptions =
+                StreamOptions(includeObfuscation, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): StreamOptions = apply {
+            if (validated) {
+                return@apply
+            }
+
+            includeObfuscation()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = (if (includeObfuscation.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is StreamOptions &&
+                includeObfuscation == other.includeObfuscation &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(includeObfuscation, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "StreamOptions{includeObfuscation=$includeObfuscation, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * How the model should select which tool (or tools) to use when generating a response. See the
+     * `tools` parameter to see how to specify which tools the model can call.
+     */
+    @JsonDeserialize(using = ToolChoice.Deserializer::class)
+    @JsonSerialize(using = ToolChoice.Serializer::class)
+    class ToolChoice
+    private constructor(
+        private val betaToolChoiceOptions: BetaToolChoiceOptions? = null,
+        private val betaToolChoiceAllowed: BetaToolChoiceAllowed? = null,
+        private val betaToolChoiceTypes: BetaToolChoiceTypes? = null,
+        private val betaToolChoiceFunction: BetaToolChoiceFunction? = null,
+        private val betaToolChoiceMcp: BetaToolChoiceMcp? = null,
+        private val betaToolChoiceCustom: BetaToolChoiceCustom? = null,
+        private val betaSpecificProgrammaticToolCallingParam: JsonValue? = null,
+        private val betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch? = null,
+        private val betaToolChoiceShell: BetaToolChoiceShell? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /**
+         * Controls which (if any) tool is called by the model.
+         *
+         * `none` means the model will not call any tool and instead generates a message.
+         *
+         * `auto` means the model can pick between generating a message or calling one or more
+         * tools.
+         *
+         * `required` means the model must call one or more tools.
+         */
+        fun betaToolChoiceOptions(): Optional<BetaToolChoiceOptions> =
+            Optional.ofNullable(betaToolChoiceOptions)
+
+        /** Constrains the tools available to the model to a pre-defined set. */
+        fun betaToolChoiceAllowed(): Optional<BetaToolChoiceAllowed> =
+            Optional.ofNullable(betaToolChoiceAllowed)
+
+        /**
+         * Indicates that the model should use a built-in tool to generate a response.
+         * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+         */
+        fun betaToolChoiceTypes(): Optional<BetaToolChoiceTypes> =
+            Optional.ofNullable(betaToolChoiceTypes)
+
+        /** Use this option to force the model to call a specific function. */
+        fun betaToolChoiceFunction(): Optional<BetaToolChoiceFunction> =
+            Optional.ofNullable(betaToolChoiceFunction)
+
+        /** Use this option to force the model to call a specific tool on a remote MCP server. */
+        fun betaToolChoiceMcp(): Optional<BetaToolChoiceMcp> =
+            Optional.ofNullable(betaToolChoiceMcp)
+
+        /** Use this option to force the model to call a specific custom tool. */
+        fun betaToolChoiceCustom(): Optional<BetaToolChoiceCustom> =
+            Optional.ofNullable(betaToolChoiceCustom)
+
+        fun betaSpecificProgrammaticToolCallingParam(): Optional<JsonValue> =
+            Optional.ofNullable(betaSpecificProgrammaticToolCallingParam)
+
+        /** Forces the model to call the apply_patch tool when executing a tool call. */
+        fun betaToolChoiceApplyPatch(): Optional<BetaToolChoiceApplyPatch> =
+            Optional.ofNullable(betaToolChoiceApplyPatch)
+
+        /** Forces the model to call the shell tool when a tool call is required. */
+        fun betaToolChoiceShell(): Optional<BetaToolChoiceShell> =
+            Optional.ofNullable(betaToolChoiceShell)
+
+        fun isBetaToolChoiceOptions(): Boolean = betaToolChoiceOptions != null
+
+        fun isBetaToolChoiceAllowed(): Boolean = betaToolChoiceAllowed != null
+
+        fun isBetaToolChoiceTypes(): Boolean = betaToolChoiceTypes != null
+
+        fun isBetaToolChoiceFunction(): Boolean = betaToolChoiceFunction != null
+
+        fun isBetaToolChoiceMcp(): Boolean = betaToolChoiceMcp != null
+
+        fun isBetaToolChoiceCustom(): Boolean = betaToolChoiceCustom != null
+
+        fun isBetaSpecificProgrammaticToolCallingParam(): Boolean =
+            betaSpecificProgrammaticToolCallingParam != null
+
+        fun isBetaToolChoiceApplyPatch(): Boolean = betaToolChoiceApplyPatch != null
+
+        fun isBetaToolChoiceShell(): Boolean = betaToolChoiceShell != null
+
+        /**
+         * Controls which (if any) tool is called by the model.
+         *
+         * `none` means the model will not call any tool and instead generates a message.
+         *
+         * `auto` means the model can pick between generating a message or calling one or more
+         * tools.
+         *
+         * `required` means the model must call one or more tools.
+         */
+        fun asBetaToolChoiceOptions(): BetaToolChoiceOptions =
+            betaToolChoiceOptions.getOrThrow("betaToolChoiceOptions")
+
+        /** Constrains the tools available to the model to a pre-defined set. */
+        fun asBetaToolChoiceAllowed(): BetaToolChoiceAllowed =
+            betaToolChoiceAllowed.getOrThrow("betaToolChoiceAllowed")
+
+        /**
+         * Indicates that the model should use a built-in tool to generate a response.
+         * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+         */
+        fun asBetaToolChoiceTypes(): BetaToolChoiceTypes =
+            betaToolChoiceTypes.getOrThrow("betaToolChoiceTypes")
+
+        /** Use this option to force the model to call a specific function. */
+        fun asBetaToolChoiceFunction(): BetaToolChoiceFunction =
+            betaToolChoiceFunction.getOrThrow("betaToolChoiceFunction")
+
+        /** Use this option to force the model to call a specific tool on a remote MCP server. */
+        fun asBetaToolChoiceMcp(): BetaToolChoiceMcp =
+            betaToolChoiceMcp.getOrThrow("betaToolChoiceMcp")
+
+        /** Use this option to force the model to call a specific custom tool. */
+        fun asBetaToolChoiceCustom(): BetaToolChoiceCustom =
+            betaToolChoiceCustom.getOrThrow("betaToolChoiceCustom")
+
+        fun asBetaSpecificProgrammaticToolCallingParam(): JsonValue =
+            betaSpecificProgrammaticToolCallingParam.getOrThrow(
+                "betaSpecificProgrammaticToolCallingParam"
+            )
+
+        /** Forces the model to call the apply_patch tool when executing a tool call. */
+        fun asBetaToolChoiceApplyPatch(): BetaToolChoiceApplyPatch =
+            betaToolChoiceApplyPatch.getOrThrow("betaToolChoiceApplyPatch")
+
+        /** Forces the model to call the shell tool when a tool call is required. */
+        fun asBetaToolChoiceShell(): BetaToolChoiceShell =
+            betaToolChoiceShell.getOrThrow("betaToolChoiceShell")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = toolChoice.accept(new ToolChoice.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitBetaToolChoiceOptions(BetaToolChoiceOptions betaToolChoiceOptions) {
+         *         return Optional.of(betaToolChoiceOptions.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                betaToolChoiceOptions != null ->
+                    visitor.visitBetaToolChoiceOptions(betaToolChoiceOptions)
+                betaToolChoiceAllowed != null ->
+                    visitor.visitBetaToolChoiceAllowed(betaToolChoiceAllowed)
+                betaToolChoiceTypes != null -> visitor.visitBetaToolChoiceTypes(betaToolChoiceTypes)
+                betaToolChoiceFunction != null ->
+                    visitor.visitBetaToolChoiceFunction(betaToolChoiceFunction)
+                betaToolChoiceMcp != null -> visitor.visitBetaToolChoiceMcp(betaToolChoiceMcp)
+                betaToolChoiceCustom != null ->
+                    visitor.visitBetaToolChoiceCustom(betaToolChoiceCustom)
+                betaSpecificProgrammaticToolCallingParam != null ->
+                    visitor.visitBetaSpecificProgrammaticToolCallingParam(
+                        betaSpecificProgrammaticToolCallingParam
+                    )
+                betaToolChoiceApplyPatch != null ->
+                    visitor.visitBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch)
+                betaToolChoiceShell != null -> visitor.visitBetaToolChoiceShell(betaToolChoiceShell)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ToolChoice = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitBetaToolChoiceOptions(
+                        betaToolChoiceOptions: BetaToolChoiceOptions
+                    ) {
+                        betaToolChoiceOptions.validate()
+                    }
+
+                    override fun visitBetaToolChoiceAllowed(
+                        betaToolChoiceAllowed: BetaToolChoiceAllowed
+                    ) {
+                        betaToolChoiceAllowed.validate()
+                    }
+
+                    override fun visitBetaToolChoiceTypes(
+                        betaToolChoiceTypes: BetaToolChoiceTypes
+                    ) {
+                        betaToolChoiceTypes.validate()
+                    }
+
+                    override fun visitBetaToolChoiceFunction(
+                        betaToolChoiceFunction: BetaToolChoiceFunction
+                    ) {
+                        betaToolChoiceFunction.validate()
+                    }
+
+                    override fun visitBetaToolChoiceMcp(betaToolChoiceMcp: BetaToolChoiceMcp) {
+                        betaToolChoiceMcp.validate()
+                    }
+
+                    override fun visitBetaToolChoiceCustom(
+                        betaToolChoiceCustom: BetaToolChoiceCustom
+                    ) {
+                        betaToolChoiceCustom.validate()
+                    }
+
+                    override fun visitBetaSpecificProgrammaticToolCallingParam(
+                        betaSpecificProgrammaticToolCallingParam: JsonValue
+                    ) {
+                        betaSpecificProgrammaticToolCallingParam.let {
+                            if (
+                                it != JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                            ) {
+                                throw OpenAIInvalidDataException(
+                                    "'betaSpecificProgrammaticToolCallingParam' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitBetaToolChoiceApplyPatch(
+                        betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch
+                    ) {
+                        betaToolChoiceApplyPatch.validate()
+                    }
+
+                    override fun visitBetaToolChoiceShell(
+                        betaToolChoiceShell: BetaToolChoiceShell
+                    ) {
+                        betaToolChoiceShell.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitBetaToolChoiceOptions(
+                        betaToolChoiceOptions: BetaToolChoiceOptions
+                    ) = betaToolChoiceOptions.validity()
+
+                    override fun visitBetaToolChoiceAllowed(
+                        betaToolChoiceAllowed: BetaToolChoiceAllowed
+                    ) = betaToolChoiceAllowed.validity()
+
+                    override fun visitBetaToolChoiceTypes(
+                        betaToolChoiceTypes: BetaToolChoiceTypes
+                    ) = betaToolChoiceTypes.validity()
+
+                    override fun visitBetaToolChoiceFunction(
+                        betaToolChoiceFunction: BetaToolChoiceFunction
+                    ) = betaToolChoiceFunction.validity()
+
+                    override fun visitBetaToolChoiceMcp(betaToolChoiceMcp: BetaToolChoiceMcp) =
+                        betaToolChoiceMcp.validity()
+
+                    override fun visitBetaToolChoiceCustom(
+                        betaToolChoiceCustom: BetaToolChoiceCustom
+                    ) = betaToolChoiceCustom.validity()
+
+                    override fun visitBetaSpecificProgrammaticToolCallingParam(
+                        betaSpecificProgrammaticToolCallingParam: JsonValue
+                    ) =
+                        betaSpecificProgrammaticToolCallingParam.let {
+                            if (it == JsonValue.from(mapOf("type" to "programmatic_tool_calling")))
+                                1
+                            else 0
+                        }
+
+                    override fun visitBetaToolChoiceApplyPatch(
+                        betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch
+                    ) = betaToolChoiceApplyPatch.validity()
+
+                    override fun visitBetaToolChoiceShell(
+                        betaToolChoiceShell: BetaToolChoiceShell
+                    ) = betaToolChoiceShell.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ToolChoice &&
+                betaToolChoiceOptions == other.betaToolChoiceOptions &&
+                betaToolChoiceAllowed == other.betaToolChoiceAllowed &&
+                betaToolChoiceTypes == other.betaToolChoiceTypes &&
+                betaToolChoiceFunction == other.betaToolChoiceFunction &&
+                betaToolChoiceMcp == other.betaToolChoiceMcp &&
+                betaToolChoiceCustom == other.betaToolChoiceCustom &&
+                betaSpecificProgrammaticToolCallingParam ==
+                    other.betaSpecificProgrammaticToolCallingParam &&
+                betaToolChoiceApplyPatch == other.betaToolChoiceApplyPatch &&
+                betaToolChoiceShell == other.betaToolChoiceShell
+        }
+
+        override fun hashCode(): Int =
+            Objects.hash(
+                betaToolChoiceOptions,
+                betaToolChoiceAllowed,
+                betaToolChoiceTypes,
+                betaToolChoiceFunction,
+                betaToolChoiceMcp,
+                betaToolChoiceCustom,
+                betaSpecificProgrammaticToolCallingParam,
+                betaToolChoiceApplyPatch,
+                betaToolChoiceShell,
+            )
+
+        override fun toString(): String =
+            when {
+                betaToolChoiceOptions != null ->
+                    "ToolChoice{betaToolChoiceOptions=$betaToolChoiceOptions}"
+                betaToolChoiceAllowed != null ->
+                    "ToolChoice{betaToolChoiceAllowed=$betaToolChoiceAllowed}"
+                betaToolChoiceTypes != null ->
+                    "ToolChoice{betaToolChoiceTypes=$betaToolChoiceTypes}"
+                betaToolChoiceFunction != null ->
+                    "ToolChoice{betaToolChoiceFunction=$betaToolChoiceFunction}"
+                betaToolChoiceMcp != null -> "ToolChoice{betaToolChoiceMcp=$betaToolChoiceMcp}"
+                betaToolChoiceCustom != null ->
+                    "ToolChoice{betaToolChoiceCustom=$betaToolChoiceCustom}"
+                betaSpecificProgrammaticToolCallingParam != null ->
+                    "ToolChoice{betaSpecificProgrammaticToolCallingParam=$betaSpecificProgrammaticToolCallingParam}"
+                betaToolChoiceApplyPatch != null ->
+                    "ToolChoice{betaToolChoiceApplyPatch=$betaToolChoiceApplyPatch}"
+                betaToolChoiceShell != null ->
+                    "ToolChoice{betaToolChoiceShell=$betaToolChoiceShell}"
+                _json != null -> "ToolChoice{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid ToolChoice")
+            }
+
+        companion object {
+
+            /**
+             * Controls which (if any) tool is called by the model.
+             *
+             * `none` means the model will not call any tool and instead generates a message.
+             *
+             * `auto` means the model can pick between generating a message or calling one or more
+             * tools.
+             *
+             * `required` means the model must call one or more tools.
+             */
+            @JvmStatic
+            fun ofBetaToolChoiceOptions(betaToolChoiceOptions: BetaToolChoiceOptions) =
+                ToolChoice(betaToolChoiceOptions = betaToolChoiceOptions)
+
+            /** Constrains the tools available to the model to a pre-defined set. */
+            @JvmStatic
+            fun ofBetaToolChoiceAllowed(betaToolChoiceAllowed: BetaToolChoiceAllowed) =
+                ToolChoice(betaToolChoiceAllowed = betaToolChoiceAllowed)
+
+            /**
+             * Indicates that the model should use a built-in tool to generate a response.
+             * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+             */
+            @JvmStatic
+            fun ofBetaToolChoiceTypes(betaToolChoiceTypes: BetaToolChoiceTypes) =
+                ToolChoice(betaToolChoiceTypes = betaToolChoiceTypes)
+
+            /** Use this option to force the model to call a specific function. */
+            @JvmStatic
+            fun ofBetaToolChoiceFunction(betaToolChoiceFunction: BetaToolChoiceFunction) =
+                ToolChoice(betaToolChoiceFunction = betaToolChoiceFunction)
+
+            /**
+             * Use this option to force the model to call a specific tool on a remote MCP server.
+             */
+            @JvmStatic
+            fun ofBetaToolChoiceMcp(betaToolChoiceMcp: BetaToolChoiceMcp) =
+                ToolChoice(betaToolChoiceMcp = betaToolChoiceMcp)
+
+            /** Use this option to force the model to call a specific custom tool. */
+            @JvmStatic
+            fun ofBetaToolChoiceCustom(betaToolChoiceCustom: BetaToolChoiceCustom) =
+                ToolChoice(betaToolChoiceCustom = betaToolChoiceCustom)
+
+            @JvmStatic
+            fun ofBetaSpecificProgrammaticToolCallingParam() =
+                ToolChoice(
+                    betaSpecificProgrammaticToolCallingParam =
+                        JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                )
+
+            /** Forces the model to call the apply_patch tool when executing a tool call. */
+            @JvmStatic
+            fun ofBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch) =
+                ToolChoice(betaToolChoiceApplyPatch = betaToolChoiceApplyPatch)
+
+            /** Forces the model to call the shell tool when a tool call is required. */
+            @JvmStatic
+            fun ofBetaToolChoiceShell(betaToolChoiceShell: BetaToolChoiceShell) =
+                ToolChoice(betaToolChoiceShell = betaToolChoiceShell)
+        }
+
+        /**
+         * An interface that defines how to map each variant of [ToolChoice] to a value of type [T].
+         */
+        interface Visitor<out T> {
+
+            /**
+             * Controls which (if any) tool is called by the model.
+             *
+             * `none` means the model will not call any tool and instead generates a message.
+             *
+             * `auto` means the model can pick between generating a message or calling one or more
+             * tools.
+             *
+             * `required` means the model must call one or more tools.
+             */
+            fun visitBetaToolChoiceOptions(betaToolChoiceOptions: BetaToolChoiceOptions): T
+
+            /** Constrains the tools available to the model to a pre-defined set. */
+            fun visitBetaToolChoiceAllowed(betaToolChoiceAllowed: BetaToolChoiceAllowed): T
+
+            /**
+             * Indicates that the model should use a built-in tool to generate a response.
+             * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+             */
+            fun visitBetaToolChoiceTypes(betaToolChoiceTypes: BetaToolChoiceTypes): T
+
+            /** Use this option to force the model to call a specific function. */
+            fun visitBetaToolChoiceFunction(betaToolChoiceFunction: BetaToolChoiceFunction): T
+
+            /**
+             * Use this option to force the model to call a specific tool on a remote MCP server.
+             */
+            fun visitBetaToolChoiceMcp(betaToolChoiceMcp: BetaToolChoiceMcp): T
+
+            /** Use this option to force the model to call a specific custom tool. */
+            fun visitBetaToolChoiceCustom(betaToolChoiceCustom: BetaToolChoiceCustom): T
+
+            fun visitBetaSpecificProgrammaticToolCallingParam(
+                betaSpecificProgrammaticToolCallingParam: JsonValue
+            ): T
+
+            /** Forces the model to call the apply_patch tool when executing a tool call. */
+            fun visitBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch): T
+
+            /** Forces the model to call the shell tool when a tool call is required. */
+            fun visitBetaToolChoiceShell(betaToolChoiceShell: BetaToolChoiceShell): T
+
+            /**
+             * Maps an unknown variant of [ToolChoice] to a value of type [T].
+             *
+             * An instance of [ToolChoice] can contain an unknown variant if it was deserialized
+             * from data that doesn't match any known variant. For example, if the SDK is on an
+             * older version than the API, then the API may respond with new variants that the SDK
+             * is unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown ToolChoice: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<ToolChoice>(ToolChoice::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): ToolChoice {
+                val json = JsonValue.fromJsonNode(node)
+
+                val bestMatches =
+                    sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let {
+                                    ToolChoice(
+                                        betaSpecificProgrammaticToolCallingParam = it,
+                                        _json = json,
+                                    )
+                                }
+                                ?.takeIf { it.isValid() },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceOptions>())?.let {
+                                ToolChoice(betaToolChoiceOptions = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceAllowed>())?.let {
+                                ToolChoice(betaToolChoiceAllowed = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceTypes>())?.let {
+                                ToolChoice(betaToolChoiceTypes = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceFunction>())?.let {
+                                ToolChoice(betaToolChoiceFunction = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceMcp>())?.let {
+                                ToolChoice(betaToolChoiceMcp = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceCustom>())?.let {
+                                ToolChoice(betaToolChoiceCustom = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceApplyPatch>())?.let {
+                                ToolChoice(betaToolChoiceApplyPatch = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceShell>())?.let {
+                                ToolChoice(betaToolChoiceShell = it, _json = json)
+                            },
+                        )
+                        .filterNotNull()
+                        .allMaxBy { it.validity() }
+                        .toList()
+                return when (bestMatches.size) {
+                    // This can happen if what we're deserializing is completely incompatible with
+                    // all the possible variants (e.g. deserializing from boolean).
+                    0 -> ToolChoice(_json = json)
+                    1 -> bestMatches.single()
+                    // If there's more than one match with the highest validity, then use the first
+                    // completely valid match, or simply the first match if none are completely
+                    // valid.
+                    else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                }
+            }
+        }
+
+        internal class Serializer : BaseSerializer<ToolChoice>(ToolChoice::class) {
+
+            override fun serialize(
+                value: ToolChoice,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.betaToolChoiceOptions != null ->
+                        generator.writeObject(value.betaToolChoiceOptions)
+                    value.betaToolChoiceAllowed != null ->
+                        generator.writeObject(value.betaToolChoiceAllowed)
+                    value.betaToolChoiceTypes != null ->
+                        generator.writeObject(value.betaToolChoiceTypes)
+                    value.betaToolChoiceFunction != null ->
+                        generator.writeObject(value.betaToolChoiceFunction)
+                    value.betaToolChoiceMcp != null ->
+                        generator.writeObject(value.betaToolChoiceMcp)
+                    value.betaToolChoiceCustom != null ->
+                        generator.writeObject(value.betaToolChoiceCustom)
+                    value.betaSpecificProgrammaticToolCallingParam != null ->
+                        generator.writeObject(value.betaSpecificProgrammaticToolCallingParam)
+                    value.betaToolChoiceApplyPatch != null ->
+                        generator.writeObject(value.betaToolChoiceApplyPatch)
+                    value.betaToolChoiceShell != null ->
+                        generator.writeObject(value.betaToolChoiceShell)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid ToolChoice")
+                }
+            }
+        }
+    }
+
+    /**
+     * The truncation strategy to use for the model response.
+     * - `auto`: If the input to this Response exceeds the model's context window size, the model
+     *   will truncate the response to fit the context window by dropping items from the beginning
+     *   of the conversation.
+     * - `disabled` (default): If the input size will exceed the context window size for a model,
+     *   the request will fail with a 400 error.
+     */
+    @Deprecated("deprecated")
+    class Truncation @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val AUTO = of("auto")
+
+            @JvmField val DISABLED = of("disabled")
+
+            @JvmStatic fun of(value: String) = Truncation(JsonField.of(value))
+        }
+
+        /** An enum containing [Truncation]'s known values. */
+        enum class Known {
+            AUTO,
+            DISABLED,
+        }
+
+        /**
+         * An enum containing [Truncation]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Truncation] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            AUTO,
+            DISABLED,
+            /**
+             * An enum member indicating that [Truncation] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                AUTO -> Value.AUTO
+                DISABLED -> Value.DISABLED
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                AUTO -> Known.AUTO
+                DISABLED -> Known.DISABLED
+                else -> throw OpenAIInvalidDataException("Unknown Truncation: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Truncation = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Truncation && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    class Beta @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val RESPONSES_MULTI_AGENT_V1 = of("responses_multi_agent=v1")
+
+            @JvmStatic fun of(value: String) = Beta(JsonField.of(value))
+        }
+
+        /** An enum containing [Beta]'s known values. */
+        enum class Known {
+            RESPONSES_MULTI_AGENT_V1
+        }
+
+        /**
+         * An enum containing [Beta]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Beta] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            RESPONSES_MULTI_AGENT_V1,
+            /** An enum member indicating that [Beta] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                RESPONSES_MULTI_AGENT_V1 -> Value.RESPONSES_MULTI_AGENT_V1
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                RESPONSES_MULTI_AGENT_V1 -> Known.RESPONSES_MULTI_AGENT_V1
+                else -> throw OpenAIInvalidDataException("Unknown Beta: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Beta = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Beta && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ResponseCreateParams &&
+            betas == other.betas &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(betas, body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "ResponseCreateParams{betas=$betas, body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseDeleteParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseDeleteParams.kt
new file mode 100644
index 000000000..b6e5c095b
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseDeleteParams.kt
@@ -0,0 +1,392 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.openai.core.Enum
+import com.openai.core.JsonField
+import com.openai.core.JsonValue
+import com.openai.core.Params
+import com.openai.core.http.Headers
+import com.openai.core.http.QueryParams
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Deletes a model response with the given ID. */
+class ResponseDeleteParams
+private constructor(
+    private val responseId: String?,
+    private val betas: List<Beta>?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+    private val additionalBodyProperties: Map<String, JsonValue>,
+) : Params {
+
+    fun responseId(): Optional<String> = Optional.ofNullable(responseId)
+
+    fun betas(): Optional<List<Beta>> = Optional.ofNullable(betas)
+
+    /** Additional body properties to send with the request. */
+    fun _additionalBodyProperties(): Map<String, JsonValue> = additionalBodyProperties
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): ResponseDeleteParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [ResponseDeleteParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ResponseDeleteParams]. */
+    class Builder internal constructor() {
+
+        private var responseId: String? = null
+        private var betas: MutableList<Beta>? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+        private var additionalBodyProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(responseDeleteParams: ResponseDeleteParams) = apply {
+            responseId = responseDeleteParams.responseId
+            betas = responseDeleteParams.betas?.toMutableList()
+            additionalHeaders = responseDeleteParams.additionalHeaders.toBuilder()
+            additionalQueryParams = responseDeleteParams.additionalQueryParams.toBuilder()
+            additionalBodyProperties = responseDeleteParams.additionalBodyProperties.toMutableMap()
+        }
+
+        fun responseId(responseId: String?) = apply { this.responseId = responseId }
+
+        /** Alias for calling [Builder.responseId] with `responseId.orElse(null)`. */
+        fun responseId(responseId: Optional<String>) = responseId(responseId.getOrNull())
+
+        fun betas(betas: List<Beta>?) = apply { this.betas = betas?.toMutableList() }
+
+        /** Alias for calling [Builder.betas] with `betas.orElse(null)`. */
+        fun betas(betas: Optional<List<Beta>>) = betas(betas.getOrNull())
+
+        /**
+         * Adds a single [Beta] to [betas].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addBeta(beta: Beta) = apply { betas = (betas ?: mutableListOf()).apply { add(beta) } }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            this.additionalBodyProperties.clear()
+            putAllAdditionalBodyProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            additionalBodyProperties.put(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                this.additionalBodyProperties.putAll(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply {
+            additionalBodyProperties.remove(key)
+        }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalBodyProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [ResponseDeleteParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ResponseDeleteParams =
+            ResponseDeleteParams(
+                responseId,
+                betas?.toImmutable(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+                additionalBodyProperties.toImmutable(),
+            )
+    }
+
+    fun _body(): Optional<Map<String, JsonValue>> =
+        Optional.ofNullable(additionalBodyProperties.ifEmpty { null })
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> responseId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers =
+        Headers.builder()
+            .apply {
+                betas?.forEach { put("openai-beta", it.toString()) }
+                putAll(additionalHeaders)
+            }
+            .build()
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Beta @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val RESPONSES_MULTI_AGENT_V1 = of("responses_multi_agent=v1")
+
+            @JvmStatic fun of(value: String) = Beta(JsonField.of(value))
+        }
+
+        /** An enum containing [Beta]'s known values. */
+        enum class Known {
+            RESPONSES_MULTI_AGENT_V1
+        }
+
+        /**
+         * An enum containing [Beta]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Beta] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            RESPONSES_MULTI_AGENT_V1,
+            /** An enum member indicating that [Beta] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                RESPONSES_MULTI_AGENT_V1 -> Value.RESPONSES_MULTI_AGENT_V1
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                RESPONSES_MULTI_AGENT_V1 -> Known.RESPONSES_MULTI_AGENT_V1
+                else -> throw OpenAIInvalidDataException("Unknown Beta: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Beta = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Beta && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ResponseDeleteParams &&
+            responseId == other.responseId &&
+            betas == other.betas &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams &&
+            additionalBodyProperties == other.additionalBodyProperties
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(
+            responseId,
+            betas,
+            additionalHeaders,
+            additionalQueryParams,
+            additionalBodyProperties,
+        )
+
+    override fun toString() =
+        "ResponseDeleteParams{responseId=$responseId, betas=$betas, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams, additionalBodyProperties=$additionalBodyProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseRetrieveParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseRetrieveParams.kt
new file mode 100644
index 000000000..945041d06
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/ResponseRetrieveParams.kt
@@ -0,0 +1,461 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.openai.core.Enum
+import com.openai.core.JsonField
+import com.openai.core.Params
+import com.openai.core.http.Headers
+import com.openai.core.http.QueryParams
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Retrieves a model response with the given ID. */
+class ResponseRetrieveParams
+private constructor(
+    private val responseId: String?,
+    private val include: List<BetaResponseIncludable>?,
+    private val includeObfuscation: Boolean?,
+    private val startingAfter: Long?,
+    private val betas: List<Beta>?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun responseId(): Optional<String> = Optional.ofNullable(responseId)
+
+    /**
+     * Additional fields to include in the response. See the `include` parameter for Response
+     * creation above for more information.
+     */
+    fun include(): Optional<List<BetaResponseIncludable>> = Optional.ofNullable(include)
+
+    /**
+     * When true, stream obfuscation will be enabled. Stream obfuscation adds random characters to
+     * an `obfuscation` field on streaming delta events to normalize payload sizes as a mitigation
+     * to certain side-channel attacks. These obfuscation fields are included by default, but add a
+     * small amount of overhead to the data stream. You can set `include_obfuscation` to false to
+     * optimize for bandwidth if you trust the network links between your application and the OpenAI
+     * API.
+     */
+    fun includeObfuscation(): Optional<Boolean> = Optional.ofNullable(includeObfuscation)
+
+    /** The sequence number of the event after which to start streaming. */
+    fun startingAfter(): Optional<Long> = Optional.ofNullable(startingAfter)
+
+    fun betas(): Optional<List<Beta>> = Optional.ofNullable(betas)
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): ResponseRetrieveParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [ResponseRetrieveParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [ResponseRetrieveParams]. */
+    class Builder internal constructor() {
+
+        private var responseId: String? = null
+        private var include: MutableList<BetaResponseIncludable>? = null
+        private var includeObfuscation: Boolean? = null
+        private var startingAfter: Long? = null
+        private var betas: MutableList<Beta>? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(responseRetrieveParams: ResponseRetrieveParams) = apply {
+            responseId = responseRetrieveParams.responseId
+            include = responseRetrieveParams.include?.toMutableList()
+            includeObfuscation = responseRetrieveParams.includeObfuscation
+            startingAfter = responseRetrieveParams.startingAfter
+            betas = responseRetrieveParams.betas?.toMutableList()
+            additionalHeaders = responseRetrieveParams.additionalHeaders.toBuilder()
+            additionalQueryParams = responseRetrieveParams.additionalQueryParams.toBuilder()
+        }
+
+        fun responseId(responseId: String?) = apply { this.responseId = responseId }
+
+        /** Alias for calling [Builder.responseId] with `responseId.orElse(null)`. */
+        fun responseId(responseId: Optional<String>) = responseId(responseId.getOrNull())
+
+        /**
+         * Additional fields to include in the response. See the `include` parameter for Response
+         * creation above for more information.
+         */
+        fun include(include: List<BetaResponseIncludable>?) = apply {
+            this.include = include?.toMutableList()
+        }
+
+        /** Alias for calling [Builder.include] with `include.orElse(null)`. */
+        fun include(include: Optional<List<BetaResponseIncludable>>) = include(include.getOrNull())
+
+        /**
+         * Adds a single [BetaResponseIncludable] to [Builder.include].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addInclude(include: BetaResponseIncludable) = apply {
+            this.include = (this.include ?: mutableListOf()).apply { add(include) }
+        }
+
+        /**
+         * When true, stream obfuscation will be enabled. Stream obfuscation adds random characters
+         * to an `obfuscation` field on streaming delta events to normalize payload sizes as a
+         * mitigation to certain side-channel attacks. These obfuscation fields are included by
+         * default, but add a small amount of overhead to the data stream. You can set
+         * `include_obfuscation` to false to optimize for bandwidth if you trust the network links
+         * between your application and the OpenAI API.
+         */
+        fun includeObfuscation(includeObfuscation: Boolean?) = apply {
+            this.includeObfuscation = includeObfuscation
+        }
+
+        /**
+         * Alias for [Builder.includeObfuscation].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun includeObfuscation(includeObfuscation: Boolean) =
+            includeObfuscation(includeObfuscation as Boolean?)
+
+        /**
+         * Alias for calling [Builder.includeObfuscation] with `includeObfuscation.orElse(null)`.
+         */
+        fun includeObfuscation(includeObfuscation: Optional<Boolean>) =
+            includeObfuscation(includeObfuscation.getOrNull())
+
+        /** The sequence number of the event after which to start streaming. */
+        fun startingAfter(startingAfter: Long?) = apply { this.startingAfter = startingAfter }
+
+        /**
+         * Alias for [Builder.startingAfter].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun startingAfter(startingAfter: Long) = startingAfter(startingAfter as Long?)
+
+        /** Alias for calling [Builder.startingAfter] with `startingAfter.orElse(null)`. */
+        fun startingAfter(startingAfter: Optional<Long>) = startingAfter(startingAfter.getOrNull())
+
+        fun betas(betas: List<Beta>?) = apply { this.betas = betas?.toMutableList() }
+
+        /** Alias for calling [Builder.betas] with `betas.orElse(null)`. */
+        fun betas(betas: Optional<List<Beta>>) = betas(betas.getOrNull())
+
+        /**
+         * Adds a single [Beta] to [betas].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addBeta(beta: Beta) = apply { betas = (betas ?: mutableListOf()).apply { add(beta) } }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [ResponseRetrieveParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): ResponseRetrieveParams =
+            ResponseRetrieveParams(
+                responseId,
+                include?.toImmutable(),
+                includeObfuscation,
+                startingAfter,
+                betas?.toImmutable(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> responseId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers =
+        Headers.builder()
+            .apply {
+                betas?.forEach { put("openai-beta", it.toString()) }
+                putAll(additionalHeaders)
+            }
+            .build()
+
+    override fun _queryParams(): QueryParams =
+        QueryParams.builder()
+            .apply {
+                include?.forEach { put("include[]", it.toString()) }
+                includeObfuscation?.let { put("include_obfuscation", it.toString()) }
+                startingAfter?.let { put("starting_after", it.toString()) }
+                putAll(additionalQueryParams)
+            }
+            .build()
+
+    class Beta @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val RESPONSES_MULTI_AGENT_V1 = of("responses_multi_agent=v1")
+
+            @JvmStatic fun of(value: String) = Beta(JsonField.of(value))
+        }
+
+        /** An enum containing [Beta]'s known values. */
+        enum class Known {
+            RESPONSES_MULTI_AGENT_V1
+        }
+
+        /**
+         * An enum containing [Beta]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Beta] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            RESPONSES_MULTI_AGENT_V1,
+            /** An enum member indicating that [Beta] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                RESPONSES_MULTI_AGENT_V1 -> Value.RESPONSES_MULTI_AGENT_V1
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                RESPONSES_MULTI_AGENT_V1 -> Known.RESPONSES_MULTI_AGENT_V1
+                else -> throw OpenAIInvalidDataException("Unknown Beta: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Beta = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Beta && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is ResponseRetrieveParams &&
+            responseId == other.responseId &&
+            include == other.include &&
+            includeObfuscation == other.includeObfuscation &&
+            startingAfter == other.startingAfter &&
+            betas == other.betas &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(
+            responseId,
+            include,
+            includeObfuscation,
+            startingAfter,
+            betas,
+            additionalHeaders,
+            additionalQueryParams,
+        )
+
+    override fun toString() =
+        "ResponseRetrieveParams{responseId=$responseId, include=$include, includeObfuscation=$includeObfuscation, startingAfter=$startingAfter, betas=$betas, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputitems/BetaResponseItemList.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputitems/BetaResponseItemList.kt
new file mode 100644
index 000000000..7f38979d8
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputitems/BetaResponseItemList.kt
@@ -0,0 +1,543 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses.inputitems
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.checkRequired
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import com.openai.models.beta.responses.BetaResponseApplyPatchToolCall
+import com.openai.models.beta.responses.BetaResponseApplyPatchToolCallOutput
+import com.openai.models.beta.responses.BetaResponseCodeInterpreterToolCall
+import com.openai.models.beta.responses.BetaResponseCompactionItem
+import com.openai.models.beta.responses.BetaResponseComputerToolCall
+import com.openai.models.beta.responses.BetaResponseComputerToolCallOutputItem
+import com.openai.models.beta.responses.BetaResponseCustomToolCallItem
+import com.openai.models.beta.responses.BetaResponseCustomToolCallOutputItem
+import com.openai.models.beta.responses.BetaResponseFileSearchToolCall
+import com.openai.models.beta.responses.BetaResponseFunctionShellToolCall
+import com.openai.models.beta.responses.BetaResponseFunctionShellToolCallOutput
+import com.openai.models.beta.responses.BetaResponseFunctionToolCallItem
+import com.openai.models.beta.responses.BetaResponseFunctionToolCallOutputItem
+import com.openai.models.beta.responses.BetaResponseFunctionWebSearch
+import com.openai.models.beta.responses.BetaResponseInputMessageItem
+import com.openai.models.beta.responses.BetaResponseItem
+import com.openai.models.beta.responses.BetaResponseOutputMessage
+import com.openai.models.beta.responses.BetaResponseReasoningItem
+import com.openai.models.beta.responses.BetaResponseToolSearchCall
+import com.openai.models.beta.responses.BetaResponseToolSearchOutputItem
+import java.util.Collections
+import java.util.Objects
+import kotlin.jvm.optionals.getOrNull
+
+/** A list of Response items. */
+class BetaResponseItemList
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val data: JsonField<List<BetaResponseItem>>,
+    private val firstId: JsonField<String>,
+    private val hasMore: JsonField<Boolean>,
+    private val lastId: JsonField<String>,
+    private val object_: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("data")
+        @ExcludeMissing
+        data: JsonField<List<BetaResponseItem>> = JsonMissing.of(),
+        @JsonProperty("first_id") @ExcludeMissing firstId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("has_more") @ExcludeMissing hasMore: JsonField<Boolean> = JsonMissing.of(),
+        @JsonProperty("last_id") @ExcludeMissing lastId: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("object") @ExcludeMissing object_: JsonValue = JsonMissing.of(),
+    ) : this(data, firstId, hasMore, lastId, object_, mutableMapOf())
+
+    /**
+     * A list of items used to generate this response.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun data(): List<BetaResponseItem> = data.getRequired("data")
+
+    /**
+     * The ID of the first item in the list.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun firstId(): String = firstId.getRequired("first_id")
+
+    /**
+     * Whether there are more items available.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun hasMore(): Boolean = hasMore.getRequired("has_more")
+
+    /**
+     * The ID of the last item in the list.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun lastId(): String = lastId.getRequired("last_id")
+
+    /**
+     * The type of object returned, must be `list`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("list")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("object") @ExcludeMissing fun _object_(): JsonValue = object_
+
+    /**
+     * Returns the raw JSON value of [data].
+     *
+     * Unlike [data], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("data") @ExcludeMissing fun _data(): JsonField<List<BetaResponseItem>> = data
+
+    /**
+     * Returns the raw JSON value of [firstId].
+     *
+     * Unlike [firstId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("first_id") @ExcludeMissing fun _firstId(): JsonField<String> = firstId
+
+    /**
+     * Returns the raw JSON value of [hasMore].
+     *
+     * Unlike [hasMore], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("has_more") @ExcludeMissing fun _hasMore(): JsonField<Boolean> = hasMore
+
+    /**
+     * Returns the raw JSON value of [lastId].
+     *
+     * Unlike [lastId], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("last_id") @ExcludeMissing fun _lastId(): JsonField<String> = lastId
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [BetaResponseItemList].
+         *
+         * The following fields are required:
+         * ```java
+         * .data()
+         * .firstId()
+         * .hasMore()
+         * .lastId()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [BetaResponseItemList]. */
+    class Builder internal constructor() {
+
+        private var data: JsonField<MutableList<BetaResponseItem>>? = null
+        private var firstId: JsonField<String>? = null
+        private var hasMore: JsonField<Boolean>? = null
+        private var lastId: JsonField<String>? = null
+        private var object_: JsonValue = JsonValue.from("list")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(betaResponseItemList: BetaResponseItemList) = apply {
+            data = betaResponseItemList.data.map { it.toMutableList() }
+            firstId = betaResponseItemList.firstId
+            hasMore = betaResponseItemList.hasMore
+            lastId = betaResponseItemList.lastId
+            object_ = betaResponseItemList.object_
+            additionalProperties = betaResponseItemList.additionalProperties.toMutableMap()
+        }
+
+        /** A list of items used to generate this response. */
+        fun data(data: List<BetaResponseItem>) = data(JsonField.of(data))
+
+        /**
+         * Sets [Builder.data] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.data] with a well-typed `List<BetaResponseItem>` value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun data(data: JsonField<List<BetaResponseItem>>) = apply {
+            this.data = data.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [BetaResponseItem] to [Builder.data].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addData(data: BetaResponseItem) = apply {
+            this.data =
+                (this.data ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("data", it).add(data)
+                }
+        }
+
+        /**
+         * Alias for calling [addData] with
+         * `BetaResponseItem.ofBetaResponseInputMessageItem(betaResponseInputMessageItem)`.
+         */
+        fun addData(betaResponseInputMessageItem: BetaResponseInputMessageItem) =
+            addData(BetaResponseItem.ofBetaResponseInputMessageItem(betaResponseInputMessageItem))
+
+        /**
+         * Alias for calling [addData] with
+         * `BetaResponseItem.ofBetaResponseOutputMessage(betaResponseOutputMessage)`.
+         */
+        fun addData(betaResponseOutputMessage: BetaResponseOutputMessage) =
+            addData(BetaResponseItem.ofBetaResponseOutputMessage(betaResponseOutputMessage))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofFileSearchCall(fileSearchCall)`. */
+        fun addData(fileSearchCall: BetaResponseFileSearchToolCall) =
+            addData(BetaResponseItem.ofFileSearchCall(fileSearchCall))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofComputerCall(computerCall)`. */
+        fun addData(computerCall: BetaResponseComputerToolCall) =
+            addData(BetaResponseItem.ofComputerCall(computerCall))
+
+        /**
+         * Alias for calling [addData] with
+         * `BetaResponseItem.ofComputerCallOutput(computerCallOutput)`.
+         */
+        fun addData(computerCallOutput: BetaResponseComputerToolCallOutputItem) =
+            addData(BetaResponseItem.ofComputerCallOutput(computerCallOutput))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofWebSearchCall(webSearchCall)`. */
+        fun addData(webSearchCall: BetaResponseFunctionWebSearch) =
+            addData(BetaResponseItem.ofWebSearchCall(webSearchCall))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofFunctionCall(functionCall)`. */
+        fun addData(functionCall: BetaResponseFunctionToolCallItem) =
+            addData(BetaResponseItem.ofFunctionCall(functionCall))
+
+        /**
+         * Alias for calling [addData] with
+         * `BetaResponseItem.ofFunctionCallOutput(functionCallOutput)`.
+         */
+        fun addData(functionCallOutput: BetaResponseFunctionToolCallOutputItem) =
+            addData(BetaResponseItem.ofFunctionCallOutput(functionCallOutput))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofAgentMessage(agentMessage)`. */
+        fun addData(agentMessage: BetaResponseItem.AgentMessage) =
+            addData(BetaResponseItem.ofAgentMessage(agentMessage))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofMultiAgentCall(multiAgentCall)`. */
+        fun addData(multiAgentCall: BetaResponseItem.MultiAgentCall) =
+            addData(BetaResponseItem.ofMultiAgentCall(multiAgentCall))
+
+        /**
+         * Alias for calling [addData] with
+         * `BetaResponseItem.ofMultiAgentCallOutput(multiAgentCallOutput)`.
+         */
+        fun addData(multiAgentCallOutput: BetaResponseItem.MultiAgentCallOutput) =
+            addData(BetaResponseItem.ofMultiAgentCallOutput(multiAgentCallOutput))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofToolSearchCall(toolSearchCall)`. */
+        fun addData(toolSearchCall: BetaResponseToolSearchCall) =
+            addData(BetaResponseItem.ofToolSearchCall(toolSearchCall))
+
+        /**
+         * Alias for calling [addData] with `BetaResponseItem.ofToolSearchOutput(toolSearchOutput)`.
+         */
+        fun addData(toolSearchOutput: BetaResponseToolSearchOutputItem) =
+            addData(BetaResponseItem.ofToolSearchOutput(toolSearchOutput))
+
+        /**
+         * Alias for calling [addData] with `BetaResponseItem.ofAdditionalTools(additionalTools)`.
+         */
+        fun addData(additionalTools: BetaResponseItem.AdditionalTools) =
+            addData(BetaResponseItem.ofAdditionalTools(additionalTools))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofReasoning(reasoning)`. */
+        fun addData(reasoning: BetaResponseReasoningItem) =
+            addData(BetaResponseItem.ofReasoning(reasoning))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofProgram(program)`. */
+        fun addData(program: BetaResponseItem.Program) =
+            addData(BetaResponseItem.ofProgram(program))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofProgramOutput(programOutput)`. */
+        fun addData(programOutput: BetaResponseItem.ProgramOutput) =
+            addData(BetaResponseItem.ofProgramOutput(programOutput))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofCompaction(compaction)`. */
+        fun addData(compaction: BetaResponseCompactionItem) =
+            addData(BetaResponseItem.ofCompaction(compaction))
+
+        /**
+         * Alias for calling [addData] with
+         * `BetaResponseItem.ofImageGenerationCall(imageGenerationCall)`.
+         */
+        fun addData(imageGenerationCall: BetaResponseItem.ImageGenerationCall) =
+            addData(BetaResponseItem.ofImageGenerationCall(imageGenerationCall))
+
+        /**
+         * Alias for calling [addData] with
+         * `BetaResponseItem.ofCodeInterpreterCall(codeInterpreterCall)`.
+         */
+        fun addData(codeInterpreterCall: BetaResponseCodeInterpreterToolCall) =
+            addData(BetaResponseItem.ofCodeInterpreterCall(codeInterpreterCall))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofLocalShellCall(localShellCall)`. */
+        fun addData(localShellCall: BetaResponseItem.LocalShellCall) =
+            addData(BetaResponseItem.ofLocalShellCall(localShellCall))
+
+        /**
+         * Alias for calling [addData] with
+         * `BetaResponseItem.ofLocalShellCallOutput(localShellCallOutput)`.
+         */
+        fun addData(localShellCallOutput: BetaResponseItem.LocalShellCallOutput) =
+            addData(BetaResponseItem.ofLocalShellCallOutput(localShellCallOutput))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofShellCall(shellCall)`. */
+        fun addData(shellCall: BetaResponseFunctionShellToolCall) =
+            addData(BetaResponseItem.ofShellCall(shellCall))
+
+        /**
+         * Alias for calling [addData] with `BetaResponseItem.ofShellCallOutput(shellCallOutput)`.
+         */
+        fun addData(shellCallOutput: BetaResponseFunctionShellToolCallOutput) =
+            addData(BetaResponseItem.ofShellCallOutput(shellCallOutput))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofApplyPatchCall(applyPatchCall)`. */
+        fun addData(applyPatchCall: BetaResponseApplyPatchToolCall) =
+            addData(BetaResponseItem.ofApplyPatchCall(applyPatchCall))
+
+        /**
+         * Alias for calling [addData] with
+         * `BetaResponseItem.ofApplyPatchCallOutput(applyPatchCallOutput)`.
+         */
+        fun addData(applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput) =
+            addData(BetaResponseItem.ofApplyPatchCallOutput(applyPatchCallOutput))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofMcpListTools(mcpListTools)`. */
+        fun addData(mcpListTools: BetaResponseItem.McpListTools) =
+            addData(BetaResponseItem.ofMcpListTools(mcpListTools))
+
+        /**
+         * Alias for calling [addData] with
+         * `BetaResponseItem.ofMcpApprovalRequest(mcpApprovalRequest)`.
+         */
+        fun addData(mcpApprovalRequest: BetaResponseItem.McpApprovalRequest) =
+            addData(BetaResponseItem.ofMcpApprovalRequest(mcpApprovalRequest))
+
+        /**
+         * Alias for calling [addData] with
+         * `BetaResponseItem.ofMcpApprovalResponse(mcpApprovalResponse)`.
+         */
+        fun addData(mcpApprovalResponse: BetaResponseItem.McpApprovalResponse) =
+            addData(BetaResponseItem.ofMcpApprovalResponse(mcpApprovalResponse))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofMcpCall(mcpCall)`. */
+        fun addData(mcpCall: BetaResponseItem.McpCall) =
+            addData(BetaResponseItem.ofMcpCall(mcpCall))
+
+        /** Alias for calling [addData] with `BetaResponseItem.ofCustomToolCall(customToolCall)`. */
+        fun addData(customToolCall: BetaResponseCustomToolCallItem) =
+            addData(BetaResponseItem.ofCustomToolCall(customToolCall))
+
+        /**
+         * Alias for calling [addData] with
+         * `BetaResponseItem.ofCustomToolCallOutput(customToolCallOutput)`.
+         */
+        fun addData(customToolCallOutput: BetaResponseCustomToolCallOutputItem) =
+            addData(BetaResponseItem.ofCustomToolCallOutput(customToolCallOutput))
+
+        /** The ID of the first item in the list. */
+        fun firstId(firstId: String) = firstId(JsonField.of(firstId))
+
+        /**
+         * Sets [Builder.firstId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.firstId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun firstId(firstId: JsonField<String>) = apply { this.firstId = firstId }
+
+        /** Whether there are more items available. */
+        fun hasMore(hasMore: Boolean) = hasMore(JsonField.of(hasMore))
+
+        /**
+         * Sets [Builder.hasMore] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.hasMore] with a well-typed [Boolean] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun hasMore(hasMore: JsonField<Boolean>) = apply { this.hasMore = hasMore }
+
+        /** The ID of the last item in the list. */
+        fun lastId(lastId: String) = lastId(JsonField.of(lastId))
+
+        /**
+         * Sets [Builder.lastId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.lastId] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun lastId(lastId: JsonField<String>) = apply { this.lastId = lastId }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("list")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun object_(object_: JsonValue) = apply { this.object_ = object_ }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [BetaResponseItemList].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .data()
+         * .firstId()
+         * .hasMore()
+         * .lastId()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): BetaResponseItemList =
+            BetaResponseItemList(
+                checkRequired("data", data).map { it.toImmutable() },
+                checkRequired("firstId", firstId),
+                checkRequired("hasMore", hasMore),
+                checkRequired("lastId", lastId),
+                object_,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): BetaResponseItemList = apply {
+        if (validated) {
+            return@apply
+        }
+
+        data().forEach { it.validate() }
+        firstId()
+        hasMore()
+        lastId()
+        _object_().let {
+            if (it != JsonValue.from("list")) {
+                throw OpenAIInvalidDataException("'object_' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (data.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+            (if (firstId.asKnown().isPresent) 1 else 0) +
+            (if (hasMore.asKnown().isPresent) 1 else 0) +
+            (if (lastId.asKnown().isPresent) 1 else 0) +
+            object_.let { if (it == JsonValue.from("list")) 1 else 0 }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is BetaResponseItemList &&
+            data == other.data &&
+            firstId == other.firstId &&
+            hasMore == other.hasMore &&
+            lastId == other.lastId &&
+            object_ == other.object_ &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(data, firstId, hasMore, lastId, object_, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "BetaResponseItemList{data=$data, firstId=$firstId, hasMore=$hasMore, lastId=$lastId, object_=$object_, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputitems/InputItemListPage.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputitems/InputItemListPage.kt
new file mode 100644
index 000000000..924dd38a2
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputitems/InputItemListPage.kt
@@ -0,0 +1,287 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses.inputitems
+
+import com.openai.core.AutoPager
+import com.openai.core.Page
+import com.openai.core.checkRequired
+import com.openai.models.beta.responses.BetaResponseApplyPatchToolCall
+import com.openai.models.beta.responses.BetaResponseApplyPatchToolCallOutput
+import com.openai.models.beta.responses.BetaResponseCodeInterpreterToolCall
+import com.openai.models.beta.responses.BetaResponseCompactionItem
+import com.openai.models.beta.responses.BetaResponseComputerToolCall
+import com.openai.models.beta.responses.BetaResponseComputerToolCallOutputItem
+import com.openai.models.beta.responses.BetaResponseCustomToolCallItem
+import com.openai.models.beta.responses.BetaResponseCustomToolCallOutputItem
+import com.openai.models.beta.responses.BetaResponseFileSearchToolCall
+import com.openai.models.beta.responses.BetaResponseFunctionShellToolCall
+import com.openai.models.beta.responses.BetaResponseFunctionShellToolCallOutput
+import com.openai.models.beta.responses.BetaResponseFunctionToolCallItem
+import com.openai.models.beta.responses.BetaResponseFunctionToolCallOutputItem
+import com.openai.models.beta.responses.BetaResponseFunctionWebSearch
+import com.openai.models.beta.responses.BetaResponseInputMessageItem
+import com.openai.models.beta.responses.BetaResponseItem
+import com.openai.models.beta.responses.BetaResponseOutputMessage
+import com.openai.models.beta.responses.BetaResponseReasoningItem
+import com.openai.models.beta.responses.BetaResponseToolSearchCall
+import com.openai.models.beta.responses.BetaResponseToolSearchOutputItem
+import com.openai.services.blocking.beta.responses.InputItemService
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** @see InputItemService.list */
+class InputItemListPage
+private constructor(
+    private val service: InputItemService,
+    private val params: InputItemListParams,
+    private val response: BetaResponseItemList,
+) : Page<BetaResponseItem> {
+
+    /**
+     * Delegates to [BetaResponseItemList], but gracefully handles missing data.
+     *
+     * @see BetaResponseItemList.data
+     */
+    fun data(): List<BetaResponseItem> =
+        response._data().getOptional("data").getOrNull() ?: emptyList()
+
+    /**
+     * Delegates to [BetaResponseItemList], but gracefully handles missing data.
+     *
+     * @see BetaResponseItemList.hasMore
+     */
+    fun hasMore(): Optional<Boolean> = response._hasMore().getOptional("has_more")
+
+    override fun items(): List<BetaResponseItem> = data()
+
+    override fun hasNextPage(): Boolean = items().isNotEmpty()
+
+    fun nextPageParams(): InputItemListParams =
+        params
+            .toBuilder()
+            .after(
+                items()
+                    .last()
+                    .accept(
+                        object : BetaResponseItem.Visitor<Optional<String>> {
+                            override fun visitBetaResponseInputMessageItem(
+                                betaResponseInputMessageItem: BetaResponseInputMessageItem
+                            ): Optional<String> =
+                                betaResponseInputMessageItem._id().getOptional("id")
+
+                            override fun visitBetaResponseOutputMessage(
+                                betaResponseOutputMessage: BetaResponseOutputMessage
+                            ): Optional<String> = betaResponseOutputMessage._id().getOptional("id")
+
+                            override fun visitFileSearchCall(
+                                fileSearchCall: BetaResponseFileSearchToolCall
+                            ): Optional<String> = fileSearchCall._id().getOptional("id")
+
+                            override fun visitComputerCall(
+                                computerCall: BetaResponseComputerToolCall
+                            ): Optional<String> = computerCall._id().getOptional("id")
+
+                            override fun visitComputerCallOutput(
+                                computerCallOutput: BetaResponseComputerToolCallOutputItem
+                            ): Optional<String> = computerCallOutput._id().getOptional("id")
+
+                            override fun visitWebSearchCall(
+                                webSearchCall: BetaResponseFunctionWebSearch
+                            ): Optional<String> = webSearchCall._id().getOptional("id")
+
+                            override fun visitFunctionCall(
+                                functionCall: BetaResponseFunctionToolCallItem
+                            ): Optional<String> = functionCall._id().getOptional("id")
+
+                            override fun visitFunctionCallOutput(
+                                functionCallOutput: BetaResponseFunctionToolCallOutputItem
+                            ): Optional<String> = functionCallOutput._id().getOptional("id")
+
+                            override fun visitAgentMessage(
+                                agentMessage: BetaResponseItem.AgentMessage
+                            ): Optional<String> = agentMessage._id().getOptional("id")
+
+                            override fun visitMultiAgentCall(
+                                multiAgentCall: BetaResponseItem.MultiAgentCall
+                            ): Optional<String> = multiAgentCall._id().getOptional("id")
+
+                            override fun visitMultiAgentCallOutput(
+                                multiAgentCallOutput: BetaResponseItem.MultiAgentCallOutput
+                            ): Optional<String> = multiAgentCallOutput._id().getOptional("id")
+
+                            override fun visitToolSearchCall(
+                                toolSearchCall: BetaResponseToolSearchCall
+                            ): Optional<String> = toolSearchCall._id().getOptional("id")
+
+                            override fun visitToolSearchOutput(
+                                toolSearchOutput: BetaResponseToolSearchOutputItem
+                            ): Optional<String> = toolSearchOutput._id().getOptional("id")
+
+                            override fun visitAdditionalTools(
+                                additionalTools: BetaResponseItem.AdditionalTools
+                            ): Optional<String> = additionalTools._id().getOptional("id")
+
+                            override fun visitReasoning(
+                                reasoning: BetaResponseReasoningItem
+                            ): Optional<String> = reasoning._id().getOptional("id")
+
+                            override fun visitProgram(
+                                program: BetaResponseItem.Program
+                            ): Optional<String> = program._id().getOptional("id")
+
+                            override fun visitProgramOutput(
+                                programOutput: BetaResponseItem.ProgramOutput
+                            ): Optional<String> = programOutput._id().getOptional("id")
+
+                            override fun visitCompaction(
+                                compaction: BetaResponseCompactionItem
+                            ): Optional<String> = compaction._id().getOptional("id")
+
+                            override fun visitImageGenerationCall(
+                                imageGenerationCall: BetaResponseItem.ImageGenerationCall
+                            ): Optional<String> = imageGenerationCall._id().getOptional("id")
+
+                            override fun visitCodeInterpreterCall(
+                                codeInterpreterCall: BetaResponseCodeInterpreterToolCall
+                            ): Optional<String> = codeInterpreterCall._id().getOptional("id")
+
+                            override fun visitLocalShellCall(
+                                localShellCall: BetaResponseItem.LocalShellCall
+                            ): Optional<String> = localShellCall._id().getOptional("id")
+
+                            override fun visitLocalShellCallOutput(
+                                localShellCallOutput: BetaResponseItem.LocalShellCallOutput
+                            ): Optional<String> = localShellCallOutput._id().getOptional("id")
+
+                            override fun visitShellCall(
+                                shellCall: BetaResponseFunctionShellToolCall
+                            ): Optional<String> = shellCall._id().getOptional("id")
+
+                            override fun visitShellCallOutput(
+                                shellCallOutput: BetaResponseFunctionShellToolCallOutput
+                            ): Optional<String> = shellCallOutput._id().getOptional("id")
+
+                            override fun visitApplyPatchCall(
+                                applyPatchCall: BetaResponseApplyPatchToolCall
+                            ): Optional<String> = applyPatchCall._id().getOptional("id")
+
+                            override fun visitApplyPatchCallOutput(
+                                applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput
+                            ): Optional<String> = applyPatchCallOutput._id().getOptional("id")
+
+                            override fun visitMcpListTools(
+                                mcpListTools: BetaResponseItem.McpListTools
+                            ): Optional<String> = mcpListTools._id().getOptional("id")
+
+                            override fun visitMcpApprovalRequest(
+                                mcpApprovalRequest: BetaResponseItem.McpApprovalRequest
+                            ): Optional<String> = mcpApprovalRequest._id().getOptional("id")
+
+                            override fun visitMcpApprovalResponse(
+                                mcpApprovalResponse: BetaResponseItem.McpApprovalResponse
+                            ): Optional<String> = mcpApprovalResponse._id().getOptional("id")
+
+                            override fun visitMcpCall(
+                                mcpCall: BetaResponseItem.McpCall
+                            ): Optional<String> = mcpCall._id().getOptional("id")
+
+                            override fun visitCustomToolCall(
+                                customToolCall: BetaResponseCustomToolCallItem
+                            ): Optional<String> = customToolCall._id().getOptional("id")
+
+                            override fun visitCustomToolCallOutput(
+                                customToolCallOutput: BetaResponseCustomToolCallOutputItem
+                            ): Optional<String> = customToolCallOutput._id().getOptional("id")
+                        }
+                    )
+            )
+            .build()
+
+    override fun nextPage(): InputItemListPage = service.list(nextPageParams())
+
+    fun autoPager(): AutoPager<BetaResponseItem> = AutoPager.from(this)
+
+    /** The parameters that were used to request this page. */
+    fun params(): InputItemListParams = params
+
+    /** The response that this page was parsed from. */
+    fun response(): BetaResponseItemList = response
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [InputItemListPage].
+         *
+         * The following fields are required:
+         * ```java
+         * .service()
+         * .params()
+         * .response()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [InputItemListPage]. */
+    class Builder internal constructor() {
+
+        private var service: InputItemService? = null
+        private var params: InputItemListParams? = null
+        private var response: BetaResponseItemList? = null
+
+        @JvmSynthetic
+        internal fun from(inputItemListPage: InputItemListPage) = apply {
+            service = inputItemListPage.service
+            params = inputItemListPage.params
+            response = inputItemListPage.response
+        }
+
+        fun service(service: InputItemService) = apply { this.service = service }
+
+        /** The parameters that were used to request this page. */
+        fun params(params: InputItemListParams) = apply { this.params = params }
+
+        /** The response that this page was parsed from. */
+        fun response(response: BetaResponseItemList) = apply { this.response = response }
+
+        /**
+         * Returns an immutable instance of [InputItemListPage].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .service()
+         * .params()
+         * .response()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): InputItemListPage =
+            InputItemListPage(
+                checkRequired("service", service),
+                checkRequired("params", params),
+                checkRequired("response", response),
+            )
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is InputItemListPage &&
+            service == other.service &&
+            params == other.params &&
+            response == other.response
+    }
+
+    override fun hashCode(): Int = Objects.hash(service, params, response)
+
+    override fun toString() =
+        "InputItemListPage{service=$service, params=$params, response=$response}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputitems/InputItemListPageAsync.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputitems/InputItemListPageAsync.kt
new file mode 100644
index 000000000..c380356d3
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputitems/InputItemListPageAsync.kt
@@ -0,0 +1,302 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses.inputitems
+
+import com.openai.core.AutoPagerAsync
+import com.openai.core.PageAsync
+import com.openai.core.checkRequired
+import com.openai.models.beta.responses.BetaResponseApplyPatchToolCall
+import com.openai.models.beta.responses.BetaResponseApplyPatchToolCallOutput
+import com.openai.models.beta.responses.BetaResponseCodeInterpreterToolCall
+import com.openai.models.beta.responses.BetaResponseCompactionItem
+import com.openai.models.beta.responses.BetaResponseComputerToolCall
+import com.openai.models.beta.responses.BetaResponseComputerToolCallOutputItem
+import com.openai.models.beta.responses.BetaResponseCustomToolCallItem
+import com.openai.models.beta.responses.BetaResponseCustomToolCallOutputItem
+import com.openai.models.beta.responses.BetaResponseFileSearchToolCall
+import com.openai.models.beta.responses.BetaResponseFunctionShellToolCall
+import com.openai.models.beta.responses.BetaResponseFunctionShellToolCallOutput
+import com.openai.models.beta.responses.BetaResponseFunctionToolCallItem
+import com.openai.models.beta.responses.BetaResponseFunctionToolCallOutputItem
+import com.openai.models.beta.responses.BetaResponseFunctionWebSearch
+import com.openai.models.beta.responses.BetaResponseInputMessageItem
+import com.openai.models.beta.responses.BetaResponseItem
+import com.openai.models.beta.responses.BetaResponseOutputMessage
+import com.openai.models.beta.responses.BetaResponseReasoningItem
+import com.openai.models.beta.responses.BetaResponseToolSearchCall
+import com.openai.models.beta.responses.BetaResponseToolSearchOutputItem
+import com.openai.services.async.beta.responses.InputItemServiceAsync
+import java.util.Objects
+import java.util.Optional
+import java.util.concurrent.CompletableFuture
+import java.util.concurrent.Executor
+import kotlin.jvm.optionals.getOrNull
+
+/** @see InputItemServiceAsync.list */
+class InputItemListPageAsync
+private constructor(
+    private val service: InputItemServiceAsync,
+    private val streamHandlerExecutor: Executor,
+    private val params: InputItemListParams,
+    private val response: BetaResponseItemList,
+) : PageAsync<BetaResponseItem> {
+
+    /**
+     * Delegates to [BetaResponseItemList], but gracefully handles missing data.
+     *
+     * @see BetaResponseItemList.data
+     */
+    fun data(): List<BetaResponseItem> =
+        response._data().getOptional("data").getOrNull() ?: emptyList()
+
+    /**
+     * Delegates to [BetaResponseItemList], but gracefully handles missing data.
+     *
+     * @see BetaResponseItemList.hasMore
+     */
+    fun hasMore(): Optional<Boolean> = response._hasMore().getOptional("has_more")
+
+    override fun items(): List<BetaResponseItem> = data()
+
+    override fun hasNextPage(): Boolean = items().isNotEmpty()
+
+    fun nextPageParams(): InputItemListParams =
+        params
+            .toBuilder()
+            .after(
+                items()
+                    .last()
+                    .accept(
+                        object : BetaResponseItem.Visitor<Optional<String>> {
+                            override fun visitBetaResponseInputMessageItem(
+                                betaResponseInputMessageItem: BetaResponseInputMessageItem
+                            ): Optional<String> =
+                                betaResponseInputMessageItem._id().getOptional("id")
+
+                            override fun visitBetaResponseOutputMessage(
+                                betaResponseOutputMessage: BetaResponseOutputMessage
+                            ): Optional<String> = betaResponseOutputMessage._id().getOptional("id")
+
+                            override fun visitFileSearchCall(
+                                fileSearchCall: BetaResponseFileSearchToolCall
+                            ): Optional<String> = fileSearchCall._id().getOptional("id")
+
+                            override fun visitComputerCall(
+                                computerCall: BetaResponseComputerToolCall
+                            ): Optional<String> = computerCall._id().getOptional("id")
+
+                            override fun visitComputerCallOutput(
+                                computerCallOutput: BetaResponseComputerToolCallOutputItem
+                            ): Optional<String> = computerCallOutput._id().getOptional("id")
+
+                            override fun visitWebSearchCall(
+                                webSearchCall: BetaResponseFunctionWebSearch
+                            ): Optional<String> = webSearchCall._id().getOptional("id")
+
+                            override fun visitFunctionCall(
+                                functionCall: BetaResponseFunctionToolCallItem
+                            ): Optional<String> = functionCall._id().getOptional("id")
+
+                            override fun visitFunctionCallOutput(
+                                functionCallOutput: BetaResponseFunctionToolCallOutputItem
+                            ): Optional<String> = functionCallOutput._id().getOptional("id")
+
+                            override fun visitAgentMessage(
+                                agentMessage: BetaResponseItem.AgentMessage
+                            ): Optional<String> = agentMessage._id().getOptional("id")
+
+                            override fun visitMultiAgentCall(
+                                multiAgentCall: BetaResponseItem.MultiAgentCall
+                            ): Optional<String> = multiAgentCall._id().getOptional("id")
+
+                            override fun visitMultiAgentCallOutput(
+                                multiAgentCallOutput: BetaResponseItem.MultiAgentCallOutput
+                            ): Optional<String> = multiAgentCallOutput._id().getOptional("id")
+
+                            override fun visitToolSearchCall(
+                                toolSearchCall: BetaResponseToolSearchCall
+                            ): Optional<String> = toolSearchCall._id().getOptional("id")
+
+                            override fun visitToolSearchOutput(
+                                toolSearchOutput: BetaResponseToolSearchOutputItem
+                            ): Optional<String> = toolSearchOutput._id().getOptional("id")
+
+                            override fun visitAdditionalTools(
+                                additionalTools: BetaResponseItem.AdditionalTools
+                            ): Optional<String> = additionalTools._id().getOptional("id")
+
+                            override fun visitReasoning(
+                                reasoning: BetaResponseReasoningItem
+                            ): Optional<String> = reasoning._id().getOptional("id")
+
+                            override fun visitProgram(
+                                program: BetaResponseItem.Program
+                            ): Optional<String> = program._id().getOptional("id")
+
+                            override fun visitProgramOutput(
+                                programOutput: BetaResponseItem.ProgramOutput
+                            ): Optional<String> = programOutput._id().getOptional("id")
+
+                            override fun visitCompaction(
+                                compaction: BetaResponseCompactionItem
+                            ): Optional<String> = compaction._id().getOptional("id")
+
+                            override fun visitImageGenerationCall(
+                                imageGenerationCall: BetaResponseItem.ImageGenerationCall
+                            ): Optional<String> = imageGenerationCall._id().getOptional("id")
+
+                            override fun visitCodeInterpreterCall(
+                                codeInterpreterCall: BetaResponseCodeInterpreterToolCall
+                            ): Optional<String> = codeInterpreterCall._id().getOptional("id")
+
+                            override fun visitLocalShellCall(
+                                localShellCall: BetaResponseItem.LocalShellCall
+                            ): Optional<String> = localShellCall._id().getOptional("id")
+
+                            override fun visitLocalShellCallOutput(
+                                localShellCallOutput: BetaResponseItem.LocalShellCallOutput
+                            ): Optional<String> = localShellCallOutput._id().getOptional("id")
+
+                            override fun visitShellCall(
+                                shellCall: BetaResponseFunctionShellToolCall
+                            ): Optional<String> = shellCall._id().getOptional("id")
+
+                            override fun visitShellCallOutput(
+                                shellCallOutput: BetaResponseFunctionShellToolCallOutput
+                            ): Optional<String> = shellCallOutput._id().getOptional("id")
+
+                            override fun visitApplyPatchCall(
+                                applyPatchCall: BetaResponseApplyPatchToolCall
+                            ): Optional<String> = applyPatchCall._id().getOptional("id")
+
+                            override fun visitApplyPatchCallOutput(
+                                applyPatchCallOutput: BetaResponseApplyPatchToolCallOutput
+                            ): Optional<String> = applyPatchCallOutput._id().getOptional("id")
+
+                            override fun visitMcpListTools(
+                                mcpListTools: BetaResponseItem.McpListTools
+                            ): Optional<String> = mcpListTools._id().getOptional("id")
+
+                            override fun visitMcpApprovalRequest(
+                                mcpApprovalRequest: BetaResponseItem.McpApprovalRequest
+                            ): Optional<String> = mcpApprovalRequest._id().getOptional("id")
+
+                            override fun visitMcpApprovalResponse(
+                                mcpApprovalResponse: BetaResponseItem.McpApprovalResponse
+                            ): Optional<String> = mcpApprovalResponse._id().getOptional("id")
+
+                            override fun visitMcpCall(
+                                mcpCall: BetaResponseItem.McpCall
+                            ): Optional<String> = mcpCall._id().getOptional("id")
+
+                            override fun visitCustomToolCall(
+                                customToolCall: BetaResponseCustomToolCallItem
+                            ): Optional<String> = customToolCall._id().getOptional("id")
+
+                            override fun visitCustomToolCallOutput(
+                                customToolCallOutput: BetaResponseCustomToolCallOutputItem
+                            ): Optional<String> = customToolCallOutput._id().getOptional("id")
+                        }
+                    )
+            )
+            .build()
+
+    override fun nextPage(): CompletableFuture<InputItemListPageAsync> =
+        service.list(nextPageParams())
+
+    fun autoPager(): AutoPagerAsync<BetaResponseItem> =
+        AutoPagerAsync.from(this, streamHandlerExecutor)
+
+    /** The parameters that were used to request this page. */
+    fun params(): InputItemListParams = params
+
+    /** The response that this page was parsed from. */
+    fun response(): BetaResponseItemList = response
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [InputItemListPageAsync].
+         *
+         * The following fields are required:
+         * ```java
+         * .service()
+         * .streamHandlerExecutor()
+         * .params()
+         * .response()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [InputItemListPageAsync]. */
+    class Builder internal constructor() {
+
+        private var service: InputItemServiceAsync? = null
+        private var streamHandlerExecutor: Executor? = null
+        private var params: InputItemListParams? = null
+        private var response: BetaResponseItemList? = null
+
+        @JvmSynthetic
+        internal fun from(inputItemListPageAsync: InputItemListPageAsync) = apply {
+            service = inputItemListPageAsync.service
+            streamHandlerExecutor = inputItemListPageAsync.streamHandlerExecutor
+            params = inputItemListPageAsync.params
+            response = inputItemListPageAsync.response
+        }
+
+        fun service(service: InputItemServiceAsync) = apply { this.service = service }
+
+        fun streamHandlerExecutor(streamHandlerExecutor: Executor) = apply {
+            this.streamHandlerExecutor = streamHandlerExecutor
+        }
+
+        /** The parameters that were used to request this page. */
+        fun params(params: InputItemListParams) = apply { this.params = params }
+
+        /** The response that this page was parsed from. */
+        fun response(response: BetaResponseItemList) = apply { this.response = response }
+
+        /**
+         * Returns an immutable instance of [InputItemListPageAsync].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .service()
+         * .streamHandlerExecutor()
+         * .params()
+         * .response()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): InputItemListPageAsync =
+            InputItemListPageAsync(
+                checkRequired("service", service),
+                checkRequired("streamHandlerExecutor", streamHandlerExecutor),
+                checkRequired("params", params),
+                checkRequired("response", response),
+            )
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is InputItemListPageAsync &&
+            service == other.service &&
+            streamHandlerExecutor == other.streamHandlerExecutor &&
+            params == other.params &&
+            response == other.response
+    }
+
+    override fun hashCode(): Int = Objects.hash(service, streamHandlerExecutor, params, response)
+
+    override fun toString() =
+        "InputItemListPageAsync{service=$service, streamHandlerExecutor=$streamHandlerExecutor, params=$params, response=$response}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputitems/InputItemListParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputitems/InputItemListParams.kt
new file mode 100644
index 000000000..c6cabfbe2
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputitems/InputItemListParams.kt
@@ -0,0 +1,604 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses.inputitems
+
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.openai.core.Enum
+import com.openai.core.JsonField
+import com.openai.core.Params
+import com.openai.core.http.Headers
+import com.openai.core.http.QueryParams
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import com.openai.models.beta.responses.BetaResponseIncludable
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Returns a list of input items for a given response. */
+class InputItemListParams
+private constructor(
+    private val responseId: String?,
+    private val after: String?,
+    private val include: List<BetaResponseIncludable>?,
+    private val limit: Long?,
+    private val order: Order?,
+    private val betas: List<Beta>?,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun responseId(): Optional<String> = Optional.ofNullable(responseId)
+
+    /** An item ID to list items after, used in pagination. */
+    fun after(): Optional<String> = Optional.ofNullable(after)
+
+    /**
+     * Additional fields to include in the response. See the `include` parameter for Response
+     * creation above for more information.
+     */
+    fun include(): Optional<List<BetaResponseIncludable>> = Optional.ofNullable(include)
+
+    /**
+     * A limit on the number of objects to be returned. Limit can range between 1 and 100, and the
+     * default is 20.
+     */
+    fun limit(): Optional<Long> = Optional.ofNullable(limit)
+
+    /**
+     * The order to return the input items in. Default is `desc`.
+     * - `asc`: Return the input items in ascending order.
+     * - `desc`: Return the input items in descending order.
+     */
+    fun order(): Optional<Order> = Optional.ofNullable(order)
+
+    fun betas(): Optional<List<Beta>> = Optional.ofNullable(betas)
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): InputItemListParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [InputItemListParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [InputItemListParams]. */
+    class Builder internal constructor() {
+
+        private var responseId: String? = null
+        private var after: String? = null
+        private var include: MutableList<BetaResponseIncludable>? = null
+        private var limit: Long? = null
+        private var order: Order? = null
+        private var betas: MutableList<Beta>? = null
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(inputItemListParams: InputItemListParams) = apply {
+            responseId = inputItemListParams.responseId
+            after = inputItemListParams.after
+            include = inputItemListParams.include?.toMutableList()
+            limit = inputItemListParams.limit
+            order = inputItemListParams.order
+            betas = inputItemListParams.betas?.toMutableList()
+            additionalHeaders = inputItemListParams.additionalHeaders.toBuilder()
+            additionalQueryParams = inputItemListParams.additionalQueryParams.toBuilder()
+        }
+
+        fun responseId(responseId: String?) = apply { this.responseId = responseId }
+
+        /** Alias for calling [Builder.responseId] with `responseId.orElse(null)`. */
+        fun responseId(responseId: Optional<String>) = responseId(responseId.getOrNull())
+
+        /** An item ID to list items after, used in pagination. */
+        fun after(after: String?) = apply { this.after = after }
+
+        /** Alias for calling [Builder.after] with `after.orElse(null)`. */
+        fun after(after: Optional<String>) = after(after.getOrNull())
+
+        /**
+         * Additional fields to include in the response. See the `include` parameter for Response
+         * creation above for more information.
+         */
+        fun include(include: List<BetaResponseIncludable>?) = apply {
+            this.include = include?.toMutableList()
+        }
+
+        /** Alias for calling [Builder.include] with `include.orElse(null)`. */
+        fun include(include: Optional<List<BetaResponseIncludable>>) = include(include.getOrNull())
+
+        /**
+         * Adds a single [BetaResponseIncludable] to [Builder.include].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addInclude(include: BetaResponseIncludable) = apply {
+            this.include = (this.include ?: mutableListOf()).apply { add(include) }
+        }
+
+        /**
+         * A limit on the number of objects to be returned. Limit can range between 1 and 100, and
+         * the default is 20.
+         */
+        fun limit(limit: Long?) = apply { this.limit = limit }
+
+        /**
+         * Alias for [Builder.limit].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun limit(limit: Long) = limit(limit as Long?)
+
+        /** Alias for calling [Builder.limit] with `limit.orElse(null)`. */
+        fun limit(limit: Optional<Long>) = limit(limit.getOrNull())
+
+        /**
+         * The order to return the input items in. Default is `desc`.
+         * - `asc`: Return the input items in ascending order.
+         * - `desc`: Return the input items in descending order.
+         */
+        fun order(order: Order?) = apply { this.order = order }
+
+        /** Alias for calling [Builder.order] with `order.orElse(null)`. */
+        fun order(order: Optional<Order>) = order(order.getOrNull())
+
+        fun betas(betas: List<Beta>?) = apply { this.betas = betas?.toMutableList() }
+
+        /** Alias for calling [Builder.betas] with `betas.orElse(null)`. */
+        fun betas(betas: Optional<List<Beta>>) = betas(betas.getOrNull())
+
+        /**
+         * Adds a single [Beta] to [betas].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addBeta(beta: Beta) = apply { betas = (betas ?: mutableListOf()).apply { add(beta) } }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [InputItemListParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): InputItemListParams =
+            InputItemListParams(
+                responseId,
+                after,
+                include?.toImmutable(),
+                limit,
+                order,
+                betas?.toImmutable(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _pathParam(index: Int): String =
+        when (index) {
+            0 -> responseId ?: ""
+            else -> ""
+        }
+
+    override fun _headers(): Headers =
+        Headers.builder()
+            .apply {
+                betas?.forEach { put("openai-beta", it.toString()) }
+                putAll(additionalHeaders)
+            }
+            .build()
+
+    override fun _queryParams(): QueryParams =
+        QueryParams.builder()
+            .apply {
+                after?.let { put("after", it) }
+                include?.forEach { put("include[]", it.toString()) }
+                limit?.let { put("limit", it.toString()) }
+                order?.let { put("order", it.toString()) }
+                putAll(additionalQueryParams)
+            }
+            .build()
+
+    class Beta @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val RESPONSES_MULTI_AGENT_V1 = of("responses_multi_agent=v1")
+
+            @JvmStatic fun of(value: String) = Beta(JsonField.of(value))
+        }
+
+        /** An enum containing [Beta]'s known values. */
+        enum class Known {
+            RESPONSES_MULTI_AGENT_V1
+        }
+
+        /**
+         * An enum containing [Beta]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Beta] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            RESPONSES_MULTI_AGENT_V1,
+            /** An enum member indicating that [Beta] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                RESPONSES_MULTI_AGENT_V1 -> Value.RESPONSES_MULTI_AGENT_V1
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                RESPONSES_MULTI_AGENT_V1 -> Known.RESPONSES_MULTI_AGENT_V1
+                else -> throw OpenAIInvalidDataException("Unknown Beta: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Beta = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Beta && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /**
+     * The order to return the input items in. Default is `desc`.
+     * - `asc`: Return the input items in ascending order.
+     * - `desc`: Return the input items in descending order.
+     */
+    class Order @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val ASC = of("asc")
+
+            @JvmField val DESC = of("desc")
+
+            @JvmStatic fun of(value: String) = Order(JsonField.of(value))
+        }
+
+        /** An enum containing [Order]'s known values. */
+        enum class Known {
+            ASC,
+            DESC,
+        }
+
+        /**
+         * An enum containing [Order]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Order] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            ASC,
+            DESC,
+            /** An enum member indicating that [Order] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                ASC -> Value.ASC
+                DESC -> Value.DESC
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                ASC -> Known.ASC
+                DESC -> Known.DESC
+                else -> throw OpenAIInvalidDataException("Unknown Order: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Order = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Order && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is InputItemListParams &&
+            responseId == other.responseId &&
+            after == other.after &&
+            include == other.include &&
+            limit == other.limit &&
+            order == other.order &&
+            betas == other.betas &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(
+            responseId,
+            after,
+            include,
+            limit,
+            order,
+            betas,
+            additionalHeaders,
+            additionalQueryParams,
+        )
+
+    override fun toString() =
+        "InputItemListParams{responseId=$responseId, after=$after, include=$include, limit=$limit, order=$order, betas=$betas, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputtokens/InputTokenCountParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputtokens/InputTokenCountParams.kt
new file mode 100644
index 000000000..e05b09a9b
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputtokens/InputTokenCountParams.kt
@@ -0,0 +1,4973 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses.inputtokens
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.Params
+import com.openai.core.allMaxBy
+import com.openai.core.checkKnown
+import com.openai.core.getOrThrow
+import com.openai.core.http.Headers
+import com.openai.core.http.QueryParams
+import com.openai.core.toImmutable
+import com.openai.errors.OpenAIInvalidDataException
+import com.openai.models.beta.responses.BetaApplyPatchTool
+import com.openai.models.beta.responses.BetaComputerTool
+import com.openai.models.beta.responses.BetaComputerUsePreviewTool
+import com.openai.models.beta.responses.BetaCustomTool
+import com.openai.models.beta.responses.BetaFileSearchTool
+import com.openai.models.beta.responses.BetaFunctionShellTool
+import com.openai.models.beta.responses.BetaFunctionTool
+import com.openai.models.beta.responses.BetaNamespaceTool
+import com.openai.models.beta.responses.BetaResponseConversationParam
+import com.openai.models.beta.responses.BetaResponseFormatTextConfig
+import com.openai.models.beta.responses.BetaResponseFormatTextJsonSchemaConfig
+import com.openai.models.beta.responses.BetaResponseInputItem
+import com.openai.models.beta.responses.BetaTool
+import com.openai.models.beta.responses.BetaToolChoiceAllowed
+import com.openai.models.beta.responses.BetaToolChoiceApplyPatch
+import com.openai.models.beta.responses.BetaToolChoiceCustom
+import com.openai.models.beta.responses.BetaToolChoiceFunction
+import com.openai.models.beta.responses.BetaToolChoiceMcp
+import com.openai.models.beta.responses.BetaToolChoiceOptions
+import com.openai.models.beta.responses.BetaToolChoiceShell
+import com.openai.models.beta.responses.BetaToolChoiceTypes
+import com.openai.models.beta.responses.BetaToolSearchTool
+import com.openai.models.beta.responses.BetaWebSearchPreviewTool
+import com.openai.models.beta.responses.BetaWebSearchTool
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/**
+ * Returns input token counts of the request.
+ *
+ * Returns an object with `object` set to `response.input_tokens` and an `input_tokens` count.
+ */
+class InputTokenCountParams
+private constructor(
+    private val betas: List<Beta>?,
+    private val body: Body,
+    private val additionalHeaders: Headers,
+    private val additionalQueryParams: QueryParams,
+) : Params {
+
+    fun betas(): Optional<List<Beta>> = Optional.ofNullable(betas)
+
+    /**
+     * The conversation that this response belongs to. Items from this conversation are prepended to
+     * `input_items` for this response request. Input items and output items from this response are
+     * automatically added to this conversation after this response completes.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun conversation(): Optional<Conversation> = body.conversation()
+
+    /**
+     * Text, image, or file inputs to the model, used to generate a response
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun input(): Optional<Input> = body.input()
+
+    /**
+     * A system (or developer) message inserted into the model's context. When used along with
+     * `previous_response_id`, the instructions from a previous response will not be carried over to
+     * the next response. This makes it simple to swap out system (or developer) messages in new
+     * responses.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun instructions(): Optional<String> = body.instructions()
+
+    /**
+     * Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide range of
+     * models with different capabilities, performance characteristics, and price points. Refer to
+     * the [model guide](https://platform.openai.com/docs/models) to browse and compare available
+     * models.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun model(): Optional<String> = body.model()
+
+    /**
+     * Whether to allow the model to run tool calls in parallel.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun parallelToolCalls(): Optional<Boolean> = body.parallelToolCalls()
+
+    /**
+     * A model-owned style preset to apply to this request. Omit this parameter to use the model's
+     * default style. Supported values may expand over time. Values must be at most 64 characters.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun personality(): Optional<Personality> = body.personality()
+
+    /**
+     * The unique ID of the previous response to the model. Use this to create multi-turn
+     * conversations. Learn more about
+     * [conversation state](https://platform.openai.com/docs/guides/conversation-state). Cannot be
+     * used in conjunction with `conversation`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun previousResponseId(): Optional<String> = body.previousResponseId()
+
+    /**
+     * **gpt-5 and o-series models only** Configuration options for
+     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun reasoning(): Optional<Reasoning> = body.reasoning()
+
+    /**
+     * Configuration options for a text response from the model. Can be plain text or structured
+     * JSON data. Learn more:
+     * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+     * - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun text(): Optional<Text> = body.text()
+
+    /**
+     * Controls which tool the model should use, if any.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun toolChoice(): Optional<ToolChoice> = body.toolChoice()
+
+    /**
+     * An array of tools the model may call while generating a response. You can specify which tool
+     * to use by setting the `tool_choice` parameter.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun tools(): Optional<List<BetaTool>> = body.tools()
+
+    /**
+     * The truncation strategy to use for the model response. - `auto`: If the input to this
+     * Response exceeds the model's context window size, the model will truncate the response to fit
+     * the context window by dropping items from the beginning of the conversation. - `disabled`
+     * (default): If the input size will exceed the context window size for a model, the request
+     * will fail with a 400 error.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    @Deprecated("deprecated") fun truncation(): Optional<Truncation> = body.truncation()
+
+    /**
+     * Returns the raw JSON value of [conversation].
+     *
+     * Unlike [conversation], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _conversation(): JsonField<Conversation> = body._conversation()
+
+    /**
+     * Returns the raw JSON value of [input].
+     *
+     * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _input(): JsonField<Input> = body._input()
+
+    /**
+     * Returns the raw JSON value of [instructions].
+     *
+     * Unlike [instructions], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _instructions(): JsonField<String> = body._instructions()
+
+    /**
+     * Returns the raw JSON value of [model].
+     *
+     * Unlike [model], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _model(): JsonField<String> = body._model()
+
+    /**
+     * Returns the raw JSON value of [parallelToolCalls].
+     *
+     * Unlike [parallelToolCalls], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    fun _parallelToolCalls(): JsonField<Boolean> = body._parallelToolCalls()
+
+    /**
+     * Returns the raw JSON value of [personality].
+     *
+     * Unlike [personality], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _personality(): JsonField<Personality> = body._personality()
+
+    /**
+     * Returns the raw JSON value of [previousResponseId].
+     *
+     * Unlike [previousResponseId], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    fun _previousResponseId(): JsonField<String> = body._previousResponseId()
+
+    /**
+     * Returns the raw JSON value of [reasoning].
+     *
+     * Unlike [reasoning], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _reasoning(): JsonField<Reasoning> = body._reasoning()
+
+    /**
+     * Returns the raw JSON value of [text].
+     *
+     * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _text(): JsonField<Text> = body._text()
+
+    /**
+     * Returns the raw JSON value of [toolChoice].
+     *
+     * Unlike [toolChoice], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _toolChoice(): JsonField<ToolChoice> = body._toolChoice()
+
+    /**
+     * Returns the raw JSON value of [tools].
+     *
+     * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _tools(): JsonField<List<BetaTool>> = body._tools()
+
+    /**
+     * Returns the raw JSON value of [truncation].
+     *
+     * Unlike [truncation], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @Deprecated("deprecated") fun _truncation(): JsonField<Truncation> = body._truncation()
+
+    fun _additionalBodyProperties(): Map<String, JsonValue> = body._additionalProperties()
+
+    /** Additional headers to send with the request. */
+    fun _additionalHeaders(): Headers = additionalHeaders
+
+    /** Additional query param to send with the request. */
+    fun _additionalQueryParams(): QueryParams = additionalQueryParams
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        @JvmStatic fun none(): InputTokenCountParams = builder().build()
+
+        /** Returns a mutable builder for constructing an instance of [InputTokenCountParams]. */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [InputTokenCountParams]. */
+    class Builder internal constructor() {
+
+        private var betas: MutableList<Beta>? = null
+        private var body: Body.Builder = Body.builder()
+        private var additionalHeaders: Headers.Builder = Headers.builder()
+        private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
+
+        @JvmSynthetic
+        internal fun from(inputTokenCountParams: InputTokenCountParams) = apply {
+            betas = inputTokenCountParams.betas?.toMutableList()
+            body = inputTokenCountParams.body.toBuilder()
+            additionalHeaders = inputTokenCountParams.additionalHeaders.toBuilder()
+            additionalQueryParams = inputTokenCountParams.additionalQueryParams.toBuilder()
+        }
+
+        fun betas(betas: List<Beta>?) = apply { this.betas = betas?.toMutableList() }
+
+        /** Alias for calling [Builder.betas] with `betas.orElse(null)`. */
+        fun betas(betas: Optional<List<Beta>>) = betas(betas.getOrNull())
+
+        /**
+         * Adds a single [Beta] to [betas].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addBeta(beta: Beta) = apply { betas = (betas ?: mutableListOf()).apply { add(beta) } }
+
+        /**
+         * Sets the entire request body.
+         *
+         * This is generally only useful if you are already constructing the body separately.
+         * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [conversation]
+         * - [input]
+         * - [instructions]
+         * - [model]
+         * - [parallelToolCalls]
+         * - etc.
+         */
+        fun body(body: Body) = apply { this.body = body.toBuilder() }
+
+        /**
+         * The conversation that this response belongs to. Items from this conversation are
+         * prepended to `input_items` for this response request. Input items and output items from
+         * this response are automatically added to this conversation after this response completes.
+         */
+        fun conversation(conversation: Conversation?) = apply { body.conversation(conversation) }
+
+        /** Alias for calling [Builder.conversation] with `conversation.orElse(null)`. */
+        fun conversation(conversation: Optional<Conversation>) =
+            conversation(conversation.getOrNull())
+
+        /**
+         * Sets [Builder.conversation] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.conversation] with a well-typed [Conversation] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun conversation(conversation: JsonField<Conversation>) = apply {
+            body.conversation(conversation)
+        }
+
+        /** Alias for calling [conversation] with `Conversation.ofId(id)`. */
+        fun conversation(id: String) = apply { body.conversation(id) }
+
+        /**
+         * Alias for calling [conversation] with
+         * `Conversation.ofBetaResponseConversationParam(betaResponseConversationParam)`.
+         */
+        fun conversation(betaResponseConversationParam: BetaResponseConversationParam) = apply {
+            body.conversation(betaResponseConversationParam)
+        }
+
+        /** Text, image, or file inputs to the model, used to generate a response */
+        fun input(input: Input?) = apply { body.input(input) }
+
+        /** Alias for calling [Builder.input] with `input.orElse(null)`. */
+        fun input(input: Optional<Input>) = input(input.getOrNull())
+
+        /**
+         * Sets [Builder.input] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.input] with a well-typed [Input] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun input(input: JsonField<Input>) = apply { body.input(input) }
+
+        /** Alias for calling [input] with `Input.ofString(string)`. */
+        fun input(string: String) = apply { body.input(string) }
+
+        /**
+         * Alias for calling [input] with `Input.ofBetaResponseInputItems(betaResponseInputItems)`.
+         */
+        fun inputOfBetaResponseInputItems(betaResponseInputItems: List<BetaResponseInputItem>) =
+            apply {
+                body.inputOfBetaResponseInputItems(betaResponseInputItems)
+            }
+
+        /**
+         * A system (or developer) message inserted into the model's context. When used along with
+         * `previous_response_id`, the instructions from a previous response will not be carried
+         * over to the next response. This makes it simple to swap out system (or developer)
+         * messages in new responses.
+         */
+        fun instructions(instructions: String?) = apply { body.instructions(instructions) }
+
+        /** Alias for calling [Builder.instructions] with `instructions.orElse(null)`. */
+        fun instructions(instructions: Optional<String>) = instructions(instructions.getOrNull())
+
+        /**
+         * Sets [Builder.instructions] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.instructions] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun instructions(instructions: JsonField<String>) = apply {
+            body.instructions(instructions)
+        }
+
+        /**
+         * Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide range
+         * of models with different capabilities, performance characteristics, and price points.
+         * Refer to the [model guide](https://platform.openai.com/docs/models) to browse and compare
+         * available models.
+         */
+        fun model(model: String?) = apply { body.model(model) }
+
+        /** Alias for calling [Builder.model] with `model.orElse(null)`. */
+        fun model(model: Optional<String>) = model(model.getOrNull())
+
+        /**
+         * Sets [Builder.model] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.model] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun model(model: JsonField<String>) = apply { body.model(model) }
+
+        /** Whether to allow the model to run tool calls in parallel. */
+        fun parallelToolCalls(parallelToolCalls: Boolean?) = apply {
+            body.parallelToolCalls(parallelToolCalls)
+        }
+
+        /**
+         * Alias for [Builder.parallelToolCalls].
+         *
+         * This unboxed primitive overload exists for backwards compatibility.
+         */
+        fun parallelToolCalls(parallelToolCalls: Boolean) =
+            parallelToolCalls(parallelToolCalls as Boolean?)
+
+        /** Alias for calling [Builder.parallelToolCalls] with `parallelToolCalls.orElse(null)`. */
+        fun parallelToolCalls(parallelToolCalls: Optional<Boolean>) =
+            parallelToolCalls(parallelToolCalls.getOrNull())
+
+        /**
+         * Sets [Builder.parallelToolCalls] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.parallelToolCalls] with a well-typed [Boolean] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun parallelToolCalls(parallelToolCalls: JsonField<Boolean>) = apply {
+            body.parallelToolCalls(parallelToolCalls)
+        }
+
+        /**
+         * A model-owned style preset to apply to this request. Omit this parameter to use the
+         * model's default style. Supported values may expand over time. Values must be at most 64
+         * characters.
+         */
+        fun personality(personality: Personality) = apply { body.personality(personality) }
+
+        /**
+         * Sets [Builder.personality] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.personality] with a well-typed [Personality] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun personality(personality: JsonField<Personality>) = apply {
+            body.personality(personality)
+        }
+
+        /**
+         * Sets [personality] to an arbitrary [String].
+         *
+         * You should usually call [personality] with a well-typed [Personality] constant instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun personality(value: String) = apply { body.personality(value) }
+
+        /**
+         * The unique ID of the previous response to the model. Use this to create multi-turn
+         * conversations. Learn more about
+         * [conversation state](https://platform.openai.com/docs/guides/conversation-state). Cannot
+         * be used in conjunction with `conversation`.
+         */
+        fun previousResponseId(previousResponseId: String?) = apply {
+            body.previousResponseId(previousResponseId)
+        }
+
+        /**
+         * Alias for calling [Builder.previousResponseId] with `previousResponseId.orElse(null)`.
+         */
+        fun previousResponseId(previousResponseId: Optional<String>) =
+            previousResponseId(previousResponseId.getOrNull())
+
+        /**
+         * Sets [Builder.previousResponseId] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.previousResponseId] with a well-typed [String] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun previousResponseId(previousResponseId: JsonField<String>) = apply {
+            body.previousResponseId(previousResponseId)
+        }
+
+        /**
+         * **gpt-5 and o-series models only** Configuration options for
+         * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+         */
+        fun reasoning(reasoning: Reasoning?) = apply { body.reasoning(reasoning) }
+
+        /** Alias for calling [Builder.reasoning] with `reasoning.orElse(null)`. */
+        fun reasoning(reasoning: Optional<Reasoning>) = reasoning(reasoning.getOrNull())
+
+        /**
+         * Sets [Builder.reasoning] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.reasoning] with a well-typed [Reasoning] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun reasoning(reasoning: JsonField<Reasoning>) = apply { body.reasoning(reasoning) }
+
+        /**
+         * Configuration options for a text response from the model. Can be plain text or structured
+         * JSON data. Learn more:
+         * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+         * - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+         */
+        fun text(text: Text?) = apply { body.text(text) }
+
+        /** Alias for calling [Builder.text] with `text.orElse(null)`. */
+        fun text(text: Optional<Text>) = text(text.getOrNull())
+
+        /**
+         * Sets [Builder.text] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.text] with a well-typed [Text] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun text(text: JsonField<Text>) = apply { body.text(text) }
+
+        /** Controls which tool the model should use, if any. */
+        fun toolChoice(toolChoice: ToolChoice?) = apply { body.toolChoice(toolChoice) }
+
+        /** Alias for calling [Builder.toolChoice] with `toolChoice.orElse(null)`. */
+        fun toolChoice(toolChoice: Optional<ToolChoice>) = toolChoice(toolChoice.getOrNull())
+
+        /**
+         * Sets [Builder.toolChoice] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.toolChoice] with a well-typed [ToolChoice] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun toolChoice(toolChoice: JsonField<ToolChoice>) = apply { body.toolChoice(toolChoice) }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceOptions(betaToolChoiceOptions)`.
+         */
+        fun toolChoice(betaToolChoiceOptions: BetaToolChoiceOptions) = apply {
+            body.toolChoice(betaToolChoiceOptions)
+        }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceAllowed(betaToolChoiceAllowed)`.
+         */
+        fun toolChoice(betaToolChoiceAllowed: BetaToolChoiceAllowed) = apply {
+            body.toolChoice(betaToolChoiceAllowed)
+        }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceTypes(betaToolChoiceTypes)`.
+         */
+        fun toolChoice(betaToolChoiceTypes: BetaToolChoiceTypes) = apply {
+            body.toolChoice(betaToolChoiceTypes)
+        }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceFunction(betaToolChoiceFunction)`.
+         */
+        fun toolChoice(betaToolChoiceFunction: BetaToolChoiceFunction) = apply {
+            body.toolChoice(betaToolChoiceFunction)
+        }
+
+        /**
+         * Alias for calling [toolChoice] with `ToolChoice.ofBetaToolChoiceMcp(betaToolChoiceMcp)`.
+         */
+        fun toolChoice(betaToolChoiceMcp: BetaToolChoiceMcp) = apply {
+            body.toolChoice(betaToolChoiceMcp)
+        }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceCustom(betaToolChoiceCustom)`.
+         */
+        fun toolChoice(betaToolChoiceCustom: BetaToolChoiceCustom) = apply {
+            body.toolChoice(betaToolChoiceCustom)
+        }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaSpecificProgrammaticToolCallingParam()`.
+         */
+        fun toolChoiceBetaSpecificProgrammaticToolCallingParam() = apply {
+            body.toolChoiceBetaSpecificProgrammaticToolCallingParam()
+        }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch)`.
+         */
+        fun toolChoice(betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch) = apply {
+            body.toolChoice(betaToolChoiceApplyPatch)
+        }
+
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofBetaToolChoiceShell(betaToolChoiceShell)`.
+         */
+        fun toolChoice(betaToolChoiceShell: BetaToolChoiceShell) = apply {
+            body.toolChoice(betaToolChoiceShell)
+        }
+
+        /**
+         * An array of tools the model may call while generating a response. You can specify which
+         * tool to use by setting the `tool_choice` parameter.
+         */
+        fun tools(tools: List<BetaTool>?) = apply { body.tools(tools) }
+
+        /** Alias for calling [Builder.tools] with `tools.orElse(null)`. */
+        fun tools(tools: Optional<List<BetaTool>>) = tools(tools.getOrNull())
+
+        /**
+         * Sets [Builder.tools] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.tools] with a well-typed `List<BetaTool>` value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun tools(tools: JsonField<List<BetaTool>>) = apply { body.tools(tools) }
+
+        /**
+         * Adds a single [BetaTool] to [tools].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addTool(tool: BetaTool) = apply { body.addTool(tool) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofFunction(function)`. */
+        fun addTool(function: BetaFunctionTool) = apply { body.addTool(function) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofFileSearch(fileSearch)`. */
+        fun addTool(fileSearch: BetaFileSearchTool) = apply { body.addTool(fileSearch) }
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaFileSearchTool.builder()
+         *     .vectorStoreIds(vectorStoreIds)
+         *     .build()
+         * ```
+         */
+        fun addFileSearchTool(vectorStoreIds: List<String>) = apply {
+            body.addFileSearchTool(vectorStoreIds)
+        }
+
+        /** Alias for calling [addTool] with `BetaTool.ofComputer(computer)`. */
+        fun addTool(computer: BetaComputerTool) = apply { body.addTool(computer) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofComputerUsePreview(computerUsePreview)`. */
+        fun addTool(computerUsePreview: BetaComputerUsePreviewTool) = apply {
+            body.addTool(computerUsePreview)
+        }
+
+        /** Alias for calling [addTool] with `BetaTool.ofWebSearch(webSearch)`. */
+        fun addTool(webSearch: BetaWebSearchTool) = apply { body.addTool(webSearch) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofMcp(mcp)`. */
+        fun addTool(mcp: BetaTool.Mcp) = apply { body.addTool(mcp) }
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaTool.Mcp.builder()
+         *     .serverLabel(serverLabel)
+         *     .build()
+         * ```
+         */
+        fun addMcpTool(serverLabel: String) = apply { body.addMcpTool(serverLabel) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofCodeInterpreter(codeInterpreter)`. */
+        fun addTool(codeInterpreter: BetaTool.CodeInterpreter) = apply {
+            body.addTool(codeInterpreter)
+        }
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaTool.CodeInterpreter.builder()
+         *     .container(container)
+         *     .build()
+         * ```
+         */
+        fun addCodeInterpreterTool(container: BetaTool.CodeInterpreter.Container) = apply {
+            body.addCodeInterpreterTool(container)
+        }
+
+        /**
+         * Alias for calling [addCodeInterpreterTool] with
+         * `BetaTool.CodeInterpreter.Container.ofString(string)`.
+         */
+        fun addCodeInterpreterTool(string: String) = apply { body.addCodeInterpreterTool(string) }
+
+        /**
+         * Alias for calling [addCodeInterpreterTool] with
+         * `BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)`.
+         */
+        fun addCodeInterpreterTool(
+            codeInterpreterToolAuto: BetaTool.CodeInterpreter.Container.CodeInterpreterToolAuto
+        ) = apply { body.addCodeInterpreterTool(codeInterpreterToolAuto) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofProgrammaticToolCalling()`. */
+        fun addToolProgrammaticToolCalling() = apply { body.addToolProgrammaticToolCalling() }
+
+        /** Alias for calling [addTool] with `BetaTool.ofImageGeneration(imageGeneration)`. */
+        fun addTool(imageGeneration: BetaTool.ImageGeneration) = apply {
+            body.addTool(imageGeneration)
+        }
+
+        /** Alias for calling [addTool] with `BetaTool.ofLocalShell()`. */
+        fun addToolLocalShell() = apply { body.addToolLocalShell() }
+
+        /** Alias for calling [addTool] with `BetaTool.ofShell(shell)`. */
+        fun addTool(shell: BetaFunctionShellTool) = apply { body.addTool(shell) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofCustom(custom)`. */
+        fun addTool(custom: BetaCustomTool) = apply { body.addTool(custom) }
+
+        /**
+         * Alias for calling [addTool] with the following:
+         * ```java
+         * BetaCustomTool.builder()
+         *     .name(name)
+         *     .build()
+         * ```
+         */
+        fun addCustomTool(name: String) = apply { body.addCustomTool(name) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofNamespace(namespace)`. */
+        fun addTool(namespace: BetaNamespaceTool) = apply { body.addTool(namespace) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofToolSearch(toolSearch)`. */
+        fun addTool(toolSearch: BetaToolSearchTool) = apply { body.addTool(toolSearch) }
+
+        /** Alias for calling [addTool] with `BetaTool.ofWebSearchPreview(webSearchPreview)`. */
+        fun addTool(webSearchPreview: BetaWebSearchPreviewTool) = apply {
+            body.addTool(webSearchPreview)
+        }
+
+        /** Alias for calling [addTool] with `BetaTool.ofApplyPatch(applyPatch)`. */
+        fun addTool(applyPatch: BetaApplyPatchTool) = apply { body.addTool(applyPatch) }
+
+        /**
+         * The truncation strategy to use for the model response. - `auto`: If the input to this
+         * Response exceeds the model's context window size, the model will truncate the response to
+         * fit the context window by dropping items from the beginning of the conversation. -
+         * `disabled` (default): If the input size will exceed the context window size for a model,
+         * the request will fail with a 400 error.
+         */
+        @Deprecated("deprecated")
+        fun truncation(truncation: Truncation) = apply { body.truncation(truncation) }
+
+        /**
+         * Sets [Builder.truncation] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.truncation] with a well-typed [Truncation] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        @Deprecated("deprecated")
+        fun truncation(truncation: JsonField<Truncation>) = apply { body.truncation(truncation) }
+
+        fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
+            body.additionalProperties(additionalBodyProperties)
+        }
+
+        fun putAdditionalBodyProperty(key: String, value: JsonValue) = apply {
+            body.putAdditionalProperty(key, value)
+        }
+
+        fun putAllAdditionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) =
+            apply {
+                body.putAllAdditionalProperties(additionalBodyProperties)
+            }
+
+        fun removeAdditionalBodyProperty(key: String) = apply { body.removeAdditionalProperty(key) }
+
+        fun removeAllAdditionalBodyProperties(keys: Set<String>) = apply {
+            body.removeAllAdditionalProperties(keys)
+        }
+
+        fun additionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun additionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.clear()
+            putAllAdditionalHeaders(additionalHeaders)
+        }
+
+        fun putAdditionalHeader(name: String, value: String) = apply {
+            additionalHeaders.put(name, value)
+        }
+
+        fun putAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.put(name, values)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun putAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.putAll(additionalHeaders)
+        }
+
+        fun replaceAdditionalHeaders(name: String, value: String) = apply {
+            additionalHeaders.replace(name, value)
+        }
+
+        fun replaceAdditionalHeaders(name: String, values: Iterable<String>) = apply {
+            additionalHeaders.replace(name, values)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Headers) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun replaceAllAdditionalHeaders(additionalHeaders: Map<String, Iterable<String>>) = apply {
+            this.additionalHeaders.replaceAll(additionalHeaders)
+        }
+
+        fun removeAdditionalHeaders(name: String) = apply { additionalHeaders.remove(name) }
+
+        fun removeAllAdditionalHeaders(names: Set<String>) = apply {
+            additionalHeaders.removeAll(names)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun additionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) = apply {
+            this.additionalQueryParams.clear()
+            putAllAdditionalQueryParams(additionalQueryParams)
+        }
+
+        fun putAdditionalQueryParam(key: String, value: String) = apply {
+            additionalQueryParams.put(key, value)
+        }
+
+        fun putAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.put(key, values)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.putAll(additionalQueryParams)
+        }
+
+        fun putAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.putAll(additionalQueryParams)
+            }
+
+        fun replaceAdditionalQueryParams(key: String, value: String) = apply {
+            additionalQueryParams.replace(key, value)
+        }
+
+        fun replaceAdditionalQueryParams(key: String, values: Iterable<String>) = apply {
+            additionalQueryParams.replace(key, values)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: QueryParams) = apply {
+            this.additionalQueryParams.replaceAll(additionalQueryParams)
+        }
+
+        fun replaceAllAdditionalQueryParams(additionalQueryParams: Map<String, Iterable<String>>) =
+            apply {
+                this.additionalQueryParams.replaceAll(additionalQueryParams)
+            }
+
+        fun removeAdditionalQueryParams(key: String) = apply { additionalQueryParams.remove(key) }
+
+        fun removeAllAdditionalQueryParams(keys: Set<String>) = apply {
+            additionalQueryParams.removeAll(keys)
+        }
+
+        /**
+         * Returns an immutable instance of [InputTokenCountParams].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         */
+        fun build(): InputTokenCountParams =
+            InputTokenCountParams(
+                betas?.toImmutable(),
+                body.build(),
+                additionalHeaders.build(),
+                additionalQueryParams.build(),
+            )
+    }
+
+    fun _body(): Body = body
+
+    override fun _headers(): Headers =
+        Headers.builder()
+            .apply {
+                betas?.forEach { put("openai-beta", it.toString()) }
+                putAll(additionalHeaders)
+            }
+            .build()
+
+    override fun _queryParams(): QueryParams = additionalQueryParams
+
+    class Body
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val conversation: JsonField<Conversation>,
+        private val input: JsonField<Input>,
+        private val instructions: JsonField<String>,
+        private val model: JsonField<String>,
+        private val parallelToolCalls: JsonField<Boolean>,
+        private val personality: JsonField<Personality>,
+        private val previousResponseId: JsonField<String>,
+        private val reasoning: JsonField<Reasoning>,
+        private val text: JsonField<Text>,
+        private val toolChoice: JsonField<ToolChoice>,
+        private val tools: JsonField<List<BetaTool>>,
+        private val truncation: JsonField<Truncation>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("conversation")
+            @ExcludeMissing
+            conversation: JsonField<Conversation> = JsonMissing.of(),
+            @JsonProperty("input") @ExcludeMissing input: JsonField<Input> = JsonMissing.of(),
+            @JsonProperty("instructions")
+            @ExcludeMissing
+            instructions: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("model") @ExcludeMissing model: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("parallel_tool_calls")
+            @ExcludeMissing
+            parallelToolCalls: JsonField<Boolean> = JsonMissing.of(),
+            @JsonProperty("personality")
+            @ExcludeMissing
+            personality: JsonField<Personality> = JsonMissing.of(),
+            @JsonProperty("previous_response_id")
+            @ExcludeMissing
+            previousResponseId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("reasoning")
+            @ExcludeMissing
+            reasoning: JsonField<Reasoning> = JsonMissing.of(),
+            @JsonProperty("text") @ExcludeMissing text: JsonField<Text> = JsonMissing.of(),
+            @JsonProperty("tool_choice")
+            @ExcludeMissing
+            toolChoice: JsonField<ToolChoice> = JsonMissing.of(),
+            @JsonProperty("tools")
+            @ExcludeMissing
+            tools: JsonField<List<BetaTool>> = JsonMissing.of(),
+            @JsonProperty("truncation")
+            @ExcludeMissing
+            truncation: JsonField<Truncation> = JsonMissing.of(),
+        ) : this(
+            conversation,
+            input,
+            instructions,
+            model,
+            parallelToolCalls,
+            personality,
+            previousResponseId,
+            reasoning,
+            text,
+            toolChoice,
+            tools,
+            truncation,
+            mutableMapOf(),
+        )
+
+        /**
+         * The conversation that this response belongs to. Items from this conversation are
+         * prepended to `input_items` for this response request. Input items and output items from
+         * this response are automatically added to this conversation after this response completes.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun conversation(): Optional<Conversation> = conversation.getOptional("conversation")
+
+        /**
+         * Text, image, or file inputs to the model, used to generate a response
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun input(): Optional<Input> = input.getOptional("input")
+
+        /**
+         * A system (or developer) message inserted into the model's context. When used along with
+         * `previous_response_id`, the instructions from a previous response will not be carried
+         * over to the next response. This makes it simple to swap out system (or developer)
+         * messages in new responses.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun instructions(): Optional<String> = instructions.getOptional("instructions")
+
+        /**
+         * Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide range
+         * of models with different capabilities, performance characteristics, and price points.
+         * Refer to the [model guide](https://platform.openai.com/docs/models) to browse and compare
+         * available models.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun model(): Optional<String> = model.getOptional("model")
+
+        /**
+         * Whether to allow the model to run tool calls in parallel.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun parallelToolCalls(): Optional<Boolean> =
+            parallelToolCalls.getOptional("parallel_tool_calls")
+
+        /**
+         * A model-owned style preset to apply to this request. Omit this parameter to use the
+         * model's default style. Supported values may expand over time. Values must be at most 64
+         * characters.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun personality(): Optional<Personality> = personality.getOptional("personality")
+
+        /**
+         * The unique ID of the previous response to the model. Use this to create multi-turn
+         * conversations. Learn more about
+         * [conversation state](https://platform.openai.com/docs/guides/conversation-state). Cannot
+         * be used in conjunction with `conversation`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun previousResponseId(): Optional<String> =
+            previousResponseId.getOptional("previous_response_id")
+
+        /**
+         * **gpt-5 and o-series models only** Configuration options for
+         * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun reasoning(): Optional<Reasoning> = reasoning.getOptional("reasoning")
+
+        /**
+         * Configuration options for a text response from the model. Can be plain text or structured
+         * JSON data. Learn more:
+         * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+         * - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun text(): Optional<Text> = text.getOptional("text")
+
+        /**
+         * Controls which tool the model should use, if any.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun toolChoice(): Optional<ToolChoice> = toolChoice.getOptional("tool_choice")
+
+        /**
+         * An array of tools the model may call while generating a response. You can specify which
+         * tool to use by setting the `tool_choice` parameter.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun tools(): Optional<List<BetaTool>> = tools.getOptional("tools")
+
+        /**
+         * The truncation strategy to use for the model response. - `auto`: If the input to this
+         * Response exceeds the model's context window size, the model will truncate the response to
+         * fit the context window by dropping items from the beginning of the conversation. -
+         * `disabled` (default): If the input size will exceed the context window size for a model,
+         * the request will fail with a 400 error.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        @Deprecated("deprecated")
+        fun truncation(): Optional<Truncation> = truncation.getOptional("truncation")
+
+        /**
+         * Returns the raw JSON value of [conversation].
+         *
+         * Unlike [conversation], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("conversation")
+        @ExcludeMissing
+        fun _conversation(): JsonField<Conversation> = conversation
+
+        /**
+         * Returns the raw JSON value of [input].
+         *
+         * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("input") @ExcludeMissing fun _input(): JsonField<Input> = input
+
+        /**
+         * Returns the raw JSON value of [instructions].
+         *
+         * Unlike [instructions], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("instructions")
+        @ExcludeMissing
+        fun _instructions(): JsonField<String> = instructions
+
+        /**
+         * Returns the raw JSON value of [model].
+         *
+         * Unlike [model], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("model") @ExcludeMissing fun _model(): JsonField<String> = model
+
+        /**
+         * Returns the raw JSON value of [parallelToolCalls].
+         *
+         * Unlike [parallelToolCalls], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("parallel_tool_calls")
+        @ExcludeMissing
+        fun _parallelToolCalls(): JsonField<Boolean> = parallelToolCalls
+
+        /**
+         * Returns the raw JSON value of [personality].
+         *
+         * Unlike [personality], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("personality")
+        @ExcludeMissing
+        fun _personality(): JsonField<Personality> = personality
+
+        /**
+         * Returns the raw JSON value of [previousResponseId].
+         *
+         * Unlike [previousResponseId], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @JsonProperty("previous_response_id")
+        @ExcludeMissing
+        fun _previousResponseId(): JsonField<String> = previousResponseId
+
+        /**
+         * Returns the raw JSON value of [reasoning].
+         *
+         * Unlike [reasoning], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("reasoning")
+        @ExcludeMissing
+        fun _reasoning(): JsonField<Reasoning> = reasoning
+
+        /**
+         * Returns the raw JSON value of [text].
+         *
+         * Unlike [text], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<Text> = text
+
+        /**
+         * Returns the raw JSON value of [toolChoice].
+         *
+         * Unlike [toolChoice], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("tool_choice")
+        @ExcludeMissing
+        fun _toolChoice(): JsonField<ToolChoice> = toolChoice
+
+        /**
+         * Returns the raw JSON value of [tools].
+         *
+         * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<BetaTool>> = tools
+
+        /**
+         * Returns the raw JSON value of [truncation].
+         *
+         * Unlike [truncation], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @Deprecated("deprecated")
+        @JsonProperty("truncation")
+        @ExcludeMissing
+        fun _truncation(): JsonField<Truncation> = truncation
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Body]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Body]. */
+        class Builder internal constructor() {
+
+            private var conversation: JsonField<Conversation> = JsonMissing.of()
+            private var input: JsonField<Input> = JsonMissing.of()
+            private var instructions: JsonField<String> = JsonMissing.of()
+            private var model: JsonField<String> = JsonMissing.of()
+            private var parallelToolCalls: JsonField<Boolean> = JsonMissing.of()
+            private var personality: JsonField<Personality> = JsonMissing.of()
+            private var previousResponseId: JsonField<String> = JsonMissing.of()
+            private var reasoning: JsonField<Reasoning> = JsonMissing.of()
+            private var text: JsonField<Text> = JsonMissing.of()
+            private var toolChoice: JsonField<ToolChoice> = JsonMissing.of()
+            private var tools: JsonField<MutableList<BetaTool>>? = null
+            private var truncation: JsonField<Truncation> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(body: Body) = apply {
+                conversation = body.conversation
+                input = body.input
+                instructions = body.instructions
+                model = body.model
+                parallelToolCalls = body.parallelToolCalls
+                personality = body.personality
+                previousResponseId = body.previousResponseId
+                reasoning = body.reasoning
+                text = body.text
+                toolChoice = body.toolChoice
+                tools = body.tools.map { it.toMutableList() }
+                truncation = body.truncation
+                additionalProperties = body.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * The conversation that this response belongs to. Items from this conversation are
+             * prepended to `input_items` for this response request. Input items and output items
+             * from this response are automatically added to this conversation after this response
+             * completes.
+             */
+            fun conversation(conversation: Conversation?) =
+                conversation(JsonField.ofNullable(conversation))
+
+            /** Alias for calling [Builder.conversation] with `conversation.orElse(null)`. */
+            fun conversation(conversation: Optional<Conversation>) =
+                conversation(conversation.getOrNull())
+
+            /**
+             * Sets [Builder.conversation] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.conversation] with a well-typed [Conversation] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun conversation(conversation: JsonField<Conversation>) = apply {
+                this.conversation = conversation
+            }
+
+            /** Alias for calling [conversation] with `Conversation.ofId(id)`. */
+            fun conversation(id: String) = conversation(Conversation.ofId(id))
+
+            /**
+             * Alias for calling [conversation] with
+             * `Conversation.ofBetaResponseConversationParam(betaResponseConversationParam)`.
+             */
+            fun conversation(betaResponseConversationParam: BetaResponseConversationParam) =
+                conversation(
+                    Conversation.ofBetaResponseConversationParam(betaResponseConversationParam)
+                )
+
+            /** Text, image, or file inputs to the model, used to generate a response */
+            fun input(input: Input?) = input(JsonField.ofNullable(input))
+
+            /** Alias for calling [Builder.input] with `input.orElse(null)`. */
+            fun input(input: Optional<Input>) = input(input.getOrNull())
+
+            /**
+             * Sets [Builder.input] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.input] with a well-typed [Input] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun input(input: JsonField<Input>) = apply { this.input = input }
+
+            /** Alias for calling [input] with `Input.ofString(string)`. */
+            fun input(string: String) = input(Input.ofString(string))
+
+            /**
+             * Alias for calling [input] with
+             * `Input.ofBetaResponseInputItems(betaResponseInputItems)`.
+             */
+            fun inputOfBetaResponseInputItems(betaResponseInputItems: List<BetaResponseInputItem>) =
+                input(Input.ofBetaResponseInputItems(betaResponseInputItems))
+
+            /**
+             * A system (or developer) message inserted into the model's context. When used along
+             * with `previous_response_id`, the instructions from a previous response will not be
+             * carried over to the next response. This makes it simple to swap out system (or
+             * developer) messages in new responses.
+             */
+            fun instructions(instructions: String?) =
+                instructions(JsonField.ofNullable(instructions))
+
+            /** Alias for calling [Builder.instructions] with `instructions.orElse(null)`. */
+            fun instructions(instructions: Optional<String>) =
+                instructions(instructions.getOrNull())
+
+            /**
+             * Sets [Builder.instructions] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.instructions] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun instructions(instructions: JsonField<String>) = apply {
+                this.instructions = instructions
+            }
+
+            /**
+             * Model ID used to generate the response, like `gpt-4o` or `o3`. OpenAI offers a wide
+             * range of models with different capabilities, performance characteristics, and price
+             * points. Refer to the [model guide](https://platform.openai.com/docs/models) to browse
+             * and compare available models.
+             */
+            fun model(model: String?) = model(JsonField.ofNullable(model))
+
+            /** Alias for calling [Builder.model] with `model.orElse(null)`. */
+            fun model(model: Optional<String>) = model(model.getOrNull())
+
+            /**
+             * Sets [Builder.model] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.model] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun model(model: JsonField<String>) = apply { this.model = model }
+
+            /** Whether to allow the model to run tool calls in parallel. */
+            fun parallelToolCalls(parallelToolCalls: Boolean?) =
+                parallelToolCalls(JsonField.ofNullable(parallelToolCalls))
+
+            /**
+             * Alias for [Builder.parallelToolCalls].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun parallelToolCalls(parallelToolCalls: Boolean) =
+                parallelToolCalls(parallelToolCalls as Boolean?)
+
+            /**
+             * Alias for calling [Builder.parallelToolCalls] with `parallelToolCalls.orElse(null)`.
+             */
+            fun parallelToolCalls(parallelToolCalls: Optional<Boolean>) =
+                parallelToolCalls(parallelToolCalls.getOrNull())
+
+            /**
+             * Sets [Builder.parallelToolCalls] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.parallelToolCalls] with a well-typed [Boolean] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun parallelToolCalls(parallelToolCalls: JsonField<Boolean>) = apply {
+                this.parallelToolCalls = parallelToolCalls
+            }
+
+            /**
+             * A model-owned style preset to apply to this request. Omit this parameter to use the
+             * model's default style. Supported values may expand over time. Values must be at most
+             * 64 characters.
+             */
+            fun personality(personality: Personality) = personality(JsonField.of(personality))
+
+            /**
+             * Sets [Builder.personality] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.personality] with a well-typed [Personality] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun personality(personality: JsonField<Personality>) = apply {
+                this.personality = personality
+            }
+
+            /**
+             * Sets [personality] to an arbitrary [String].
+             *
+             * You should usually call [personality] with a well-typed [Personality] constant
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun personality(value: String) = personality(Personality.of(value))
+
+            /**
+             * The unique ID of the previous response to the model. Use this to create multi-turn
+             * conversations. Learn more about
+             * [conversation state](https://platform.openai.com/docs/guides/conversation-state).
+             * Cannot be used in conjunction with `conversation`.
+             */
+            fun previousResponseId(previousResponseId: String?) =
+                previousResponseId(JsonField.ofNullable(previousResponseId))
+
+            /**
+             * Alias for calling [Builder.previousResponseId] with
+             * `previousResponseId.orElse(null)`.
+             */
+            fun previousResponseId(previousResponseId: Optional<String>) =
+                previousResponseId(previousResponseId.getOrNull())
+
+            /**
+             * Sets [Builder.previousResponseId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.previousResponseId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun previousResponseId(previousResponseId: JsonField<String>) = apply {
+                this.previousResponseId = previousResponseId
+            }
+
+            /**
+             * **gpt-5 and o-series models only** Configuration options for
+             * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+             */
+            fun reasoning(reasoning: Reasoning?) = reasoning(JsonField.ofNullable(reasoning))
+
+            /** Alias for calling [Builder.reasoning] with `reasoning.orElse(null)`. */
+            fun reasoning(reasoning: Optional<Reasoning>) = reasoning(reasoning.getOrNull())
+
+            /**
+             * Sets [Builder.reasoning] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.reasoning] with a well-typed [Reasoning] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun reasoning(reasoning: JsonField<Reasoning>) = apply { this.reasoning = reasoning }
+
+            /**
+             * Configuration options for a text response from the model. Can be plain text or
+             * structured JSON data. Learn more:
+             * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+             * - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+             */
+            fun text(text: Text?) = text(JsonField.ofNullable(text))
+
+            /** Alias for calling [Builder.text] with `text.orElse(null)`. */
+            fun text(text: Optional<Text>) = text(text.getOrNull())
+
+            /**
+             * Sets [Builder.text] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.text] with a well-typed [Text] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun text(text: JsonField<Text>) = apply { this.text = text }
+
+            /** Controls which tool the model should use, if any. */
+            fun toolChoice(toolChoice: ToolChoice?) = toolChoice(JsonField.ofNullable(toolChoice))
+
+            /** Alias for calling [Builder.toolChoice] with `toolChoice.orElse(null)`. */
+            fun toolChoice(toolChoice: Optional<ToolChoice>) = toolChoice(toolChoice.getOrNull())
+
+            /**
+             * Sets [Builder.toolChoice] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.toolChoice] with a well-typed [ToolChoice] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun toolChoice(toolChoice: JsonField<ToolChoice>) = apply {
+                this.toolChoice = toolChoice
+            }
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceOptions(betaToolChoiceOptions)`.
+             */
+            fun toolChoice(betaToolChoiceOptions: BetaToolChoiceOptions) =
+                toolChoice(ToolChoice.ofBetaToolChoiceOptions(betaToolChoiceOptions))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceAllowed(betaToolChoiceAllowed)`.
+             */
+            fun toolChoice(betaToolChoiceAllowed: BetaToolChoiceAllowed) =
+                toolChoice(ToolChoice.ofBetaToolChoiceAllowed(betaToolChoiceAllowed))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceTypes(betaToolChoiceTypes)`.
+             */
+            fun toolChoice(betaToolChoiceTypes: BetaToolChoiceTypes) =
+                toolChoice(ToolChoice.ofBetaToolChoiceTypes(betaToolChoiceTypes))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceFunction(betaToolChoiceFunction)`.
+             */
+            fun toolChoice(betaToolChoiceFunction: BetaToolChoiceFunction) =
+                toolChoice(ToolChoice.ofBetaToolChoiceFunction(betaToolChoiceFunction))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceMcp(betaToolChoiceMcp)`.
+             */
+            fun toolChoice(betaToolChoiceMcp: BetaToolChoiceMcp) =
+                toolChoice(ToolChoice.ofBetaToolChoiceMcp(betaToolChoiceMcp))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceCustom(betaToolChoiceCustom)`.
+             */
+            fun toolChoice(betaToolChoiceCustom: BetaToolChoiceCustom) =
+                toolChoice(ToolChoice.ofBetaToolChoiceCustom(betaToolChoiceCustom))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaSpecificProgrammaticToolCallingParam()`.
+             */
+            fun toolChoiceBetaSpecificProgrammaticToolCallingParam() =
+                toolChoice(ToolChoice.ofBetaSpecificProgrammaticToolCallingParam())
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch)`.
+             */
+            fun toolChoice(betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch) =
+                toolChoice(ToolChoice.ofBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch))
+
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofBetaToolChoiceShell(betaToolChoiceShell)`.
+             */
+            fun toolChoice(betaToolChoiceShell: BetaToolChoiceShell) =
+                toolChoice(ToolChoice.ofBetaToolChoiceShell(betaToolChoiceShell))
+
+            /**
+             * An array of tools the model may call while generating a response. You can specify
+             * which tool to use by setting the `tool_choice` parameter.
+             */
+            fun tools(tools: List<BetaTool>?) = tools(JsonField.ofNullable(tools))
+
+            /** Alias for calling [Builder.tools] with `tools.orElse(null)`. */
+            fun tools(tools: Optional<List<BetaTool>>) = tools(tools.getOrNull())
+
+            /**
+             * Sets [Builder.tools] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.tools] with a well-typed `List<BetaTool>` value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun tools(tools: JsonField<List<BetaTool>>) = apply {
+                this.tools = tools.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [BetaTool] to [tools].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addTool(tool: BetaTool) = apply {
+                tools =
+                    (tools ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("tools", it).add(tool)
+                    }
+            }
+
+            /** Alias for calling [addTool] with `BetaTool.ofFunction(function)`. */
+            fun addTool(function: BetaFunctionTool) = addTool(BetaTool.ofFunction(function))
+
+            /** Alias for calling [addTool] with `BetaTool.ofFileSearch(fileSearch)`. */
+            fun addTool(fileSearch: BetaFileSearchTool) = addTool(BetaTool.ofFileSearch(fileSearch))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaFileSearchTool.builder()
+             *     .vectorStoreIds(vectorStoreIds)
+             *     .build()
+             * ```
+             */
+            fun addFileSearchTool(vectorStoreIds: List<String>) =
+                addTool(BetaFileSearchTool.builder().vectorStoreIds(vectorStoreIds).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofComputer(computer)`. */
+            fun addTool(computer: BetaComputerTool) = addTool(BetaTool.ofComputer(computer))
+
+            /**
+             * Alias for calling [addTool] with `BetaTool.ofComputerUsePreview(computerUsePreview)`.
+             */
+            fun addTool(computerUsePreview: BetaComputerUsePreviewTool) =
+                addTool(BetaTool.ofComputerUsePreview(computerUsePreview))
+
+            /** Alias for calling [addTool] with `BetaTool.ofWebSearch(webSearch)`. */
+            fun addTool(webSearch: BetaWebSearchTool) = addTool(BetaTool.ofWebSearch(webSearch))
+
+            /** Alias for calling [addTool] with `BetaTool.ofMcp(mcp)`. */
+            fun addTool(mcp: BetaTool.Mcp) = addTool(BetaTool.ofMcp(mcp))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaTool.Mcp.builder()
+             *     .serverLabel(serverLabel)
+             *     .build()
+             * ```
+             */
+            fun addMcpTool(serverLabel: String) =
+                addTool(BetaTool.Mcp.builder().serverLabel(serverLabel).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofCodeInterpreter(codeInterpreter)`. */
+            fun addTool(codeInterpreter: BetaTool.CodeInterpreter) =
+                addTool(BetaTool.ofCodeInterpreter(codeInterpreter))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaTool.CodeInterpreter.builder()
+             *     .container(container)
+             *     .build()
+             * ```
+             */
+            fun addCodeInterpreterTool(container: BetaTool.CodeInterpreter.Container) =
+                addTool(BetaTool.CodeInterpreter.builder().container(container).build())
+
+            /**
+             * Alias for calling [addCodeInterpreterTool] with
+             * `BetaTool.CodeInterpreter.Container.ofString(string)`.
+             */
+            fun addCodeInterpreterTool(string: String) =
+                addCodeInterpreterTool(BetaTool.CodeInterpreter.Container.ofString(string))
+
+            /**
+             * Alias for calling [addCodeInterpreterTool] with
+             * `BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)`.
+             */
+            fun addCodeInterpreterTool(
+                codeInterpreterToolAuto: BetaTool.CodeInterpreter.Container.CodeInterpreterToolAuto
+            ) =
+                addCodeInterpreterTool(
+                    BetaTool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(
+                        codeInterpreterToolAuto
+                    )
+                )
+
+            /** Alias for calling [addTool] with `BetaTool.ofProgrammaticToolCalling()`. */
+            fun addToolProgrammaticToolCalling() = addTool(BetaTool.ofProgrammaticToolCalling())
+
+            /** Alias for calling [addTool] with `BetaTool.ofImageGeneration(imageGeneration)`. */
+            fun addTool(imageGeneration: BetaTool.ImageGeneration) =
+                addTool(BetaTool.ofImageGeneration(imageGeneration))
+
+            /** Alias for calling [addTool] with `BetaTool.ofLocalShell()`. */
+            fun addToolLocalShell() = addTool(BetaTool.ofLocalShell())
+
+            /** Alias for calling [addTool] with `BetaTool.ofShell(shell)`. */
+            fun addTool(shell: BetaFunctionShellTool) = addTool(BetaTool.ofShell(shell))
+
+            /** Alias for calling [addTool] with `BetaTool.ofCustom(custom)`. */
+            fun addTool(custom: BetaCustomTool) = addTool(BetaTool.ofCustom(custom))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * BetaCustomTool.builder()
+             *     .name(name)
+             *     .build()
+             * ```
+             */
+            fun addCustomTool(name: String) = addTool(BetaCustomTool.builder().name(name).build())
+
+            /** Alias for calling [addTool] with `BetaTool.ofNamespace(namespace)`. */
+            fun addTool(namespace: BetaNamespaceTool) = addTool(BetaTool.ofNamespace(namespace))
+
+            /** Alias for calling [addTool] with `BetaTool.ofToolSearch(toolSearch)`. */
+            fun addTool(toolSearch: BetaToolSearchTool) = addTool(BetaTool.ofToolSearch(toolSearch))
+
+            /** Alias for calling [addTool] with `BetaTool.ofWebSearchPreview(webSearchPreview)`. */
+            fun addTool(webSearchPreview: BetaWebSearchPreviewTool) =
+                addTool(BetaTool.ofWebSearchPreview(webSearchPreview))
+
+            /** Alias for calling [addTool] with `BetaTool.ofApplyPatch(applyPatch)`. */
+            fun addTool(applyPatch: BetaApplyPatchTool) = addTool(BetaTool.ofApplyPatch(applyPatch))
+
+            /**
+             * The truncation strategy to use for the model response. - `auto`: If the input to this
+             * Response exceeds the model's context window size, the model will truncate the
+             * response to fit the context window by dropping items from the beginning of the
+             * conversation. - `disabled` (default): If the input size will exceed the context
+             * window size for a model, the request will fail with a 400 error.
+             */
+            @Deprecated("deprecated")
+            fun truncation(truncation: Truncation) = truncation(JsonField.of(truncation))
+
+            /**
+             * Sets [Builder.truncation] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.truncation] with a well-typed [Truncation] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            @Deprecated("deprecated")
+            fun truncation(truncation: JsonField<Truncation>) = apply {
+                this.truncation = truncation
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Body].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Body =
+                Body(
+                    conversation,
+                    input,
+                    instructions,
+                    model,
+                    parallelToolCalls,
+                    personality,
+                    previousResponseId,
+                    reasoning,
+                    text,
+                    toolChoice,
+                    (tools ?: JsonMissing.of()).map { it.toImmutable() },
+                    truncation,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Body = apply {
+            if (validated) {
+                return@apply
+            }
+
+            conversation().ifPresent { it.validate() }
+            input().ifPresent { it.validate() }
+            instructions()
+            model()
+            parallelToolCalls()
+            personality()
+            previousResponseId()
+            reasoning().ifPresent { it.validate() }
+            text().ifPresent { it.validate() }
+            toolChoice().ifPresent { it.validate() }
+            tools().ifPresent { it.forEach { it.validate() } }
+            truncation().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (conversation.asKnown().getOrNull()?.validity() ?: 0) +
+                (input.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (instructions.asKnown().isPresent) 1 else 0) +
+                (if (model.asKnown().isPresent) 1 else 0) +
+                (if (parallelToolCalls.asKnown().isPresent) 1 else 0) +
+                (if (personality.asKnown().isPresent) 1 else 0) +
+                (if (previousResponseId.asKnown().isPresent) 1 else 0) +
+                (reasoning.asKnown().getOrNull()?.validity() ?: 0) +
+                (text.asKnown().getOrNull()?.validity() ?: 0) +
+                (toolChoice.asKnown().getOrNull()?.validity() ?: 0) +
+                (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                (truncation.asKnown().getOrNull()?.validity() ?: 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Body &&
+                conversation == other.conversation &&
+                input == other.input &&
+                instructions == other.instructions &&
+                model == other.model &&
+                parallelToolCalls == other.parallelToolCalls &&
+                personality == other.personality &&
+                previousResponseId == other.previousResponseId &&
+                reasoning == other.reasoning &&
+                text == other.text &&
+                toolChoice == other.toolChoice &&
+                tools == other.tools &&
+                truncation == other.truncation &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                conversation,
+                input,
+                instructions,
+                model,
+                parallelToolCalls,
+                personality,
+                previousResponseId,
+                reasoning,
+                text,
+                toolChoice,
+                tools,
+                truncation,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Body{conversation=$conversation, input=$input, instructions=$instructions, model=$model, parallelToolCalls=$parallelToolCalls, personality=$personality, previousResponseId=$previousResponseId, reasoning=$reasoning, text=$text, toolChoice=$toolChoice, tools=$tools, truncation=$truncation, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * The conversation that this response belongs to. Items from this conversation are prepended to
+     * `input_items` for this response request. Input items and output items from this response are
+     * automatically added to this conversation after this response completes.
+     */
+    @JsonDeserialize(using = Conversation.Deserializer::class)
+    @JsonSerialize(using = Conversation.Serializer::class)
+    class Conversation
+    private constructor(
+        private val id: String? = null,
+        private val betaResponseConversationParam: BetaResponseConversationParam? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** The unique ID of the conversation. */
+        fun id(): Optional<String> = Optional.ofNullable(id)
+
+        /** The conversation that this response belongs to. */
+        fun betaResponseConversationParam(): Optional<BetaResponseConversationParam> =
+            Optional.ofNullable(betaResponseConversationParam)
+
+        fun isId(): Boolean = id != null
+
+        fun isBetaResponseConversationParam(): Boolean = betaResponseConversationParam != null
+
+        /** The unique ID of the conversation. */
+        fun asId(): String = id.getOrThrow("id")
+
+        /** The conversation that this response belongs to. */
+        fun asBetaResponseConversationParam(): BetaResponseConversationParam =
+            betaResponseConversationParam.getOrThrow("betaResponseConversationParam")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = conversation.accept(new Conversation.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitId(String id) {
+         *         return Optional.of(id.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                id != null -> visitor.visitId(id)
+                betaResponseConversationParam != null ->
+                    visitor.visitBetaResponseConversationParam(betaResponseConversationParam)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Conversation = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitId(id: String) {}
+
+                    override fun visitBetaResponseConversationParam(
+                        betaResponseConversationParam: BetaResponseConversationParam
+                    ) {
+                        betaResponseConversationParam.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitId(id: String) = 1
+
+                    override fun visitBetaResponseConversationParam(
+                        betaResponseConversationParam: BetaResponseConversationParam
+                    ) = betaResponseConversationParam.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Conversation &&
+                id == other.id &&
+                betaResponseConversationParam == other.betaResponseConversationParam
+        }
+
+        override fun hashCode(): Int = Objects.hash(id, betaResponseConversationParam)
+
+        override fun toString(): String =
+            when {
+                id != null -> "Conversation{id=$id}"
+                betaResponseConversationParam != null ->
+                    "Conversation{betaResponseConversationParam=$betaResponseConversationParam}"
+                _json != null -> "Conversation{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Conversation")
+            }
+
+        companion object {
+
+            /** The unique ID of the conversation. */
+            @JvmStatic fun ofId(id: String) = Conversation(id = id)
+
+            /** The conversation that this response belongs to. */
+            @JvmStatic
+            fun ofBetaResponseConversationParam(
+                betaResponseConversationParam: BetaResponseConversationParam
+            ) = Conversation(betaResponseConversationParam = betaResponseConversationParam)
+        }
+
+        /**
+         * An interface that defines how to map each variant of [Conversation] to a value of type
+         * [T].
+         */
+        interface Visitor<out T> {
+
+            /** The unique ID of the conversation. */
+            fun visitId(id: String): T
+
+            /** The conversation that this response belongs to. */
+            fun visitBetaResponseConversationParam(
+                betaResponseConversationParam: BetaResponseConversationParam
+            ): T
+
+            /**
+             * Maps an unknown variant of [Conversation] to a value of type [T].
+             *
+             * An instance of [Conversation] can contain an unknown variant if it was deserialized
+             * from data that doesn't match any known variant. For example, if the SDK is on an
+             * older version than the API, then the API may respond with new variants that the SDK
+             * is unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Conversation: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Conversation>(Conversation::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Conversation {
+                val json = JsonValue.fromJsonNode(node)
+
+                val bestMatches =
+                    sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<BetaResponseConversationParam>())
+                                ?.let {
+                                    Conversation(betaResponseConversationParam = it, _json = json)
+                                },
+                            tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                Conversation(id = it, _json = json)
+                            },
+                        )
+                        .filterNotNull()
+                        .allMaxBy { it.validity() }
+                        .toList()
+                return when (bestMatches.size) {
+                    // This can happen if what we're deserializing is completely incompatible with
+                    // all the possible variants (e.g. deserializing from boolean).
+                    0 -> Conversation(_json = json)
+                    1 -> bestMatches.single()
+                    // If there's more than one match with the highest validity, then use the first
+                    // completely valid match, or simply the first match if none are completely
+                    // valid.
+                    else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                }
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Conversation>(Conversation::class) {
+
+            override fun serialize(
+                value: Conversation,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.id != null -> generator.writeObject(value.id)
+                    value.betaResponseConversationParam != null ->
+                        generator.writeObject(value.betaResponseConversationParam)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Conversation")
+                }
+            }
+        }
+    }
+
+    /** Text, image, or file inputs to the model, used to generate a response */
+    @JsonDeserialize(using = Input.Deserializer::class)
+    @JsonSerialize(using = Input.Serializer::class)
+    class Input
+    private constructor(
+        private val string: String? = null,
+        private val betaResponseInputItems: List<BetaResponseInputItem>? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /** A text input to the model, equivalent to a text input with the `user` role. */
+        fun string(): Optional<String> = Optional.ofNullable(string)
+
+        /** A list of one or many input items to the model, containing different content types. */
+        fun betaResponseInputItems(): Optional<List<BetaResponseInputItem>> =
+            Optional.ofNullable(betaResponseInputItems)
+
+        fun isString(): Boolean = string != null
+
+        fun isBetaResponseInputItems(): Boolean = betaResponseInputItems != null
+
+        /** A text input to the model, equivalent to a text input with the `user` role. */
+        fun asString(): String = string.getOrThrow("string")
+
+        /** A list of one or many input items to the model, containing different content types. */
+        fun asBetaResponseInputItems(): List<BetaResponseInputItem> =
+            betaResponseInputItems.getOrThrow("betaResponseInputItems")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = input.accept(new Input.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitString(String string) {
+         *         return Optional.of(string.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                string != null -> visitor.visitString(string)
+                betaResponseInputItems != null ->
+                    visitor.visitBetaResponseInputItems(betaResponseInputItems)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Input = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitString(string: String) {}
+
+                    override fun visitBetaResponseInputItems(
+                        betaResponseInputItems: List<BetaResponseInputItem>
+                    ) {
+                        betaResponseInputItems.forEach { it.validate() }
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitString(string: String) = 1
+
+                    override fun visitBetaResponseInputItems(
+                        betaResponseInputItems: List<BetaResponseInputItem>
+                    ) = betaResponseInputItems.sumOf { it.validity().toInt() }
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Input &&
+                string == other.string &&
+                betaResponseInputItems == other.betaResponseInputItems
+        }
+
+        override fun hashCode(): Int = Objects.hash(string, betaResponseInputItems)
+
+        override fun toString(): String =
+            when {
+                string != null -> "Input{string=$string}"
+                betaResponseInputItems != null ->
+                    "Input{betaResponseInputItems=$betaResponseInputItems}"
+                _json != null -> "Input{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Input")
+            }
+
+        companion object {
+
+            /** A text input to the model, equivalent to a text input with the `user` role. */
+            @JvmStatic fun ofString(string: String) = Input(string = string)
+
+            /**
+             * A list of one or many input items to the model, containing different content types.
+             */
+            @JvmStatic
+            fun ofBetaResponseInputItems(betaResponseInputItems: List<BetaResponseInputItem>) =
+                Input(betaResponseInputItems = betaResponseInputItems.toImmutable())
+        }
+
+        /** An interface that defines how to map each variant of [Input] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            /** A text input to the model, equivalent to a text input with the `user` role. */
+            fun visitString(string: String): T
+
+            /**
+             * A list of one or many input items to the model, containing different content types.
+             */
+            fun visitBetaResponseInputItems(betaResponseInputItems: List<BetaResponseInputItem>): T
+
+            /**
+             * Maps an unknown variant of [Input] to a value of type [T].
+             *
+             * An instance of [Input] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Input: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Input>(Input::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Input {
+                val json = JsonValue.fromJsonNode(node)
+
+                val bestMatches =
+                    sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<String>())?.let {
+                                Input(string = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<List<BetaResponseInputItem>>())
+                                ?.let { Input(betaResponseInputItems = it, _json = json) },
+                        )
+                        .filterNotNull()
+                        .allMaxBy { it.validity() }
+                        .toList()
+                return when (bestMatches.size) {
+                    // This can happen if what we're deserializing is completely incompatible with
+                    // all the possible variants (e.g. deserializing from boolean).
+                    0 -> Input(_json = json)
+                    1 -> bestMatches.single()
+                    // If there's more than one match with the highest validity, then use the first
+                    // completely valid match, or simply the first match if none are completely
+                    // valid.
+                    else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                }
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Input>(Input::class) {
+
+            override fun serialize(
+                value: Input,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.string != null -> generator.writeObject(value.string)
+                    value.betaResponseInputItems != null ->
+                        generator.writeObject(value.betaResponseInputItems)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Input")
+                }
+            }
+        }
+    }
+
+    /**
+     * A model-owned style preset to apply to this request. Omit this parameter to use the model's
+     * default style. Supported values may expand over time. Values must be at most 64 characters.
+     */
+    class Personality @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val FRIENDLY = of("friendly")
+
+            @JvmField val PRAGMATIC = of("pragmatic")
+
+            @JvmStatic fun of(value: String) = Personality(JsonField.of(value))
+        }
+
+        /** An enum containing [Personality]'s known values. */
+        enum class Known {
+            FRIENDLY,
+            PRAGMATIC,
+        }
+
+        /**
+         * An enum containing [Personality]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Personality] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            FRIENDLY,
+            PRAGMATIC,
+            /**
+             * An enum member indicating that [Personality] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                FRIENDLY -> Value.FRIENDLY
+                PRAGMATIC -> Value.PRAGMATIC
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                FRIENDLY -> Known.FRIENDLY
+                PRAGMATIC -> Known.PRAGMATIC
+                else -> throw OpenAIInvalidDataException("Unknown Personality: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Personality = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Personality && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /**
+     * **gpt-5 and o-series models only** Configuration options for
+     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
+     */
+    class Reasoning
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val context: JsonField<Context>,
+        private val effort: JsonField<Effort>,
+        private val generateSummary: JsonField<GenerateSummary>,
+        private val mode: JsonField<Mode>,
+        private val summary: JsonField<Summary>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("context") @ExcludeMissing context: JsonField<Context> = JsonMissing.of(),
+            @JsonProperty("effort") @ExcludeMissing effort: JsonField<Effort> = JsonMissing.of(),
+            @JsonProperty("generate_summary")
+            @ExcludeMissing
+            generateSummary: JsonField<GenerateSummary> = JsonMissing.of(),
+            @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of(),
+            @JsonProperty("summary") @ExcludeMissing summary: JsonField<Summary> = JsonMissing.of(),
+        ) : this(context, effort, generateSummary, mode, summary, mutableMapOf())
+
+        /**
+         * Controls which reasoning items are rendered back to the model on later turns. When
+         * returned on a response, this is the effective reasoning context mode used for the
+         * response.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun context(): Optional<Context> = context.getOptional("context")
+
+        /**
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun effort(): Optional<Effort> = effort.getOptional("effort")
+
+        /**
+         * **Deprecated:** use `summary` instead.
+         *
+         * A summary of the reasoning performed by the model. This can be useful for debugging and
+         * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        @Deprecated("deprecated")
+        fun generateSummary(): Optional<GenerateSummary> =
+            generateSummary.getOptional("generate_summary")
+
+        /**
+         * Controls the reasoning execution mode for the request.
+         *
+         * When returned on a response, this is the effective execution mode.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun mode(): Optional<Mode> = mode.getOptional("mode")
+
+        /**
+         * A summary of the reasoning performed by the model. This can be useful for debugging and
+         * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
+         *
+         * `concise` is supported for `computer-use-preview` models and all reasoning models after
+         * `gpt-5`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun summary(): Optional<Summary> = summary.getOptional("summary")
+
+        /**
+         * Returns the raw JSON value of [context].
+         *
+         * Unlike [context], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("context") @ExcludeMissing fun _context(): JsonField<Context> = context
+
+        /**
+         * Returns the raw JSON value of [effort].
+         *
+         * Unlike [effort], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("effort") @ExcludeMissing fun _effort(): JsonField<Effort> = effort
+
+        /**
+         * Returns the raw JSON value of [generateSummary].
+         *
+         * Unlike [generateSummary], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @Deprecated("deprecated")
+        @JsonProperty("generate_summary")
+        @ExcludeMissing
+        fun _generateSummary(): JsonField<GenerateSummary> = generateSummary
+
+        /**
+         * Returns the raw JSON value of [mode].
+         *
+         * Unlike [mode], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+        /**
+         * Returns the raw JSON value of [summary].
+         *
+         * Unlike [summary], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("summary") @ExcludeMissing fun _summary(): JsonField<Summary> = summary
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Reasoning]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Reasoning]. */
+        class Builder internal constructor() {
+
+            private var context: JsonField<Context> = JsonMissing.of()
+            private var effort: JsonField<Effort> = JsonMissing.of()
+            private var generateSummary: JsonField<GenerateSummary> = JsonMissing.of()
+            private var mode: JsonField<Mode> = JsonMissing.of()
+            private var summary: JsonField<Summary> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(reasoning: Reasoning) = apply {
+                context = reasoning.context
+                effort = reasoning.effort
+                generateSummary = reasoning.generateSummary
+                mode = reasoning.mode
+                summary = reasoning.summary
+                additionalProperties = reasoning.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Controls which reasoning items are rendered back to the model on later turns. When
+             * returned on a response, this is the effective reasoning context mode used for the
+             * response.
+             */
+            fun context(context: Context?) = context(JsonField.ofNullable(context))
+
+            /** Alias for calling [Builder.context] with `context.orElse(null)`. */
+            fun context(context: Optional<Context>) = context(context.getOrNull())
+
+            /**
+             * Sets [Builder.context] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.context] with a well-typed [Context] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun context(context: JsonField<Context>) = apply { this.context = context }
+
+            /**
+             * Constrains effort on reasoning for reasoning models. Currently supported values are
+             * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning
+             * effort can result in faster responses and fewer tokens used on reasoning in a
+             * response. Not all reasoning models support every value. See the
+             * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+             * model-specific support.
+             */
+            fun effort(effort: Effort?) = effort(JsonField.ofNullable(effort))
+
+            /** Alias for calling [Builder.effort] with `effort.orElse(null)`. */
+            fun effort(effort: Optional<Effort>) = effort(effort.getOrNull())
+
+            /**
+             * Sets [Builder.effort] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.effort] with a well-typed [Effort] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun effort(effort: JsonField<Effort>) = apply { this.effort = effort }
+
+            /**
+             * **Deprecated:** use `summary` instead.
+             *
+             * A summary of the reasoning performed by the model. This can be useful for debugging
+             * and understanding the model's reasoning process. One of `auto`, `concise`, or
+             * `detailed`.
+             */
+            @Deprecated("deprecated")
+            fun generateSummary(generateSummary: GenerateSummary?) =
+                generateSummary(JsonField.ofNullable(generateSummary))
+
+            /** Alias for calling [Builder.generateSummary] with `generateSummary.orElse(null)`. */
+            @Deprecated("deprecated")
+            fun generateSummary(generateSummary: Optional<GenerateSummary>) =
+                generateSummary(generateSummary.getOrNull())
+
+            /**
+             * Sets [Builder.generateSummary] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.generateSummary] with a well-typed [GenerateSummary]
+             * value instead. This method is primarily for setting the field to an undocumented or
+             * not yet supported value.
+             */
+            @Deprecated("deprecated")
+            fun generateSummary(generateSummary: JsonField<GenerateSummary>) = apply {
+                this.generateSummary = generateSummary
+            }
+
+            /**
+             * Controls the reasoning execution mode for the request.
+             *
+             * When returned on a response, this is the effective execution mode.
+             */
+            fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+            /**
+             * Sets [Builder.mode] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.mode] with a well-typed [Mode] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+            /**
+             * Sets [mode] to an arbitrary [String].
+             *
+             * You should usually call [mode] with a well-typed [Mode] constant instead. This method
+             * is primarily for setting the field to an undocumented or not yet supported value.
+             */
+            fun mode(value: String) = mode(Mode.of(value))
+
+            /**
+             * A summary of the reasoning performed by the model. This can be useful for debugging
+             * and understanding the model's reasoning process. One of `auto`, `concise`, or
+             * `detailed`.
+             *
+             * `concise` is supported for `computer-use-preview` models and all reasoning models
+             * after `gpt-5`.
+             */
+            fun summary(summary: Summary?) = summary(JsonField.ofNullable(summary))
+
+            /** Alias for calling [Builder.summary] with `summary.orElse(null)`. */
+            fun summary(summary: Optional<Summary>) = summary(summary.getOrNull())
+
+            /**
+             * Sets [Builder.summary] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.summary] with a well-typed [Summary] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun summary(summary: JsonField<Summary>) = apply { this.summary = summary }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Reasoning].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Reasoning =
+                Reasoning(
+                    context,
+                    effort,
+                    generateSummary,
+                    mode,
+                    summary,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Reasoning = apply {
+            if (validated) {
+                return@apply
+            }
+
+            context().ifPresent { it.validate() }
+            effort().ifPresent { it.validate() }
+            generateSummary().ifPresent { it.validate() }
+            mode()
+            summary().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (context.asKnown().getOrNull()?.validity() ?: 0) +
+                (effort.asKnown().getOrNull()?.validity() ?: 0) +
+                (generateSummary.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (mode.asKnown().isPresent) 1 else 0) +
+                (summary.asKnown().getOrNull()?.validity() ?: 0)
+
+        /**
+         * Controls which reasoning items are rendered back to the model on later turns. When
+         * returned on a response, this is the effective reasoning context mode used for the
+         * response.
+         */
+        class Context @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmField val CURRENT_TURN = of("current_turn")
+
+                @JvmField val ALL_TURNS = of("all_turns")
+
+                @JvmStatic fun of(value: String) = Context(JsonField.of(value))
+            }
+
+            /** An enum containing [Context]'s known values. */
+            enum class Known {
+                AUTO,
+                CURRENT_TURN,
+                ALL_TURNS,
+            }
+
+            /**
+             * An enum containing [Context]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Context] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                AUTO,
+                CURRENT_TURN,
+                ALL_TURNS,
+                /**
+                 * An enum member indicating that [Context] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    AUTO -> Value.AUTO
+                    CURRENT_TURN -> Value.CURRENT_TURN
+                    ALL_TURNS -> Value.ALL_TURNS
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    AUTO -> Known.AUTO
+                    CURRENT_TURN -> Known.CURRENT_TURN
+                    ALL_TURNS -> Known.ALL_TURNS
+                    else -> throw OpenAIInvalidDataException("Unknown Context: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Context = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Context && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
+         */
+        class Effort @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val NONE = of("none")
+
+                @JvmField val MINIMAL = of("minimal")
+
+                @JvmField val LOW = of("low")
+
+                @JvmField val MEDIUM = of("medium")
+
+                @JvmField val HIGH = of("high")
+
+                @JvmField val XHIGH = of("xhigh")
+
+                @JvmField val MAX = of("max")
+
+                @JvmStatic fun of(value: String) = Effort(JsonField.of(value))
+            }
+
+            /** An enum containing [Effort]'s known values. */
+            enum class Known {
+                NONE,
+                MINIMAL,
+                LOW,
+                MEDIUM,
+                HIGH,
+                XHIGH,
+                MAX,
+            }
+
+            /**
+             * An enum containing [Effort]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Effort] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                NONE,
+                MINIMAL,
+                LOW,
+                MEDIUM,
+                HIGH,
+                XHIGH,
+                MAX,
+                /**
+                 * An enum member indicating that [Effort] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    NONE -> Value.NONE
+                    MINIMAL -> Value.MINIMAL
+                    LOW -> Value.LOW
+                    MEDIUM -> Value.MEDIUM
+                    HIGH -> Value.HIGH
+                    XHIGH -> Value.XHIGH
+                    MAX -> Value.MAX
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    NONE -> Known.NONE
+                    MINIMAL -> Known.MINIMAL
+                    LOW -> Known.LOW
+                    MEDIUM -> Known.MEDIUM
+                    HIGH -> Known.HIGH
+                    XHIGH -> Known.XHIGH
+                    MAX -> Known.MAX
+                    else -> throw OpenAIInvalidDataException("Unknown Effort: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Effort = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Effort && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * **Deprecated:** use `summary` instead.
+         *
+         * A summary of the reasoning performed by the model. This can be useful for debugging and
+         * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
+         */
+        @Deprecated("deprecated")
+        class GenerateSummary
+        @JsonCreator
+        private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmField val CONCISE = of("concise")
+
+                @JvmField val DETAILED = of("detailed")
+
+                @JvmStatic fun of(value: String) = GenerateSummary(JsonField.of(value))
+            }
+
+            /** An enum containing [GenerateSummary]'s known values. */
+            enum class Known {
+                AUTO,
+                CONCISE,
+                DETAILED,
+            }
+
+            /**
+             * An enum containing [GenerateSummary]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [GenerateSummary] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                AUTO,
+                CONCISE,
+                DETAILED,
+                /**
+                 * An enum member indicating that [GenerateSummary] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    AUTO -> Value.AUTO
+                    CONCISE -> Value.CONCISE
+                    DETAILED -> Value.DETAILED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    AUTO -> Known.AUTO
+                    CONCISE -> Known.CONCISE
+                    DETAILED -> Known.DETAILED
+                    else -> throw OpenAIInvalidDataException("Unknown GenerateSummary: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): GenerateSummary = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is GenerateSummary && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * Controls the reasoning execution mode for the request.
+         *
+         * When returned on a response, this is the effective execution mode.
+         */
+        class Mode @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val STANDARD = of("standard")
+
+                @JvmField val PRO = of("pro")
+
+                @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+            }
+
+            /** An enum containing [Mode]'s known values. */
+            enum class Known {
+                STANDARD,
+                PRO,
+            }
+
+            /**
+             * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Mode] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                STANDARD,
+                PRO,
+                /** An enum member indicating that [Mode] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    STANDARD -> Value.STANDARD
+                    PRO -> Value.PRO
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    STANDARD -> Known.STANDARD
+                    PRO -> Known.PRO
+                    else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Mode = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Mode && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * A summary of the reasoning performed by the model. This can be useful for debugging and
+         * understanding the model's reasoning process. One of `auto`, `concise`, or `detailed`.
+         *
+         * `concise` is supported for `computer-use-preview` models and all reasoning models after
+         * `gpt-5`.
+         */
+        class Summary @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val AUTO = of("auto")
+
+                @JvmField val CONCISE = of("concise")
+
+                @JvmField val DETAILED = of("detailed")
+
+                @JvmStatic fun of(value: String) = Summary(JsonField.of(value))
+            }
+
+            /** An enum containing [Summary]'s known values. */
+            enum class Known {
+                AUTO,
+                CONCISE,
+                DETAILED,
+            }
+
+            /**
+             * An enum containing [Summary]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Summary] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                AUTO,
+                CONCISE,
+                DETAILED,
+                /**
+                 * An enum member indicating that [Summary] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    AUTO -> Value.AUTO
+                    CONCISE -> Value.CONCISE
+                    DETAILED -> Value.DETAILED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    AUTO -> Known.AUTO
+                    CONCISE -> Known.CONCISE
+                    DETAILED -> Known.DETAILED
+                    else -> throw OpenAIInvalidDataException("Unknown Summary: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Summary = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Summary && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Reasoning &&
+                context == other.context &&
+                effort == other.effort &&
+                generateSummary == other.generateSummary &&
+                mode == other.mode &&
+                summary == other.summary &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(context, effort, generateSummary, mode, summary, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Reasoning{context=$context, effort=$effort, generateSummary=$generateSummary, mode=$mode, summary=$summary, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Configuration options for a text response from the model. Can be plain text or structured
+     * JSON data. Learn more:
+     * - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)
+     * - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)
+     */
+    class Text
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val format: JsonField<BetaResponseFormatTextConfig>,
+        private val verbosity: JsonField<Verbosity>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("format")
+            @ExcludeMissing
+            format: JsonField<BetaResponseFormatTextConfig> = JsonMissing.of(),
+            @JsonProperty("verbosity")
+            @ExcludeMissing
+            verbosity: JsonField<Verbosity> = JsonMissing.of(),
+        ) : this(format, verbosity, mutableMapOf())
+
+        /**
+         * An object specifying the format that the model must output.
+         *
+         * Configuring `{ "type": "json_schema" }` enables Structured Outputs, which ensures the
+         * model will match your supplied JSON schema. Learn more in the
+         * [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+         *
+         * The default format is `{ "type": "text" }` with no additional options.
+         *
+         * **Not recommended for gpt-4o and newer models:**
+         *
+         * Setting to `{ "type": "json_object" }` enables the older JSON mode, which ensures the
+         * message the model generates is valid JSON. Using `json_schema` is preferred for models
+         * that support it.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun format(): Optional<BetaResponseFormatTextConfig> = format.getOptional("format")
+
+        /**
+         * Constrains the verbosity of the model's response. Lower values will result in more
+         * concise responses, while higher values will result in more verbose responses. Currently
+         * supported values are `low`, `medium`, and `high`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun verbosity(): Optional<Verbosity> = verbosity.getOptional("verbosity")
+
+        /**
+         * Returns the raw JSON value of [format].
+         *
+         * Unlike [format], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("format")
+        @ExcludeMissing
+        fun _format(): JsonField<BetaResponseFormatTextConfig> = format
+
+        /**
+         * Returns the raw JSON value of [verbosity].
+         *
+         * Unlike [verbosity], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("verbosity")
+        @ExcludeMissing
+        fun _verbosity(): JsonField<Verbosity> = verbosity
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [Text]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Text]. */
+        class Builder internal constructor() {
+
+            private var format: JsonField<BetaResponseFormatTextConfig> = JsonMissing.of()
+            private var verbosity: JsonField<Verbosity> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(text: Text) = apply {
+                format = text.format
+                verbosity = text.verbosity
+                additionalProperties = text.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * An object specifying the format that the model must output.
+             *
+             * Configuring `{ "type": "json_schema" }` enables Structured Outputs, which ensures the
+             * model will match your supplied JSON schema. Learn more in the
+             * [Structured Outputs guide](https://platform.openai.com/docs/guides/structured-outputs).
+             *
+             * The default format is `{ "type": "text" }` with no additional options.
+             *
+             * **Not recommended for gpt-4o and newer models:**
+             *
+             * Setting to `{ "type": "json_object" }` enables the older JSON mode, which ensures the
+             * message the model generates is valid JSON. Using `json_schema` is preferred for
+             * models that support it.
+             */
+            fun format(format: BetaResponseFormatTextConfig) = format(JsonField.of(format))
+
+            /**
+             * Sets [Builder.format] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.format] with a well-typed
+             * [BetaResponseFormatTextConfig] value instead. This method is primarily for setting
+             * the field to an undocumented or not yet supported value.
+             */
+            fun format(format: JsonField<BetaResponseFormatTextConfig>) = apply {
+                this.format = format
+            }
+
+            /** Alias for calling [format] with `BetaResponseFormatTextConfig.ofText()`. */
+            fun formatText() = format(BetaResponseFormatTextConfig.ofText())
+
+            /**
+             * Alias for calling [format] with
+             * `BetaResponseFormatTextConfig.ofJsonSchema(jsonSchema)`.
+             */
+            fun format(jsonSchema: BetaResponseFormatTextJsonSchemaConfig) =
+                format(BetaResponseFormatTextConfig.ofJsonSchema(jsonSchema))
+
+            /** Alias for calling [format] with `BetaResponseFormatTextConfig.ofJsonObject()`. */
+            fun formatJsonObject() = format(BetaResponseFormatTextConfig.ofJsonObject())
+
+            /**
+             * Constrains the verbosity of the model's response. Lower values will result in more
+             * concise responses, while higher values will result in more verbose responses.
+             * Currently supported values are `low`, `medium`, and `high`.
+             */
+            fun verbosity(verbosity: Verbosity?) = verbosity(JsonField.ofNullable(verbosity))
+
+            /** Alias for calling [Builder.verbosity] with `verbosity.orElse(null)`. */
+            fun verbosity(verbosity: Optional<Verbosity>) = verbosity(verbosity.getOrNull())
+
+            /**
+             * Sets [Builder.verbosity] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.verbosity] with a well-typed [Verbosity] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun verbosity(verbosity: JsonField<Verbosity>) = apply { this.verbosity = verbosity }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Text].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): Text = Text(format, verbosity, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Text = apply {
+            if (validated) {
+                return@apply
+            }
+
+            format().ifPresent { it.validate() }
+            verbosity().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (format.asKnown().getOrNull()?.validity() ?: 0) +
+                (verbosity.asKnown().getOrNull()?.validity() ?: 0)
+
+        /**
+         * Constrains the verbosity of the model's response. Lower values will result in more
+         * concise responses, while higher values will result in more verbose responses. Currently
+         * supported values are `low`, `medium`, and `high`.
+         */
+        class Verbosity @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val LOW = of("low")
+
+                @JvmField val MEDIUM = of("medium")
+
+                @JvmField val HIGH = of("high")
+
+                @JvmStatic fun of(value: String) = Verbosity(JsonField.of(value))
+            }
+
+            /** An enum containing [Verbosity]'s known values. */
+            enum class Known {
+                LOW,
+                MEDIUM,
+                HIGH,
+            }
+
+            /**
+             * An enum containing [Verbosity]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Verbosity] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                LOW,
+                MEDIUM,
+                HIGH,
+                /**
+                 * An enum member indicating that [Verbosity] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    LOW -> Value.LOW
+                    MEDIUM -> Value.MEDIUM
+                    HIGH -> Value.HIGH
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    LOW -> Known.LOW
+                    MEDIUM -> Known.MEDIUM
+                    HIGH -> Known.HIGH
+                    else -> throw OpenAIInvalidDataException("Unknown Verbosity: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Verbosity = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Verbosity && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Text &&
+                format == other.format &&
+                verbosity == other.verbosity &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(format, verbosity, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Text{format=$format, verbosity=$verbosity, additionalProperties=$additionalProperties}"
+    }
+
+    /** Controls which tool the model should use, if any. */
+    @JsonDeserialize(using = ToolChoice.Deserializer::class)
+    @JsonSerialize(using = ToolChoice.Serializer::class)
+    class ToolChoice
+    private constructor(
+        private val betaToolChoiceOptions: BetaToolChoiceOptions? = null,
+        private val betaToolChoiceAllowed: BetaToolChoiceAllowed? = null,
+        private val betaToolChoiceTypes: BetaToolChoiceTypes? = null,
+        private val betaToolChoiceFunction: BetaToolChoiceFunction? = null,
+        private val betaToolChoiceMcp: BetaToolChoiceMcp? = null,
+        private val betaToolChoiceCustom: BetaToolChoiceCustom? = null,
+        private val betaSpecificProgrammaticToolCallingParam: JsonValue? = null,
+        private val betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch? = null,
+        private val betaToolChoiceShell: BetaToolChoiceShell? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        /**
+         * Controls which (if any) tool is called by the model.
+         *
+         * `none` means the model will not call any tool and instead generates a message.
+         *
+         * `auto` means the model can pick between generating a message or calling one or more
+         * tools.
+         *
+         * `required` means the model must call one or more tools.
+         */
+        fun betaToolChoiceOptions(): Optional<BetaToolChoiceOptions> =
+            Optional.ofNullable(betaToolChoiceOptions)
+
+        /** Constrains the tools available to the model to a pre-defined set. */
+        fun betaToolChoiceAllowed(): Optional<BetaToolChoiceAllowed> =
+            Optional.ofNullable(betaToolChoiceAllowed)
+
+        /**
+         * Indicates that the model should use a built-in tool to generate a response.
+         * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+         */
+        fun betaToolChoiceTypes(): Optional<BetaToolChoiceTypes> =
+            Optional.ofNullable(betaToolChoiceTypes)
+
+        /** Use this option to force the model to call a specific function. */
+        fun betaToolChoiceFunction(): Optional<BetaToolChoiceFunction> =
+            Optional.ofNullable(betaToolChoiceFunction)
+
+        /** Use this option to force the model to call a specific tool on a remote MCP server. */
+        fun betaToolChoiceMcp(): Optional<BetaToolChoiceMcp> =
+            Optional.ofNullable(betaToolChoiceMcp)
+
+        /** Use this option to force the model to call a specific custom tool. */
+        fun betaToolChoiceCustom(): Optional<BetaToolChoiceCustom> =
+            Optional.ofNullable(betaToolChoiceCustom)
+
+        fun betaSpecificProgrammaticToolCallingParam(): Optional<JsonValue> =
+            Optional.ofNullable(betaSpecificProgrammaticToolCallingParam)
+
+        /** Forces the model to call the apply_patch tool when executing a tool call. */
+        fun betaToolChoiceApplyPatch(): Optional<BetaToolChoiceApplyPatch> =
+            Optional.ofNullable(betaToolChoiceApplyPatch)
+
+        /** Forces the model to call the shell tool when a tool call is required. */
+        fun betaToolChoiceShell(): Optional<BetaToolChoiceShell> =
+            Optional.ofNullable(betaToolChoiceShell)
+
+        fun isBetaToolChoiceOptions(): Boolean = betaToolChoiceOptions != null
+
+        fun isBetaToolChoiceAllowed(): Boolean = betaToolChoiceAllowed != null
+
+        fun isBetaToolChoiceTypes(): Boolean = betaToolChoiceTypes != null
+
+        fun isBetaToolChoiceFunction(): Boolean = betaToolChoiceFunction != null
+
+        fun isBetaToolChoiceMcp(): Boolean = betaToolChoiceMcp != null
+
+        fun isBetaToolChoiceCustom(): Boolean = betaToolChoiceCustom != null
+
+        fun isBetaSpecificProgrammaticToolCallingParam(): Boolean =
+            betaSpecificProgrammaticToolCallingParam != null
+
+        fun isBetaToolChoiceApplyPatch(): Boolean = betaToolChoiceApplyPatch != null
+
+        fun isBetaToolChoiceShell(): Boolean = betaToolChoiceShell != null
+
+        /**
+         * Controls which (if any) tool is called by the model.
+         *
+         * `none` means the model will not call any tool and instead generates a message.
+         *
+         * `auto` means the model can pick between generating a message or calling one or more
+         * tools.
+         *
+         * `required` means the model must call one or more tools.
+         */
+        fun asBetaToolChoiceOptions(): BetaToolChoiceOptions =
+            betaToolChoiceOptions.getOrThrow("betaToolChoiceOptions")
+
+        /** Constrains the tools available to the model to a pre-defined set. */
+        fun asBetaToolChoiceAllowed(): BetaToolChoiceAllowed =
+            betaToolChoiceAllowed.getOrThrow("betaToolChoiceAllowed")
+
+        /**
+         * Indicates that the model should use a built-in tool to generate a response.
+         * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+         */
+        fun asBetaToolChoiceTypes(): BetaToolChoiceTypes =
+            betaToolChoiceTypes.getOrThrow("betaToolChoiceTypes")
+
+        /** Use this option to force the model to call a specific function. */
+        fun asBetaToolChoiceFunction(): BetaToolChoiceFunction =
+            betaToolChoiceFunction.getOrThrow("betaToolChoiceFunction")
+
+        /** Use this option to force the model to call a specific tool on a remote MCP server. */
+        fun asBetaToolChoiceMcp(): BetaToolChoiceMcp =
+            betaToolChoiceMcp.getOrThrow("betaToolChoiceMcp")
+
+        /** Use this option to force the model to call a specific custom tool. */
+        fun asBetaToolChoiceCustom(): BetaToolChoiceCustom =
+            betaToolChoiceCustom.getOrThrow("betaToolChoiceCustom")
+
+        fun asBetaSpecificProgrammaticToolCallingParam(): JsonValue =
+            betaSpecificProgrammaticToolCallingParam.getOrThrow(
+                "betaSpecificProgrammaticToolCallingParam"
+            )
+
+        /** Forces the model to call the apply_patch tool when executing a tool call. */
+        fun asBetaToolChoiceApplyPatch(): BetaToolChoiceApplyPatch =
+            betaToolChoiceApplyPatch.getOrThrow("betaToolChoiceApplyPatch")
+
+        /** Forces the model to call the shell tool when a tool call is required. */
+        fun asBetaToolChoiceShell(): BetaToolChoiceShell =
+            betaToolChoiceShell.getOrThrow("betaToolChoiceShell")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = toolChoice.accept(new ToolChoice.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitBetaToolChoiceOptions(BetaToolChoiceOptions betaToolChoiceOptions) {
+         *         return Optional.of(betaToolChoiceOptions.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                betaToolChoiceOptions != null ->
+                    visitor.visitBetaToolChoiceOptions(betaToolChoiceOptions)
+                betaToolChoiceAllowed != null ->
+                    visitor.visitBetaToolChoiceAllowed(betaToolChoiceAllowed)
+                betaToolChoiceTypes != null -> visitor.visitBetaToolChoiceTypes(betaToolChoiceTypes)
+                betaToolChoiceFunction != null ->
+                    visitor.visitBetaToolChoiceFunction(betaToolChoiceFunction)
+                betaToolChoiceMcp != null -> visitor.visitBetaToolChoiceMcp(betaToolChoiceMcp)
+                betaToolChoiceCustom != null ->
+                    visitor.visitBetaToolChoiceCustom(betaToolChoiceCustom)
+                betaSpecificProgrammaticToolCallingParam != null ->
+                    visitor.visitBetaSpecificProgrammaticToolCallingParam(
+                        betaSpecificProgrammaticToolCallingParam
+                    )
+                betaToolChoiceApplyPatch != null ->
+                    visitor.visitBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch)
+                betaToolChoiceShell != null -> visitor.visitBetaToolChoiceShell(betaToolChoiceShell)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ToolChoice = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitBetaToolChoiceOptions(
+                        betaToolChoiceOptions: BetaToolChoiceOptions
+                    ) {
+                        betaToolChoiceOptions.validate()
+                    }
+
+                    override fun visitBetaToolChoiceAllowed(
+                        betaToolChoiceAllowed: BetaToolChoiceAllowed
+                    ) {
+                        betaToolChoiceAllowed.validate()
+                    }
+
+                    override fun visitBetaToolChoiceTypes(
+                        betaToolChoiceTypes: BetaToolChoiceTypes
+                    ) {
+                        betaToolChoiceTypes.validate()
+                    }
+
+                    override fun visitBetaToolChoiceFunction(
+                        betaToolChoiceFunction: BetaToolChoiceFunction
+                    ) {
+                        betaToolChoiceFunction.validate()
+                    }
+
+                    override fun visitBetaToolChoiceMcp(betaToolChoiceMcp: BetaToolChoiceMcp) {
+                        betaToolChoiceMcp.validate()
+                    }
+
+                    override fun visitBetaToolChoiceCustom(
+                        betaToolChoiceCustom: BetaToolChoiceCustom
+                    ) {
+                        betaToolChoiceCustom.validate()
+                    }
+
+                    override fun visitBetaSpecificProgrammaticToolCallingParam(
+                        betaSpecificProgrammaticToolCallingParam: JsonValue
+                    ) {
+                        betaSpecificProgrammaticToolCallingParam.let {
+                            if (
+                                it != JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                            ) {
+                                throw OpenAIInvalidDataException(
+                                    "'betaSpecificProgrammaticToolCallingParam' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitBetaToolChoiceApplyPatch(
+                        betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch
+                    ) {
+                        betaToolChoiceApplyPatch.validate()
+                    }
+
+                    override fun visitBetaToolChoiceShell(
+                        betaToolChoiceShell: BetaToolChoiceShell
+                    ) {
+                        betaToolChoiceShell.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitBetaToolChoiceOptions(
+                        betaToolChoiceOptions: BetaToolChoiceOptions
+                    ) = betaToolChoiceOptions.validity()
+
+                    override fun visitBetaToolChoiceAllowed(
+                        betaToolChoiceAllowed: BetaToolChoiceAllowed
+                    ) = betaToolChoiceAllowed.validity()
+
+                    override fun visitBetaToolChoiceTypes(
+                        betaToolChoiceTypes: BetaToolChoiceTypes
+                    ) = betaToolChoiceTypes.validity()
+
+                    override fun visitBetaToolChoiceFunction(
+                        betaToolChoiceFunction: BetaToolChoiceFunction
+                    ) = betaToolChoiceFunction.validity()
+
+                    override fun visitBetaToolChoiceMcp(betaToolChoiceMcp: BetaToolChoiceMcp) =
+                        betaToolChoiceMcp.validity()
+
+                    override fun visitBetaToolChoiceCustom(
+                        betaToolChoiceCustom: BetaToolChoiceCustom
+                    ) = betaToolChoiceCustom.validity()
+
+                    override fun visitBetaSpecificProgrammaticToolCallingParam(
+                        betaSpecificProgrammaticToolCallingParam: JsonValue
+                    ) =
+                        betaSpecificProgrammaticToolCallingParam.let {
+                            if (it == JsonValue.from(mapOf("type" to "programmatic_tool_calling")))
+                                1
+                            else 0
+                        }
+
+                    override fun visitBetaToolChoiceApplyPatch(
+                        betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch
+                    ) = betaToolChoiceApplyPatch.validity()
+
+                    override fun visitBetaToolChoiceShell(
+                        betaToolChoiceShell: BetaToolChoiceShell
+                    ) = betaToolChoiceShell.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ToolChoice &&
+                betaToolChoiceOptions == other.betaToolChoiceOptions &&
+                betaToolChoiceAllowed == other.betaToolChoiceAllowed &&
+                betaToolChoiceTypes == other.betaToolChoiceTypes &&
+                betaToolChoiceFunction == other.betaToolChoiceFunction &&
+                betaToolChoiceMcp == other.betaToolChoiceMcp &&
+                betaToolChoiceCustom == other.betaToolChoiceCustom &&
+                betaSpecificProgrammaticToolCallingParam ==
+                    other.betaSpecificProgrammaticToolCallingParam &&
+                betaToolChoiceApplyPatch == other.betaToolChoiceApplyPatch &&
+                betaToolChoiceShell == other.betaToolChoiceShell
+        }
+
+        override fun hashCode(): Int =
+            Objects.hash(
+                betaToolChoiceOptions,
+                betaToolChoiceAllowed,
+                betaToolChoiceTypes,
+                betaToolChoiceFunction,
+                betaToolChoiceMcp,
+                betaToolChoiceCustom,
+                betaSpecificProgrammaticToolCallingParam,
+                betaToolChoiceApplyPatch,
+                betaToolChoiceShell,
+            )
+
+        override fun toString(): String =
+            when {
+                betaToolChoiceOptions != null ->
+                    "ToolChoice{betaToolChoiceOptions=$betaToolChoiceOptions}"
+                betaToolChoiceAllowed != null ->
+                    "ToolChoice{betaToolChoiceAllowed=$betaToolChoiceAllowed}"
+                betaToolChoiceTypes != null ->
+                    "ToolChoice{betaToolChoiceTypes=$betaToolChoiceTypes}"
+                betaToolChoiceFunction != null ->
+                    "ToolChoice{betaToolChoiceFunction=$betaToolChoiceFunction}"
+                betaToolChoiceMcp != null -> "ToolChoice{betaToolChoiceMcp=$betaToolChoiceMcp}"
+                betaToolChoiceCustom != null ->
+                    "ToolChoice{betaToolChoiceCustom=$betaToolChoiceCustom}"
+                betaSpecificProgrammaticToolCallingParam != null ->
+                    "ToolChoice{betaSpecificProgrammaticToolCallingParam=$betaSpecificProgrammaticToolCallingParam}"
+                betaToolChoiceApplyPatch != null ->
+                    "ToolChoice{betaToolChoiceApplyPatch=$betaToolChoiceApplyPatch}"
+                betaToolChoiceShell != null ->
+                    "ToolChoice{betaToolChoiceShell=$betaToolChoiceShell}"
+                _json != null -> "ToolChoice{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid ToolChoice")
+            }
+
+        companion object {
+
+            /**
+             * Controls which (if any) tool is called by the model.
+             *
+             * `none` means the model will not call any tool and instead generates a message.
+             *
+             * `auto` means the model can pick between generating a message or calling one or more
+             * tools.
+             *
+             * `required` means the model must call one or more tools.
+             */
+            @JvmStatic
+            fun ofBetaToolChoiceOptions(betaToolChoiceOptions: BetaToolChoiceOptions) =
+                ToolChoice(betaToolChoiceOptions = betaToolChoiceOptions)
+
+            /** Constrains the tools available to the model to a pre-defined set. */
+            @JvmStatic
+            fun ofBetaToolChoiceAllowed(betaToolChoiceAllowed: BetaToolChoiceAllowed) =
+                ToolChoice(betaToolChoiceAllowed = betaToolChoiceAllowed)
+
+            /**
+             * Indicates that the model should use a built-in tool to generate a response.
+             * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+             */
+            @JvmStatic
+            fun ofBetaToolChoiceTypes(betaToolChoiceTypes: BetaToolChoiceTypes) =
+                ToolChoice(betaToolChoiceTypes = betaToolChoiceTypes)
+
+            /** Use this option to force the model to call a specific function. */
+            @JvmStatic
+            fun ofBetaToolChoiceFunction(betaToolChoiceFunction: BetaToolChoiceFunction) =
+                ToolChoice(betaToolChoiceFunction = betaToolChoiceFunction)
+
+            /**
+             * Use this option to force the model to call a specific tool on a remote MCP server.
+             */
+            @JvmStatic
+            fun ofBetaToolChoiceMcp(betaToolChoiceMcp: BetaToolChoiceMcp) =
+                ToolChoice(betaToolChoiceMcp = betaToolChoiceMcp)
+
+            /** Use this option to force the model to call a specific custom tool. */
+            @JvmStatic
+            fun ofBetaToolChoiceCustom(betaToolChoiceCustom: BetaToolChoiceCustom) =
+                ToolChoice(betaToolChoiceCustom = betaToolChoiceCustom)
+
+            @JvmStatic
+            fun ofBetaSpecificProgrammaticToolCallingParam() =
+                ToolChoice(
+                    betaSpecificProgrammaticToolCallingParam =
+                        JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                )
+
+            /** Forces the model to call the apply_patch tool when executing a tool call. */
+            @JvmStatic
+            fun ofBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch) =
+                ToolChoice(betaToolChoiceApplyPatch = betaToolChoiceApplyPatch)
+
+            /** Forces the model to call the shell tool when a tool call is required. */
+            @JvmStatic
+            fun ofBetaToolChoiceShell(betaToolChoiceShell: BetaToolChoiceShell) =
+                ToolChoice(betaToolChoiceShell = betaToolChoiceShell)
+        }
+
+        /**
+         * An interface that defines how to map each variant of [ToolChoice] to a value of type [T].
+         */
+        interface Visitor<out T> {
+
+            /**
+             * Controls which (if any) tool is called by the model.
+             *
+             * `none` means the model will not call any tool and instead generates a message.
+             *
+             * `auto` means the model can pick between generating a message or calling one or more
+             * tools.
+             *
+             * `required` means the model must call one or more tools.
+             */
+            fun visitBetaToolChoiceOptions(betaToolChoiceOptions: BetaToolChoiceOptions): T
+
+            /** Constrains the tools available to the model to a pre-defined set. */
+            fun visitBetaToolChoiceAllowed(betaToolChoiceAllowed: BetaToolChoiceAllowed): T
+
+            /**
+             * Indicates that the model should use a built-in tool to generate a response.
+             * [Learn more about built-in tools](https://platform.openai.com/docs/guides/tools).
+             */
+            fun visitBetaToolChoiceTypes(betaToolChoiceTypes: BetaToolChoiceTypes): T
+
+            /** Use this option to force the model to call a specific function. */
+            fun visitBetaToolChoiceFunction(betaToolChoiceFunction: BetaToolChoiceFunction): T
+
+            /**
+             * Use this option to force the model to call a specific tool on a remote MCP server.
+             */
+            fun visitBetaToolChoiceMcp(betaToolChoiceMcp: BetaToolChoiceMcp): T
+
+            /** Use this option to force the model to call a specific custom tool. */
+            fun visitBetaToolChoiceCustom(betaToolChoiceCustom: BetaToolChoiceCustom): T
+
+            fun visitBetaSpecificProgrammaticToolCallingParam(
+                betaSpecificProgrammaticToolCallingParam: JsonValue
+            ): T
+
+            /** Forces the model to call the apply_patch tool when executing a tool call. */
+            fun visitBetaToolChoiceApplyPatch(betaToolChoiceApplyPatch: BetaToolChoiceApplyPatch): T
+
+            /** Forces the model to call the shell tool when a tool call is required. */
+            fun visitBetaToolChoiceShell(betaToolChoiceShell: BetaToolChoiceShell): T
+
+            /**
+             * Maps an unknown variant of [ToolChoice] to a value of type [T].
+             *
+             * An instance of [ToolChoice] can contain an unknown variant if it was deserialized
+             * from data that doesn't match any known variant. For example, if the SDK is on an
+             * older version than the API, then the API may respond with new variants that the SDK
+             * is unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown ToolChoice: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<ToolChoice>(ToolChoice::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): ToolChoice {
+                val json = JsonValue.fromJsonNode(node)
+
+                val bestMatches =
+                    sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let {
+                                    ToolChoice(
+                                        betaSpecificProgrammaticToolCallingParam = it,
+                                        _json = json,
+                                    )
+                                }
+                                ?.takeIf { it.isValid() },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceOptions>())?.let {
+                                ToolChoice(betaToolChoiceOptions = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceAllowed>())?.let {
+                                ToolChoice(betaToolChoiceAllowed = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceTypes>())?.let {
+                                ToolChoice(betaToolChoiceTypes = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceFunction>())?.let {
+                                ToolChoice(betaToolChoiceFunction = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceMcp>())?.let {
+                                ToolChoice(betaToolChoiceMcp = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceCustom>())?.let {
+                                ToolChoice(betaToolChoiceCustom = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceApplyPatch>())?.let {
+                                ToolChoice(betaToolChoiceApplyPatch = it, _json = json)
+                            },
+                            tryDeserialize(node, jacksonTypeRef<BetaToolChoiceShell>())?.let {
+                                ToolChoice(betaToolChoiceShell = it, _json = json)
+                            },
+                        )
+                        .filterNotNull()
+                        .allMaxBy { it.validity() }
+                        .toList()
+                return when (bestMatches.size) {
+                    // This can happen if what we're deserializing is completely incompatible with
+                    // all the possible variants (e.g. deserializing from boolean).
+                    0 -> ToolChoice(_json = json)
+                    1 -> bestMatches.single()
+                    // If there's more than one match with the highest validity, then use the first
+                    // completely valid match, or simply the first match if none are completely
+                    // valid.
+                    else -> bestMatches.firstOrNull { it.isValid() } ?: bestMatches.first()
+                }
+            }
+        }
+
+        internal class Serializer : BaseSerializer<ToolChoice>(ToolChoice::class) {
+
+            override fun serialize(
+                value: ToolChoice,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.betaToolChoiceOptions != null ->
+                        generator.writeObject(value.betaToolChoiceOptions)
+                    value.betaToolChoiceAllowed != null ->
+                        generator.writeObject(value.betaToolChoiceAllowed)
+                    value.betaToolChoiceTypes != null ->
+                        generator.writeObject(value.betaToolChoiceTypes)
+                    value.betaToolChoiceFunction != null ->
+                        generator.writeObject(value.betaToolChoiceFunction)
+                    value.betaToolChoiceMcp != null ->
+                        generator.writeObject(value.betaToolChoiceMcp)
+                    value.betaToolChoiceCustom != null ->
+                        generator.writeObject(value.betaToolChoiceCustom)
+                    value.betaSpecificProgrammaticToolCallingParam != null ->
+                        generator.writeObject(value.betaSpecificProgrammaticToolCallingParam)
+                    value.betaToolChoiceApplyPatch != null ->
+                        generator.writeObject(value.betaToolChoiceApplyPatch)
+                    value.betaToolChoiceShell != null ->
+                        generator.writeObject(value.betaToolChoiceShell)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid ToolChoice")
+                }
+            }
+        }
+    }
+
+    /**
+     * The truncation strategy to use for the model response. - `auto`: If the input to this
+     * Response exceeds the model's context window size, the model will truncate the response to fit
+     * the context window by dropping items from the beginning of the conversation. - `disabled`
+     * (default): If the input size will exceed the context window size for a model, the request
+     * will fail with a 400 error.
+     */
+    @Deprecated("deprecated")
+    class Truncation @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val AUTO = of("auto")
+
+            @JvmField val DISABLED = of("disabled")
+
+            @JvmStatic fun of(value: String) = Truncation(JsonField.of(value))
+        }
+
+        /** An enum containing [Truncation]'s known values. */
+        enum class Known {
+            AUTO,
+            DISABLED,
+        }
+
+        /**
+         * An enum containing [Truncation]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Truncation] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            AUTO,
+            DISABLED,
+            /**
+             * An enum member indicating that [Truncation] was instantiated with an unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                AUTO -> Value.AUTO
+                DISABLED -> Value.DISABLED
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                AUTO -> Known.AUTO
+                DISABLED -> Known.DISABLED
+                else -> throw OpenAIInvalidDataException("Unknown Truncation: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Truncation = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Truncation && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    class Beta @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val RESPONSES_MULTI_AGENT_V1 = of("responses_multi_agent=v1")
+
+            @JvmStatic fun of(value: String) = Beta(JsonField.of(value))
+        }
+
+        /** An enum containing [Beta]'s known values. */
+        enum class Known {
+            RESPONSES_MULTI_AGENT_V1
+        }
+
+        /**
+         * An enum containing [Beta]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Beta] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            RESPONSES_MULTI_AGENT_V1,
+            /** An enum member indicating that [Beta] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                RESPONSES_MULTI_AGENT_V1 -> Value.RESPONSES_MULTI_AGENT_V1
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                RESPONSES_MULTI_AGENT_V1 -> Known.RESPONSES_MULTI_AGENT_V1
+                else -> throw OpenAIInvalidDataException("Unknown Beta: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Beta = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Beta && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is InputTokenCountParams &&
+            betas == other.betas &&
+            body == other.body &&
+            additionalHeaders == other.additionalHeaders &&
+            additionalQueryParams == other.additionalQueryParams
+    }
+
+    override fun hashCode(): Int =
+        Objects.hash(betas, body, additionalHeaders, additionalQueryParams)
+
+    override fun toString() =
+        "InputTokenCountParams{betas=$betas, body=$body, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputtokens/InputTokenCountResponse.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputtokens/InputTokenCountResponse.kt
new file mode 100644
index 000000000..bc5b14163
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/responses/inputtokens/InputTokenCountResponse.kt
@@ -0,0 +1,220 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses.inputtokens
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+
+class InputTokenCountResponse
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val inputTokens: JsonField<Long>,
+    private val object_: JsonValue,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("input_tokens")
+        @ExcludeMissing
+        inputTokens: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("object") @ExcludeMissing object_: JsonValue = JsonMissing.of(),
+    ) : this(inputTokens, object_, mutableMapOf())
+
+    /**
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun inputTokens(): Long = inputTokens.getRequired("input_tokens")
+
+    /**
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("response.input_tokens")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("object") @ExcludeMissing fun _object_(): JsonValue = object_
+
+    /**
+     * Returns the raw JSON value of [inputTokens].
+     *
+     * Unlike [inputTokens], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("input_tokens") @ExcludeMissing fun _inputTokens(): JsonField<Long> = inputTokens
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of [InputTokenCountResponse].
+         *
+         * The following fields are required:
+         * ```java
+         * .inputTokens()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [InputTokenCountResponse]. */
+    class Builder internal constructor() {
+
+        private var inputTokens: JsonField<Long>? = null
+        private var object_: JsonValue = JsonValue.from("response.input_tokens")
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(inputTokenCountResponse: InputTokenCountResponse) = apply {
+            inputTokens = inputTokenCountResponse.inputTokens
+            object_ = inputTokenCountResponse.object_
+            additionalProperties = inputTokenCountResponse.additionalProperties.toMutableMap()
+        }
+
+        fun inputTokens(inputTokens: Long) = inputTokens(JsonField.of(inputTokens))
+
+        /**
+         * Sets [Builder.inputTokens] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.inputTokens] with a well-typed [Long] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun inputTokens(inputTokens: JsonField<Long>) = apply { this.inputTokens = inputTokens }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("response.input_tokens")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun object_(object_: JsonValue) = apply { this.object_ = object_ }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [InputTokenCountResponse].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .inputTokens()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): InputTokenCountResponse =
+            InputTokenCountResponse(
+                checkRequired("inputTokens", inputTokens),
+                object_,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): InputTokenCountResponse = apply {
+        if (validated) {
+            return@apply
+        }
+
+        inputTokens()
+        _object_().let {
+            if (it != JsonValue.from("response.input_tokens")) {
+                throw OpenAIInvalidDataException("'object_' is invalid, received $it")
+            }
+        }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (inputTokens.asKnown().isPresent) 1 else 0) +
+            object_.let { if (it == JsonValue.from("response.input_tokens")) 1 else 0 }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is InputTokenCountResponse &&
+            inputTokens == other.inputTokens &&
+            object_ == other.object_ &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy { Objects.hash(inputTokens, object_, additionalProperties) }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "InputTokenCountResponse{inputTokens=$inputTokens, object_=$object_, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/beta/threads/runs/RunCreateParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/beta/threads/runs/RunCreateParams.kt
index e8e5d679f..2122900e4 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/beta/threads/runs/RunCreateParams.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/beta/threads/runs/RunCreateParams.kt
@@ -165,17 +165,12 @@ private constructor(
     fun parallelToolCalls(): Optional<Boolean> = body.parallelToolCalls()
 
     /**
-     * Constrains effort on reasoning for
-     * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported
-     * values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing reasoning effort
-     * can result in faster responses and fewer tokens used on reasoning in a response.
-     * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
-     *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for
-     *   all reasoning values in gpt-5.1.
-     * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support
-     *   `none`.
-     * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+     * Constrains effort on reasoning for reasoning models. Currently supported values are `none`,
+     * `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort can result
+     * in faster responses and fewer tokens used on reasoning in a response. Not all reasoning
+     * models support every value. See the
+     * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+     * support.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -691,18 +686,12 @@ private constructor(
         }
 
         /**
-         * Constrains effort on reasoning for
-         * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-         * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing
-         * reasoning effort can result in faster responses and fewer tokens used on reasoning in a
-         * response.
-         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
-         *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported
-         *   for all reasoning values in gpt-5.1.
-         * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support
-         *   `none`.
-         * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-         * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
          */
         fun reasoningEffort(reasoningEffort: ReasoningEffort?) = apply {
             body.reasoningEffort(reasoningEffort)
@@ -1291,18 +1280,12 @@ private constructor(
             parallelToolCalls.getOptional("parallel_tool_calls")
 
         /**
-         * Constrains effort on reasoning for
-         * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-         * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing
-         * reasoning effort can result in faster responses and fewer tokens used on reasoning in a
-         * response.
-         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
-         *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported
-         *   for all reasoning values in gpt-5.1.
-         * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support
-         *   `none`.
-         * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-         * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -1841,18 +1824,12 @@ private constructor(
             }
 
             /**
-             * Constrains effort on reasoning for
-             * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-             * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-             * Reducing reasoning effort can result in faster responses and fewer tokens used on
-             * reasoning in a response.
-             * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-             *   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls
-             *   are supported for all reasoning values in gpt-5.1.
-             * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-             *   support `none`.
-             * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-             * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+             * Constrains effort on reasoning for reasoning models. Currently supported values are
+             * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning
+             * effort can result in faster responses and fewer tokens used on reasoning in a
+             * response. Not all reasoning models support every value. See the
+             * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+             * model-specific support.
              */
             fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                 reasoningEffort(JsonField.ofNullable(reasoningEffort))
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionContentPart.kt b/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionContentPart.kt
index 005dc662b..8bd9ee3f6 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionContentPart.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionContentPart.kt
@@ -331,6 +331,7 @@ private constructor(
     private constructor(
         private val file: JsonField<FileObject>,
         private val type: JsonValue,
+        private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
@@ -338,7 +339,10 @@ private constructor(
         private constructor(
             @JsonProperty("file") @ExcludeMissing file: JsonField<FileObject> = JsonMissing.of(),
             @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-        ) : this(file, type, mutableMapOf())
+            @JsonProperty("prompt_cache_breakpoint")
+            @ExcludeMissing
+            promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+        ) : this(file, type, promptCacheBreakpoint, mutableMapOf())
 
         /**
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
@@ -359,6 +363,16 @@ private constructor(
          */
         @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+            promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
         /**
          * Returns the raw JSON value of [file].
          *
@@ -366,6 +380,16 @@ private constructor(
          */
         @JsonProperty("file") @ExcludeMissing fun _file(): JsonField<FileObject> = file
 
+        /**
+         * Returns the raw JSON value of [promptCacheBreakpoint].
+         *
+         * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
             additionalProperties.put(key, value)
@@ -396,12 +420,14 @@ private constructor(
 
             private var file: JsonField<FileObject>? = null
             private var type: JsonValue = JsonValue.from("file")
+            private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
             internal fun from(file: File) = apply {
                 this.file = file.file
                 type = file.type
+                promptCacheBreakpoint = file.promptCacheBreakpoint
                 additionalProperties = file.additionalProperties.toMutableMap()
             }
 
@@ -430,6 +456,26 @@ private constructor(
              */
             fun type(type: JsonValue) = apply { this.type = type }
 
+            /**
+             * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from
+             * the request's `prompt_cache_options.ttl`; the boundary is not rounded to a token
+             * block.
+             */
+            fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint) =
+                promptCacheBreakpoint(JsonField.of(promptCacheBreakpoint))
+
+            /**
+             * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+             * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field
+             * to an undocumented or not yet supported value.
+             */
+            fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) =
+                apply {
+                    this.promptCacheBreakpoint = promptCacheBreakpoint
+                }
+
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
                 putAllAdditionalProperties(additionalProperties)
@@ -462,7 +508,12 @@ private constructor(
              * @throws IllegalStateException if any required field is unset.
              */
             fun build(): File =
-                File(checkRequired("file", file), type, additionalProperties.toMutableMap())
+                File(
+                    checkRequired("file", file),
+                    type,
+                    promptCacheBreakpoint,
+                    additionalProperties.toMutableMap(),
+                )
         }
 
         private var validated: Boolean = false
@@ -487,6 +538,7 @@ private constructor(
                     throw OpenAIInvalidDataException("'type' is invalid, received $it")
                 }
             }
+            promptCacheBreakpoint().ifPresent { it.validate() }
             validated = true
         }
 
@@ -507,7 +559,8 @@ private constructor(
         @JvmSynthetic
         internal fun validity(): Int =
             (file.asKnown().getOrNull()?.validity() ?: 0) +
-                type.let { if (it == JsonValue.from("file")) 1 else 0 }
+                type.let { if (it == JsonValue.from("file")) 1 else 0 } +
+                (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
 
         class FileObject
         @JsonCreator(mode = JsonCreator.Mode.DISABLED)
@@ -747,6 +800,174 @@ private constructor(
                 "FileObject{fileData=$fileData, fileId=$fileId, filename=$filename, additionalProperties=$additionalProperties}"
         }
 
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        class PromptCacheBreakpoint
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val mode: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+            ) : this(mode, mutableMapOf())
+
+            /**
+             * The breakpoint mode. Always `explicit`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of
+                 * [PromptCacheBreakpoint].
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [PromptCacheBreakpoint]. */
+            class Builder internal constructor() {
+
+                private var mode: JsonValue = JsonValue.from("explicit")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                    mode = promptCacheBreakpoint.mode
+                    additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+                }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("explicit")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [PromptCacheBreakpoint].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): PromptCacheBreakpoint =
+                    PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): PromptCacheBreakpoint = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                _mode().let {
+                    if (it != JsonValue.from("explicit")) {
+                        throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is PromptCacheBreakpoint &&
+                    mode == other.mode &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+        }
+
         override fun equals(other: Any?): Boolean {
             if (this === other) {
                 return true
@@ -755,14 +976,17 @@ private constructor(
             return other is File &&
                 file == other.file &&
                 type == other.type &&
+                promptCacheBreakpoint == other.promptCacheBreakpoint &&
                 additionalProperties == other.additionalProperties
         }
 
-        private val hashCode: Int by lazy { Objects.hash(file, type, additionalProperties) }
+        private val hashCode: Int by lazy {
+            Objects.hash(file, type, promptCacheBreakpoint, additionalProperties)
+        }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "File{file=$file, type=$type, additionalProperties=$additionalProperties}"
+            "File{file=$file, type=$type, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
     }
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartImage.kt b/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartImage.kt
index c784800b8..37d444d30 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartImage.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartImage.kt
@@ -24,6 +24,7 @@ class ChatCompletionContentPartImage
 private constructor(
     private val imageUrl: JsonField<ImageUrl>,
     private val type: JsonValue,
+    private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -31,7 +32,10 @@ private constructor(
     private constructor(
         @JsonProperty("image_url") @ExcludeMissing imageUrl: JsonField<ImageUrl> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-    ) : this(imageUrl, type, mutableMapOf())
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+    ) : this(imageUrl, type, promptCacheBreakpoint, mutableMapOf())
 
     /**
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
@@ -52,6 +56,16 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+        promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
     /**
      * Returns the raw JSON value of [imageUrl].
      *
@@ -59,6 +73,16 @@ private constructor(
      */
     @JsonProperty("image_url") @ExcludeMissing fun _imageUrl(): JsonField<ImageUrl> = imageUrl
 
+    /**
+     * Returns the raw JSON value of [promptCacheBreakpoint].
+     *
+     * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_breakpoint")
+    @ExcludeMissing
+    fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -90,12 +114,14 @@ private constructor(
 
         private var imageUrl: JsonField<ImageUrl>? = null
         private var type: JsonValue = JsonValue.from("image_url")
+        private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
         internal fun from(chatCompletionContentPartImage: ChatCompletionContentPartImage) = apply {
             imageUrl = chatCompletionContentPartImage.imageUrl
             type = chatCompletionContentPartImage.type
+            promptCacheBreakpoint = chatCompletionContentPartImage.promptCacheBreakpoint
             additionalProperties =
                 chatCompletionContentPartImage.additionalProperties.toMutableMap()
         }
@@ -125,6 +151,24 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint) =
+            promptCacheBreakpoint(JsonField.of(promptCacheBreakpoint))
+
+        /**
+         * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+         * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) = apply {
+            this.promptCacheBreakpoint = promptCacheBreakpoint
+        }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -160,6 +204,7 @@ private constructor(
             ChatCompletionContentPartImage(
                 checkRequired("imageUrl", imageUrl),
                 type,
+                promptCacheBreakpoint,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -185,6 +230,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        promptCacheBreakpoint().ifPresent { it.validate() }
         validated = true
     }
 
@@ -204,7 +250,8 @@ private constructor(
     @JvmSynthetic
     internal fun validity(): Int =
         (imageUrl.asKnown().getOrNull()?.validity() ?: 0) +
-            type.let { if (it == JsonValue.from("image_url")) 1 else 0 }
+            type.let { if (it == JsonValue.from("image_url")) 1 else 0 } +
+            (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
 
     class ImageUrl
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
@@ -560,6 +607,168 @@ private constructor(
             "ImageUrl{url=$url, detail=$detail, additionalProperties=$additionalProperties}"
     }
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     */
+    class PromptCacheBreakpoint
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+        ) : this(mode, mutableMapOf())
+
+        /**
+         * The breakpoint mode. Always `explicit`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("explicit")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheBreakpoint].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheBreakpoint]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonValue = JsonValue.from("explicit")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                mode = promptCacheBreakpoint.mode
+                additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheBreakpoint].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheBreakpoint =
+                PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheBreakpoint = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _mode().let {
+                if (it != JsonValue.from("explicit")) {
+                    throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheBreakpoint &&
+                mode == other.mode &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -568,13 +777,16 @@ private constructor(
         return other is ChatCompletionContentPartImage &&
             imageUrl == other.imageUrl &&
             type == other.type &&
+            promptCacheBreakpoint == other.promptCacheBreakpoint &&
             additionalProperties == other.additionalProperties
     }
 
-    private val hashCode: Int by lazy { Objects.hash(imageUrl, type, additionalProperties) }
+    private val hashCode: Int by lazy {
+        Objects.hash(imageUrl, type, promptCacheBreakpoint, additionalProperties)
+    }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ChatCompletionContentPartImage{imageUrl=$imageUrl, type=$type, additionalProperties=$additionalProperties}"
+        "ChatCompletionContentPartImage{imageUrl=$imageUrl, type=$type, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartInputAudio.kt b/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartInputAudio.kt
index f7ed7b5d5..96cf03fd0 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartInputAudio.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartInputAudio.kt
@@ -15,6 +15,7 @@ import com.openai.core.checkRequired
 import com.openai.errors.OpenAIInvalidDataException
 import java.util.Collections
 import java.util.Objects
+import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
 /** Learn about [audio inputs](https://platform.openai.com/docs/guides/audio). */
@@ -23,6 +24,7 @@ class ChatCompletionContentPartInputAudio
 private constructor(
     private val inputAudio: JsonField<InputAudio>,
     private val type: JsonValue,
+    private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -32,7 +34,10 @@ private constructor(
         @ExcludeMissing
         inputAudio: JsonField<InputAudio> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-    ) : this(inputAudio, type, mutableMapOf())
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+    ) : this(inputAudio, type, promptCacheBreakpoint, mutableMapOf())
 
     /**
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
@@ -53,6 +58,16 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+        promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
     /**
      * Returns the raw JSON value of [inputAudio].
      *
@@ -62,6 +77,16 @@ private constructor(
     @ExcludeMissing
     fun _inputAudio(): JsonField<InputAudio> = inputAudio
 
+    /**
+     * Returns the raw JSON value of [promptCacheBreakpoint].
+     *
+     * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_breakpoint")
+    @ExcludeMissing
+    fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -93,6 +118,7 @@ private constructor(
 
         private var inputAudio: JsonField<InputAudio>? = null
         private var type: JsonValue = JsonValue.from("input_audio")
+        private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -101,6 +127,7 @@ private constructor(
         ) = apply {
             inputAudio = chatCompletionContentPartInputAudio.inputAudio
             type = chatCompletionContentPartInputAudio.type
+            promptCacheBreakpoint = chatCompletionContentPartInputAudio.promptCacheBreakpoint
             additionalProperties =
                 chatCompletionContentPartInputAudio.additionalProperties.toMutableMap()
         }
@@ -130,6 +157,24 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint) =
+            promptCacheBreakpoint(JsonField.of(promptCacheBreakpoint))
+
+        /**
+         * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+         * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) = apply {
+            this.promptCacheBreakpoint = promptCacheBreakpoint
+        }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -165,6 +210,7 @@ private constructor(
             ChatCompletionContentPartInputAudio(
                 checkRequired("inputAudio", inputAudio),
                 type,
+                promptCacheBreakpoint,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -190,6 +236,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        promptCacheBreakpoint().ifPresent { it.validate() }
         validated = true
     }
 
@@ -209,7 +256,8 @@ private constructor(
     @JvmSynthetic
     internal fun validity(): Int =
         (inputAudio.asKnown().getOrNull()?.validity() ?: 0) +
-            type.let { if (it == JsonValue.from("input_audio")) 1 else 0 }
+            type.let { if (it == JsonValue.from("input_audio")) 1 else 0 } +
+            (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
 
     class InputAudio
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
@@ -558,6 +606,168 @@ private constructor(
             "InputAudio{data=$data, format=$format, additionalProperties=$additionalProperties}"
     }
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     */
+    class PromptCacheBreakpoint
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+        ) : this(mode, mutableMapOf())
+
+        /**
+         * The breakpoint mode. Always `explicit`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("explicit")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheBreakpoint].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheBreakpoint]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonValue = JsonValue.from("explicit")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                mode = promptCacheBreakpoint.mode
+                additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheBreakpoint].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheBreakpoint =
+                PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheBreakpoint = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _mode().let {
+                if (it != JsonValue.from("explicit")) {
+                    throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheBreakpoint &&
+                mode == other.mode &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -566,13 +776,16 @@ private constructor(
         return other is ChatCompletionContentPartInputAudio &&
             inputAudio == other.inputAudio &&
             type == other.type &&
+            promptCacheBreakpoint == other.promptCacheBreakpoint &&
             additionalProperties == other.additionalProperties
     }
 
-    private val hashCode: Int by lazy { Objects.hash(inputAudio, type, additionalProperties) }
+    private val hashCode: Int by lazy {
+        Objects.hash(inputAudio, type, promptCacheBreakpoint, additionalProperties)
+    }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ChatCompletionContentPartInputAudio{inputAudio=$inputAudio, type=$type, additionalProperties=$additionalProperties}"
+        "ChatCompletionContentPartInputAudio{inputAudio=$inputAudio, type=$type, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartText.kt b/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartText.kt
index 276b4d0fe..cf1437ea4 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartText.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartText.kt
@@ -14,6 +14,8 @@ import com.openai.core.checkRequired
 import com.openai.errors.OpenAIInvalidDataException
 import java.util.Collections
 import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
 
 /** Learn about [text inputs](https://platform.openai.com/docs/guides/text-generation). */
 class ChatCompletionContentPartText
@@ -21,6 +23,7 @@ class ChatCompletionContentPartText
 private constructor(
     private val text: JsonField<String>,
     private val type: JsonValue,
+    private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -28,7 +31,10 @@ private constructor(
     private constructor(
         @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-    ) : this(text, type, mutableMapOf())
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+    ) : this(text, type, promptCacheBreakpoint, mutableMapOf())
 
     /**
      * The text content.
@@ -51,6 +57,16 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+        promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
     /**
      * Returns the raw JSON value of [text].
      *
@@ -58,6 +74,16 @@ private constructor(
      */
     @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
 
+    /**
+     * Returns the raw JSON value of [promptCacheBreakpoint].
+     *
+     * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_breakpoint")
+    @ExcludeMissing
+    fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -89,12 +115,14 @@ private constructor(
 
         private var text: JsonField<String>? = null
         private var type: JsonValue = JsonValue.from("text")
+        private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
         internal fun from(chatCompletionContentPartText: ChatCompletionContentPartText) = apply {
             text = chatCompletionContentPartText.text
             type = chatCompletionContentPartText.type
+            promptCacheBreakpoint = chatCompletionContentPartText.promptCacheBreakpoint
             additionalProperties = chatCompletionContentPartText.additionalProperties.toMutableMap()
         }
 
@@ -123,6 +151,24 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint) =
+            promptCacheBreakpoint(JsonField.of(promptCacheBreakpoint))
+
+        /**
+         * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+         * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) = apply {
+            this.promptCacheBreakpoint = promptCacheBreakpoint
+        }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -158,6 +204,7 @@ private constructor(
             ChatCompletionContentPartText(
                 checkRequired("text", text),
                 type,
+                promptCacheBreakpoint,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -183,6 +230,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        promptCacheBreakpoint().ifPresent { it.validate() }
         validated = true
     }
 
@@ -202,7 +250,170 @@ private constructor(
     @JvmSynthetic
     internal fun validity(): Int =
         (if (text.asKnown().isPresent) 1 else 0) +
-            type.let { if (it == JsonValue.from("text")) 1 else 0 }
+            type.let { if (it == JsonValue.from("text")) 1 else 0 } +
+            (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     */
+    class PromptCacheBreakpoint
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+        ) : this(mode, mutableMapOf())
+
+        /**
+         * The breakpoint mode. Always `explicit`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("explicit")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheBreakpoint].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheBreakpoint]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonValue = JsonValue.from("explicit")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                mode = promptCacheBreakpoint.mode
+                additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheBreakpoint].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheBreakpoint =
+                PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheBreakpoint = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _mode().let {
+                if (it != JsonValue.from("explicit")) {
+                    throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheBreakpoint &&
+                mode == other.mode &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+    }
 
     override fun equals(other: Any?): Boolean {
         if (this === other) {
@@ -212,13 +423,16 @@ private constructor(
         return other is ChatCompletionContentPartText &&
             text == other.text &&
             type == other.type &&
+            promptCacheBreakpoint == other.promptCacheBreakpoint &&
             additionalProperties == other.additionalProperties
     }
 
-    private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+    private val hashCode: Int by lazy {
+        Objects.hash(text, type, promptCacheBreakpoint, additionalProperties)
+    }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ChatCompletionContentPartText{text=$text, type=$type, additionalProperties=$additionalProperties}"
+        "ChatCompletionContentPartText{text=$text, type=$type, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionCreateParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionCreateParams.kt
index 926e5b88b..1d1c977b5 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionCreateParams.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionCreateParams.kt
@@ -277,10 +277,29 @@ private constructor(
     fun promptCacheKey(): Optional<String> = body.promptCacheKey()
 
     /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+     * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+     * content blocks with `prompt_cache_breakpoint`. Each request can write up to four breakpoints.
+     * For cache matching, OpenAI considers up to the latest 80 breakpoints in the conversation,
+     * without a content-block lookback limit. Set `mode` to `explicit` to disable the implicit
+     * breakpoint. The `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for current
+     * details.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheOptions(): Optional<PromptCacheOptions> = body.promptCacheOptions()
+
+    /**
+     * Deprecated. Use `prompt_cache_options.ttl` instead.
+     *
      * The retention policy for the prompt cache. Set to `24h` to enable extended prompt caching,
      * which keeps cached prefixes active for longer, up to a maximum of 24 hours.
      * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
-     * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+     * This field expresses a maximum retention policy, while `prompt_cache_options.ttl` expresses a
+     * minimum cache lifetime. The two fields are independent and do not interact. For `gpt-5.5`,
+     * `gpt-5.5-pro`, and future models, only `24h` is supported.
      *
      * For older models that support both `in_memory` and `24h`, the default depends on your
      * organization's data retention policy:
@@ -291,20 +310,16 @@ private constructor(
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
+    @Deprecated("deprecated")
     fun promptCacheRetention(): Optional<PromptCacheRetention> = body.promptCacheRetention()
 
     /**
-     * Constrains effort on reasoning for
-     * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported
-     * values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing reasoning effort
-     * can result in faster responses and fewer tokens used on reasoning in a response.
-     * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
-     *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported for
-     *   all reasoning values in gpt-5.1.
-     * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support
-     *   `none`.
-     * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+     * Constrains effort on reasoning for reasoning models. Currently supported values are `none`,
+     * `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort can result
+     * in faster responses and fewer tokens used on reasoning in a response. Not all reasoning
+     * models support every value. See the
+     * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+     * support.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -618,12 +633,21 @@ private constructor(
      */
     fun _promptCacheKey(): JsonField<String> = body._promptCacheKey()
 
+    /**
+     * Returns the raw JSON value of [promptCacheOptions].
+     *
+     * Unlike [promptCacheOptions], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    fun _promptCacheOptions(): JsonField<PromptCacheOptions> = body._promptCacheOptions()
+
     /**
      * Returns the raw JSON value of [promptCacheRetention].
      *
      * Unlike [promptCacheRetention], this method doesn't throw if the JSON field has an unexpected
      * type.
      */
+    @Deprecated("deprecated")
     fun _promptCacheRetention(): JsonField<PromptCacheRetention> = body._promptCacheRetention()
 
     /**
@@ -1410,9 +1434,39 @@ private constructor(
         }
 
         /**
+         * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+         * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+         * content blocks with `prompt_cache_breakpoint`. Each request can write up to four
+         * breakpoints. For cache matching, OpenAI considers up to the latest 80 breakpoints in the
+         * conversation, without a content-block lookback limit. Set `mode` to `explicit` to disable
+         * the implicit breakpoint. The `ttl` defaults to `30m`, which is currently the only
+         * supported value. See the
+         * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+         * current details.
+         */
+        fun promptCacheOptions(promptCacheOptions: PromptCacheOptions) = apply {
+            body.promptCacheOptions(promptCacheOptions)
+        }
+
+        /**
+         * Sets [Builder.promptCacheOptions] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheOptions] with a well-typed
+         * [PromptCacheOptions] value instead. This method is primarily for setting the field to an
+         * undocumented or not yet supported value.
+         */
+        fun promptCacheOptions(promptCacheOptions: JsonField<PromptCacheOptions>) = apply {
+            body.promptCacheOptions(promptCacheOptions)
+        }
+
+        /**
+         * Deprecated. Use `prompt_cache_options.ttl` instead.
+         *
          * The retention policy for the prompt cache. Set to `24h` to enable extended prompt
          * caching, which keeps cached prefixes active for longer, up to a maximum of 24 hours.
          * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+         * This field expresses a maximum retention policy, while `prompt_cache_options.ttl`
+         * expresses a minimum cache lifetime. The two fields are independent and do not interact.
          * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
          *
          * For older models that support both `in_memory` and `24h`, the default depends on your
@@ -1421,6 +1475,7 @@ private constructor(
          * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is
          *   not specified.
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(promptCacheRetention: PromptCacheRetention?) = apply {
             body.promptCacheRetention(promptCacheRetention)
         }
@@ -1429,6 +1484,7 @@ private constructor(
          * Alias for calling [Builder.promptCacheRetention] with
          * `promptCacheRetention.orElse(null)`.
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(promptCacheRetention: Optional<PromptCacheRetention>) =
             promptCacheRetention(promptCacheRetention.getOrNull())
 
@@ -1439,23 +1495,18 @@ private constructor(
          * [PromptCacheRetention] value instead. This method is primarily for setting the field to
          * an undocumented or not yet supported value.
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(promptCacheRetention: JsonField<PromptCacheRetention>) = apply {
             body.promptCacheRetention(promptCacheRetention)
         }
 
         /**
-         * Constrains effort on reasoning for
-         * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-         * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing
-         * reasoning effort can result in faster responses and fewer tokens used on reasoning in a
-         * response.
-         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
-         *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported
-         *   for all reasoning values in gpt-5.1.
-         * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support
-         *   `none`.
-         * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-         * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
          */
         fun reasoningEffort(reasoningEffort: ReasoningEffort?) = apply {
             body.reasoningEffort(reasoningEffort)
@@ -2122,6 +2173,7 @@ private constructor(
         private val prediction: JsonField<ChatCompletionPredictionContent>,
         private val presencePenalty: JsonField<Double>,
         private val promptCacheKey: JsonField<String>,
+        private val promptCacheOptions: JsonField<PromptCacheOptions>,
         private val promptCacheRetention: JsonField<PromptCacheRetention>,
         private val reasoningEffort: JsonField<ReasoningEffort>,
         private val responseFormat: JsonField<ResponseFormat>,
@@ -2194,6 +2246,9 @@ private constructor(
             @JsonProperty("prompt_cache_key")
             @ExcludeMissing
             promptCacheKey: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("prompt_cache_options")
+            @ExcludeMissing
+            promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of(),
             @JsonProperty("prompt_cache_retention")
             @ExcludeMissing
             promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of(),
@@ -2254,6 +2309,7 @@ private constructor(
             prediction,
             presencePenalty,
             promptCacheKey,
+            promptCacheOptions,
             promptCacheRetention,
             reasoningEffort,
             responseFormat,
@@ -2486,9 +2542,30 @@ private constructor(
         fun promptCacheKey(): Optional<String> = promptCacheKey.getOptional("prompt_cache_key")
 
         /**
+         * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+         * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+         * content blocks with `prompt_cache_breakpoint`. Each request can write up to four
+         * breakpoints. For cache matching, OpenAI considers up to the latest 80 breakpoints in the
+         * conversation, without a content-block lookback limit. Set `mode` to `explicit` to disable
+         * the implicit breakpoint. The `ttl` defaults to `30m`, which is currently the only
+         * supported value. See the
+         * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+         * current details.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun promptCacheOptions(): Optional<PromptCacheOptions> =
+            promptCacheOptions.getOptional("prompt_cache_options")
+
+        /**
+         * Deprecated. Use `prompt_cache_options.ttl` instead.
+         *
          * The retention policy for the prompt cache. Set to `24h` to enable extended prompt
          * caching, which keeps cached prefixes active for longer, up to a maximum of 24 hours.
          * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+         * This field expresses a maximum retention policy, while `prompt_cache_options.ttl`
+         * expresses a minimum cache lifetime. The two fields are independent and do not interact.
          * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
          *
          * For older models that support both `in_memory` and `24h`, the default depends on your
@@ -2500,22 +2577,17 @@ private constructor(
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(): Optional<PromptCacheRetention> =
             promptCacheRetention.getOptional("prompt_cache_retention")
 
         /**
-         * Constrains effort on reasoning for
-         * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-         * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing
-         * reasoning effort can result in faster responses and fewer tokens used on reasoning in a
-         * response.
-         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
-         *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported
-         *   for all reasoning values in gpt-5.1.
-         * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support
-         *   `none`.
-         * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-         * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -2870,12 +2942,23 @@ private constructor(
         @ExcludeMissing
         fun _promptCacheKey(): JsonField<String> = promptCacheKey
 
+        /**
+         * Returns the raw JSON value of [promptCacheOptions].
+         *
+         * Unlike [promptCacheOptions], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @JsonProperty("prompt_cache_options")
+        @ExcludeMissing
+        fun _promptCacheOptions(): JsonField<PromptCacheOptions> = promptCacheOptions
+
         /**
          * Returns the raw JSON value of [promptCacheRetention].
          *
          * Unlike [promptCacheRetention], this method doesn't throw if the JSON field has an
          * unexpected type.
          */
+        @Deprecated("deprecated")
         @JsonProperty("prompt_cache_retention")
         @ExcludeMissing
         fun _promptCacheRetention(): JsonField<PromptCacheRetention> = promptCacheRetention
@@ -3072,6 +3155,7 @@ private constructor(
             private var prediction: JsonField<ChatCompletionPredictionContent> = JsonMissing.of()
             private var presencePenalty: JsonField<Double> = JsonMissing.of()
             private var promptCacheKey: JsonField<String> = JsonMissing.of()
+            private var promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of()
             private var promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of()
             private var reasoningEffort: JsonField<ReasoningEffort> = JsonMissing.of()
             private var responseFormat: JsonField<ResponseFormat> = JsonMissing.of()
@@ -3111,6 +3195,7 @@ private constructor(
                 prediction = body.prediction
                 presencePenalty = body.presencePenalty
                 promptCacheKey = body.promptCacheKey
+                promptCacheOptions = body.promptCacheOptions
                 promptCacheRetention = body.promptCacheRetention
                 reasoningEffort = body.reasoningEffort
                 responseFormat = body.responseFormat
@@ -3803,10 +3888,39 @@ private constructor(
             }
 
             /**
+             * Options for prompt caching. Supported for `gpt-5.6` and later models. By default,
+             * OpenAI automatically chooses one implicit cache breakpoint. You can add explicit
+             * breakpoints to content blocks with `prompt_cache_breakpoint`. Each request can write
+             * up to four breakpoints. For cache matching, OpenAI considers up to the latest 80
+             * breakpoints in the conversation, without a content-block lookback limit. Set `mode`
+             * to `explicit` to disable the implicit breakpoint. The `ttl` defaults to `30m`, which
+             * is currently the only supported value. See the
+             * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+             * current details.
+             */
+            fun promptCacheOptions(promptCacheOptions: PromptCacheOptions) =
+                promptCacheOptions(JsonField.of(promptCacheOptions))
+
+            /**
+             * Sets [Builder.promptCacheOptions] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.promptCacheOptions] with a well-typed
+             * [PromptCacheOptions] value instead. This method is primarily for setting the field to
+             * an undocumented or not yet supported value.
+             */
+            fun promptCacheOptions(promptCacheOptions: JsonField<PromptCacheOptions>) = apply {
+                this.promptCacheOptions = promptCacheOptions
+            }
+
+            /**
+             * Deprecated. Use `prompt_cache_options.ttl` instead.
+             *
              * The retention policy for the prompt cache. Set to `24h` to enable extended prompt
              * caching, which keeps cached prefixes active for longer, up to a maximum of 24 hours.
              * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
-             * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+             * This field expresses a maximum retention policy, while `prompt_cache_options.ttl`
+             * expresses a minimum cache lifetime. The two fields are independent and do not
+             * interact. For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
              *
              * For older models that support both `in_memory` and `24h`, the default depends on your
              * organization's data retention policy:
@@ -3814,6 +3928,7 @@ private constructor(
              * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention`
              *   is not specified.
              */
+            @Deprecated("deprecated")
             fun promptCacheRetention(promptCacheRetention: PromptCacheRetention?) =
                 promptCacheRetention(JsonField.ofNullable(promptCacheRetention))
 
@@ -3821,6 +3936,7 @@ private constructor(
              * Alias for calling [Builder.promptCacheRetention] with
              * `promptCacheRetention.orElse(null)`.
              */
+            @Deprecated("deprecated")
             fun promptCacheRetention(promptCacheRetention: Optional<PromptCacheRetention>) =
                 promptCacheRetention(promptCacheRetention.getOrNull())
 
@@ -3831,24 +3947,19 @@ private constructor(
              * [PromptCacheRetention] value instead. This method is primarily for setting the field
              * to an undocumented or not yet supported value.
              */
+            @Deprecated("deprecated")
             fun promptCacheRetention(promptCacheRetention: JsonField<PromptCacheRetention>) =
                 apply {
                     this.promptCacheRetention = promptCacheRetention
                 }
 
             /**
-             * Constrains effort on reasoning for
-             * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-             * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-             * Reducing reasoning effort can result in faster responses and fewer tokens used on
-             * reasoning in a response.
-             * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-             *   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls
-             *   are supported for all reasoning values in gpt-5.1.
-             * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-             *   support `none`.
-             * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-             * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+             * Constrains effort on reasoning for reasoning models. Currently supported values are
+             * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning
+             * effort can result in faster responses and fewer tokens used on reasoning in a
+             * response. Not all reasoning models support every value. See the
+             * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+             * model-specific support.
              */
             fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                 reasoningEffort(JsonField.ofNullable(reasoningEffort))
@@ -4381,6 +4492,7 @@ private constructor(
                     prediction,
                     presencePenalty,
                     promptCacheKey,
+                    promptCacheOptions,
                     promptCacheRetention,
                     reasoningEffort,
                     responseFormat,
@@ -4436,6 +4548,7 @@ private constructor(
             prediction().ifPresent { it.validate() }
             presencePenalty()
             promptCacheKey()
+            promptCacheOptions().ifPresent { it.validate() }
             promptCacheRetention().ifPresent { it.validate() }
             reasoningEffort().ifPresent { it.validate() }
             responseFormat().ifPresent { it.validate() }
@@ -4490,6 +4603,7 @@ private constructor(
                 (prediction.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (presencePenalty.asKnown().isPresent) 1 else 0) +
                 (if (promptCacheKey.asKnown().isPresent) 1 else 0) +
+                (promptCacheOptions.asKnown().getOrNull()?.validity() ?: 0) +
                 (promptCacheRetention.asKnown().getOrNull()?.validity() ?: 0) +
                 (reasoningEffort.asKnown().getOrNull()?.validity() ?: 0) +
                 (responseFormat.asKnown().getOrNull()?.validity() ?: 0) +
@@ -4532,6 +4646,7 @@ private constructor(
                 prediction == other.prediction &&
                 presencePenalty == other.presencePenalty &&
                 promptCacheKey == other.promptCacheKey &&
+                promptCacheOptions == other.promptCacheOptions &&
                 promptCacheRetention == other.promptCacheRetention &&
                 reasoningEffort == other.reasoningEffort &&
                 responseFormat == other.responseFormat &&
@@ -4572,6 +4687,7 @@ private constructor(
                 prediction,
                 presencePenalty,
                 promptCacheKey,
+                promptCacheOptions,
                 promptCacheRetention,
                 reasoningEffort,
                 responseFormat,
@@ -4596,7 +4712,7 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Body{messages=$messages, model=$model, audio=$audio, frequencyPenalty=$frequencyPenalty, functionCall=$functionCall, functions=$functions, logitBias=$logitBias, logprobs=$logprobs, maxCompletionTokens=$maxCompletionTokens, maxTokens=$maxTokens, metadata=$metadata, modalities=$modalities, moderation=$moderation, n=$n, parallelToolCalls=$parallelToolCalls, prediction=$prediction, presencePenalty=$presencePenalty, promptCacheKey=$promptCacheKey, promptCacheRetention=$promptCacheRetention, reasoningEffort=$reasoningEffort, responseFormat=$responseFormat, safetyIdentifier=$safetyIdentifier, seed=$seed, serviceTier=$serviceTier, stop=$stop, store=$store, streamOptions=$streamOptions, temperature=$temperature, toolChoice=$toolChoice, tools=$tools, topLogprobs=$topLogprobs, topP=$topP, user=$user, verbosity=$verbosity, webSearchOptions=$webSearchOptions, additionalProperties=$additionalProperties}"
+            "Body{messages=$messages, model=$model, audio=$audio, frequencyPenalty=$frequencyPenalty, functionCall=$functionCall, functions=$functions, logitBias=$logitBias, logprobs=$logprobs, maxCompletionTokens=$maxCompletionTokens, maxTokens=$maxTokens, metadata=$metadata, modalities=$modalities, moderation=$moderation, n=$n, parallelToolCalls=$parallelToolCalls, prediction=$prediction, presencePenalty=$presencePenalty, promptCacheKey=$promptCacheKey, promptCacheOptions=$promptCacheOptions, promptCacheRetention=$promptCacheRetention, reasoningEffort=$reasoningEffort, responseFormat=$responseFormat, safetyIdentifier=$safetyIdentifier, seed=$seed, serviceTier=$serviceTier, stop=$stop, store=$store, streamOptions=$streamOptions, temperature=$temperature, toolChoice=$toolChoice, tools=$tools, topLogprobs=$topLogprobs, topP=$topP, user=$user, verbosity=$verbosity, webSearchOptions=$webSearchOptions, additionalProperties=$additionalProperties}"
     }
 
     /**
@@ -5663,13 +5779,15 @@ private constructor(
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
         private val model: JsonField<String>,
+        private val policy: JsonField<Policy>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
         @JsonCreator
         private constructor(
-            @JsonProperty("model") @ExcludeMissing model: JsonField<String> = JsonMissing.of()
-        ) : this(model, mutableMapOf())
+            @JsonProperty("model") @ExcludeMissing model: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("policy") @ExcludeMissing policy: JsonField<Policy> = JsonMissing.of(),
+        ) : this(model, policy, mutableMapOf())
 
         /**
          * The moderation model to use for moderated completions, e.g. 'omni-moderation-latest'.
@@ -5679,6 +5797,14 @@ private constructor(
          */
         fun model(): String = model.getRequired("model")
 
+        /**
+         * The policy to apply to moderated response input and output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun policy(): Optional<Policy> = policy.getOptional("policy")
+
         /**
          * Returns the raw JSON value of [model].
          *
@@ -5686,6 +5812,13 @@ private constructor(
          */
         @JsonProperty("model") @ExcludeMissing fun _model(): JsonField<String> = model
 
+        /**
+         * Returns the raw JSON value of [policy].
+         *
+         * Unlike [policy], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("policy") @ExcludeMissing fun _policy(): JsonField<Policy> = policy
+
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
             additionalProperties.put(key, value)
@@ -5715,11 +5848,13 @@ private constructor(
         class Builder internal constructor() {
 
             private var model: JsonField<String>? = null
+            private var policy: JsonField<Policy> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
             internal fun from(moderation: Moderation) = apply {
                 model = moderation.model
+                policy = moderation.policy
                 additionalProperties = moderation.additionalProperties.toMutableMap()
             }
 
@@ -5737,6 +5872,21 @@ private constructor(
              */
             fun model(model: JsonField<String>) = apply { this.model = model }
 
+            /** The policy to apply to moderated response input and output. */
+            fun policy(policy: Policy?) = policy(JsonField.ofNullable(policy))
+
+            /** Alias for calling [Builder.policy] with `policy.orElse(null)`. */
+            fun policy(policy: Optional<Policy>) = policy(policy.getOrNull())
+
+            /**
+             * Sets [Builder.policy] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.policy] with a well-typed [Policy] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun policy(policy: JsonField<Policy>) = apply { this.policy = policy }
+
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
                 putAllAdditionalProperties(additionalProperties)
@@ -5769,7 +5919,11 @@ private constructor(
              * @throws IllegalStateException if any required field is unset.
              */
             fun build(): Moderation =
-                Moderation(checkRequired("model", model), additionalProperties.toMutableMap())
+                Moderation(
+                    checkRequired("model", model),
+                    policy,
+                    additionalProperties.toMutableMap(),
+                )
         }
 
         private var validated: Boolean = false
@@ -5789,6 +5943,7 @@ private constructor(
             }
 
             model()
+            policy().ifPresent { it.validate() }
             validated = true
         }
 
@@ -5806,38 +5961,1364 @@ private constructor(
          *
          * Used for best match union deserialization.
          */
-        @JvmSynthetic internal fun validity(): Int = (if (model.asKnown().isPresent) 1 else 0)
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (model.asKnown().isPresent) 1 else 0) +
+                (policy.asKnown().getOrNull()?.validity() ?: 0)
 
-        override fun equals(other: Any?): Boolean {
-            if (this === other) {
-                return true
+        /** The policy to apply to moderated response input and output. */
+        class Policy
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val input: JsonField<Input>,
+            private val output: JsonField<Output>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("input") @ExcludeMissing input: JsonField<Input> = JsonMissing.of(),
+                @JsonProperty("output") @ExcludeMissing output: JsonField<Output> = JsonMissing.of(),
+            ) : this(input, output, mutableMapOf())
+
+            /**
+             * The moderation policy for the response input.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun input(): Optional<Input> = input.getOptional("input")
+
+            /**
+             * The moderation policy for the response output.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun output(): Optional<Output> = output.getOptional("output")
+
+            /**
+             * Returns the raw JSON value of [input].
+             *
+             * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("input") @ExcludeMissing fun _input(): JsonField<Input> = input
+
+            /**
+             * Returns the raw JSON value of [output].
+             *
+             * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<Output> = output
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
             }
 
-            return other is Moderation &&
-                model == other.model &&
-                additionalProperties == other.additionalProperties
-        }
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
 
-        private val hashCode: Int by lazy { Objects.hash(model, additionalProperties) }
+            fun toBuilder() = Builder().from(this)
 
-        override fun hashCode(): Int = hashCode
+            companion object {
 
-        override fun toString() =
-            "Moderation{model=$model, additionalProperties=$additionalProperties}"
-    }
+                /** Returns a mutable builder for constructing an instance of [Policy]. */
+                @JvmStatic fun builder() = Builder()
+            }
 
-    /**
-     * The retention policy for the prompt cache. Set to `24h` to enable extended prompt caching,
-     * which keeps cached prefixes active for longer, up to a maximum of 24 hours.
-     * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
-     * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
-     *
-     * For older models that support both `in_memory` and `24h`, the default depends on your
-     * organization's data retention policy:
-     * - Organizations without ZDR enabled default to `24h`.
-     * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is not
-     *   specified.
-     */
+            /** A builder for [Policy]. */
+            class Builder internal constructor() {
+
+                private var input: JsonField<Input> = JsonMissing.of()
+                private var output: JsonField<Output> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(policy: Policy) = apply {
+                    input = policy.input
+                    output = policy.output
+                    additionalProperties = policy.additionalProperties.toMutableMap()
+                }
+
+                /** The moderation policy for the response input. */
+                fun input(input: Input?) = input(JsonField.ofNullable(input))
+
+                /** Alias for calling [Builder.input] with `input.orElse(null)`. */
+                fun input(input: Optional<Input>) = input(input.getOrNull())
+
+                /**
+                 * Sets [Builder.input] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.input] with a well-typed [Input] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun input(input: JsonField<Input>) = apply { this.input = input }
+
+                /** The moderation policy for the response output. */
+                fun output(output: Output?) = output(JsonField.ofNullable(output))
+
+                /** Alias for calling [Builder.output] with `output.orElse(null)`. */
+                fun output(output: Optional<Output>) = output(output.getOrNull())
+
+                /**
+                 * Sets [Builder.output] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.output] with a well-typed [Output] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun output(output: JsonField<Output>) = apply { this.output = output }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Policy].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): Policy = Policy(input, output, additionalProperties.toMutableMap())
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Policy = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                input().ifPresent { it.validate() }
+                output().ifPresent { it.validate() }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (input.asKnown().getOrNull()?.validity() ?: 0) +
+                    (output.asKnown().getOrNull()?.validity() ?: 0)
+
+            /** The moderation policy for the response input. */
+            class Input
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val mode: JsonField<Mode>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of()
+                ) : this(mode, mutableMapOf())
+
+                /**
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun mode(): Mode = mode.getRequired("mode")
+
+                /**
+                 * Returns the raw JSON value of [mode].
+                 *
+                 * Unlike [mode], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Input].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .mode()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Input]. */
+                class Builder internal constructor() {
+
+                    private var mode: JsonField<Mode>? = null
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(input: Input) = apply {
+                        mode = input.mode
+                        additionalProperties = input.additionalProperties.toMutableMap()
+                    }
+
+                    fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+                    /**
+                     * Sets [Builder.mode] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.mode] with a well-typed [Mode] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Input].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .mode()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Input =
+                        Input(checkRequired("mode", mode), additionalProperties.toMutableMap())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Input = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    mode().validate()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int = (mode.asKnown().getOrNull()?.validity() ?: 0)
+
+                class Mode @JsonCreator private constructor(private val value: JsonField<String>) :
+                    Enum {
+
+                    /**
+                     * Returns this class instance's raw value.
+                     *
+                     * This is usually only useful if this instance was deserialized from data that
+                     * doesn't match any known member, and you want to know that value. For example,
+                     * if the SDK is on an older version than the API, then the API may respond with
+                     * new members that the SDK is unaware of.
+                     */
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    fun _value(): JsonField<String> = value
+
+                    companion object {
+
+                        @JvmField val SCORE = of("score")
+
+                        @JvmField val BLOCK = of("block")
+
+                        @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+                    }
+
+                    /** An enum containing [Mode]'s known values. */
+                    enum class Known {
+                        SCORE,
+                        BLOCK,
+                    }
+
+                    /**
+                     * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+                     *
+                     * An instance of [Mode] can contain an unknown value in a couple of cases:
+                     * - It was deserialized from data that doesn't match any known member. For
+                     *   example, if the SDK is on an older version than the API, then the API may
+                     *   respond with new members that the SDK is unaware of.
+                     * - It was constructed with an arbitrary value using the [of] method.
+                     */
+                    enum class Value {
+                        SCORE,
+                        BLOCK,
+                        /**
+                         * An enum member indicating that [Mode] was instantiated with an unknown
+                         * value.
+                         */
+                        _UNKNOWN,
+                    }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value, or
+                     * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                     *
+                     * Use the [known] method instead if you're certain the value is always known or
+                     * if you want to throw for the unknown case.
+                     */
+                    fun value(): Value =
+                        when (this) {
+                            SCORE -> Value.SCORE
+                            BLOCK -> Value.BLOCK
+                            else -> Value._UNKNOWN
+                        }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value.
+                     *
+                     * Use the [value] method instead if you're uncertain the value is always known
+                     * and don't want to throw for the unknown case.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                     *   known member.
+                     */
+                    fun known(): Known =
+                        when (this) {
+                            SCORE -> Known.SCORE
+                            BLOCK -> Known.BLOCK
+                            else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                        }
+
+                    /**
+                     * Returns this class instance's primitive wire representation.
+                     *
+                     * This differs from the [toString] method because that method is primarily for
+                     * debugging and generally doesn't throw.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value does not
+                     *   have the expected primitive type.
+                     */
+                    fun asString(): String =
+                        _value().asString().orElseThrow {
+                            OpenAIInvalidDataException("Value is not a String")
+                        }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): Mode = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        known()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Mode && value == other.value
+                    }
+
+                    override fun hashCode() = value.hashCode()
+
+                    override fun toString() = value.toString()
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Input &&
+                        mode == other.mode &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Input{mode=$mode, additionalProperties=$additionalProperties}"
+            }
+
+            /** The moderation policy for the response output. */
+            class Output
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val mode: JsonField<Mode>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of()
+                ) : this(mode, mutableMapOf())
+
+                /**
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun mode(): Mode = mode.getRequired("mode")
+
+                /**
+                 * Returns the raw JSON value of [mode].
+                 *
+                 * Unlike [mode], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Output].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .mode()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Output]. */
+                class Builder internal constructor() {
+
+                    private var mode: JsonField<Mode>? = null
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(output: Output) = apply {
+                        mode = output.mode
+                        additionalProperties = output.additionalProperties.toMutableMap()
+                    }
+
+                    fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+                    /**
+                     * Sets [Builder.mode] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.mode] with a well-typed [Mode] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Output].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .mode()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Output =
+                        Output(checkRequired("mode", mode), additionalProperties.toMutableMap())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Output = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    mode().validate()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int = (mode.asKnown().getOrNull()?.validity() ?: 0)
+
+                class Mode @JsonCreator private constructor(private val value: JsonField<String>) :
+                    Enum {
+
+                    /**
+                     * Returns this class instance's raw value.
+                     *
+                     * This is usually only useful if this instance was deserialized from data that
+                     * doesn't match any known member, and you want to know that value. For example,
+                     * if the SDK is on an older version than the API, then the API may respond with
+                     * new members that the SDK is unaware of.
+                     */
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    fun _value(): JsonField<String> = value
+
+                    companion object {
+
+                        @JvmField val SCORE = of("score")
+
+                        @JvmField val BLOCK = of("block")
+
+                        @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+                    }
+
+                    /** An enum containing [Mode]'s known values. */
+                    enum class Known {
+                        SCORE,
+                        BLOCK,
+                    }
+
+                    /**
+                     * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+                     *
+                     * An instance of [Mode] can contain an unknown value in a couple of cases:
+                     * - It was deserialized from data that doesn't match any known member. For
+                     *   example, if the SDK is on an older version than the API, then the API may
+                     *   respond with new members that the SDK is unaware of.
+                     * - It was constructed with an arbitrary value using the [of] method.
+                     */
+                    enum class Value {
+                        SCORE,
+                        BLOCK,
+                        /**
+                         * An enum member indicating that [Mode] was instantiated with an unknown
+                         * value.
+                         */
+                        _UNKNOWN,
+                    }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value, or
+                     * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                     *
+                     * Use the [known] method instead if you're certain the value is always known or
+                     * if you want to throw for the unknown case.
+                     */
+                    fun value(): Value =
+                        when (this) {
+                            SCORE -> Value.SCORE
+                            BLOCK -> Value.BLOCK
+                            else -> Value._UNKNOWN
+                        }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value.
+                     *
+                     * Use the [value] method instead if you're uncertain the value is always known
+                     * and don't want to throw for the unknown case.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                     *   known member.
+                     */
+                    fun known(): Known =
+                        when (this) {
+                            SCORE -> Known.SCORE
+                            BLOCK -> Known.BLOCK
+                            else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                        }
+
+                    /**
+                     * Returns this class instance's primitive wire representation.
+                     *
+                     * This differs from the [toString] method because that method is primarily for
+                     * debugging and generally doesn't throw.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value does not
+                     *   have the expected primitive type.
+                     */
+                    fun asString(): String =
+                        _value().asString().orElseThrow {
+                            OpenAIInvalidDataException("Value is not a String")
+                        }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): Mode = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        known()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Mode && value == other.value
+                    }
+
+                    override fun hashCode() = value.hashCode()
+
+                    override fun toString() = value.toString()
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Output &&
+                        mode == other.mode &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Output{mode=$mode, additionalProperties=$additionalProperties}"
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Policy &&
+                    input == other.input &&
+                    output == other.output &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(input, output, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Policy{input=$input, output=$output, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Moderation &&
+                model == other.model &&
+                policy == other.policy &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(model, policy, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Moderation{model=$model, policy=$policy, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+     * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+     * content blocks with `prompt_cache_breakpoint`. Each request can write up to four breakpoints.
+     * For cache matching, OpenAI considers up to the latest 80 breakpoints in the conversation,
+     * without a content-block lookback limit. Set `mode` to `explicit` to disable the implicit
+     * breakpoint. The `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for current
+     * details.
+     */
+    class PromptCacheOptions
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonField<Mode>,
+        private val ttl: JsonField<Ttl>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of(),
+            @JsonProperty("ttl") @ExcludeMissing ttl: JsonField<Ttl> = JsonMissing.of(),
+        ) : this(mode, ttl, mutableMapOf())
+
+        /**
+         * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults to
+         * `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up to the
+         * latest three explicit breakpoints in the request. With `explicit`, OpenAI does not create
+         * an implicit breakpoint and writes up to the latest four explicit breakpoints. If there
+         * are no explicit breakpoints, the request does not use prompt caching.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun mode(): Optional<Mode> = mode.getOptional("mode")
+
+        /**
+         * The minimum lifetime applied to every implicit and explicit cache breakpoint written by
+         * the request. Defaults to `30m`, which is currently the only supported value. The backend
+         * may retain cache entries for longer.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun ttl(): Optional<Ttl> = ttl.getOptional("ttl")
+
+        /**
+         * Returns the raw JSON value of [mode].
+         *
+         * Unlike [mode], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+        /**
+         * Returns the raw JSON value of [ttl].
+         *
+         * Unlike [ttl], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("ttl") @ExcludeMissing fun _ttl(): JsonField<Ttl> = ttl
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [PromptCacheOptions]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheOptions]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonField<Mode> = JsonMissing.of()
+            private var ttl: JsonField<Ttl> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheOptions: PromptCacheOptions) = apply {
+                mode = promptCacheOptions.mode
+                ttl = promptCacheOptions.ttl
+                additionalProperties = promptCacheOptions.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults
+             * to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up
+             * to the latest three explicit breakpoints in the request. With `explicit`, OpenAI does
+             * not create an implicit breakpoint and writes up to the latest four explicit
+             * breakpoints. If there are no explicit breakpoints, the request does not use prompt
+             * caching.
+             */
+            fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+            /**
+             * Sets [Builder.mode] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.mode] with a well-typed [Mode] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+            /**
+             * The minimum lifetime applied to every implicit and explicit cache breakpoint written
+             * by the request. Defaults to `30m`, which is currently the only supported value. The
+             * backend may retain cache entries for longer.
+             */
+            fun ttl(ttl: Ttl) = ttl(JsonField.of(ttl))
+
+            /**
+             * Sets [Builder.ttl] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.ttl] with a well-typed [Ttl] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun ttl(ttl: JsonField<Ttl>) = apply { this.ttl = ttl }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheOptions].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheOptions =
+                PromptCacheOptions(mode, ttl, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheOptions = apply {
+            if (validated) {
+                return@apply
+            }
+
+            mode().ifPresent { it.validate() }
+            ttl().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (mode.asKnown().getOrNull()?.validity() ?: 0) +
+                (ttl.asKnown().getOrNull()?.validity() ?: 0)
+
+        /**
+         * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults to
+         * `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up to the
+         * latest three explicit breakpoints in the request. With `explicit`, OpenAI does not create
+         * an implicit breakpoint and writes up to the latest four explicit breakpoints. If there
+         * are no explicit breakpoints, the request does not use prompt caching.
+         */
+        class Mode @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IMPLICIT = of("implicit")
+
+                @JvmField val EXPLICIT = of("explicit")
+
+                @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+            }
+
+            /** An enum containing [Mode]'s known values. */
+            enum class Known {
+                IMPLICIT,
+                EXPLICIT,
+            }
+
+            /**
+             * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Mode] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IMPLICIT,
+                EXPLICIT,
+                /** An enum member indicating that [Mode] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IMPLICIT -> Value.IMPLICIT
+                    EXPLICIT -> Value.EXPLICIT
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IMPLICIT -> Known.IMPLICIT
+                    EXPLICIT -> Known.EXPLICIT
+                    else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Mode = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Mode && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * The minimum lifetime applied to every implicit and explicit cache breakpoint written by
+         * the request. Defaults to `30m`, which is currently the only supported value. The backend
+         * may retain cache entries for longer.
+         */
+        class Ttl @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val _30M = of("30m")
+
+                @JvmStatic fun of(value: String) = Ttl(JsonField.of(value))
+            }
+
+            /** An enum containing [Ttl]'s known values. */
+            enum class Known {
+                _30M
+            }
+
+            /**
+             * An enum containing [Ttl]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Ttl] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                _30M,
+                /** An enum member indicating that [Ttl] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    _30M -> Value._30M
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    _30M -> Known._30M
+                    else -> throw OpenAIInvalidDataException("Unknown Ttl: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Ttl = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Ttl && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheOptions &&
+                mode == other.mode &&
+                ttl == other.ttl &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, ttl, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheOptions{mode=$mode, ttl=$ttl, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Deprecated. Use `prompt_cache_options.ttl` instead.
+     *
+     * The retention policy for the prompt cache. Set to `24h` to enable extended prompt caching,
+     * which keeps cached prefixes active for longer, up to a maximum of 24 hours.
+     * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+     * This field expresses a maximum retention policy, while `prompt_cache_options.ttl` expresses a
+     * minimum cache lifetime. The two fields are independent and do not interact. For `gpt-5.5`,
+     * `gpt-5.5-pro`, and future models, only `24h` is supported.
+     *
+     * For older models that support both `in_memory` and `24h`, the default depends on your
+     * organization's data retention policy:
+     * - Organizations without ZDR enabled default to `24h`.
+     * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is not
+     *   specified.
+     */
+    @Deprecated("deprecated")
     class PromptCacheRetention
     @JsonCreator
     private constructor(private val value: JsonField<String>) : Enum {
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/completions/CompletionUsage.kt b/openai-java-core/src/main/kotlin/com/openai/models/completions/CompletionUsage.kt
index 7acabe460..f3821c74c 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/completions/CompletionUsage.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/completions/CompletionUsage.kt
@@ -672,6 +672,7 @@ private constructor(
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
         private val audioTokens: JsonField<Long>,
+        private val cacheWriteTokens: JsonField<Long>,
         private val cachedTokens: JsonField<Long>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
@@ -681,10 +682,13 @@ private constructor(
             @JsonProperty("audio_tokens")
             @ExcludeMissing
             audioTokens: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("cache_write_tokens")
+            @ExcludeMissing
+            cacheWriteTokens: JsonField<Long> = JsonMissing.of(),
             @JsonProperty("cached_tokens")
             @ExcludeMissing
             cachedTokens: JsonField<Long> = JsonMissing.of(),
-        ) : this(audioTokens, cachedTokens, mutableMapOf())
+        ) : this(audioTokens, cacheWriteTokens, cachedTokens, mutableMapOf())
 
         /**
          * Audio input tokens present in the prompt.
@@ -694,6 +698,14 @@ private constructor(
          */
         fun audioTokens(): Optional<Long> = audioTokens.getOptional("audio_tokens")
 
+        /**
+         * The unadjusted number of prompt tokens written to cache.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun cacheWriteTokens(): Optional<Long> = cacheWriteTokens.getOptional("cache_write_tokens")
+
         /**
          * Cached tokens present in the prompt.
          *
@@ -711,6 +723,16 @@ private constructor(
         @ExcludeMissing
         fun _audioTokens(): JsonField<Long> = audioTokens
 
+        /**
+         * Returns the raw JSON value of [cacheWriteTokens].
+         *
+         * Unlike [cacheWriteTokens], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("cache_write_tokens")
+        @ExcludeMissing
+        fun _cacheWriteTokens(): JsonField<Long> = cacheWriteTokens
+
         /**
          * Returns the raw JSON value of [cachedTokens].
          *
@@ -743,12 +765,14 @@ private constructor(
         class Builder internal constructor() {
 
             private var audioTokens: JsonField<Long> = JsonMissing.of()
+            private var cacheWriteTokens: JsonField<Long> = JsonMissing.of()
             private var cachedTokens: JsonField<Long> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
             internal fun from(promptTokensDetails: PromptTokensDetails) = apply {
                 audioTokens = promptTokensDetails.audioTokens
+                cacheWriteTokens = promptTokensDetails.cacheWriteTokens
                 cachedTokens = promptTokensDetails.cachedTokens
                 additionalProperties = promptTokensDetails.additionalProperties.toMutableMap()
             }
@@ -765,6 +789,21 @@ private constructor(
              */
             fun audioTokens(audioTokens: JsonField<Long>) = apply { this.audioTokens = audioTokens }
 
+            /** The unadjusted number of prompt tokens written to cache. */
+            fun cacheWriteTokens(cacheWriteTokens: Long) =
+                cacheWriteTokens(JsonField.of(cacheWriteTokens))
+
+            /**
+             * Sets [Builder.cacheWriteTokens] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.cacheWriteTokens] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun cacheWriteTokens(cacheWriteTokens: JsonField<Long>) = apply {
+                this.cacheWriteTokens = cacheWriteTokens
+            }
+
             /** Cached tokens present in the prompt. */
             fun cachedTokens(cachedTokens: Long) = cachedTokens(JsonField.of(cachedTokens))
 
@@ -804,7 +843,12 @@ private constructor(
              * Further updates to this [Builder] will not mutate the returned instance.
              */
             fun build(): PromptTokensDetails =
-                PromptTokensDetails(audioTokens, cachedTokens, additionalProperties.toMutableMap())
+                PromptTokensDetails(
+                    audioTokens,
+                    cacheWriteTokens,
+                    cachedTokens,
+                    additionalProperties.toMutableMap(),
+                )
         }
 
         private var validated: Boolean = false
@@ -824,6 +868,7 @@ private constructor(
             }
 
             audioTokens()
+            cacheWriteTokens()
             cachedTokens()
             validated = true
         }
@@ -845,6 +890,7 @@ private constructor(
         @JvmSynthetic
         internal fun validity(): Int =
             (if (audioTokens.asKnown().isPresent) 1 else 0) +
+                (if (cacheWriteTokens.asKnown().isPresent) 1 else 0) +
                 (if (cachedTokens.asKnown().isPresent) 1 else 0)
 
         override fun equals(other: Any?): Boolean {
@@ -854,18 +900,19 @@ private constructor(
 
             return other is PromptTokensDetails &&
                 audioTokens == other.audioTokens &&
+                cacheWriteTokens == other.cacheWriteTokens &&
                 cachedTokens == other.cachedTokens &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(audioTokens, cachedTokens, additionalProperties)
+            Objects.hash(audioTokens, cacheWriteTokens, cachedTokens, additionalProperties)
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "PromptTokensDetails{audioTokens=$audioTokens, cachedTokens=$cachedTokens, additionalProperties=$additionalProperties}"
+            "PromptTokensDetails{audioTokens=$audioTokens, cacheWriteTokens=$cacheWriteTokens, cachedTokens=$cachedTokens, additionalProperties=$additionalProperties}"
     }
 
     override fun equals(other: Any?): Boolean {
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/conversations/ComputerScreenshotContent.kt b/openai-java-core/src/main/kotlin/com/openai/models/conversations/ComputerScreenshotContent.kt
index 3159c5a1b..b2092d334 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/conversations/ComputerScreenshotContent.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/conversations/ComputerScreenshotContent.kt
@@ -26,6 +26,7 @@ private constructor(
     private val fileId: JsonField<String>,
     private val imageUrl: JsonField<String>,
     private val type: JsonValue,
+    private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -35,7 +36,10 @@ private constructor(
         @JsonProperty("file_id") @ExcludeMissing fileId: JsonField<String> = JsonMissing.of(),
         @JsonProperty("image_url") @ExcludeMissing imageUrl: JsonField<String> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-    ) : this(detail, fileId, imageUrl, type, mutableMapOf())
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+    ) : this(detail, fileId, imageUrl, type, promptCacheBreakpoint, mutableMapOf())
 
     /**
      * The detail level of the screenshot image to be sent to the model. One of `high`, `low`,
@@ -76,6 +80,16 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+        promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
     /**
      * Returns the raw JSON value of [detail].
      *
@@ -97,6 +111,16 @@ private constructor(
      */
     @JsonProperty("image_url") @ExcludeMissing fun _imageUrl(): JsonField<String> = imageUrl
 
+    /**
+     * Returns the raw JSON value of [promptCacheBreakpoint].
+     *
+     * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_breakpoint")
+    @ExcludeMissing
+    fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -131,6 +155,7 @@ private constructor(
         private var fileId: JsonField<String>? = null
         private var imageUrl: JsonField<String>? = null
         private var type: JsonValue = JsonValue.from("computer_screenshot")
+        private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -139,6 +164,7 @@ private constructor(
             fileId = computerScreenshotContent.fileId
             imageUrl = computerScreenshotContent.imageUrl
             type = computerScreenshotContent.type
+            promptCacheBreakpoint = computerScreenshotContent.promptCacheBreakpoint
             additionalProperties = computerScreenshotContent.additionalProperties.toMutableMap()
         }
 
@@ -198,6 +224,24 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint) =
+            promptCacheBreakpoint(JsonField.of(promptCacheBreakpoint))
+
+        /**
+         * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+         * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) = apply {
+            this.promptCacheBreakpoint = promptCacheBreakpoint
+        }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -237,6 +281,7 @@ private constructor(
                 checkRequired("fileId", fileId),
                 checkRequired("imageUrl", imageUrl),
                 type,
+                promptCacheBreakpoint,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -264,6 +309,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        promptCacheBreakpoint().ifPresent { it.validate() }
         validated = true
     }
 
@@ -285,7 +331,8 @@ private constructor(
         (detail.asKnown().getOrNull()?.validity() ?: 0) +
             (if (fileId.asKnown().isPresent) 1 else 0) +
             (if (imageUrl.asKnown().isPresent) 1 else 0) +
-            type.let { if (it == JsonValue.from("computer_screenshot")) 1 else 0 }
+            type.let { if (it == JsonValue.from("computer_screenshot")) 1 else 0 } +
+            (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
 
     /**
      * The detail level of the screenshot image to be sent to the model. One of `high`, `low`,
@@ -437,6 +484,168 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     */
+    class PromptCacheBreakpoint
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+        ) : this(mode, mutableMapOf())
+
+        /**
+         * The breakpoint mode. Always `explicit`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("explicit")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheBreakpoint].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheBreakpoint]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonValue = JsonValue.from("explicit")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                mode = promptCacheBreakpoint.mode
+                additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheBreakpoint].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheBreakpoint =
+                PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheBreakpoint = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _mode().let {
+                if (it != JsonValue.from("explicit")) {
+                    throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheBreakpoint &&
+                mode == other.mode &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -447,15 +656,16 @@ private constructor(
             fileId == other.fileId &&
             imageUrl == other.imageUrl &&
             type == other.type &&
+            promptCacheBreakpoint == other.promptCacheBreakpoint &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(detail, fileId, imageUrl, type, additionalProperties)
+        Objects.hash(detail, fileId, imageUrl, type, promptCacheBreakpoint, additionalProperties)
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ComputerScreenshotContent{detail=$detail, fileId=$fileId, imageUrl=$imageUrl, type=$type, additionalProperties=$additionalProperties}"
+        "ComputerScreenshotContent{detail=$detail, fileId=$fileId, imageUrl=$imageUrl, type=$type, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/conversations/ConversationCreateParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/conversations/ConversationCreateParams.kt
index ecc6df5a7..b56e683b3 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/conversations/ConversationCreateParams.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/conversations/ConversationCreateParams.kt
@@ -382,6 +382,14 @@ private constructor(
          */
         fun addItemReferenceItem(id: String) = apply { body.addItemReferenceItem(id) }
 
+        /** Alias for calling [addItem] with `ResponseInputItem.ofProgram(program)`. */
+        fun addItem(program: ResponseInputItem.Program) = apply { body.addItem(program) }
+
+        /** Alias for calling [addItem] with `ResponseInputItem.ofProgramOutput(programOutput)`. */
+        fun addItem(programOutput: ResponseInputItem.ProgramOutput) = apply {
+            body.addItem(programOutput)
+        }
+
         /**
          * Set of 16 key-value pairs that can be attached to an object. This can be useful for
          * storing additional information about the object in a structured format, and querying for
@@ -909,6 +917,16 @@ private constructor(
                         .build()
                 )
 
+            /** Alias for calling [addItem] with `ResponseInputItem.ofProgram(program)`. */
+            fun addItem(program: ResponseInputItem.Program) =
+                addItem(ResponseInputItem.ofProgram(program))
+
+            /**
+             * Alias for calling [addItem] with `ResponseInputItem.ofProgramOutput(programOutput)`.
+             */
+            fun addItem(programOutput: ResponseInputItem.ProgramOutput) =
+                addItem(ResponseInputItem.ofProgramOutput(programOutput))
+
             /**
              * Set of 16 key-value pairs that can be attached to an object. This can be useful for
              * storing additional information about the object in a structured format, and querying
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/conversations/items/ConversationItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/conversations/items/ConversationItem.kt
index 7bd1647db..c8bbb031d 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/conversations/items/ConversationItem.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/conversations/items/ConversationItem.kt
@@ -81,6 +81,8 @@ private constructor(
     private val toolSearchOutput: ResponseToolSearchOutputItem? = null,
     private val additionalTools: AdditionalTools? = null,
     private val reasoning: ResponseReasoningItem? = null,
+    private val program: Program? = null,
+    private val programOutput: ProgramOutput? = null,
     private val compaction: ResponseCompactionItem? = null,
     private val codeInterpreterCall: ResponseCodeInterpreterToolCall? = null,
     private val localShellCall: LocalShellCall? = null,
@@ -154,6 +156,10 @@ private constructor(
      */
     fun reasoning(): Optional<ResponseReasoningItem> = Optional.ofNullable(reasoning)
 
+    fun program(): Optional<Program> = Optional.ofNullable(program)
+
+    fun programOutput(): Optional<ProgramOutput> = Optional.ofNullable(programOutput)
+
     /**
      * A compaction item generated by the
      * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
@@ -229,6 +235,10 @@ private constructor(
 
     fun isReasoning(): Boolean = reasoning != null
 
+    fun isProgram(): Boolean = program != null
+
+    fun isProgramOutput(): Boolean = programOutput != null
+
     fun isCompaction(): Boolean = compaction != null
 
     fun isCodeInterpreterCall(): Boolean = codeInterpreterCall != null
@@ -313,6 +323,10 @@ private constructor(
      */
     fun asReasoning(): ResponseReasoningItem = reasoning.getOrThrow("reasoning")
 
+    fun asProgram(): Program = program.getOrThrow("program")
+
+    fun asProgramOutput(): ProgramOutput = programOutput.getOrThrow("programOutput")
+
     /**
      * A compaction item generated by the
      * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
@@ -410,6 +424,8 @@ private constructor(
             toolSearchOutput != null -> visitor.visitToolSearchOutput(toolSearchOutput)
             additionalTools != null -> visitor.visitAdditionalTools(additionalTools)
             reasoning != null -> visitor.visitReasoning(reasoning)
+            program != null -> visitor.visitProgram(program)
+            programOutput != null -> visitor.visitProgramOutput(programOutput)
             compaction != null -> visitor.visitCompaction(compaction)
             codeInterpreterCall != null -> visitor.visitCodeInterpreterCall(codeInterpreterCall)
             localShellCall != null -> visitor.visitLocalShellCall(localShellCall)
@@ -496,6 +512,14 @@ private constructor(
                     reasoning.validate()
                 }
 
+                override fun visitProgram(program: Program) {
+                    program.validate()
+                }
+
+                override fun visitProgramOutput(programOutput: ProgramOutput) {
+                    programOutput.validate()
+                }
+
                 override fun visitCompaction(compaction: ResponseCompactionItem) {
                     compaction.validate()
                 }
@@ -617,6 +641,11 @@ private constructor(
 
                 override fun visitReasoning(reasoning: ResponseReasoningItem) = reasoning.validity()
 
+                override fun visitProgram(program: Program) = program.validity()
+
+                override fun visitProgramOutput(programOutput: ProgramOutput) =
+                    programOutput.validity()
+
                 override fun visitCompaction(compaction: ResponseCompactionItem) =
                     compaction.validity()
 
@@ -683,6 +712,8 @@ private constructor(
             toolSearchOutput == other.toolSearchOutput &&
             additionalTools == other.additionalTools &&
             reasoning == other.reasoning &&
+            program == other.program &&
+            programOutput == other.programOutput &&
             compaction == other.compaction &&
             codeInterpreterCall == other.codeInterpreterCall &&
             localShellCall == other.localShellCall &&
@@ -713,6 +744,8 @@ private constructor(
             toolSearchOutput,
             additionalTools,
             reasoning,
+            program,
+            programOutput,
             compaction,
             codeInterpreterCall,
             localShellCall,
@@ -744,6 +777,8 @@ private constructor(
             toolSearchOutput != null -> "ConversationItem{toolSearchOutput=$toolSearchOutput}"
             additionalTools != null -> "ConversationItem{additionalTools=$additionalTools}"
             reasoning != null -> "ConversationItem{reasoning=$reasoning}"
+            program != null -> "ConversationItem{program=$program}"
+            programOutput != null -> "ConversationItem{programOutput=$programOutput}"
             compaction != null -> "ConversationItem{compaction=$compaction}"
             codeInterpreterCall != null ->
                 "ConversationItem{codeInterpreterCall=$codeInterpreterCall}"
@@ -842,6 +877,12 @@ private constructor(
         @JvmStatic
         fun ofReasoning(reasoning: ResponseReasoningItem) = ConversationItem(reasoning = reasoning)
 
+        @JvmStatic fun ofProgram(program: Program) = ConversationItem(program = program)
+
+        @JvmStatic
+        fun ofProgramOutput(programOutput: ProgramOutput) =
+            ConversationItem(programOutput = programOutput)
+
         /**
          * A compaction item generated by the
          * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
@@ -972,6 +1013,10 @@ private constructor(
          */
         fun visitReasoning(reasoning: ResponseReasoningItem): T
 
+        fun visitProgram(program: Program): T
+
+        fun visitProgramOutput(programOutput: ProgramOutput): T
+
         /**
          * A compaction item generated by the
          * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
@@ -1105,6 +1150,16 @@ private constructor(
                         ConversationItem(reasoning = it, _json = json)
                     } ?: ConversationItem(_json = json)
                 }
+                "program" -> {
+                    return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                        ConversationItem(program = it, _json = json)
+                    } ?: ConversationItem(_json = json)
+                }
+                "program_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ProgramOutput>())?.let {
+                        ConversationItem(programOutput = it, _json = json)
+                    } ?: ConversationItem(_json = json)
+                }
                 "compaction" -> {
                     return tryDeserialize(node, jacksonTypeRef<ResponseCompactionItem>())?.let {
                         ConversationItem(compaction = it, _json = json)
@@ -1205,6 +1260,8 @@ private constructor(
                 value.toolSearchOutput != null -> generator.writeObject(value.toolSearchOutput)
                 value.additionalTools != null -> generator.writeObject(value.additionalTools)
                 value.reasoning != null -> generator.writeObject(value.reasoning)
+                value.program != null -> generator.writeObject(value.program)
+                value.programOutput != null -> generator.writeObject(value.programOutput)
                 value.compaction != null -> generator.writeObject(value.compaction)
                 value.codeInterpreterCall != null ->
                     generator.writeObject(value.codeInterpreterCall)
@@ -1918,6 +1975,9 @@ private constructor(
                     )
                 )
 
+            /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+            fun addToolProgrammaticToolCalling() = addTool(Tool.ofProgrammaticToolCalling())
+
             /** Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`. */
             fun addTool(imageGeneration: Tool.ImageGeneration) =
                 addTool(Tool.ofImageGeneration(imageGeneration))
@@ -2256,6 +2316,796 @@ private constructor(
             "AdditionalTools{id=$id, role=$role, tools=$tools, type=$type, additionalProperties=$additionalProperties}"
     }
 
+    class Program
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val callId: JsonField<String>,
+        private val code: JsonField<String>,
+        private val fingerprint: JsonField<String>,
+        private val type: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("code") @ExcludeMissing code: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("fingerprint")
+            @ExcludeMissing
+            fingerprint: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(id, callId, code, fingerprint, type, mutableMapOf())
+
+        /**
+         * The unique ID of the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The stable call ID of the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The JavaScript source executed by programmatic tool calling.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun code(): String = code.getRequired("code")
+
+        /**
+         * Opaque program replay fingerprint that must be round-tripped.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun fingerprint(): String = fingerprint.getRequired("fingerprint")
+
+        /**
+         * The type of the item. Always `program`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("program")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [code].
+         *
+         * Unlike [code], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<String> = code
+
+        /**
+         * Returns the raw JSON value of [fingerprint].
+         *
+         * Unlike [fingerprint], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("fingerprint")
+        @ExcludeMissing
+        fun _fingerprint(): JsonField<String> = fingerprint
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Program].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .code()
+             * .fingerprint()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Program]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var callId: JsonField<String>? = null
+            private var code: JsonField<String>? = null
+            private var fingerprint: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("program")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(program: Program) = apply {
+                id = program.id
+                callId = program.callId
+                code = program.code
+                fingerprint = program.fingerprint
+                type = program.type
+                additionalProperties = program.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the program item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The stable call ID of the program item. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The JavaScript source executed by programmatic tool calling. */
+            fun code(code: String) = code(JsonField.of(code))
+
+            /**
+             * Sets [Builder.code] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.code] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun code(code: JsonField<String>) = apply { this.code = code }
+
+            /** Opaque program replay fingerprint that must be round-tripped. */
+            fun fingerprint(fingerprint: String) = fingerprint(JsonField.of(fingerprint))
+
+            /**
+             * Sets [Builder.fingerprint] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.fingerprint] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun fingerprint(fingerprint: JsonField<String>) = apply {
+                this.fingerprint = fingerprint
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Program].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .code()
+             * .fingerprint()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Program =
+                Program(
+                    checkRequired("id", id),
+                    checkRequired("callId", callId),
+                    checkRequired("code", code),
+                    checkRequired("fingerprint", fingerprint),
+                    type,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Program = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            callId()
+            code()
+            fingerprint()
+            _type().let {
+                if (it != JsonValue.from("program")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (if (code.asKnown().isPresent) 1 else 0) +
+                (if (fingerprint.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Program &&
+                id == other.id &&
+                callId == other.callId &&
+                code == other.code &&
+                fingerprint == other.fingerprint &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, callId, code, fingerprint, type, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Program{id=$id, callId=$callId, code=$code, fingerprint=$fingerprint, type=$type, additionalProperties=$additionalProperties}"
+    }
+
+    class ProgramOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val callId: JsonField<String>,
+        private val result: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("result") @ExcludeMissing result: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(id, callId, result, status, type, mutableMapOf())
+
+        /**
+         * The unique ID of the program output item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The call ID of the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The result produced by the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun result(): String = result.getRequired("result")
+
+        /**
+         * The terminal status of the program output item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The type of the item. Always `program_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("program_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [result].
+         *
+         * Unlike [result], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("result") @ExcludeMissing fun _result(): JsonField<String> = result
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ProgramOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .result()
+             * .status()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ProgramOutput]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var callId: JsonField<String>? = null
+            private var result: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("program_output")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(programOutput: ProgramOutput) = apply {
+                id = programOutput.id
+                callId = programOutput.callId
+                result = programOutput.result
+                status = programOutput.status
+                type = programOutput.type
+                additionalProperties = programOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the program output item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The call ID of the program item. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The result produced by the program item. */
+            fun result(result: String) = result(JsonField.of(result))
+
+            /**
+             * Sets [Builder.result] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.result] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun result(result: JsonField<String>) = apply { this.result = result }
+
+            /** The terminal status of the program output item. */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("program_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ProgramOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .result()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ProgramOutput =
+                ProgramOutput(
+                    checkRequired("id", id),
+                    checkRequired("callId", callId),
+                    checkRequired("result", result),
+                    checkRequired("status", status),
+                    type,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ProgramOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            callId()
+            result()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("program_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (if (result.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("program_output")) 1 else 0 }
+
+        /** The terminal status of the program output item. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ProgramOutput &&
+                id == other.id &&
+                callId == other.callId &&
+                result == other.result &&
+                status == other.status &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, callId, result, status, type, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ProgramOutput{id=$id, callId=$callId, result=$result, status=$status, type=$type, additionalProperties=$additionalProperties}"
+    }
+
     /** A tool call to run a command on the local shell. */
     class LocalShellCall
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/conversations/items/ConversationItemList.kt b/openai-java-core/src/main/kotlin/com/openai/models/conversations/items/ConversationItemList.kt
index 88d2499fb..c476e6259 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/conversations/items/ConversationItemList.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/conversations/items/ConversationItemList.kt
@@ -266,6 +266,14 @@ private constructor(
         fun addData(reasoning: ResponseReasoningItem) =
             addData(ConversationItem.ofReasoning(reasoning))
 
+        /** Alias for calling [addData] with `ConversationItem.ofProgram(program)`. */
+        fun addData(program: ConversationItem.Program) =
+            addData(ConversationItem.ofProgram(program))
+
+        /** Alias for calling [addData] with `ConversationItem.ofProgramOutput(programOutput)`. */
+        fun addData(programOutput: ConversationItem.ProgramOutput) =
+            addData(ConversationItem.ofProgramOutput(programOutput))
+
         /** Alias for calling [addData] with `ConversationItem.ofCompaction(compaction)`. */
         fun addData(compaction: ResponseCompactionItem) =
             addData(ConversationItem.ofCompaction(compaction))
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/conversations/items/ItemCreateParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/conversations/items/ItemCreateParams.kt
index 0badfaf81..bcaa7a015 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/conversations/items/ItemCreateParams.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/conversations/items/ItemCreateParams.kt
@@ -404,6 +404,14 @@ private constructor(
          */
         fun addItemReferenceItem(id: String) = apply { body.addItemReferenceItem(id) }
 
+        /** Alias for calling [addItem] with `ResponseInputItem.ofProgram(program)`. */
+        fun addItem(program: ResponseInputItem.Program) = apply { body.addItem(program) }
+
+        /** Alias for calling [addItem] with `ResponseInputItem.ofProgramOutput(programOutput)`. */
+        fun addItem(programOutput: ResponseInputItem.ProgramOutput) = apply {
+            body.addItem(programOutput)
+        }
+
         fun additionalBodyProperties(additionalBodyProperties: Map<String, JsonValue>) = apply {
             body.additionalProperties(additionalBodyProperties)
         }
@@ -904,6 +912,16 @@ private constructor(
                         .build()
                 )
 
+            /** Alias for calling [addItem] with `ResponseInputItem.ofProgram(program)`. */
+            fun addItem(program: ResponseInputItem.Program) =
+                addItem(ResponseInputItem.ofProgram(program))
+
+            /**
+             * Alias for calling [addItem] with `ResponseInputItem.ofProgramOutput(programOutput)`.
+             */
+            fun addItem(programOutput: ResponseInputItem.ProgramOutput) =
+                addItem(ResponseInputItem.ofProgramOutput(programOutput))
+
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
                 putAllAdditionalProperties(additionalProperties)
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/CreateEvalCompletionsRunDataSource.kt b/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/CreateEvalCompletionsRunDataSource.kt
index 1af34990e..c702a792e 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/CreateEvalCompletionsRunDataSource.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/CreateEvalCompletionsRunDataSource.kt
@@ -4772,18 +4772,12 @@ private constructor(
             maxCompletionTokens.getOptional("max_completion_tokens")
 
         /**
-         * Constrains effort on reasoning for
-         * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-         * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing
-         * reasoning effort can result in faster responses and fewer tokens used on reasoning in a
-         * response.
-         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
-         *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported
-         *   for all reasoning values in gpt-5.1.
-         * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support
-         *   `none`.
-         * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-         * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -4962,18 +4956,12 @@ private constructor(
             }
 
             /**
-             * Constrains effort on reasoning for
-             * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-             * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-             * Reducing reasoning effort can result in faster responses and fewer tokens used on
-             * reasoning in a response.
-             * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-             *   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls
-             *   are supported for all reasoning values in gpt-5.1.
-             * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-             *   support `none`.
-             * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-             * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+             * Constrains effort on reasoning for reasoning models. Currently supported values are
+             * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning
+             * effort can result in faster responses and fewer tokens used on reasoning in a
+             * response. Not all reasoning models support every value. See the
+             * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+             * model-specific support.
              */
             fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                 reasoningEffort(JsonField.ofNullable(reasoningEffort))
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunCancelResponse.kt b/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunCancelResponse.kt
index 85165ccb7..f94938799 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunCancelResponse.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunCancelResponse.kt
@@ -2889,19 +2889,13 @@ private constructor(
                     fun model(): Optional<String> = model.getOptional("model")
 
                     /**
-                     * Constrains effort on reasoning for
-                     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
-                     * Currently supported values are `none`, `minimal`, `low`, `medium`, `high`,
-                     * and `xhigh`. Reducing reasoning effort can result in faster responses and
-                     * fewer tokens used on reasoning in a response.
-                     * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The
-                     *   supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and
-                     *   `high`. Tool calls are supported for all reasoning values in gpt-5.1.
-                     * - All models before `gpt-5.1` default to `medium` reasoning effort, and do
-                     *   not support `none`.
-                     * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning
-                     *   effort.
-                     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                     * Constrains effort on reasoning for reasoning models. Currently supported
+                     * values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`.
+                     * Reducing reasoning effort can result in faster responses and fewer tokens
+                     * used on reasoning in a response. Not all reasoning models support every
+                     * value. See the
+                     * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                     * model-specific support.
                      *
                      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
                      *   (e.g. if the server responded with an unexpected value).
@@ -3212,20 +3206,13 @@ private constructor(
                         fun model(model: JsonField<String>) = apply { this.model = model }
 
                         /**
-                         * Constrains effort on reasoning for
-                         * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
-                         * Currently supported values are `none`, `minimal`, `low`, `medium`,
-                         * `high`, and `xhigh`. Reducing reasoning effort can result in faster
-                         * responses and fewer tokens used on reasoning in a response.
-                         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The
-                         *   supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`,
-                         *   and `high`. Tool calls are supported for all reasoning values in
-                         *   gpt-5.1.
-                         * - All models before `gpt-5.1` default to `medium` reasoning effort, and
-                         *   do not support `none`.
-                         * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning
-                         *   effort.
-                         * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                         * Constrains effort on reasoning for reasoning models. Currently supported
+                         * values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and
+                         * `max`. Reducing reasoning effort can result in faster responses and fewer
+                         * tokens used on reasoning in a response. Not all reasoning models support
+                         * every value. See the
+                         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                         * model-specific support.
                          */
                         fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                             reasoningEffort(JsonField.ofNullable(reasoningEffort))
@@ -6408,18 +6395,12 @@ private constructor(
                     maxCompletionTokens.getOptional("max_completion_tokens")
 
                 /**
-                 * Constrains effort on reasoning for
-                 * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-                 * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-                 * Reducing reasoning effort can result in faster responses and fewer tokens used on
-                 * reasoning in a response.
-                 * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-                 *   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-                 *   calls are supported for all reasoning values in gpt-5.1.
-                 * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-                 *   support `none`.
-                 * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-                 * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                 * Constrains effort on reasoning for reasoning models. Currently supported values
+                 * are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+                 * reasoning effort can result in faster responses and fewer tokens used on
+                 * reasoning in a response. Not all reasoning models support every value. See the
+                 * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                 * model-specific support.
                  *
                  * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
                  *   if the server responded with an unexpected value).
@@ -6604,19 +6585,13 @@ private constructor(
                     }
 
                     /**
-                     * Constrains effort on reasoning for
-                     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
-                     * Currently supported values are `none`, `minimal`, `low`, `medium`, `high`,
-                     * and `xhigh`. Reducing reasoning effort can result in faster responses and
-                     * fewer tokens used on reasoning in a response.
-                     * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The
-                     *   supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and
-                     *   `high`. Tool calls are supported for all reasoning values in gpt-5.1.
-                     * - All models before `gpt-5.1` default to `medium` reasoning effort, and do
-                     *   not support `none`.
-                     * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning
-                     *   effort.
-                     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                     * Constrains effort on reasoning for reasoning models. Currently supported
+                     * values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`.
+                     * Reducing reasoning effort can result in faster responses and fewer tokens
+                     * used on reasoning in a response. Not all reasoning models support every
+                     * value. See the
+                     * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                     * model-specific support.
                      */
                     fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                         reasoningEffort(JsonField.ofNullable(reasoningEffort))
@@ -6805,6 +6780,9 @@ private constructor(
                             )
                         )
 
+                    /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+                    fun addToolProgrammaticToolCalling() = addTool(Tool.ofProgrammaticToolCalling())
+
                     /**
                      * Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`.
                      */
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunCreateParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunCreateParams.kt
index 8a30d2adb..adb3051ff 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunCreateParams.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunCreateParams.kt
@@ -2652,19 +2652,13 @@ private constructor(
                     fun model(): Optional<String> = model.getOptional("model")
 
                     /**
-                     * Constrains effort on reasoning for
-                     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
-                     * Currently supported values are `none`, `minimal`, `low`, `medium`, `high`,
-                     * and `xhigh`. Reducing reasoning effort can result in faster responses and
-                     * fewer tokens used on reasoning in a response.
-                     * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The
-                     *   supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and
-                     *   `high`. Tool calls are supported for all reasoning values in gpt-5.1.
-                     * - All models before `gpt-5.1` default to `medium` reasoning effort, and do
-                     *   not support `none`.
-                     * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning
-                     *   effort.
-                     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                     * Constrains effort on reasoning for reasoning models. Currently supported
+                     * values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`.
+                     * Reducing reasoning effort can result in faster responses and fewer tokens
+                     * used on reasoning in a response. Not all reasoning models support every
+                     * value. See the
+                     * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                     * model-specific support.
                      *
                      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
                      *   (e.g. if the server responded with an unexpected value).
@@ -2973,20 +2967,13 @@ private constructor(
                         fun model(model: JsonField<String>) = apply { this.model = model }
 
                         /**
-                         * Constrains effort on reasoning for
-                         * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
-                         * Currently supported values are `none`, `minimal`, `low`, `medium`,
-                         * `high`, and `xhigh`. Reducing reasoning effort can result in faster
-                         * responses and fewer tokens used on reasoning in a response.
-                         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The
-                         *   supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`,
-                         *   and `high`. Tool calls are supported for all reasoning values in
-                         *   gpt-5.1.
-                         * - All models before `gpt-5.1` default to `medium` reasoning effort, and
-                         *   do not support `none`.
-                         * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning
-                         *   effort.
-                         * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                         * Constrains effort on reasoning for reasoning models. Currently supported
+                         * values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and
+                         * `max`. Reducing reasoning effort can result in faster responses and fewer
+                         * tokens used on reasoning in a response. Not all reasoning models support
+                         * every value. See the
+                         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                         * model-specific support.
                          */
                         fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                             reasoningEffort(JsonField.ofNullable(reasoningEffort))
@@ -6304,18 +6291,12 @@ private constructor(
                     maxCompletionTokens.getOptional("max_completion_tokens")
 
                 /**
-                 * Constrains effort on reasoning for
-                 * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-                 * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-                 * Reducing reasoning effort can result in faster responses and fewer tokens used on
-                 * reasoning in a response.
-                 * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-                 *   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-                 *   calls are supported for all reasoning values in gpt-5.1.
-                 * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-                 *   support `none`.
-                 * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-                 * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                 * Constrains effort on reasoning for reasoning models. Currently supported values
+                 * are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+                 * reasoning effort can result in faster responses and fewer tokens used on
+                 * reasoning in a response. Not all reasoning models support every value. See the
+                 * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                 * model-specific support.
                  *
                  * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
                  *   if the server responded with an unexpected value).
@@ -6500,19 +6481,13 @@ private constructor(
                     }
 
                     /**
-                     * Constrains effort on reasoning for
-                     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
-                     * Currently supported values are `none`, `minimal`, `low`, `medium`, `high`,
-                     * and `xhigh`. Reducing reasoning effort can result in faster responses and
-                     * fewer tokens used on reasoning in a response.
-                     * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The
-                     *   supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and
-                     *   `high`. Tool calls are supported for all reasoning values in gpt-5.1.
-                     * - All models before `gpt-5.1` default to `medium` reasoning effort, and do
-                     *   not support `none`.
-                     * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning
-                     *   effort.
-                     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                     * Constrains effort on reasoning for reasoning models. Currently supported
+                     * values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`.
+                     * Reducing reasoning effort can result in faster responses and fewer tokens
+                     * used on reasoning in a response. Not all reasoning models support every
+                     * value. See the
+                     * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                     * model-specific support.
                      */
                     fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                         reasoningEffort(JsonField.ofNullable(reasoningEffort))
@@ -6701,6 +6676,9 @@ private constructor(
                             )
                         )
 
+                    /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+                    fun addToolProgrammaticToolCalling() = addTool(Tool.ofProgrammaticToolCalling())
+
                     /**
                      * Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`.
                      */
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunCreateResponse.kt b/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunCreateResponse.kt
index 175106920..81c3e932f 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunCreateResponse.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunCreateResponse.kt
@@ -2889,19 +2889,13 @@ private constructor(
                     fun model(): Optional<String> = model.getOptional("model")
 
                     /**
-                     * Constrains effort on reasoning for
-                     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
-                     * Currently supported values are `none`, `minimal`, `low`, `medium`, `high`,
-                     * and `xhigh`. Reducing reasoning effort can result in faster responses and
-                     * fewer tokens used on reasoning in a response.
-                     * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The
-                     *   supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and
-                     *   `high`. Tool calls are supported for all reasoning values in gpt-5.1.
-                     * - All models before `gpt-5.1` default to `medium` reasoning effort, and do
-                     *   not support `none`.
-                     * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning
-                     *   effort.
-                     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                     * Constrains effort on reasoning for reasoning models. Currently supported
+                     * values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`.
+                     * Reducing reasoning effort can result in faster responses and fewer tokens
+                     * used on reasoning in a response. Not all reasoning models support every
+                     * value. See the
+                     * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                     * model-specific support.
                      *
                      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
                      *   (e.g. if the server responded with an unexpected value).
@@ -3212,20 +3206,13 @@ private constructor(
                         fun model(model: JsonField<String>) = apply { this.model = model }
 
                         /**
-                         * Constrains effort on reasoning for
-                         * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
-                         * Currently supported values are `none`, `minimal`, `low`, `medium`,
-                         * `high`, and `xhigh`. Reducing reasoning effort can result in faster
-                         * responses and fewer tokens used on reasoning in a response.
-                         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The
-                         *   supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`,
-                         *   and `high`. Tool calls are supported for all reasoning values in
-                         *   gpt-5.1.
-                         * - All models before `gpt-5.1` default to `medium` reasoning effort, and
-                         *   do not support `none`.
-                         * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning
-                         *   effort.
-                         * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                         * Constrains effort on reasoning for reasoning models. Currently supported
+                         * values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and
+                         * `max`. Reducing reasoning effort can result in faster responses and fewer
+                         * tokens used on reasoning in a response. Not all reasoning models support
+                         * every value. See the
+                         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                         * model-specific support.
                          */
                         fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                             reasoningEffort(JsonField.ofNullable(reasoningEffort))
@@ -6408,18 +6395,12 @@ private constructor(
                     maxCompletionTokens.getOptional("max_completion_tokens")
 
                 /**
-                 * Constrains effort on reasoning for
-                 * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-                 * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-                 * Reducing reasoning effort can result in faster responses and fewer tokens used on
-                 * reasoning in a response.
-                 * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-                 *   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-                 *   calls are supported for all reasoning values in gpt-5.1.
-                 * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-                 *   support `none`.
-                 * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-                 * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                 * Constrains effort on reasoning for reasoning models. Currently supported values
+                 * are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+                 * reasoning effort can result in faster responses and fewer tokens used on
+                 * reasoning in a response. Not all reasoning models support every value. See the
+                 * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                 * model-specific support.
                  *
                  * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
                  *   if the server responded with an unexpected value).
@@ -6604,19 +6585,13 @@ private constructor(
                     }
 
                     /**
-                     * Constrains effort on reasoning for
-                     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
-                     * Currently supported values are `none`, `minimal`, `low`, `medium`, `high`,
-                     * and `xhigh`. Reducing reasoning effort can result in faster responses and
-                     * fewer tokens used on reasoning in a response.
-                     * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The
-                     *   supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and
-                     *   `high`. Tool calls are supported for all reasoning values in gpt-5.1.
-                     * - All models before `gpt-5.1` default to `medium` reasoning effort, and do
-                     *   not support `none`.
-                     * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning
-                     *   effort.
-                     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                     * Constrains effort on reasoning for reasoning models. Currently supported
+                     * values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`.
+                     * Reducing reasoning effort can result in faster responses and fewer tokens
+                     * used on reasoning in a response. Not all reasoning models support every
+                     * value. See the
+                     * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                     * model-specific support.
                      */
                     fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                         reasoningEffort(JsonField.ofNullable(reasoningEffort))
@@ -6805,6 +6780,9 @@ private constructor(
                             )
                         )
 
+                    /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+                    fun addToolProgrammaticToolCalling() = addTool(Tool.ofProgrammaticToolCalling())
+
                     /**
                      * Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`.
                      */
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunListResponse.kt b/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunListResponse.kt
index 11c9a0a4c..f2a3e3f67 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunListResponse.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunListResponse.kt
@@ -2889,19 +2889,13 @@ private constructor(
                     fun model(): Optional<String> = model.getOptional("model")
 
                     /**
-                     * Constrains effort on reasoning for
-                     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
-                     * Currently supported values are `none`, `minimal`, `low`, `medium`, `high`,
-                     * and `xhigh`. Reducing reasoning effort can result in faster responses and
-                     * fewer tokens used on reasoning in a response.
-                     * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The
-                     *   supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and
-                     *   `high`. Tool calls are supported for all reasoning values in gpt-5.1.
-                     * - All models before `gpt-5.1` default to `medium` reasoning effort, and do
-                     *   not support `none`.
-                     * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning
-                     *   effort.
-                     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                     * Constrains effort on reasoning for reasoning models. Currently supported
+                     * values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`.
+                     * Reducing reasoning effort can result in faster responses and fewer tokens
+                     * used on reasoning in a response. Not all reasoning models support every
+                     * value. See the
+                     * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                     * model-specific support.
                      *
                      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
                      *   (e.g. if the server responded with an unexpected value).
@@ -3212,20 +3206,13 @@ private constructor(
                         fun model(model: JsonField<String>) = apply { this.model = model }
 
                         /**
-                         * Constrains effort on reasoning for
-                         * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
-                         * Currently supported values are `none`, `minimal`, `low`, `medium`,
-                         * `high`, and `xhigh`. Reducing reasoning effort can result in faster
-                         * responses and fewer tokens used on reasoning in a response.
-                         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The
-                         *   supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`,
-                         *   and `high`. Tool calls are supported for all reasoning values in
-                         *   gpt-5.1.
-                         * - All models before `gpt-5.1` default to `medium` reasoning effort, and
-                         *   do not support `none`.
-                         * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning
-                         *   effort.
-                         * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                         * Constrains effort on reasoning for reasoning models. Currently supported
+                         * values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and
+                         * `max`. Reducing reasoning effort can result in faster responses and fewer
+                         * tokens used on reasoning in a response. Not all reasoning models support
+                         * every value. See the
+                         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                         * model-specific support.
                          */
                         fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                             reasoningEffort(JsonField.ofNullable(reasoningEffort))
@@ -6408,18 +6395,12 @@ private constructor(
                     maxCompletionTokens.getOptional("max_completion_tokens")
 
                 /**
-                 * Constrains effort on reasoning for
-                 * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-                 * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-                 * Reducing reasoning effort can result in faster responses and fewer tokens used on
-                 * reasoning in a response.
-                 * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-                 *   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-                 *   calls are supported for all reasoning values in gpt-5.1.
-                 * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-                 *   support `none`.
-                 * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-                 * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                 * Constrains effort on reasoning for reasoning models. Currently supported values
+                 * are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+                 * reasoning effort can result in faster responses and fewer tokens used on
+                 * reasoning in a response. Not all reasoning models support every value. See the
+                 * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                 * model-specific support.
                  *
                  * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
                  *   if the server responded with an unexpected value).
@@ -6604,19 +6585,13 @@ private constructor(
                     }
 
                     /**
-                     * Constrains effort on reasoning for
-                     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
-                     * Currently supported values are `none`, `minimal`, `low`, `medium`, `high`,
-                     * and `xhigh`. Reducing reasoning effort can result in faster responses and
-                     * fewer tokens used on reasoning in a response.
-                     * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The
-                     *   supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and
-                     *   `high`. Tool calls are supported for all reasoning values in gpt-5.1.
-                     * - All models before `gpt-5.1` default to `medium` reasoning effort, and do
-                     *   not support `none`.
-                     * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning
-                     *   effort.
-                     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                     * Constrains effort on reasoning for reasoning models. Currently supported
+                     * values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`.
+                     * Reducing reasoning effort can result in faster responses and fewer tokens
+                     * used on reasoning in a response. Not all reasoning models support every
+                     * value. See the
+                     * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                     * model-specific support.
                      */
                     fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                         reasoningEffort(JsonField.ofNullable(reasoningEffort))
@@ -6805,6 +6780,9 @@ private constructor(
                             )
                         )
 
+                    /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+                    fun addToolProgrammaticToolCalling() = addTool(Tool.ofProgrammaticToolCalling())
+
                     /**
                      * Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`.
                      */
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunRetrieveResponse.kt b/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunRetrieveResponse.kt
index e2d659fce..d06db9a26 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunRetrieveResponse.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/evals/runs/RunRetrieveResponse.kt
@@ -2889,19 +2889,13 @@ private constructor(
                     fun model(): Optional<String> = model.getOptional("model")
 
                     /**
-                     * Constrains effort on reasoning for
-                     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
-                     * Currently supported values are `none`, `minimal`, `low`, `medium`, `high`,
-                     * and `xhigh`. Reducing reasoning effort can result in faster responses and
-                     * fewer tokens used on reasoning in a response.
-                     * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The
-                     *   supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and
-                     *   `high`. Tool calls are supported for all reasoning values in gpt-5.1.
-                     * - All models before `gpt-5.1` default to `medium` reasoning effort, and do
-                     *   not support `none`.
-                     * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning
-                     *   effort.
-                     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                     * Constrains effort on reasoning for reasoning models. Currently supported
+                     * values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`.
+                     * Reducing reasoning effort can result in faster responses and fewer tokens
+                     * used on reasoning in a response. Not all reasoning models support every
+                     * value. See the
+                     * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                     * model-specific support.
                      *
                      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type
                      *   (e.g. if the server responded with an unexpected value).
@@ -3212,20 +3206,13 @@ private constructor(
                         fun model(model: JsonField<String>) = apply { this.model = model }
 
                         /**
-                         * Constrains effort on reasoning for
-                         * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
-                         * Currently supported values are `none`, `minimal`, `low`, `medium`,
-                         * `high`, and `xhigh`. Reducing reasoning effort can result in faster
-                         * responses and fewer tokens used on reasoning in a response.
-                         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The
-                         *   supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`,
-                         *   and `high`. Tool calls are supported for all reasoning values in
-                         *   gpt-5.1.
-                         * - All models before `gpt-5.1` default to `medium` reasoning effort, and
-                         *   do not support `none`.
-                         * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning
-                         *   effort.
-                         * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                         * Constrains effort on reasoning for reasoning models. Currently supported
+                         * values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and
+                         * `max`. Reducing reasoning effort can result in faster responses and fewer
+                         * tokens used on reasoning in a response. Not all reasoning models support
+                         * every value. See the
+                         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                         * model-specific support.
                          */
                         fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                             reasoningEffort(JsonField.ofNullable(reasoningEffort))
@@ -6408,18 +6395,12 @@ private constructor(
                     maxCompletionTokens.getOptional("max_completion_tokens")
 
                 /**
-                 * Constrains effort on reasoning for
-                 * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-                 * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-                 * Reducing reasoning effort can result in faster responses and fewer tokens used on
-                 * reasoning in a response.
-                 * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-                 *   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool
-                 *   calls are supported for all reasoning values in gpt-5.1.
-                 * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-                 *   support `none`.
-                 * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-                 * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                 * Constrains effort on reasoning for reasoning models. Currently supported values
+                 * are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing
+                 * reasoning effort can result in faster responses and fewer tokens used on
+                 * reasoning in a response. Not all reasoning models support every value. See the
+                 * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                 * model-specific support.
                  *
                  * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g.
                  *   if the server responded with an unexpected value).
@@ -6604,19 +6585,13 @@ private constructor(
                     }
 
                     /**
-                     * Constrains effort on reasoning for
-                     * [reasoning models](https://platform.openai.com/docs/guides/reasoning).
-                     * Currently supported values are `none`, `minimal`, `low`, `medium`, `high`,
-                     * and `xhigh`. Reducing reasoning effort can result in faster responses and
-                     * fewer tokens used on reasoning in a response.
-                     * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The
-                     *   supported reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and
-                     *   `high`. Tool calls are supported for all reasoning values in gpt-5.1.
-                     * - All models before `gpt-5.1` default to `medium` reasoning effort, and do
-                     *   not support `none`.
-                     * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning
-                     *   effort.
-                     * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+                     * Constrains effort on reasoning for reasoning models. Currently supported
+                     * values are `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`.
+                     * Reducing reasoning effort can result in faster responses and fewer tokens
+                     * used on reasoning in a response. Not all reasoning models support every
+                     * value. See the
+                     * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+                     * model-specific support.
                      */
                     fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                         reasoningEffort(JsonField.ofNullable(reasoningEffort))
@@ -6805,6 +6780,9 @@ private constructor(
                             )
                         )
 
+                    /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+                    fun addToolProgrammaticToolCalling() = addTool(Tool.ofProgrammaticToolCalling())
+
                     /**
                      * Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`.
                      */
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/graders/gradermodels/ScoreModelGrader.kt b/openai-java-core/src/main/kotlin/com/openai/models/graders/gradermodels/ScoreModelGrader.kt
index 8fb6c2a95..75ec72e55 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/graders/gradermodels/ScoreModelGrader.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/graders/gradermodels/ScoreModelGrader.kt
@@ -1861,18 +1861,12 @@ private constructor(
             maxCompletionsTokens.getOptional("max_completions_tokens")
 
         /**
-         * Constrains effort on reasoning for
-         * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-         * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`. Reducing
-         * reasoning effort can result in faster responses and fewer tokens used on reasoning in a
-         * response.
-         * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported reasoning
-         *   values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls are supported
-         *   for all reasoning values in gpt-5.1.
-         * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not support
-         *   `none`.
-         * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-         * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+         * Constrains effort on reasoning for reasoning models. Currently supported values are
+         * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning effort
+         * can result in faster responses and fewer tokens used on reasoning in a response. Not all
+         * reasoning models support every value. See the
+         * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for model-specific
+         * support.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -2016,18 +2010,12 @@ private constructor(
             }
 
             /**
-             * Constrains effort on reasoning for
-             * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
-             * supported values are `none`, `minimal`, `low`, `medium`, `high`, and `xhigh`.
-             * Reducing reasoning effort can result in faster responses and fewer tokens used on
-             * reasoning in a response.
-             * - `gpt-5.1` defaults to `none`, which does not perform reasoning. The supported
-             *   reasoning values for `gpt-5.1` are `none`, `low`, `medium`, and `high`. Tool calls
-             *   are supported for all reasoning values in gpt-5.1.
-             * - All models before `gpt-5.1` default to `medium` reasoning effort, and do not
-             *   support `none`.
-             * - The `gpt-5-pro` model defaults to (and only supports) `high` reasoning effort.
-             * - `xhigh` is supported for all models after `gpt-5.1-codex-max`.
+             * Constrains effort on reasoning for reasoning models. Currently supported values are
+             * `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, and `max`. Reducing reasoning
+             * effort can result in faster responses and fewer tokens used on reasoning in a
+             * response. Not all reasoning models support every value. See the
+             * [reasoning guide](https://platform.openai.com/docs/guides/reasoning) for
+             * model-specific support.
              */
             fun reasoningEffort(reasoningEffort: ReasoningEffort?) =
                 reasoningEffort(JsonField.ofNullable(reasoningEffort))
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeResponseCreateMcpTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeResponseCreateMcpTool.kt
index 3006f1578..f6fbc7a63 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeResponseCreateMcpTool.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeResponseCreateMcpTool.kt
@@ -40,6 +40,7 @@ class RealtimeResponseCreateMcpTool
 private constructor(
     private val serverLabel: JsonField<String>,
     private val type: JsonValue,
+    private val allowedCallers: JsonField<List<AllowedCaller>>,
     private val allowedTools: JsonField<AllowedTools>,
     private val authorization: JsonField<String>,
     private val connectorId: JsonField<ConnectorId>,
@@ -58,6 +59,9 @@ private constructor(
         @ExcludeMissing
         serverLabel: JsonField<String> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("allowed_callers")
+        @ExcludeMissing
+        allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
         @JsonProperty("allowed_tools")
         @ExcludeMissing
         allowedTools: JsonField<AllowedTools> = JsonMissing.of(),
@@ -82,6 +86,7 @@ private constructor(
     ) : this(
         serverLabel,
         type,
+        allowedCallers,
         allowedTools,
         authorization,
         connectorId,
@@ -115,6 +120,15 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * The tool invocation context(s).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun allowedCallers(): Optional<List<AllowedCaller>> =
+        allowedCallers.getOptional("allowed_callers")
+
     /**
      * List of allowed tool names or a filter object.
      *
@@ -213,6 +227,15 @@ private constructor(
     @ExcludeMissing
     fun _serverLabel(): JsonField<String> = serverLabel
 
+    /**
+     * Returns the raw JSON value of [allowedCallers].
+     *
+     * Unlike [allowedCallers], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("allowed_callers")
+    @ExcludeMissing
+    fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
     /**
      * Returns the raw JSON value of [allowedTools].
      *
@@ -320,6 +343,7 @@ private constructor(
 
         private var serverLabel: JsonField<String>? = null
         private var type: JsonValue = JsonValue.from("mcp")
+        private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
         private var allowedTools: JsonField<AllowedTools> = JsonMissing.of()
         private var authorization: JsonField<String> = JsonMissing.of()
         private var connectorId: JsonField<ConnectorId> = JsonMissing.of()
@@ -335,6 +359,7 @@ private constructor(
         internal fun from(realtimeResponseCreateMcpTool: RealtimeResponseCreateMcpTool) = apply {
             serverLabel = realtimeResponseCreateMcpTool.serverLabel
             type = realtimeResponseCreateMcpTool.type
+            allowedCallers = realtimeResponseCreateMcpTool.allowedCallers.map { it.toMutableList() }
             allowedTools = realtimeResponseCreateMcpTool.allowedTools
             authorization = realtimeResponseCreateMcpTool.authorization
             connectorId = realtimeResponseCreateMcpTool.connectorId
@@ -373,6 +398,37 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /** The tool invocation context(s). */
+        fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+            allowedCallers(JsonField.ofNullable(allowedCallers))
+
+        /** Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`. */
+        fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+            allowedCallers(allowedCallers.getOrNull())
+
+        /**
+         * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.allowedCallers] with a well-typed `List<AllowedCaller>`
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+            this.allowedCallers = allowedCallers.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [AllowedCaller] to [allowedCallers].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+            allowedCallers =
+                (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("allowedCallers", it).add(allowedCaller)
+                }
+        }
+
         /** List of allowed tool names or a filter object. */
         fun allowedTools(allowedTools: AllowedTools?) =
             allowedTools(JsonField.ofNullable(allowedTools))
@@ -588,6 +644,7 @@ private constructor(
             RealtimeResponseCreateMcpTool(
                 checkRequired("serverLabel", serverLabel),
                 type,
+                (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
                 allowedTools,
                 authorization,
                 connectorId,
@@ -622,6 +679,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        allowedCallers().ifPresent { it.forEach { it.validate() } }
         allowedTools().ifPresent { it.validate() }
         authorization()
         connectorId().ifPresent { it.validate() }
@@ -651,6 +709,7 @@ private constructor(
     internal fun validity(): Int =
         (if (serverLabel.asKnown().isPresent) 1 else 0) +
             type.let { if (it == JsonValue.from("mcp")) 1 else 0 } +
+            (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
             (allowedTools.asKnown().getOrNull()?.validity() ?: 0) +
             (if (authorization.asKnown().isPresent) 1 else 0) +
             (connectorId.asKnown().getOrNull()?.validity() ?: 0) +
@@ -661,6 +720,144 @@ private constructor(
             (if (serverUrl.asKnown().isPresent) 1 else 0) +
             (if (tunnelId.asKnown().isPresent) 1 else 0)
 
+    class AllowedCaller @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val DIRECT = of("direct")
+
+            @JvmField val PROGRAMMATIC = of("programmatic")
+
+            @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+        }
+
+        /** An enum containing [AllowedCaller]'s known values. */
+        enum class Known {
+            DIRECT,
+            PROGRAMMATIC,
+        }
+
+        /**
+         * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            DIRECT,
+            PROGRAMMATIC,
+            /**
+             * An enum member indicating that [AllowedCaller] was instantiated with an unknown
+             * value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                DIRECT -> Value.DIRECT
+                PROGRAMMATIC -> Value.PROGRAMMATIC
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                DIRECT -> Known.DIRECT
+                PROGRAMMATIC -> Known.PROGRAMMATIC
+                else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): AllowedCaller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AllowedCaller && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
     /** List of allowed tool names or a filter object. */
     @JsonDeserialize(using = AllowedTools.Deserializer::class)
     @JsonSerialize(using = AllowedTools.Serializer::class)
@@ -2502,6 +2699,7 @@ private constructor(
         return other is RealtimeResponseCreateMcpTool &&
             serverLabel == other.serverLabel &&
             type == other.type &&
+            allowedCallers == other.allowedCallers &&
             allowedTools == other.allowedTools &&
             authorization == other.authorization &&
             connectorId == other.connectorId &&
@@ -2518,6 +2716,7 @@ private constructor(
         Objects.hash(
             serverLabel,
             type,
+            allowedCallers,
             allowedTools,
             authorization,
             connectorId,
@@ -2534,5 +2733,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "RealtimeResponseCreateMcpTool{serverLabel=$serverLabel, type=$type, allowedTools=$allowedTools, authorization=$authorization, connectorId=$connectorId, deferLoading=$deferLoading, headers=$headers, requireApproval=$requireApproval, serverDescription=$serverDescription, serverUrl=$serverUrl, tunnelId=$tunnelId, additionalProperties=$additionalProperties}"
+        "RealtimeResponseCreateMcpTool{serverLabel=$serverLabel, type=$type, allowedCallers=$allowedCallers, allowedTools=$allowedTools, authorization=$authorization, connectorId=$connectorId, deferLoading=$deferLoading, headers=$headers, requireApproval=$requireApproval, serverDescription=$serverDescription, serverUrl=$serverUrl, tunnelId=$tunnelId, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeSessionCreateRequest.kt b/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeSessionCreateRequest.kt
index e3e989d02..02b18b6bc 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeSessionCreateRequest.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeSessionCreateRequest.kt
@@ -1285,6 +1285,10 @@ private constructor(
 
             @JvmField val GPT_REALTIME_2 = of("gpt-realtime-2")
 
+            @JvmField val GPT_REALTIME_2_1 = of("gpt-realtime-2.1")
+
+            @JvmField val GPT_REALTIME_2_1_MINI = of("gpt-realtime-2.1-mini")
+
             @JvmField val GPT_REALTIME_2025_08_28 = of("gpt-realtime-2025-08-28")
 
             @JvmField val GPT_4O_REALTIME_PREVIEW = of("gpt-4o-realtime-preview")
@@ -1326,6 +1330,8 @@ private constructor(
             GPT_REALTIME,
             GPT_REALTIME_1_5,
             GPT_REALTIME_2,
+            GPT_REALTIME_2_1,
+            GPT_REALTIME_2_1_MINI,
             GPT_REALTIME_2025_08_28,
             GPT_4O_REALTIME_PREVIEW,
             GPT_4O_REALTIME_PREVIEW_2024_10_01,
@@ -1355,6 +1361,8 @@ private constructor(
             GPT_REALTIME,
             GPT_REALTIME_1_5,
             GPT_REALTIME_2,
+            GPT_REALTIME_2_1,
+            GPT_REALTIME_2_1_MINI,
             GPT_REALTIME_2025_08_28,
             GPT_4O_REALTIME_PREVIEW,
             GPT_4O_REALTIME_PREVIEW_2024_10_01,
@@ -1385,6 +1393,8 @@ private constructor(
                 GPT_REALTIME -> Value.GPT_REALTIME
                 GPT_REALTIME_1_5 -> Value.GPT_REALTIME_1_5
                 GPT_REALTIME_2 -> Value.GPT_REALTIME_2
+                GPT_REALTIME_2_1 -> Value.GPT_REALTIME_2_1
+                GPT_REALTIME_2_1_MINI -> Value.GPT_REALTIME_2_1_MINI
                 GPT_REALTIME_2025_08_28 -> Value.GPT_REALTIME_2025_08_28
                 GPT_4O_REALTIME_PREVIEW -> Value.GPT_4O_REALTIME_PREVIEW
                 GPT_4O_REALTIME_PREVIEW_2024_10_01 -> Value.GPT_4O_REALTIME_PREVIEW_2024_10_01
@@ -1417,6 +1427,8 @@ private constructor(
                 GPT_REALTIME -> Known.GPT_REALTIME
                 GPT_REALTIME_1_5 -> Known.GPT_REALTIME_1_5
                 GPT_REALTIME_2 -> Known.GPT_REALTIME_2
+                GPT_REALTIME_2_1 -> Known.GPT_REALTIME_2_1
+                GPT_REALTIME_2_1_MINI -> Known.GPT_REALTIME_2_1_MINI
                 GPT_REALTIME_2025_08_28 -> Known.GPT_REALTIME_2025_08_28
                 GPT_4O_REALTIME_PREVIEW -> Known.GPT_4O_REALTIME_PREVIEW
                 GPT_4O_REALTIME_PREVIEW_2024_10_01 -> Known.GPT_4O_REALTIME_PREVIEW_2024_10_01
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeToolsConfigUnion.kt b/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeToolsConfigUnion.kt
index 3f80bb45c..5a7986d25 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeToolsConfigUnion.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeToolsConfigUnion.kt
@@ -268,6 +268,7 @@ private constructor(
     private constructor(
         private val serverLabel: JsonField<String>,
         private val type: JsonValue,
+        private val allowedCallers: JsonField<List<AllowedCaller>>,
         private val allowedTools: JsonField<AllowedTools>,
         private val authorization: JsonField<String>,
         private val connectorId: JsonField<ConnectorId>,
@@ -286,6 +287,9 @@ private constructor(
             @ExcludeMissing
             serverLabel: JsonField<String> = JsonMissing.of(),
             @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("allowed_callers")
+            @ExcludeMissing
+            allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
             @JsonProperty("allowed_tools")
             @ExcludeMissing
             allowedTools: JsonField<AllowedTools> = JsonMissing.of(),
@@ -314,6 +318,7 @@ private constructor(
         ) : this(
             serverLabel,
             type,
+            allowedCallers,
             allowedTools,
             authorization,
             connectorId,
@@ -347,6 +352,15 @@ private constructor(
          */
         @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+        /**
+         * The tool invocation context(s).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun allowedCallers(): Optional<List<AllowedCaller>> =
+            allowedCallers.getOptional("allowed_callers")
+
         /**
          * List of allowed tool names or a filter object.
          *
@@ -447,6 +461,16 @@ private constructor(
         @ExcludeMissing
         fun _serverLabel(): JsonField<String> = serverLabel
 
+        /**
+         * Returns the raw JSON value of [allowedCallers].
+         *
+         * Unlike [allowedCallers], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("allowed_callers")
+        @ExcludeMissing
+        fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
         /**
          * Returns the raw JSON value of [allowedTools].
          *
@@ -557,6 +581,7 @@ private constructor(
 
             private var serverLabel: JsonField<String>? = null
             private var type: JsonValue = JsonValue.from("mcp")
+            private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
             private var allowedTools: JsonField<AllowedTools> = JsonMissing.of()
             private var authorization: JsonField<String> = JsonMissing.of()
             private var connectorId: JsonField<ConnectorId> = JsonMissing.of()
@@ -572,6 +597,7 @@ private constructor(
             internal fun from(mcp: Mcp) = apply {
                 serverLabel = mcp.serverLabel
                 type = mcp.type
+                allowedCallers = mcp.allowedCallers.map { it.toMutableList() }
                 allowedTools = mcp.allowedTools
                 authorization = mcp.authorization
                 connectorId = mcp.connectorId
@@ -612,6 +638,37 @@ private constructor(
              */
             fun type(type: JsonValue) = apply { this.type = type }
 
+            /** The tool invocation context(s). */
+            fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+                allowedCallers(JsonField.ofNullable(allowedCallers))
+
+            /** Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`. */
+            fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+                allowedCallers(allowedCallers.getOrNull())
+
+            /**
+             * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.allowedCallers] with a well-typed
+             * `List<AllowedCaller>` value instead. This method is primarily for setting the field
+             * to an undocumented or not yet supported value.
+             */
+            fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+                this.allowedCallers = allowedCallers.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [AllowedCaller] to [allowedCallers].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+                allowedCallers =
+                    (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("allowedCallers", it).add(allowedCaller)
+                    }
+            }
+
             /** List of allowed tool names or a filter object. */
             fun allowedTools(allowedTools: AllowedTools?) =
                 allowedTools(JsonField.ofNullable(allowedTools))
@@ -832,6 +889,7 @@ private constructor(
                 Mcp(
                     checkRequired("serverLabel", serverLabel),
                     type,
+                    (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
                     allowedTools,
                     authorization,
                     connectorId,
@@ -867,6 +925,7 @@ private constructor(
                     throw OpenAIInvalidDataException("'type' is invalid, received $it")
                 }
             }
+            allowedCallers().ifPresent { it.forEach { it.validate() } }
             allowedTools().ifPresent { it.validate() }
             authorization()
             connectorId().ifPresent { it.validate() }
@@ -897,6 +956,7 @@ private constructor(
         internal fun validity(): Int =
             (if (serverLabel.asKnown().isPresent) 1 else 0) +
                 type.let { if (it == JsonValue.from("mcp")) 1 else 0 } +
+                (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
                 (allowedTools.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (authorization.asKnown().isPresent) 1 else 0) +
                 (connectorId.asKnown().getOrNull()?.validity() ?: 0) +
@@ -907,6 +967,147 @@ private constructor(
                 (if (serverUrl.asKnown().isPresent) 1 else 0) +
                 (if (tunnelId.asKnown().isPresent) 1 else 0)
 
+        class AllowedCaller @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val DIRECT = of("direct")
+
+                @JvmField val PROGRAMMATIC = of("programmatic")
+
+                @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+            }
+
+            /** An enum containing [AllowedCaller]'s known values. */
+            enum class Known {
+                DIRECT,
+                PROGRAMMATIC,
+            }
+
+            /**
+             * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                DIRECT,
+                PROGRAMMATIC,
+                /**
+                 * An enum member indicating that [AllowedCaller] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    DIRECT -> Value.DIRECT
+                    PROGRAMMATIC -> Value.PROGRAMMATIC
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    DIRECT -> Known.DIRECT
+                    PROGRAMMATIC -> Known.PROGRAMMATIC
+                    else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): AllowedCaller = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is AllowedCaller && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
         /** List of allowed tool names or a filter object. */
         @JsonDeserialize(using = AllowedTools.Deserializer::class)
         @JsonSerialize(using = AllowedTools.Serializer::class)
@@ -2786,6 +2987,7 @@ private constructor(
             return other is Mcp &&
                 serverLabel == other.serverLabel &&
                 type == other.type &&
+                allowedCallers == other.allowedCallers &&
                 allowedTools == other.allowedTools &&
                 authorization == other.authorization &&
                 connectorId == other.connectorId &&
@@ -2802,6 +3004,7 @@ private constructor(
             Objects.hash(
                 serverLabel,
                 type,
+                allowedCallers,
                 allowedTools,
                 authorization,
                 connectorId,
@@ -2818,6 +3021,6 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Mcp{serverLabel=$serverLabel, type=$type, allowedTools=$allowedTools, authorization=$authorization, connectorId=$connectorId, deferLoading=$deferLoading, headers=$headers, requireApproval=$requireApproval, serverDescription=$serverDescription, serverUrl=$serverUrl, tunnelId=$tunnelId, additionalProperties=$additionalProperties}"
+            "Mcp{serverLabel=$serverLabel, type=$type, allowedCallers=$allowedCallers, allowedTools=$allowedTools, authorization=$authorization, connectorId=$connectorId, deferLoading=$deferLoading, headers=$headers, requireApproval=$requireApproval, serverDescription=$serverDescription, serverUrl=$serverUrl, tunnelId=$tunnelId, additionalProperties=$additionalProperties}"
     }
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/realtime/clientsecrets/RealtimeSessionCreateResponse.kt b/openai-java-core/src/main/kotlin/com/openai/models/realtime/clientsecrets/RealtimeSessionCreateResponse.kt
index 34b2484cb..e5abdf255 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/realtime/clientsecrets/RealtimeSessionCreateResponse.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/realtime/clientsecrets/RealtimeSessionCreateResponse.kt
@@ -3822,6 +3822,10 @@ private constructor(
 
             @JvmField val GPT_REALTIME_2 = of("gpt-realtime-2")
 
+            @JvmField val GPT_REALTIME_2_1 = of("gpt-realtime-2.1")
+
+            @JvmField val GPT_REALTIME_2_1_MINI = of("gpt-realtime-2.1-mini")
+
             @JvmField val GPT_REALTIME_2025_08_28 = of("gpt-realtime-2025-08-28")
 
             @JvmField val GPT_4O_REALTIME_PREVIEW = of("gpt-4o-realtime-preview")
@@ -3863,6 +3867,8 @@ private constructor(
             GPT_REALTIME,
             GPT_REALTIME_1_5,
             GPT_REALTIME_2,
+            GPT_REALTIME_2_1,
+            GPT_REALTIME_2_1_MINI,
             GPT_REALTIME_2025_08_28,
             GPT_4O_REALTIME_PREVIEW,
             GPT_4O_REALTIME_PREVIEW_2024_10_01,
@@ -3892,6 +3898,8 @@ private constructor(
             GPT_REALTIME,
             GPT_REALTIME_1_5,
             GPT_REALTIME_2,
+            GPT_REALTIME_2_1,
+            GPT_REALTIME_2_1_MINI,
             GPT_REALTIME_2025_08_28,
             GPT_4O_REALTIME_PREVIEW,
             GPT_4O_REALTIME_PREVIEW_2024_10_01,
@@ -3922,6 +3930,8 @@ private constructor(
                 GPT_REALTIME -> Value.GPT_REALTIME
                 GPT_REALTIME_1_5 -> Value.GPT_REALTIME_1_5
                 GPT_REALTIME_2 -> Value.GPT_REALTIME_2
+                GPT_REALTIME_2_1 -> Value.GPT_REALTIME_2_1
+                GPT_REALTIME_2_1_MINI -> Value.GPT_REALTIME_2_1_MINI
                 GPT_REALTIME_2025_08_28 -> Value.GPT_REALTIME_2025_08_28
                 GPT_4O_REALTIME_PREVIEW -> Value.GPT_4O_REALTIME_PREVIEW
                 GPT_4O_REALTIME_PREVIEW_2024_10_01 -> Value.GPT_4O_REALTIME_PREVIEW_2024_10_01
@@ -3954,6 +3964,8 @@ private constructor(
                 GPT_REALTIME -> Known.GPT_REALTIME
                 GPT_REALTIME_1_5 -> Known.GPT_REALTIME_1_5
                 GPT_REALTIME_2 -> Known.GPT_REALTIME_2
+                GPT_REALTIME_2_1 -> Known.GPT_REALTIME_2_1
+                GPT_REALTIME_2_1_MINI -> Known.GPT_REALTIME_2_1_MINI
                 GPT_REALTIME_2025_08_28 -> Known.GPT_REALTIME_2025_08_28
                 GPT_4O_REALTIME_PREVIEW -> Known.GPT_4O_REALTIME_PREVIEW
                 GPT_4O_REALTIME_PREVIEW_2024_10_01 -> Known.GPT_4O_REALTIME_PREVIEW_2024_10_01
@@ -4711,6 +4723,7 @@ private constructor(
         private constructor(
             private val serverLabel: JsonField<String>,
             private val type: JsonValue,
+            private val allowedCallers: JsonField<List<AllowedCaller>>,
             private val allowedTools: JsonField<AllowedTools>,
             private val authorization: JsonField<String>,
             private val connectorId: JsonField<ConnectorId>,
@@ -4729,6 +4742,9 @@ private constructor(
                 @ExcludeMissing
                 serverLabel: JsonField<String> = JsonMissing.of(),
                 @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                @JsonProperty("allowed_callers")
+                @ExcludeMissing
+                allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
                 @JsonProperty("allowed_tools")
                 @ExcludeMissing
                 allowedTools: JsonField<AllowedTools> = JsonMissing.of(),
@@ -4759,6 +4775,7 @@ private constructor(
             ) : this(
                 serverLabel,
                 type,
+                allowedCallers,
                 allowedTools,
                 authorization,
                 connectorId,
@@ -4793,6 +4810,15 @@ private constructor(
              */
             @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+            /**
+             * The tool invocation context(s).
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun allowedCallers(): Optional<List<AllowedCaller>> =
+                allowedCallers.getOptional("allowed_callers")
+
             /**
              * List of allowed tool names or a filter object.
              *
@@ -4895,6 +4921,16 @@ private constructor(
             @ExcludeMissing
             fun _serverLabel(): JsonField<String> = serverLabel
 
+            /**
+             * Returns the raw JSON value of [allowedCallers].
+             *
+             * Unlike [allowedCallers], this method doesn't throw if the JSON field has an
+             * unexpected type.
+             */
+            @JsonProperty("allowed_callers")
+            @ExcludeMissing
+            fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
             /**
              * Returns the raw JSON value of [allowedTools].
              *
@@ -5010,6 +5046,7 @@ private constructor(
 
                 private var serverLabel: JsonField<String>? = null
                 private var type: JsonValue = JsonValue.from("mcp")
+                private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
                 private var allowedTools: JsonField<AllowedTools> = JsonMissing.of()
                 private var authorization: JsonField<String> = JsonMissing.of()
                 private var connectorId: JsonField<ConnectorId> = JsonMissing.of()
@@ -5025,6 +5062,7 @@ private constructor(
                 internal fun from(mcpTool: McpTool) = apply {
                     serverLabel = mcpTool.serverLabel
                     type = mcpTool.type
+                    allowedCallers = mcpTool.allowedCallers.map { it.toMutableList() }
                     allowedTools = mcpTool.allowedTools
                     authorization = mcpTool.authorization
                     connectorId = mcpTool.connectorId
@@ -5065,6 +5103,39 @@ private constructor(
                  */
                 fun type(type: JsonValue) = apply { this.type = type }
 
+                /** The tool invocation context(s). */
+                fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+                    allowedCallers(JsonField.ofNullable(allowedCallers))
+
+                /**
+                 * Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`.
+                 */
+                fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+                    allowedCallers(allowedCallers.getOrNull())
+
+                /**
+                 * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.allowedCallers] with a well-typed
+                 * `List<AllowedCaller>` value instead. This method is primarily for setting the
+                 * field to an undocumented or not yet supported value.
+                 */
+                fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+                    this.allowedCallers = allowedCallers.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [AllowedCaller] to [allowedCallers].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+                    allowedCallers =
+                        (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("allowedCallers", it).add(allowedCaller)
+                        }
+                }
+
                 /** List of allowed tool names or a filter object. */
                 fun allowedTools(allowedTools: AllowedTools?) =
                     allowedTools(JsonField.ofNullable(allowedTools))
@@ -5296,6 +5367,7 @@ private constructor(
                     McpTool(
                         checkRequired("serverLabel", serverLabel),
                         type,
+                        (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
                         allowedTools,
                         authorization,
                         connectorId,
@@ -5332,6 +5404,7 @@ private constructor(
                         throw OpenAIInvalidDataException("'type' is invalid, received $it")
                     }
                 }
+                allowedCallers().ifPresent { it.forEach { it.validate() } }
                 allowedTools().ifPresent { it.validate() }
                 authorization()
                 connectorId().ifPresent { it.validate() }
@@ -5362,6 +5435,7 @@ private constructor(
             internal fun validity(): Int =
                 (if (serverLabel.asKnown().isPresent) 1 else 0) +
                     type.let { if (it == JsonValue.from("mcp")) 1 else 0 } +
+                    (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
                     (allowedTools.asKnown().getOrNull()?.validity() ?: 0) +
                     (if (authorization.asKnown().isPresent) 1 else 0) +
                     (connectorId.asKnown().getOrNull()?.validity() ?: 0) +
@@ -5372,6 +5446,149 @@ private constructor(
                     (if (serverUrl.asKnown().isPresent) 1 else 0) +
                     (if (tunnelId.asKnown().isPresent) 1 else 0)
 
+            class AllowedCaller
+            @JsonCreator
+            private constructor(private val value: JsonField<String>) : Enum {
+
+                /**
+                 * Returns this class instance's raw value.
+                 *
+                 * This is usually only useful if this instance was deserialized from data that
+                 * doesn't match any known member, and you want to know that value. For example, if
+                 * the SDK is on an older version than the API, then the API may respond with new
+                 * members that the SDK is unaware of.
+                 */
+                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+                companion object {
+
+                    @JvmField val DIRECT = of("direct")
+
+                    @JvmField val PROGRAMMATIC = of("programmatic")
+
+                    @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+                }
+
+                /** An enum containing [AllowedCaller]'s known values. */
+                enum class Known {
+                    DIRECT,
+                    PROGRAMMATIC,
+                }
+
+                /**
+                 * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN]
+                 * member.
+                 *
+                 * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+                 * - It was deserialized from data that doesn't match any known member. For example,
+                 *   if the SDK is on an older version than the API, then the API may respond with
+                 *   new members that the SDK is unaware of.
+                 * - It was constructed with an arbitrary value using the [of] method.
+                 */
+                enum class Value {
+                    DIRECT,
+                    PROGRAMMATIC,
+                    /**
+                     * An enum member indicating that [AllowedCaller] was instantiated with an
+                     * unknown value.
+                     */
+                    _UNKNOWN,
+                }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value, or
+                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                 *
+                 * Use the [known] method instead if you're certain the value is always known or if
+                 * you want to throw for the unknown case.
+                 */
+                fun value(): Value =
+                    when (this) {
+                        DIRECT -> Value.DIRECT
+                        PROGRAMMATIC -> Value.PROGRAMMATIC
+                        else -> Value._UNKNOWN
+                    }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value.
+                 *
+                 * Use the [value] method instead if you're uncertain the value is always known and
+                 * don't want to throw for the unknown case.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                 *   known member.
+                 */
+                fun known(): Known =
+                    when (this) {
+                        DIRECT -> Known.DIRECT
+                        PROGRAMMATIC -> Known.PROGRAMMATIC
+                        else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+                    }
+
+                /**
+                 * Returns this class instance's primitive wire representation.
+                 *
+                 * This differs from the [toString] method because that method is primarily for
+                 * debugging and generally doesn't throw.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value does not have
+                 *   the expected primitive type.
+                 */
+                fun asString(): String =
+                    _value().asString().orElseThrow {
+                        OpenAIInvalidDataException("Value is not a String")
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): AllowedCaller = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    known()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is AllowedCaller && value == other.value
+                }
+
+                override fun hashCode() = value.hashCode()
+
+                override fun toString() = value.toString()
+            }
+
             /** List of allowed tool names or a filter object. */
             @JsonDeserialize(using = AllowedTools.Deserializer::class)
             @JsonSerialize(using = AllowedTools.Serializer::class)
@@ -7293,6 +7510,7 @@ private constructor(
                 return other is McpTool &&
                     serverLabel == other.serverLabel &&
                     type == other.type &&
+                    allowedCallers == other.allowedCallers &&
                     allowedTools == other.allowedTools &&
                     authorization == other.authorization &&
                     connectorId == other.connectorId &&
@@ -7309,6 +7527,7 @@ private constructor(
                 Objects.hash(
                     serverLabel,
                     type,
+                    allowedCallers,
                     allowedTools,
                     authorization,
                     connectorId,
@@ -7325,7 +7544,7 @@ private constructor(
             override fun hashCode(): Int = hashCode
 
             override fun toString() =
-                "McpTool{serverLabel=$serverLabel, type=$type, allowedTools=$allowedTools, authorization=$authorization, connectorId=$connectorId, deferLoading=$deferLoading, headers=$headers, requireApproval=$requireApproval, serverDescription=$serverDescription, serverUrl=$serverUrl, tunnelId=$tunnelId, additionalProperties=$additionalProperties}"
+                "McpTool{serverLabel=$serverLabel, type=$type, allowedCallers=$allowedCallers, allowedTools=$allowedTools, authorization=$authorization, connectorId=$connectorId, deferLoading=$deferLoading, headers=$headers, requireApproval=$requireApproval, serverDescription=$serverDescription, serverUrl=$serverUrl, tunnelId=$tunnelId, additionalProperties=$additionalProperties}"
         }
     }
 
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ApplyPatchTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ApplyPatchTool.kt
index cc894ca70..caef0f64d 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ApplyPatchTool.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ApplyPatchTool.kt
@@ -6,25 +6,35 @@ import com.fasterxml.jackson.annotation.JsonAnyGetter
 import com.fasterxml.jackson.annotation.JsonAnySetter
 import com.fasterxml.jackson.annotation.JsonCreator
 import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
 import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
 import com.openai.core.JsonMissing
 import com.openai.core.JsonValue
+import com.openai.core.checkKnown
+import com.openai.core.toImmutable
 import com.openai.errors.OpenAIInvalidDataException
 import java.util.Collections
 import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
 
 /** Allows the assistant to create, delete, or update files using unified diffs. */
 class ApplyPatchTool
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
     private val type: JsonValue,
+    private val allowedCallers: JsonField<List<AllowedCaller>>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
     @JsonCreator
     private constructor(
-        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of()
-    ) : this(type, mutableMapOf())
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("allowed_callers")
+        @ExcludeMissing
+        allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
+    ) : this(type, allowedCallers, mutableMapOf())
 
     /**
      * The type of the tool. Always `apply_patch`.
@@ -39,6 +49,24 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * The tool invocation context(s).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun allowedCallers(): Optional<List<AllowedCaller>> =
+        allowedCallers.getOptional("allowed_callers")
+
+    /**
+     * Returns the raw JSON value of [allowedCallers].
+     *
+     * Unlike [allowedCallers], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("allowed_callers")
+    @ExcludeMissing
+    fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -61,11 +89,13 @@ private constructor(
     class Builder internal constructor() {
 
         private var type: JsonValue = JsonValue.from("apply_patch")
+        private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
         internal fun from(applyPatchTool: ApplyPatchTool) = apply {
             type = applyPatchTool.type
+            allowedCallers = applyPatchTool.allowedCallers.map { it.toMutableList() }
             additionalProperties = applyPatchTool.additionalProperties.toMutableMap()
         }
 
@@ -83,6 +113,37 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /** The tool invocation context(s). */
+        fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+            allowedCallers(JsonField.ofNullable(allowedCallers))
+
+        /** Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`. */
+        fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+            allowedCallers(allowedCallers.getOrNull())
+
+        /**
+         * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.allowedCallers] with a well-typed `List<AllowedCaller>`
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+            this.allowedCallers = allowedCallers.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [AllowedCaller] to [allowedCallers].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+            allowedCallers =
+                (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("allowedCallers", it).add(allowedCaller)
+                }
+        }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -107,7 +168,12 @@ private constructor(
          *
          * Further updates to this [Builder] will not mutate the returned instance.
          */
-        fun build(): ApplyPatchTool = ApplyPatchTool(type, additionalProperties.toMutableMap())
+        fun build(): ApplyPatchTool =
+            ApplyPatchTool(
+                type,
+                (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
+                additionalProperties.toMutableMap(),
+            )
     }
 
     private var validated: Boolean = false
@@ -130,6 +196,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        allowedCallers().ifPresent { it.forEach { it.validate() } }
         validated = true
     }
 
@@ -147,7 +214,147 @@ private constructor(
      * Used for best match union deserialization.
      */
     @JvmSynthetic
-    internal fun validity(): Int = type.let { if (it == JsonValue.from("apply_patch")) 1 else 0 }
+    internal fun validity(): Int =
+        type.let { if (it == JsonValue.from("apply_patch")) 1 else 0 } +
+            (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
+
+    class AllowedCaller @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val DIRECT = of("direct")
+
+            @JvmField val PROGRAMMATIC = of("programmatic")
+
+            @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+        }
+
+        /** An enum containing [AllowedCaller]'s known values. */
+        enum class Known {
+            DIRECT,
+            PROGRAMMATIC,
+        }
+
+        /**
+         * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            DIRECT,
+            PROGRAMMATIC,
+            /**
+             * An enum member indicating that [AllowedCaller] was instantiated with an unknown
+             * value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                DIRECT -> Value.DIRECT
+                PROGRAMMATIC -> Value.PROGRAMMATIC
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                DIRECT -> Known.DIRECT
+                PROGRAMMATIC -> Known.PROGRAMMATIC
+                else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): AllowedCaller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AllowedCaller && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
 
     override fun equals(other: Any?): Boolean {
         if (this === other) {
@@ -156,13 +363,14 @@ private constructor(
 
         return other is ApplyPatchTool &&
             type == other.type &&
+            allowedCallers == other.allowedCallers &&
             additionalProperties == other.additionalProperties
     }
 
-    private val hashCode: Int by lazy { Objects.hash(type, additionalProperties) }
+    private val hashCode: Int by lazy { Objects.hash(type, allowedCallers, additionalProperties) }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ApplyPatchTool{type=$type, additionalProperties=$additionalProperties}"
+        "ApplyPatchTool{type=$type, allowedCallers=$allowedCallers, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/CompactedResponse.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/CompactedResponse.kt
index 745c5f7b7..eec9af05f 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/CompactedResponse.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/CompactedResponse.kt
@@ -271,6 +271,16 @@ private constructor(
         fun addOutput(reasoning: ResponseReasoningItem) =
             addOutput(ResponseOutputItem.ofReasoning(reasoning))
 
+        /** Alias for calling [addOutput] with `ResponseOutputItem.ofProgram(program)`. */
+        fun addOutput(program: ResponseOutputItem.Program) =
+            addOutput(ResponseOutputItem.ofProgram(program))
+
+        /**
+         * Alias for calling [addOutput] with `ResponseOutputItem.ofProgramOutput(programOutput)`.
+         */
+        fun addOutput(programOutput: ResponseOutputItem.ProgramOutput) =
+            addOutput(ResponseOutputItem.ofProgramOutput(programOutput))
+
         /**
          * Alias for calling [addOutput] with `ResponseOutputItem.ofToolSearchCall(toolSearchCall)`.
          */
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/CustomTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/CustomTool.kt
index b18c0447d..021503a6c 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/CustomTool.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/CustomTool.kt
@@ -6,11 +6,14 @@ import com.fasterxml.jackson.annotation.JsonAnyGetter
 import com.fasterxml.jackson.annotation.JsonAnySetter
 import com.fasterxml.jackson.annotation.JsonCreator
 import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
 import com.openai.core.ExcludeMissing
 import com.openai.core.JsonField
 import com.openai.core.JsonMissing
 import com.openai.core.JsonValue
+import com.openai.core.checkKnown
 import com.openai.core.checkRequired
+import com.openai.core.toImmutable
 import com.openai.errors.OpenAIInvalidDataException
 import com.openai.models.CustomToolInputFormat
 import java.util.Collections
@@ -27,6 +30,7 @@ class CustomTool
 private constructor(
     private val name: JsonField<String>,
     private val type: JsonValue,
+    private val allowedCallers: JsonField<List<AllowedCaller>>,
     private val deferLoading: JsonField<Boolean>,
     private val description: JsonField<String>,
     private val format: JsonField<CustomToolInputFormat>,
@@ -37,6 +41,9 @@ private constructor(
     private constructor(
         @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("allowed_callers")
+        @ExcludeMissing
+        allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
         @JsonProperty("defer_loading")
         @ExcludeMissing
         deferLoading: JsonField<Boolean> = JsonMissing.of(),
@@ -46,7 +53,7 @@ private constructor(
         @JsonProperty("format")
         @ExcludeMissing
         format: JsonField<CustomToolInputFormat> = JsonMissing.of(),
-    ) : this(name, type, deferLoading, description, format, mutableMapOf())
+    ) : this(name, type, allowedCallers, deferLoading, description, format, mutableMapOf())
 
     /**
      * The name of the custom tool, used to identify it in tool calls.
@@ -69,6 +76,15 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * The tool invocation context(s).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun allowedCallers(): Optional<List<AllowedCaller>> =
+        allowedCallers.getOptional("allowed_callers")
+
     /**
      * Whether this tool should be deferred and discovered via tool search.
      *
@@ -100,6 +116,15 @@ private constructor(
      */
     @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
 
+    /**
+     * Returns the raw JSON value of [allowedCallers].
+     *
+     * Unlike [allowedCallers], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("allowed_callers")
+    @ExcludeMissing
+    fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
     /**
      * Returns the raw JSON value of [deferLoading].
      *
@@ -153,6 +178,7 @@ private constructor(
 
         private var name: JsonField<String>? = null
         private var type: JsonValue = JsonValue.from("custom")
+        private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
         private var deferLoading: JsonField<Boolean> = JsonMissing.of()
         private var description: JsonField<String> = JsonMissing.of()
         private var format: JsonField<CustomToolInputFormat> = JsonMissing.of()
@@ -162,6 +188,7 @@ private constructor(
         internal fun from(customTool: CustomTool) = apply {
             name = customTool.name
             type = customTool.type
+            allowedCallers = customTool.allowedCallers.map { it.toMutableList() }
             deferLoading = customTool.deferLoading
             description = customTool.description
             format = customTool.format
@@ -193,6 +220,37 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /** The tool invocation context(s). */
+        fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+            allowedCallers(JsonField.ofNullable(allowedCallers))
+
+        /** Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`. */
+        fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+            allowedCallers(allowedCallers.getOrNull())
+
+        /**
+         * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.allowedCallers] with a well-typed `List<AllowedCaller>`
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+            this.allowedCallers = allowedCallers.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [AllowedCaller] to [allowedCallers].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+            allowedCallers =
+                (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("allowedCallers", it).add(allowedCaller)
+                }
+        }
+
         /** Whether this tool should be deferred and discovered via tool search. */
         fun deferLoading(deferLoading: Boolean) = deferLoading(JsonField.of(deferLoading))
 
@@ -273,6 +331,7 @@ private constructor(
             CustomTool(
                 checkRequired("name", name),
                 type,
+                (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
                 deferLoading,
                 description,
                 format,
@@ -301,6 +360,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        allowedCallers().ifPresent { it.forEach { it.validate() } }
         deferLoading()
         description()
         format().ifPresent { it.validate() }
@@ -324,10 +384,149 @@ private constructor(
     internal fun validity(): Int =
         (if (name.asKnown().isPresent) 1 else 0) +
             type.let { if (it == JsonValue.from("custom")) 1 else 0 } +
+            (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
             (if (deferLoading.asKnown().isPresent) 1 else 0) +
             (if (description.asKnown().isPresent) 1 else 0) +
             (format.asKnown().getOrNull()?.validity() ?: 0)
 
+    class AllowedCaller @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val DIRECT = of("direct")
+
+            @JvmField val PROGRAMMATIC = of("programmatic")
+
+            @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+        }
+
+        /** An enum containing [AllowedCaller]'s known values. */
+        enum class Known {
+            DIRECT,
+            PROGRAMMATIC,
+        }
+
+        /**
+         * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            DIRECT,
+            PROGRAMMATIC,
+            /**
+             * An enum member indicating that [AllowedCaller] was instantiated with an unknown
+             * value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                DIRECT -> Value.DIRECT
+                PROGRAMMATIC -> Value.PROGRAMMATIC
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                DIRECT -> Known.DIRECT
+                PROGRAMMATIC -> Known.PROGRAMMATIC
+                else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): AllowedCaller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AllowedCaller && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -336,6 +535,7 @@ private constructor(
         return other is CustomTool &&
             name == other.name &&
             type == other.type &&
+            allowedCallers == other.allowedCallers &&
             deferLoading == other.deferLoading &&
             description == other.description &&
             format == other.format &&
@@ -343,11 +543,19 @@ private constructor(
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(name, type, deferLoading, description, format, additionalProperties)
+        Objects.hash(
+            name,
+            type,
+            allowedCallers,
+            deferLoading,
+            description,
+            format,
+            additionalProperties,
+        )
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "CustomTool{name=$name, type=$type, deferLoading=$deferLoading, description=$description, format=$format, additionalProperties=$additionalProperties}"
+        "CustomTool{name=$name, type=$type, allowedCallers=$allowedCallers, deferLoading=$deferLoading, description=$description, format=$format, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/FunctionShellTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/FunctionShellTool.kt
index caf8a80fb..680add11e 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/FunctionShellTool.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/FunctionShellTool.kt
@@ -15,11 +15,14 @@ import com.fasterxml.jackson.databind.annotation.JsonSerialize
 import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
 import com.openai.core.BaseDeserializer
 import com.openai.core.BaseSerializer
+import com.openai.core.Enum
 import com.openai.core.ExcludeMissing
 import com.openai.core.JsonField
 import com.openai.core.JsonMissing
 import com.openai.core.JsonValue
+import com.openai.core.checkKnown
 import com.openai.core.getOrThrow
+import com.openai.core.toImmutable
 import com.openai.errors.OpenAIInvalidDataException
 import java.util.Collections
 import java.util.Objects
@@ -31,6 +34,7 @@ class FunctionShellTool
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
     private val type: JsonValue,
+    private val allowedCallers: JsonField<List<AllowedCaller>>,
     private val environment: JsonField<Environment>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
@@ -38,10 +42,13 @@ private constructor(
     @JsonCreator
     private constructor(
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("allowed_callers")
+        @ExcludeMissing
+        allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
         @JsonProperty("environment")
         @ExcludeMissing
         environment: JsonField<Environment> = JsonMissing.of(),
-    ) : this(type, environment, mutableMapOf())
+    ) : this(type, allowedCallers, environment, mutableMapOf())
 
     /**
      * The type of the shell tool. Always `shell`.
@@ -56,12 +63,30 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * The tool invocation context(s).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun allowedCallers(): Optional<List<AllowedCaller>> =
+        allowedCallers.getOptional("allowed_callers")
+
     /**
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
     fun environment(): Optional<Environment> = environment.getOptional("environment")
 
+    /**
+     * Returns the raw JSON value of [allowedCallers].
+     *
+     * Unlike [allowedCallers], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("allowed_callers")
+    @ExcludeMissing
+    fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
     /**
      * Returns the raw JSON value of [environment].
      *
@@ -93,12 +118,14 @@ private constructor(
     class Builder internal constructor() {
 
         private var type: JsonValue = JsonValue.from("shell")
+        private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
         private var environment: JsonField<Environment> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
         internal fun from(functionShellTool: FunctionShellTool) = apply {
             type = functionShellTool.type
+            allowedCallers = functionShellTool.allowedCallers.map { it.toMutableList() }
             environment = functionShellTool.environment
             additionalProperties = functionShellTool.additionalProperties.toMutableMap()
         }
@@ -117,6 +144,37 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /** The tool invocation context(s). */
+        fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+            allowedCallers(JsonField.ofNullable(allowedCallers))
+
+        /** Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`. */
+        fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+            allowedCallers(allowedCallers.getOrNull())
+
+        /**
+         * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.allowedCallers] with a well-typed `List<AllowedCaller>`
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+            this.allowedCallers = allowedCallers.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [AllowedCaller] to [allowedCallers].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+            allowedCallers =
+                (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("allowedCallers", it).add(allowedCaller)
+                }
+        }
+
         fun environment(environment: Environment?) = environment(JsonField.ofNullable(environment))
 
         /** Alias for calling [Builder.environment] with `environment.orElse(null)`. */
@@ -183,7 +241,12 @@ private constructor(
          * Further updates to this [Builder] will not mutate the returned instance.
          */
         fun build(): FunctionShellTool =
-            FunctionShellTool(type, environment, additionalProperties.toMutableMap())
+            FunctionShellTool(
+                type,
+                (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
+                environment,
+                additionalProperties.toMutableMap(),
+            )
     }
 
     private var validated: Boolean = false
@@ -206,6 +269,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        allowedCallers().ifPresent { it.forEach { it.validate() } }
         environment().ifPresent { it.validate() }
         validated = true
     }
@@ -226,8 +290,147 @@ private constructor(
     @JvmSynthetic
     internal fun validity(): Int =
         type.let { if (it == JsonValue.from("shell")) 1 else 0 } +
+            (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
             (environment.asKnown().getOrNull()?.validity() ?: 0)
 
+    class AllowedCaller @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val DIRECT = of("direct")
+
+            @JvmField val PROGRAMMATIC = of("programmatic")
+
+            @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+        }
+
+        /** An enum containing [AllowedCaller]'s known values. */
+        enum class Known {
+            DIRECT,
+            PROGRAMMATIC,
+        }
+
+        /**
+         * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            DIRECT,
+            PROGRAMMATIC,
+            /**
+             * An enum member indicating that [AllowedCaller] was instantiated with an unknown
+             * value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                DIRECT -> Value.DIRECT
+                PROGRAMMATIC -> Value.PROGRAMMATIC
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                DIRECT -> Known.DIRECT
+                PROGRAMMATIC -> Known.PROGRAMMATIC
+                else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): AllowedCaller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AllowedCaller && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
     @JsonDeserialize(using = Environment.Deserializer::class)
     @JsonSerialize(using = Environment.Serializer::class)
     class Environment
@@ -477,14 +680,17 @@ private constructor(
 
         return other is FunctionShellTool &&
             type == other.type &&
+            allowedCallers == other.allowedCallers &&
             environment == other.environment &&
             additionalProperties == other.additionalProperties
     }
 
-    private val hashCode: Int by lazy { Objects.hash(type, environment, additionalProperties) }
+    private val hashCode: Int by lazy {
+        Objects.hash(type, allowedCallers, environment, additionalProperties)
+    }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "FunctionShellTool{type=$type, environment=$environment, additionalProperties=$additionalProperties}"
+        "FunctionShellTool{type=$type, allowedCallers=$allowedCallers, environment=$environment, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/FunctionTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/FunctionTool.kt
index 6399d2048..ab7fc358e 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/FunctionTool.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/FunctionTool.kt
@@ -6,10 +6,12 @@ import com.fasterxml.jackson.annotation.JsonAnyGetter
 import com.fasterxml.jackson.annotation.JsonAnySetter
 import com.fasterxml.jackson.annotation.JsonCreator
 import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
 import com.openai.core.ExcludeMissing
 import com.openai.core.JsonField
 import com.openai.core.JsonMissing
 import com.openai.core.JsonValue
+import com.openai.core.checkKnown
 import com.openai.core.checkRequired
 import com.openai.core.toImmutable
 import com.openai.errors.OpenAIInvalidDataException
@@ -29,8 +31,10 @@ private constructor(
     private val parameters: JsonField<Parameters>,
     private val strict: JsonField<Boolean>,
     private val type: JsonValue,
+    private val allowedCallers: JsonField<List<AllowedCaller>>,
     private val deferLoading: JsonField<Boolean>,
     private val description: JsonField<String>,
+    private val outputSchema: JsonField<OutputSchema>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -42,13 +46,29 @@ private constructor(
         parameters: JsonField<Parameters> = JsonMissing.of(),
         @JsonProperty("strict") @ExcludeMissing strict: JsonField<Boolean> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("allowed_callers")
+        @ExcludeMissing
+        allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
         @JsonProperty("defer_loading")
         @ExcludeMissing
         deferLoading: JsonField<Boolean> = JsonMissing.of(),
         @JsonProperty("description")
         @ExcludeMissing
         description: JsonField<String> = JsonMissing.of(),
-    ) : this(name, parameters, strict, type, deferLoading, description, mutableMapOf())
+        @JsonProperty("output_schema")
+        @ExcludeMissing
+        outputSchema: JsonField<OutputSchema> = JsonMissing.of(),
+    ) : this(
+        name,
+        parameters,
+        strict,
+        type,
+        allowedCallers,
+        deferLoading,
+        description,
+        outputSchema,
+        mutableMapOf(),
+    )
 
     /**
      * The name of the function to call.
@@ -67,7 +87,7 @@ private constructor(
     fun parameters(): Optional<Parameters> = parameters.getOptional("parameters")
 
     /**
-     * Whether to enforce strict parameter validation. Default `true`.
+     * Whether strict parameter validation is enforced for this function tool.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -87,6 +107,15 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * The tool invocation context(s).
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun allowedCallers(): Optional<List<AllowedCaller>> =
+        allowedCallers.getOptional("allowed_callers")
+
     /**
      * Whether this function is deferred and loaded via tool search.
      *
@@ -104,6 +133,14 @@ private constructor(
      */
     fun description(): Optional<String> = description.getOptional("description")
 
+    /**
+     * A JSON schema object describing the JSON value encoded in string outputs for this function.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun outputSchema(): Optional<OutputSchema> = outputSchema.getOptional("output_schema")
+
     /**
      * Returns the raw JSON value of [name].
      *
@@ -127,6 +164,15 @@ private constructor(
      */
     @JsonProperty("strict") @ExcludeMissing fun _strict(): JsonField<Boolean> = strict
 
+    /**
+     * Returns the raw JSON value of [allowedCallers].
+     *
+     * Unlike [allowedCallers], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("allowed_callers")
+    @ExcludeMissing
+    fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
     /**
      * Returns the raw JSON value of [deferLoading].
      *
@@ -143,6 +189,15 @@ private constructor(
      */
     @JsonProperty("description") @ExcludeMissing fun _description(): JsonField<String> = description
 
+    /**
+     * Returns the raw JSON value of [outputSchema].
+     *
+     * Unlike [outputSchema], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("output_schema")
+    @ExcludeMissing
+    fun _outputSchema(): JsonField<OutputSchema> = outputSchema
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -177,8 +232,10 @@ private constructor(
         private var parameters: JsonField<Parameters>? = null
         private var strict: JsonField<Boolean>? = null
         private var type: JsonValue = JsonValue.from("function")
+        private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
         private var deferLoading: JsonField<Boolean> = JsonMissing.of()
         private var description: JsonField<String> = JsonMissing.of()
+        private var outputSchema: JsonField<OutputSchema> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -187,8 +244,10 @@ private constructor(
             parameters = functionTool.parameters
             strict = functionTool.strict
             type = functionTool.type
+            allowedCallers = functionTool.allowedCallers.map { it.toMutableList() }
             deferLoading = functionTool.deferLoading
             description = functionTool.description
+            outputSchema = functionTool.outputSchema
             additionalProperties = functionTool.additionalProperties.toMutableMap()
         }
 
@@ -218,7 +277,7 @@ private constructor(
          */
         fun parameters(parameters: JsonField<Parameters>) = apply { this.parameters = parameters }
 
-        /** Whether to enforce strict parameter validation. Default `true`. */
+        /** Whether strict parameter validation is enforced for this function tool. */
         fun strict(strict: Boolean?) = strict(JsonField.ofNullable(strict))
 
         /**
@@ -253,6 +312,37 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /** The tool invocation context(s). */
+        fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+            allowedCallers(JsonField.ofNullable(allowedCallers))
+
+        /** Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`. */
+        fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+            allowedCallers(allowedCallers.getOrNull())
+
+        /**
+         * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.allowedCallers] with a well-typed `List<AllowedCaller>`
+         * value instead. This method is primarily for setting the field to an undocumented or not
+         * yet supported value.
+         */
+        fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+            this.allowedCallers = allowedCallers.map { it.toMutableList() }
+        }
+
+        /**
+         * Adds a single [AllowedCaller] to [allowedCallers].
+         *
+         * @throws IllegalStateException if the field was previously set to a non-list.
+         */
+        fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+            allowedCallers =
+                (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                    checkKnown("allowedCallers", it).add(allowedCaller)
+                }
+        }
+
         /** Whether this function is deferred and loaded via tool search. */
         fun deferLoading(deferLoading: Boolean) = deferLoading(JsonField.of(deferLoading))
 
@@ -285,6 +375,28 @@ private constructor(
          */
         fun description(description: JsonField<String>) = apply { this.description = description }
 
+        /**
+         * A JSON schema object describing the JSON value encoded in string outputs for this
+         * function.
+         */
+        fun outputSchema(outputSchema: OutputSchema?) =
+            outputSchema(JsonField.ofNullable(outputSchema))
+
+        /** Alias for calling [Builder.outputSchema] with `outputSchema.orElse(null)`. */
+        fun outputSchema(outputSchema: Optional<OutputSchema>) =
+            outputSchema(outputSchema.getOrNull())
+
+        /**
+         * Sets [Builder.outputSchema] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.outputSchema] with a well-typed [OutputSchema] value
+         * instead. This method is primarily for setting the field to an undocumented or not yet
+         * supported value.
+         */
+        fun outputSchema(outputSchema: JsonField<OutputSchema>) = apply {
+            this.outputSchema = outputSchema
+        }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -324,8 +436,10 @@ private constructor(
                 checkRequired("parameters", parameters),
                 checkRequired("strict", strict),
                 type,
+                (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
                 deferLoading,
                 description,
+                outputSchema,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -353,8 +467,10 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        allowedCallers().ifPresent { it.forEach { it.validate() } }
         deferLoading()
         description()
+        outputSchema().ifPresent { it.validate() }
         validated = true
     }
 
@@ -377,8 +493,10 @@ private constructor(
             (parameters.asKnown().getOrNull()?.validity() ?: 0) +
             (if (strict.asKnown().isPresent) 1 else 0) +
             type.let { if (it == JsonValue.from("function")) 1 else 0 } +
+            (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
             (if (deferLoading.asKnown().isPresent) 1 else 0) +
-            (if (description.asKnown().isPresent) 1 else 0)
+            (if (description.asKnown().isPresent) 1 else 0) +
+            (outputSchema.asKnown().getOrNull()?.validity() ?: 0)
 
     /** A JSON schema object describing the parameters of the function. */
     class Parameters
@@ -489,6 +607,255 @@ private constructor(
         override fun toString() = "Parameters{additionalProperties=$additionalProperties}"
     }
 
+    class AllowedCaller @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val DIRECT = of("direct")
+
+            @JvmField val PROGRAMMATIC = of("programmatic")
+
+            @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+        }
+
+        /** An enum containing [AllowedCaller]'s known values. */
+        enum class Known {
+            DIRECT,
+            PROGRAMMATIC,
+        }
+
+        /**
+         * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            DIRECT,
+            PROGRAMMATIC,
+            /**
+             * An enum member indicating that [AllowedCaller] was instantiated with an unknown
+             * value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                DIRECT -> Value.DIRECT
+                PROGRAMMATIC -> Value.PROGRAMMATIC
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                DIRECT -> Known.DIRECT
+                PROGRAMMATIC -> Known.PROGRAMMATIC
+                else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): AllowedCaller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is AllowedCaller && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /**
+     * A JSON schema object describing the JSON value encoded in string outputs for this function.
+     */
+    class OutputSchema
+    @JsonCreator
+    private constructor(
+        @com.fasterxml.jackson.annotation.JsonValue
+        private val additionalProperties: Map<String, JsonValue>
+    ) {
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [OutputSchema]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [OutputSchema]. */
+        class Builder internal constructor() {
+
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(outputSchema: OutputSchema) = apply {
+                additionalProperties = outputSchema.additionalProperties.toMutableMap()
+            }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [OutputSchema].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): OutputSchema = OutputSchema(additionalProperties.toImmutable())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): OutputSchema = apply {
+            if (validated) {
+                return@apply
+            }
+
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            additionalProperties.count { (_, value) -> !value.isNull() && !value.isMissing() }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is OutputSchema && additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() = "OutputSchema{additionalProperties=$additionalProperties}"
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -499,8 +866,10 @@ private constructor(
             parameters == other.parameters &&
             strict == other.strict &&
             type == other.type &&
+            allowedCallers == other.allowedCallers &&
             deferLoading == other.deferLoading &&
             description == other.description &&
+            outputSchema == other.outputSchema &&
             additionalProperties == other.additionalProperties
     }
 
@@ -510,8 +879,10 @@ private constructor(
             parameters,
             strict,
             type,
+            allowedCallers,
             deferLoading,
             description,
+            outputSchema,
             additionalProperties,
         )
     }
@@ -519,5 +890,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "FunctionTool{name=$name, parameters=$parameters, strict=$strict, type=$type, deferLoading=$deferLoading, description=$description, additionalProperties=$additionalProperties}"
+        "FunctionTool{name=$name, parameters=$parameters, strict=$strict, type=$type, allowedCallers=$allowedCallers, deferLoading=$deferLoading, description=$description, outputSchema=$outputSchema, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/NamespaceTool.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/NamespaceTool.kt
index 7291779ca..f7aab6621 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/NamespaceTool.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/NamespaceTool.kt
@@ -15,6 +15,7 @@ import com.fasterxml.jackson.databind.annotation.JsonSerialize
 import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
 import com.openai.core.BaseDeserializer
 import com.openai.core.BaseSerializer
+import com.openai.core.Enum
 import com.openai.core.ExcludeMissing
 import com.openai.core.JsonField
 import com.openai.core.JsonMissing
@@ -551,8 +552,10 @@ private constructor(
         private constructor(
             private val name: JsonField<String>,
             private val type: JsonValue,
+            private val allowedCallers: JsonField<List<AllowedCaller>>,
             private val deferLoading: JsonField<Boolean>,
             private val description: JsonField<String>,
+            private val outputSchema: JsonField<OutputSchema>,
             private val parameters: JsonValue,
             private val strict: JsonField<Boolean>,
             private val additionalProperties: MutableMap<String, JsonValue>,
@@ -562,19 +565,35 @@ private constructor(
             private constructor(
                 @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
                 @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                @JsonProperty("allowed_callers")
+                @ExcludeMissing
+                allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
                 @JsonProperty("defer_loading")
                 @ExcludeMissing
                 deferLoading: JsonField<Boolean> = JsonMissing.of(),
                 @JsonProperty("description")
                 @ExcludeMissing
                 description: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("output_schema")
+                @ExcludeMissing
+                outputSchema: JsonField<OutputSchema> = JsonMissing.of(),
                 @JsonProperty("parameters")
                 @ExcludeMissing
                 parameters: JsonValue = JsonMissing.of(),
                 @JsonProperty("strict")
                 @ExcludeMissing
                 strict: JsonField<Boolean> = JsonMissing.of(),
-            ) : this(name, type, deferLoading, description, parameters, strict, mutableMapOf())
+            ) : this(
+                name,
+                type,
+                allowedCallers,
+                deferLoading,
+                description,
+                outputSchema,
+                parameters,
+                strict,
+                mutableMapOf(),
+            )
 
             /**
              * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
@@ -594,6 +613,15 @@ private constructor(
              */
             @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+            /**
+             * The tool invocation context(s).
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun allowedCallers(): Optional<List<AllowedCaller>> =
+                allowedCallers.getOptional("allowed_callers")
+
             /**
              * Whether this function should be deferred and discovered via tool search.
              *
@@ -608,6 +636,15 @@ private constructor(
              */
             fun description(): Optional<String> = description.getOptional("description")
 
+            /**
+             * A JSON Schema describing the JSON value encoded in string outputs for this function
+             * tool. This does not describe content-array outputs.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun outputSchema(): Optional<OutputSchema> = outputSchema.getOptional("output_schema")
+
             /**
              * This arbitrary value can be deserialized into a custom type using the `convert`
              * method:
@@ -618,6 +655,10 @@ private constructor(
             @JsonProperty("parameters") @ExcludeMissing fun _parameters(): JsonValue = parameters
 
             /**
+             * Whether to enforce strict parameter validation. If omitted, Responses attempts to use
+             * strict validation when the schema is compatible, and falls back to non-strict
+             * validation otherwise.
+             *
              * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
              *   the server responded with an unexpected value).
              */
@@ -630,6 +671,16 @@ private constructor(
              */
             @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
 
+            /**
+             * Returns the raw JSON value of [allowedCallers].
+             *
+             * Unlike [allowedCallers], this method doesn't throw if the JSON field has an
+             * unexpected type.
+             */
+            @JsonProperty("allowed_callers")
+            @ExcludeMissing
+            fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
             /**
              * Returns the raw JSON value of [deferLoading].
              *
@@ -650,6 +701,16 @@ private constructor(
             @ExcludeMissing
             fun _description(): JsonField<String> = description
 
+            /**
+             * Returns the raw JSON value of [outputSchema].
+             *
+             * Unlike [outputSchema], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("output_schema")
+            @ExcludeMissing
+            fun _outputSchema(): JsonField<OutputSchema> = outputSchema
+
             /**
              * Returns the raw JSON value of [strict].
              *
@@ -687,8 +748,10 @@ private constructor(
 
                 private var name: JsonField<String>? = null
                 private var type: JsonValue = JsonValue.from("function")
+                private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
                 private var deferLoading: JsonField<Boolean> = JsonMissing.of()
                 private var description: JsonField<String> = JsonMissing.of()
+                private var outputSchema: JsonField<OutputSchema> = JsonMissing.of()
                 private var parameters: JsonValue = JsonMissing.of()
                 private var strict: JsonField<Boolean> = JsonMissing.of()
                 private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
@@ -697,8 +760,10 @@ private constructor(
                 internal fun from(function: Function) = apply {
                     name = function.name
                     type = function.type
+                    allowedCallers = function.allowedCallers.map { it.toMutableList() }
                     deferLoading = function.deferLoading
                     description = function.description
+                    outputSchema = function.outputSchema
                     parameters = function.parameters
                     strict = function.strict
                     additionalProperties = function.additionalProperties.toMutableMap()
@@ -729,6 +794,39 @@ private constructor(
                  */
                 fun type(type: JsonValue) = apply { this.type = type }
 
+                /** The tool invocation context(s). */
+                fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+                    allowedCallers(JsonField.ofNullable(allowedCallers))
+
+                /**
+                 * Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`.
+                 */
+                fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+                    allowedCallers(allowedCallers.getOrNull())
+
+                /**
+                 * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.allowedCallers] with a well-typed
+                 * `List<AllowedCaller>` value instead. This method is primarily for setting the
+                 * field to an undocumented or not yet supported value.
+                 */
+                fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+                    this.allowedCallers = allowedCallers.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [AllowedCaller] to [allowedCallers].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+                    allowedCallers =
+                        (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("allowedCallers", it).add(allowedCaller)
+                        }
+                }
+
                 /** Whether this function should be deferred and discovered via tool search. */
                 fun deferLoading(deferLoading: Boolean) = deferLoading(JsonField.of(deferLoading))
 
@@ -761,8 +859,35 @@ private constructor(
                     this.description = description
                 }
 
+                /**
+                 * A JSON Schema describing the JSON value encoded in string outputs for this
+                 * function tool. This does not describe content-array outputs.
+                 */
+                fun outputSchema(outputSchema: OutputSchema?) =
+                    outputSchema(JsonField.ofNullable(outputSchema))
+
+                /** Alias for calling [Builder.outputSchema] with `outputSchema.orElse(null)`. */
+                fun outputSchema(outputSchema: Optional<OutputSchema>) =
+                    outputSchema(outputSchema.getOrNull())
+
+                /**
+                 * Sets [Builder.outputSchema] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.outputSchema] with a well-typed [OutputSchema]
+                 * value instead. This method is primarily for setting the field to an undocumented
+                 * or not yet supported value.
+                 */
+                fun outputSchema(outputSchema: JsonField<OutputSchema>) = apply {
+                    this.outputSchema = outputSchema
+                }
+
                 fun parameters(parameters: JsonValue) = apply { this.parameters = parameters }
 
+                /**
+                 * Whether to enforce strict parameter validation. If omitted, Responses attempts to
+                 * use strict validation when the schema is compatible, and falls back to non-strict
+                 * validation otherwise.
+                 */
                 fun strict(strict: Boolean?) = strict(JsonField.ofNullable(strict))
 
                 /**
@@ -822,8 +947,10 @@ private constructor(
                     Function(
                         checkRequired("name", name),
                         type,
+                        (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
                         deferLoading,
                         description,
+                        outputSchema,
                         parameters,
                         strict,
                         additionalProperties.toMutableMap(),
@@ -853,8 +980,10 @@ private constructor(
                         throw OpenAIInvalidDataException("'type' is invalid, received $it")
                     }
                 }
+                allowedCallers().ifPresent { it.forEach { it.validate() } }
                 deferLoading()
                 description()
+                outputSchema().ifPresent { it.validate() }
                 strict()
                 validated = true
             }
@@ -877,10 +1006,274 @@ private constructor(
             internal fun validity(): Int =
                 (if (name.asKnown().isPresent) 1 else 0) +
                     type.let { if (it == JsonValue.from("function")) 1 else 0 } +
+                    (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
                     (if (deferLoading.asKnown().isPresent) 1 else 0) +
                     (if (description.asKnown().isPresent) 1 else 0) +
+                    (outputSchema.asKnown().getOrNull()?.validity() ?: 0) +
                     (if (strict.asKnown().isPresent) 1 else 0)
 
+            class AllowedCaller
+            @JsonCreator
+            private constructor(private val value: JsonField<String>) : Enum {
+
+                /**
+                 * Returns this class instance's raw value.
+                 *
+                 * This is usually only useful if this instance was deserialized from data that
+                 * doesn't match any known member, and you want to know that value. For example, if
+                 * the SDK is on an older version than the API, then the API may respond with new
+                 * members that the SDK is unaware of.
+                 */
+                @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+                companion object {
+
+                    @JvmField val DIRECT = of("direct")
+
+                    @JvmField val PROGRAMMATIC = of("programmatic")
+
+                    @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+                }
+
+                /** An enum containing [AllowedCaller]'s known values. */
+                enum class Known {
+                    DIRECT,
+                    PROGRAMMATIC,
+                }
+
+                /**
+                 * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN]
+                 * member.
+                 *
+                 * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+                 * - It was deserialized from data that doesn't match any known member. For example,
+                 *   if the SDK is on an older version than the API, then the API may respond with
+                 *   new members that the SDK is unaware of.
+                 * - It was constructed with an arbitrary value using the [of] method.
+                 */
+                enum class Value {
+                    DIRECT,
+                    PROGRAMMATIC,
+                    /**
+                     * An enum member indicating that [AllowedCaller] was instantiated with an
+                     * unknown value.
+                     */
+                    _UNKNOWN,
+                }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value, or
+                 * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                 *
+                 * Use the [known] method instead if you're certain the value is always known or if
+                 * you want to throw for the unknown case.
+                 */
+                fun value(): Value =
+                    when (this) {
+                        DIRECT -> Value.DIRECT
+                        PROGRAMMATIC -> Value.PROGRAMMATIC
+                        else -> Value._UNKNOWN
+                    }
+
+                /**
+                 * Returns an enum member corresponding to this class instance's value.
+                 *
+                 * Use the [value] method instead if you're uncertain the value is always known and
+                 * don't want to throw for the unknown case.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                 *   known member.
+                 */
+                fun known(): Known =
+                    when (this) {
+                        DIRECT -> Known.DIRECT
+                        PROGRAMMATIC -> Known.PROGRAMMATIC
+                        else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+                    }
+
+                /**
+                 * Returns this class instance's primitive wire representation.
+                 *
+                 * This differs from the [toString] method because that method is primarily for
+                 * debugging and generally doesn't throw.
+                 *
+                 * @throws OpenAIInvalidDataException if this class instance's value does not have
+                 *   the expected primitive type.
+                 */
+                fun asString(): String =
+                    _value().asString().orElseThrow {
+                        OpenAIInvalidDataException("Value is not a String")
+                    }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): AllowedCaller = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    known()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is AllowedCaller && value == other.value
+                }
+
+                override fun hashCode() = value.hashCode()
+
+                override fun toString() = value.toString()
+            }
+
+            /**
+             * A JSON Schema describing the JSON value encoded in string outputs for this function
+             * tool. This does not describe content-array outputs.
+             */
+            class OutputSchema
+            @JsonCreator
+            private constructor(
+                @com.fasterxml.jackson.annotation.JsonValue
+                private val additionalProperties: Map<String, JsonValue>
+            ) {
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /** Returns a mutable builder for constructing an instance of [OutputSchema]. */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [OutputSchema]. */
+                class Builder internal constructor() {
+
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(outputSchema: OutputSchema) = apply {
+                        additionalProperties = outputSchema.additionalProperties.toMutableMap()
+                    }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [OutputSchema].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     */
+                    fun build(): OutputSchema = OutputSchema(additionalProperties.toImmutable())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): OutputSchema = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    additionalProperties.count { (_, value) ->
+                        !value.isNull() && !value.isMissing()
+                    }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is OutputSchema &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() = "OutputSchema{additionalProperties=$additionalProperties}"
+            }
+
             override fun equals(other: Any?): Boolean {
                 if (this === other) {
                     return true
@@ -889,8 +1282,10 @@ private constructor(
                 return other is Function &&
                     name == other.name &&
                     type == other.type &&
+                    allowedCallers == other.allowedCallers &&
                     deferLoading == other.deferLoading &&
                     description == other.description &&
+                    outputSchema == other.outputSchema &&
                     parameters == other.parameters &&
                     strict == other.strict &&
                     additionalProperties == other.additionalProperties
@@ -900,8 +1295,10 @@ private constructor(
                 Objects.hash(
                     name,
                     type,
+                    allowedCallers,
                     deferLoading,
                     description,
+                    outputSchema,
                     parameters,
                     strict,
                     additionalProperties,
@@ -911,7 +1308,7 @@ private constructor(
             override fun hashCode(): Int = hashCode
 
             override fun toString() =
-                "Function{name=$name, type=$type, deferLoading=$deferLoading, description=$description, parameters=$parameters, strict=$strict, additionalProperties=$additionalProperties}"
+                "Function{name=$name, type=$type, allowedCallers=$allowedCallers, deferLoading=$deferLoading, description=$description, outputSchema=$outputSchema, parameters=$parameters, strict=$strict, additionalProperties=$additionalProperties}"
         }
     }
 
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/Response.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/Response.kt
index 2fc710c14..6395fc45a 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/Response.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/Response.kt
@@ -60,6 +60,7 @@ private constructor(
     private val previousResponseId: JsonField<String>,
     private val prompt: JsonField<ResponsePrompt>,
     private val promptCacheKey: JsonField<String>,
+    private val promptCacheOptions: JsonField<PromptCacheOptions>,
     private val promptCacheRetention: JsonField<PromptCacheRetention>,
     private val reasoning: JsonField<Reasoning>,
     private val safetyIdentifier: JsonField<String>,
@@ -128,6 +129,9 @@ private constructor(
         @JsonProperty("prompt_cache_key")
         @ExcludeMissing
         promptCacheKey: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("prompt_cache_options")
+        @ExcludeMissing
+        promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of(),
         @JsonProperty("prompt_cache_retention")
         @ExcludeMissing
         promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of(),
@@ -178,6 +182,7 @@ private constructor(
         previousResponseId,
         prompt,
         promptCacheKey,
+        promptCacheOptions,
         promptCacheRetention,
         reasoning,
         safetyIdentifier,
@@ -434,10 +439,24 @@ private constructor(
     fun promptCacheKey(): Optional<String> = promptCacheKey.getOptional("prompt_cache_key")
 
     /**
+     * The prompt-caching options that were applied to the response. Supported for `gpt-5.6` and
+     * later models.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheOptions(): Optional<PromptCacheOptions> =
+        promptCacheOptions.getOptional("prompt_cache_options")
+
+    /**
+     * Deprecated. Use `prompt_cache_options.ttl` instead.
+     *
      * The retention policy for the prompt cache. Set to `24h` to enable extended prompt caching,
      * which keeps cached prefixes active for longer, up to a maximum of 24 hours.
      * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
-     * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+     * This field expresses a maximum retention policy, while `prompt_cache_options.ttl` expresses a
+     * minimum cache lifetime. The two fields are independent and do not interact. For `gpt-5.5`,
+     * `gpt-5.5-pro`, and future models, only `24h` is supported.
      *
      * For older models that support both `in_memory` and `24h`, the default depends on your
      * organization's data retention policy:
@@ -448,6 +467,7 @@ private constructor(
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
+    @Deprecated("deprecated")
     fun promptCacheRetention(): Optional<PromptCacheRetention> =
         promptCacheRetention.getOptional("prompt_cache_retention")
 
@@ -739,12 +759,23 @@ private constructor(
     @ExcludeMissing
     fun _promptCacheKey(): JsonField<String> = promptCacheKey
 
+    /**
+     * Returns the raw JSON value of [promptCacheOptions].
+     *
+     * Unlike [promptCacheOptions], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_options")
+    @ExcludeMissing
+    fun _promptCacheOptions(): JsonField<PromptCacheOptions> = promptCacheOptions
+
     /**
      * Returns the raw JSON value of [promptCacheRetention].
      *
      * Unlike [promptCacheRetention], this method doesn't throw if the JSON field has an unexpected
      * type.
      */
+    @Deprecated("deprecated")
     @JsonProperty("prompt_cache_retention")
     @ExcludeMissing
     fun _promptCacheRetention(): JsonField<PromptCacheRetention> = promptCacheRetention
@@ -885,6 +916,7 @@ private constructor(
         private var previousResponseId: JsonField<String> = JsonMissing.of()
         private var prompt: JsonField<ResponsePrompt> = JsonMissing.of()
         private var promptCacheKey: JsonField<String> = JsonMissing.of()
+        private var promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of()
         private var promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of()
         private var reasoning: JsonField<Reasoning> = JsonMissing.of()
         private var safetyIdentifier: JsonField<String> = JsonMissing.of()
@@ -922,6 +954,7 @@ private constructor(
             previousResponseId = response.previousResponseId
             prompt = response.prompt
             promptCacheKey = response.promptCacheKey
+            promptCacheOptions = response.promptCacheOptions
             promptCacheRetention = response.promptCacheRetention
             reasoning = response.reasoning
             safetyIdentifier = response.safetyIdentifier
@@ -1161,6 +1194,16 @@ private constructor(
         fun addOutput(reasoning: ResponseReasoningItem) =
             addOutput(ResponseOutputItem.ofReasoning(reasoning))
 
+        /** Alias for calling [addOutput] with `ResponseOutputItem.ofProgram(program)`. */
+        fun addOutput(program: ResponseOutputItem.Program) =
+            addOutput(ResponseOutputItem.ofProgram(program))
+
+        /**
+         * Alias for calling [addOutput] with `ResponseOutputItem.ofProgramOutput(programOutput)`.
+         */
+        fun addOutput(programOutput: ResponseOutputItem.ProgramOutput) =
+            addOutput(ResponseOutputItem.ofProgramOutput(programOutput))
+
         /**
          * Alias for calling [addOutput] with `ResponseOutputItem.ofToolSearchCall(toolSearchCall)`.
          */
@@ -1345,6 +1388,13 @@ private constructor(
         /** Alias for calling [toolChoice] with `ToolChoice.ofCustom(custom)`. */
         fun toolChoice(custom: ToolChoiceCustom) = toolChoice(ToolChoice.ofCustom(custom))
 
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofSpecificProgrammaticToolCallingParam()`.
+         */
+        fun toolChoiceSpecificProgrammaticToolCallingParam() =
+            toolChoice(ToolChoice.ofSpecificProgrammaticToolCallingParam())
+
         /** Alias for calling [toolChoice] with `ToolChoice.ofApplyPatch(applyPatch)`. */
         fun toolChoice(applyPatch: ToolChoiceApplyPatch) =
             toolChoice(ToolChoice.ofApplyPatch(applyPatch))
@@ -1467,6 +1517,9 @@ private constructor(
                 Tool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)
             )
 
+        /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+        fun addToolProgrammaticToolCalling() = addTool(Tool.ofProgrammaticToolCalling())
+
         /** Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`. */
         fun addTool(imageGeneration: Tool.ImageGeneration) =
             addTool(Tool.ofImageGeneration(imageGeneration))
@@ -1739,9 +1792,31 @@ private constructor(
         }
 
         /**
+         * The prompt-caching options that were applied to the response. Supported for `gpt-5.6` and
+         * later models.
+         */
+        fun promptCacheOptions(promptCacheOptions: PromptCacheOptions) =
+            promptCacheOptions(JsonField.of(promptCacheOptions))
+
+        /**
+         * Sets [Builder.promptCacheOptions] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheOptions] with a well-typed
+         * [PromptCacheOptions] value instead. This method is primarily for setting the field to an
+         * undocumented or not yet supported value.
+         */
+        fun promptCacheOptions(promptCacheOptions: JsonField<PromptCacheOptions>) = apply {
+            this.promptCacheOptions = promptCacheOptions
+        }
+
+        /**
+         * Deprecated. Use `prompt_cache_options.ttl` instead.
+         *
          * The retention policy for the prompt cache. Set to `24h` to enable extended prompt
          * caching, which keeps cached prefixes active for longer, up to a maximum of 24 hours.
          * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+         * This field expresses a maximum retention policy, while `prompt_cache_options.ttl`
+         * expresses a minimum cache lifetime. The two fields are independent and do not interact.
          * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
          *
          * For older models that support both `in_memory` and `24h`, the default depends on your
@@ -1750,6 +1825,7 @@ private constructor(
          * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is
          *   not specified.
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(promptCacheRetention: PromptCacheRetention?) =
             promptCacheRetention(JsonField.ofNullable(promptCacheRetention))
 
@@ -1757,6 +1833,7 @@ private constructor(
          * Alias for calling [Builder.promptCacheRetention] with
          * `promptCacheRetention.orElse(null)`.
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(promptCacheRetention: Optional<PromptCacheRetention>) =
             promptCacheRetention(promptCacheRetention.getOrNull())
 
@@ -1767,6 +1844,7 @@ private constructor(
          * [PromptCacheRetention] value instead. This method is primarily for setting the field to
          * an undocumented or not yet supported value.
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(promptCacheRetention: JsonField<PromptCacheRetention>) = apply {
             this.promptCacheRetention = promptCacheRetention
         }
@@ -2023,6 +2101,7 @@ private constructor(
                 previousResponseId,
                 prompt,
                 promptCacheKey,
+                promptCacheOptions,
                 promptCacheRetention,
                 reasoning,
                 safetyIdentifier,
@@ -2079,6 +2158,7 @@ private constructor(
         previousResponseId()
         prompt().ifPresent { it.validate() }
         promptCacheKey()
+        promptCacheOptions().ifPresent { it.validate() }
         promptCacheRetention().ifPresent { it.validate() }
         reasoning().ifPresent { it.validate() }
         safetyIdentifier()
@@ -2130,6 +2210,7 @@ private constructor(
             (if (previousResponseId.asKnown().isPresent) 1 else 0) +
             (prompt.asKnown().getOrNull()?.validity() ?: 0) +
             (if (promptCacheKey.asKnown().isPresent) 1 else 0) +
+            (promptCacheOptions.asKnown().getOrNull()?.validity() ?: 0) +
             (promptCacheRetention.asKnown().getOrNull()?.validity() ?: 0) +
             (reasoning.asKnown().getOrNull()?.validity() ?: 0) +
             (if (safetyIdentifier.asKnown().isPresent) 1 else 0) +
@@ -2797,6 +2878,7 @@ private constructor(
         private val function: ToolChoiceFunction? = null,
         private val mcp: ToolChoiceMcp? = null,
         private val custom: ToolChoiceCustom? = null,
+        private val specificProgrammaticToolCallingParam: JsonValue? = null,
         private val applyPatch: ToolChoiceApplyPatch? = null,
         private val shell: ToolChoiceShell? = null,
         private val _json: JsonValue? = null,
@@ -2832,6 +2914,9 @@ private constructor(
         /** Use this option to force the model to call a specific custom tool. */
         fun custom(): Optional<ToolChoiceCustom> = Optional.ofNullable(custom)
 
+        fun specificProgrammaticToolCallingParam(): Optional<JsonValue> =
+            Optional.ofNullable(specificProgrammaticToolCallingParam)
+
         /** Forces the model to call the apply_patch tool when executing a tool call. */
         fun applyPatch(): Optional<ToolChoiceApplyPatch> = Optional.ofNullable(applyPatch)
 
@@ -2850,6 +2935,9 @@ private constructor(
 
         fun isCustom(): Boolean = custom != null
 
+        fun isSpecificProgrammaticToolCallingParam(): Boolean =
+            specificProgrammaticToolCallingParam != null
+
         fun isApplyPatch(): Boolean = applyPatch != null
 
         fun isShell(): Boolean = shell != null
@@ -2884,6 +2972,9 @@ private constructor(
         /** Use this option to force the model to call a specific custom tool. */
         fun asCustom(): ToolChoiceCustom = custom.getOrThrow("custom")
 
+        fun asSpecificProgrammaticToolCallingParam(): JsonValue =
+            specificProgrammaticToolCallingParam.getOrThrow("specificProgrammaticToolCallingParam")
+
         /** Forces the model to call the apply_patch tool when executing a tool call. */
         fun asApplyPatch(): ToolChoiceApplyPatch = applyPatch.getOrThrow("applyPatch")
 
@@ -2929,6 +3020,10 @@ private constructor(
                 function != null -> visitor.visitFunction(function)
                 mcp != null -> visitor.visitMcp(mcp)
                 custom != null -> visitor.visitCustom(custom)
+                specificProgrammaticToolCallingParam != null ->
+                    visitor.visitSpecificProgrammaticToolCallingParam(
+                        specificProgrammaticToolCallingParam
+                    )
                 applyPatch != null -> visitor.visitApplyPatch(applyPatch)
                 shell != null -> visitor.visitShell(shell)
                 else -> visitor.unknown(_json)
@@ -2976,6 +3071,20 @@ private constructor(
                         custom.validate()
                     }
 
+                    override fun visitSpecificProgrammaticToolCallingParam(
+                        specificProgrammaticToolCallingParam: JsonValue
+                    ) {
+                        specificProgrammaticToolCallingParam.let {
+                            if (
+                                it != JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                            ) {
+                                throw OpenAIInvalidDataException(
+                                    "'specificProgrammaticToolCallingParam' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
                     override fun visitApplyPatch(applyPatch: ToolChoiceApplyPatch) {
                         applyPatch.validate()
                     }
@@ -3018,6 +3127,15 @@ private constructor(
 
                     override fun visitCustom(custom: ToolChoiceCustom) = custom.validity()
 
+                    override fun visitSpecificProgrammaticToolCallingParam(
+                        specificProgrammaticToolCallingParam: JsonValue
+                    ) =
+                        specificProgrammaticToolCallingParam.let {
+                            if (it == JsonValue.from(mapOf("type" to "programmatic_tool_calling")))
+                                1
+                            else 0
+                        }
+
                     override fun visitApplyPatch(applyPatch: ToolChoiceApplyPatch) =
                         applyPatch.validity()
 
@@ -3039,12 +3157,24 @@ private constructor(
                 function == other.function &&
                 mcp == other.mcp &&
                 custom == other.custom &&
+                specificProgrammaticToolCallingParam ==
+                    other.specificProgrammaticToolCallingParam &&
                 applyPatch == other.applyPatch &&
                 shell == other.shell
         }
 
         override fun hashCode(): Int =
-            Objects.hash(options, allowed, types, function, mcp, custom, applyPatch, shell)
+            Objects.hash(
+                options,
+                allowed,
+                types,
+                function,
+                mcp,
+                custom,
+                specificProgrammaticToolCallingParam,
+                applyPatch,
+                shell,
+            )
 
         override fun toString(): String =
             when {
@@ -3054,6 +3184,8 @@ private constructor(
                 function != null -> "ToolChoice{function=$function}"
                 mcp != null -> "ToolChoice{mcp=$mcp}"
                 custom != null -> "ToolChoice{custom=$custom}"
+                specificProgrammaticToolCallingParam != null ->
+                    "ToolChoice{specificProgrammaticToolCallingParam=$specificProgrammaticToolCallingParam}"
                 applyPatch != null -> "ToolChoice{applyPatch=$applyPatch}"
                 shell != null -> "ToolChoice{shell=$shell}"
                 _json != null -> "ToolChoice{_unknown=$_json}"
@@ -3095,6 +3227,13 @@ private constructor(
             /** Use this option to force the model to call a specific custom tool. */
             @JvmStatic fun ofCustom(custom: ToolChoiceCustom) = ToolChoice(custom = custom)
 
+            @JvmStatic
+            fun ofSpecificProgrammaticToolCallingParam() =
+                ToolChoice(
+                    specificProgrammaticToolCallingParam =
+                        JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                )
+
             /** Forces the model to call the apply_patch tool when executing a tool call. */
             @JvmStatic
             fun ofApplyPatch(applyPatch: ToolChoiceApplyPatch) = ToolChoice(applyPatch = applyPatch)
@@ -3140,6 +3279,10 @@ private constructor(
             /** Use this option to force the model to call a specific custom tool. */
             fun visitCustom(custom: ToolChoiceCustom): T
 
+            fun visitSpecificProgrammaticToolCallingParam(
+                specificProgrammaticToolCallingParam: JsonValue
+            ): T
+
             /** Forces the model to call the apply_patch tool when executing a tool call. */
             fun visitApplyPatch(applyPatch: ToolChoiceApplyPatch): T
 
@@ -3168,6 +3311,14 @@ private constructor(
 
                 val bestMatches =
                     sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let {
+                                    ToolChoice(
+                                        specificProgrammaticToolCallingParam = it,
+                                        _json = json,
+                                    )
+                                }
+                                ?.takeIf { it.isValid() },
                             tryDeserialize(node, jacksonTypeRef<ToolChoiceOptions>())?.let {
                                 ToolChoice(options = it, _json = json)
                             },
@@ -3223,6 +3374,8 @@ private constructor(
                     value.function != null -> generator.writeObject(value.function)
                     value.mcp != null -> generator.writeObject(value.mcp)
                     value.custom != null -> generator.writeObject(value.custom)
+                    value.specificProgrammaticToolCallingParam != null ->
+                        generator.writeObject(value.specificProgrammaticToolCallingParam)
                     value.applyPatch != null -> generator.writeObject(value.applyPatch)
                     value.shell != null -> generator.writeObject(value.shell)
                     value._json != null -> generator.writeObject(value._json)
@@ -6194,10 +6347,495 @@ private constructor(
     }
 
     /**
+     * The prompt-caching options that were applied to the response. Supported for `gpt-5.6` and
+     * later models.
+     */
+    class PromptCacheOptions
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonField<Mode>,
+        private val ttl: JsonField<Ttl>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of(),
+            @JsonProperty("ttl") @ExcludeMissing ttl: JsonField<Ttl> = JsonMissing.of(),
+        ) : this(mode, ttl, mutableMapOf())
+
+        /**
+         * Whether implicit prompt-cache breakpoints were enabled.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun mode(): Mode = mode.getRequired("mode")
+
+        /**
+         * The minimum lifetime applied to each cache breakpoint.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun ttl(): Ttl = ttl.getRequired("ttl")
+
+        /**
+         * Returns the raw JSON value of [mode].
+         *
+         * Unlike [mode], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+        /**
+         * Returns the raw JSON value of [ttl].
+         *
+         * Unlike [ttl], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("ttl") @ExcludeMissing fun _ttl(): JsonField<Ttl> = ttl
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheOptions].
+             *
+             * The following fields are required:
+             * ```java
+             * .mode()
+             * .ttl()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheOptions]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonField<Mode>? = null
+            private var ttl: JsonField<Ttl>? = null
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheOptions: PromptCacheOptions) = apply {
+                mode = promptCacheOptions.mode
+                ttl = promptCacheOptions.ttl
+                additionalProperties = promptCacheOptions.additionalProperties.toMutableMap()
+            }
+
+            /** Whether implicit prompt-cache breakpoints were enabled. */
+            fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+            /**
+             * Sets [Builder.mode] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.mode] with a well-typed [Mode] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+            /** The minimum lifetime applied to each cache breakpoint. */
+            fun ttl(ttl: Ttl) = ttl(JsonField.of(ttl))
+
+            /**
+             * Sets [Builder.ttl] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.ttl] with a well-typed [Ttl] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun ttl(ttl: JsonField<Ttl>) = apply { this.ttl = ttl }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheOptions].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .mode()
+             * .ttl()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): PromptCacheOptions =
+                PromptCacheOptions(
+                    checkRequired("mode", mode),
+                    checkRequired("ttl", ttl),
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheOptions = apply {
+            if (validated) {
+                return@apply
+            }
+
+            mode().validate()
+            ttl().validate()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (mode.asKnown().getOrNull()?.validity() ?: 0) +
+                (ttl.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** Whether implicit prompt-cache breakpoints were enabled. */
+        class Mode @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IMPLICIT = of("implicit")
+
+                @JvmField val EXPLICIT = of("explicit")
+
+                @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+            }
+
+            /** An enum containing [Mode]'s known values. */
+            enum class Known {
+                IMPLICIT,
+                EXPLICIT,
+            }
+
+            /**
+             * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Mode] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IMPLICIT,
+                EXPLICIT,
+                /** An enum member indicating that [Mode] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IMPLICIT -> Value.IMPLICIT
+                    EXPLICIT -> Value.EXPLICIT
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IMPLICIT -> Known.IMPLICIT
+                    EXPLICIT -> Known.EXPLICIT
+                    else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Mode = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Mode && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /** The minimum lifetime applied to each cache breakpoint. */
+        class Ttl @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val _30M = of("30m")
+
+                @JvmStatic fun of(value: String) = Ttl(JsonField.of(value))
+            }
+
+            /** An enum containing [Ttl]'s known values. */
+            enum class Known {
+                _30M
+            }
+
+            /**
+             * An enum containing [Ttl]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Ttl] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                _30M,
+                /** An enum member indicating that [Ttl] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    _30M -> Value._30M
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    _30M -> Known._30M
+                    else -> throw OpenAIInvalidDataException("Unknown Ttl: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Ttl = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Ttl && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheOptions &&
+                mode == other.mode &&
+                ttl == other.ttl &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, ttl, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheOptions{mode=$mode, ttl=$ttl, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Deprecated. Use `prompt_cache_options.ttl` instead.
+     *
      * The retention policy for the prompt cache. Set to `24h` to enable extended prompt caching,
      * which keeps cached prefixes active for longer, up to a maximum of 24 hours.
      * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
-     * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+     * This field expresses a maximum retention policy, while `prompt_cache_options.ttl` expresses a
+     * minimum cache lifetime. The two fields are independent and do not interact. For `gpt-5.5`,
+     * `gpt-5.5-pro`, and future models, only `24h` is supported.
      *
      * For older models that support both `in_memory` and `24h`, the default depends on your
      * organization's data retention policy:
@@ -6205,6 +6843,7 @@ private constructor(
      * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is not
      *   specified.
      */
+    @Deprecated("deprecated")
     class PromptCacheRetention
     @JsonCreator
     private constructor(private val value: JsonField<String>) : Enum {
@@ -6688,6 +7327,7 @@ private constructor(
             previousResponseId == other.previousResponseId &&
             prompt == other.prompt &&
             promptCacheKey == other.promptCacheKey &&
+            promptCacheOptions == other.promptCacheOptions &&
             promptCacheRetention == other.promptCacheRetention &&
             reasoning == other.reasoning &&
             safetyIdentifier == other.safetyIdentifier &&
@@ -6726,6 +7366,7 @@ private constructor(
             previousResponseId,
             prompt,
             promptCacheKey,
+            promptCacheOptions,
             promptCacheRetention,
             reasoning,
             safetyIdentifier,
@@ -6743,5 +7384,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "Response{id=$id, createdAt=$createdAt, error=$error, incompleteDetails=$incompleteDetails, instructions=$instructions, metadata=$metadata, model=$model, object_=$object_, output=$output, parallelToolCalls=$parallelToolCalls, temperature=$temperature, toolChoice=$toolChoice, tools=$tools, topP=$topP, background=$background, completedAt=$completedAt, conversation=$conversation, maxOutputTokens=$maxOutputTokens, maxToolCalls=$maxToolCalls, moderation=$moderation, previousResponseId=$previousResponseId, prompt=$prompt, promptCacheKey=$promptCacheKey, promptCacheRetention=$promptCacheRetention, reasoning=$reasoning, safetyIdentifier=$safetyIdentifier, serviceTier=$serviceTier, status=$status, text=$text, topLogprobs=$topLogprobs, truncation=$truncation, usage=$usage, user=$user, additionalProperties=$additionalProperties}"
+        "Response{id=$id, createdAt=$createdAt, error=$error, incompleteDetails=$incompleteDetails, instructions=$instructions, metadata=$metadata, model=$model, object_=$object_, output=$output, parallelToolCalls=$parallelToolCalls, temperature=$temperature, toolChoice=$toolChoice, tools=$tools, topP=$topP, background=$background, completedAt=$completedAt, conversation=$conversation, maxOutputTokens=$maxOutputTokens, maxToolCalls=$maxToolCalls, moderation=$moderation, previousResponseId=$previousResponseId, prompt=$prompt, promptCacheKey=$promptCacheKey, promptCacheOptions=$promptCacheOptions, promptCacheRetention=$promptCacheRetention, reasoning=$reasoning, safetyIdentifier=$safetyIdentifier, serviceTier=$serviceTier, status=$status, text=$text, topLogprobs=$topLogprobs, truncation=$truncation, usage=$usage, user=$user, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseApplyPatchToolCall.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseApplyPatchToolCall.kt
index 887288bc6..9302528bb 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseApplyPatchToolCall.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseApplyPatchToolCall.kt
@@ -37,6 +37,7 @@ private constructor(
     private val operation: JsonField<Operation>,
     private val status: JsonField<Status>,
     private val type: JsonValue,
+    private val caller: JsonField<Caller>,
     private val createdBy: JsonField<String>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
@@ -50,8 +51,9 @@ private constructor(
         operation: JsonField<Operation> = JsonMissing.of(),
         @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
         @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
-    ) : this(id, callId, operation, status, type, createdBy, mutableMapOf())
+    ) : this(id, callId, operation, status, type, caller, createdBy, mutableMapOf())
 
     /**
      * The unique ID of the apply patch tool call. Populated when this item is returned via API.
@@ -98,6 +100,14 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<Caller> = caller.getOptional("caller")
+
     /**
      * The ID of the entity that created this tool call.
      *
@@ -134,6 +144,13 @@ private constructor(
      */
     @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
 
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
     /**
      * Returns the raw JSON value of [createdBy].
      *
@@ -177,6 +194,7 @@ private constructor(
         private var operation: JsonField<Operation>? = null
         private var status: JsonField<Status>? = null
         private var type: JsonValue = JsonValue.from("apply_patch_call")
+        private var caller: JsonField<Caller> = JsonMissing.of()
         private var createdBy: JsonField<String> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
@@ -187,6 +205,7 @@ private constructor(
             operation = responseApplyPatchToolCall.operation
             status = responseApplyPatchToolCall.status
             type = responseApplyPatchToolCall.type
+            caller = responseApplyPatchToolCall.caller
             createdBy = responseApplyPatchToolCall.createdBy
             additionalProperties = responseApplyPatchToolCall.additionalProperties.toMutableMap()
         }
@@ -277,6 +296,37 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /** The execution context that produced this tool call. */
+        fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed [Caller] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+        /** Alias for calling [caller] with `Caller.ofDirect()`. */
+        fun callerDirect() = caller(Caller.ofDirect())
+
+        /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+        fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(Caller.Program.builder().callerId(callerId).build())
+
         /** The ID of the entity that created this tool call. */
         fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
 
@@ -330,6 +380,7 @@ private constructor(
                 checkRequired("operation", operation),
                 checkRequired("status", status),
                 type,
+                caller,
                 createdBy,
                 additionalProperties.toMutableMap(),
             )
@@ -359,6 +410,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        caller().ifPresent { it.validate() }
         createdBy()
         validated = true
     }
@@ -383,6 +435,7 @@ private constructor(
             (operation.asKnown().getOrNull()?.validity() ?: 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0) +
             type.let { if (it == JsonValue.from("apply_patch_call")) 1 else 0 } +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
             (if (createdBy.asKnown().isPresent) 1 else 0)
 
     /** One of the create_file, delete_file, or update_file operations applied via apply_patch. */
@@ -1490,6 +1543,431 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /** The execution context that produced this tool call. */
+    @JsonDeserialize(using = Caller.Deserializer::class)
+    @JsonSerialize(using = Caller.Serializer::class)
+    class Caller
+    private constructor(
+        private val direct: JsonValue? = null,
+        private val program: Program? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+        fun program(): Optional<Program> = Optional.ofNullable(program)
+
+        fun isDirect(): Boolean = direct != null
+
+        fun isProgram(): Boolean = program != null
+
+        fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+        fun asProgram(): Program = program.getOrThrow("program")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDirect(JsonValue direct) {
+         *         return Optional.of(direct.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                direct != null -> visitor.visitDirect(direct)
+                program != null -> visitor.visitProgram(program)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Caller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDirect(direct: JsonValue) {
+                        direct.let {
+                            if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'direct' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitProgram(program: Program) {
+                        program.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDirect(direct: JsonValue) =
+                        direct.let { if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0 }
+
+                    override fun visitProgram(program: Program) = program.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Caller && direct == other.direct && program == other.program
+        }
+
+        override fun hashCode(): Int = Objects.hash(direct, program)
+
+        override fun toString(): String =
+            when {
+                direct != null -> "Caller{direct=$direct}"
+                program != null -> "Caller{program=$program}"
+                _json != null -> "Caller{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Caller")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+            @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+        }
+
+        /** An interface that defines how to map each variant of [Caller] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitDirect(direct: JsonValue): T
+
+            fun visitProgram(program: Program): T
+
+            /**
+             * Maps an unknown variant of [Caller] to a value of type [T].
+             *
+             * An instance of [Caller] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Caller: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "direct" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Caller(direct = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                    }
+                    "program" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                            Caller(program = it, _json = json)
+                        } ?: Caller(_json = json)
+                    }
+                }
+
+                return Caller(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+            override fun serialize(
+                value: Caller,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.direct != null -> generator.writeObject(value.direct)
+                    value.program != null -> generator.writeObject(value.program)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+            }
+        }
+
+        class Program
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val callerId: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                callerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(callerId, type, mutableMapOf())
+
+            /**
+             * The call ID of the program item that produced this tool call.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun callerId(): String = callerId.getRequired("caller_id")
+
+            /**
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [callerId].
+             *
+             * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("caller_id") @ExcludeMissing fun _callerId(): JsonField<String> = callerId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Program].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Program]. */
+            class Builder internal constructor() {
+
+                private var callerId: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("program")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(program: Program) = apply {
+                    callerId = program.callerId
+                    type = program.type
+                    additionalProperties = program.additionalProperties.toMutableMap()
+                }
+
+                /** The call ID of the program item that produced this tool call. */
+                fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                /**
+                 * Sets [Builder.callerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.callerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Program].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Program =
+                    Program(
+                        checkRequired("callerId", callerId),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Program = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                callerId()
+                _type().let {
+                    if (it != JsonValue.from("program")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (callerId.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Program &&
+                    callerId == other.callerId &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(callerId, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -1501,16 +1979,17 @@ private constructor(
             operation == other.operation &&
             status == other.status &&
             type == other.type &&
+            caller == other.caller &&
             createdBy == other.createdBy &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(id, callId, operation, status, type, createdBy, additionalProperties)
+        Objects.hash(id, callId, operation, status, type, caller, createdBy, additionalProperties)
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseApplyPatchToolCall{id=$id, callId=$callId, operation=$operation, status=$status, type=$type, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+        "ResponseApplyPatchToolCall{id=$id, callId=$callId, operation=$operation, status=$status, type=$type, caller=$caller, createdBy=$createdBy, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseApplyPatchToolCallOutput.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseApplyPatchToolCallOutput.kt
index e6f757a3e..3e5b27e74 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseApplyPatchToolCallOutput.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseApplyPatchToolCallOutput.kt
@@ -6,12 +6,22 @@ import com.fasterxml.jackson.annotation.JsonAnyGetter
 import com.fasterxml.jackson.annotation.JsonAnySetter
 import com.fasterxml.jackson.annotation.JsonCreator
 import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
 import com.openai.core.Enum
 import com.openai.core.ExcludeMissing
 import com.openai.core.JsonField
 import com.openai.core.JsonMissing
 import com.openai.core.JsonValue
 import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
 import com.openai.errors.OpenAIInvalidDataException
 import java.util.Collections
 import java.util.Objects
@@ -26,6 +36,7 @@ private constructor(
     private val callId: JsonField<String>,
     private val status: JsonField<Status>,
     private val type: JsonValue,
+    private val caller: JsonField<Caller>,
     private val createdBy: JsonField<String>,
     private val output: JsonField<String>,
     private val additionalProperties: MutableMap<String, JsonValue>,
@@ -37,9 +48,10 @@ private constructor(
         @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
         @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
         @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
         @JsonProperty("output") @ExcludeMissing output: JsonField<String> = JsonMissing.of(),
-    ) : this(id, callId, status, type, createdBy, output, mutableMapOf())
+    ) : this(id, callId, status, type, caller, createdBy, output, mutableMapOf())
 
     /**
      * The unique ID of the apply patch tool call output. Populated when this item is returned via
@@ -79,6 +91,14 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<Caller> = caller.getOptional("caller")
+
     /**
      * The ID of the entity that created this tool call output.
      *
@@ -116,6 +136,13 @@ private constructor(
      */
     @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
 
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
     /**
      * Returns the raw JSON value of [createdBy].
      *
@@ -165,6 +192,7 @@ private constructor(
         private var callId: JsonField<String>? = null
         private var status: JsonField<Status>? = null
         private var type: JsonValue = JsonValue.from("apply_patch_call_output")
+        private var caller: JsonField<Caller> = JsonMissing.of()
         private var createdBy: JsonField<String> = JsonMissing.of()
         private var output: JsonField<String> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
@@ -176,6 +204,7 @@ private constructor(
                 callId = responseApplyPatchToolCallOutput.callId
                 status = responseApplyPatchToolCallOutput.status
                 type = responseApplyPatchToolCallOutput.type
+                caller = responseApplyPatchToolCallOutput.caller
                 createdBy = responseApplyPatchToolCallOutput.createdBy
                 output = responseApplyPatchToolCallOutput.output
                 additionalProperties =
@@ -232,6 +261,37 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /** The execution context that produced this tool call. */
+        fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed [Caller] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+        /** Alias for calling [caller] with `Caller.ofDirect()`. */
+        fun callerDirect() = caller(Caller.ofDirect())
+
+        /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+        fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(Caller.Program.builder().callerId(callerId).build())
+
         /** The ID of the entity that created this tool call output. */
         fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
 
@@ -297,6 +357,7 @@ private constructor(
                 checkRequired("callId", callId),
                 checkRequired("status", status),
                 type,
+                caller,
                 createdBy,
                 output,
                 additionalProperties.toMutableMap(),
@@ -326,6 +387,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        caller().ifPresent { it.validate() }
         createdBy()
         output()
         validated = true
@@ -350,6 +412,7 @@ private constructor(
             (if (callId.asKnown().isPresent) 1 else 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0) +
             type.let { if (it == JsonValue.from("apply_patch_call_output")) 1 else 0 } +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
             (if (createdBy.asKnown().isPresent) 1 else 0) +
             (if (output.asKnown().isPresent) 1 else 0)
 
@@ -488,6 +551,431 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /** The execution context that produced this tool call. */
+    @JsonDeserialize(using = Caller.Deserializer::class)
+    @JsonSerialize(using = Caller.Serializer::class)
+    class Caller
+    private constructor(
+        private val direct: JsonValue? = null,
+        private val program: Program? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+        fun program(): Optional<Program> = Optional.ofNullable(program)
+
+        fun isDirect(): Boolean = direct != null
+
+        fun isProgram(): Boolean = program != null
+
+        fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+        fun asProgram(): Program = program.getOrThrow("program")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDirect(JsonValue direct) {
+         *         return Optional.of(direct.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                direct != null -> visitor.visitDirect(direct)
+                program != null -> visitor.visitProgram(program)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Caller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDirect(direct: JsonValue) {
+                        direct.let {
+                            if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'direct' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitProgram(program: Program) {
+                        program.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDirect(direct: JsonValue) =
+                        direct.let { if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0 }
+
+                    override fun visitProgram(program: Program) = program.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Caller && direct == other.direct && program == other.program
+        }
+
+        override fun hashCode(): Int = Objects.hash(direct, program)
+
+        override fun toString(): String =
+            when {
+                direct != null -> "Caller{direct=$direct}"
+                program != null -> "Caller{program=$program}"
+                _json != null -> "Caller{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Caller")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+            @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+        }
+
+        /** An interface that defines how to map each variant of [Caller] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitDirect(direct: JsonValue): T
+
+            fun visitProgram(program: Program): T
+
+            /**
+             * Maps an unknown variant of [Caller] to a value of type [T].
+             *
+             * An instance of [Caller] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Caller: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "direct" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Caller(direct = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                    }
+                    "program" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                            Caller(program = it, _json = json)
+                        } ?: Caller(_json = json)
+                    }
+                }
+
+                return Caller(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+            override fun serialize(
+                value: Caller,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.direct != null -> generator.writeObject(value.direct)
+                    value.program != null -> generator.writeObject(value.program)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+            }
+        }
+
+        class Program
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val callerId: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                callerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(callerId, type, mutableMapOf())
+
+            /**
+             * The call ID of the program item that produced this tool call.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun callerId(): String = callerId.getRequired("caller_id")
+
+            /**
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [callerId].
+             *
+             * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("caller_id") @ExcludeMissing fun _callerId(): JsonField<String> = callerId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Program].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Program]. */
+            class Builder internal constructor() {
+
+                private var callerId: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("program")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(program: Program) = apply {
+                    callerId = program.callerId
+                    type = program.type
+                    additionalProperties = program.additionalProperties.toMutableMap()
+                }
+
+                /** The call ID of the program item that produced this tool call. */
+                fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                /**
+                 * Sets [Builder.callerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.callerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Program].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Program =
+                    Program(
+                        checkRequired("callerId", callerId),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Program = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                callerId()
+                _type().let {
+                    if (it != JsonValue.from("program")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (callerId.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Program &&
+                    callerId == other.callerId &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(callerId, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -498,17 +986,18 @@ private constructor(
             callId == other.callId &&
             status == other.status &&
             type == other.type &&
+            caller == other.caller &&
             createdBy == other.createdBy &&
             output == other.output &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(id, callId, status, type, createdBy, output, additionalProperties)
+        Objects.hash(id, callId, status, type, caller, createdBy, output, additionalProperties)
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseApplyPatchToolCallOutput{id=$id, callId=$callId, status=$status, type=$type, createdBy=$createdBy, output=$output, additionalProperties=$additionalProperties}"
+        "ResponseApplyPatchToolCallOutput{id=$id, callId=$callId, status=$status, type=$type, caller=$caller, createdBy=$createdBy, output=$output, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCompactParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCompactParams.kt
index 25a97fdbb..4d1ca3761 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCompactParams.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCompactParams.kt
@@ -97,12 +97,28 @@ private constructor(
      */
     fun promptCacheKey(): Optional<String> = body.promptCacheKey()
 
+    /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+     * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+     * content blocks with `prompt_cache_breakpoint`. Each request can write up to four breakpoints.
+     * For cache matching, OpenAI considers up to the latest 80 breakpoints in the conversation,
+     * without a content-block lookback limit. Set `mode` to `explicit` to disable the implicit
+     * breakpoint. The `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for current
+     * details.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheOptions(): Optional<PromptCacheOptions> = body.promptCacheOptions()
+
     /**
      * How long to retain a prompt cache entry created by this request.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
+    @Deprecated("deprecated")
     fun promptCacheRetention(): Optional<PromptCacheRetention> = body.promptCacheRetention()
 
     /**
@@ -149,12 +165,21 @@ private constructor(
      */
     fun _promptCacheKey(): JsonField<String> = body._promptCacheKey()
 
+    /**
+     * Returns the raw JSON value of [promptCacheOptions].
+     *
+     * Unlike [promptCacheOptions], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    fun _promptCacheOptions(): JsonField<PromptCacheOptions> = body._promptCacheOptions()
+
     /**
      * Returns the raw JSON value of [promptCacheRetention].
      *
      * Unlike [promptCacheRetention], this method doesn't throw if the JSON field has an unexpected
      * type.
      */
+    @Deprecated("deprecated")
     fun _promptCacheRetention(): JsonField<PromptCacheRetention> = body._promptCacheRetention()
 
     /**
@@ -331,7 +356,40 @@ private constructor(
             body.promptCacheKey(promptCacheKey)
         }
 
+        /**
+         * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+         * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+         * content blocks with `prompt_cache_breakpoint`. Each request can write up to four
+         * breakpoints. For cache matching, OpenAI considers up to the latest 80 breakpoints in the
+         * conversation, without a content-block lookback limit. Set `mode` to `explicit` to disable
+         * the implicit breakpoint. The `ttl` defaults to `30m`, which is currently the only
+         * supported value. See the
+         * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+         * current details.
+         */
+        fun promptCacheOptions(promptCacheOptions: PromptCacheOptions?) = apply {
+            body.promptCacheOptions(promptCacheOptions)
+        }
+
+        /**
+         * Alias for calling [Builder.promptCacheOptions] with `promptCacheOptions.orElse(null)`.
+         */
+        fun promptCacheOptions(promptCacheOptions: Optional<PromptCacheOptions>) =
+            promptCacheOptions(promptCacheOptions.getOrNull())
+
+        /**
+         * Sets [Builder.promptCacheOptions] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheOptions] with a well-typed
+         * [PromptCacheOptions] value instead. This method is primarily for setting the field to an
+         * undocumented or not yet supported value.
+         */
+        fun promptCacheOptions(promptCacheOptions: JsonField<PromptCacheOptions>) = apply {
+            body.promptCacheOptions(promptCacheOptions)
+        }
+
         /** How long to retain a prompt cache entry created by this request. */
+        @Deprecated("deprecated")
         fun promptCacheRetention(promptCacheRetention: PromptCacheRetention?) = apply {
             body.promptCacheRetention(promptCacheRetention)
         }
@@ -340,6 +398,7 @@ private constructor(
          * Alias for calling [Builder.promptCacheRetention] with
          * `promptCacheRetention.orElse(null)`.
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(promptCacheRetention: Optional<PromptCacheRetention>) =
             promptCacheRetention(promptCacheRetention.getOrNull())
 
@@ -350,6 +409,7 @@ private constructor(
          * [PromptCacheRetention] value instead. This method is primarily for setting the field to
          * an undocumented or not yet supported value.
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(promptCacheRetention: JsonField<PromptCacheRetention>) = apply {
             body.promptCacheRetention(promptCacheRetention)
         }
@@ -522,6 +582,7 @@ private constructor(
         private val instructions: JsonField<String>,
         private val previousResponseId: JsonField<String>,
         private val promptCacheKey: JsonField<String>,
+        private val promptCacheOptions: JsonField<PromptCacheOptions>,
         private val promptCacheRetention: JsonField<PromptCacheRetention>,
         private val serviceTier: JsonField<ServiceTier>,
         private val additionalProperties: MutableMap<String, JsonValue>,
@@ -540,6 +601,9 @@ private constructor(
             @JsonProperty("prompt_cache_key")
             @ExcludeMissing
             promptCacheKey: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("prompt_cache_options")
+            @ExcludeMissing
+            promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of(),
             @JsonProperty("prompt_cache_retention")
             @ExcludeMissing
             promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of(),
@@ -552,6 +616,7 @@ private constructor(
             instructions,
             previousResponseId,
             promptCacheKey,
+            promptCacheOptions,
             promptCacheRetention,
             serviceTier,
             mutableMapOf(),
@@ -607,12 +672,30 @@ private constructor(
          */
         fun promptCacheKey(): Optional<String> = promptCacheKey.getOptional("prompt_cache_key")
 
+        /**
+         * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+         * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+         * content blocks with `prompt_cache_breakpoint`. Each request can write up to four
+         * breakpoints. For cache matching, OpenAI considers up to the latest 80 breakpoints in the
+         * conversation, without a content-block lookback limit. Set `mode` to `explicit` to disable
+         * the implicit breakpoint. The `ttl` defaults to `30m`, which is currently the only
+         * supported value. See the
+         * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+         * current details.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun promptCacheOptions(): Optional<PromptCacheOptions> =
+            promptCacheOptions.getOptional("prompt_cache_options")
+
         /**
          * How long to retain a prompt cache entry created by this request.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(): Optional<PromptCacheRetention> =
             promptCacheRetention.getOptional("prompt_cache_retention")
 
@@ -668,12 +751,23 @@ private constructor(
         @ExcludeMissing
         fun _promptCacheKey(): JsonField<String> = promptCacheKey
 
+        /**
+         * Returns the raw JSON value of [promptCacheOptions].
+         *
+         * Unlike [promptCacheOptions], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @JsonProperty("prompt_cache_options")
+        @ExcludeMissing
+        fun _promptCacheOptions(): JsonField<PromptCacheOptions> = promptCacheOptions
+
         /**
          * Returns the raw JSON value of [promptCacheRetention].
          *
          * Unlike [promptCacheRetention], this method doesn't throw if the JSON field has an
          * unexpected type.
          */
+        @Deprecated("deprecated")
         @JsonProperty("prompt_cache_retention")
         @ExcludeMissing
         fun _promptCacheRetention(): JsonField<PromptCacheRetention> = promptCacheRetention
@@ -720,6 +814,7 @@ private constructor(
             private var instructions: JsonField<String> = JsonMissing.of()
             private var previousResponseId: JsonField<String> = JsonMissing.of()
             private var promptCacheKey: JsonField<String> = JsonMissing.of()
+            private var promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of()
             private var promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of()
             private var serviceTier: JsonField<ServiceTier> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
@@ -731,6 +826,7 @@ private constructor(
                 instructions = body.instructions
                 previousResponseId = body.previousResponseId
                 promptCacheKey = body.promptCacheKey
+                promptCacheOptions = body.promptCacheOptions
                 promptCacheRetention = body.promptCacheRetention
                 serviceTier = body.serviceTier
                 additionalProperties = body.additionalProperties.toMutableMap()
@@ -857,7 +953,40 @@ private constructor(
                 this.promptCacheKey = promptCacheKey
             }
 
+            /**
+             * Options for prompt caching. Supported for `gpt-5.6` and later models. By default,
+             * OpenAI automatically chooses one implicit cache breakpoint. You can add explicit
+             * breakpoints to content blocks with `prompt_cache_breakpoint`. Each request can write
+             * up to four breakpoints. For cache matching, OpenAI considers up to the latest 80
+             * breakpoints in the conversation, without a content-block lookback limit. Set `mode`
+             * to `explicit` to disable the implicit breakpoint. The `ttl` defaults to `30m`, which
+             * is currently the only supported value. See the
+             * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+             * current details.
+             */
+            fun promptCacheOptions(promptCacheOptions: PromptCacheOptions?) =
+                promptCacheOptions(JsonField.ofNullable(promptCacheOptions))
+
+            /**
+             * Alias for calling [Builder.promptCacheOptions] with
+             * `promptCacheOptions.orElse(null)`.
+             */
+            fun promptCacheOptions(promptCacheOptions: Optional<PromptCacheOptions>) =
+                promptCacheOptions(promptCacheOptions.getOrNull())
+
+            /**
+             * Sets [Builder.promptCacheOptions] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.promptCacheOptions] with a well-typed
+             * [PromptCacheOptions] value instead. This method is primarily for setting the field to
+             * an undocumented or not yet supported value.
+             */
+            fun promptCacheOptions(promptCacheOptions: JsonField<PromptCacheOptions>) = apply {
+                this.promptCacheOptions = promptCacheOptions
+            }
+
             /** How long to retain a prompt cache entry created by this request. */
+            @Deprecated("deprecated")
             fun promptCacheRetention(promptCacheRetention: PromptCacheRetention?) =
                 promptCacheRetention(JsonField.ofNullable(promptCacheRetention))
 
@@ -865,6 +994,7 @@ private constructor(
              * Alias for calling [Builder.promptCacheRetention] with
              * `promptCacheRetention.orElse(null)`.
              */
+            @Deprecated("deprecated")
             fun promptCacheRetention(promptCacheRetention: Optional<PromptCacheRetention>) =
                 promptCacheRetention(promptCacheRetention.getOrNull())
 
@@ -875,6 +1005,7 @@ private constructor(
              * [PromptCacheRetention] value instead. This method is primarily for setting the field
              * to an undocumented or not yet supported value.
              */
+            @Deprecated("deprecated")
             fun promptCacheRetention(promptCacheRetention: JsonField<PromptCacheRetention>) =
                 apply {
                     this.promptCacheRetention = promptCacheRetention
@@ -937,6 +1068,7 @@ private constructor(
                     instructions,
                     previousResponseId,
                     promptCacheKey,
+                    promptCacheOptions,
                     promptCacheRetention,
                     serviceTier,
                     additionalProperties.toMutableMap(),
@@ -964,6 +1096,7 @@ private constructor(
             instructions()
             previousResponseId()
             promptCacheKey()
+            promptCacheOptions().ifPresent { it.validate() }
             promptCacheRetention().ifPresent { it.validate() }
             serviceTier().ifPresent { it.validate() }
             validated = true
@@ -990,6 +1123,7 @@ private constructor(
                 (if (instructions.asKnown().isPresent) 1 else 0) +
                 (if (previousResponseId.asKnown().isPresent) 1 else 0) +
                 (if (promptCacheKey.asKnown().isPresent) 1 else 0) +
+                (promptCacheOptions.asKnown().getOrNull()?.validity() ?: 0) +
                 (promptCacheRetention.asKnown().getOrNull()?.validity() ?: 0) +
                 (serviceTier.asKnown().getOrNull()?.validity() ?: 0)
 
@@ -1004,6 +1138,7 @@ private constructor(
                 instructions == other.instructions &&
                 previousResponseId == other.previousResponseId &&
                 promptCacheKey == other.promptCacheKey &&
+                promptCacheOptions == other.promptCacheOptions &&
                 promptCacheRetention == other.promptCacheRetention &&
                 serviceTier == other.serviceTier &&
                 additionalProperties == other.additionalProperties
@@ -1016,6 +1151,7 @@ private constructor(
                 instructions,
                 previousResponseId,
                 promptCacheKey,
+                promptCacheOptions,
                 promptCacheRetention,
                 serviceTier,
                 additionalProperties,
@@ -1025,7 +1161,7 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Body{model=$model, input=$input, instructions=$instructions, previousResponseId=$previousResponseId, promptCacheKey=$promptCacheKey, promptCacheRetention=$promptCacheRetention, serviceTier=$serviceTier, additionalProperties=$additionalProperties}"
+            "Body{model=$model, input=$input, instructions=$instructions, previousResponseId=$previousResponseId, promptCacheKey=$promptCacheKey, promptCacheOptions=$promptCacheOptions, promptCacheRetention=$promptCacheRetention, serviceTier=$serviceTier, additionalProperties=$additionalProperties}"
     }
 
     /**
@@ -1048,6 +1184,12 @@ private constructor(
 
         companion object {
 
+            @JvmField val GPT_5_6_SOL = of("gpt-5.6-sol")
+
+            @JvmField val GPT_5_6_TERRA = of("gpt-5.6-terra")
+
+            @JvmField val GPT_5_6_LUNA = of("gpt-5.6-luna")
+
             @JvmField val GPT_5_4 = of("gpt-5.4")
 
             @JvmField val GPT_5_4_MINI = of("gpt-5.4-mini")
@@ -1239,6 +1381,9 @@ private constructor(
 
         /** An enum containing [Model]'s known values. */
         enum class Known {
+            GPT_5_6_SOL,
+            GPT_5_6_TERRA,
+            GPT_5_6_LUNA,
             GPT_5_4,
             GPT_5_4_MINI,
             GPT_5_4_NANO,
@@ -1343,6 +1488,9 @@ private constructor(
          * - It was constructed with an arbitrary value using the [of] method.
          */
         enum class Value {
+            GPT_5_6_SOL,
+            GPT_5_6_TERRA,
+            GPT_5_6_LUNA,
             GPT_5_4,
             GPT_5_4_MINI,
             GPT_5_4_NANO,
@@ -1448,6 +1596,9 @@ private constructor(
          */
         fun value(): Value =
             when (this) {
+                GPT_5_6_SOL -> Value.GPT_5_6_SOL
+                GPT_5_6_TERRA -> Value.GPT_5_6_TERRA
+                GPT_5_6_LUNA -> Value.GPT_5_6_LUNA
                 GPT_5_4 -> Value.GPT_5_4
                 GPT_5_4_MINI -> Value.GPT_5_4_MINI
                 GPT_5_4_NANO -> Value.GPT_5_4_NANO
@@ -1554,6 +1705,9 @@ private constructor(
          */
         fun known(): Known =
             when (this) {
+                GPT_5_6_SOL -> Known.GPT_5_6_SOL
+                GPT_5_6_TERRA -> Known.GPT_5_6_TERRA
+                GPT_5_6_LUNA -> Known.GPT_5_6_LUNA
                 GPT_5_4 -> Known.GPT_5_4
                 GPT_5_4_MINI -> Known.GPT_5_4_MINI
                 GPT_5_4_NANO -> Known.GPT_5_4_NANO
@@ -1941,7 +2095,502 @@ private constructor(
         }
     }
 
+    /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+     * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+     * content blocks with `prompt_cache_breakpoint`. Each request can write up to four breakpoints.
+     * For cache matching, OpenAI considers up to the latest 80 breakpoints in the conversation,
+     * without a content-block lookback limit. Set `mode` to `explicit` to disable the implicit
+     * breakpoint. The `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for current
+     * details.
+     */
+    class PromptCacheOptions
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonField<Mode>,
+        private val ttl: JsonField<Ttl>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of(),
+            @JsonProperty("ttl") @ExcludeMissing ttl: JsonField<Ttl> = JsonMissing.of(),
+        ) : this(mode, ttl, mutableMapOf())
+
+        /**
+         * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults to
+         * `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up to the
+         * latest three explicit breakpoints in the request. With `explicit`, OpenAI does not create
+         * an implicit breakpoint and writes up to the latest four explicit breakpoints. If there
+         * are no explicit breakpoints, the request does not use prompt caching.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun mode(): Optional<Mode> = mode.getOptional("mode")
+
+        /**
+         * The minimum lifetime applied to every implicit and explicit cache breakpoint written by
+         * the request. Defaults to `30m`, which is currently the only supported value. The backend
+         * may retain cache entries for longer.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun ttl(): Optional<Ttl> = ttl.getOptional("ttl")
+
+        /**
+         * Returns the raw JSON value of [mode].
+         *
+         * Unlike [mode], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+        /**
+         * Returns the raw JSON value of [ttl].
+         *
+         * Unlike [ttl], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("ttl") @ExcludeMissing fun _ttl(): JsonField<Ttl> = ttl
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [PromptCacheOptions]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheOptions]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonField<Mode> = JsonMissing.of()
+            private var ttl: JsonField<Ttl> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheOptions: PromptCacheOptions) = apply {
+                mode = promptCacheOptions.mode
+                ttl = promptCacheOptions.ttl
+                additionalProperties = promptCacheOptions.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults
+             * to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up
+             * to the latest three explicit breakpoints in the request. With `explicit`, OpenAI does
+             * not create an implicit breakpoint and writes up to the latest four explicit
+             * breakpoints. If there are no explicit breakpoints, the request does not use prompt
+             * caching.
+             */
+            fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+            /**
+             * Sets [Builder.mode] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.mode] with a well-typed [Mode] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+            /**
+             * The minimum lifetime applied to every implicit and explicit cache breakpoint written
+             * by the request. Defaults to `30m`, which is currently the only supported value. The
+             * backend may retain cache entries for longer.
+             */
+            fun ttl(ttl: Ttl) = ttl(JsonField.of(ttl))
+
+            /**
+             * Sets [Builder.ttl] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.ttl] with a well-typed [Ttl] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun ttl(ttl: JsonField<Ttl>) = apply { this.ttl = ttl }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheOptions].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheOptions =
+                PromptCacheOptions(mode, ttl, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheOptions = apply {
+            if (validated) {
+                return@apply
+            }
+
+            mode().ifPresent { it.validate() }
+            ttl().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (mode.asKnown().getOrNull()?.validity() ?: 0) +
+                (ttl.asKnown().getOrNull()?.validity() ?: 0)
+
+        /**
+         * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults to
+         * `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up to the
+         * latest three explicit breakpoints in the request. With `explicit`, OpenAI does not create
+         * an implicit breakpoint and writes up to the latest four explicit breakpoints. If there
+         * are no explicit breakpoints, the request does not use prompt caching.
+         */
+        class Mode @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IMPLICIT = of("implicit")
+
+                @JvmField val EXPLICIT = of("explicit")
+
+                @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+            }
+
+            /** An enum containing [Mode]'s known values. */
+            enum class Known {
+                IMPLICIT,
+                EXPLICIT,
+            }
+
+            /**
+             * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Mode] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IMPLICIT,
+                EXPLICIT,
+                /** An enum member indicating that [Mode] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IMPLICIT -> Value.IMPLICIT
+                    EXPLICIT -> Value.EXPLICIT
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IMPLICIT -> Known.IMPLICIT
+                    EXPLICIT -> Known.EXPLICIT
+                    else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Mode = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Mode && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * The minimum lifetime applied to every implicit and explicit cache breakpoint written by
+         * the request. Defaults to `30m`, which is currently the only supported value. The backend
+         * may retain cache entries for longer.
+         */
+        class Ttl @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val _30M = of("30m")
+
+                @JvmStatic fun of(value: String) = Ttl(JsonField.of(value))
+            }
+
+            /** An enum containing [Ttl]'s known values. */
+            enum class Known {
+                _30M
+            }
+
+            /**
+             * An enum containing [Ttl]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Ttl] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                _30M,
+                /** An enum member indicating that [Ttl] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    _30M -> Value._30M
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    _30M -> Known._30M
+                    else -> throw OpenAIInvalidDataException("Unknown Ttl: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Ttl = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Ttl && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheOptions &&
+                mode == other.mode &&
+                ttl == other.ttl &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, ttl, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheOptions{mode=$mode, ttl=$ttl, additionalProperties=$additionalProperties}"
+    }
+
     /** How long to retain a prompt cache entry created by this request. */
+    @Deprecated("deprecated")
     class PromptCacheRetention
     @JsonCreator
     private constructor(private val value: JsonField<String>) : Enum {
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCreateParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCreateParams.kt
index ea90af07c..5912b893e 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCreateParams.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCreateParams.kt
@@ -222,10 +222,29 @@ private constructor(
     fun promptCacheKey(): Optional<String> = body.promptCacheKey()
 
     /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+     * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+     * content blocks with `prompt_cache_breakpoint`. Each request can write up to four breakpoints.
+     * For cache matching, OpenAI considers up to the latest 80 breakpoints in the conversation,
+     * without a content-block lookback limit. Set `mode` to `explicit` to disable the implicit
+     * breakpoint. The `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for current
+     * details.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheOptions(): Optional<PromptCacheOptions> = body.promptCacheOptions()
+
+    /**
+     * Deprecated. Use `prompt_cache_options.ttl` instead.
+     *
      * The retention policy for the prompt cache. Set to `24h` to enable extended prompt caching,
      * which keeps cached prefixes active for longer, up to a maximum of 24 hours.
      * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
-     * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+     * This field expresses a maximum retention policy, while `prompt_cache_options.ttl` expresses a
+     * minimum cache lifetime. The two fields are independent and do not interact. For `gpt-5.5`,
+     * `gpt-5.5-pro`, and future models, only `24h` is supported.
      *
      * For older models that support both `in_memory` and `24h`, the default depends on your
      * organization's data retention policy:
@@ -236,6 +255,7 @@ private constructor(
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
+    @Deprecated("deprecated")
     fun promptCacheRetention(): Optional<PromptCacheRetention> = body.promptCacheRetention()
 
     /**
@@ -504,12 +524,21 @@ private constructor(
      */
     fun _promptCacheKey(): JsonField<String> = body._promptCacheKey()
 
+    /**
+     * Returns the raw JSON value of [promptCacheOptions].
+     *
+     * Unlike [promptCacheOptions], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    fun _promptCacheOptions(): JsonField<PromptCacheOptions> = body._promptCacheOptions()
+
     /**
      * Returns the raw JSON value of [promptCacheRetention].
      *
      * Unlike [promptCacheRetention], this method doesn't throw if the JSON field has an unexpected
      * type.
      */
+    @Deprecated("deprecated")
     fun _promptCacheRetention(): JsonField<PromptCacheRetention> = body._promptCacheRetention()
 
     /**
@@ -1038,9 +1067,39 @@ private constructor(
         }
 
         /**
+         * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+         * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+         * content blocks with `prompt_cache_breakpoint`. Each request can write up to four
+         * breakpoints. For cache matching, OpenAI considers up to the latest 80 breakpoints in the
+         * conversation, without a content-block lookback limit. Set `mode` to `explicit` to disable
+         * the implicit breakpoint. The `ttl` defaults to `30m`, which is currently the only
+         * supported value. See the
+         * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+         * current details.
+         */
+        fun promptCacheOptions(promptCacheOptions: PromptCacheOptions) = apply {
+            body.promptCacheOptions(promptCacheOptions)
+        }
+
+        /**
+         * Sets [Builder.promptCacheOptions] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheOptions] with a well-typed
+         * [PromptCacheOptions] value instead. This method is primarily for setting the field to an
+         * undocumented or not yet supported value.
+         */
+        fun promptCacheOptions(promptCacheOptions: JsonField<PromptCacheOptions>) = apply {
+            body.promptCacheOptions(promptCacheOptions)
+        }
+
+        /**
+         * Deprecated. Use `prompt_cache_options.ttl` instead.
+         *
          * The retention policy for the prompt cache. Set to `24h` to enable extended prompt
          * caching, which keeps cached prefixes active for longer, up to a maximum of 24 hours.
          * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+         * This field expresses a maximum retention policy, while `prompt_cache_options.ttl`
+         * expresses a minimum cache lifetime. The two fields are independent and do not interact.
          * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
          *
          * For older models that support both `in_memory` and `24h`, the default depends on your
@@ -1049,6 +1108,7 @@ private constructor(
          * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is
          *   not specified.
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(promptCacheRetention: PromptCacheRetention?) = apply {
             body.promptCacheRetention(promptCacheRetention)
         }
@@ -1057,6 +1117,7 @@ private constructor(
          * Alias for calling [Builder.promptCacheRetention] with
          * `promptCacheRetention.orElse(null)`.
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(promptCacheRetention: Optional<PromptCacheRetention>) =
             promptCacheRetention(promptCacheRetention.getOrNull())
 
@@ -1067,6 +1128,7 @@ private constructor(
          * [PromptCacheRetention] value instead. This method is primarily for setting the field to
          * an undocumented or not yet supported value.
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(promptCacheRetention: JsonField<PromptCacheRetention>) = apply {
             body.promptCacheRetention(promptCacheRetention)
         }
@@ -1300,6 +1362,14 @@ private constructor(
         /** Alias for calling [toolChoice] with `ToolChoice.ofCustom(custom)`. */
         fun toolChoice(custom: ToolChoiceCustom) = apply { body.toolChoice(custom) }
 
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofSpecificProgrammaticToolCallingParam()`.
+         */
+        fun toolChoiceSpecificProgrammaticToolCallingParam() = apply {
+            body.toolChoiceSpecificProgrammaticToolCallingParam()
+        }
+
         /** Alias for calling [toolChoice] with `ToolChoice.ofApplyPatch(applyPatch)`. */
         fun toolChoice(applyPatch: ToolChoiceApplyPatch) = apply { body.toolChoice(applyPatch) }
 
@@ -1430,6 +1500,9 @@ private constructor(
             codeInterpreterToolAuto: Tool.CodeInterpreter.Container.CodeInterpreterToolAuto
         ) = apply { body.addCodeInterpreterTool(codeInterpreterToolAuto) }
 
+        /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+        fun addToolProgrammaticToolCalling() = apply { body.addToolProgrammaticToolCalling() }
+
         /** Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`. */
         fun addTool(imageGeneration: Tool.ImageGeneration) = apply { body.addTool(imageGeneration) }
 
@@ -1715,6 +1788,7 @@ private constructor(
         private val previousResponseId: JsonField<String>,
         private val prompt: JsonField<ResponsePrompt>,
         private val promptCacheKey: JsonField<String>,
+        private val promptCacheOptions: JsonField<PromptCacheOptions>,
         private val promptCacheRetention: JsonField<PromptCacheRetention>,
         private val reasoning: JsonField<Reasoning>,
         private val safetyIdentifier: JsonField<String>,
@@ -1777,6 +1851,9 @@ private constructor(
             @JsonProperty("prompt_cache_key")
             @ExcludeMissing
             promptCacheKey: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("prompt_cache_options")
+            @ExcludeMissing
+            promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of(),
             @JsonProperty("prompt_cache_retention")
             @ExcludeMissing
             promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of(),
@@ -1827,6 +1904,7 @@ private constructor(
             previousResponseId,
             prompt,
             promptCacheKey,
+            promptCacheOptions,
             promptCacheRetention,
             reasoning,
             safetyIdentifier,
@@ -2014,9 +2092,30 @@ private constructor(
         fun promptCacheKey(): Optional<String> = promptCacheKey.getOptional("prompt_cache_key")
 
         /**
+         * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+         * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+         * content blocks with `prompt_cache_breakpoint`. Each request can write up to four
+         * breakpoints. For cache matching, OpenAI considers up to the latest 80 breakpoints in the
+         * conversation, without a content-block lookback limit. Set `mode` to `explicit` to disable
+         * the implicit breakpoint. The `ttl` defaults to `30m`, which is currently the only
+         * supported value. See the
+         * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+         * current details.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun promptCacheOptions(): Optional<PromptCacheOptions> =
+            promptCacheOptions.getOptional("prompt_cache_options")
+
+        /**
+         * Deprecated. Use `prompt_cache_options.ttl` instead.
+         *
          * The retention policy for the prompt cache. Set to `24h` to enable extended prompt
          * caching, which keeps cached prefixes active for longer, up to a maximum of 24 hours.
          * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+         * This field expresses a maximum retention policy, while `prompt_cache_options.ttl`
+         * expresses a minimum cache lifetime. The two fields are independent and do not interact.
          * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
          *
          * For older models that support both `in_memory` and `24h`, the default depends on your
@@ -2028,6 +2127,7 @@ private constructor(
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(): Optional<PromptCacheRetention> =
             promptCacheRetention.getOptional("prompt_cache_retention")
 
@@ -2326,12 +2426,23 @@ private constructor(
         @ExcludeMissing
         fun _promptCacheKey(): JsonField<String> = promptCacheKey
 
+        /**
+         * Returns the raw JSON value of [promptCacheOptions].
+         *
+         * Unlike [promptCacheOptions], this method doesn't throw if the JSON field has an
+         * unexpected type.
+         */
+        @JsonProperty("prompt_cache_options")
+        @ExcludeMissing
+        fun _promptCacheOptions(): JsonField<PromptCacheOptions> = promptCacheOptions
+
         /**
          * Returns the raw JSON value of [promptCacheRetention].
          *
          * Unlike [promptCacheRetention], this method doesn't throw if the JSON field has an
          * unexpected type.
          */
+        @Deprecated("deprecated")
         @JsonProperty("prompt_cache_retention")
         @ExcludeMissing
         fun _promptCacheRetention(): JsonField<PromptCacheRetention> = promptCacheRetention
@@ -2485,6 +2596,7 @@ private constructor(
             private var previousResponseId: JsonField<String> = JsonMissing.of()
             private var prompt: JsonField<ResponsePrompt> = JsonMissing.of()
             private var promptCacheKey: JsonField<String> = JsonMissing.of()
+            private var promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of()
             private var promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of()
             private var reasoning: JsonField<Reasoning> = JsonMissing.of()
             private var safetyIdentifier: JsonField<String> = JsonMissing.of()
@@ -2518,6 +2630,7 @@ private constructor(
                 previousResponseId = body.previousResponseId
                 prompt = body.prompt
                 promptCacheKey = body.promptCacheKey
+                promptCacheOptions = body.promptCacheOptions
                 promptCacheRetention = body.promptCacheRetention
                 reasoning = body.reasoning
                 safetyIdentifier = body.safetyIdentifier
@@ -2943,10 +3056,39 @@ private constructor(
             }
 
             /**
+             * Options for prompt caching. Supported for `gpt-5.6` and later models. By default,
+             * OpenAI automatically chooses one implicit cache breakpoint. You can add explicit
+             * breakpoints to content blocks with `prompt_cache_breakpoint`. Each request can write
+             * up to four breakpoints. For cache matching, OpenAI considers up to the latest 80
+             * breakpoints in the conversation, without a content-block lookback limit. Set `mode`
+             * to `explicit` to disable the implicit breakpoint. The `ttl` defaults to `30m`, which
+             * is currently the only supported value. See the
+             * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+             * current details.
+             */
+            fun promptCacheOptions(promptCacheOptions: PromptCacheOptions) =
+                promptCacheOptions(JsonField.of(promptCacheOptions))
+
+            /**
+             * Sets [Builder.promptCacheOptions] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.promptCacheOptions] with a well-typed
+             * [PromptCacheOptions] value instead. This method is primarily for setting the field to
+             * an undocumented or not yet supported value.
+             */
+            fun promptCacheOptions(promptCacheOptions: JsonField<PromptCacheOptions>) = apply {
+                this.promptCacheOptions = promptCacheOptions
+            }
+
+            /**
+             * Deprecated. Use `prompt_cache_options.ttl` instead.
+             *
              * The retention policy for the prompt cache. Set to `24h` to enable extended prompt
              * caching, which keeps cached prefixes active for longer, up to a maximum of 24 hours.
              * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
-             * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+             * This field expresses a maximum retention policy, while `prompt_cache_options.ttl`
+             * expresses a minimum cache lifetime. The two fields are independent and do not
+             * interact. For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
              *
              * For older models that support both `in_memory` and `24h`, the default depends on your
              * organization's data retention policy:
@@ -2954,6 +3096,7 @@ private constructor(
              * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention`
              *   is not specified.
              */
+            @Deprecated("deprecated")
             fun promptCacheRetention(promptCacheRetention: PromptCacheRetention?) =
                 promptCacheRetention(JsonField.ofNullable(promptCacheRetention))
 
@@ -2961,6 +3104,7 @@ private constructor(
              * Alias for calling [Builder.promptCacheRetention] with
              * `promptCacheRetention.orElse(null)`.
              */
+            @Deprecated("deprecated")
             fun promptCacheRetention(promptCacheRetention: Optional<PromptCacheRetention>) =
                 promptCacheRetention(promptCacheRetention.getOrNull())
 
@@ -2971,6 +3115,7 @@ private constructor(
              * [PromptCacheRetention] value instead. This method is primarily for setting the field
              * to an undocumented or not yet supported value.
              */
+            @Deprecated("deprecated")
             fun promptCacheRetention(promptCacheRetention: JsonField<PromptCacheRetention>) =
                 apply {
                     this.promptCacheRetention = promptCacheRetention
@@ -3174,6 +3319,13 @@ private constructor(
             /** Alias for calling [toolChoice] with `ToolChoice.ofCustom(custom)`. */
             fun toolChoice(custom: ToolChoiceCustom) = toolChoice(ToolChoice.ofCustom(custom))
 
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofSpecificProgrammaticToolCallingParam()`.
+             */
+            fun toolChoiceSpecificProgrammaticToolCallingParam() =
+                toolChoice(ToolChoice.ofSpecificProgrammaticToolCallingParam())
+
             /** Alias for calling [toolChoice] with `ToolChoice.ofApplyPatch(applyPatch)`. */
             fun toolChoice(applyPatch: ToolChoiceApplyPatch) =
                 toolChoice(ToolChoice.ofApplyPatch(applyPatch))
@@ -3300,6 +3452,9 @@ private constructor(
                     )
                 )
 
+            /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+            fun addToolProgrammaticToolCalling() = addTool(Tool.ofProgrammaticToolCalling())
+
             /** Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`. */
             fun addTool(imageGeneration: Tool.ImageGeneration) =
                 addTool(Tool.ofImageGeneration(imageGeneration))
@@ -3476,6 +3631,7 @@ private constructor(
                     previousResponseId,
                     prompt,
                     promptCacheKey,
+                    promptCacheOptions,
                     promptCacheRetention,
                     reasoning,
                     safetyIdentifier,
@@ -3525,6 +3681,7 @@ private constructor(
             previousResponseId()
             prompt().ifPresent { it.validate() }
             promptCacheKey()
+            promptCacheOptions().ifPresent { it.validate() }
             promptCacheRetention().ifPresent { it.validate() }
             reasoning().ifPresent { it.validate() }
             safetyIdentifier()
@@ -3573,6 +3730,7 @@ private constructor(
                 (if (previousResponseId.asKnown().isPresent) 1 else 0) +
                 (prompt.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (promptCacheKey.asKnown().isPresent) 1 else 0) +
+                (promptCacheOptions.asKnown().getOrNull()?.validity() ?: 0) +
                 (promptCacheRetention.asKnown().getOrNull()?.validity() ?: 0) +
                 (reasoning.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (safetyIdentifier.asKnown().isPresent) 1 else 0) +
@@ -3609,6 +3767,7 @@ private constructor(
                 previousResponseId == other.previousResponseId &&
                 prompt == other.prompt &&
                 promptCacheKey == other.promptCacheKey &&
+                promptCacheOptions == other.promptCacheOptions &&
                 promptCacheRetention == other.promptCacheRetention &&
                 reasoning == other.reasoning &&
                 safetyIdentifier == other.safetyIdentifier &&
@@ -3643,6 +3802,7 @@ private constructor(
                 previousResponseId,
                 prompt,
                 promptCacheKey,
+                promptCacheOptions,
                 promptCacheRetention,
                 reasoning,
                 safetyIdentifier,
@@ -3664,7 +3824,7 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Body{background=$background, contextManagement=$contextManagement, conversation=$conversation, include=$include, input=$input, instructions=$instructions, maxOutputTokens=$maxOutputTokens, maxToolCalls=$maxToolCalls, metadata=$metadata, model=$model, moderation=$moderation, parallelToolCalls=$parallelToolCalls, previousResponseId=$previousResponseId, prompt=$prompt, promptCacheKey=$promptCacheKey, promptCacheRetention=$promptCacheRetention, reasoning=$reasoning, safetyIdentifier=$safetyIdentifier, serviceTier=$serviceTier, store=$store, streamOptions=$streamOptions, temperature=$temperature, text=$text, toolChoice=$toolChoice, tools=$tools, topLogprobs=$topLogprobs, topP=$topP, truncation=$truncation, user=$user, additionalProperties=$additionalProperties}"
+            "Body{background=$background, contextManagement=$contextManagement, conversation=$conversation, include=$include, input=$input, instructions=$instructions, maxOutputTokens=$maxOutputTokens, maxToolCalls=$maxToolCalls, metadata=$metadata, model=$model, moderation=$moderation, parallelToolCalls=$parallelToolCalls, previousResponseId=$previousResponseId, prompt=$prompt, promptCacheKey=$promptCacheKey, promptCacheOptions=$promptCacheOptions, promptCacheRetention=$promptCacheRetention, reasoning=$reasoning, safetyIdentifier=$safetyIdentifier, serviceTier=$serviceTier, store=$store, streamOptions=$streamOptions, temperature=$temperature, text=$text, toolChoice=$toolChoice, tools=$tools, topLogprobs=$topLogprobs, topP=$topP, truncation=$truncation, user=$user, additionalProperties=$additionalProperties}"
     }
 
     class ContextManagement
@@ -4487,13 +4647,15 @@ private constructor(
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
         private val model: JsonField<String>,
+        private val policy: JsonField<Policy>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
         @JsonCreator
         private constructor(
-            @JsonProperty("model") @ExcludeMissing model: JsonField<String> = JsonMissing.of()
-        ) : this(model, mutableMapOf())
+            @JsonProperty("model") @ExcludeMissing model: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("policy") @ExcludeMissing policy: JsonField<Policy> = JsonMissing.of(),
+        ) : this(model, policy, mutableMapOf())
 
         /**
          * The moderation model to use for moderated completions, e.g. 'omni-moderation-latest'.
@@ -4503,6 +4665,14 @@ private constructor(
          */
         fun model(): String = model.getRequired("model")
 
+        /**
+         * The policy to apply to moderated response input and output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun policy(): Optional<Policy> = policy.getOptional("policy")
+
         /**
          * Returns the raw JSON value of [model].
          *
@@ -4510,6 +4680,13 @@ private constructor(
          */
         @JsonProperty("model") @ExcludeMissing fun _model(): JsonField<String> = model
 
+        /**
+         * Returns the raw JSON value of [policy].
+         *
+         * Unlike [policy], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("policy") @ExcludeMissing fun _policy(): JsonField<Policy> = policy
+
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
             additionalProperties.put(key, value)
@@ -4539,11 +4716,13 @@ private constructor(
         class Builder internal constructor() {
 
             private var model: JsonField<String>? = null
+            private var policy: JsonField<Policy> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
             internal fun from(moderation: Moderation) = apply {
                 model = moderation.model
+                policy = moderation.policy
                 additionalProperties = moderation.additionalProperties.toMutableMap()
             }
 
@@ -4561,6 +4740,21 @@ private constructor(
              */
             fun model(model: JsonField<String>) = apply { this.model = model }
 
+            /** The policy to apply to moderated response input and output. */
+            fun policy(policy: Policy?) = policy(JsonField.ofNullable(policy))
+
+            /** Alias for calling [Builder.policy] with `policy.orElse(null)`. */
+            fun policy(policy: Optional<Policy>) = policy(policy.getOrNull())
+
+            /**
+             * Sets [Builder.policy] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.policy] with a well-typed [Policy] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun policy(policy: JsonField<Policy>) = apply { this.policy = policy }
+
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
                 putAllAdditionalProperties(additionalProperties)
@@ -4593,7 +4787,11 @@ private constructor(
              * @throws IllegalStateException if any required field is unset.
              */
             fun build(): Moderation =
-                Moderation(checkRequired("model", model), additionalProperties.toMutableMap())
+                Moderation(
+                    checkRequired("model", model),
+                    policy,
+                    additionalProperties.toMutableMap(),
+                )
         }
 
         private var validated: Boolean = false
@@ -4613,6 +4811,7 @@ private constructor(
             }
 
             model()
+            policy().ifPresent { it.validate() }
             validated = true
         }
 
@@ -4630,176 +4829,1502 @@ private constructor(
          *
          * Used for best match union deserialization.
          */
-        @JvmSynthetic internal fun validity(): Int = (if (model.asKnown().isPresent) 1 else 0)
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (model.asKnown().isPresent) 1 else 0) +
+                (policy.asKnown().getOrNull()?.validity() ?: 0)
 
-        override fun equals(other: Any?): Boolean {
-            if (this === other) {
-                return true
-            }
+        /** The policy to apply to moderated response input and output. */
+        class Policy
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val input: JsonField<Input>,
+            private val output: JsonField<Output>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
 
-            return other is Moderation &&
-                model == other.model &&
-                additionalProperties == other.additionalProperties
-        }
+            @JsonCreator
+            private constructor(
+                @JsonProperty("input") @ExcludeMissing input: JsonField<Input> = JsonMissing.of(),
+                @JsonProperty("output") @ExcludeMissing output: JsonField<Output> = JsonMissing.of(),
+            ) : this(input, output, mutableMapOf())
 
-        private val hashCode: Int by lazy { Objects.hash(model, additionalProperties) }
+            /**
+             * The moderation policy for the response input.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun input(): Optional<Input> = input.getOptional("input")
 
-        override fun hashCode(): Int = hashCode
+            /**
+             * The moderation policy for the response output.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun output(): Optional<Output> = output.getOptional("output")
 
-        override fun toString() =
-            "Moderation{model=$model, additionalProperties=$additionalProperties}"
-    }
+            /**
+             * Returns the raw JSON value of [input].
+             *
+             * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("input") @ExcludeMissing fun _input(): JsonField<Input> = input
 
-    /**
-     * The retention policy for the prompt cache. Set to `24h` to enable extended prompt caching,
-     * which keeps cached prefixes active for longer, up to a maximum of 24 hours.
-     * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
-     * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
-     *
-     * For older models that support both `in_memory` and `24h`, the default depends on your
-     * organization's data retention policy:
-     * - Organizations without ZDR enabled default to `24h`.
-     * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is not
-     *   specified.
-     */
-    class PromptCacheRetention
-    @JsonCreator
-    private constructor(private val value: JsonField<String>) : Enum {
+            /**
+             * Returns the raw JSON value of [output].
+             *
+             * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<Output> = output
 
-        /**
-         * Returns this class instance's raw value.
-         *
-         * This is usually only useful if this instance was deserialized from data that doesn't
-         * match any known member, and you want to know that value. For example, if the SDK is on an
-         * older version than the API, then the API may respond with new members that the SDK is
-         * unaware of.
-         */
-        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
 
-        companion object {
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
 
-            @JvmField val IN_MEMORY = of("in_memory")
+            fun toBuilder() = Builder().from(this)
 
-            @JvmField val _24H = of("24h")
+            companion object {
 
-            @JvmStatic fun of(value: String) = PromptCacheRetention(JsonField.of(value))
-        }
+                /** Returns a mutable builder for constructing an instance of [Policy]. */
+                @JvmStatic fun builder() = Builder()
+            }
 
-        /** An enum containing [PromptCacheRetention]'s known values. */
-        enum class Known {
-            IN_MEMORY,
-            _24H,
-        }
+            /** A builder for [Policy]. */
+            class Builder internal constructor() {
 
-        /**
-         * An enum containing [PromptCacheRetention]'s known values, as well as an [_UNKNOWN]
-         * member.
-         *
-         * An instance of [PromptCacheRetention] can contain an unknown value in a couple of cases:
-         * - It was deserialized from data that doesn't match any known member. For example, if the
-         *   SDK is on an older version than the API, then the API may respond with new members that
-         *   the SDK is unaware of.
-         * - It was constructed with an arbitrary value using the [of] method.
-         */
-        enum class Value {
-            IN_MEMORY,
-            _24H,
-            /**
-             * An enum member indicating that [PromptCacheRetention] was instantiated with an
-             * unknown value.
-             */
-            _UNKNOWN,
-        }
+                private var input: JsonField<Input> = JsonMissing.of()
+                private var output: JsonField<Output> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
-        /**
-         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
-         * if the class was instantiated with an unknown value.
-         *
-         * Use the [known] method instead if you're certain the value is always known or if you want
-         * to throw for the unknown case.
-         */
-        fun value(): Value =
-            when (this) {
-                IN_MEMORY -> Value.IN_MEMORY
-                _24H -> Value._24H
-                else -> Value._UNKNOWN
-            }
+                @JvmSynthetic
+                internal fun from(policy: Policy) = apply {
+                    input = policy.input
+                    output = policy.output
+                    additionalProperties = policy.additionalProperties.toMutableMap()
+                }
 
-        /**
-         * Returns an enum member corresponding to this class instance's value.
-         *
-         * Use the [value] method instead if you're uncertain the value is always known and don't
-         * want to throw for the unknown case.
-         *
-         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
-         *   member.
-         */
-        fun known(): Known =
-            when (this) {
-                IN_MEMORY -> Known.IN_MEMORY
-                _24H -> Known._24H
-                else -> throw OpenAIInvalidDataException("Unknown PromptCacheRetention: $value")
-            }
+                /** The moderation policy for the response input. */
+                fun input(input: Input?) = input(JsonField.ofNullable(input))
+
+                /** Alias for calling [Builder.input] with `input.orElse(null)`. */
+                fun input(input: Optional<Input>) = input(input.getOrNull())
+
+                /**
+                 * Sets [Builder.input] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.input] with a well-typed [Input] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun input(input: JsonField<Input>) = apply { this.input = input }
+
+                /** The moderation policy for the response output. */
+                fun output(output: Output?) = output(JsonField.ofNullable(output))
+
+                /** Alias for calling [Builder.output] with `output.orElse(null)`. */
+                fun output(output: Optional<Output>) = output(output.getOrNull())
+
+                /**
+                 * Sets [Builder.output] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.output] with a well-typed [Output] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun output(output: JsonField<Output>) = apply { this.output = output }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
 
-        /**
-         * Returns this class instance's primitive wire representation.
-         *
-         * This differs from the [toString] method because that method is primarily for debugging
-         * and generally doesn't throw.
-         *
-         * @throws OpenAIInvalidDataException if this class instance's value does not have the
-         *   expected primitive type.
-         */
-        fun asString(): String =
-            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
 
-        private var validated: Boolean = false
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
 
-        /**
-         * Validates that the types of all values in this object match their expected types
-         * recursively.
-         *
-         * This method is _not_ forwards compatible with new types from the API for existing fields.
-         *
-         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-         *   expected type.
-         */
-        fun validate(): PromptCacheRetention = apply {
-            if (validated) {
-                return@apply
-            }
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
 
-            known()
-            validated = true
-        }
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
 
-        fun isValid(): Boolean =
-            try {
-                validate()
-                true
-            } catch (e: OpenAIInvalidDataException) {
-                false
+                /**
+                 * Returns an immutable instance of [Policy].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): Policy = Policy(input, output, additionalProperties.toMutableMap())
             }
 
-        /**
-         * Returns a score indicating how many valid values are contained in this object
-         * recursively.
-         *
-         * Used for best match union deserialization.
-         */
-        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+            private var validated: Boolean = false
 
-        override fun equals(other: Any?): Boolean {
-            if (this === other) {
-                return true
-            }
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Policy = apply {
+                if (validated) {
+                    return@apply
+                }
 
-            return other is PromptCacheRetention && value == other.value
-        }
+                input().ifPresent { it.validate() }
+                output().ifPresent { it.validate() }
+                validated = true
+            }
 
-        override fun hashCode() = value.hashCode()
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
 
-        override fun toString() = value.toString()
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (input.asKnown().getOrNull()?.validity() ?: 0) +
+                    (output.asKnown().getOrNull()?.validity() ?: 0)
+
+            /** The moderation policy for the response input. */
+            class Input
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val mode: JsonField<Mode>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of()
+                ) : this(mode, mutableMapOf())
+
+                /**
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun mode(): Mode = mode.getRequired("mode")
+
+                /**
+                 * Returns the raw JSON value of [mode].
+                 *
+                 * Unlike [mode], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Input].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .mode()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Input]. */
+                class Builder internal constructor() {
+
+                    private var mode: JsonField<Mode>? = null
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(input: Input) = apply {
+                        mode = input.mode
+                        additionalProperties = input.additionalProperties.toMutableMap()
+                    }
+
+                    fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+                    /**
+                     * Sets [Builder.mode] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.mode] with a well-typed [Mode] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Input].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .mode()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Input =
+                        Input(checkRequired("mode", mode), additionalProperties.toMutableMap())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Input = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    mode().validate()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int = (mode.asKnown().getOrNull()?.validity() ?: 0)
+
+                class Mode @JsonCreator private constructor(private val value: JsonField<String>) :
+                    Enum {
+
+                    /**
+                     * Returns this class instance's raw value.
+                     *
+                     * This is usually only useful if this instance was deserialized from data that
+                     * doesn't match any known member, and you want to know that value. For example,
+                     * if the SDK is on an older version than the API, then the API may respond with
+                     * new members that the SDK is unaware of.
+                     */
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    fun _value(): JsonField<String> = value
+
+                    companion object {
+
+                        @JvmField val SCORE = of("score")
+
+                        @JvmField val BLOCK = of("block")
+
+                        @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+                    }
+
+                    /** An enum containing [Mode]'s known values. */
+                    enum class Known {
+                        SCORE,
+                        BLOCK,
+                    }
+
+                    /**
+                     * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+                     *
+                     * An instance of [Mode] can contain an unknown value in a couple of cases:
+                     * - It was deserialized from data that doesn't match any known member. For
+                     *   example, if the SDK is on an older version than the API, then the API may
+                     *   respond with new members that the SDK is unaware of.
+                     * - It was constructed with an arbitrary value using the [of] method.
+                     */
+                    enum class Value {
+                        SCORE,
+                        BLOCK,
+                        /**
+                         * An enum member indicating that [Mode] was instantiated with an unknown
+                         * value.
+                         */
+                        _UNKNOWN,
+                    }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value, or
+                     * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                     *
+                     * Use the [known] method instead if you're certain the value is always known or
+                     * if you want to throw for the unknown case.
+                     */
+                    fun value(): Value =
+                        when (this) {
+                            SCORE -> Value.SCORE
+                            BLOCK -> Value.BLOCK
+                            else -> Value._UNKNOWN
+                        }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value.
+                     *
+                     * Use the [value] method instead if you're uncertain the value is always known
+                     * and don't want to throw for the unknown case.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                     *   known member.
+                     */
+                    fun known(): Known =
+                        when (this) {
+                            SCORE -> Known.SCORE
+                            BLOCK -> Known.BLOCK
+                            else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                        }
+
+                    /**
+                     * Returns this class instance's primitive wire representation.
+                     *
+                     * This differs from the [toString] method because that method is primarily for
+                     * debugging and generally doesn't throw.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value does not
+                     *   have the expected primitive type.
+                     */
+                    fun asString(): String =
+                        _value().asString().orElseThrow {
+                            OpenAIInvalidDataException("Value is not a String")
+                        }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): Mode = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        known()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Mode && value == other.value
+                    }
+
+                    override fun hashCode() = value.hashCode()
+
+                    override fun toString() = value.toString()
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Input &&
+                        mode == other.mode &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Input{mode=$mode, additionalProperties=$additionalProperties}"
+            }
+
+            /** The moderation policy for the response output. */
+            class Output
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val mode: JsonField<Mode>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of()
+                ) : this(mode, mutableMapOf())
+
+                /**
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun mode(): Mode = mode.getRequired("mode")
+
+                /**
+                 * Returns the raw JSON value of [mode].
+                 *
+                 * Unlike [mode], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Output].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .mode()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Output]. */
+                class Builder internal constructor() {
+
+                    private var mode: JsonField<Mode>? = null
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(output: Output) = apply {
+                        mode = output.mode
+                        additionalProperties = output.additionalProperties.toMutableMap()
+                    }
+
+                    fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+                    /**
+                     * Sets [Builder.mode] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.mode] with a well-typed [Mode] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Output].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .mode()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Output =
+                        Output(checkRequired("mode", mode), additionalProperties.toMutableMap())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Output = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    mode().validate()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int = (mode.asKnown().getOrNull()?.validity() ?: 0)
+
+                class Mode @JsonCreator private constructor(private val value: JsonField<String>) :
+                    Enum {
+
+                    /**
+                     * Returns this class instance's raw value.
+                     *
+                     * This is usually only useful if this instance was deserialized from data that
+                     * doesn't match any known member, and you want to know that value. For example,
+                     * if the SDK is on an older version than the API, then the API may respond with
+                     * new members that the SDK is unaware of.
+                     */
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    fun _value(): JsonField<String> = value
+
+                    companion object {
+
+                        @JvmField val SCORE = of("score")
+
+                        @JvmField val BLOCK = of("block")
+
+                        @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+                    }
+
+                    /** An enum containing [Mode]'s known values. */
+                    enum class Known {
+                        SCORE,
+                        BLOCK,
+                    }
+
+                    /**
+                     * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+                     *
+                     * An instance of [Mode] can contain an unknown value in a couple of cases:
+                     * - It was deserialized from data that doesn't match any known member. For
+                     *   example, if the SDK is on an older version than the API, then the API may
+                     *   respond with new members that the SDK is unaware of.
+                     * - It was constructed with an arbitrary value using the [of] method.
+                     */
+                    enum class Value {
+                        SCORE,
+                        BLOCK,
+                        /**
+                         * An enum member indicating that [Mode] was instantiated with an unknown
+                         * value.
+                         */
+                        _UNKNOWN,
+                    }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value, or
+                     * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                     *
+                     * Use the [known] method instead if you're certain the value is always known or
+                     * if you want to throw for the unknown case.
+                     */
+                    fun value(): Value =
+                        when (this) {
+                            SCORE -> Value.SCORE
+                            BLOCK -> Value.BLOCK
+                            else -> Value._UNKNOWN
+                        }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value.
+                     *
+                     * Use the [value] method instead if you're uncertain the value is always known
+                     * and don't want to throw for the unknown case.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                     *   known member.
+                     */
+                    fun known(): Known =
+                        when (this) {
+                            SCORE -> Known.SCORE
+                            BLOCK -> Known.BLOCK
+                            else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                        }
+
+                    /**
+                     * Returns this class instance's primitive wire representation.
+                     *
+                     * This differs from the [toString] method because that method is primarily for
+                     * debugging and generally doesn't throw.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value does not
+                     *   have the expected primitive type.
+                     */
+                    fun asString(): String =
+                        _value().asString().orElseThrow {
+                            OpenAIInvalidDataException("Value is not a String")
+                        }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): Mode = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        known()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Mode && value == other.value
+                    }
+
+                    override fun hashCode() = value.hashCode()
+
+                    override fun toString() = value.toString()
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Output &&
+                        mode == other.mode &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Output{mode=$mode, additionalProperties=$additionalProperties}"
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Policy &&
+                    input == other.input &&
+                    output == other.output &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(input, output, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Policy{input=$input, output=$output, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Moderation &&
+                model == other.model &&
+                policy == other.policy &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(model, policy, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Moderation{model=$model, policy=$policy, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+     * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+     * content blocks with `prompt_cache_breakpoint`. Each request can write up to four breakpoints.
+     * For cache matching, OpenAI considers up to the latest 80 breakpoints in the conversation,
+     * without a content-block lookback limit. Set `mode` to `explicit` to disable the implicit
+     * breakpoint. The `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for current
+     * details.
+     */
+    class PromptCacheOptions
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonField<Mode>,
+        private val ttl: JsonField<Ttl>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of(),
+            @JsonProperty("ttl") @ExcludeMissing ttl: JsonField<Ttl> = JsonMissing.of(),
+        ) : this(mode, ttl, mutableMapOf())
+
+        /**
+         * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults to
+         * `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up to the
+         * latest three explicit breakpoints in the request. With `explicit`, OpenAI does not create
+         * an implicit breakpoint and writes up to the latest four explicit breakpoints. If there
+         * are no explicit breakpoints, the request does not use prompt caching.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun mode(): Optional<Mode> = mode.getOptional("mode")
+
+        /**
+         * The minimum lifetime applied to every implicit and explicit cache breakpoint written by
+         * the request. Defaults to `30m`, which is currently the only supported value. The backend
+         * may retain cache entries for longer.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun ttl(): Optional<Ttl> = ttl.getOptional("ttl")
+
+        /**
+         * Returns the raw JSON value of [mode].
+         *
+         * Unlike [mode], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+        /**
+         * Returns the raw JSON value of [ttl].
+         *
+         * Unlike [ttl], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("ttl") @ExcludeMissing fun _ttl(): JsonField<Ttl> = ttl
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [PromptCacheOptions]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheOptions]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonField<Mode> = JsonMissing.of()
+            private var ttl: JsonField<Ttl> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheOptions: PromptCacheOptions) = apply {
+                mode = promptCacheOptions.mode
+                ttl = promptCacheOptions.ttl
+                additionalProperties = promptCacheOptions.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults
+             * to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up
+             * to the latest three explicit breakpoints in the request. With `explicit`, OpenAI does
+             * not create an implicit breakpoint and writes up to the latest four explicit
+             * breakpoints. If there are no explicit breakpoints, the request does not use prompt
+             * caching.
+             */
+            fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+            /**
+             * Sets [Builder.mode] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.mode] with a well-typed [Mode] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+            /**
+             * The minimum lifetime applied to every implicit and explicit cache breakpoint written
+             * by the request. Defaults to `30m`, which is currently the only supported value. The
+             * backend may retain cache entries for longer.
+             */
+            fun ttl(ttl: Ttl) = ttl(JsonField.of(ttl))
+
+            /**
+             * Sets [Builder.ttl] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.ttl] with a well-typed [Ttl] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun ttl(ttl: JsonField<Ttl>) = apply { this.ttl = ttl }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheOptions].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheOptions =
+                PromptCacheOptions(mode, ttl, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheOptions = apply {
+            if (validated) {
+                return@apply
+            }
+
+            mode().ifPresent { it.validate() }
+            ttl().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (mode.asKnown().getOrNull()?.validity() ?: 0) +
+                (ttl.asKnown().getOrNull()?.validity() ?: 0)
+
+        /**
+         * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults to
+         * `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up to the
+         * latest three explicit breakpoints in the request. With `explicit`, OpenAI does not create
+         * an implicit breakpoint and writes up to the latest four explicit breakpoints. If there
+         * are no explicit breakpoints, the request does not use prompt caching.
+         */
+        class Mode @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IMPLICIT = of("implicit")
+
+                @JvmField val EXPLICIT = of("explicit")
+
+                @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+            }
+
+            /** An enum containing [Mode]'s known values. */
+            enum class Known {
+                IMPLICIT,
+                EXPLICIT,
+            }
+
+            /**
+             * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Mode] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IMPLICIT,
+                EXPLICIT,
+                /** An enum member indicating that [Mode] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IMPLICIT -> Value.IMPLICIT
+                    EXPLICIT -> Value.EXPLICIT
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IMPLICIT -> Known.IMPLICIT
+                    EXPLICIT -> Known.EXPLICIT
+                    else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Mode = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Mode && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * The minimum lifetime applied to every implicit and explicit cache breakpoint written by
+         * the request. Defaults to `30m`, which is currently the only supported value. The backend
+         * may retain cache entries for longer.
+         */
+        class Ttl @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val _30M = of("30m")
+
+                @JvmStatic fun of(value: String) = Ttl(JsonField.of(value))
+            }
+
+            /** An enum containing [Ttl]'s known values. */
+            enum class Known {
+                _30M
+            }
+
+            /**
+             * An enum containing [Ttl]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Ttl] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                _30M,
+                /** An enum member indicating that [Ttl] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    _30M -> Value._30M
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    _30M -> Known._30M
+                    else -> throw OpenAIInvalidDataException("Unknown Ttl: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Ttl = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Ttl && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheOptions &&
+                mode == other.mode &&
+                ttl == other.ttl &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, ttl, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheOptions{mode=$mode, ttl=$ttl, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Deprecated. Use `prompt_cache_options.ttl` instead.
+     *
+     * The retention policy for the prompt cache. Set to `24h` to enable extended prompt caching,
+     * which keeps cached prefixes active for longer, up to a maximum of 24 hours.
+     * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+     * This field expresses a maximum retention policy, while `prompt_cache_options.ttl` expresses a
+     * minimum cache lifetime. The two fields are independent and do not interact. For `gpt-5.5`,
+     * `gpt-5.5-pro`, and future models, only `24h` is supported.
+     *
+     * For older models that support both `in_memory` and `24h`, the default depends on your
+     * organization's data retention policy:
+     * - Organizations without ZDR enabled default to `24h`.
+     * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is not
+     *   specified.
+     */
+    @Deprecated("deprecated")
+    class PromptCacheRetention
+    @JsonCreator
+    private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_MEMORY = of("in_memory")
+
+            @JvmField val _24H = of("24h")
+
+            @JvmStatic fun of(value: String) = PromptCacheRetention(JsonField.of(value))
+        }
+
+        /** An enum containing [PromptCacheRetention]'s known values. */
+        enum class Known {
+            IN_MEMORY,
+            _24H,
+        }
+
+        /**
+         * An enum containing [PromptCacheRetention]'s known values, as well as an [_UNKNOWN]
+         * member.
+         *
+         * An instance of [PromptCacheRetention] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_MEMORY,
+            _24H,
+            /**
+             * An enum member indicating that [PromptCacheRetention] was instantiated with an
+             * unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_MEMORY -> Value.IN_MEMORY
+                _24H -> Value._24H
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_MEMORY -> Known.IN_MEMORY
+                _24H -> Known._24H
+                else -> throw OpenAIInvalidDataException("Unknown PromptCacheRetention: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheRetention = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheRetention && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
     }
 
     /**
@@ -5160,6 +6685,7 @@ private constructor(
         private val function: ToolChoiceFunction? = null,
         private val mcp: ToolChoiceMcp? = null,
         private val custom: ToolChoiceCustom? = null,
+        private val specificProgrammaticToolCallingParam: JsonValue? = null,
         private val applyPatch: ToolChoiceApplyPatch? = null,
         private val shell: ToolChoiceShell? = null,
         private val _json: JsonValue? = null,
@@ -5195,6 +6721,9 @@ private constructor(
         /** Use this option to force the model to call a specific custom tool. */
         fun custom(): Optional<ToolChoiceCustom> = Optional.ofNullable(custom)
 
+        fun specificProgrammaticToolCallingParam(): Optional<JsonValue> =
+            Optional.ofNullable(specificProgrammaticToolCallingParam)
+
         /** Forces the model to call the apply_patch tool when executing a tool call. */
         fun applyPatch(): Optional<ToolChoiceApplyPatch> = Optional.ofNullable(applyPatch)
 
@@ -5213,6 +6742,9 @@ private constructor(
 
         fun isCustom(): Boolean = custom != null
 
+        fun isSpecificProgrammaticToolCallingParam(): Boolean =
+            specificProgrammaticToolCallingParam != null
+
         fun isApplyPatch(): Boolean = applyPatch != null
 
         fun isShell(): Boolean = shell != null
@@ -5247,6 +6779,9 @@ private constructor(
         /** Use this option to force the model to call a specific custom tool. */
         fun asCustom(): ToolChoiceCustom = custom.getOrThrow("custom")
 
+        fun asSpecificProgrammaticToolCallingParam(): JsonValue =
+            specificProgrammaticToolCallingParam.getOrThrow("specificProgrammaticToolCallingParam")
+
         /** Forces the model to call the apply_patch tool when executing a tool call. */
         fun asApplyPatch(): ToolChoiceApplyPatch = applyPatch.getOrThrow("applyPatch")
 
@@ -5292,6 +6827,10 @@ private constructor(
                 function != null -> visitor.visitFunction(function)
                 mcp != null -> visitor.visitMcp(mcp)
                 custom != null -> visitor.visitCustom(custom)
+                specificProgrammaticToolCallingParam != null ->
+                    visitor.visitSpecificProgrammaticToolCallingParam(
+                        specificProgrammaticToolCallingParam
+                    )
                 applyPatch != null -> visitor.visitApplyPatch(applyPatch)
                 shell != null -> visitor.visitShell(shell)
                 else -> visitor.unknown(_json)
@@ -5339,6 +6878,20 @@ private constructor(
                         custom.validate()
                     }
 
+                    override fun visitSpecificProgrammaticToolCallingParam(
+                        specificProgrammaticToolCallingParam: JsonValue
+                    ) {
+                        specificProgrammaticToolCallingParam.let {
+                            if (
+                                it != JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                            ) {
+                                throw OpenAIInvalidDataException(
+                                    "'specificProgrammaticToolCallingParam' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
                     override fun visitApplyPatch(applyPatch: ToolChoiceApplyPatch) {
                         applyPatch.validate()
                     }
@@ -5381,6 +6934,15 @@ private constructor(
 
                     override fun visitCustom(custom: ToolChoiceCustom) = custom.validity()
 
+                    override fun visitSpecificProgrammaticToolCallingParam(
+                        specificProgrammaticToolCallingParam: JsonValue
+                    ) =
+                        specificProgrammaticToolCallingParam.let {
+                            if (it == JsonValue.from(mapOf("type" to "programmatic_tool_calling")))
+                                1
+                            else 0
+                        }
+
                     override fun visitApplyPatch(applyPatch: ToolChoiceApplyPatch) =
                         applyPatch.validity()
 
@@ -5402,12 +6964,24 @@ private constructor(
                 function == other.function &&
                 mcp == other.mcp &&
                 custom == other.custom &&
+                specificProgrammaticToolCallingParam ==
+                    other.specificProgrammaticToolCallingParam &&
                 applyPatch == other.applyPatch &&
                 shell == other.shell
         }
 
         override fun hashCode(): Int =
-            Objects.hash(options, allowed, types, function, mcp, custom, applyPatch, shell)
+            Objects.hash(
+                options,
+                allowed,
+                types,
+                function,
+                mcp,
+                custom,
+                specificProgrammaticToolCallingParam,
+                applyPatch,
+                shell,
+            )
 
         override fun toString(): String =
             when {
@@ -5417,6 +6991,8 @@ private constructor(
                 function != null -> "ToolChoice{function=$function}"
                 mcp != null -> "ToolChoice{mcp=$mcp}"
                 custom != null -> "ToolChoice{custom=$custom}"
+                specificProgrammaticToolCallingParam != null ->
+                    "ToolChoice{specificProgrammaticToolCallingParam=$specificProgrammaticToolCallingParam}"
                 applyPatch != null -> "ToolChoice{applyPatch=$applyPatch}"
                 shell != null -> "ToolChoice{shell=$shell}"
                 _json != null -> "ToolChoice{_unknown=$_json}"
@@ -5458,6 +7034,13 @@ private constructor(
             /** Use this option to force the model to call a specific custom tool. */
             @JvmStatic fun ofCustom(custom: ToolChoiceCustom) = ToolChoice(custom = custom)
 
+            @JvmStatic
+            fun ofSpecificProgrammaticToolCallingParam() =
+                ToolChoice(
+                    specificProgrammaticToolCallingParam =
+                        JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                )
+
             /** Forces the model to call the apply_patch tool when executing a tool call. */
             @JvmStatic
             fun ofApplyPatch(applyPatch: ToolChoiceApplyPatch) = ToolChoice(applyPatch = applyPatch)
@@ -5503,6 +7086,10 @@ private constructor(
             /** Use this option to force the model to call a specific custom tool. */
             fun visitCustom(custom: ToolChoiceCustom): T
 
+            fun visitSpecificProgrammaticToolCallingParam(
+                specificProgrammaticToolCallingParam: JsonValue
+            ): T
+
             /** Forces the model to call the apply_patch tool when executing a tool call. */
             fun visitApplyPatch(applyPatch: ToolChoiceApplyPatch): T
 
@@ -5531,6 +7118,14 @@ private constructor(
 
                 val bestMatches =
                     sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let {
+                                    ToolChoice(
+                                        specificProgrammaticToolCallingParam = it,
+                                        _json = json,
+                                    )
+                                }
+                                ?.takeIf { it.isValid() },
                             tryDeserialize(node, jacksonTypeRef<ToolChoiceOptions>())?.let {
                                 ToolChoice(options = it, _json = json)
                             },
@@ -5586,6 +7181,8 @@ private constructor(
                     value.function != null -> generator.writeObject(value.function)
                     value.mcp != null -> generator.writeObject(value.mcp)
                     value.custom != null -> generator.writeObject(value.custom)
+                    value.specificProgrammaticToolCallingParam != null ->
+                        generator.writeObject(value.specificProgrammaticToolCallingParam)
                     value.applyPatch != null -> generator.writeObject(value.applyPatch)
                     value.shell != null -> generator.writeObject(value.shell)
                     value._json != null -> generator.writeObject(value._json)
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCustomToolCall.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCustomToolCall.kt
index a76c9a7b3..de5c5b466 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCustomToolCall.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCustomToolCall.kt
@@ -6,15 +6,26 @@ import com.fasterxml.jackson.annotation.JsonAnyGetter
 import com.fasterxml.jackson.annotation.JsonAnySetter
 import com.fasterxml.jackson.annotation.JsonCreator
 import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
 import com.openai.core.ExcludeMissing
 import com.openai.core.JsonField
 import com.openai.core.JsonMissing
 import com.openai.core.JsonValue
 import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
 import com.openai.errors.OpenAIInvalidDataException
 import java.util.Collections
 import java.util.Objects
 import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
 
 /** A call to a custom tool created by the model. */
 class ResponseCustomToolCall
@@ -25,6 +36,7 @@ private constructor(
     private val name: JsonField<String>,
     private val type: JsonValue,
     private val id: JsonField<String>,
+    private val caller: JsonField<Caller>,
     private val namespace: JsonField<String>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
@@ -36,8 +48,9 @@ private constructor(
         @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
         @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
         @JsonProperty("namespace") @ExcludeMissing namespace: JsonField<String> = JsonMissing.of(),
-    ) : this(callId, input, name, type, id, namespace, mutableMapOf())
+    ) : this(callId, input, name, type, id, caller, namespace, mutableMapOf())
 
     /**
      * An identifier used to map this custom tool call to a tool call output.
@@ -84,6 +97,14 @@ private constructor(
      */
     fun id(): Optional<String> = id.getOptional("id")
 
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<Caller> = caller.getOptional("caller")
+
     /**
      * The namespace of the custom tool being called.
      *
@@ -120,6 +141,13 @@ private constructor(
      */
     @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
     /**
      * Returns the raw JSON value of [namespace].
      *
@@ -162,6 +190,7 @@ private constructor(
         private var name: JsonField<String>? = null
         private var type: JsonValue = JsonValue.from("custom_tool_call")
         private var id: JsonField<String> = JsonMissing.of()
+        private var caller: JsonField<Caller> = JsonMissing.of()
         private var namespace: JsonField<String> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
@@ -172,6 +201,7 @@ private constructor(
             name = responseCustomToolCall.name
             type = responseCustomToolCall.type
             id = responseCustomToolCall.id
+            caller = responseCustomToolCall.caller
             namespace = responseCustomToolCall.namespace
             additionalProperties = responseCustomToolCall.additionalProperties.toMutableMap()
         }
@@ -234,6 +264,37 @@ private constructor(
          */
         fun id(id: JsonField<String>) = apply { this.id = id }
 
+        /** The execution context that produced this tool call. */
+        fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed [Caller] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+        /** Alias for calling [caller] with `Caller.ofDirect()`. */
+        fun callerDirect() = caller(Caller.ofDirect())
+
+        /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+        fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(Caller.Program.builder().callerId(callerId).build())
+
         /** The namespace of the custom tool being called. */
         fun namespace(namespace: String) = namespace(JsonField.of(namespace))
 
@@ -286,6 +347,7 @@ private constructor(
                 checkRequired("name", name),
                 type,
                 id,
+                caller,
                 namespace,
                 additionalProperties.toMutableMap(),
             )
@@ -315,6 +377,7 @@ private constructor(
             }
         }
         id()
+        caller().ifPresent { it.validate() }
         namespace()
         validated = true
     }
@@ -339,8 +402,434 @@ private constructor(
             (if (name.asKnown().isPresent) 1 else 0) +
             type.let { if (it == JsonValue.from("custom_tool_call")) 1 else 0 } +
             (if (id.asKnown().isPresent) 1 else 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
             (if (namespace.asKnown().isPresent) 1 else 0)
 
+    /** The execution context that produced this tool call. */
+    @JsonDeserialize(using = Caller.Deserializer::class)
+    @JsonSerialize(using = Caller.Serializer::class)
+    class Caller
+    private constructor(
+        private val direct: JsonValue? = null,
+        private val program: Program? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+        fun program(): Optional<Program> = Optional.ofNullable(program)
+
+        fun isDirect(): Boolean = direct != null
+
+        fun isProgram(): Boolean = program != null
+
+        fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+        fun asProgram(): Program = program.getOrThrow("program")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDirect(JsonValue direct) {
+         *         return Optional.of(direct.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                direct != null -> visitor.visitDirect(direct)
+                program != null -> visitor.visitProgram(program)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Caller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDirect(direct: JsonValue) {
+                        direct.let {
+                            if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'direct' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitProgram(program: Program) {
+                        program.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDirect(direct: JsonValue) =
+                        direct.let { if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0 }
+
+                    override fun visitProgram(program: Program) = program.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Caller && direct == other.direct && program == other.program
+        }
+
+        override fun hashCode(): Int = Objects.hash(direct, program)
+
+        override fun toString(): String =
+            when {
+                direct != null -> "Caller{direct=$direct}"
+                program != null -> "Caller{program=$program}"
+                _json != null -> "Caller{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Caller")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+            @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+        }
+
+        /** An interface that defines how to map each variant of [Caller] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitDirect(direct: JsonValue): T
+
+            fun visitProgram(program: Program): T
+
+            /**
+             * Maps an unknown variant of [Caller] to a value of type [T].
+             *
+             * An instance of [Caller] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Caller: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "direct" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Caller(direct = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                    }
+                    "program" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                            Caller(program = it, _json = json)
+                        } ?: Caller(_json = json)
+                    }
+                }
+
+                return Caller(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+            override fun serialize(
+                value: Caller,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.direct != null -> generator.writeObject(value.direct)
+                    value.program != null -> generator.writeObject(value.program)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+            }
+        }
+
+        class Program
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val callerId: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                callerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(callerId, type, mutableMapOf())
+
+            /**
+             * The call ID of the program item that produced this tool call.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun callerId(): String = callerId.getRequired("caller_id")
+
+            /**
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [callerId].
+             *
+             * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("caller_id") @ExcludeMissing fun _callerId(): JsonField<String> = callerId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Program].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Program]. */
+            class Builder internal constructor() {
+
+                private var callerId: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("program")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(program: Program) = apply {
+                    callerId = program.callerId
+                    type = program.type
+                    additionalProperties = program.additionalProperties.toMutableMap()
+                }
+
+                /** The call ID of the program item that produced this tool call. */
+                fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                /**
+                 * Sets [Builder.callerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.callerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Program].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Program =
+                    Program(
+                        checkRequired("callerId", callerId),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Program = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                callerId()
+                _type().let {
+                    if (it != JsonValue.from("program")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (callerId.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Program &&
+                    callerId == other.callerId &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(callerId, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -352,16 +841,17 @@ private constructor(
             name == other.name &&
             type == other.type &&
             id == other.id &&
+            caller == other.caller &&
             namespace == other.namespace &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(callId, input, name, type, id, namespace, additionalProperties)
+        Objects.hash(callId, input, name, type, id, caller, namespace, additionalProperties)
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseCustomToolCall{callId=$callId, input=$input, name=$name, type=$type, id=$id, namespace=$namespace, additionalProperties=$additionalProperties}"
+        "ResponseCustomToolCall{callId=$callId, input=$input, name=$name, type=$type, id=$id, caller=$caller, namespace=$namespace, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCustomToolCallItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCustomToolCallItem.kt
index f099b0c0b..fdca197d5 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCustomToolCallItem.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCustomToolCallItem.kt
@@ -27,6 +27,7 @@ private constructor(
     private val name: JsonField<String>,
     private val type: JsonValue,
     private val id: JsonField<String>,
+    private val caller: JsonField<ResponseCustomToolCall.Caller>,
     private val namespace: JsonField<String>,
     private val status: JsonField<Status>,
     private val createdBy: JsonField<String>,
@@ -40,10 +41,13 @@ private constructor(
         @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
         @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("caller")
+        @ExcludeMissing
+        caller: JsonField<ResponseCustomToolCall.Caller> = JsonMissing.of(),
         @JsonProperty("namespace") @ExcludeMissing namespace: JsonField<String> = JsonMissing.of(),
         @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
         @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
-    ) : this(callId, input, name, type, id, namespace, status, createdBy, mutableMapOf())
+    ) : this(callId, input, name, type, id, caller, namespace, status, createdBy, mutableMapOf())
 
     fun toResponseCustomToolCall(): ResponseCustomToolCall =
         ResponseCustomToolCall.builder()
@@ -52,6 +56,7 @@ private constructor(
             .name(name)
             .type(type)
             .id(id)
+            .caller(caller)
             .namespace(namespace)
             .build()
 
@@ -100,6 +105,14 @@ private constructor(
      */
     fun id(): Optional<String> = id.getOptional("id")
 
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<ResponseCustomToolCall.Caller> = caller.getOptional("caller")
+
     /**
      * The namespace of the custom tool being called.
      *
@@ -153,6 +166,15 @@ private constructor(
      */
     @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller")
+    @ExcludeMissing
+    fun _caller(): JsonField<ResponseCustomToolCall.Caller> = caller
+
     /**
      * Returns the raw JSON value of [namespace].
      *
@@ -210,6 +232,7 @@ private constructor(
         private var name: JsonField<String>? = null
         private var type: JsonValue = JsonValue.from("custom_tool_call")
         private var id: JsonField<String> = JsonMissing.of()
+        private var caller: JsonField<ResponseCustomToolCall.Caller> = JsonMissing.of()
         private var namespace: JsonField<String> = JsonMissing.of()
         private var status: JsonField<Status>? = null
         private var createdBy: JsonField<String> = JsonMissing.of()
@@ -222,6 +245,7 @@ private constructor(
             name = responseCustomToolCallItem.name
             type = responseCustomToolCallItem.type
             id = responseCustomToolCallItem.id
+            caller = responseCustomToolCallItem.caller
             namespace = responseCustomToolCallItem.namespace
             status = responseCustomToolCallItem.status
             createdBy = responseCustomToolCallItem.createdBy
@@ -286,6 +310,41 @@ private constructor(
          */
         fun id(id: JsonField<String>) = apply { this.id = id }
 
+        /** The execution context that produced this tool call. */
+        fun caller(caller: ResponseCustomToolCall.Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<ResponseCustomToolCall.Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed
+         * [ResponseCustomToolCall.Caller] value instead. This method is primarily for setting the
+         * field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<ResponseCustomToolCall.Caller>) = apply {
+            this.caller = caller
+        }
+
+        /** Alias for calling [caller] with `ResponseCustomToolCall.Caller.ofDirect()`. */
+        fun callerDirect() = caller(ResponseCustomToolCall.Caller.ofDirect())
+
+        /** Alias for calling [caller] with `ResponseCustomToolCall.Caller.ofProgram(program)`. */
+        fun caller(program: ResponseCustomToolCall.Caller.Program) =
+            caller(ResponseCustomToolCall.Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * ResponseCustomToolCall.Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(ResponseCustomToolCall.Caller.Program.builder().callerId(callerId).build())
+
         /** The namespace of the custom tool being called. */
         fun namespace(namespace: String) = namespace(JsonField.of(namespace))
 
@@ -365,6 +424,7 @@ private constructor(
                 checkRequired("name", name),
                 type,
                 id,
+                caller,
                 namespace,
                 checkRequired("status", status),
                 createdBy,
@@ -396,6 +456,7 @@ private constructor(
             }
         }
         id()
+        caller().ifPresent { it.validate() }
         namespace()
         status().validate()
         createdBy()
@@ -422,6 +483,7 @@ private constructor(
             (if (name.asKnown().isPresent) 1 else 0) +
             type.let { if (it == JsonValue.from("custom_tool_call")) 1 else 0 } +
             (if (id.asKnown().isPresent) 1 else 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
             (if (namespace.asKnown().isPresent) 1 else 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0) +
             (if (createdBy.asKnown().isPresent) 1 else 0)
@@ -581,6 +643,7 @@ private constructor(
             name == other.name &&
             type == other.type &&
             id == other.id &&
+            caller == other.caller &&
             namespace == other.namespace &&
             status == other.status &&
             createdBy == other.createdBy &&
@@ -594,6 +657,7 @@ private constructor(
             name,
             type,
             id,
+            caller,
             namespace,
             status,
             createdBy,
@@ -604,5 +668,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseCustomToolCallItem{callId=$callId, input=$input, name=$name, type=$type, id=$id, namespace=$namespace, status=$status, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+        "ResponseCustomToolCallItem{callId=$callId, input=$input, name=$name, type=$type, id=$id, caller=$caller, namespace=$namespace, status=$status, createdBy=$createdBy, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCustomToolCallOutput.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCustomToolCallOutput.kt
index fcf6f86c5..306e497a2 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCustomToolCallOutput.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCustomToolCallOutput.kt
@@ -37,6 +37,7 @@ private constructor(
     private val output: JsonField<Output>,
     private val type: JsonValue,
     private val id: JsonField<String>,
+    private val caller: JsonField<Caller>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -46,7 +47,8 @@ private constructor(
         @JsonProperty("output") @ExcludeMissing output: JsonField<Output> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
         @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-    ) : this(callId, output, type, id, mutableMapOf())
+        @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+    ) : this(callId, output, type, id, caller, mutableMapOf())
 
     /**
      * The call ID, used to map this custom tool call output to a custom tool call.
@@ -86,6 +88,14 @@ private constructor(
      */
     fun id(): Optional<String> = id.getOptional("id")
 
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<Caller> = caller.getOptional("caller")
+
     /**
      * Returns the raw JSON value of [callId].
      *
@@ -107,6 +117,13 @@ private constructor(
      */
     @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -140,6 +157,7 @@ private constructor(
         private var output: JsonField<Output>? = null
         private var type: JsonValue = JsonValue.from("custom_tool_call_output")
         private var id: JsonField<String> = JsonMissing.of()
+        private var caller: JsonField<Caller> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -148,6 +166,7 @@ private constructor(
             output = responseCustomToolCallOutput.output
             type = responseCustomToolCallOutput.type
             id = responseCustomToolCallOutput.id
+            caller = responseCustomToolCallOutput.caller
             additionalProperties = responseCustomToolCallOutput.additionalProperties.toMutableMap()
         }
 
@@ -208,6 +227,37 @@ private constructor(
          */
         fun id(id: JsonField<String>) = apply { this.id = id }
 
+        /** The execution context that produced this tool call. */
+        fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed [Caller] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+        /** Alias for calling [caller] with `Caller.ofDirect()`. */
+        fun callerDirect() = caller(Caller.ofDirect())
+
+        /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+        fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(Caller.Program.builder().callerId(callerId).build())
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -246,6 +296,7 @@ private constructor(
                 checkRequired("output", output),
                 type,
                 id,
+                caller,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -273,6 +324,7 @@ private constructor(
             }
         }
         id()
+        caller().ifPresent { it.validate() }
         validated = true
     }
 
@@ -294,7 +346,8 @@ private constructor(
         (if (callId.asKnown().isPresent) 1 else 0) +
             (output.asKnown().getOrNull()?.validity() ?: 0) +
             type.let { if (it == JsonValue.from("custom_tool_call_output")) 1 else 0 } +
-            (if (id.asKnown().isPresent) 1 else 0)
+            (if (id.asKnown().isPresent) 1 else 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0)
 
     /**
      * The output from the custom tool call generated by your code. Can be a string or an list of
@@ -806,6 +859,433 @@ private constructor(
         }
     }
 
+    /** The execution context that produced this tool call. */
+    @JsonDeserialize(using = Caller.Deserializer::class)
+    @JsonSerialize(using = Caller.Serializer::class)
+    class Caller
+    private constructor(
+        private val direct: JsonValue? = null,
+        private val program: Program? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+        fun program(): Optional<Program> = Optional.ofNullable(program)
+
+        fun isDirect(): Boolean = direct != null
+
+        fun isProgram(): Boolean = program != null
+
+        fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+        fun asProgram(): Program = program.getOrThrow("program")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDirect(JsonValue direct) {
+         *         return Optional.of(direct.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                direct != null -> visitor.visitDirect(direct)
+                program != null -> visitor.visitProgram(program)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Caller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDirect(direct: JsonValue) {
+                        direct.let {
+                            if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'direct' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitProgram(program: Program) {
+                        program.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDirect(direct: JsonValue) =
+                        direct.let { if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0 }
+
+                    override fun visitProgram(program: Program) = program.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Caller && direct == other.direct && program == other.program
+        }
+
+        override fun hashCode(): Int = Objects.hash(direct, program)
+
+        override fun toString(): String =
+            when {
+                direct != null -> "Caller{direct=$direct}"
+                program != null -> "Caller{program=$program}"
+                _json != null -> "Caller{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Caller")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+            @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+        }
+
+        /** An interface that defines how to map each variant of [Caller] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitDirect(direct: JsonValue): T
+
+            fun visitProgram(program: Program): T
+
+            /**
+             * Maps an unknown variant of [Caller] to a value of type [T].
+             *
+             * An instance of [Caller] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Caller: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "direct" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Caller(direct = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                    }
+                    "program" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                            Caller(program = it, _json = json)
+                        } ?: Caller(_json = json)
+                    }
+                }
+
+                return Caller(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+            override fun serialize(
+                value: Caller,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.direct != null -> generator.writeObject(value.direct)
+                    value.program != null -> generator.writeObject(value.program)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+            }
+        }
+
+        class Program
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val callerId: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                callerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(callerId, type, mutableMapOf())
+
+            /**
+             * The call ID of the program item that produced this tool call.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun callerId(): String = callerId.getRequired("caller_id")
+
+            /**
+             * The caller type. Always `program`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [callerId].
+             *
+             * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("caller_id") @ExcludeMissing fun _callerId(): JsonField<String> = callerId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Program].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Program]. */
+            class Builder internal constructor() {
+
+                private var callerId: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("program")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(program: Program) = apply {
+                    callerId = program.callerId
+                    type = program.type
+                    additionalProperties = program.additionalProperties.toMutableMap()
+                }
+
+                /** The call ID of the program item that produced this tool call. */
+                fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                /**
+                 * Sets [Builder.callerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.callerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Program].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Program =
+                    Program(
+                        checkRequired("callerId", callerId),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Program = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                callerId()
+                _type().let {
+                    if (it != JsonValue.from("program")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (callerId.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Program &&
+                    callerId == other.callerId &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(callerId, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -816,15 +1296,16 @@ private constructor(
             output == other.output &&
             type == other.type &&
             id == other.id &&
+            caller == other.caller &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(callId, output, type, id, additionalProperties)
+        Objects.hash(callId, output, type, id, caller, additionalProperties)
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseCustomToolCallOutput{callId=$callId, output=$output, type=$type, id=$id, additionalProperties=$additionalProperties}"
+        "ResponseCustomToolCallOutput{callId=$callId, output=$output, type=$type, id=$id, caller=$caller, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCustomToolCallOutputItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCustomToolCallOutputItem.kt
index bec077d39..cfb24cc0b 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCustomToolCallOutputItem.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCustomToolCallOutputItem.kt
@@ -26,6 +26,7 @@ private constructor(
     private val output: JsonField<ResponseCustomToolCallOutput.Output>,
     private val type: JsonValue,
     private val id: JsonField<String>,
+    private val caller: JsonField<ResponseCustomToolCallOutput.Caller>,
     private val status: JsonField<Status>,
     private val createdBy: JsonField<String>,
     private val additionalProperties: MutableMap<String, JsonValue>,
@@ -39,9 +40,12 @@ private constructor(
         output: JsonField<ResponseCustomToolCallOutput.Output> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
         @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("caller")
+        @ExcludeMissing
+        caller: JsonField<ResponseCustomToolCallOutput.Caller> = JsonMissing.of(),
         @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
         @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
-    ) : this(callId, output, type, id, status, createdBy, mutableMapOf())
+    ) : this(callId, output, type, id, caller, status, createdBy, mutableMapOf())
 
     fun toResponseCustomToolCallOutput(): ResponseCustomToolCallOutput =
         ResponseCustomToolCallOutput.builder()
@@ -49,6 +53,7 @@ private constructor(
             .output(output)
             .type(type)
             .id(id)
+            .caller(caller)
             .build()
 
     /**
@@ -89,6 +94,14 @@ private constructor(
      */
     fun id(): Optional<String> = id.getOptional("id")
 
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<ResponseCustomToolCallOutput.Caller> = caller.getOptional("caller")
+
     /**
      * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when
      * items are returned via API.
@@ -129,6 +142,15 @@ private constructor(
      */
     @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller")
+    @ExcludeMissing
+    fun _caller(): JsonField<ResponseCustomToolCallOutput.Caller> = caller
+
     /**
      * Returns the raw JSON value of [status].
      *
@@ -178,6 +200,7 @@ private constructor(
         private var output: JsonField<ResponseCustomToolCallOutput.Output>? = null
         private var type: JsonValue = JsonValue.from("custom_tool_call_output")
         private var id: JsonField<String> = JsonMissing.of()
+        private var caller: JsonField<ResponseCustomToolCallOutput.Caller> = JsonMissing.of()
         private var status: JsonField<Status>? = null
         private var createdBy: JsonField<String> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
@@ -189,6 +212,7 @@ private constructor(
                 output = responseCustomToolCallOutputItem.output
                 type = responseCustomToolCallOutputItem.type
                 id = responseCustomToolCallOutputItem.id
+                caller = responseCustomToolCallOutputItem.caller
                 status = responseCustomToolCallOutputItem.status
                 createdBy = responseCustomToolCallOutputItem.createdBy
                 additionalProperties =
@@ -261,6 +285,45 @@ private constructor(
          */
         fun id(id: JsonField<String>) = apply { this.id = id }
 
+        /** The execution context that produced this tool call. */
+        fun caller(caller: ResponseCustomToolCallOutput.Caller?) =
+            caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<ResponseCustomToolCallOutput.Caller>) =
+            caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed
+         * [ResponseCustomToolCallOutput.Caller] value instead. This method is primarily for setting
+         * the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<ResponseCustomToolCallOutput.Caller>) = apply {
+            this.caller = caller
+        }
+
+        /** Alias for calling [caller] with `ResponseCustomToolCallOutput.Caller.ofDirect()`. */
+        fun callerDirect() = caller(ResponseCustomToolCallOutput.Caller.ofDirect())
+
+        /**
+         * Alias for calling [caller] with `ResponseCustomToolCallOutput.Caller.ofProgram(program)`.
+         */
+        fun caller(program: ResponseCustomToolCallOutput.Caller.Program) =
+            caller(ResponseCustomToolCallOutput.Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * ResponseCustomToolCallOutput.Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(ResponseCustomToolCallOutput.Caller.Program.builder().callerId(callerId).build())
+
         /**
          * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated
          * when items are returned via API.
@@ -326,6 +389,7 @@ private constructor(
                 checkRequired("output", output),
                 type,
                 id,
+                caller,
                 checkRequired("status", status),
                 createdBy,
                 additionalProperties.toMutableMap(),
@@ -355,6 +419,7 @@ private constructor(
             }
         }
         id()
+        caller().ifPresent { it.validate() }
         status().validate()
         createdBy()
         validated = true
@@ -379,6 +444,7 @@ private constructor(
             (output.asKnown().getOrNull()?.validity() ?: 0) +
             type.let { if (it == JsonValue.from("custom_tool_call_output")) 1 else 0 } +
             (if (id.asKnown().isPresent) 1 else 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0) +
             (if (createdBy.asKnown().isPresent) 1 else 0)
 
@@ -536,17 +602,18 @@ private constructor(
             output == other.output &&
             type == other.type &&
             id == other.id &&
+            caller == other.caller &&
             status == other.status &&
             createdBy == other.createdBy &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(callId, output, type, id, status, createdBy, additionalProperties)
+        Objects.hash(callId, output, type, id, caller, status, createdBy, additionalProperties)
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseCustomToolCallOutputItem{callId=$callId, output=$output, type=$type, id=$id, status=$status, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+        "ResponseCustomToolCallOutputItem{callId=$callId, output=$output, type=$type, id=$id, caller=$caller, status=$status, createdBy=$createdBy, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseError.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseError.kt
index 011de28b3..cc186b5f6 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseError.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseError.kt
@@ -222,6 +222,8 @@ private constructor(
 
             @JvmField val INVALID_PROMPT = of("invalid_prompt")
 
+            @JvmField val BIO_POLICY = of("bio_policy")
+
             @JvmField val VECTOR_STORE_TIMEOUT = of("vector_store_timeout")
 
             @JvmField val INVALID_IMAGE = of("invalid_image")
@@ -260,6 +262,7 @@ private constructor(
             SERVER_ERROR,
             RATE_LIMIT_EXCEEDED,
             INVALID_PROMPT,
+            BIO_POLICY,
             VECTOR_STORE_TIMEOUT,
             INVALID_IMAGE,
             INVALID_IMAGE_FORMAT,
@@ -290,6 +293,7 @@ private constructor(
             SERVER_ERROR,
             RATE_LIMIT_EXCEEDED,
             INVALID_PROMPT,
+            BIO_POLICY,
             VECTOR_STORE_TIMEOUT,
             INVALID_IMAGE,
             INVALID_IMAGE_FORMAT,
@@ -321,6 +325,7 @@ private constructor(
                 SERVER_ERROR -> Value.SERVER_ERROR
                 RATE_LIMIT_EXCEEDED -> Value.RATE_LIMIT_EXCEEDED
                 INVALID_PROMPT -> Value.INVALID_PROMPT
+                BIO_POLICY -> Value.BIO_POLICY
                 VECTOR_STORE_TIMEOUT -> Value.VECTOR_STORE_TIMEOUT
                 INVALID_IMAGE -> Value.INVALID_IMAGE
                 INVALID_IMAGE_FORMAT -> Value.INVALID_IMAGE_FORMAT
@@ -353,6 +358,7 @@ private constructor(
                 SERVER_ERROR -> Known.SERVER_ERROR
                 RATE_LIMIT_EXCEEDED -> Known.RATE_LIMIT_EXCEEDED
                 INVALID_PROMPT -> Known.INVALID_PROMPT
+                BIO_POLICY -> Known.BIO_POLICY
                 VECTOR_STORE_TIMEOUT -> Known.VECTOR_STORE_TIMEOUT
                 INVALID_IMAGE -> Known.INVALID_IMAGE
                 INVALID_IMAGE_FORMAT -> Known.INVALID_IMAGE_FORMAT
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionShellToolCall.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionShellToolCall.kt
index 1fdb5151d..02aa01d58 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionShellToolCall.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionShellToolCall.kt
@@ -40,6 +40,7 @@ private constructor(
     private val environment: JsonField<Environment>,
     private val status: JsonField<Status>,
     private val type: JsonValue,
+    private val caller: JsonField<Caller>,
     private val createdBy: JsonField<String>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
@@ -54,8 +55,9 @@ private constructor(
         environment: JsonField<Environment> = JsonMissing.of(),
         @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
         @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
-    ) : this(id, action, callId, environment, status, type, createdBy, mutableMapOf())
+    ) : this(id, action, callId, environment, status, type, caller, createdBy, mutableMapOf())
 
     /**
      * The unique ID of the shell tool call. Populated when this item is returned via API.
@@ -110,6 +112,14 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<Caller> = caller.getOptional("caller")
+
     /**
      * The ID of the entity that created this tool call.
      *
@@ -155,6 +165,13 @@ private constructor(
      */
     @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
 
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
     /**
      * Returns the raw JSON value of [createdBy].
      *
@@ -201,6 +218,7 @@ private constructor(
         private var environment: JsonField<Environment>? = null
         private var status: JsonField<Status>? = null
         private var type: JsonValue = JsonValue.from("shell_call")
+        private var caller: JsonField<Caller> = JsonMissing.of()
         private var createdBy: JsonField<String> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
@@ -212,6 +230,7 @@ private constructor(
             environment = responseFunctionShellToolCall.environment
             status = responseFunctionShellToolCall.status
             type = responseFunctionShellToolCall.type
+            caller = responseFunctionShellToolCall.caller
             createdBy = responseFunctionShellToolCall.createdBy
             additionalProperties = responseFunctionShellToolCall.additionalProperties.toMutableMap()
         }
@@ -312,6 +331,37 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /** The execution context that produced this tool call. */
+        fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed [Caller] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+        /** Alias for calling [caller] with `Caller.ofDirect()`. */
+        fun callerDirect() = caller(Caller.ofDirect())
+
+        /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+        fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(Caller.Program.builder().callerId(callerId).build())
+
         /** The ID of the entity that created this tool call. */
         fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
 
@@ -367,6 +417,7 @@ private constructor(
                 checkRequired("environment", environment),
                 checkRequired("status", status),
                 type,
+                caller,
                 createdBy,
                 additionalProperties.toMutableMap(),
             )
@@ -397,6 +448,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        caller().ifPresent { it.validate() }
         createdBy()
         validated = true
     }
@@ -422,6 +474,7 @@ private constructor(
             (environment.asKnown().getOrNull()?.validity() ?: 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0) +
             type.let { if (it == JsonValue.from("shell_call")) 1 else 0 } +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
             (if (createdBy.asKnown().isPresent) 1 else 0)
 
     /** The shell commands and limits that describe how to run the tool call. */
@@ -1083,6 +1136,431 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /** The execution context that produced this tool call. */
+    @JsonDeserialize(using = Caller.Deserializer::class)
+    @JsonSerialize(using = Caller.Serializer::class)
+    class Caller
+    private constructor(
+        private val direct: JsonValue? = null,
+        private val program: Program? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+        fun program(): Optional<Program> = Optional.ofNullable(program)
+
+        fun isDirect(): Boolean = direct != null
+
+        fun isProgram(): Boolean = program != null
+
+        fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+        fun asProgram(): Program = program.getOrThrow("program")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDirect(JsonValue direct) {
+         *         return Optional.of(direct.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                direct != null -> visitor.visitDirect(direct)
+                program != null -> visitor.visitProgram(program)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Caller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDirect(direct: JsonValue) {
+                        direct.let {
+                            if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'direct' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitProgram(program: Program) {
+                        program.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDirect(direct: JsonValue) =
+                        direct.let { if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0 }
+
+                    override fun visitProgram(program: Program) = program.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Caller && direct == other.direct && program == other.program
+        }
+
+        override fun hashCode(): Int = Objects.hash(direct, program)
+
+        override fun toString(): String =
+            when {
+                direct != null -> "Caller{direct=$direct}"
+                program != null -> "Caller{program=$program}"
+                _json != null -> "Caller{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Caller")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+            @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+        }
+
+        /** An interface that defines how to map each variant of [Caller] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitDirect(direct: JsonValue): T
+
+            fun visitProgram(program: Program): T
+
+            /**
+             * Maps an unknown variant of [Caller] to a value of type [T].
+             *
+             * An instance of [Caller] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Caller: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "direct" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Caller(direct = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                    }
+                    "program" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                            Caller(program = it, _json = json)
+                        } ?: Caller(_json = json)
+                    }
+                }
+
+                return Caller(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+            override fun serialize(
+                value: Caller,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.direct != null -> generator.writeObject(value.direct)
+                    value.program != null -> generator.writeObject(value.program)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+            }
+        }
+
+        class Program
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val callerId: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                callerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(callerId, type, mutableMapOf())
+
+            /**
+             * The call ID of the program item that produced this tool call.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun callerId(): String = callerId.getRequired("caller_id")
+
+            /**
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [callerId].
+             *
+             * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("caller_id") @ExcludeMissing fun _callerId(): JsonField<String> = callerId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Program].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Program]. */
+            class Builder internal constructor() {
+
+                private var callerId: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("program")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(program: Program) = apply {
+                    callerId = program.callerId
+                    type = program.type
+                    additionalProperties = program.additionalProperties.toMutableMap()
+                }
+
+                /** The call ID of the program item that produced this tool call. */
+                fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                /**
+                 * Sets [Builder.callerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.callerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Program].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Program =
+                    Program(
+                        checkRequired("callerId", callerId),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Program = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                callerId()
+                _type().let {
+                    if (it != JsonValue.from("program")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (callerId.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Program &&
+                    callerId == other.callerId &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(callerId, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -1095,16 +1573,27 @@ private constructor(
             environment == other.environment &&
             status == other.status &&
             type == other.type &&
+            caller == other.caller &&
             createdBy == other.createdBy &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(id, action, callId, environment, status, type, createdBy, additionalProperties)
+        Objects.hash(
+            id,
+            action,
+            callId,
+            environment,
+            status,
+            type,
+            caller,
+            createdBy,
+            additionalProperties,
+        )
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseFunctionShellToolCall{id=$id, action=$action, callId=$callId, environment=$environment, status=$status, type=$type, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+        "ResponseFunctionShellToolCall{id=$id, action=$action, callId=$callId, environment=$environment, status=$status, type=$type, caller=$caller, createdBy=$createdBy, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionShellToolCallOutput.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionShellToolCallOutput.kt
index 5ae88e05d..ce24e13e7 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionShellToolCallOutput.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionShellToolCallOutput.kt
@@ -40,6 +40,7 @@ private constructor(
     private val output: JsonField<List<Output>>,
     private val status: JsonField<Status>,
     private val type: JsonValue,
+    private val caller: JsonField<Caller>,
     private val createdBy: JsonField<String>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
@@ -54,8 +55,9 @@ private constructor(
         @JsonProperty("output") @ExcludeMissing output: JsonField<List<Output>> = JsonMissing.of(),
         @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
         @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
-    ) : this(id, callId, maxOutputLength, output, status, type, createdBy, mutableMapOf())
+    ) : this(id, callId, maxOutputLength, output, status, type, caller, createdBy, mutableMapOf())
 
     /**
      * The unique ID of the shell call output. Populated when this item is returned via API.
@@ -111,6 +113,14 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<Caller> = caller.getOptional("caller")
+
     /**
      * The identifier of the actor that created the item.
      *
@@ -156,6 +166,13 @@ private constructor(
      */
     @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
 
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
     /**
      * Returns the raw JSON value of [createdBy].
      *
@@ -202,6 +219,7 @@ private constructor(
         private var output: JsonField<MutableList<Output>>? = null
         private var status: JsonField<Status>? = null
         private var type: JsonValue = JsonValue.from("shell_call_output")
+        private var caller: JsonField<Caller> = JsonMissing.of()
         private var createdBy: JsonField<String> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
@@ -215,6 +233,7 @@ private constructor(
             output = responseFunctionShellToolCallOutput.output.map { it.toMutableList() }
             status = responseFunctionShellToolCallOutput.status
             type = responseFunctionShellToolCallOutput.type
+            caller = responseFunctionShellToolCallOutput.caller
             createdBy = responseFunctionShellToolCallOutput.createdBy
             additionalProperties =
                 responseFunctionShellToolCallOutput.additionalProperties.toMutableMap()
@@ -324,6 +343,37 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /** The execution context that produced this tool call. */
+        fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed [Caller] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+        /** Alias for calling [caller] with `Caller.ofDirect()`. */
+        fun callerDirect() = caller(Caller.ofDirect())
+
+        /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+        fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(Caller.Program.builder().callerId(callerId).build())
+
         /** The identifier of the actor that created the item. */
         fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
 
@@ -379,6 +429,7 @@ private constructor(
                 checkRequired("output", output).map { it.toImmutable() },
                 checkRequired("status", status),
                 type,
+                caller,
                 createdBy,
                 additionalProperties.toMutableMap(),
             )
@@ -409,6 +460,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        caller().ifPresent { it.validate() }
         createdBy()
         validated = true
     }
@@ -434,6 +486,7 @@ private constructor(
             (output.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0) +
             type.let { if (it == JsonValue.from("shell_call_output")) 1 else 0 } +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
             (if (createdBy.asKnown().isPresent) 1 else 0)
 
     /** The content of a shell tool call output that was emitted. */
@@ -1333,6 +1386,431 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /** The execution context that produced this tool call. */
+    @JsonDeserialize(using = Caller.Deserializer::class)
+    @JsonSerialize(using = Caller.Serializer::class)
+    class Caller
+    private constructor(
+        private val direct: JsonValue? = null,
+        private val program: Program? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+        fun program(): Optional<Program> = Optional.ofNullable(program)
+
+        fun isDirect(): Boolean = direct != null
+
+        fun isProgram(): Boolean = program != null
+
+        fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+        fun asProgram(): Program = program.getOrThrow("program")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDirect(JsonValue direct) {
+         *         return Optional.of(direct.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                direct != null -> visitor.visitDirect(direct)
+                program != null -> visitor.visitProgram(program)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Caller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDirect(direct: JsonValue) {
+                        direct.let {
+                            if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'direct' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitProgram(program: Program) {
+                        program.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDirect(direct: JsonValue) =
+                        direct.let { if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0 }
+
+                    override fun visitProgram(program: Program) = program.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Caller && direct == other.direct && program == other.program
+        }
+
+        override fun hashCode(): Int = Objects.hash(direct, program)
+
+        override fun toString(): String =
+            when {
+                direct != null -> "Caller{direct=$direct}"
+                program != null -> "Caller{program=$program}"
+                _json != null -> "Caller{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Caller")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+            @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+        }
+
+        /** An interface that defines how to map each variant of [Caller] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitDirect(direct: JsonValue): T
+
+            fun visitProgram(program: Program): T
+
+            /**
+             * Maps an unknown variant of [Caller] to a value of type [T].
+             *
+             * An instance of [Caller] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Caller: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "direct" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Caller(direct = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                    }
+                    "program" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                            Caller(program = it, _json = json)
+                        } ?: Caller(_json = json)
+                    }
+                }
+
+                return Caller(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+            override fun serialize(
+                value: Caller,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.direct != null -> generator.writeObject(value.direct)
+                    value.program != null -> generator.writeObject(value.program)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+            }
+        }
+
+        class Program
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val callerId: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                callerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(callerId, type, mutableMapOf())
+
+            /**
+             * The call ID of the program item that produced this tool call.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun callerId(): String = callerId.getRequired("caller_id")
+
+            /**
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [callerId].
+             *
+             * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("caller_id") @ExcludeMissing fun _callerId(): JsonField<String> = callerId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Program].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Program]. */
+            class Builder internal constructor() {
+
+                private var callerId: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("program")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(program: Program) = apply {
+                    callerId = program.callerId
+                    type = program.type
+                    additionalProperties = program.additionalProperties.toMutableMap()
+                }
+
+                /** The call ID of the program item that produced this tool call. */
+                fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                /**
+                 * Sets [Builder.callerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.callerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Program].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Program =
+                    Program(
+                        checkRequired("callerId", callerId),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Program = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                callerId()
+                _type().let {
+                    if (it != JsonValue.from("program")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (callerId.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Program &&
+                    callerId == other.callerId &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(callerId, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -1345,6 +1823,7 @@ private constructor(
             output == other.output &&
             status == other.status &&
             type == other.type &&
+            caller == other.caller &&
             createdBy == other.createdBy &&
             additionalProperties == other.additionalProperties
     }
@@ -1357,6 +1836,7 @@ private constructor(
             output,
             status,
             type,
+            caller,
             createdBy,
             additionalProperties,
         )
@@ -1365,5 +1845,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseFunctionShellToolCallOutput{id=$id, callId=$callId, maxOutputLength=$maxOutputLength, output=$output, status=$status, type=$type, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+        "ResponseFunctionShellToolCallOutput{id=$id, callId=$callId, maxOutputLength=$maxOutputLength, output=$output, status=$status, type=$type, caller=$caller, createdBy=$createdBy, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionToolCall.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionToolCall.kt
index f17f059db..a7d5b3f20 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionToolCall.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionToolCall.kt
@@ -6,12 +6,22 @@ import com.fasterxml.jackson.annotation.JsonAnyGetter
 import com.fasterxml.jackson.annotation.JsonAnySetter
 import com.fasterxml.jackson.annotation.JsonCreator
 import com.fasterxml.jackson.annotation.JsonProperty
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.ObjectCodec
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.SerializerProvider
+import com.fasterxml.jackson.databind.annotation.JsonDeserialize
+import com.fasterxml.jackson.databind.annotation.JsonSerialize
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.BaseDeserializer
+import com.openai.core.BaseSerializer
 import com.openai.core.Enum
 import com.openai.core.ExcludeMissing
 import com.openai.core.JsonField
 import com.openai.core.JsonMissing
 import com.openai.core.JsonValue
 import com.openai.core.checkRequired
+import com.openai.core.getOrThrow
 import com.openai.core.responseTypeFromJson
 import com.openai.errors.OpenAIInvalidDataException
 import java.util.Collections
@@ -32,6 +42,7 @@ private constructor(
     private val name: JsonField<String>,
     private val type: JsonValue,
     private val id: JsonField<String>,
+    private val caller: JsonField<Caller>,
     private val namespace: JsonField<String>,
     private val status: JsonField<Status>,
     private val additionalProperties: MutableMap<String, JsonValue>,
@@ -44,9 +55,10 @@ private constructor(
         @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
         @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
         @JsonProperty("namespace") @ExcludeMissing namespace: JsonField<String> = JsonMissing.of(),
         @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
-    ) : this(arguments, callId, name, type, id, namespace, status, mutableMapOf())
+    ) : this(arguments, callId, name, type, id, caller, namespace, status, mutableMapOf())
 
     /**
      * A JSON string of the arguments to pass to the function.
@@ -108,6 +120,14 @@ private constructor(
      */
     fun id(): Optional<String> = id.getOptional("id")
 
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<Caller> = caller.getOptional("caller")
+
     /**
      * The namespace of the function to run.
      *
@@ -153,6 +173,13 @@ private constructor(
      */
     @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
     /**
      * Returns the raw JSON value of [namespace].
      *
@@ -202,6 +229,7 @@ private constructor(
         private var name: JsonField<String>? = null
         private var type: JsonValue = JsonValue.from("function_call")
         private var id: JsonField<String> = JsonMissing.of()
+        private var caller: JsonField<Caller> = JsonMissing.of()
         private var namespace: JsonField<String> = JsonMissing.of()
         private var status: JsonField<Status> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
@@ -213,6 +241,7 @@ private constructor(
             name = responseFunctionToolCall.name
             type = responseFunctionToolCall.type
             id = responseFunctionToolCall.id
+            caller = responseFunctionToolCall.caller
             namespace = responseFunctionToolCall.namespace
             status = responseFunctionToolCall.status
             additionalProperties = responseFunctionToolCall.additionalProperties.toMutableMap()
@@ -277,6 +306,37 @@ private constructor(
          */
         fun id(id: JsonField<String>) = apply { this.id = id }
 
+        /** The execution context that produced this tool call. */
+        fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed [Caller] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+        /** Alias for calling [caller] with `Caller.ofDirect()`. */
+        fun callerDirect() = caller(Caller.ofDirect())
+
+        /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+        fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(Caller.Program.builder().callerId(callerId).build())
+
         /** The namespace of the function to run. */
         fun namespace(namespace: String) = namespace(JsonField.of(namespace))
 
@@ -343,6 +403,7 @@ private constructor(
                 checkRequired("name", name),
                 type,
                 id,
+                caller,
                 namespace,
                 status,
                 additionalProperties.toMutableMap(),
@@ -373,6 +434,7 @@ private constructor(
             }
         }
         id()
+        caller().ifPresent { it.validate() }
         namespace()
         status().ifPresent { it.validate() }
         validated = true
@@ -398,9 +460,435 @@ private constructor(
             (if (name.asKnown().isPresent) 1 else 0) +
             type.let { if (it == JsonValue.from("function_call")) 1 else 0 } +
             (if (id.asKnown().isPresent) 1 else 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
             (if (namespace.asKnown().isPresent) 1 else 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0)
 
+    /** The execution context that produced this tool call. */
+    @JsonDeserialize(using = Caller.Deserializer::class)
+    @JsonSerialize(using = Caller.Serializer::class)
+    class Caller
+    private constructor(
+        private val direct: JsonValue? = null,
+        private val program: Program? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+        fun program(): Optional<Program> = Optional.ofNullable(program)
+
+        fun isDirect(): Boolean = direct != null
+
+        fun isProgram(): Boolean = program != null
+
+        fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+        fun asProgram(): Program = program.getOrThrow("program")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDirect(JsonValue direct) {
+         *         return Optional.of(direct.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                direct != null -> visitor.visitDirect(direct)
+                program != null -> visitor.visitProgram(program)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Caller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDirect(direct: JsonValue) {
+                        direct.let {
+                            if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'direct' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitProgram(program: Program) {
+                        program.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDirect(direct: JsonValue) =
+                        direct.let { if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0 }
+
+                    override fun visitProgram(program: Program) = program.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Caller && direct == other.direct && program == other.program
+        }
+
+        override fun hashCode(): Int = Objects.hash(direct, program)
+
+        override fun toString(): String =
+            when {
+                direct != null -> "Caller{direct=$direct}"
+                program != null -> "Caller{program=$program}"
+                _json != null -> "Caller{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Caller")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+            @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+        }
+
+        /** An interface that defines how to map each variant of [Caller] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitDirect(direct: JsonValue): T
+
+            fun visitProgram(program: Program): T
+
+            /**
+             * Maps an unknown variant of [Caller] to a value of type [T].
+             *
+             * An instance of [Caller] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Caller: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "direct" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Caller(direct = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                    }
+                    "program" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                            Caller(program = it, _json = json)
+                        } ?: Caller(_json = json)
+                    }
+                }
+
+                return Caller(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+            override fun serialize(
+                value: Caller,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.direct != null -> generator.writeObject(value.direct)
+                    value.program != null -> generator.writeObject(value.program)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+            }
+        }
+
+        class Program
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val callerId: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                callerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(callerId, type, mutableMapOf())
+
+            /**
+             * The call ID of the program item that produced this tool call.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun callerId(): String = callerId.getRequired("caller_id")
+
+            /**
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [callerId].
+             *
+             * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("caller_id") @ExcludeMissing fun _callerId(): JsonField<String> = callerId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Program].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Program]. */
+            class Builder internal constructor() {
+
+                private var callerId: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("program")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(program: Program) = apply {
+                    callerId = program.callerId
+                    type = program.type
+                    additionalProperties = program.additionalProperties.toMutableMap()
+                }
+
+                /** The call ID of the program item that produced this tool call. */
+                fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                /**
+                 * Sets [Builder.callerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.callerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Program].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Program =
+                    Program(
+                        checkRequired("callerId", callerId),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Program = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                callerId()
+                _type().let {
+                    if (it != JsonValue.from("program")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (callerId.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Program &&
+                    callerId == other.callerId &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(callerId, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
     /**
      * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated when
      * items are returned via API.
@@ -556,17 +1044,28 @@ private constructor(
             name == other.name &&
             type == other.type &&
             id == other.id &&
+            caller == other.caller &&
             namespace == other.namespace &&
             status == other.status &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(arguments, callId, name, type, id, namespace, status, additionalProperties)
+        Objects.hash(
+            arguments,
+            callId,
+            name,
+            type,
+            id,
+            caller,
+            namespace,
+            status,
+            additionalProperties,
+        )
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseFunctionToolCall{arguments=$arguments, callId=$callId, name=$name, type=$type, id=$id, namespace=$namespace, status=$status, additionalProperties=$additionalProperties}"
+        "ResponseFunctionToolCall{arguments=$arguments, callId=$callId, name=$name, type=$type, id=$id, caller=$caller, namespace=$namespace, status=$status, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionToolCallItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionToolCallItem.kt
index 27c187fb6..6bdfc5fa1 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionToolCallItem.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionToolCallItem.kt
@@ -31,6 +31,7 @@ private constructor(
     private val name: JsonField<String>,
     private val type: JsonValue,
     private val id: JsonField<String>,
+    private val caller: JsonField<ResponseFunctionToolCall.Caller>,
     private val namespace: JsonField<String>,
     private val status: JsonField<ResponseFunctionToolCall.Status>,
     private val createdBy: JsonField<String>,
@@ -44,12 +45,26 @@ private constructor(
         @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
         @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("caller")
+        @ExcludeMissing
+        caller: JsonField<ResponseFunctionToolCall.Caller> = JsonMissing.of(),
         @JsonProperty("namespace") @ExcludeMissing namespace: JsonField<String> = JsonMissing.of(),
         @JsonProperty("status")
         @ExcludeMissing
         status: JsonField<ResponseFunctionToolCall.Status> = JsonMissing.of(),
         @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
-    ) : this(arguments, callId, name, type, id, namespace, status, createdBy, mutableMapOf())
+    ) : this(
+        arguments,
+        callId,
+        name,
+        type,
+        id,
+        caller,
+        namespace,
+        status,
+        createdBy,
+        mutableMapOf(),
+    )
 
     fun toResponseFunctionToolCall(): ResponseFunctionToolCall =
         ResponseFunctionToolCall.builder()
@@ -58,6 +73,7 @@ private constructor(
             .name(name)
             .type(type)
             .id(id)
+            .caller(caller)
             .namespace(namespace)
             .status(status)
             .build()
@@ -107,6 +123,14 @@ private constructor(
      */
     fun id(): Optional<String> = id.getOptional("id")
 
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<ResponseFunctionToolCall.Caller> = caller.getOptional("caller")
+
     /**
      * The namespace of the function to run.
      *
@@ -160,6 +184,15 @@ private constructor(
      */
     @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller")
+    @ExcludeMissing
+    fun _caller(): JsonField<ResponseFunctionToolCall.Caller> = caller
+
     /**
      * Returns the raw JSON value of [namespace].
      *
@@ -218,6 +251,7 @@ private constructor(
         private var name: JsonField<String>? = null
         private var type: JsonValue = JsonValue.from("function_call")
         private var id: JsonField<String> = JsonMissing.of()
+        private var caller: JsonField<ResponseFunctionToolCall.Caller> = JsonMissing.of()
         private var namespace: JsonField<String> = JsonMissing.of()
         private var status: JsonField<ResponseFunctionToolCall.Status> = JsonMissing.of()
         private var createdBy: JsonField<String> = JsonMissing.of()
@@ -230,6 +264,7 @@ private constructor(
             name = responseFunctionToolCallItem.name
             type = responseFunctionToolCallItem.type
             id = responseFunctionToolCallItem.id
+            caller = responseFunctionToolCallItem.caller
             namespace = responseFunctionToolCallItem.namespace
             status = responseFunctionToolCallItem.status
             createdBy = responseFunctionToolCallItem.createdBy
@@ -295,6 +330,41 @@ private constructor(
          */
         fun id(id: JsonField<String>) = apply { this.id = id }
 
+        /** The execution context that produced this tool call. */
+        fun caller(caller: ResponseFunctionToolCall.Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<ResponseFunctionToolCall.Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed
+         * [ResponseFunctionToolCall.Caller] value instead. This method is primarily for setting the
+         * field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<ResponseFunctionToolCall.Caller>) = apply {
+            this.caller = caller
+        }
+
+        /** Alias for calling [caller] with `ResponseFunctionToolCall.Caller.ofDirect()`. */
+        fun callerDirect() = caller(ResponseFunctionToolCall.Caller.ofDirect())
+
+        /** Alias for calling [caller] with `ResponseFunctionToolCall.Caller.ofProgram(program)`. */
+        fun caller(program: ResponseFunctionToolCall.Caller.Program) =
+            caller(ResponseFunctionToolCall.Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * ResponseFunctionToolCall.Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(ResponseFunctionToolCall.Caller.Program.builder().callerId(callerId).build())
+
         /** The namespace of the function to run. */
         fun namespace(namespace: String) = namespace(JsonField.of(namespace))
 
@@ -376,6 +446,7 @@ private constructor(
                 checkRequired("name", name),
                 type,
                 id,
+                caller,
                 namespace,
                 status,
                 createdBy,
@@ -407,6 +478,7 @@ private constructor(
             }
         }
         id()
+        caller().ifPresent { it.validate() }
         namespace()
         status().ifPresent { it.validate() }
         createdBy()
@@ -433,6 +505,7 @@ private constructor(
             (if (name.asKnown().isPresent) 1 else 0) +
             type.let { if (it == JsonValue.from("function_call")) 1 else 0 } +
             (if (id.asKnown().isPresent) 1 else 0) +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
             (if (namespace.asKnown().isPresent) 1 else 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0) +
             (if (createdBy.asKnown().isPresent) 1 else 0)
@@ -592,6 +665,7 @@ private constructor(
             name == other.name &&
             type == other.type &&
             id == other.id &&
+            caller == other.caller &&
             namespace == other.namespace &&
             status == other.status &&
             createdBy == other.createdBy &&
@@ -605,6 +679,7 @@ private constructor(
             name,
             type,
             id,
+            caller,
             namespace,
             status,
             createdBy,
@@ -615,5 +690,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseFunctionToolCallItem{arguments=$arguments, callId=$callId, name=$name, type=$type, id=$id, namespace=$namespace, status=$status, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+        "ResponseFunctionToolCallItem{arguments=$arguments, callId=$callId, name=$name, type=$type, id=$id, caller=$caller, namespace=$namespace, status=$status, createdBy=$createdBy, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionToolCallOutputItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionToolCallOutputItem.kt
index d8be6b049..50b7b9a73 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionToolCallOutputItem.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionToolCallOutputItem.kt
@@ -38,6 +38,7 @@ private constructor(
     private val output: JsonField<Output>,
     private val status: JsonField<Status>,
     private val type: JsonValue,
+    private val caller: JsonField<Caller>,
     private val createdBy: JsonField<String>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
@@ -49,8 +50,9 @@ private constructor(
         @JsonProperty("output") @ExcludeMissing output: JsonField<Output> = JsonMissing.of(),
         @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
         @JsonProperty("created_by") @ExcludeMissing createdBy: JsonField<String> = JsonMissing.of(),
-    ) : this(id, callId, output, status, type, createdBy, mutableMapOf())
+    ) : this(id, callId, output, status, type, caller, createdBy, mutableMapOf())
 
     /**
      * The unique ID of the function call tool output.
@@ -99,6 +101,14 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * The execution context that produced this tool call.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun caller(): Optional<Caller> = caller.getOptional("caller")
+
     /**
      * The identifier of the actor that created the item.
      *
@@ -135,6 +145,13 @@ private constructor(
      */
     @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
 
+    /**
+     * Returns the raw JSON value of [caller].
+     *
+     * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
     /**
      * Returns the raw JSON value of [createdBy].
      *
@@ -179,6 +196,7 @@ private constructor(
         private var output: JsonField<Output>? = null
         private var status: JsonField<Status>? = null
         private var type: JsonValue = JsonValue.from("function_call_output")
+        private var caller: JsonField<Caller> = JsonMissing.of()
         private var createdBy: JsonField<String> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
@@ -190,6 +208,7 @@ private constructor(
                 output = responseFunctionToolCallOutputItem.output
                 status = responseFunctionToolCallOutputItem.status
                 type = responseFunctionToolCallOutputItem.type
+                caller = responseFunctionToolCallOutputItem.caller
                 createdBy = responseFunctionToolCallOutputItem.createdBy
                 additionalProperties =
                     responseFunctionToolCallOutputItem.additionalProperties.toMutableMap()
@@ -266,6 +285,37 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /** The execution context that produced this tool call. */
+        fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+        /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+        fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+        /**
+         * Sets [Builder.caller] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.caller] with a well-typed [Caller] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+        /** Alias for calling [caller] with `Caller.ofDirect()`. */
+        fun callerDirect() = caller(Caller.ofDirect())
+
+        /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+        fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+        /**
+         * Alias for calling [caller] with the following:
+         * ```java
+         * Caller.Program.builder()
+         *     .callerId(callerId)
+         *     .build()
+         * ```
+         */
+        fun programCaller(callerId: String) =
+            caller(Caller.Program.builder().callerId(callerId).build())
+
         /** The identifier of the actor that created the item. */
         fun createdBy(createdBy: String) = createdBy(JsonField.of(createdBy))
 
@@ -319,6 +369,7 @@ private constructor(
                 checkRequired("output", output),
                 checkRequired("status", status),
                 type,
+                caller,
                 createdBy,
                 additionalProperties.toMutableMap(),
             )
@@ -348,6 +399,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        caller().ifPresent { it.validate() }
         createdBy()
         validated = true
     }
@@ -372,6 +424,7 @@ private constructor(
             (output.asKnown().getOrNull()?.validity() ?: 0) +
             (status.asKnown().getOrNull()?.validity() ?: 0) +
             type.let { if (it == JsonValue.from("function_call_output")) 1 else 0 } +
+            (caller.asKnown().getOrNull()?.validity() ?: 0) +
             (if (createdBy.asKnown().isPresent) 1 else 0)
 
     /**
@@ -1028,6 +1081,433 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /** The execution context that produced this tool call. */
+    @JsonDeserialize(using = Caller.Deserializer::class)
+    @JsonSerialize(using = Caller.Serializer::class)
+    class Caller
+    private constructor(
+        private val direct: JsonValue? = null,
+        private val program: Program? = null,
+        private val _json: JsonValue? = null,
+    ) {
+
+        fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+        fun program(): Optional<Program> = Optional.ofNullable(program)
+
+        fun isDirect(): Boolean = direct != null
+
+        fun isProgram(): Boolean = program != null
+
+        fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+        fun asProgram(): Program = program.getOrThrow("program")
+
+        fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+        /**
+         * Maps this instance's current variant to a value of type [T] using the given [visitor].
+         *
+         * Note that this method is _not_ forwards compatible with new variants from the API, unless
+         * [visitor] overrides [Visitor.unknown]. To handle variants not known to this version of
+         * the SDK gracefully, consider overriding [Visitor.unknown]:
+         * ```java
+         * import com.openai.core.JsonValue;
+         * import java.util.Optional;
+         *
+         * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+         *     @Override
+         *     public Optional<String> visitDirect(JsonValue direct) {
+         *         return Optional.of(direct.toString());
+         *     }
+         *
+         *     // ...
+         *
+         *     @Override
+         *     public Optional<String> unknown(JsonValue json) {
+         *         // Or inspect the `json`.
+         *         return Optional.empty();
+         *     }
+         * });
+         * ```
+         *
+         * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in [visitor]
+         *   and the current variant is unknown.
+         */
+        fun <T> accept(visitor: Visitor<T>): T =
+            when {
+                direct != null -> visitor.visitDirect(direct)
+                program != null -> visitor.visitProgram(program)
+                else -> visitor.unknown(_json)
+            }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Caller = apply {
+            if (validated) {
+                return@apply
+            }
+
+            accept(
+                object : Visitor<Unit> {
+                    override fun visitDirect(direct: JsonValue) {
+                        direct.let {
+                            if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                throw OpenAIInvalidDataException(
+                                    "'direct' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
+                    override fun visitProgram(program: Program) {
+                        program.validate()
+                    }
+                }
+            )
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            accept(
+                object : Visitor<Int> {
+                    override fun visitDirect(direct: JsonValue) =
+                        direct.let { if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0 }
+
+                    override fun visitProgram(program: Program) = program.validity()
+
+                    override fun unknown(json: JsonValue?) = 0
+                }
+            )
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Caller && direct == other.direct && program == other.program
+        }
+
+        override fun hashCode(): Int = Objects.hash(direct, program)
+
+        override fun toString(): String =
+            when {
+                direct != null -> "Caller{direct=$direct}"
+                program != null -> "Caller{program=$program}"
+                _json != null -> "Caller{_unknown=$_json}"
+                else -> throw IllegalStateException("Invalid Caller")
+            }
+
+        companion object {
+
+            @JvmStatic fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+            @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+        }
+
+        /** An interface that defines how to map each variant of [Caller] to a value of type [T]. */
+        interface Visitor<out T> {
+
+            fun visitDirect(direct: JsonValue): T
+
+            fun visitProgram(program: Program): T
+
+            /**
+             * Maps an unknown variant of [Caller] to a value of type [T].
+             *
+             * An instance of [Caller] can contain an unknown variant if it was deserialized from
+             * data that doesn't match any known variant. For example, if the SDK is on an older
+             * version than the API, then the API may respond with new variants that the SDK is
+             * unaware of.
+             *
+             * @throws OpenAIInvalidDataException in the default implementation.
+             */
+            fun unknown(json: JsonValue?): T {
+                throw OpenAIInvalidDataException("Unknown Caller: $json")
+            }
+        }
+
+        internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+            override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                val json = JsonValue.fromJsonNode(node)
+                val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                when (type) {
+                    "direct" -> {
+                        return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                            ?.let { Caller(direct = it, _json = json) }
+                            ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                    }
+                    "program" -> {
+                        return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                            Caller(program = it, _json = json)
+                        } ?: Caller(_json = json)
+                    }
+                }
+
+                return Caller(_json = json)
+            }
+        }
+
+        internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+            override fun serialize(
+                value: Caller,
+                generator: JsonGenerator,
+                provider: SerializerProvider,
+            ) {
+                when {
+                    value.direct != null -> generator.writeObject(value.direct)
+                    value.program != null -> generator.writeObject(value.program)
+                    value._json != null -> generator.writeObject(value._json)
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+            }
+        }
+
+        class Program
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val callerId: JsonField<String>,
+            private val type: JsonValue,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                callerId: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            ) : this(callerId, type, mutableMapOf())
+
+            /**
+             * The call ID of the program item that produced this tool call.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun callerId(): String = callerId.getRequired("caller_id")
+
+            /**
+             * The caller type. Always `program`.
+             *
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
+             */
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+            /**
+             * Returns the raw JSON value of [callerId].
+             *
+             * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("caller_id") @ExcludeMissing fun _callerId(): JsonField<String> = callerId
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Program].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Program]. */
+            class Builder internal constructor() {
+
+                private var callerId: JsonField<String>? = null
+                private var type: JsonValue = JsonValue.from("program")
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(program: Program) = apply {
+                    callerId = program.callerId
+                    type = program.type
+                    additionalProperties = program.additionalProperties.toMutableMap()
+                }
+
+                /** The call ID of the program item that produced this tool call. */
+                fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                /**
+                 * Sets [Builder.callerId] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.callerId] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Program].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .callerId()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Program =
+                    Program(
+                        checkRequired("callerId", callerId),
+                        type,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Program = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                callerId()
+                _type().let {
+                    if (it != JsonValue.from("program")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (callerId.asKnown().isPresent) 1 else 0) +
+                    type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Program &&
+                    callerId == other.callerId &&
+                    type == other.type &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(callerId, type, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+        }
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -1039,16 +1519,17 @@ private constructor(
             output == other.output &&
             status == other.status &&
             type == other.type &&
+            caller == other.caller &&
             createdBy == other.createdBy &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(id, callId, output, status, type, createdBy, additionalProperties)
+        Objects.hash(id, callId, output, status, type, caller, createdBy, additionalProperties)
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseFunctionToolCallOutputItem{id=$id, callId=$callId, output=$output, status=$status, type=$type, createdBy=$createdBy, additionalProperties=$additionalProperties}"
+        "ResponseFunctionToolCallOutputItem{id=$id, callId=$callId, output=$output, status=$status, type=$type, caller=$caller, createdBy=$createdBy, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputFile.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputFile.kt
index d17dbf0f5..b743ca1fd 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputFile.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputFile.kt
@@ -27,6 +27,7 @@ private constructor(
     private val fileId: JsonField<String>,
     private val fileUrl: JsonField<String>,
     private val filename: JsonField<String>,
+    private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -38,7 +39,19 @@ private constructor(
         @JsonProperty("file_id") @ExcludeMissing fileId: JsonField<String> = JsonMissing.of(),
         @JsonProperty("file_url") @ExcludeMissing fileUrl: JsonField<String> = JsonMissing.of(),
         @JsonProperty("filename") @ExcludeMissing filename: JsonField<String> = JsonMissing.of(),
-    ) : this(type, detail, fileData, fileId, fileUrl, filename, mutableMapOf())
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+    ) : this(
+        type,
+        detail,
+        fileData,
+        fileId,
+        fileUrl,
+        filename,
+        promptCacheBreakpoint,
+        mutableMapOf(),
+    )
 
     /**
      * The type of the input item. Always `input_file`.
@@ -54,8 +67,10 @@ private constructor(
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
     /**
-     * The detail level of the file to be sent to the model. Use `low` for the default rendering
-     * behavior, or `high` to render the file at higher quality. Defaults to `low`.
+     * The detail level of the file to be sent to the model. Use `auto` to let the system select the
+     * detail level; for GPT-5.6 and later models, `auto` uses high-quality rendering, which may
+     * increase input token usage. Use `low` for lower-cost rendering, or `high` to render the file
+     * at higher quality. Defaults to `auto`.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -94,6 +109,16 @@ private constructor(
      */
     fun filename(): Optional<String> = filename.getOptional("filename")
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+        promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
     /**
      * Returns the raw JSON value of [detail].
      *
@@ -129,6 +154,16 @@ private constructor(
      */
     @JsonProperty("filename") @ExcludeMissing fun _filename(): JsonField<String> = filename
 
+    /**
+     * Returns the raw JSON value of [promptCacheBreakpoint].
+     *
+     * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_breakpoint")
+    @ExcludeMissing
+    fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -156,6 +191,7 @@ private constructor(
         private var fileId: JsonField<String> = JsonMissing.of()
         private var fileUrl: JsonField<String> = JsonMissing.of()
         private var filename: JsonField<String> = JsonMissing.of()
+        private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -166,6 +202,7 @@ private constructor(
             fileId = responseInputFile.fileId
             fileUrl = responseInputFile.fileUrl
             filename = responseInputFile.filename
+            promptCacheBreakpoint = responseInputFile.promptCacheBreakpoint
             additionalProperties = responseInputFile.additionalProperties.toMutableMap()
         }
 
@@ -184,8 +221,10 @@ private constructor(
         fun type(type: JsonValue) = apply { this.type = type }
 
         /**
-         * The detail level of the file to be sent to the model. Use `low` for the default rendering
-         * behavior, or `high` to render the file at higher quality. Defaults to `low`.
+         * The detail level of the file to be sent to the model. Use `auto` to let the system select
+         * the detail level; for GPT-5.6 and later models, `auto` uses high-quality rendering, which
+         * may increase input token usage. Use `low` for lower-cost rendering, or `high` to render
+         * the file at higher quality. Defaults to `auto`.
          */
         fun detail(detail: Detail) = detail(JsonField.of(detail))
 
@@ -244,6 +283,24 @@ private constructor(
          */
         fun filename(filename: JsonField<String>) = apply { this.filename = filename }
 
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint) =
+            promptCacheBreakpoint(JsonField.of(promptCacheBreakpoint))
+
+        /**
+         * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+         * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) = apply {
+            this.promptCacheBreakpoint = promptCacheBreakpoint
+        }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -276,6 +333,7 @@ private constructor(
                 fileId,
                 fileUrl,
                 filename,
+                promptCacheBreakpoint,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -305,6 +363,7 @@ private constructor(
         fileId()
         fileUrl()
         filename()
+        promptCacheBreakpoint().ifPresent { it.validate() }
         validated = true
     }
 
@@ -328,11 +387,14 @@ private constructor(
             (if (fileData.asKnown().isPresent) 1 else 0) +
             (if (fileId.asKnown().isPresent) 1 else 0) +
             (if (fileUrl.asKnown().isPresent) 1 else 0) +
-            (if (filename.asKnown().isPresent) 1 else 0)
+            (if (filename.asKnown().isPresent) 1 else 0) +
+            (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
 
     /**
-     * The detail level of the file to be sent to the model. Use `low` for the default rendering
-     * behavior, or `high` to render the file at higher quality. Defaults to `low`.
+     * The detail level of the file to be sent to the model. Use `auto` to let the system select the
+     * detail level; for GPT-5.6 and later models, `auto` uses high-quality rendering, which may
+     * increase input token usage. Use `low` for lower-cost rendering, or `high` to render the file
+     * at higher quality. Defaults to `auto`.
      */
     class Detail @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
@@ -348,6 +410,8 @@ private constructor(
 
         companion object {
 
+            @JvmField val AUTO = of("auto")
+
             @JvmField val LOW = of("low")
 
             @JvmField val HIGH = of("high")
@@ -357,6 +421,7 @@ private constructor(
 
         /** An enum containing [Detail]'s known values. */
         enum class Known {
+            AUTO,
             LOW,
             HIGH,
         }
@@ -371,6 +436,7 @@ private constructor(
          * - It was constructed with an arbitrary value using the [of] method.
          */
         enum class Value {
+            AUTO,
             LOW,
             HIGH,
             /** An enum member indicating that [Detail] was instantiated with an unknown value. */
@@ -386,6 +452,7 @@ private constructor(
          */
         fun value(): Value =
             when (this) {
+                AUTO -> Value.AUTO
                 LOW -> Value.LOW
                 HIGH -> Value.HIGH
                 else -> Value._UNKNOWN
@@ -402,6 +469,7 @@ private constructor(
          */
         fun known(): Known =
             when (this) {
+                AUTO -> Known.AUTO
                 LOW -> Known.LOW
                 HIGH -> Known.HIGH
                 else -> throw OpenAIInvalidDataException("Unknown Detail: $value")
@@ -468,6 +536,168 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     */
+    class PromptCacheBreakpoint
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+        ) : this(mode, mutableMapOf())
+
+        /**
+         * The breakpoint mode. Always `explicit`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("explicit")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheBreakpoint].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheBreakpoint]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonValue = JsonValue.from("explicit")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                mode = promptCacheBreakpoint.mode
+                additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheBreakpoint].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheBreakpoint =
+                PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheBreakpoint = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _mode().let {
+                if (it != JsonValue.from("explicit")) {
+                    throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheBreakpoint &&
+                mode == other.mode &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -480,15 +710,25 @@ private constructor(
             fileId == other.fileId &&
             fileUrl == other.fileUrl &&
             filename == other.filename &&
+            promptCacheBreakpoint == other.promptCacheBreakpoint &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(type, detail, fileData, fileId, fileUrl, filename, additionalProperties)
+        Objects.hash(
+            type,
+            detail,
+            fileData,
+            fileId,
+            fileUrl,
+            filename,
+            promptCacheBreakpoint,
+            additionalProperties,
+        )
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseInputFile{type=$type, detail=$detail, fileData=$fileData, fileId=$fileId, fileUrl=$fileUrl, filename=$filename, additionalProperties=$additionalProperties}"
+        "ResponseInputFile{type=$type, detail=$detail, fileData=$fileData, fileId=$fileId, fileUrl=$fileUrl, filename=$filename, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputFileContent.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputFileContent.kt
index ff23d8824..4acb93714 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputFileContent.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputFileContent.kt
@@ -27,6 +27,7 @@ private constructor(
     private val fileId: JsonField<String>,
     private val fileUrl: JsonField<String>,
     private val filename: JsonField<String>,
+    private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -38,7 +39,19 @@ private constructor(
         @JsonProperty("file_id") @ExcludeMissing fileId: JsonField<String> = JsonMissing.of(),
         @JsonProperty("file_url") @ExcludeMissing fileUrl: JsonField<String> = JsonMissing.of(),
         @JsonProperty("filename") @ExcludeMissing filename: JsonField<String> = JsonMissing.of(),
-    ) : this(type, detail, fileData, fileId, fileUrl, filename, mutableMapOf())
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+    ) : this(
+        type,
+        detail,
+        fileData,
+        fileId,
+        fileUrl,
+        filename,
+        promptCacheBreakpoint,
+        mutableMapOf(),
+    )
 
     /**
      * The type of the input item. Always `input_file`.
@@ -54,8 +67,10 @@ private constructor(
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
     /**
-     * The detail level of the file to be sent to the model. Use `low` for the default rendering
-     * behavior, or `high` to render the file at higher quality. Defaults to `low`.
+     * The detail level of the file to be sent to the model. Use `auto` to let the system select the
+     * detail level; for GPT-5.6 and later models, `auto` uses high-quality rendering, which may
+     * increase input token usage. Use `low` for lower-cost rendering, or `high` to render the file
+     * at higher quality. Defaults to `auto`.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -94,6 +109,16 @@ private constructor(
      */
     fun filename(): Optional<String> = filename.getOptional("filename")
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+        promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
     /**
      * Returns the raw JSON value of [detail].
      *
@@ -129,6 +154,16 @@ private constructor(
      */
     @JsonProperty("filename") @ExcludeMissing fun _filename(): JsonField<String> = filename
 
+    /**
+     * Returns the raw JSON value of [promptCacheBreakpoint].
+     *
+     * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_breakpoint")
+    @ExcludeMissing
+    fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -156,6 +191,7 @@ private constructor(
         private var fileId: JsonField<String> = JsonMissing.of()
         private var fileUrl: JsonField<String> = JsonMissing.of()
         private var filename: JsonField<String> = JsonMissing.of()
+        private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -166,6 +202,7 @@ private constructor(
             fileId = responseInputFileContent.fileId
             fileUrl = responseInputFileContent.fileUrl
             filename = responseInputFileContent.filename
+            promptCacheBreakpoint = responseInputFileContent.promptCacheBreakpoint
             additionalProperties = responseInputFileContent.additionalProperties.toMutableMap()
         }
 
@@ -184,8 +221,10 @@ private constructor(
         fun type(type: JsonValue) = apply { this.type = type }
 
         /**
-         * The detail level of the file to be sent to the model. Use `low` for the default rendering
-         * behavior, or `high` to render the file at higher quality. Defaults to `low`.
+         * The detail level of the file to be sent to the model. Use `auto` to let the system select
+         * the detail level; for GPT-5.6 and later models, `auto` uses high-quality rendering, which
+         * may increase input token usage. Use `low` for lower-cost rendering, or `high` to render
+         * the file at higher quality. Defaults to `auto`.
          */
         fun detail(detail: Detail) = detail(JsonField.of(detail))
 
@@ -253,6 +292,31 @@ private constructor(
          */
         fun filename(filename: JsonField<String>) = apply { this.filename = filename }
 
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint?) =
+            promptCacheBreakpoint(JsonField.ofNullable(promptCacheBreakpoint))
+
+        /**
+         * Alias for calling [Builder.promptCacheBreakpoint] with
+         * `promptCacheBreakpoint.orElse(null)`.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: Optional<PromptCacheBreakpoint>) =
+            promptCacheBreakpoint(promptCacheBreakpoint.getOrNull())
+
+        /**
+         * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+         * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) = apply {
+            this.promptCacheBreakpoint = promptCacheBreakpoint
+        }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -285,6 +349,7 @@ private constructor(
                 fileId,
                 fileUrl,
                 filename,
+                promptCacheBreakpoint,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -314,6 +379,7 @@ private constructor(
         fileId()
         fileUrl()
         filename()
+        promptCacheBreakpoint().ifPresent { it.validate() }
         validated = true
     }
 
@@ -337,11 +403,14 @@ private constructor(
             (if (fileData.asKnown().isPresent) 1 else 0) +
             (if (fileId.asKnown().isPresent) 1 else 0) +
             (if (fileUrl.asKnown().isPresent) 1 else 0) +
-            (if (filename.asKnown().isPresent) 1 else 0)
+            (if (filename.asKnown().isPresent) 1 else 0) +
+            (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
 
     /**
-     * The detail level of the file to be sent to the model. Use `low` for the default rendering
-     * behavior, or `high` to render the file at higher quality. Defaults to `low`.
+     * The detail level of the file to be sent to the model. Use `auto` to let the system select the
+     * detail level; for GPT-5.6 and later models, `auto` uses high-quality rendering, which may
+     * increase input token usage. Use `low` for lower-cost rendering, or `high` to render the file
+     * at higher quality. Defaults to `auto`.
      */
     class Detail @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
@@ -357,6 +426,8 @@ private constructor(
 
         companion object {
 
+            @JvmField val AUTO = of("auto")
+
             @JvmField val LOW = of("low")
 
             @JvmField val HIGH = of("high")
@@ -366,6 +437,7 @@ private constructor(
 
         /** An enum containing [Detail]'s known values. */
         enum class Known {
+            AUTO,
             LOW,
             HIGH,
         }
@@ -380,6 +452,7 @@ private constructor(
          * - It was constructed with an arbitrary value using the [of] method.
          */
         enum class Value {
+            AUTO,
             LOW,
             HIGH,
             /** An enum member indicating that [Detail] was instantiated with an unknown value. */
@@ -395,6 +468,7 @@ private constructor(
          */
         fun value(): Value =
             when (this) {
+                AUTO -> Value.AUTO
                 LOW -> Value.LOW
                 HIGH -> Value.HIGH
                 else -> Value._UNKNOWN
@@ -411,6 +485,7 @@ private constructor(
          */
         fun known(): Known =
             when (this) {
+                AUTO -> Known.AUTO
                 LOW -> Known.LOW
                 HIGH -> Known.HIGH
                 else -> throw OpenAIInvalidDataException("Unknown Detail: $value")
@@ -477,6 +552,168 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     */
+    class PromptCacheBreakpoint
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+        ) : this(mode, mutableMapOf())
+
+        /**
+         * The breakpoint mode. Always `explicit`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("explicit")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheBreakpoint].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheBreakpoint]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonValue = JsonValue.from("explicit")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                mode = promptCacheBreakpoint.mode
+                additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheBreakpoint].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheBreakpoint =
+                PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheBreakpoint = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _mode().let {
+                if (it != JsonValue.from("explicit")) {
+                    throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheBreakpoint &&
+                mode == other.mode &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -489,15 +726,25 @@ private constructor(
             fileId == other.fileId &&
             fileUrl == other.fileUrl &&
             filename == other.filename &&
+            promptCacheBreakpoint == other.promptCacheBreakpoint &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(type, detail, fileData, fileId, fileUrl, filename, additionalProperties)
+        Objects.hash(
+            type,
+            detail,
+            fileData,
+            fileId,
+            fileUrl,
+            filename,
+            promptCacheBreakpoint,
+            additionalProperties,
+        )
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseInputFileContent{type=$type, detail=$detail, fileData=$fileData, fileId=$fileId, fileUrl=$fileUrl, filename=$filename, additionalProperties=$additionalProperties}"
+        "ResponseInputFileContent{type=$type, detail=$detail, fileData=$fileData, fileId=$fileId, fileUrl=$fileUrl, filename=$filename, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputImage.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputImage.kt
index 3a56242f7..1a96b54a9 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputImage.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputImage.kt
@@ -29,6 +29,7 @@ private constructor(
     private val type: JsonValue,
     private val fileId: JsonField<String>,
     private val imageUrl: JsonField<String>,
+    private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -38,7 +39,10 @@ private constructor(
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
         @JsonProperty("file_id") @ExcludeMissing fileId: JsonField<String> = JsonMissing.of(),
         @JsonProperty("image_url") @ExcludeMissing imageUrl: JsonField<String> = JsonMissing.of(),
-    ) : this(detail, type, fileId, imageUrl, mutableMapOf())
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+    ) : this(detail, type, fileId, imageUrl, promptCacheBreakpoint, mutableMapOf())
 
     /**
      * The detail level of the image to be sent to the model. One of `high`, `low`, `auto`, or
@@ -79,6 +83,16 @@ private constructor(
      */
     fun imageUrl(): Optional<String> = imageUrl.getOptional("image_url")
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+        promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
     /**
      * Returns the raw JSON value of [detail].
      *
@@ -100,6 +114,16 @@ private constructor(
      */
     @JsonProperty("image_url") @ExcludeMissing fun _imageUrl(): JsonField<String> = imageUrl
 
+    /**
+     * Returns the raw JSON value of [promptCacheBreakpoint].
+     *
+     * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_breakpoint")
+    @ExcludeMissing
+    fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -132,6 +156,7 @@ private constructor(
         private var type: JsonValue = JsonValue.from("input_image")
         private var fileId: JsonField<String> = JsonMissing.of()
         private var imageUrl: JsonField<String> = JsonMissing.of()
+        private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -140,6 +165,7 @@ private constructor(
             type = responseInputImage.type
             fileId = responseInputImage.fileId
             imageUrl = responseInputImage.imageUrl
+            promptCacheBreakpoint = responseInputImage.promptCacheBreakpoint
             additionalProperties = responseInputImage.additionalProperties.toMutableMap()
         }
 
@@ -202,6 +228,24 @@ private constructor(
          */
         fun imageUrl(imageUrl: JsonField<String>) = apply { this.imageUrl = imageUrl }
 
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint) =
+            promptCacheBreakpoint(JsonField.of(promptCacheBreakpoint))
+
+        /**
+         * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+         * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) = apply {
+            this.promptCacheBreakpoint = promptCacheBreakpoint
+        }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -239,6 +283,7 @@ private constructor(
                 type,
                 fileId,
                 imageUrl,
+                promptCacheBreakpoint,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -266,6 +311,7 @@ private constructor(
         }
         fileId()
         imageUrl()
+        promptCacheBreakpoint().ifPresent { it.validate() }
         validated = true
     }
 
@@ -287,7 +333,8 @@ private constructor(
         (detail.asKnown().getOrNull()?.validity() ?: 0) +
             type.let { if (it == JsonValue.from("input_image")) 1 else 0 } +
             (if (fileId.asKnown().isPresent) 1 else 0) +
-            (if (imageUrl.asKnown().isPresent) 1 else 0)
+            (if (imageUrl.asKnown().isPresent) 1 else 0) +
+            (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
 
     /**
      * The detail level of the image to be sent to the model. One of `high`, `low`, `auto`, or
@@ -439,6 +486,168 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     */
+    class PromptCacheBreakpoint
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+        ) : this(mode, mutableMapOf())
+
+        /**
+         * The breakpoint mode. Always `explicit`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("explicit")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheBreakpoint].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheBreakpoint]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonValue = JsonValue.from("explicit")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                mode = promptCacheBreakpoint.mode
+                additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheBreakpoint].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheBreakpoint =
+                PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheBreakpoint = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _mode().let {
+                if (it != JsonValue.from("explicit")) {
+                    throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheBreakpoint &&
+                mode == other.mode &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -449,15 +658,16 @@ private constructor(
             type == other.type &&
             fileId == other.fileId &&
             imageUrl == other.imageUrl &&
+            promptCacheBreakpoint == other.promptCacheBreakpoint &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(detail, type, fileId, imageUrl, additionalProperties)
+        Objects.hash(detail, type, fileId, imageUrl, promptCacheBreakpoint, additionalProperties)
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseInputImage{detail=$detail, type=$type, fileId=$fileId, imageUrl=$imageUrl, additionalProperties=$additionalProperties}"
+        "ResponseInputImage{detail=$detail, type=$type, fileId=$fileId, imageUrl=$imageUrl, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputImageContent.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputImageContent.kt
index 8da8b949a..29fd4a0da 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputImageContent.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputImageContent.kt
@@ -28,6 +28,7 @@ private constructor(
     private val detail: JsonField<Detail>,
     private val fileId: JsonField<String>,
     private val imageUrl: JsonField<String>,
+    private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -37,7 +38,10 @@ private constructor(
         @JsonProperty("detail") @ExcludeMissing detail: JsonField<Detail> = JsonMissing.of(),
         @JsonProperty("file_id") @ExcludeMissing fileId: JsonField<String> = JsonMissing.of(),
         @JsonProperty("image_url") @ExcludeMissing imageUrl: JsonField<String> = JsonMissing.of(),
-    ) : this(type, detail, fileId, imageUrl, mutableMapOf())
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+    ) : this(type, detail, fileId, imageUrl, promptCacheBreakpoint, mutableMapOf())
 
     /**
      * The type of the input item. Always `input_image`.
@@ -78,6 +82,16 @@ private constructor(
      */
     fun imageUrl(): Optional<String> = imageUrl.getOptional("image_url")
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+        promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
     /**
      * Returns the raw JSON value of [detail].
      *
@@ -99,6 +113,16 @@ private constructor(
      */
     @JsonProperty("image_url") @ExcludeMissing fun _imageUrl(): JsonField<String> = imageUrl
 
+    /**
+     * Returns the raw JSON value of [promptCacheBreakpoint].
+     *
+     * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_breakpoint")
+    @ExcludeMissing
+    fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -126,6 +150,7 @@ private constructor(
         private var detail: JsonField<Detail> = JsonMissing.of()
         private var fileId: JsonField<String> = JsonMissing.of()
         private var imageUrl: JsonField<String> = JsonMissing.of()
+        private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -134,6 +159,7 @@ private constructor(
             detail = responseInputImageContent.detail
             fileId = responseInputImageContent.fileId
             imageUrl = responseInputImageContent.imageUrl
+            promptCacheBreakpoint = responseInputImageContent.promptCacheBreakpoint
             additionalProperties = responseInputImageContent.additionalProperties.toMutableMap()
         }
 
@@ -199,6 +225,31 @@ private constructor(
          */
         fun imageUrl(imageUrl: JsonField<String>) = apply { this.imageUrl = imageUrl }
 
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint?) =
+            promptCacheBreakpoint(JsonField.ofNullable(promptCacheBreakpoint))
+
+        /**
+         * Alias for calling [Builder.promptCacheBreakpoint] with
+         * `promptCacheBreakpoint.orElse(null)`.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: Optional<PromptCacheBreakpoint>) =
+            promptCacheBreakpoint(promptCacheBreakpoint.getOrNull())
+
+        /**
+         * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+         * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) = apply {
+            this.promptCacheBreakpoint = promptCacheBreakpoint
+        }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -229,6 +280,7 @@ private constructor(
                 detail,
                 fileId,
                 imageUrl,
+                promptCacheBreakpoint,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -256,6 +308,7 @@ private constructor(
         detail().ifPresent { it.validate() }
         fileId()
         imageUrl()
+        promptCacheBreakpoint().ifPresent { it.validate() }
         validated = true
     }
 
@@ -277,7 +330,8 @@ private constructor(
         type.let { if (it == JsonValue.from("input_image")) 1 else 0 } +
             (detail.asKnown().getOrNull()?.validity() ?: 0) +
             (if (fileId.asKnown().isPresent) 1 else 0) +
-            (if (imageUrl.asKnown().isPresent) 1 else 0)
+            (if (imageUrl.asKnown().isPresent) 1 else 0) +
+            (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
 
     /**
      * The detail level of the image to be sent to the model. One of `high`, `low`, `auto`, or
@@ -429,6 +483,168 @@ private constructor(
         override fun toString() = value.toString()
     }
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     */
+    class PromptCacheBreakpoint
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+        ) : this(mode, mutableMapOf())
+
+        /**
+         * The breakpoint mode. Always `explicit`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("explicit")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheBreakpoint].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheBreakpoint]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonValue = JsonValue.from("explicit")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                mode = promptCacheBreakpoint.mode
+                additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheBreakpoint].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheBreakpoint =
+                PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheBreakpoint = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _mode().let {
+                if (it != JsonValue.from("explicit")) {
+                    throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheBreakpoint &&
+                mode == other.mode &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -439,15 +655,16 @@ private constructor(
             detail == other.detail &&
             fileId == other.fileId &&
             imageUrl == other.imageUrl &&
+            promptCacheBreakpoint == other.promptCacheBreakpoint &&
             additionalProperties == other.additionalProperties
     }
 
     private val hashCode: Int by lazy {
-        Objects.hash(type, detail, fileId, imageUrl, additionalProperties)
+        Objects.hash(type, detail, fileId, imageUrl, promptCacheBreakpoint, additionalProperties)
     }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseInputImageContent{type=$type, detail=$detail, fileId=$fileId, imageUrl=$imageUrl, additionalProperties=$additionalProperties}"
+        "ResponseInputImageContent{type=$type, detail=$detail, fileId=$fileId, imageUrl=$imageUrl, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputItem.kt
index babe15603..b2b64717f 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputItem.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputItem.kt
@@ -72,6 +72,8 @@ private constructor(
     private val customToolCall: ResponseCustomToolCall? = null,
     private val compactionTrigger: JsonValue? = null,
     private val itemReference: ItemReference? = null,
+    private val program: Program? = null,
+    private val programOutput: ProgramOutput? = null,
     private val _json: JsonValue? = null,
 ) {
 
@@ -203,6 +205,10 @@ private constructor(
     /** An internal identifier for an item to reference. */
     fun itemReference(): Optional<ItemReference> = Optional.ofNullable(itemReference)
 
+    fun program(): Optional<Program> = Optional.ofNullable(program)
+
+    fun programOutput(): Optional<ProgramOutput> = Optional.ofNullable(programOutput)
+
     fun isEasyInputMessage(): Boolean = easyInputMessage != null
 
     fun isMessage(): Boolean = message != null
@@ -263,6 +269,10 @@ private constructor(
 
     fun isItemReference(): Boolean = itemReference != null
 
+    fun isProgram(): Boolean = program != null
+
+    fun isProgramOutput(): Boolean = programOutput != null
+
     /**
      * A message input to the model with a role indicating instruction following hierarchy.
      * Instructions given with the `developer` or `system` role take precedence over instructions
@@ -394,6 +404,10 @@ private constructor(
     /** An internal identifier for an item to reference. */
     fun asItemReference(): ItemReference = itemReference.getOrThrow("itemReference")
 
+    fun asProgram(): Program = program.getOrThrow("program")
+
+    fun asProgramOutput(): ProgramOutput = programOutput.getOrThrow("programOutput")
+
     fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
 
     /**
@@ -458,6 +472,8 @@ private constructor(
             customToolCall != null -> visitor.visitCustomToolCall(customToolCall)
             compactionTrigger != null -> visitor.visitCompactionTrigger(compactionTrigger)
             itemReference != null -> visitor.visitItemReference(itemReference)
+            program != null -> visitor.visitProgram(program)
+            programOutput != null -> visitor.visitProgramOutput(programOutput)
             else -> visitor.unknown(_json)
         }
 
@@ -611,6 +627,14 @@ private constructor(
                 override fun visitItemReference(itemReference: ItemReference) {
                     itemReference.validate()
                 }
+
+                override fun visitProgram(program: Program) {
+                    program.validate()
+                }
+
+                override fun visitProgramOutput(programOutput: ProgramOutput) {
+                    programOutput.validate()
+                }
             }
         )
         validated = true
@@ -724,6 +748,11 @@ private constructor(
                 override fun visitItemReference(itemReference: ItemReference) =
                     itemReference.validity()
 
+                override fun visitProgram(program: Program) = program.validity()
+
+                override fun visitProgramOutput(programOutput: ProgramOutput) =
+                    programOutput.validity()
+
                 override fun unknown(json: JsonValue?) = 0
             }
         )
@@ -763,7 +792,9 @@ private constructor(
             customToolCallOutput == other.customToolCallOutput &&
             customToolCall == other.customToolCall &&
             compactionTrigger == other.compactionTrigger &&
-            itemReference == other.itemReference
+            itemReference == other.itemReference &&
+            program == other.program &&
+            programOutput == other.programOutput
     }
 
     override fun hashCode(): Int =
@@ -798,6 +829,8 @@ private constructor(
             customToolCall,
             compactionTrigger,
             itemReference,
+            program,
+            programOutput,
         )
 
     override fun toString(): String =
@@ -842,6 +875,8 @@ private constructor(
             customToolCall != null -> "ResponseInputItem{customToolCall=$customToolCall}"
             compactionTrigger != null -> "ResponseInputItem{compactionTrigger=$compactionTrigger}"
             itemReference != null -> "ResponseInputItem{itemReference=$itemReference}"
+            program != null -> "ResponseInputItem{program=$program}"
+            programOutput != null -> "ResponseInputItem{programOutput=$programOutput}"
             _json != null -> "ResponseInputItem{_unknown=$_json}"
             else -> throw IllegalStateException("Invalid ResponseInputItem")
         }
@@ -1024,6 +1059,12 @@ private constructor(
         @JvmStatic
         fun ofItemReference(itemReference: ItemReference) =
             ResponseInputItem(itemReference = itemReference)
+
+        @JvmStatic fun ofProgram(program: Program) = ResponseInputItem(program = program)
+
+        @JvmStatic
+        fun ofProgramOutput(programOutput: ProgramOutput) =
+            ResponseInputItem(programOutput = programOutput)
     }
 
     /**
@@ -1154,6 +1195,10 @@ private constructor(
         /** An internal identifier for an item to reference. */
         fun visitItemReference(itemReference: ItemReference): T
 
+        fun visitProgram(program: Program): T
+
+        fun visitProgramOutput(programOutput: ProgramOutput): T
+
         /**
          * Maps an unknown variant of [ResponseInputItem] to a value of type [T].
          *
@@ -1338,6 +1383,16 @@ private constructor(
                         ResponseInputItem(itemReference = it, _json = json)
                     } ?: ResponseInputItem(_json = json)
                 }
+                "program" -> {
+                    return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                        ResponseInputItem(program = it, _json = json)
+                    } ?: ResponseInputItem(_json = json)
+                }
+                "program_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ProgramOutput>())?.let {
+                        ResponseInputItem(programOutput = it, _json = json)
+                    } ?: ResponseInputItem(_json = json)
+                }
             }
 
             return ResponseInputItem(_json = json)
@@ -1389,6 +1444,8 @@ private constructor(
                 value.customToolCall != null -> generator.writeObject(value.customToolCall)
                 value.compactionTrigger != null -> generator.writeObject(value.compactionTrigger)
                 value.itemReference != null -> generator.writeObject(value.itemReference)
+                value.program != null -> generator.writeObject(value.program)
+                value.programOutput != null -> generator.writeObject(value.programOutput)
                 value._json != null -> generator.writeObject(value._json)
                 else -> throw IllegalStateException("Invalid ResponseInputItem")
             }
@@ -3000,6 +3057,7 @@ private constructor(
         private val output: JsonField<Output>,
         private val type: JsonValue,
         private val id: JsonField<String>,
+        private val caller: JsonField<Caller>,
         private val status: JsonField<Status>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
@@ -3010,8 +3068,9 @@ private constructor(
             @JsonProperty("output") @ExcludeMissing output: JsonField<Output> = JsonMissing.of(),
             @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
             @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
             @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
-        ) : this(callId, output, type, id, status, mutableMapOf())
+        ) : this(callId, output, type, id, caller, status, mutableMapOf())
 
         /**
          * The unique ID of the function tool call generated by the model.
@@ -3051,6 +3110,14 @@ private constructor(
          */
         fun id(): Optional<String> = id.getOptional("id")
 
+        /**
+         * The execution context that produced this tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun caller(): Optional<Caller> = caller.getOptional("caller")
+
         /**
          * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated
          * when items are returned via API.
@@ -3081,6 +3148,13 @@ private constructor(
          */
         @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
+        /**
+         * Returns the raw JSON value of [caller].
+         *
+         * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
         /**
          * Returns the raw JSON value of [status].
          *
@@ -3121,6 +3195,7 @@ private constructor(
             private var output: JsonField<Output>? = null
             private var type: JsonValue = JsonValue.from("function_call_output")
             private var id: JsonField<String> = JsonMissing.of()
+            private var caller: JsonField<Caller> = JsonMissing.of()
             private var status: JsonField<Status> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
@@ -3130,6 +3205,7 @@ private constructor(
                 output = functionCallOutput.output
                 type = functionCallOutput.type
                 id = functionCallOutput.id
+                caller = functionCallOutput.caller
                 status = functionCallOutput.status
                 additionalProperties = functionCallOutput.additionalProperties.toMutableMap()
             }
@@ -3212,6 +3288,38 @@ private constructor(
              */
             fun id(id: JsonField<String>) = apply { this.id = id }
 
+            /** The execution context that produced this tool call. */
+            fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+            /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+            fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+            /**
+             * Sets [Builder.caller] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.caller] with a well-typed [Caller] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+            /** Alias for calling [caller] with `Caller.ofDirect()`. */
+            fun callerDirect() = caller(Caller.ofDirect())
+
+            /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+            fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+            /**
+             * Alias for calling [caller] with the following:
+             * ```java
+             * Caller.Program.builder()
+             *     .callerId(callerId)
+             *     .build()
+             * ```
+             */
+            fun programCaller(callerId: String) =
+                caller(Caller.Program.builder().callerId(callerId).build())
+
             /**
              * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated
              * when items are returned via API.
@@ -3268,6 +3376,7 @@ private constructor(
                     checkRequired("output", output),
                     type,
                     id,
+                    caller,
                     status,
                     additionalProperties.toMutableMap(),
                 )
@@ -3297,6 +3406,7 @@ private constructor(
                 }
             }
             id()
+            caller().ifPresent { it.validate() }
             status().ifPresent { it.validate() }
             validated = true
         }
@@ -3321,6 +3431,7 @@ private constructor(
                 (output.asKnown().getOrNull()?.validity() ?: 0) +
                 type.let { if (it == JsonValue.from("function_call_output")) 1 else 0 } +
                 (if (id.asKnown().isPresent) 1 else 0) +
+                (caller.asKnown().getOrNull()?.validity() ?: 0) +
                 (status.asKnown().getOrNull()?.validity() ?: 0)
 
         /** Text, image, or file output of the function tool call. */
@@ -3575,103 +3686,65 @@ private constructor(
             }
         }
 
-        /**
-         * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated
-         * when items are returned via API.
-         */
-        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
-
-            /**
-             * Returns this class instance's raw value.
-             *
-             * This is usually only useful if this instance was deserialized from data that doesn't
-             * match any known member, and you want to know that value. For example, if the SDK is
-             * on an older version than the API, then the API may respond with new members that the
-             * SDK is unaware of.
-             */
-            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+        /** The execution context that produced this tool call. */
+        @JsonDeserialize(using = Caller.Deserializer::class)
+        @JsonSerialize(using = Caller.Serializer::class)
+        class Caller
+        private constructor(
+            private val direct: JsonValue? = null,
+            private val program: Program? = null,
+            private val _json: JsonValue? = null,
+        ) {
 
-            companion object {
+            fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
 
-                @JvmField val IN_PROGRESS = of("in_progress")
+            fun program(): Optional<Program> = Optional.ofNullable(program)
 
-                @JvmField val COMPLETED = of("completed")
+            fun isDirect(): Boolean = direct != null
 
-                @JvmField val INCOMPLETE = of("incomplete")
+            fun isProgram(): Boolean = program != null
 
-                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
-            }
+            fun asDirect(): JsonValue = direct.getOrThrow("direct")
 
-            /** An enum containing [Status]'s known values. */
-            enum class Known {
-                IN_PROGRESS,
-                COMPLETED,
-                INCOMPLETE,
-            }
+            fun asProgram(): Program = program.getOrThrow("program")
 
-            /**
-             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
-             *
-             * An instance of [Status] can contain an unknown value in a couple of cases:
-             * - It was deserialized from data that doesn't match any known member. For example, if
-             *   the SDK is on an older version than the API, then the API may respond with new
-             *   members that the SDK is unaware of.
-             * - It was constructed with an arbitrary value using the [of] method.
-             */
-            enum class Value {
-                IN_PROGRESS,
-                COMPLETED,
-                INCOMPLETE,
-                /**
-                 * An enum member indicating that [Status] was instantiated with an unknown value.
-                 */
-                _UNKNOWN,
-            }
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
 
             /**
-             * Returns an enum member corresponding to this class instance's value, or
-             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
              *
-             * Use the [known] method instead if you're certain the value is always known or if you
-             * want to throw for the unknown case.
-             */
-            fun value(): Value =
-                when (this) {
-                    IN_PROGRESS -> Value.IN_PROGRESS
-                    COMPLETED -> Value.COMPLETED
-                    INCOMPLETE -> Value.INCOMPLETE
-                    else -> Value._UNKNOWN
-                }
-
-            /**
-             * Returns an enum member corresponding to this class instance's value.
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
              *
-             * Use the [value] method instead if you're uncertain the value is always known and
-             * don't want to throw for the unknown case.
+             * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitDirect(JsonValue direct) {
+             *         return Optional.of(direct.toString());
+             *     }
              *
-             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
-             *   member.
-             */
-            fun known(): Known =
-                when (this) {
-                    IN_PROGRESS -> Known.IN_PROGRESS
-                    COMPLETED -> Known.COMPLETED
-                    INCOMPLETE -> Known.INCOMPLETE
-                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
-                }
-
-            /**
-             * Returns this class instance's primitive wire representation.
+             *     // ...
              *
-             * This differs from the [toString] method because that method is primarily for
-             * debugging and generally doesn't throw.
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
              *
-             * @throws OpenAIInvalidDataException if this class instance's value does not have the
-             *   expected primitive type.
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
              */
-            fun asString(): String =
-                _value().asString().orElseThrow {
-                    OpenAIInvalidDataException("Value is not a String")
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    direct != null -> visitor.visitDirect(direct)
+                    program != null -> visitor.visitProgram(program)
+                    else -> visitor.unknown(_json)
                 }
 
             private var validated: Boolean = false
@@ -3686,12 +3759,28 @@ private constructor(
              * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
              *   expected type.
              */
-            fun validate(): Status = apply {
+            fun validate(): Caller = apply {
                 if (validated) {
                     return@apply
                 }
 
-                known()
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitDirect(direct: JsonValue) {
+                            direct.let {
+                                if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                    throw OpenAIInvalidDataException(
+                                        "'direct' is invalid, received $it"
+                                    )
+                                }
+                            }
+                        }
+
+                        override fun visitProgram(program: Program) {
+                            program.validate()
+                        }
+                    }
+                )
                 validated = true
             }
 
@@ -3709,371 +3798,337 @@ private constructor(
              *
              * Used for best match union deserialization.
              */
-            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitDirect(direct: JsonValue) =
+                            direct.let {
+                                if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0
+                            }
+
+                        override fun visitProgram(program: Program) = program.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
 
             override fun equals(other: Any?): Boolean {
                 if (this === other) {
                     return true
                 }
 
-                return other is Status && value == other.value
+                return other is Caller && direct == other.direct && program == other.program
             }
 
-            override fun hashCode() = value.hashCode()
+            override fun hashCode(): Int = Objects.hash(direct, program)
 
-            override fun toString() = value.toString()
-        }
+            override fun toString(): String =
+                when {
+                    direct != null -> "Caller{direct=$direct}"
+                    program != null -> "Caller{program=$program}"
+                    _json != null -> "Caller{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
 
-        override fun equals(other: Any?): Boolean {
-            if (this === other) {
-                return true
+            companion object {
+
+                @JvmStatic
+                fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+                @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
             }
 
-            return other is FunctionCallOutput &&
-                callId == other.callId &&
-                output == other.output &&
-                type == other.type &&
-                id == other.id &&
-                status == other.status &&
-                additionalProperties == other.additionalProperties
-        }
+            /**
+             * An interface that defines how to map each variant of [Caller] to a value of type [T].
+             */
+            interface Visitor<out T> {
 
-        private val hashCode: Int by lazy {
-            Objects.hash(callId, output, type, id, status, additionalProperties)
-        }
+                fun visitDirect(direct: JsonValue): T
 
-        override fun hashCode(): Int = hashCode
+                fun visitProgram(program: Program): T
 
-        override fun toString() =
-            "FunctionCallOutput{callId=$callId, output=$output, type=$type, id=$id, status=$status, additionalProperties=$additionalProperties}"
-    }
+                /**
+                 * Maps an unknown variant of [Caller] to a value of type [T].
+                 *
+                 * An instance of [Caller] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Caller: $json")
+                }
+            }
 
-    class ToolSearchCall
-    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-    private constructor(
-        private val arguments: JsonValue,
-        private val type: JsonValue,
-        private val id: JsonField<String>,
-        private val callId: JsonField<String>,
-        private val execution: JsonField<Execution>,
-        private val status: JsonField<Status>,
-        private val additionalProperties: MutableMap<String, JsonValue>,
-    ) {
+            internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
 
-        @JsonCreator
-        private constructor(
-            @JsonProperty("arguments") @ExcludeMissing arguments: JsonValue = JsonMissing.of(),
-            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("execution")
-            @ExcludeMissing
-            execution: JsonField<Execution> = JsonMissing.of(),
-            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
-        ) : this(arguments, type, id, callId, execution, status, mutableMapOf())
+                override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
 
-        /**
-         * The arguments supplied to the tool search call.
-         *
-         * This arbitrary value can be deserialized into a custom type using the `convert` method:
-         * ```java
-         * MyClass myObject = toolSearchCall.arguments().convert(MyClass.class);
-         * ```
-         */
-        @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonValue = arguments
+                    when (type) {
+                        "direct" -> {
+                            return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let { Caller(direct = it, _json = json) }
+                                ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                        }
+                        "program" -> {
+                            return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                                Caller(program = it, _json = json)
+                            } ?: Caller(_json = json)
+                        }
+                    }
 
-        /**
-         * The item type. Always `tool_search_call`.
-         *
-         * Expected to always return the following:
-         * ```java
-         * JsonValue.from("tool_search_call")
-         * ```
-         *
-         * However, this method can be useful for debugging and logging (e.g. if the server
-         * responded with an unexpected value).
-         */
-        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+                    return Caller(_json = json)
+                }
+            }
 
-        /**
-         * The unique ID of this tool search call.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun id(): Optional<String> = id.getOptional("id")
+            internal class Serializer : BaseSerializer<Caller>(Caller::class) {
 
-        /**
-         * The unique ID of the tool search call generated by the model.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun callId(): Optional<String> = callId.getOptional("call_id")
+                override fun serialize(
+                    value: Caller,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.direct != null -> generator.writeObject(value.direct)
+                        value.program != null -> generator.writeObject(value.program)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Caller")
+                    }
+                }
+            }
 
-        /**
-         * Whether tool search was executed by the server or by the client.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun execution(): Optional<Execution> = execution.getOptional("execution")
+            class Program
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val callerId: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
 
-        /**
-         * The status of the tool search call.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun status(): Optional<Status> = status.getOptional("status")
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("caller_id")
+                    @ExcludeMissing
+                    callerId: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(callerId, type, mutableMapOf())
 
-        /**
-         * Returns the raw JSON value of [id].
-         *
-         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+                /**
+                 * The call ID of the program item that produced this tool call.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun callerId(): String = callerId.getRequired("caller_id")
 
-        /**
-         * Returns the raw JSON value of [callId].
-         *
-         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+                /**
+                 * The caller type. Always `program`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
-        /**
-         * Returns the raw JSON value of [execution].
-         *
-         * Unlike [execution], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("execution")
-        @ExcludeMissing
-        fun _execution(): JsonField<Execution> = execution
+                /**
+                 * Returns the raw JSON value of [callerId].
+                 *
+                 * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                fun _callerId(): JsonField<String> = callerId
 
-        /**
-         * Returns the raw JSON value of [status].
-         *
-         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
 
-        @JsonAnySetter
-        private fun putAdditionalProperty(key: String, value: JsonValue) {
-            additionalProperties.put(key, value)
-        }
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
 
-        @JsonAnyGetter
-        @ExcludeMissing
-        fun _additionalProperties(): Map<String, JsonValue> =
-            Collections.unmodifiableMap(additionalProperties)
+                fun toBuilder() = Builder().from(this)
 
-        fun toBuilder() = Builder().from(this)
+                companion object {
 
-        companion object {
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Program].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
 
-            /**
-             * Returns a mutable builder for constructing an instance of [ToolSearchCall].
-             *
-             * The following fields are required:
-             * ```java
-             * .arguments()
-             * ```
-             */
-            @JvmStatic fun builder() = Builder()
-        }
+                /** A builder for [Program]. */
+                class Builder internal constructor() {
 
-        /** A builder for [ToolSearchCall]. */
-        class Builder internal constructor() {
+                    private var callerId: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("program")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
-            private var arguments: JsonValue? = null
-            private var type: JsonValue = JsonValue.from("tool_search_call")
-            private var id: JsonField<String> = JsonMissing.of()
-            private var callId: JsonField<String> = JsonMissing.of()
-            private var execution: JsonField<Execution> = JsonMissing.of()
-            private var status: JsonField<Status> = JsonMissing.of()
-            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+                    @JvmSynthetic
+                    internal fun from(program: Program) = apply {
+                        callerId = program.callerId
+                        type = program.type
+                        additionalProperties = program.additionalProperties.toMutableMap()
+                    }
 
-            @JvmSynthetic
-            internal fun from(toolSearchCall: ToolSearchCall) = apply {
-                arguments = toolSearchCall.arguments
-                type = toolSearchCall.type
-                id = toolSearchCall.id
-                callId = toolSearchCall.callId
-                execution = toolSearchCall.execution
-                status = toolSearchCall.status
-                additionalProperties = toolSearchCall.additionalProperties.toMutableMap()
-            }
+                    /** The call ID of the program item that produced this tool call. */
+                    fun callerId(callerId: String) = callerId(JsonField.of(callerId))
 
-            /** The arguments supplied to the tool search call. */
-            fun arguments(arguments: JsonValue) = apply { this.arguments = arguments }
+                    /**
+                     * Sets [Builder.callerId] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.callerId] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
 
-            /**
-             * Sets the field to an arbitrary JSON value.
-             *
-             * It is usually unnecessary to call this method because the field defaults to the
-             * following:
-             * ```java
-             * JsonValue.from("tool_search_call")
-             * ```
-             *
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun type(type: JsonValue) = apply { this.type = type }
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("program")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
 
-            /** The unique ID of this tool search call. */
-            fun id(id: String?) = id(JsonField.ofNullable(id))
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
 
-            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
-            fun id(id: Optional<String>) = id(id.getOrNull())
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
 
-            /**
-             * Sets [Builder.id] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.id] with a well-typed [String] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
-             */
-            fun id(id: JsonField<String>) = apply { this.id = id }
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
 
-            /** The unique ID of the tool search call generated by the model. */
-            fun callId(callId: String?) = callId(JsonField.ofNullable(callId))
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
 
-            /** Alias for calling [Builder.callId] with `callId.orElse(null)`. */
-            fun callId(callId: Optional<String>) = callId(callId.getOrNull())
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
 
-            /**
-             * Sets [Builder.callId] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.callId] with a well-typed [String] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+                    /**
+                     * Returns an immutable instance of [Program].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Program =
+                        Program(
+                            checkRequired("callerId", callerId),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
 
-            /** Whether tool search was executed by the server or by the client. */
-            fun execution(execution: Execution) = execution(JsonField.of(execution))
+                private var validated: Boolean = false
 
-            /**
-             * Sets [Builder.execution] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.execution] with a well-typed [Execution] value
-             * instead. This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun execution(execution: JsonField<Execution>) = apply { this.execution = execution }
-
-            /** The status of the tool search call. */
-            fun status(status: Status?) = status(JsonField.ofNullable(status))
-
-            /** Alias for calling [Builder.status] with `status.orElse(null)`. */
-            fun status(status: Optional<Status>) = status(status.getOrNull())
-
-            /**
-             * Sets [Builder.status] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.status] with a well-typed [Status] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun status(status: JsonField<Status>) = apply { this.status = status }
-
-            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                this.additionalProperties.clear()
-                putAllAdditionalProperties(additionalProperties)
-            }
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Program = apply {
+                    if (validated) {
+                        return@apply
+                    }
 
-            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                additionalProperties.put(key, value)
-            }
+                    callerId()
+                    _type().let {
+                        if (it != JsonValue.from("program")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
 
-            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                this.additionalProperties.putAll(additionalProperties)
-            }
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
 
-            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (callerId.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("program")) 1 else 0 }
 
-            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                keys.forEach(::removeAdditionalProperty)
-            }
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
 
-            /**
-             * Returns an immutable instance of [ToolSearchCall].
-             *
-             * Further updates to this [Builder] will not mutate the returned instance.
-             *
-             * The following fields are required:
-             * ```java
-             * .arguments()
-             * ```
-             *
-             * @throws IllegalStateException if any required field is unset.
-             */
-            fun build(): ToolSearchCall =
-                ToolSearchCall(
-                    checkRequired("arguments", arguments),
-                    type,
-                    id,
-                    callId,
-                    execution,
-                    status,
-                    additionalProperties.toMutableMap(),
-                )
-        }
+                    return other is Program &&
+                        callerId == other.callerId &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
 
-        private var validated: Boolean = false
+                private val hashCode: Int by lazy {
+                    Objects.hash(callerId, type, additionalProperties)
+                }
 
-        /**
-         * Validates that the types of all values in this object match their expected types
-         * recursively.
-         *
-         * This method is _not_ forwards compatible with new types from the API for existing fields.
-         *
-         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-         *   expected type.
-         */
-        fun validate(): ToolSearchCall = apply {
-            if (validated) {
-                return@apply
-            }
+                override fun hashCode(): Int = hashCode
 
-            _type().let {
-                if (it != JsonValue.from("tool_search_call")) {
-                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
-                }
+                override fun toString() =
+                    "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
             }
-            id()
-            callId()
-            execution().ifPresent { it.validate() }
-            status().ifPresent { it.validate() }
-            validated = true
         }
 
-        fun isValid(): Boolean =
-            try {
-                validate()
-                true
-            } catch (e: OpenAIInvalidDataException) {
-                false
-            }
-
         /**
-         * Returns a score indicating how many valid values are contained in this object
-         * recursively.
-         *
-         * Used for best match union deserialization.
+         * The status of the item. One of `in_progress`, `completed`, or `incomplete`. Populated
+         * when items are returned via API.
          */
-        @JvmSynthetic
-        internal fun validity(): Int =
-            type.let { if (it == JsonValue.from("tool_search_call")) 1 else 0 } +
-                (if (id.asKnown().isPresent) 1 else 0) +
-                (if (callId.asKnown().isPresent) 1 else 0) +
-                (execution.asKnown().getOrNull()?.validity() ?: 0) +
-                (status.asKnown().getOrNull()?.validity() ?: 0)
-
-        /** Whether tool search was executed by the server or by the client. */
-        class Execution @JsonCreator private constructor(private val value: JsonField<String>) :
-            Enum {
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
             /**
              * Returns this class instance's raw value.
@@ -4087,34 +4142,37 @@ private constructor(
 
             companion object {
 
-                @JvmField val SERVER = of("server")
+                @JvmField val IN_PROGRESS = of("in_progress")
 
-                @JvmField val CLIENT = of("client")
+                @JvmField val COMPLETED = of("completed")
 
-                @JvmStatic fun of(value: String) = Execution(JsonField.of(value))
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
             }
 
-            /** An enum containing [Execution]'s known values. */
+            /** An enum containing [Status]'s known values. */
             enum class Known {
-                SERVER,
-                CLIENT,
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
             }
 
             /**
-             * An enum containing [Execution]'s known values, as well as an [_UNKNOWN] member.
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
              *
-             * An instance of [Execution] can contain an unknown value in a couple of cases:
+             * An instance of [Status] can contain an unknown value in a couple of cases:
              * - It was deserialized from data that doesn't match any known member. For example, if
              *   the SDK is on an older version than the API, then the API may respond with new
              *   members that the SDK is unaware of.
              * - It was constructed with an arbitrary value using the [of] method.
              */
             enum class Value {
-                SERVER,
-                CLIENT,
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
                 /**
-                 * An enum member indicating that [Execution] was instantiated with an unknown
-                 * value.
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
                  */
                 _UNKNOWN,
             }
@@ -4128,8 +4186,9 @@ private constructor(
              */
             fun value(): Value =
                 when (this) {
-                    SERVER -> Value.SERVER
-                    CLIENT -> Value.CLIENT
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
                     else -> Value._UNKNOWN
                 }
 
@@ -4144,9 +4203,10 @@ private constructor(
              */
             fun known(): Known =
                 when (this) {
-                    SERVER -> Known.SERVER
-                    CLIENT -> Known.CLIENT
-                    else -> throw OpenAIInvalidDataException("Unknown Execution: $value")
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
                 }
 
             /**
@@ -4175,7 +4235,7 @@ private constructor(
              * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
              *   expected type.
              */
-            fun validate(): Execution = apply {
+            fun validate(): Status = apply {
                 if (validated) {
                     return@apply
                 }
@@ -4205,7 +4265,7 @@ private constructor(
                     return true
                 }
 
-                return other is Execution && value == other.value
+                return other is Status && value == other.value
             }
 
             override fun hashCode() = value.hashCode()
@@ -4213,243 +4273,109 @@ private constructor(
             override fun toString() = value.toString()
         }
 
-        /** The status of the tool search call. */
-        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
 
-            /**
-             * Returns this class instance's raw value.
-             *
-             * This is usually only useful if this instance was deserialized from data that doesn't
-             * match any known member, and you want to know that value. For example, if the SDK is
-             * on an older version than the API, then the API may respond with new members that the
-             * SDK is unaware of.
-             */
-            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+            return other is FunctionCallOutput &&
+                callId == other.callId &&
+                output == other.output &&
+                type == other.type &&
+                id == other.id &&
+                caller == other.caller &&
+                status == other.status &&
+                additionalProperties == other.additionalProperties
+        }
 
-            companion object {
+        private val hashCode: Int by lazy {
+            Objects.hash(callId, output, type, id, caller, status, additionalProperties)
+        }
 
-                @JvmField val IN_PROGRESS = of("in_progress")
+        override fun hashCode(): Int = hashCode
 
-                @JvmField val COMPLETED = of("completed")
+        override fun toString() =
+            "FunctionCallOutput{callId=$callId, output=$output, type=$type, id=$id, caller=$caller, status=$status, additionalProperties=$additionalProperties}"
+    }
 
-                @JvmField val INCOMPLETE = of("incomplete")
+    class ToolSearchCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val arguments: JsonValue,
+        private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val callId: JsonField<String>,
+        private val execution: JsonField<Execution>,
+        private val status: JsonField<Status>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
 
-                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
-            }
+        @JsonCreator
+        private constructor(
+            @JsonProperty("arguments") @ExcludeMissing arguments: JsonValue = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("execution")
+            @ExcludeMissing
+            execution: JsonField<Execution> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        ) : this(arguments, type, id, callId, execution, status, mutableMapOf())
 
-            /** An enum containing [Status]'s known values. */
-            enum class Known {
-                IN_PROGRESS,
-                COMPLETED,
-                INCOMPLETE,
-            }
-
-            /**
-             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
-             *
-             * An instance of [Status] can contain an unknown value in a couple of cases:
-             * - It was deserialized from data that doesn't match any known member. For example, if
-             *   the SDK is on an older version than the API, then the API may respond with new
-             *   members that the SDK is unaware of.
-             * - It was constructed with an arbitrary value using the [of] method.
-             */
-            enum class Value {
-                IN_PROGRESS,
-                COMPLETED,
-                INCOMPLETE,
-                /**
-                 * An enum member indicating that [Status] was instantiated with an unknown value.
-                 */
-                _UNKNOWN,
-            }
-
-            /**
-             * Returns an enum member corresponding to this class instance's value, or
-             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
-             *
-             * Use the [known] method instead if you're certain the value is always known or if you
-             * want to throw for the unknown case.
-             */
-            fun value(): Value =
-                when (this) {
-                    IN_PROGRESS -> Value.IN_PROGRESS
-                    COMPLETED -> Value.COMPLETED
-                    INCOMPLETE -> Value.INCOMPLETE
-                    else -> Value._UNKNOWN
-                }
-
-            /**
-             * Returns an enum member corresponding to this class instance's value.
-             *
-             * Use the [value] method instead if you're uncertain the value is always known and
-             * don't want to throw for the unknown case.
-             *
-             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
-             *   member.
-             */
-            fun known(): Known =
-                when (this) {
-                    IN_PROGRESS -> Known.IN_PROGRESS
-                    COMPLETED -> Known.COMPLETED
-                    INCOMPLETE -> Known.INCOMPLETE
-                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
-                }
-
-            /**
-             * Returns this class instance's primitive wire representation.
-             *
-             * This differs from the [toString] method because that method is primarily for
-             * debugging and generally doesn't throw.
-             *
-             * @throws OpenAIInvalidDataException if this class instance's value does not have the
-             *   expected primitive type.
-             */
-            fun asString(): String =
-                _value().asString().orElseThrow {
-                    OpenAIInvalidDataException("Value is not a String")
-                }
-
-            private var validated: Boolean = false
-
-            /**
-             * Validates that the types of all values in this object match their expected types
-             * recursively.
-             *
-             * This method is _not_ forwards compatible with new types from the API for existing
-             * fields.
-             *
-             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-             *   expected type.
-             */
-            fun validate(): Status = apply {
-                if (validated) {
-                    return@apply
-                }
-
-                known()
-                validated = true
-            }
-
-            fun isValid(): Boolean =
-                try {
-                    validate()
-                    true
-                } catch (e: OpenAIInvalidDataException) {
-                    false
-                }
-
-            /**
-             * Returns a score indicating how many valid values are contained in this object
-             * recursively.
-             *
-             * Used for best match union deserialization.
-             */
-            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
-
-            override fun equals(other: Any?): Boolean {
-                if (this === other) {
-                    return true
-                }
-
-                return other is Status && value == other.value
-            }
-
-            override fun hashCode() = value.hashCode()
-
-            override fun toString() = value.toString()
-        }
-
-        override fun equals(other: Any?): Boolean {
-            if (this === other) {
-                return true
-            }
-
-            return other is ToolSearchCall &&
-                arguments == other.arguments &&
-                type == other.type &&
-                id == other.id &&
-                callId == other.callId &&
-                execution == other.execution &&
-                status == other.status &&
-                additionalProperties == other.additionalProperties
-        }
-
-        private val hashCode: Int by lazy {
-            Objects.hash(arguments, type, id, callId, execution, status, additionalProperties)
-        }
-
-        override fun hashCode(): Int = hashCode
-
-        override fun toString() =
-            "ToolSearchCall{arguments=$arguments, type=$type, id=$id, callId=$callId, execution=$execution, status=$status, additionalProperties=$additionalProperties}"
-    }
-
-    class AdditionalTools
-    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-    private constructor(
-        private val role: JsonValue,
-        private val tools: JsonField<List<Tool>>,
-        private val type: JsonValue,
-        private val id: JsonField<String>,
-        private val additionalProperties: MutableMap<String, JsonValue>,
-    ) {
-
-        @JsonCreator
-        private constructor(
-            @JsonProperty("role") @ExcludeMissing role: JsonValue = JsonMissing.of(),
-            @JsonProperty("tools") @ExcludeMissing tools: JsonField<List<Tool>> = JsonMissing.of(),
-            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-        ) : this(role, tools, type, id, mutableMapOf())
+        /**
+         * The arguments supplied to the tool search call.
+         *
+         * This arbitrary value can be deserialized into a custom type using the `convert` method:
+         * ```java
+         * MyClass myObject = toolSearchCall.arguments().convert(MyClass.class);
+         * ```
+         */
+        @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonValue = arguments
 
         /**
-         * The role that provided the additional tools. Only `developer` is supported.
+         * The item type. Always `tool_search_call`.
          *
          * Expected to always return the following:
          * ```java
-         * JsonValue.from("developer")
+         * JsonValue.from("tool_search_call")
          * ```
          *
          * However, this method can be useful for debugging and logging (e.g. if the server
          * responded with an unexpected value).
          */
-        @JsonProperty("role") @ExcludeMissing fun _role(): JsonValue = role
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
         /**
-         * A list of additional tools made available at this item.
+         * The unique ID of this tool search call.
          *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
          */
-        fun tools(): List<Tool> = tools.getRequired("tools")
+        fun id(): Optional<String> = id.getOptional("id")
 
         /**
-         * The item type. Always `additional_tools`.
-         *
-         * Expected to always return the following:
-         * ```java
-         * JsonValue.from("additional_tools")
-         * ```
+         * The unique ID of the tool search call generated by the model.
          *
-         * However, this method can be useful for debugging and logging (e.g. if the server
-         * responded with an unexpected value).
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
          */
-        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+        fun callId(): Optional<String> = callId.getOptional("call_id")
 
         /**
-         * The unique ID of this additional tools item.
+         * Whether tool search was executed by the server or by the client.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
-        fun id(): Optional<String> = id.getOptional("id")
+        fun execution(): Optional<Execution> = execution.getOptional("execution")
 
         /**
-         * Returns the raw JSON value of [tools].
+         * The status of the tool search call.
          *
-         * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
          */
-        @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<Tool>> = tools
+        fun status(): Optional<Status> = status.getOptional("status")
 
         /**
          * Returns the raw JSON value of [id].
@@ -4458,6 +4384,29 @@ private constructor(
          */
         @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [execution].
+         *
+         * Unlike [execution], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("execution")
+        @ExcludeMissing
+        fun _execution(): JsonField<Execution> = execution
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
             additionalProperties.put(key, value)
@@ -4473,214 +4422,111 @@ private constructor(
         companion object {
 
             /**
-             * Returns a mutable builder for constructing an instance of [AdditionalTools].
+             * Returns a mutable builder for constructing an instance of [ToolSearchCall].
              *
              * The following fields are required:
              * ```java
-             * .tools()
+             * .arguments()
              * ```
              */
             @JvmStatic fun builder() = Builder()
         }
 
-        /** A builder for [AdditionalTools]. */
+        /** A builder for [ToolSearchCall]. */
         class Builder internal constructor() {
 
-            private var role: JsonValue = JsonValue.from("developer")
-            private var tools: JsonField<MutableList<Tool>>? = null
-            private var type: JsonValue = JsonValue.from("additional_tools")
+            private var arguments: JsonValue? = null
+            private var type: JsonValue = JsonValue.from("tool_search_call")
             private var id: JsonField<String> = JsonMissing.of()
+            private var callId: JsonField<String> = JsonMissing.of()
+            private var execution: JsonField<Execution> = JsonMissing.of()
+            private var status: JsonField<Status> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
-            internal fun from(additionalTools: AdditionalTools) = apply {
-                role = additionalTools.role
-                tools = additionalTools.tools.map { it.toMutableList() }
-                type = additionalTools.type
-                id = additionalTools.id
-                additionalProperties = additionalTools.additionalProperties.toMutableMap()
-            }
-
-            /**
-             * Sets the field to an arbitrary JSON value.
+            internal fun from(toolSearchCall: ToolSearchCall) = apply {
+                arguments = toolSearchCall.arguments
+                type = toolSearchCall.type
+                id = toolSearchCall.id
+                callId = toolSearchCall.callId
+                execution = toolSearchCall.execution
+                status = toolSearchCall.status
+                additionalProperties = toolSearchCall.additionalProperties.toMutableMap()
+            }
+
+            /** The arguments supplied to the tool search call. */
+            fun arguments(arguments: JsonValue) = apply { this.arguments = arguments }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
              *
              * It is usually unnecessary to call this method because the field defaults to the
              * following:
              * ```java
-             * JsonValue.from("developer")
+             * JsonValue.from("tool_search_call")
              * ```
              *
              * This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun role(role: JsonValue) = apply { this.role = role }
+            fun type(type: JsonValue) = apply { this.type = type }
 
-            /** A list of additional tools made available at this item. */
-            fun tools(tools: List<Tool>) = tools(JsonField.of(tools))
+            /** The unique ID of this tool search call. */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
 
-            /**
-             * Sets [Builder.tools] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.tools] with a well-typed `List<Tool>` value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun tools(tools: JsonField<List<Tool>>) = apply {
-                this.tools = tools.map { it.toMutableList() }
-            }
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
 
             /**
-             * Adds a single [Tool] to [tools].
+             * Sets [Builder.id] to an arbitrary JSON value.
              *
-             * @throws IllegalStateException if the field was previously set to a non-list.
-             */
-            fun addTool(tool: Tool) = apply {
-                tools =
-                    (tools ?: JsonField.of(mutableListOf())).also {
-                        checkKnown("tools", it).add(tool)
-                    }
-            }
-
-            /** Alias for calling [addTool] with `Tool.ofFunction(function)`. */
-            fun addTool(function: FunctionTool) = addTool(Tool.ofFunction(function))
-
-            /** Alias for calling [addTool] with `Tool.ofFileSearch(fileSearch)`. */
-            fun addTool(fileSearch: FileSearchTool) = addTool(Tool.ofFileSearch(fileSearch))
-
-            /**
-             * Alias for calling [addTool] with the following:
-             * ```java
-             * FileSearchTool.builder()
-             *     .vectorStoreIds(vectorStoreIds)
-             *     .build()
-             * ```
-             */
-            fun addFileSearchTool(vectorStoreIds: List<String>) =
-                addTool(FileSearchTool.builder().vectorStoreIds(vectorStoreIds).build())
-
-            /** Alias for calling [addTool] with `Tool.ofComputer(computer)`. */
-            fun addTool(computer: ComputerTool) = addTool(Tool.ofComputer(computer))
-
-            /** Alias for calling [addTool] with `Tool.ofComputerUsePreview(computerUsePreview)`. */
-            fun addTool(computerUsePreview: ComputerUsePreviewTool) =
-                addTool(Tool.ofComputerUsePreview(computerUsePreview))
-
-            /** Alias for calling [addTool] with `Tool.ofWebSearch(webSearch)`. */
-            fun addTool(webSearch: WebSearchTool) = addTool(Tool.ofWebSearch(webSearch))
-
-            /** Alias for calling [addTool] with `Tool.ofMcp(mcp)`. */
-            fun addTool(mcp: Tool.Mcp) = addTool(Tool.ofMcp(mcp))
-
-            /**
-             * Alias for calling [addTool] with the following:
-             * ```java
-             * Tool.Mcp.builder()
-             *     .serverLabel(serverLabel)
-             *     .build()
-             * ```
-             */
-            fun addMcpTool(serverLabel: String) =
-                addTool(Tool.Mcp.builder().serverLabel(serverLabel).build())
-
-            /** Alias for calling [addTool] with `Tool.ofCodeInterpreter(codeInterpreter)`. */
-            fun addTool(codeInterpreter: Tool.CodeInterpreter) =
-                addTool(Tool.ofCodeInterpreter(codeInterpreter))
-
-            /**
-             * Alias for calling [addTool] with the following:
-             * ```java
-             * Tool.CodeInterpreter.builder()
-             *     .container(container)
-             *     .build()
-             * ```
-             */
-            fun addCodeInterpreterTool(container: Tool.CodeInterpreter.Container) =
-                addTool(Tool.CodeInterpreter.builder().container(container).build())
-
-            /**
-             * Alias for calling [addCodeInterpreterTool] with
-             * `Tool.CodeInterpreter.Container.ofString(string)`.
-             */
-            fun addCodeInterpreterTool(string: String) =
-                addCodeInterpreterTool(Tool.CodeInterpreter.Container.ofString(string))
-
-            /**
-             * Alias for calling [addCodeInterpreterTool] with
-             * `Tool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)`.
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
              */
-            fun addCodeInterpreterTool(
-                codeInterpreterToolAuto: Tool.CodeInterpreter.Container.CodeInterpreterToolAuto
-            ) =
-                addCodeInterpreterTool(
-                    Tool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(
-                        codeInterpreterToolAuto
-                    )
-                )
-
-            /** Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`. */
-            fun addTool(imageGeneration: Tool.ImageGeneration) =
-                addTool(Tool.ofImageGeneration(imageGeneration))
-
-            /** Alias for calling [addTool] with `Tool.ofLocalShell()`. */
-            fun addToolLocalShell() = addTool(Tool.ofLocalShell())
+            fun id(id: JsonField<String>) = apply { this.id = id }
 
-            /** Alias for calling [addTool] with `Tool.ofShell(shell)`. */
-            fun addTool(shell: FunctionShellTool) = addTool(Tool.ofShell(shell))
+            /** The unique ID of the tool search call generated by the model. */
+            fun callId(callId: String?) = callId(JsonField.ofNullable(callId))
 
-            /** Alias for calling [addTool] with `Tool.ofCustom(custom)`. */
-            fun addTool(custom: CustomTool) = addTool(Tool.ofCustom(custom))
+            /** Alias for calling [Builder.callId] with `callId.orElse(null)`. */
+            fun callId(callId: Optional<String>) = callId(callId.getOrNull())
 
             /**
-             * Alias for calling [addTool] with the following:
-             * ```java
-             * CustomTool.builder()
-             *     .name(name)
-             *     .build()
-             * ```
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            fun addCustomTool(name: String) = addTool(CustomTool.builder().name(name).build())
-
-            /** Alias for calling [addTool] with `Tool.ofNamespace(namespace)`. */
-            fun addTool(namespace: NamespaceTool) = addTool(Tool.ofNamespace(namespace))
-
-            /** Alias for calling [addTool] with `Tool.ofSearch(search)`. */
-            fun addTool(search: ToolSearchTool) = addTool(Tool.ofSearch(search))
-
-            /** Alias for calling [addTool] with `Tool.ofWebSearchPreview(webSearchPreview)`. */
-            fun addTool(webSearchPreview: WebSearchPreviewTool) =
-                addTool(Tool.ofWebSearchPreview(webSearchPreview))
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
 
-            /** Alias for calling [addTool] with `Tool.ofApplyPatch(applyPatch)`. */
-            fun addTool(applyPatch: ApplyPatchTool) = addTool(Tool.ofApplyPatch(applyPatch))
+            /** Whether tool search was executed by the server or by the client. */
+            fun execution(execution: Execution) = execution(JsonField.of(execution))
 
             /**
-             * Sets the field to an arbitrary JSON value.
-             *
-             * It is usually unnecessary to call this method because the field defaults to the
-             * following:
-             * ```java
-             * JsonValue.from("additional_tools")
-             * ```
+             * Sets [Builder.execution] to an arbitrary JSON value.
              *
-             * This method is primarily for setting the field to an undocumented or not yet
+             * You should usually call [Builder.execution] with a well-typed [Execution] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun type(type: JsonValue) = apply { this.type = type }
+            fun execution(execution: JsonField<Execution>) = apply { this.execution = execution }
 
-            /** The unique ID of this additional tools item. */
-            fun id(id: String?) = id(JsonField.ofNullable(id))
+            /** The status of the tool search call. */
+            fun status(status: Status?) = status(JsonField.ofNullable(status))
 
-            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
-            fun id(id: Optional<String>) = id(id.getOrNull())
+            /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+            fun status(status: Optional<Status>) = status(status.getOrNull())
 
             /**
-             * Sets [Builder.id] to an arbitrary JSON value.
+             * Sets [Builder.status] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.id] with a well-typed [String] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            fun id(id: JsonField<String>) = apply { this.id = id }
+            fun status(status: JsonField<Status>) = apply { this.status = status }
 
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
@@ -4702,23 +4548,25 @@ private constructor(
             }
 
             /**
-             * Returns an immutable instance of [AdditionalTools].
+             * Returns an immutable instance of [ToolSearchCall].
              *
              * Further updates to this [Builder] will not mutate the returned instance.
              *
              * The following fields are required:
              * ```java
-             * .tools()
+             * .arguments()
              * ```
              *
              * @throws IllegalStateException if any required field is unset.
              */
-            fun build(): AdditionalTools =
-                AdditionalTools(
-                    role,
-                    checkRequired("tools", tools).map { it.toImmutable() },
+            fun build(): ToolSearchCall =
+                ToolSearchCall(
+                    checkRequired("arguments", arguments),
                     type,
                     id,
+                    callId,
+                    execution,
+                    status,
                     additionalProperties.toMutableMap(),
                 )
         }
@@ -4734,23 +4582,20 @@ private constructor(
          * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
          *   expected type.
          */
-        fun validate(): AdditionalTools = apply {
+        fun validate(): ToolSearchCall = apply {
             if (validated) {
                 return@apply
             }
 
-            _role().let {
-                if (it != JsonValue.from("developer")) {
-                    throw OpenAIInvalidDataException("'role' is invalid, received $it")
-                }
-            }
-            tools().forEach { it.validate() }
             _type().let {
-                if (it != JsonValue.from("additional_tools")) {
+                if (it != JsonValue.from("tool_search_call")) {
                     throw OpenAIInvalidDataException("'type' is invalid, received $it")
                 }
             }
             id()
+            callId()
+            execution().ifPresent { it.validate() }
+            status().ifPresent { it.validate() }
             validated = true
         }
 
@@ -4770,301 +4615,155 @@ private constructor(
          */
         @JvmSynthetic
         internal fun validity(): Int =
-            role.let { if (it == JsonValue.from("developer")) 1 else 0 } +
-                (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
-                type.let { if (it == JsonValue.from("additional_tools")) 1 else 0 } +
-                (if (id.asKnown().isPresent) 1 else 0)
+            type.let { if (it == JsonValue.from("tool_search_call")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (execution.asKnown().getOrNull()?.validity() ?: 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0)
 
-        override fun equals(other: Any?): Boolean {
-            if (this === other) {
-                return true
-            }
+        /** Whether tool search was executed by the server or by the client. */
+        class Execution @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
 
-            return other is AdditionalTools &&
-                role == other.role &&
-                tools == other.tools &&
-                type == other.type &&
-                id == other.id &&
-                additionalProperties == other.additionalProperties
-        }
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
 
-        private val hashCode: Int by lazy {
-            Objects.hash(role, tools, type, id, additionalProperties)
-        }
-
-        override fun hashCode(): Int = hashCode
-
-        override fun toString() =
-            "AdditionalTools{role=$role, tools=$tools, type=$type, id=$id, additionalProperties=$additionalProperties}"
-    }
-
-    /** An image generation request made by the model. */
-    class ImageGenerationCall
-    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-    private constructor(
-        private val id: JsonField<String>,
-        private val result: JsonField<String>,
-        private val status: JsonField<Status>,
-        private val type: JsonValue,
-        private val additionalProperties: MutableMap<String, JsonValue>,
-    ) {
-
-        @JsonCreator
-        private constructor(
-            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("result") @ExcludeMissing result: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
-            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-        ) : this(id, result, status, type, mutableMapOf())
-
-        /**
-         * The unique ID of the image generation call.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun id(): String = id.getRequired("id")
-
-        /**
-         * The generated image encoded in base64.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun result(): Optional<String> = result.getOptional("result")
-
-        /**
-         * The status of the image generation call.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun status(): Status = status.getRequired("status")
-
-        /**
-         * The type of the image generation call. Always `image_generation_call`.
-         *
-         * Expected to always return the following:
-         * ```java
-         * JsonValue.from("image_generation_call")
-         * ```
-         *
-         * However, this method can be useful for debugging and logging (e.g. if the server
-         * responded with an unexpected value).
-         */
-        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
-
-        /**
-         * Returns the raw JSON value of [id].
-         *
-         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
-
-        /**
-         * Returns the raw JSON value of [result].
-         *
-         * Unlike [result], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("result") @ExcludeMissing fun _result(): JsonField<String> = result
-
-        /**
-         * Returns the raw JSON value of [status].
-         *
-         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+            companion object {
 
-        @JsonAnySetter
-        private fun putAdditionalProperty(key: String, value: JsonValue) {
-            additionalProperties.put(key, value)
-        }
+                @JvmField val SERVER = of("server")
 
-        @JsonAnyGetter
-        @ExcludeMissing
-        fun _additionalProperties(): Map<String, JsonValue> =
-            Collections.unmodifiableMap(additionalProperties)
+                @JvmField val CLIENT = of("client")
 
-        fun toBuilder() = Builder().from(this)
+                @JvmStatic fun of(value: String) = Execution(JsonField.of(value))
+            }
 
-        companion object {
+            /** An enum containing [Execution]'s known values. */
+            enum class Known {
+                SERVER,
+                CLIENT,
+            }
 
             /**
-             * Returns a mutable builder for constructing an instance of [ImageGenerationCall].
+             * An enum containing [Execution]'s known values, as well as an [_UNKNOWN] member.
              *
-             * The following fields are required:
-             * ```java
-             * .id()
-             * .result()
-             * .status()
-             * ```
+             * An instance of [Execution] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
              */
-            @JvmStatic fun builder() = Builder()
-        }
-
-        /** A builder for [ImageGenerationCall]. */
-        class Builder internal constructor() {
-
-            private var id: JsonField<String>? = null
-            private var result: JsonField<String>? = null
-            private var status: JsonField<Status>? = null
-            private var type: JsonValue = JsonValue.from("image_generation_call")
-            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-            @JvmSynthetic
-            internal fun from(imageGenerationCall: ImageGenerationCall) = apply {
-                id = imageGenerationCall.id
-                result = imageGenerationCall.result
-                status = imageGenerationCall.status
-                type = imageGenerationCall.type
-                additionalProperties = imageGenerationCall.additionalProperties.toMutableMap()
+            enum class Value {
+                SERVER,
+                CLIENT,
+                /**
+                 * An enum member indicating that [Execution] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
             }
 
-            /** The unique ID of the image generation call. */
-            fun id(id: String) = id(JsonField.of(id))
-
             /**
-             * Sets [Builder.id] to an arbitrary JSON value.
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
              *
-             * You should usually call [Builder.id] with a well-typed [String] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
              */
-            fun id(id: JsonField<String>) = apply { this.id = id }
-
-            /** The generated image encoded in base64. */
-            fun result(result: String?) = result(JsonField.ofNullable(result))
-
-            /** Alias for calling [Builder.result] with `result.orElse(null)`. */
-            fun result(result: Optional<String>) = result(result.getOrNull())
+            fun value(): Value =
+                when (this) {
+                    SERVER -> Value.SERVER
+                    CLIENT -> Value.CLIENT
+                    else -> Value._UNKNOWN
+                }
 
             /**
-             * Sets [Builder.result] to an arbitrary JSON value.
+             * Returns an enum member corresponding to this class instance's value.
              *
-             * You should usually call [Builder.result] with a well-typed [String] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
              */
-            fun result(result: JsonField<String>) = apply { this.result = result }
-
-            /** The status of the image generation call. */
-            fun status(status: Status) = status(JsonField.of(status))
+            fun known(): Known =
+                when (this) {
+                    SERVER -> Known.SERVER
+                    CLIENT -> Known.CLIENT
+                    else -> throw OpenAIInvalidDataException("Unknown Execution: $value")
+                }
 
             /**
-             * Sets [Builder.status] to an arbitrary JSON value.
+             * Returns this class instance's primitive wire representation.
              *
-             * You should usually call [Builder.status] with a well-typed [Status] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
              */
-            fun status(status: JsonField<Status>) = apply { this.status = status }
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
 
             /**
-             * Sets the field to an arbitrary JSON value.
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
              *
-             * It is usually unnecessary to call this method because the field defaults to the
-             * following:
-             * ```java
-             * JsonValue.from("image_generation_call")
-             * ```
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
              *
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
              */
-            fun type(type: JsonValue) = apply { this.type = type }
-
-            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                this.additionalProperties.clear()
-                putAllAdditionalProperties(additionalProperties)
-            }
-
-            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                additionalProperties.put(key, value)
-            }
+            fun validate(): Execution = apply {
+                if (validated) {
+                    return@apply
+                }
 
-            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                this.additionalProperties.putAll(additionalProperties)
+                known()
+                validated = true
             }
 
-            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
-
-            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                keys.forEach(::removeAdditionalProperty)
-            }
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
 
             /**
-             * Returns an immutable instance of [ImageGenerationCall].
-             *
-             * Further updates to this [Builder] will not mutate the returned instance.
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
              *
-             * The following fields are required:
-             * ```java
-             * .id()
-             * .result()
-             * .status()
-             * ```
-             *
-             * @throws IllegalStateException if any required field is unset.
+             * Used for best match union deserialization.
              */
-            fun build(): ImageGenerationCall =
-                ImageGenerationCall(
-                    checkRequired("id", id),
-                    checkRequired("result", result),
-                    checkRequired("status", status),
-                    type,
-                    additionalProperties.toMutableMap(),
-                )
-        }
-
-        private var validated: Boolean = false
-
-        /**
-         * Validates that the types of all values in this object match their expected types
-         * recursively.
-         *
-         * This method is _not_ forwards compatible with new types from the API for existing fields.
-         *
-         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-         *   expected type.
-         */
-        fun validate(): ImageGenerationCall = apply {
-            if (validated) {
-                return@apply
-            }
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
 
-            id()
-            result()
-            status().validate()
-            _type().let {
-                if (it != JsonValue.from("image_generation_call")) {
-                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
                 }
-            }
-            validated = true
-        }
 
-        fun isValid(): Boolean =
-            try {
-                validate()
-                true
-            } catch (e: OpenAIInvalidDataException) {
-                false
+                return other is Execution && value == other.value
             }
 
-        /**
-         * Returns a score indicating how many valid values are contained in this object
-         * recursively.
-         *
-         * Used for best match union deserialization.
-         */
-        @JvmSynthetic
-        internal fun validity(): Int =
-            (if (id.asKnown().isPresent) 1 else 0) +
-                (if (result.asKnown().isPresent) 1 else 0) +
-                (status.asKnown().getOrNull()?.validity() ?: 0) +
-                type.let { if (it == JsonValue.from("image_generation_call")) 1 else 0 }
+            override fun hashCode() = value.hashCode()
 
-        /** The status of the image generation call. */
+            override fun toString() = value.toString()
+        }
+
+        /** The status of the tool search call. */
         class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
             /**
@@ -5083,9 +4782,7 @@ private constructor(
 
                 @JvmField val COMPLETED = of("completed")
 
-                @JvmField val GENERATING = of("generating")
-
-                @JvmField val FAILED = of("failed")
+                @JvmField val INCOMPLETE = of("incomplete")
 
                 @JvmStatic fun of(value: String) = Status(JsonField.of(value))
             }
@@ -5094,8 +4791,7 @@ private constructor(
             enum class Known {
                 IN_PROGRESS,
                 COMPLETED,
-                GENERATING,
-                FAILED,
+                INCOMPLETE,
             }
 
             /**
@@ -5110,8 +4806,7 @@ private constructor(
             enum class Value {
                 IN_PROGRESS,
                 COMPLETED,
-                GENERATING,
-                FAILED,
+                INCOMPLETE,
                 /**
                  * An enum member indicating that [Status] was instantiated with an unknown value.
                  */
@@ -5129,8 +4824,7 @@ private constructor(
                 when (this) {
                     IN_PROGRESS -> Value.IN_PROGRESS
                     COMPLETED -> Value.COMPLETED
-                    GENERATING -> Value.GENERATING
-                    FAILED -> Value.FAILED
+                    INCOMPLETE -> Value.INCOMPLETE
                     else -> Value._UNKNOWN
                 }
 
@@ -5147,8 +4841,7 @@ private constructor(
                 when (this) {
                     IN_PROGRESS -> Known.IN_PROGRESS
                     COMPLETED -> Known.COMPLETED
-                    GENERATING -> Known.GENERATING
-                    FAILED -> Known.FAILED
+                    INCOMPLETE -> Known.INCOMPLETE
                     else -> throw OpenAIInvalidDataException("Unknown Status: $value")
                 }
 
@@ -5221,83 +4914,71 @@ private constructor(
                 return true
             }
 
-            return other is ImageGenerationCall &&
+            return other is ToolSearchCall &&
+                arguments == other.arguments &&
+                type == other.type &&
                 id == other.id &&
-                result == other.result &&
+                callId == other.callId &&
+                execution == other.execution &&
                 status == other.status &&
-                type == other.type &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(id, result, status, type, additionalProperties)
+            Objects.hash(arguments, type, id, callId, execution, status, additionalProperties)
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "ImageGenerationCall{id=$id, result=$result, status=$status, type=$type, additionalProperties=$additionalProperties}"
+            "ToolSearchCall{arguments=$arguments, type=$type, id=$id, callId=$callId, execution=$execution, status=$status, additionalProperties=$additionalProperties}"
     }
 
-    /** A tool call to run a command on the local shell. */
-    class LocalShellCall
+    class AdditionalTools
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
-        private val id: JsonField<String>,
-        private val action: JsonField<Action>,
-        private val callId: JsonField<String>,
-        private val status: JsonField<Status>,
+        private val role: JsonValue,
+        private val tools: JsonField<List<Tool>>,
         private val type: JsonValue,
+        private val id: JsonField<String>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
         @JsonCreator
         private constructor(
-            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
-            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("role") @ExcludeMissing role: JsonValue = JsonMissing.of(),
+            @JsonProperty("tools") @ExcludeMissing tools: JsonField<List<Tool>> = JsonMissing.of(),
             @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-        ) : this(id, action, callId, status, type, mutableMapOf())
-
-        /**
-         * The unique ID of the local shell call.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun id(): String = id.getRequired("id")
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        ) : this(role, tools, type, id, mutableMapOf())
 
         /**
-         * Execute a shell command on the server.
+         * The role that provided the additional tools. Only `developer` is supported.
          *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun action(): Action = action.getRequired("action")
-
-        /**
-         * The unique ID of the local shell tool call generated by the model.
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("developer")
+         * ```
          *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
          */
-        fun callId(): String = callId.getRequired("call_id")
+        @JsonProperty("role") @ExcludeMissing fun _role(): JsonValue = role
 
         /**
-         * The status of the local shell call.
+         * A list of additional tools made available at this item.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun status(): Status = status.getRequired("status")
+        fun tools(): List<Tool> = tools.getRequired("tools")
 
         /**
-         * The type of the local shell call. Always `local_shell_call`.
+         * The item type. Always `additional_tools`.
          *
          * Expected to always return the following:
          * ```java
-         * JsonValue.from("local_shell_call")
+         * JsonValue.from("additional_tools")
          * ```
          *
          * However, this method can be useful for debugging and logging (e.g. if the server
@@ -5306,32 +4987,26 @@ private constructor(
         @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
         /**
-         * Returns the raw JSON value of [id].
-         *
-         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
-
-        /**
-         * Returns the raw JSON value of [action].
+         * The unique ID of this additional tools item.
          *
-         * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
          */
-        @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+        fun id(): Optional<String> = id.getOptional("id")
 
         /**
-         * Returns the raw JSON value of [callId].
+         * Returns the raw JSON value of [tools].
          *
-         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+        @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<Tool>> = tools
 
         /**
-         * Returns the raw JSON value of [status].
+         * Returns the raw JSON value of [id].
          *
-         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
@@ -5348,86 +5023,188 @@ private constructor(
         companion object {
 
             /**
-             * Returns a mutable builder for constructing an instance of [LocalShellCall].
+             * Returns a mutable builder for constructing an instance of [AdditionalTools].
              *
              * The following fields are required:
              * ```java
-             * .id()
-             * .action()
-             * .callId()
-             * .status()
+             * .tools()
              * ```
              */
             @JvmStatic fun builder() = Builder()
         }
 
-        /** A builder for [LocalShellCall]. */
+        /** A builder for [AdditionalTools]. */
         class Builder internal constructor() {
 
-            private var id: JsonField<String>? = null
-            private var action: JsonField<Action>? = null
-            private var callId: JsonField<String>? = null
-            private var status: JsonField<Status>? = null
-            private var type: JsonValue = JsonValue.from("local_shell_call")
+            private var role: JsonValue = JsonValue.from("developer")
+            private var tools: JsonField<MutableList<Tool>>? = null
+            private var type: JsonValue = JsonValue.from("additional_tools")
+            private var id: JsonField<String> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
-            internal fun from(localShellCall: LocalShellCall) = apply {
-                id = localShellCall.id
-                action = localShellCall.action
-                callId = localShellCall.callId
-                status = localShellCall.status
-                type = localShellCall.type
-                additionalProperties = localShellCall.additionalProperties.toMutableMap()
+            internal fun from(additionalTools: AdditionalTools) = apply {
+                role = additionalTools.role
+                tools = additionalTools.tools.map { it.toMutableList() }
+                type = additionalTools.type
+                id = additionalTools.id
+                additionalProperties = additionalTools.additionalProperties.toMutableMap()
             }
 
-            /** The unique ID of the local shell call. */
-            fun id(id: String) = id(JsonField.of(id))
-
             /**
-             * Sets [Builder.id] to an arbitrary JSON value.
+             * Sets the field to an arbitrary JSON value.
              *
-             * You should usually call [Builder.id] with a well-typed [String] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
-             */
-            fun id(id: JsonField<String>) = apply { this.id = id }
-
-            /** Execute a shell command on the server. */
-            fun action(action: Action) = action(JsonField.of(action))
-
-            /**
-             * Sets [Builder.action] to an arbitrary JSON value.
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("developer")
+             * ```
              *
-             * You should usually call [Builder.action] with a well-typed [Action] value instead.
              * This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun action(action: JsonField<Action>) = apply { this.action = action }
+            fun role(role: JsonValue) = apply { this.role = role }
 
-            /** The unique ID of the local shell tool call generated by the model. */
-            fun callId(callId: String) = callId(JsonField.of(callId))
+            /** A list of additional tools made available at this item. */
+            fun tools(tools: List<Tool>) = tools(JsonField.of(tools))
 
             /**
-             * Sets [Builder.callId] to an arbitrary JSON value.
+             * Sets [Builder.tools] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * You should usually call [Builder.tools] with a well-typed `List<Tool>` value instead.
              * This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
-
-            /** The status of the local shell call. */
-            fun status(status: Status) = status(JsonField.of(status))
+            fun tools(tools: JsonField<List<Tool>>) = apply {
+                this.tools = tools.map { it.toMutableList() }
+            }
 
             /**
-             * Sets [Builder.status] to an arbitrary JSON value.
+             * Adds a single [Tool] to [tools].
              *
-             * You should usually call [Builder.status] with a well-typed [Status] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
+             * @throws IllegalStateException if the field was previously set to a non-list.
              */
-            fun status(status: JsonField<Status>) = apply { this.status = status }
+            fun addTool(tool: Tool) = apply {
+                tools =
+                    (tools ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("tools", it).add(tool)
+                    }
+            }
+
+            /** Alias for calling [addTool] with `Tool.ofFunction(function)`. */
+            fun addTool(function: FunctionTool) = addTool(Tool.ofFunction(function))
+
+            /** Alias for calling [addTool] with `Tool.ofFileSearch(fileSearch)`. */
+            fun addTool(fileSearch: FileSearchTool) = addTool(Tool.ofFileSearch(fileSearch))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * FileSearchTool.builder()
+             *     .vectorStoreIds(vectorStoreIds)
+             *     .build()
+             * ```
+             */
+            fun addFileSearchTool(vectorStoreIds: List<String>) =
+                addTool(FileSearchTool.builder().vectorStoreIds(vectorStoreIds).build())
+
+            /** Alias for calling [addTool] with `Tool.ofComputer(computer)`. */
+            fun addTool(computer: ComputerTool) = addTool(Tool.ofComputer(computer))
+
+            /** Alias for calling [addTool] with `Tool.ofComputerUsePreview(computerUsePreview)`. */
+            fun addTool(computerUsePreview: ComputerUsePreviewTool) =
+                addTool(Tool.ofComputerUsePreview(computerUsePreview))
+
+            /** Alias for calling [addTool] with `Tool.ofWebSearch(webSearch)`. */
+            fun addTool(webSearch: WebSearchTool) = addTool(Tool.ofWebSearch(webSearch))
+
+            /** Alias for calling [addTool] with `Tool.ofMcp(mcp)`. */
+            fun addTool(mcp: Tool.Mcp) = addTool(Tool.ofMcp(mcp))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * Tool.Mcp.builder()
+             *     .serverLabel(serverLabel)
+             *     .build()
+             * ```
+             */
+            fun addMcpTool(serverLabel: String) =
+                addTool(Tool.Mcp.builder().serverLabel(serverLabel).build())
+
+            /** Alias for calling [addTool] with `Tool.ofCodeInterpreter(codeInterpreter)`. */
+            fun addTool(codeInterpreter: Tool.CodeInterpreter) =
+                addTool(Tool.ofCodeInterpreter(codeInterpreter))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * Tool.CodeInterpreter.builder()
+             *     .container(container)
+             *     .build()
+             * ```
+             */
+            fun addCodeInterpreterTool(container: Tool.CodeInterpreter.Container) =
+                addTool(Tool.CodeInterpreter.builder().container(container).build())
+
+            /**
+             * Alias for calling [addCodeInterpreterTool] with
+             * `Tool.CodeInterpreter.Container.ofString(string)`.
+             */
+            fun addCodeInterpreterTool(string: String) =
+                addCodeInterpreterTool(Tool.CodeInterpreter.Container.ofString(string))
+
+            /**
+             * Alias for calling [addCodeInterpreterTool] with
+             * `Tool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)`.
+             */
+            fun addCodeInterpreterTool(
+                codeInterpreterToolAuto: Tool.CodeInterpreter.Container.CodeInterpreterToolAuto
+            ) =
+                addCodeInterpreterTool(
+                    Tool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(
+                        codeInterpreterToolAuto
+                    )
+                )
+
+            /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+            fun addToolProgrammaticToolCalling() = addTool(Tool.ofProgrammaticToolCalling())
+
+            /** Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`. */
+            fun addTool(imageGeneration: Tool.ImageGeneration) =
+                addTool(Tool.ofImageGeneration(imageGeneration))
+
+            /** Alias for calling [addTool] with `Tool.ofLocalShell()`. */
+            fun addToolLocalShell() = addTool(Tool.ofLocalShell())
+
+            /** Alias for calling [addTool] with `Tool.ofShell(shell)`. */
+            fun addTool(shell: FunctionShellTool) = addTool(Tool.ofShell(shell))
+
+            /** Alias for calling [addTool] with `Tool.ofCustom(custom)`. */
+            fun addTool(custom: CustomTool) = addTool(Tool.ofCustom(custom))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * CustomTool.builder()
+             *     .name(name)
+             *     .build()
+             * ```
+             */
+            fun addCustomTool(name: String) = addTool(CustomTool.builder().name(name).build())
+
+            /** Alias for calling [addTool] with `Tool.ofNamespace(namespace)`. */
+            fun addTool(namespace: NamespaceTool) = addTool(Tool.ofNamespace(namespace))
+
+            /** Alias for calling [addTool] with `Tool.ofSearch(search)`. */
+            fun addTool(search: ToolSearchTool) = addTool(Tool.ofSearch(search))
+
+            /** Alias for calling [addTool] with `Tool.ofWebSearchPreview(webSearchPreview)`. */
+            fun addTool(webSearchPreview: WebSearchPreviewTool) =
+                addTool(Tool.ofWebSearchPreview(webSearchPreview))
+
+            /** Alias for calling [addTool] with `Tool.ofApplyPatch(applyPatch)`. */
+            fun addTool(applyPatch: ApplyPatchTool) = addTool(Tool.ofApplyPatch(applyPatch))
 
             /**
              * Sets the field to an arbitrary JSON value.
@@ -5435,7 +5212,7 @@ private constructor(
              * It is usually unnecessary to call this method because the field defaults to the
              * following:
              * ```java
-             * JsonValue.from("local_shell_call")
+             * JsonValue.from("additional_tools")
              * ```
              *
              * This method is primarily for setting the field to an undocumented or not yet
@@ -5443,6 +5220,21 @@ private constructor(
              */
             fun type(type: JsonValue) = apply { this.type = type }
 
+            /** The unique ID of this additional tools item. */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
                 putAllAdditionalProperties(additionalProperties)
@@ -5463,27 +5255,23 @@ private constructor(
             }
 
             /**
-             * Returns an immutable instance of [LocalShellCall].
+             * Returns an immutable instance of [AdditionalTools].
              *
              * Further updates to this [Builder] will not mutate the returned instance.
              *
              * The following fields are required:
              * ```java
-             * .id()
-             * .action()
-             * .callId()
-             * .status()
+             * .tools()
              * ```
              *
              * @throws IllegalStateException if any required field is unset.
              */
-            fun build(): LocalShellCall =
-                LocalShellCall(
-                    checkRequired("id", id),
-                    checkRequired("action", action),
-                    checkRequired("callId", callId),
-                    checkRequired("status", status),
+            fun build(): AdditionalTools =
+                AdditionalTools(
+                    role,
+                    checkRequired("tools", tools).map { it.toImmutable() },
                     type,
+                    id,
                     additionalProperties.toMutableMap(),
                 )
         }
@@ -5499,20 +5287,23 @@ private constructor(
          * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
          *   expected type.
          */
-        fun validate(): LocalShellCall = apply {
+        fun validate(): AdditionalTools = apply {
             if (validated) {
                 return@apply
             }
 
-            id()
-            action().validate()
-            callId()
-            status().validate()
+            _role().let {
+                if (it != JsonValue.from("developer")) {
+                    throw OpenAIInvalidDataException("'role' is invalid, received $it")
+                }
+            }
+            tools().forEach { it.validate() }
             _type().let {
-                if (it != JsonValue.from("local_shell_call")) {
+                if (it != JsonValue.from("additional_tools")) {
                     throw OpenAIInvalidDataException("'type' is invalid, received $it")
                 }
             }
+            id()
             validated = true
         }
 
@@ -5532,373 +5323,420 @@ private constructor(
          */
         @JvmSynthetic
         internal fun validity(): Int =
-            (if (id.asKnown().isPresent) 1 else 0) +
-                (action.asKnown().getOrNull()?.validity() ?: 0) +
-                (if (callId.asKnown().isPresent) 1 else 0) +
-                (status.asKnown().getOrNull()?.validity() ?: 0) +
-                type.let { if (it == JsonValue.from("local_shell_call")) 1 else 0 }
+            role.let { if (it == JsonValue.from("developer")) 1 else 0 } +
+                (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                type.let { if (it == JsonValue.from("additional_tools")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0)
 
-        /** Execute a shell command on the server. */
-        class Action
-        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-        private constructor(
-            private val command: JsonField<List<String>>,
-            private val env: JsonField<Env>,
-            private val type: JsonValue,
-            private val timeoutMs: JsonField<Long>,
-            private val user: JsonField<String>,
-            private val workingDirectory: JsonField<String>,
-            private val additionalProperties: MutableMap<String, JsonValue>,
-        ) {
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
 
-            @JsonCreator
-            private constructor(
-                @JsonProperty("command")
-                @ExcludeMissing
-                command: JsonField<List<String>> = JsonMissing.of(),
-                @JsonProperty("env") @ExcludeMissing env: JsonField<Env> = JsonMissing.of(),
-                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-                @JsonProperty("timeout_ms")
-                @ExcludeMissing
-                timeoutMs: JsonField<Long> = JsonMissing.of(),
-                @JsonProperty("user") @ExcludeMissing user: JsonField<String> = JsonMissing.of(),
-                @JsonProperty("working_directory")
-                @ExcludeMissing
-                workingDirectory: JsonField<String> = JsonMissing.of(),
-            ) : this(command, env, type, timeoutMs, user, workingDirectory, mutableMapOf())
+            return other is AdditionalTools &&
+                role == other.role &&
+                tools == other.tools &&
+                type == other.type &&
+                id == other.id &&
+                additionalProperties == other.additionalProperties
+        }
 
-            /**
-             * The command to run.
-             *
-             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
-             *   value).
-             */
-            fun command(): List<String> = command.getRequired("command")
+        private val hashCode: Int by lazy {
+            Objects.hash(role, tools, type, id, additionalProperties)
+        }
 
-            /**
-             * Environment variables to set for the command.
-             *
-             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
-             *   value).
-             */
-            fun env(): Env = env.getRequired("env")
+        override fun hashCode(): Int = hashCode
 
-            /**
-             * The type of the local shell action. Always `exec`.
-             *
-             * Expected to always return the following:
-             * ```java
-             * JsonValue.from("exec")
-             * ```
-             *
-             * However, this method can be useful for debugging and logging (e.g. if the server
-             * responded with an unexpected value).
-             */
-            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+        override fun toString() =
+            "AdditionalTools{role=$role, tools=$tools, type=$type, id=$id, additionalProperties=$additionalProperties}"
+    }
 
-            /**
-             * Optional timeout in milliseconds for the command.
-             *
-             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
-             *   the server responded with an unexpected value).
-             */
-            fun timeoutMs(): Optional<Long> = timeoutMs.getOptional("timeout_ms")
+    /** An image generation request made by the model. */
+    class ImageGenerationCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val result: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
 
-            /**
-             * Optional user to run the command as.
-             *
-             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
-             *   the server responded with an unexpected value).
-             */
-            fun user(): Optional<String> = user.getOptional("user")
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("result") @ExcludeMissing result: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(id, result, status, type, mutableMapOf())
 
-            /**
-             * Optional working directory to run the command in.
-             *
-             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
-             *   the server responded with an unexpected value).
-             */
-            fun workingDirectory(): Optional<String> =
-                workingDirectory.getOptional("working_directory")
+        /**
+         * The unique ID of the image generation call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The generated image encoded in base64.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun result(): Optional<String> = result.getOptional("result")
+
+        /**
+         * The status of the image generation call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The type of the image generation call. Always `image_generation_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("image_generation_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [result].
+         *
+         * Unlike [result], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("result") @ExcludeMissing fun _result(): JsonField<String> = result
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
 
             /**
-             * Returns the raw JSON value of [command].
+             * Returns a mutable builder for constructing an instance of [ImageGenerationCall].
              *
-             * Unlike [command], this method doesn't throw if the JSON field has an unexpected type.
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .result()
+             * .status()
+             * ```
              */
-            @JsonProperty("command")
-            @ExcludeMissing
-            fun _command(): JsonField<List<String>> = command
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ImageGenerationCall]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var result: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("image_generation_call")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(imageGenerationCall: ImageGenerationCall) = apply {
+                id = imageGenerationCall.id
+                result = imageGenerationCall.result
+                status = imageGenerationCall.status
+                type = imageGenerationCall.type
+                additionalProperties = imageGenerationCall.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the image generation call. */
+            fun id(id: String) = id(JsonField.of(id))
 
             /**
-             * Returns the raw JSON value of [env].
+             * Sets [Builder.id] to an arbitrary JSON value.
              *
-             * Unlike [env], this method doesn't throw if the JSON field has an unexpected type.
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
              */
-            @JsonProperty("env") @ExcludeMissing fun _env(): JsonField<Env> = env
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The generated image encoded in base64. */
+            fun result(result: String?) = result(JsonField.ofNullable(result))
+
+            /** Alias for calling [Builder.result] with `result.orElse(null)`. */
+            fun result(result: Optional<String>) = result(result.getOrNull())
 
             /**
-             * Returns the raw JSON value of [timeoutMs].
+             * Sets [Builder.result] to an arbitrary JSON value.
              *
-             * Unlike [timeoutMs], this method doesn't throw if the JSON field has an unexpected
-             * type.
+             * You should usually call [Builder.result] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            @JsonProperty("timeout_ms")
-            @ExcludeMissing
-            fun _timeoutMs(): JsonField<Long> = timeoutMs
+            fun result(result: JsonField<String>) = apply { this.result = result }
+
+            /** The status of the image generation call. */
+            fun status(status: Status) = status(JsonField.of(status))
 
             /**
-             * Returns the raw JSON value of [user].
+             * Sets [Builder.status] to an arbitrary JSON value.
              *
-             * Unlike [user], this method doesn't throw if the JSON field has an unexpected type.
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            @JsonProperty("user") @ExcludeMissing fun _user(): JsonField<String> = user
+            fun status(status: JsonField<Status>) = apply { this.status = status }
 
             /**
-             * Returns the raw JSON value of [workingDirectory].
+             * Sets the field to an arbitrary JSON value.
              *
-             * Unlike [workingDirectory], this method doesn't throw if the JSON field has an
-             * unexpected type.
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("image_generation_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            @JsonProperty("working_directory")
-            @ExcludeMissing
-            fun _workingDirectory(): JsonField<String> = workingDirectory
+            fun type(type: JsonValue) = apply { this.type = type }
 
-            @JsonAnySetter
-            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                additionalProperties.put(key, value)
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
             }
 
-            @JsonAnyGetter
-            @ExcludeMissing
-            fun _additionalProperties(): Map<String, JsonValue> =
-                Collections.unmodifiableMap(additionalProperties)
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
 
-            fun toBuilder() = Builder().from(this)
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
 
-            companion object {
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
 
-                /**
-                 * Returns a mutable builder for constructing an instance of [Action].
-                 *
-                 * The following fields are required:
-                 * ```java
-                 * .command()
-                 * .env()
-                 * ```
-                 */
-                @JvmStatic fun builder() = Builder()
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
             }
 
-            /** A builder for [Action]. */
-            class Builder internal constructor() {
+            /**
+             * Returns an immutable instance of [ImageGenerationCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .result()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ImageGenerationCall =
+                ImageGenerationCall(
+                    checkRequired("id", id),
+                    checkRequired("result", result),
+                    checkRequired("status", status),
+                    type,
+                    additionalProperties.toMutableMap(),
+                )
+        }
 
-                private var command: JsonField<MutableList<String>>? = null
-                private var env: JsonField<Env>? = null
-                private var type: JsonValue = JsonValue.from("exec")
-                private var timeoutMs: JsonField<Long> = JsonMissing.of()
-                private var user: JsonField<String> = JsonMissing.of()
-                private var workingDirectory: JsonField<String> = JsonMissing.of()
-                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-                @JvmSynthetic
-                internal fun from(action: Action) = apply {
-                    command = action.command.map { it.toMutableList() }
-                    env = action.env
-                    type = action.type
-                    timeoutMs = action.timeoutMs
-                    user = action.user
-                    workingDirectory = action.workingDirectory
-                    additionalProperties = action.additionalProperties.toMutableMap()
-                }
-
-                /** The command to run. */
-                fun command(command: List<String>) = command(JsonField.of(command))
+        private var validated: Boolean = false
 
-                /**
-                 * Sets [Builder.command] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.command] with a well-typed `List<String>` value
-                 * instead. This method is primarily for setting the field to an undocumented or not
-                 * yet supported value.
-                 */
-                fun command(command: JsonField<List<String>>) = apply {
-                    this.command = command.map { it.toMutableList() }
-                }
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ImageGenerationCall = apply {
+            if (validated) {
+                return@apply
+            }
 
-                /**
-                 * Adds a single [String] to [Builder.command].
-                 *
-                 * @throws IllegalStateException if the field was previously set to a non-list.
-                 */
-                fun addCommand(command: String) = apply {
-                    this.command =
-                        (this.command ?: JsonField.of(mutableListOf())).also {
-                            checkKnown("command", it).add(command)
-                        }
+            id()
+            result()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("image_generation_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
                 }
+            }
+            validated = true
+        }
 
-                /** Environment variables to set for the command. */
-                fun env(env: Env) = env(JsonField.of(env))
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
 
-                /**
-                 * Sets [Builder.env] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.env] with a well-typed [Env] value instead. This
-                 * method is primarily for setting the field to an undocumented or not yet supported
-                 * value.
-                 */
-                fun env(env: JsonField<Env>) = apply { this.env = env }
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (result.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("image_generation_call")) 1 else 0 }
 
-                /**
-                 * Sets the field to an arbitrary JSON value.
-                 *
-                 * It is usually unnecessary to call this method because the field defaults to the
-                 * following:
-                 * ```java
-                 * JsonValue.from("exec")
-                 * ```
-                 *
-                 * This method is primarily for setting the field to an undocumented or not yet
-                 * supported value.
-                 */
-                fun type(type: JsonValue) = apply { this.type = type }
+        /** The status of the image generation call. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
-                /** Optional timeout in milliseconds for the command. */
-                fun timeoutMs(timeoutMs: Long?) = timeoutMs(JsonField.ofNullable(timeoutMs))
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
 
-                /**
-                 * Alias for [Builder.timeoutMs].
-                 *
-                 * This unboxed primitive overload exists for backwards compatibility.
-                 */
-                fun timeoutMs(timeoutMs: Long) = timeoutMs(timeoutMs as Long?)
+            companion object {
 
-                /** Alias for calling [Builder.timeoutMs] with `timeoutMs.orElse(null)`. */
-                fun timeoutMs(timeoutMs: Optional<Long>) = timeoutMs(timeoutMs.getOrNull())
+                @JvmField val IN_PROGRESS = of("in_progress")
 
-                /**
-                 * Sets [Builder.timeoutMs] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.timeoutMs] with a well-typed [Long] value
-                 * instead. This method is primarily for setting the field to an undocumented or not
-                 * yet supported value.
-                 */
-                fun timeoutMs(timeoutMs: JsonField<Long>) = apply { this.timeoutMs = timeoutMs }
+                @JvmField val COMPLETED = of("completed")
 
-                /** Optional user to run the command as. */
-                fun user(user: String?) = user(JsonField.ofNullable(user))
+                @JvmField val GENERATING = of("generating")
 
-                /** Alias for calling [Builder.user] with `user.orElse(null)`. */
-                fun user(user: Optional<String>) = user(user.getOrNull())
+                @JvmField val FAILED = of("failed")
 
-                /**
-                 * Sets [Builder.user] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.user] with a well-typed [String] value instead.
-                 * This method is primarily for setting the field to an undocumented or not yet
-                 * supported value.
-                 */
-                fun user(user: JsonField<String>) = apply { this.user = user }
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
 
-                /** Optional working directory to run the command in. */
-                fun workingDirectory(workingDirectory: String?) =
-                    workingDirectory(JsonField.ofNullable(workingDirectory))
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                GENERATING,
+                FAILED,
+            }
 
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                GENERATING,
+                FAILED,
                 /**
-                 * Alias for calling [Builder.workingDirectory] with
-                 * `workingDirectory.orElse(null)`.
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
                  */
-                fun workingDirectory(workingDirectory: Optional<String>) =
-                    workingDirectory(workingDirectory.getOrNull())
+                _UNKNOWN,
+            }
 
-                /**
-                 * Sets [Builder.workingDirectory] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.workingDirectory] with a well-typed [String]
-                 * value instead. This method is primarily for setting the field to an undocumented
-                 * or not yet supported value.
-                 */
-                fun workingDirectory(workingDirectory: JsonField<String>) = apply {
-                    this.workingDirectory = workingDirectory
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    GENERATING -> Value.GENERATING
+                    FAILED -> Value.FAILED
+                    else -> Value._UNKNOWN
                 }
 
-                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                    this.additionalProperties.clear()
-                    putAllAdditionalProperties(additionalProperties)
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    GENERATING -> Known.GENERATING
+                    FAILED -> Known.FAILED
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
                 }
 
-                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                    additionalProperties.put(key, value)
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
                 }
 
-                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
-                    apply {
-                        this.additionalProperties.putAll(additionalProperties)
-                    }
+            private var validated: Boolean = false
 
-                fun removeAdditionalProperty(key: String) = apply {
-                    additionalProperties.remove(key)
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
                 }
 
-                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                    keys.forEach(::removeAdditionalProperty)
-                }
-
-                /**
-                 * Returns an immutable instance of [Action].
-                 *
-                 * Further updates to this [Builder] will not mutate the returned instance.
-                 *
-                 * The following fields are required:
-                 * ```java
-                 * .command()
-                 * .env()
-                 * ```
-                 *
-                 * @throws IllegalStateException if any required field is unset.
-                 */
-                fun build(): Action =
-                    Action(
-                        checkRequired("command", command).map { it.toImmutable() },
-                        checkRequired("env", env),
-                        type,
-                        timeoutMs,
-                        user,
-                        workingDirectory,
-                        additionalProperties.toMutableMap(),
-                    )
-            }
-
-            private var validated: Boolean = false
-
-            /**
-             * Validates that the types of all values in this object match their expected types
-             * recursively.
-             *
-             * This method is _not_ forwards compatible with new types from the API for existing
-             * fields.
-             *
-             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-             *   expected type.
-             */
-            fun validate(): Action = apply {
-                if (validated) {
-                    return@apply
-                }
-
-                command()
-                env().validate()
-                _type().let {
-                    if (it != JsonValue.from("exec")) {
-                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
-                    }
-                }
-                timeoutMs()
-                user()
-                workingDirectory()
+                known()
                 validated = true
             }
 
@@ -5916,545 +5754,289 @@ private constructor(
              *
              * Used for best match union deserialization.
              */
-            @JvmSynthetic
-            internal fun validity(): Int =
-                (command.asKnown().getOrNull()?.size ?: 0) +
-                    (env.asKnown().getOrNull()?.validity() ?: 0) +
-                    type.let { if (it == JsonValue.from("exec")) 1 else 0 } +
-                    (if (timeoutMs.asKnown().isPresent) 1 else 0) +
-                    (if (user.asKnown().isPresent) 1 else 0) +
-                    (if (workingDirectory.asKnown().isPresent) 1 else 0)
-
-            /** Environment variables to set for the command. */
-            class Env
-            @JsonCreator
-            private constructor(
-                @com.fasterxml.jackson.annotation.JsonValue
-                private val additionalProperties: Map<String, JsonValue>
-            ) {
-
-                @JsonAnyGetter
-                @ExcludeMissing
-                fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
-
-                fun toBuilder() = Builder().from(this)
-
-                companion object {
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
 
-                    /** Returns a mutable builder for constructing an instance of [Env]. */
-                    @JvmStatic fun builder() = Builder()
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
                 }
 
-                /** A builder for [Env]. */
-                class Builder internal constructor() {
-
-                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+                return other is Status && value == other.value
+            }
 
-                    @JvmSynthetic
-                    internal fun from(env: Env) = apply {
-                        additionalProperties = env.additionalProperties.toMutableMap()
-                    }
+            override fun hashCode() = value.hashCode()
 
-                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                        this.additionalProperties.clear()
-                        putAllAdditionalProperties(additionalProperties)
-                    }
+            override fun toString() = value.toString()
+        }
 
-                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                        additionalProperties.put(key, value)
-                    }
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
 
-                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
-                        apply {
-                            this.additionalProperties.putAll(additionalProperties)
-                        }
+            return other is ImageGenerationCall &&
+                id == other.id &&
+                result == other.result &&
+                status == other.status &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
 
-                    fun removeAdditionalProperty(key: String) = apply {
-                        additionalProperties.remove(key)
-                    }
+        private val hashCode: Int by lazy {
+            Objects.hash(id, result, status, type, additionalProperties)
+        }
 
-                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                        keys.forEach(::removeAdditionalProperty)
-                    }
+        override fun hashCode(): Int = hashCode
 
-                    /**
-                     * Returns an immutable instance of [Env].
-                     *
-                     * Further updates to this [Builder] will not mutate the returned instance.
-                     */
-                    fun build(): Env = Env(additionalProperties.toImmutable())
-                }
+        override fun toString() =
+            "ImageGenerationCall{id=$id, result=$result, status=$status, type=$type, additionalProperties=$additionalProperties}"
+    }
 
-                private var validated: Boolean = false
+    /** A tool call to run a command on the local shell. */
+    class LocalShellCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val action: JsonField<Action>,
+        private val callId: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
 
-                /**
-                 * Validates that the types of all values in this object match their expected types
-                 * recursively.
-                 *
-                 * This method is _not_ forwards compatible with new types from the API for existing
-                 * fields.
-                 *
-                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
-                 *   its expected type.
-                 */
-                fun validate(): Env = apply {
-                    if (validated) {
-                        return@apply
-                    }
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(id, action, callId, status, type, mutableMapOf())
 
-                    validated = true
-                }
+        /**
+         * The unique ID of the local shell call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
 
-                fun isValid(): Boolean =
-                    try {
-                        validate()
-                        true
-                    } catch (e: OpenAIInvalidDataException) {
-                        false
-                    }
+        /**
+         * Execute a shell command on the server.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun action(): Action = action.getRequired("action")
 
-                /**
-                 * Returns a score indicating how many valid values are contained in this object
-                 * recursively.
-                 *
-                 * Used for best match union deserialization.
-                 */
-                @JvmSynthetic
-                internal fun validity(): Int =
-                    additionalProperties.count { (_, value) ->
-                        !value.isNull() && !value.isMissing()
-                    }
+        /**
+         * The unique ID of the local shell tool call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
 
-                override fun equals(other: Any?): Boolean {
-                    if (this === other) {
-                        return true
-                    }
+        /**
+         * The status of the local shell call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
 
-                    return other is Env && additionalProperties == other.additionalProperties
-                }
+        /**
+         * The type of the local shell call. Always `local_shell_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("local_shell_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
-                private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
-                override fun hashCode(): Int = hashCode
+        /**
+         * Returns the raw JSON value of [action].
+         *
+         * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
 
-                override fun toString() = "Env{additionalProperties=$additionalProperties}"
-            }
-
-            override fun equals(other: Any?): Boolean {
-                if (this === other) {
-                    return true
-                }
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
 
-                return other is Action &&
-                    command == other.command &&
-                    env == other.env &&
-                    type == other.type &&
-                    timeoutMs == other.timeoutMs &&
-                    user == other.user &&
-                    workingDirectory == other.workingDirectory &&
-                    additionalProperties == other.additionalProperties
-            }
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
 
-            private val hashCode: Int by lazy {
-                Objects.hash(
-                    command,
-                    env,
-                    type,
-                    timeoutMs,
-                    user,
-                    workingDirectory,
-                    additionalProperties,
-                )
-            }
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
 
-            override fun hashCode(): Int = hashCode
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
 
-            override fun toString() =
-                "Action{command=$command, env=$env, type=$type, timeoutMs=$timeoutMs, user=$user, workingDirectory=$workingDirectory, additionalProperties=$additionalProperties}"
-        }
+        fun toBuilder() = Builder().from(this)
 
-        /** The status of the local shell call. */
-        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+        companion object {
 
             /**
-             * Returns this class instance's raw value.
+             * Returns a mutable builder for constructing an instance of [LocalShellCall].
              *
-             * This is usually only useful if this instance was deserialized from data that doesn't
-             * match any known member, and you want to know that value. For example, if the SDK is
-             * on an older version than the API, then the API may respond with new members that the
-             * SDK is unaware of.
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .action()
+             * .callId()
+             * .status()
+             * ```
              */
-            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
-
-            companion object {
-
-                @JvmField val IN_PROGRESS = of("in_progress")
+            @JvmStatic fun builder() = Builder()
+        }
 
-                @JvmField val COMPLETED = of("completed")
+        /** A builder for [LocalShellCall]. */
+        class Builder internal constructor() {
 
-                @JvmField val INCOMPLETE = of("incomplete")
+            private var id: JsonField<String>? = null
+            private var action: JsonField<Action>? = null
+            private var callId: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("local_shell_call")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
-                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            @JvmSynthetic
+            internal fun from(localShellCall: LocalShellCall) = apply {
+                id = localShellCall.id
+                action = localShellCall.action
+                callId = localShellCall.callId
+                status = localShellCall.status
+                type = localShellCall.type
+                additionalProperties = localShellCall.additionalProperties.toMutableMap()
             }
 
-            /** An enum containing [Status]'s known values. */
-            enum class Known {
-                IN_PROGRESS,
-                COMPLETED,
-                INCOMPLETE,
-            }
+            /** The unique ID of the local shell call. */
+            fun id(id: String) = id(JsonField.of(id))
 
             /**
-             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             * Sets [Builder.id] to an arbitrary JSON value.
              *
-             * An instance of [Status] can contain an unknown value in a couple of cases:
-             * - It was deserialized from data that doesn't match any known member. For example, if
-             *   the SDK is on an older version than the API, then the API may respond with new
-             *   members that the SDK is unaware of.
-             * - It was constructed with an arbitrary value using the [of] method.
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
              */
-            enum class Value {
-                IN_PROGRESS,
-                COMPLETED,
-                INCOMPLETE,
-                /**
-                 * An enum member indicating that [Status] was instantiated with an unknown value.
-                 */
-                _UNKNOWN,
-            }
+            fun id(id: JsonField<String>) = apply { this.id = id }
 
-            /**
-             * Returns an enum member corresponding to this class instance's value, or
-             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
-             *
-             * Use the [known] method instead if you're certain the value is always known or if you
-             * want to throw for the unknown case.
-             */
-            fun value(): Value =
-                when (this) {
-                    IN_PROGRESS -> Value.IN_PROGRESS
-                    COMPLETED -> Value.COMPLETED
-                    INCOMPLETE -> Value.INCOMPLETE
-                    else -> Value._UNKNOWN
-                }
+            /** Execute a shell command on the server. */
+            fun action(action: Action) = action(JsonField.of(action))
 
             /**
-             * Returns an enum member corresponding to this class instance's value.
-             *
-             * Use the [value] method instead if you're uncertain the value is always known and
-             * don't want to throw for the unknown case.
+             * Sets [Builder.action] to an arbitrary JSON value.
              *
-             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
-             *   member.
+             * You should usually call [Builder.action] with a well-typed [Action] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            fun known(): Known =
-                when (this) {
-                    IN_PROGRESS -> Known.IN_PROGRESS
-                    COMPLETED -> Known.COMPLETED
-                    INCOMPLETE -> Known.INCOMPLETE
-                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
-                }
+            fun action(action: JsonField<Action>) = apply { this.action = action }
+
+            /** The unique ID of the local shell tool call generated by the model. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
 
             /**
-             * Returns this class instance's primitive wire representation.
-             *
-             * This differs from the [toString] method because that method is primarily for
-             * debugging and generally doesn't throw.
+             * Sets [Builder.callId] to an arbitrary JSON value.
              *
-             * @throws OpenAIInvalidDataException if this class instance's value does not have the
-             *   expected primitive type.
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            fun asString(): String =
-                _value().asString().orElseThrow {
-                    OpenAIInvalidDataException("Value is not a String")
-                }
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
 
-            private var validated: Boolean = false
+            /** The status of the local shell call. */
+            fun status(status: Status) = status(JsonField.of(status))
 
             /**
-             * Validates that the types of all values in this object match their expected types
-             * recursively.
-             *
-             * This method is _not_ forwards compatible with new types from the API for existing
-             * fields.
+             * Sets [Builder.status] to an arbitrary JSON value.
              *
-             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-             *   expected type.
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            fun validate(): Status = apply {
-                if (validated) {
-                    return@apply
-                }
-
-                known()
-                validated = true
-            }
-
-            fun isValid(): Boolean =
-                try {
-                    validate()
-                    true
-                } catch (e: OpenAIInvalidDataException) {
-                    false
-                }
+            fun status(status: JsonField<Status>) = apply { this.status = status }
 
             /**
-             * Returns a score indicating how many valid values are contained in this object
-             * recursively.
+             * Sets the field to an arbitrary JSON value.
              *
-             * Used for best match union deserialization.
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("local_shell_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
-
-            override fun equals(other: Any?): Boolean {
-                if (this === other) {
-                    return true
-                }
+            fun type(type: JsonValue) = apply { this.type = type }
 
-                return other is Status && value == other.value
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
             }
 
-            override fun hashCode() = value.hashCode()
-
-            override fun toString() = value.toString()
-        }
-
-        override fun equals(other: Any?): Boolean {
-            if (this === other) {
-                return true
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
             }
 
-            return other is LocalShellCall &&
-                id == other.id &&
-                action == other.action &&
-                callId == other.callId &&
-                status == other.status &&
-                type == other.type &&
-                additionalProperties == other.additionalProperties
-        }
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
 
-        private val hashCode: Int by lazy {
-            Objects.hash(id, action, callId, status, type, additionalProperties)
-        }
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
 
-        override fun hashCode(): Int = hashCode
-
-        override fun toString() =
-            "LocalShellCall{id=$id, action=$action, callId=$callId, status=$status, type=$type, additionalProperties=$additionalProperties}"
-    }
-
-    /** The output of a local shell tool call. */
-    class LocalShellCallOutput
-    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-    private constructor(
-        private val id: JsonField<String>,
-        private val output: JsonField<String>,
-        private val type: JsonValue,
-        private val status: JsonField<Status>,
-        private val additionalProperties: MutableMap<String, JsonValue>,
-    ) {
-
-        @JsonCreator
-        private constructor(
-            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("output") @ExcludeMissing output: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
-        ) : this(id, output, type, status, mutableMapOf())
-
-        /**
-         * The unique ID of the local shell tool call generated by the model.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun id(): String = id.getRequired("id")
-
-        /**
-         * A JSON string of the output of the local shell tool call.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun output(): String = output.getRequired("output")
-
-        /**
-         * The type of the local shell tool call output. Always `local_shell_call_output`.
-         *
-         * Expected to always return the following:
-         * ```java
-         * JsonValue.from("local_shell_call_output")
-         * ```
-         *
-         * However, this method can be useful for debugging and logging (e.g. if the server
-         * responded with an unexpected value).
-         */
-        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
-
-        /**
-         * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun status(): Optional<Status> = status.getOptional("status")
-
-        /**
-         * Returns the raw JSON value of [id].
-         *
-         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
-
-        /**
-         * Returns the raw JSON value of [output].
-         *
-         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<String> = output
-
-        /**
-         * Returns the raw JSON value of [status].
-         *
-         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
-
-        @JsonAnySetter
-        private fun putAdditionalProperty(key: String, value: JsonValue) {
-            additionalProperties.put(key, value)
-        }
-
-        @JsonAnyGetter
-        @ExcludeMissing
-        fun _additionalProperties(): Map<String, JsonValue> =
-            Collections.unmodifiableMap(additionalProperties)
-
-        fun toBuilder() = Builder().from(this)
-
-        companion object {
-
-            /**
-             * Returns a mutable builder for constructing an instance of [LocalShellCallOutput].
-             *
-             * The following fields are required:
-             * ```java
-             * .id()
-             * .output()
-             * ```
-             */
-            @JvmStatic fun builder() = Builder()
-        }
-
-        /** A builder for [LocalShellCallOutput]. */
-        class Builder internal constructor() {
-
-            private var id: JsonField<String>? = null
-            private var output: JsonField<String>? = null
-            private var type: JsonValue = JsonValue.from("local_shell_call_output")
-            private var status: JsonField<Status> = JsonMissing.of()
-            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-            @JvmSynthetic
-            internal fun from(localShellCallOutput: LocalShellCallOutput) = apply {
-                id = localShellCallOutput.id
-                output = localShellCallOutput.output
-                type = localShellCallOutput.type
-                status = localShellCallOutput.status
-                additionalProperties = localShellCallOutput.additionalProperties.toMutableMap()
-            }
-
-            /** The unique ID of the local shell tool call generated by the model. */
-            fun id(id: String) = id(JsonField.of(id))
-
-            /**
-             * Sets [Builder.id] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.id] with a well-typed [String] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
-             */
-            fun id(id: JsonField<String>) = apply { this.id = id }
-
-            /** A JSON string of the output of the local shell tool call. */
-            fun output(output: String) = output(JsonField.of(output))
-
-            /**
-             * Sets [Builder.output] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.output] with a well-typed [String] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun output(output: JsonField<String>) = apply { this.output = output }
-
-            /**
-             * Sets the field to an arbitrary JSON value.
-             *
-             * It is usually unnecessary to call this method because the field defaults to the
-             * following:
-             * ```java
-             * JsonValue.from("local_shell_call_output")
-             * ```
-             *
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun type(type: JsonValue) = apply { this.type = type }
-
-            /** The status of the item. One of `in_progress`, `completed`, or `incomplete`. */
-            fun status(status: Status?) = status(JsonField.ofNullable(status))
-
-            /** Alias for calling [Builder.status] with `status.orElse(null)`. */
-            fun status(status: Optional<Status>) = status(status.getOrNull())
-
-            /**
-             * Sets [Builder.status] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.status] with a well-typed [Status] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun status(status: JsonField<Status>) = apply { this.status = status }
-
-            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                this.additionalProperties.clear()
-                putAllAdditionalProperties(additionalProperties)
-            }
-
-            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                additionalProperties.put(key, value)
-            }
-
-            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                this.additionalProperties.putAll(additionalProperties)
-            }
-
-            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
-
-            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                keys.forEach(::removeAdditionalProperty)
-            }
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
 
             /**
-             * Returns an immutable instance of [LocalShellCallOutput].
+             * Returns an immutable instance of [LocalShellCall].
              *
              * Further updates to this [Builder] will not mutate the returned instance.
              *
              * The following fields are required:
              * ```java
              * .id()
-             * .output()
+             * .action()
+             * .callId()
+             * .status()
              * ```
              *
              * @throws IllegalStateException if any required field is unset.
              */
-            fun build(): LocalShellCallOutput =
-                LocalShellCallOutput(
+            fun build(): LocalShellCall =
+                LocalShellCall(
                     checkRequired("id", id),
-                    checkRequired("output", output),
+                    checkRequired("action", action),
+                    checkRequired("callId", callId),
+                    checkRequired("status", status),
                     type,
-                    status,
                     additionalProperties.toMutableMap(),
                 )
         }
@@ -6470,19 +6052,20 @@ private constructor(
          * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
          *   expected type.
          */
-        fun validate(): LocalShellCallOutput = apply {
+        fun validate(): LocalShellCall = apply {
             if (validated) {
                 return@apply
             }
 
             id()
-            output()
+            action().validate()
+            callId()
+            status().validate()
             _type().let {
-                if (it != JsonValue.from("local_shell_call_output")) {
+                if (it != JsonValue.from("local_shell_call")) {
                     throw OpenAIInvalidDataException("'type' is invalid, received $it")
                 }
             }
-            status().ifPresent { it.validate() }
             validated = true
         }
 
@@ -6503,1077 +6086,981 @@ private constructor(
         @JvmSynthetic
         internal fun validity(): Int =
             (if (id.asKnown().isPresent) 1 else 0) +
-                (if (output.asKnown().isPresent) 1 else 0) +
-                type.let { if (it == JsonValue.from("local_shell_call_output")) 1 else 0 } +
-                (status.asKnown().getOrNull()?.validity() ?: 0)
-
-        /** The status of the item. One of `in_progress`, `completed`, or `incomplete`. */
-        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
-
-            /**
-             * Returns this class instance's raw value.
-             *
-             * This is usually only useful if this instance was deserialized from data that doesn't
-             * match any known member, and you want to know that value. For example, if the SDK is
-             * on an older version than the API, then the API may respond with new members that the
-             * SDK is unaware of.
-             */
-            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
-
-            companion object {
+                (action.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("local_shell_call")) 1 else 0 }
 
-                @JvmField val IN_PROGRESS = of("in_progress")
+        /** Execute a shell command on the server. */
+        class Action
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val command: JsonField<List<String>>,
+            private val env: JsonField<Env>,
+            private val type: JsonValue,
+            private val timeoutMs: JsonField<Long>,
+            private val user: JsonField<String>,
+            private val workingDirectory: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
 
-                @JvmField val COMPLETED = of("completed")
-
-                @JvmField val INCOMPLETE = of("incomplete")
-
-                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
-            }
-
-            /** An enum containing [Status]'s known values. */
-            enum class Known {
-                IN_PROGRESS,
-                COMPLETED,
-                INCOMPLETE,
-            }
+            @JsonCreator
+            private constructor(
+                @JsonProperty("command")
+                @ExcludeMissing
+                command: JsonField<List<String>> = JsonMissing.of(),
+                @JsonProperty("env") @ExcludeMissing env: JsonField<Env> = JsonMissing.of(),
+                @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                @JsonProperty("timeout_ms")
+                @ExcludeMissing
+                timeoutMs: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("user") @ExcludeMissing user: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("working_directory")
+                @ExcludeMissing
+                workingDirectory: JsonField<String> = JsonMissing.of(),
+            ) : this(command, env, type, timeoutMs, user, workingDirectory, mutableMapOf())
 
             /**
-             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             * The command to run.
              *
-             * An instance of [Status] can contain an unknown value in a couple of cases:
-             * - It was deserialized from data that doesn't match any known member. For example, if
-             *   the SDK is on an older version than the API, then the API may respond with new
-             *   members that the SDK is unaware of.
-             * - It was constructed with an arbitrary value using the [of] method.
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
              */
-            enum class Value {
-                IN_PROGRESS,
-                COMPLETED,
-                INCOMPLETE,
-                /**
-                 * An enum member indicating that [Status] was instantiated with an unknown value.
-                 */
-                _UNKNOWN,
-            }
+            fun command(): List<String> = command.getRequired("command")
 
             /**
-             * Returns an enum member corresponding to this class instance's value, or
-             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             * Environment variables to set for the command.
              *
-             * Use the [known] method instead if you're certain the value is always known or if you
-             * want to throw for the unknown case.
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
              */
-            fun value(): Value =
-                when (this) {
-                    IN_PROGRESS -> Value.IN_PROGRESS
-                    COMPLETED -> Value.COMPLETED
-                    INCOMPLETE -> Value.INCOMPLETE
-                    else -> Value._UNKNOWN
-                }
+            fun env(): Env = env.getRequired("env")
 
             /**
-             * Returns an enum member corresponding to this class instance's value.
+             * The type of the local shell action. Always `exec`.
              *
-             * Use the [value] method instead if you're uncertain the value is always known and
-             * don't want to throw for the unknown case.
+             * Expected to always return the following:
+             * ```java
+             * JsonValue.from("exec")
+             * ```
              *
-             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
-             *   member.
+             * However, this method can be useful for debugging and logging (e.g. if the server
+             * responded with an unexpected value).
              */
-            fun known(): Known =
-                when (this) {
-                    IN_PROGRESS -> Known.IN_PROGRESS
-                    COMPLETED -> Known.COMPLETED
-                    INCOMPLETE -> Known.INCOMPLETE
-                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
-                }
+            @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
             /**
-             * Returns this class instance's primitive wire representation.
-             *
-             * This differs from the [toString] method because that method is primarily for
-             * debugging and generally doesn't throw.
+             * Optional timeout in milliseconds for the command.
              *
-             * @throws OpenAIInvalidDataException if this class instance's value does not have the
-             *   expected primitive type.
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
              */
-            fun asString(): String =
-                _value().asString().orElseThrow {
-                    OpenAIInvalidDataException("Value is not a String")
-                }
+            fun timeoutMs(): Optional<Long> = timeoutMs.getOptional("timeout_ms")
 
-            private var validated: Boolean = false
+            /**
+             * Optional user to run the command as.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun user(): Optional<String> = user.getOptional("user")
 
             /**
-             * Validates that the types of all values in this object match their expected types
-             * recursively.
+             * Optional working directory to run the command in.
              *
-             * This method is _not_ forwards compatible with new types from the API for existing
-             * fields.
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun workingDirectory(): Optional<String> =
+                workingDirectory.getOptional("working_directory")
+
+            /**
+             * Returns the raw JSON value of [command].
              *
-             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-             *   expected type.
+             * Unlike [command], this method doesn't throw if the JSON field has an unexpected type.
              */
-            fun validate(): Status = apply {
-                if (validated) {
-                    return@apply
-                }
+            @JsonProperty("command")
+            @ExcludeMissing
+            fun _command(): JsonField<List<String>> = command
 
-                known()
-                validated = true
-            }
+            /**
+             * Returns the raw JSON value of [env].
+             *
+             * Unlike [env], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("env") @ExcludeMissing fun _env(): JsonField<Env> = env
 
-            fun isValid(): Boolean =
-                try {
-                    validate()
-                    true
-                } catch (e: OpenAIInvalidDataException) {
-                    false
-                }
+            /**
+             * Returns the raw JSON value of [timeoutMs].
+             *
+             * Unlike [timeoutMs], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("timeout_ms")
+            @ExcludeMissing
+            fun _timeoutMs(): JsonField<Long> = timeoutMs
 
             /**
-             * Returns a score indicating how many valid values are contained in this object
-             * recursively.
+             * Returns the raw JSON value of [user].
              *
-             * Used for best match union deserialization.
+             * Unlike [user], this method doesn't throw if the JSON field has an unexpected type.
              */
-            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+            @JsonProperty("user") @ExcludeMissing fun _user(): JsonField<String> = user
 
-            override fun equals(other: Any?): Boolean {
-                if (this === other) {
-                    return true
-                }
+            /**
+             * Returns the raw JSON value of [workingDirectory].
+             *
+             * Unlike [workingDirectory], this method doesn't throw if the JSON field has an
+             * unexpected type.
+             */
+            @JsonProperty("working_directory")
+            @ExcludeMissing
+            fun _workingDirectory(): JsonField<String> = workingDirectory
 
-                return other is Status && value == other.value
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
             }
 
-            override fun hashCode() = value.hashCode()
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
 
-            override fun toString() = value.toString()
-        }
+            fun toBuilder() = Builder().from(this)
 
-        override fun equals(other: Any?): Boolean {
-            if (this === other) {
-                return true
-            }
+            companion object {
 
-            return other is LocalShellCallOutput &&
-                id == other.id &&
-                output == other.output &&
-                type == other.type &&
-                status == other.status &&
-                additionalProperties == other.additionalProperties
-        }
+                /**
+                 * Returns a mutable builder for constructing an instance of [Action].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .command()
+                 * .env()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
 
-        private val hashCode: Int by lazy {
-            Objects.hash(id, output, type, status, additionalProperties)
-        }
+            /** A builder for [Action]. */
+            class Builder internal constructor() {
 
-        override fun hashCode(): Int = hashCode
+                private var command: JsonField<MutableList<String>>? = null
+                private var env: JsonField<Env>? = null
+                private var type: JsonValue = JsonValue.from("exec")
+                private var timeoutMs: JsonField<Long> = JsonMissing.of()
+                private var user: JsonField<String> = JsonMissing.of()
+                private var workingDirectory: JsonField<String> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
-        override fun toString() =
-            "LocalShellCallOutput{id=$id, output=$output, type=$type, status=$status, additionalProperties=$additionalProperties}"
-    }
+                @JvmSynthetic
+                internal fun from(action: Action) = apply {
+                    command = action.command.map { it.toMutableList() }
+                    env = action.env
+                    type = action.type
+                    timeoutMs = action.timeoutMs
+                    user = action.user
+                    workingDirectory = action.workingDirectory
+                    additionalProperties = action.additionalProperties.toMutableMap()
+                }
 
-    /** A tool representing a request to execute one or more shell commands. */
-    class ShellCall
-    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-    private constructor(
-        private val action: JsonField<Action>,
-        private val callId: JsonField<String>,
-        private val type: JsonValue,
-        private val id: JsonField<String>,
-        private val environment: JsonField<Environment>,
-        private val status: JsonField<Status>,
-        private val additionalProperties: MutableMap<String, JsonValue>,
-    ) {
+                /** The command to run. */
+                fun command(command: List<String>) = command(JsonField.of(command))
 
-        @JsonCreator
-        private constructor(
-            @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
-            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("environment")
-            @ExcludeMissing
-            environment: JsonField<Environment> = JsonMissing.of(),
-            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
-        ) : this(action, callId, type, id, environment, status, mutableMapOf())
+                /**
+                 * Sets [Builder.command] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.command] with a well-typed `List<String>` value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun command(command: JsonField<List<String>>) = apply {
+                    this.command = command.map { it.toMutableList() }
+                }
 
-        /**
-         * The shell commands and limits that describe how to run the tool call.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun action(): Action = action.getRequired("action")
+                /**
+                 * Adds a single [String] to [Builder.command].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addCommand(command: String) = apply {
+                    this.command =
+                        (this.command ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("command", it).add(command)
+                        }
+                }
 
-        /**
-         * The unique ID of the shell tool call generated by the model.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun callId(): String = callId.getRequired("call_id")
+                /** Environment variables to set for the command. */
+                fun env(env: Env) = env(JsonField.of(env))
 
-        /**
-         * The type of the item. Always `shell_call`.
-         *
-         * Expected to always return the following:
-         * ```java
-         * JsonValue.from("shell_call")
-         * ```
-         *
-         * However, this method can be useful for debugging and logging (e.g. if the server
-         * responded with an unexpected value).
-         */
-        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+                /**
+                 * Sets [Builder.env] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.env] with a well-typed [Env] value instead. This
+                 * method is primarily for setting the field to an undocumented or not yet supported
+                 * value.
+                 */
+                fun env(env: JsonField<Env>) = apply { this.env = env }
 
-        /**
-         * The unique ID of the shell tool call. Populated when this item is returned via API.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun id(): Optional<String> = id.getOptional("id")
+                /**
+                 * Sets the field to an arbitrary JSON value.
+                 *
+                 * It is usually unnecessary to call this method because the field defaults to the
+                 * following:
+                 * ```java
+                 * JsonValue.from("exec")
+                 * ```
+                 *
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun type(type: JsonValue) = apply { this.type = type }
 
-        /**
-         * The environment to execute the shell commands in.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun environment(): Optional<Environment> = environment.getOptional("environment")
+                /** Optional timeout in milliseconds for the command. */
+                fun timeoutMs(timeoutMs: Long?) = timeoutMs(JsonField.ofNullable(timeoutMs))
 
-        /**
-         * The status of the shell call. One of `in_progress`, `completed`, or `incomplete`.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun status(): Optional<Status> = status.getOptional("status")
+                /**
+                 * Alias for [Builder.timeoutMs].
+                 *
+                 * This unboxed primitive overload exists for backwards compatibility.
+                 */
+                fun timeoutMs(timeoutMs: Long) = timeoutMs(timeoutMs as Long?)
 
-        /**
-         * Returns the raw JSON value of [action].
-         *
-         * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
+                /** Alias for calling [Builder.timeoutMs] with `timeoutMs.orElse(null)`. */
+                fun timeoutMs(timeoutMs: Optional<Long>) = timeoutMs(timeoutMs.getOrNull())
 
-        /**
-         * Returns the raw JSON value of [callId].
-         *
-         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+                /**
+                 * Sets [Builder.timeoutMs] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.timeoutMs] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun timeoutMs(timeoutMs: JsonField<Long>) = apply { this.timeoutMs = timeoutMs }
 
-        /**
-         * Returns the raw JSON value of [id].
-         *
-         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+                /** Optional user to run the command as. */
+                fun user(user: String?) = user(JsonField.ofNullable(user))
 
-        /**
-         * Returns the raw JSON value of [environment].
-         *
-         * Unlike [environment], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("environment")
-        @ExcludeMissing
-        fun _environment(): JsonField<Environment> = environment
+                /** Alias for calling [Builder.user] with `user.orElse(null)`. */
+                fun user(user: Optional<String>) = user(user.getOrNull())
 
-        /**
-         * Returns the raw JSON value of [status].
-         *
-         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+                /**
+                 * Sets [Builder.user] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.user] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun user(user: JsonField<String>) = apply { this.user = user }
 
-        @JsonAnySetter
-        private fun putAdditionalProperty(key: String, value: JsonValue) {
-            additionalProperties.put(key, value)
-        }
+                /** Optional working directory to run the command in. */
+                fun workingDirectory(workingDirectory: String?) =
+                    workingDirectory(JsonField.ofNullable(workingDirectory))
 
-        @JsonAnyGetter
-        @ExcludeMissing
-        fun _additionalProperties(): Map<String, JsonValue> =
-            Collections.unmodifiableMap(additionalProperties)
+                /**
+                 * Alias for calling [Builder.workingDirectory] with
+                 * `workingDirectory.orElse(null)`.
+                 */
+                fun workingDirectory(workingDirectory: Optional<String>) =
+                    workingDirectory(workingDirectory.getOrNull())
 
-        fun toBuilder() = Builder().from(this)
+                /**
+                 * Sets [Builder.workingDirectory] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.workingDirectory] with a well-typed [String]
+                 * value instead. This method is primarily for setting the field to an undocumented
+                 * or not yet supported value.
+                 */
+                fun workingDirectory(workingDirectory: JsonField<String>) = apply {
+                    this.workingDirectory = workingDirectory
+                }
 
-        companion object {
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
 
-            /**
-             * Returns a mutable builder for constructing an instance of [ShellCall].
-             *
-             * The following fields are required:
-             * ```java
-             * .action()
-             * .callId()
-             * ```
-             */
-            @JvmStatic fun builder() = Builder()
-        }
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
 
-        /** A builder for [ShellCall]. */
-        class Builder internal constructor() {
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
 
-            private var action: JsonField<Action>? = null
-            private var callId: JsonField<String>? = null
-            private var type: JsonValue = JsonValue.from("shell_call")
-            private var id: JsonField<String> = JsonMissing.of()
-            private var environment: JsonField<Environment> = JsonMissing.of()
-            private var status: JsonField<Status> = JsonMissing.of()
-            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
 
-            @JvmSynthetic
-            internal fun from(shellCall: ShellCall) = apply {
-                action = shellCall.action
-                callId = shellCall.callId
-                type = shellCall.type
-                id = shellCall.id
-                environment = shellCall.environment
-                status = shellCall.status
-                additionalProperties = shellCall.additionalProperties.toMutableMap()
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Action].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .command()
+                 * .env()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Action =
+                    Action(
+                        checkRequired("command", command).map { it.toImmutable() },
+                        checkRequired("env", env),
+                        type,
+                        timeoutMs,
+                        user,
+                        workingDirectory,
+                        additionalProperties.toMutableMap(),
+                    )
             }
 
-            /** The shell commands and limits that describe how to run the tool call. */
-            fun action(action: Action) = action(JsonField.of(action))
-
-            /**
-             * Sets [Builder.action] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.action] with a well-typed [Action] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun action(action: JsonField<Action>) = apply { this.action = action }
-
-            /** The unique ID of the shell tool call generated by the model. */
-            fun callId(callId: String) = callId(JsonField.of(callId))
-
-            /**
-             * Sets [Builder.callId] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.callId] with a well-typed [String] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+            private var validated: Boolean = false
 
             /**
-             * Sets the field to an arbitrary JSON value.
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
              *
-             * It is usually unnecessary to call this method because the field defaults to the
-             * following:
-             * ```java
-             * JsonValue.from("shell_call")
-             * ```
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
              *
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
              */
-            fun type(type: JsonValue) = apply { this.type = type }
+            fun validate(): Action = apply {
+                if (validated) {
+                    return@apply
+                }
 
-            /**
-             * The unique ID of the shell tool call. Populated when this item is returned via API.
-             */
-            fun id(id: String?) = id(JsonField.ofNullable(id))
+                command()
+                env().validate()
+                _type().let {
+                    if (it != JsonValue.from("exec")) {
+                        throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    }
+                }
+                timeoutMs()
+                user()
+                workingDirectory()
+                validated = true
+            }
 
-            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
-            fun id(id: Optional<String>) = id(id.getOrNull())
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
 
             /**
-             * Sets [Builder.id] to an arbitrary JSON value.
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
              *
-             * You should usually call [Builder.id] with a well-typed [String] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
+             * Used for best match union deserialization.
              */
-            fun id(id: JsonField<String>) = apply { this.id = id }
-
-            /** The environment to execute the shell commands in. */
-            fun environment(environment: Environment?) =
-                environment(JsonField.ofNullable(environment))
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (command.asKnown().getOrNull()?.size ?: 0) +
+                    (env.asKnown().getOrNull()?.validity() ?: 0) +
+                    type.let { if (it == JsonValue.from("exec")) 1 else 0 } +
+                    (if (timeoutMs.asKnown().isPresent) 1 else 0) +
+                    (if (user.asKnown().isPresent) 1 else 0) +
+                    (if (workingDirectory.asKnown().isPresent) 1 else 0)
 
-            /** Alias for calling [Builder.environment] with `environment.orElse(null)`. */
-            fun environment(environment: Optional<Environment>) =
-                environment(environment.getOrNull())
+            /** Environment variables to set for the command. */
+            class Env
+            @JsonCreator
+            private constructor(
+                @com.fasterxml.jackson.annotation.JsonValue
+                private val additionalProperties: Map<String, JsonValue>
+            ) {
 
-            /**
-             * Sets [Builder.environment] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.environment] with a well-typed [Environment] value
-             * instead. This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun environment(environment: JsonField<Environment>) = apply {
-                this.environment = environment
-            }
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> = additionalProperties
 
-            /** Alias for calling [environment] with `Environment.ofLocal(local)`. */
-            fun environment(local: LocalEnvironment) = environment(Environment.ofLocal(local))
+                fun toBuilder() = Builder().from(this)
 
-            /**
-             * Alias for calling [environment] with
-             * `Environment.ofContainerReference(containerReference)`.
-             */
-            fun environment(containerReference: ContainerReference) =
-                environment(Environment.ofContainerReference(containerReference))
+                companion object {
 
-            /**
-             * Alias for calling [environment] with the following:
-             * ```java
-             * ContainerReference.builder()
-             *     .containerId(containerId)
-             *     .build()
-             * ```
-             */
-            fun containerReferenceEnvironment(containerId: String) =
-                environment(ContainerReference.builder().containerId(containerId).build())
+                    /** Returns a mutable builder for constructing an instance of [Env]. */
+                    @JvmStatic fun builder() = Builder()
+                }
 
-            /** The status of the shell call. One of `in_progress`, `completed`, or `incomplete`. */
-            fun status(status: Status?) = status(JsonField.ofNullable(status))
+                /** A builder for [Env]. */
+                class Builder internal constructor() {
 
-            /** Alias for calling [Builder.status] with `status.orElse(null)`. */
-            fun status(status: Optional<Status>) = status(status.getOrNull())
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
-            /**
-             * Sets [Builder.status] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.status] with a well-typed [Status] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun status(status: JsonField<Status>) = apply { this.status = status }
+                    @JvmSynthetic
+                    internal fun from(env: Env) = apply {
+                        additionalProperties = env.additionalProperties.toMutableMap()
+                    }
 
-            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                this.additionalProperties.clear()
-                putAllAdditionalProperties(additionalProperties)
-            }
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
 
-            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                additionalProperties.put(key, value)
-            }
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
 
-            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                this.additionalProperties.putAll(additionalProperties)
-            }
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
 
-            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
 
-            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                keys.forEach(::removeAdditionalProperty)
-            }
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
 
-            /**
-             * Returns an immutable instance of [ShellCall].
-             *
-             * Further updates to this [Builder] will not mutate the returned instance.
-             *
-             * The following fields are required:
-             * ```java
-             * .action()
-             * .callId()
-             * ```
-             *
-             * @throws IllegalStateException if any required field is unset.
-             */
-            fun build(): ShellCall =
-                ShellCall(
-                    checkRequired("action", action),
-                    checkRequired("callId", callId),
-                    type,
-                    id,
-                    environment,
-                    status,
-                    additionalProperties.toMutableMap(),
-                )
-        }
+                    /**
+                     * Returns an immutable instance of [Env].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     */
+                    fun build(): Env = Env(additionalProperties.toImmutable())
+                }
 
-        private var validated: Boolean = false
+                private var validated: Boolean = false
 
-        /**
-         * Validates that the types of all values in this object match their expected types
-         * recursively.
-         *
-         * This method is _not_ forwards compatible with new types from the API for existing fields.
-         *
-         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-         *   expected type.
-         */
-        fun validate(): ShellCall = apply {
-            if (validated) {
-                return@apply
-            }
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Env = apply {
+                    if (validated) {
+                        return@apply
+                    }
 
-            action().validate()
-            callId()
-            _type().let {
-                if (it != JsonValue.from("shell_call")) {
-                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    validated = true
                 }
-            }
-            id()
-            environment().ifPresent { it.validate() }
-            status().ifPresent { it.validate() }
-            validated = true
-        }
 
-        fun isValid(): Boolean =
-            try {
-                validate()
-                true
-            } catch (e: OpenAIInvalidDataException) {
-                false
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    additionalProperties.count { (_, value) ->
+                        !value.isNull() && !value.isMissing()
+                    }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Env && additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() = "Env{additionalProperties=$additionalProperties}"
             }
 
-        /**
-         * Returns a score indicating how many valid values are contained in this object
-         * recursively.
-         *
-         * Used for best match union deserialization.
-         */
-        @JvmSynthetic
-        internal fun validity(): Int =
-            (action.asKnown().getOrNull()?.validity() ?: 0) +
-                (if (callId.asKnown().isPresent) 1 else 0) +
-                type.let { if (it == JsonValue.from("shell_call")) 1 else 0 } +
-                (if (id.asKnown().isPresent) 1 else 0) +
-                (environment.asKnown().getOrNull()?.validity() ?: 0) +
-                (status.asKnown().getOrNull()?.validity() ?: 0)
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
 
-        /** The shell commands and limits that describe how to run the tool call. */
-        class Action
-        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-        private constructor(
-            private val commands: JsonField<List<String>>,
-            private val maxOutputLength: JsonField<Long>,
-            private val timeoutMs: JsonField<Long>,
-            private val additionalProperties: MutableMap<String, JsonValue>,
-        ) {
+                return other is Action &&
+                    command == other.command &&
+                    env == other.env &&
+                    type == other.type &&
+                    timeoutMs == other.timeoutMs &&
+                    user == other.user &&
+                    workingDirectory == other.workingDirectory &&
+                    additionalProperties == other.additionalProperties
+            }
 
-            @JsonCreator
-            private constructor(
-                @JsonProperty("commands")
-                @ExcludeMissing
-                commands: JsonField<List<String>> = JsonMissing.of(),
-                @JsonProperty("max_output_length")
-                @ExcludeMissing
-                maxOutputLength: JsonField<Long> = JsonMissing.of(),
-                @JsonProperty("timeout_ms")
-                @ExcludeMissing
-                timeoutMs: JsonField<Long> = JsonMissing.of(),
-            ) : this(commands, maxOutputLength, timeoutMs, mutableMapOf())
+            private val hashCode: Int by lazy {
+                Objects.hash(
+                    command,
+                    env,
+                    type,
+                    timeoutMs,
+                    user,
+                    workingDirectory,
+                    additionalProperties,
+                )
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Action{command=$command, env=$env, type=$type, timeoutMs=$timeoutMs, user=$user, workingDirectory=$workingDirectory, additionalProperties=$additionalProperties}"
+        }
+
+        /** The status of the local shell call. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
             /**
-             * Ordered shell commands for the execution environment to run.
+             * Returns this class instance's raw value.
              *
-             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
-             *   value).
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
              */
-            fun commands(): List<String> = commands.getRequired("commands")
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+            }
 
             /**
-             * Maximum number of UTF-8 characters to capture from combined stdout and stderr output.
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
              *
-             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
-             *   the server responded with an unexpected value).
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
              */
-            fun maxOutputLength(): Optional<Long> = maxOutputLength.getOptional("max_output_length")
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
 
             /**
-             * Maximum wall-clock time in milliseconds to allow the shell commands to run.
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
              *
-             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
-             *   the server responded with an unexpected value).
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
              */
-            fun timeoutMs(): Optional<Long> = timeoutMs.getOptional("timeout_ms")
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
 
             /**
-             * Returns the raw JSON value of [commands].
+             * Returns an enum member corresponding to this class instance's value.
              *
-             * Unlike [commands], this method doesn't throw if the JSON field has an unexpected
-             * type.
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
              */
-            @JsonProperty("commands")
-            @ExcludeMissing
-            fun _commands(): JsonField<List<String>> = commands
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
 
             /**
-             * Returns the raw JSON value of [maxOutputLength].
+             * Returns this class instance's primitive wire representation.
              *
-             * Unlike [maxOutputLength], this method doesn't throw if the JSON field has an
-             * unexpected type.
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
              */
-            @JsonProperty("max_output_length")
-            @ExcludeMissing
-            fun _maxOutputLength(): JsonField<Long> = maxOutputLength
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
 
             /**
-             * Returns the raw JSON value of [timeoutMs].
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
              *
-             * Unlike [timeoutMs], this method doesn't throw if the JSON field has an unexpected
-             * type.
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
              */
-            @JsonProperty("timeout_ms")
-            @ExcludeMissing
-            fun _timeoutMs(): JsonField<Long> = timeoutMs
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
 
-            @JsonAnySetter
-            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                additionalProperties.put(key, value)
+                known()
+                validated = true
             }
 
-            @JsonAnyGetter
-            @ExcludeMissing
-            fun _additionalProperties(): Map<String, JsonValue> =
-                Collections.unmodifiableMap(additionalProperties)
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
 
-            fun toBuilder() = Builder().from(this)
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
 
-            companion object {
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
 
-                /**
-                 * Returns a mutable builder for constructing an instance of [Action].
-                 *
-                 * The following fields are required:
-                 * ```java
-                 * .commands()
-                 * ```
-                 */
-                @JvmStatic fun builder() = Builder()
+                return other is Status && value == other.value
             }
 
-            /** A builder for [Action]. */
-            class Builder internal constructor() {
-
-                private var commands: JsonField<MutableList<String>>? = null
-                private var maxOutputLength: JsonField<Long> = JsonMissing.of()
-                private var timeoutMs: JsonField<Long> = JsonMissing.of()
-                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+            override fun hashCode() = value.hashCode()
 
-                @JvmSynthetic
-                internal fun from(action: Action) = apply {
-                    commands = action.commands.map { it.toMutableList() }
-                    maxOutputLength = action.maxOutputLength
-                    timeoutMs = action.timeoutMs
-                    additionalProperties = action.additionalProperties.toMutableMap()
-                }
+            override fun toString() = value.toString()
+        }
 
-                /** Ordered shell commands for the execution environment to run. */
-                fun commands(commands: List<String>) = commands(JsonField.of(commands))
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
 
-                /**
-                 * Sets [Builder.commands] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.commands] with a well-typed `List<String>` value
-                 * instead. This method is primarily for setting the field to an undocumented or not
-                 * yet supported value.
-                 */
-                fun commands(commands: JsonField<List<String>>) = apply {
-                    this.commands = commands.map { it.toMutableList() }
-                }
+            return other is LocalShellCall &&
+                id == other.id &&
+                action == other.action &&
+                callId == other.callId &&
+                status == other.status &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
 
-                /**
-                 * Adds a single [String] to [commands].
-                 *
-                 * @throws IllegalStateException if the field was previously set to a non-list.
-                 */
-                fun addCommand(command: String) = apply {
-                    commands =
-                        (commands ?: JsonField.of(mutableListOf())).also {
-                            checkKnown("commands", it).add(command)
-                        }
-                }
+        private val hashCode: Int by lazy {
+            Objects.hash(id, action, callId, status, type, additionalProperties)
+        }
 
-                /**
-                 * Maximum number of UTF-8 characters to capture from combined stdout and stderr
-                 * output.
-                 */
-                fun maxOutputLength(maxOutputLength: Long?) =
-                    maxOutputLength(JsonField.ofNullable(maxOutputLength))
+        override fun hashCode(): Int = hashCode
 
-                /**
-                 * Alias for [Builder.maxOutputLength].
-                 *
-                 * This unboxed primitive overload exists for backwards compatibility.
-                 */
-                fun maxOutputLength(maxOutputLength: Long) =
-                    maxOutputLength(maxOutputLength as Long?)
+        override fun toString() =
+            "LocalShellCall{id=$id, action=$action, callId=$callId, status=$status, type=$type, additionalProperties=$additionalProperties}"
+    }
 
-                /**
-                 * Alias for calling [Builder.maxOutputLength] with `maxOutputLength.orElse(null)`.
-                 */
-                fun maxOutputLength(maxOutputLength: Optional<Long>) =
-                    maxOutputLength(maxOutputLength.getOrNull())
+    /** The output of a local shell tool call. */
+    class LocalShellCallOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val output: JsonField<String>,
+        private val type: JsonValue,
+        private val status: JsonField<Status>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
 
-                /**
-                 * Sets [Builder.maxOutputLength] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.maxOutputLength] with a well-typed [Long] value
-                 * instead. This method is primarily for setting the field to an undocumented or not
-                 * yet supported value.
-                 */
-                fun maxOutputLength(maxOutputLength: JsonField<Long>) = apply {
-                    this.maxOutputLength = maxOutputLength
-                }
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("output") @ExcludeMissing output: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        ) : this(id, output, type, status, mutableMapOf())
 
-                /** Maximum wall-clock time in milliseconds to allow the shell commands to run. */
-                fun timeoutMs(timeoutMs: Long?) = timeoutMs(JsonField.ofNullable(timeoutMs))
+        /**
+         * The unique ID of the local shell tool call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
 
-                /**
-                 * Alias for [Builder.timeoutMs].
-                 *
-                 * This unboxed primitive overload exists for backwards compatibility.
-                 */
-                fun timeoutMs(timeoutMs: Long) = timeoutMs(timeoutMs as Long?)
+        /**
+         * A JSON string of the output of the local shell tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun output(): String = output.getRequired("output")
 
-                /** Alias for calling [Builder.timeoutMs] with `timeoutMs.orElse(null)`. */
-                fun timeoutMs(timeoutMs: Optional<Long>) = timeoutMs(timeoutMs.getOrNull())
+        /**
+         * The type of the local shell tool call output. Always `local_shell_call_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("local_shell_call_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
-                /**
-                 * Sets [Builder.timeoutMs] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.timeoutMs] with a well-typed [Long] value
-                 * instead. This method is primarily for setting the field to an undocumented or not
-                 * yet supported value.
-                 */
-                fun timeoutMs(timeoutMs: JsonField<Long>) = apply { this.timeoutMs = timeoutMs }
+        /**
+         * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun status(): Optional<Status> = status.getOptional("status")
 
-                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                    this.additionalProperties.clear()
-                    putAllAdditionalProperties(additionalProperties)
-                }
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
-                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                    additionalProperties.put(key, value)
-                }
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<String> = output
 
-                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
-                    apply {
-                        this.additionalProperties.putAll(additionalProperties)
-                    }
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
 
-                fun removeAdditionalProperty(key: String) = apply {
-                    additionalProperties.remove(key)
-                }
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
 
-                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                    keys.forEach(::removeAdditionalProperty)
-                }
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
 
-                /**
-                 * Returns an immutable instance of [Action].
-                 *
-                 * Further updates to this [Builder] will not mutate the returned instance.
-                 *
-                 * The following fields are required:
-                 * ```java
-                 * .commands()
-                 * ```
-                 *
-                 * @throws IllegalStateException if any required field is unset.
-                 */
-                fun build(): Action =
-                    Action(
-                        checkRequired("commands", commands).map { it.toImmutable() },
-                        maxOutputLength,
-                        timeoutMs,
-                        additionalProperties.toMutableMap(),
-                    )
-            }
+        fun toBuilder() = Builder().from(this)
 
-            private var validated: Boolean = false
+        companion object {
 
             /**
-             * Validates that the types of all values in this object match their expected types
-             * recursively.
-             *
-             * This method is _not_ forwards compatible with new types from the API for existing
-             * fields.
+             * Returns a mutable builder for constructing an instance of [LocalShellCallOutput].
              *
-             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-             *   expected type.
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .output()
+             * ```
              */
-            fun validate(): Action = apply {
-                if (validated) {
-                    return@apply
-                }
+            @JvmStatic fun builder() = Builder()
+        }
 
-                commands()
-                maxOutputLength()
-                timeoutMs()
-                validated = true
-            }
+        /** A builder for [LocalShellCallOutput]. */
+        class Builder internal constructor() {
 
-            fun isValid(): Boolean =
-                try {
-                    validate()
-                    true
-                } catch (e: OpenAIInvalidDataException) {
-                    false
-                }
+            private var id: JsonField<String>? = null
+            private var output: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("local_shell_call_output")
+            private var status: JsonField<Status> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
-            /**
-             * Returns a score indicating how many valid values are contained in this object
-             * recursively.
-             *
-             * Used for best match union deserialization.
-             */
             @JvmSynthetic
-            internal fun validity(): Int =
-                (commands.asKnown().getOrNull()?.size ?: 0) +
-                    (if (maxOutputLength.asKnown().isPresent) 1 else 0) +
-                    (if (timeoutMs.asKnown().isPresent) 1 else 0)
-
-            override fun equals(other: Any?): Boolean {
-                if (this === other) {
-                    return true
-                }
-
-                return other is Action &&
-                    commands == other.commands &&
-                    maxOutputLength == other.maxOutputLength &&
-                    timeoutMs == other.timeoutMs &&
-                    additionalProperties == other.additionalProperties
-            }
-
-            private val hashCode: Int by lazy {
-                Objects.hash(commands, maxOutputLength, timeoutMs, additionalProperties)
+            internal fun from(localShellCallOutput: LocalShellCallOutput) = apply {
+                id = localShellCallOutput.id
+                output = localShellCallOutput.output
+                type = localShellCallOutput.type
+                status = localShellCallOutput.status
+                additionalProperties = localShellCallOutput.additionalProperties.toMutableMap()
             }
 
-            override fun hashCode(): Int = hashCode
-
-            override fun toString() =
-                "Action{commands=$commands, maxOutputLength=$maxOutputLength, timeoutMs=$timeoutMs, additionalProperties=$additionalProperties}"
-        }
-
-        /** The environment to execute the shell commands in. */
-        @JsonDeserialize(using = Environment.Deserializer::class)
-        @JsonSerialize(using = Environment.Serializer::class)
-        class Environment
-        private constructor(
-            private val local: LocalEnvironment? = null,
-            private val containerReference: ContainerReference? = null,
-            private val _json: JsonValue? = null,
-        ) {
-
-            fun local(): Optional<LocalEnvironment> = Optional.ofNullable(local)
-
-            fun containerReference(): Optional<ContainerReference> =
-                Optional.ofNullable(containerReference)
-
-            fun isLocal(): Boolean = local != null
-
-            fun isContainerReference(): Boolean = containerReference != null
+            /** The unique ID of the local shell tool call generated by the model. */
+            fun id(id: String) = id(JsonField.of(id))
 
-            fun asLocal(): LocalEnvironment = local.getOrThrow("local")
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
 
-            fun asContainerReference(): ContainerReference =
-                containerReference.getOrThrow("containerReference")
+            /** A JSON string of the output of the local shell tool call. */
+            fun output(output: String) = output(JsonField.of(output))
 
-            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun output(output: JsonField<String>) = apply { this.output = output }
 
             /**
-             * Maps this instance's current variant to a value of type [T] using the given
-             * [visitor].
+             * Sets the field to an arbitrary JSON value.
              *
-             * Note that this method is _not_ forwards compatible with new variants from the API,
-             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
-             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
              * ```java
-             * import com.openai.core.JsonValue;
-             * import java.util.Optional;
-             *
-             * Optional<String> result = environment.accept(new Environment.Visitor<Optional<String>>() {
-             *     @Override
-             *     public Optional<String> visitLocal(LocalEnvironment local) {
-             *         return Optional.of(local.toString());
-             *     }
-             *
-             *     // ...
-             *
-             *     @Override
-             *     public Optional<String> unknown(JsonValue json) {
-             *         // Or inspect the `json`.
-             *         return Optional.empty();
-             *     }
-             * });
+             * JsonValue.from("local_shell_call_output")
              * ```
              *
-             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
-             *   [visitor] and the current variant is unknown.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            fun <T> accept(visitor: Visitor<T>): T =
-                when {
-                    local != null -> visitor.visitLocal(local)
-                    containerReference != null ->
-                        visitor.visitContainerReference(containerReference)
-                    else -> visitor.unknown(_json)
-                }
+            fun type(type: JsonValue) = apply { this.type = type }
 
-            private var validated: Boolean = false
+            /** The status of the item. One of `in_progress`, `completed`, or `incomplete`. */
+            fun status(status: Status?) = status(JsonField.ofNullable(status))
+
+            /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+            fun status(status: Optional<Status>) = status(status.getOrNull())
 
             /**
-             * Validates that the types of all values in this object match their expected types
-             * recursively.
-             *
-             * This method is _not_ forwards compatible with new types from the API for existing
-             * fields.
+             * Sets [Builder.status] to an arbitrary JSON value.
              *
-             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-             *   expected type.
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            fun validate(): Environment = apply {
-                if (validated) {
-                    return@apply
-                }
+            fun status(status: JsonField<Status>) = apply { this.status = status }
 
-                accept(
-                    object : Visitor<Unit> {
-                        override fun visitLocal(local: LocalEnvironment) {
-                            local.validate()
-                        }
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
 
-                        override fun visitContainerReference(
-                            containerReference: ContainerReference
-                        ) {
-                            containerReference.validate()
-                        }
-                    }
-                )
-                validated = true
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
             }
 
-            fun isValid(): Boolean =
-                try {
-                    validate()
-                    true
-                } catch (e: OpenAIInvalidDataException) {
-                    false
-                }
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
 
             /**
-             * Returns a score indicating how many valid values are contained in this object
-             * recursively.
+             * Returns an immutable instance of [LocalShellCallOutput].
              *
-             * Used for best match union deserialization.
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .output()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
              */
-            @JvmSynthetic
-            internal fun validity(): Int =
-                accept(
-                    object : Visitor<Int> {
-                        override fun visitLocal(local: LocalEnvironment) = local.validity()
-
-                        override fun visitContainerReference(
-                            containerReference: ContainerReference
-                        ) = containerReference.validity()
-
-                        override fun unknown(json: JsonValue?) = 0
-                    }
+            fun build(): LocalShellCallOutput =
+                LocalShellCallOutput(
+                    checkRequired("id", id),
+                    checkRequired("output", output),
+                    type,
+                    status,
+                    additionalProperties.toMutableMap(),
                 )
+        }
 
-            override fun equals(other: Any?): Boolean {
-                if (this === other) {
-                    return true
-                }
+        private var validated: Boolean = false
 
-                return other is Environment &&
-                    local == other.local &&
-                    containerReference == other.containerReference
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): LocalShellCallOutput = apply {
+            if (validated) {
+                return@apply
             }
 
-            override fun hashCode(): Int = Objects.hash(local, containerReference)
-
-            override fun toString(): String =
-                when {
-                    local != null -> "Environment{local=$local}"
-                    containerReference != null ->
-                        "Environment{containerReference=$containerReference}"
-                    _json != null -> "Environment{_unknown=$_json}"
-                    else -> throw IllegalStateException("Invalid Environment")
+            id()
+            output()
+            _type().let {
+                if (it != JsonValue.from("local_shell_call_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
                 }
+            }
+            status().ifPresent { it.validate() }
+            validated = true
+        }
 
-            companion object {
-
-                @JvmStatic fun ofLocal(local: LocalEnvironment) = Environment(local = local)
-
-                @JvmStatic
-                fun ofContainerReference(containerReference: ContainerReference) =
-                    Environment(containerReference = containerReference)
-            }
-
-            /**
-             * An interface that defines how to map each variant of [Environment] to a value of type
-             * [T].
-             */
-            interface Visitor<out T> {
-
-                fun visitLocal(local: LocalEnvironment): T
-
-                fun visitContainerReference(containerReference: ContainerReference): T
-
-                /**
-                 * Maps an unknown variant of [Environment] to a value of type [T].
-                 *
-                 * An instance of [Environment] can contain an unknown variant if it was
-                 * deserialized from data that doesn't match any known variant. For example, if the
-                 * SDK is on an older version than the API, then the API may respond with new
-                 * variants that the SDK is unaware of.
-                 *
-                 * @throws OpenAIInvalidDataException in the default implementation.
-                 */
-                fun unknown(json: JsonValue?): T {
-                    throw OpenAIInvalidDataException("Unknown Environment: $json")
-                }
-            }
-
-            internal class Deserializer : BaseDeserializer<Environment>(Environment::class) {
-
-                override fun ObjectCodec.deserialize(node: JsonNode): Environment {
-                    val json = JsonValue.fromJsonNode(node)
-                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
-
-                    when (type) {
-                        "local" -> {
-                            return tryDeserialize(node, jacksonTypeRef<LocalEnvironment>())?.let {
-                                Environment(local = it, _json = json)
-                            } ?: Environment(_json = json)
-                        }
-                        "container_reference" -> {
-                            return tryDeserialize(node, jacksonTypeRef<ContainerReference>())?.let {
-                                Environment(containerReference = it, _json = json)
-                            } ?: Environment(_json = json)
-                        }
-                    }
-
-                    return Environment(_json = json)
-                }
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
             }
 
-            internal class Serializer : BaseSerializer<Environment>(Environment::class) {
-
-                override fun serialize(
-                    value: Environment,
-                    generator: JsonGenerator,
-                    provider: SerializerProvider,
-                ) {
-                    when {
-                        value.local != null -> generator.writeObject(value.local)
-                        value.containerReference != null ->
-                            generator.writeObject(value.containerReference)
-                        value._json != null -> generator.writeObject(value._json)
-                        else -> throw IllegalStateException("Invalid Environment")
-                    }
-                }
-            }
-        }
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (output.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("local_shell_call_output")) 1 else 0 } +
+                (status.asKnown().getOrNull()?.validity() ?: 0)
 
-        /** The status of the shell call. One of `in_progress`, `completed`, or `incomplete`. */
+        /** The status of the item. One of `in_progress`, `completed`, or `incomplete`. */
         class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
             /**
@@ -7724,75 +7211,73 @@ private constructor(
                 return true
             }
 
-            return other is ShellCall &&
-                action == other.action &&
-                callId == other.callId &&
-                type == other.type &&
+            return other is LocalShellCallOutput &&
                 id == other.id &&
-                environment == other.environment &&
+                output == other.output &&
+                type == other.type &&
                 status == other.status &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(action, callId, type, id, environment, status, additionalProperties)
+            Objects.hash(id, output, type, status, additionalProperties)
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "ShellCall{action=$action, callId=$callId, type=$type, id=$id, environment=$environment, status=$status, additionalProperties=$additionalProperties}"
+            "LocalShellCallOutput{id=$id, output=$output, type=$type, status=$status, additionalProperties=$additionalProperties}"
     }
 
-    /** The streamed output items emitted by a shell tool call. */
-    class ShellCallOutput
+    /** A tool representing a request to execute one or more shell commands. */
+    class ShellCall
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
+        private val action: JsonField<Action>,
         private val callId: JsonField<String>,
-        private val output: JsonField<List<ResponseFunctionShellCallOutputContent>>,
         private val type: JsonValue,
         private val id: JsonField<String>,
-        private val maxOutputLength: JsonField<Long>,
+        private val caller: JsonField<Caller>,
+        private val environment: JsonField<Environment>,
         private val status: JsonField<Status>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
         @JsonCreator
         private constructor(
+            @JsonProperty("action") @ExcludeMissing action: JsonField<Action> = JsonMissing.of(),
             @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("output")
-            @ExcludeMissing
-            output: JsonField<List<ResponseFunctionShellCallOutputContent>> = JsonMissing.of(),
             @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
             @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("max_output_length")
+            @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+            @JsonProperty("environment")
             @ExcludeMissing
-            maxOutputLength: JsonField<Long> = JsonMissing.of(),
+            environment: JsonField<Environment> = JsonMissing.of(),
             @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
-        ) : this(callId, output, type, id, maxOutputLength, status, mutableMapOf())
+        ) : this(action, callId, type, id, caller, environment, status, mutableMapOf())
 
         /**
-         * The unique ID of the shell tool call generated by the model.
+         * The shell commands and limits that describe how to run the tool call.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun callId(): String = callId.getRequired("call_id")
+        fun action(): Action = action.getRequired("action")
 
         /**
-         * Captured chunks of stdout and stderr output, along with their associated outcomes.
+         * The unique ID of the shell tool call generated by the model.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun output(): List<ResponseFunctionShellCallOutputContent> = output.getRequired("output")
+        fun callId(): String = callId.getRequired("call_id")
 
         /**
-         * The type of the item. Always `shell_call_output`.
+         * The type of the item. Always `shell_call`.
          *
          * Expected to always return the following:
          * ```java
-         * JsonValue.from("shell_call_output")
+         * JsonValue.from("shell_call")
          * ```
          *
          * However, this method can be useful for debugging and logging (e.g. if the server
@@ -7801,8 +7286,7 @@ private constructor(
         @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
         /**
-         * The unique ID of the shell tool call output. Populated when this item is returned via
-         * API.
+         * The unique ID of the shell tool call. Populated when this item is returned via API.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -7810,15 +7294,23 @@ private constructor(
         fun id(): Optional<String> = id.getOptional("id")
 
         /**
-         * The maximum number of UTF-8 characters captured for this shell call's combined output.
+         * The execution context that produced this tool call.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
-        fun maxOutputLength(): Optional<Long> = maxOutputLength.getOptional("max_output_length")
+        fun caller(): Optional<Caller> = caller.getOptional("caller")
 
         /**
-         * The status of the shell call output.
+         * The environment to execute the shell commands in.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun environment(): Optional<Environment> = environment.getOptional("environment")
+
+        /**
+         * The status of the shell call. One of `in_progress`, `completed`, or `incomplete`.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
@@ -7826,20 +7318,18 @@ private constructor(
         fun status(): Optional<Status> = status.getOptional("status")
 
         /**
-         * Returns the raw JSON value of [callId].
+         * Returns the raw JSON value of [action].
          *
-         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [action], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+        @JsonProperty("action") @ExcludeMissing fun _action(): JsonField<Action> = action
 
         /**
-         * Returns the raw JSON value of [output].
+         * Returns the raw JSON value of [callId].
          *
-         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("output")
-        @ExcludeMissing
-        fun _output(): JsonField<List<ResponseFunctionShellCallOutputContent>> = output
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
 
         /**
          * Returns the raw JSON value of [id].
@@ -7849,14 +7339,20 @@ private constructor(
         @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
         /**
-         * Returns the raw JSON value of [maxOutputLength].
+         * Returns the raw JSON value of [caller].
          *
-         * Unlike [maxOutputLength], this method doesn't throw if the JSON field has an unexpected
-         * type.
+         * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("max_output_length")
+        @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
+        /**
+         * Returns the raw JSON value of [environment].
+         *
+         * Unlike [environment], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("environment")
         @ExcludeMissing
-        fun _maxOutputLength(): JsonField<Long> = maxOutputLength
+        fun _environment(): JsonField<Environment> = environment
 
         /**
          * Returns the raw JSON value of [status].
@@ -7880,80 +7376,64 @@ private constructor(
         companion object {
 
             /**
-             * Returns a mutable builder for constructing an instance of [ShellCallOutput].
+             * Returns a mutable builder for constructing an instance of [ShellCall].
              *
              * The following fields are required:
              * ```java
+             * .action()
              * .callId()
-             * .output()
              * ```
              */
             @JvmStatic fun builder() = Builder()
         }
 
-        /** A builder for [ShellCallOutput]. */
+        /** A builder for [ShellCall]. */
         class Builder internal constructor() {
 
+            private var action: JsonField<Action>? = null
             private var callId: JsonField<String>? = null
-            private var output: JsonField<MutableList<ResponseFunctionShellCallOutputContent>>? =
-                null
-            private var type: JsonValue = JsonValue.from("shell_call_output")
+            private var type: JsonValue = JsonValue.from("shell_call")
             private var id: JsonField<String> = JsonMissing.of()
-            private var maxOutputLength: JsonField<Long> = JsonMissing.of()
+            private var caller: JsonField<Caller> = JsonMissing.of()
+            private var environment: JsonField<Environment> = JsonMissing.of()
             private var status: JsonField<Status> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
-            internal fun from(shellCallOutput: ShellCallOutput) = apply {
-                callId = shellCallOutput.callId
-                output = shellCallOutput.output.map { it.toMutableList() }
-                type = shellCallOutput.type
-                id = shellCallOutput.id
-                maxOutputLength = shellCallOutput.maxOutputLength
-                status = shellCallOutput.status
-                additionalProperties = shellCallOutput.additionalProperties.toMutableMap()
+            internal fun from(shellCall: ShellCall) = apply {
+                action = shellCall.action
+                callId = shellCall.callId
+                type = shellCall.type
+                id = shellCall.id
+                caller = shellCall.caller
+                environment = shellCall.environment
+                status = shellCall.status
+                additionalProperties = shellCall.additionalProperties.toMutableMap()
             }
 
-            /** The unique ID of the shell tool call generated by the model. */
-            fun callId(callId: String) = callId(JsonField.of(callId))
+            /** The shell commands and limits that describe how to run the tool call. */
+            fun action(action: Action) = action(JsonField.of(action))
 
             /**
-             * Sets [Builder.callId] to an arbitrary JSON value.
+             * Sets [Builder.action] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * You should usually call [Builder.action] with a well-typed [Action] value instead.
              * This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
-
-            /**
-             * Captured chunks of stdout and stderr output, along with their associated outcomes.
-             */
-            fun output(output: List<ResponseFunctionShellCallOutputContent>) =
-                output(JsonField.of(output))
+            fun action(action: JsonField<Action>) = apply { this.action = action }
 
-            /**
-             * Sets [Builder.output] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.output] with a well-typed
-             * `List<ResponseFunctionShellCallOutputContent>` value instead. This method is
-             * primarily for setting the field to an undocumented or not yet supported value.
-             */
-            fun output(output: JsonField<List<ResponseFunctionShellCallOutputContent>>) = apply {
-                this.output = output.map { it.toMutableList() }
-            }
+            /** The unique ID of the shell tool call generated by the model. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
 
             /**
-             * Adds a single [ResponseFunctionShellCallOutputContent] to [Builder.output].
+             * Sets [Builder.callId] to an arbitrary JSON value.
              *
-             * @throws IllegalStateException if the field was previously set to a non-list.
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            fun addOutput(output: ResponseFunctionShellCallOutputContent) = apply {
-                this.output =
-                    (this.output ?: JsonField.of(mutableListOf())).also {
-                        checkKnown("output", it).add(output)
-                    }
-            }
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
 
             /**
              * Sets the field to an arbitrary JSON value.
@@ -7961,7 +7441,7 @@ private constructor(
              * It is usually unnecessary to call this method because the field defaults to the
              * following:
              * ```java
-             * JsonValue.from("shell_call_output")
+             * JsonValue.from("shell_call")
              * ```
              *
              * This method is primarily for setting the field to an undocumented or not yet
@@ -7970,8 +7450,7 @@ private constructor(
             fun type(type: JsonValue) = apply { this.type = type }
 
             /**
-             * The unique ID of the shell tool call output. Populated when this item is returned via
-             * API.
+             * The unique ID of the shell tool call. Populated when this item is returned via API.
              */
             fun id(id: String?) = id(JsonField.ofNullable(id))
 
@@ -7987,36 +7466,79 @@ private constructor(
              */
             fun id(id: JsonField<String>) = apply { this.id = id }
 
-            /**
-             * The maximum number of UTF-8 characters captured for this shell call's combined
-             * output.
-             */
-            fun maxOutputLength(maxOutputLength: Long?) =
-                maxOutputLength(JsonField.ofNullable(maxOutputLength))
+            /** The execution context that produced this tool call. */
+            fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+            /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+            fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
 
             /**
-             * Alias for [Builder.maxOutputLength].
+             * Sets [Builder.caller] to an arbitrary JSON value.
              *
-             * This unboxed primitive overload exists for backwards compatibility.
+             * You should usually call [Builder.caller] with a well-typed [Caller] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            fun maxOutputLength(maxOutputLength: Long) = maxOutputLength(maxOutputLength as Long?)
+            fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
 
-            /** Alias for calling [Builder.maxOutputLength] with `maxOutputLength.orElse(null)`. */
-            fun maxOutputLength(maxOutputLength: Optional<Long>) =
-                maxOutputLength(maxOutputLength.getOrNull())
+            /** Alias for calling [caller] with `Caller.ofDirect()`. */
+            fun callerDirect() = caller(Caller.ofDirect())
+
+            /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+            fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
 
             /**
-             * Sets [Builder.maxOutputLength] to an arbitrary JSON value.
+             * Alias for calling [caller] with the following:
+             * ```java
+             * Caller.Program.builder()
+             *     .callerId(callerId)
+             *     .build()
+             * ```
+             */
+            fun programCaller(callerId: String) =
+                caller(Caller.Program.builder().callerId(callerId).build())
+
+            /** The environment to execute the shell commands in. */
+            fun environment(environment: Environment?) =
+                environment(JsonField.ofNullable(environment))
+
+            /** Alias for calling [Builder.environment] with `environment.orElse(null)`. */
+            fun environment(environment: Optional<Environment>) =
+                environment(environment.getOrNull())
+
+            /**
+             * Sets [Builder.environment] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.maxOutputLength] with a well-typed [Long] value
+             * You should usually call [Builder.environment] with a well-typed [Environment] value
              * instead. This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun maxOutputLength(maxOutputLength: JsonField<Long>) = apply {
-                this.maxOutputLength = maxOutputLength
+            fun environment(environment: JsonField<Environment>) = apply {
+                this.environment = environment
             }
 
-            /** The status of the shell call output. */
+            /** Alias for calling [environment] with `Environment.ofLocal(local)`. */
+            fun environment(local: LocalEnvironment) = environment(Environment.ofLocal(local))
+
+            /**
+             * Alias for calling [environment] with
+             * `Environment.ofContainerReference(containerReference)`.
+             */
+            fun environment(containerReference: ContainerReference) =
+                environment(Environment.ofContainerReference(containerReference))
+
+            /**
+             * Alias for calling [environment] with the following:
+             * ```java
+             * ContainerReference.builder()
+             *     .containerId(containerId)
+             *     .build()
+             * ```
+             */
+            fun containerReferenceEnvironment(containerId: String) =
+                environment(ContainerReference.builder().containerId(containerId).build())
+
+            /** The status of the shell call. One of `in_progress`, `completed`, or `incomplete`. */
             fun status(status: Status?) = status(JsonField.ofNullable(status))
 
             /** Alias for calling [Builder.status] with `status.orElse(null)`. */
@@ -8051,25 +7573,26 @@ private constructor(
             }
 
             /**
-             * Returns an immutable instance of [ShellCallOutput].
+             * Returns an immutable instance of [ShellCall].
              *
              * Further updates to this [Builder] will not mutate the returned instance.
              *
              * The following fields are required:
              * ```java
+             * .action()
              * .callId()
-             * .output()
              * ```
              *
              * @throws IllegalStateException if any required field is unset.
              */
-            fun build(): ShellCallOutput =
-                ShellCallOutput(
+            fun build(): ShellCall =
+                ShellCall(
+                    checkRequired("action", action),
                     checkRequired("callId", callId),
-                    checkRequired("output", output).map { it.toImmutable() },
                     type,
                     id,
-                    maxOutputLength,
+                    caller,
+                    environment,
                     status,
                     additionalProperties.toMutableMap(),
                 )
@@ -8086,20 +7609,21 @@ private constructor(
          * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
          *   expected type.
          */
-        fun validate(): ShellCallOutput = apply {
+        fun validate(): ShellCall = apply {
             if (validated) {
                 return@apply
             }
 
+            action().validate()
             callId()
-            output().forEach { it.validate() }
             _type().let {
-                if (it != JsonValue.from("shell_call_output")) {
+                if (it != JsonValue.from("shell_call")) {
                     throw OpenAIInvalidDataException("'type' is invalid, received $it")
                 }
             }
             id()
-            maxOutputLength()
+            caller().ifPresent { it.validate() }
+            environment().ifPresent { it.validate() }
             status().ifPresent { it.validate() }
             validated = true
         }
@@ -8120,14 +7644,3593 @@ private constructor(
          */
         @JvmSynthetic
         internal fun validity(): Int =
-            (if (callId.asKnown().isPresent) 1 else 0) +
-                (output.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
-                type.let { if (it == JsonValue.from("shell_call_output")) 1 else 0 } +
+            (action.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("shell_call")) 1 else 0 } +
                 (if (id.asKnown().isPresent) 1 else 0) +
-                (if (maxOutputLength.asKnown().isPresent) 1 else 0) +
+                (caller.asKnown().getOrNull()?.validity() ?: 0) +
+                (environment.asKnown().getOrNull()?.validity() ?: 0) +
                 (status.asKnown().getOrNull()?.validity() ?: 0)
 
-        /** The status of the shell call output. */
+        /** The shell commands and limits that describe how to run the tool call. */
+        class Action
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val commands: JsonField<List<String>>,
+            private val maxOutputLength: JsonField<Long>,
+            private val timeoutMs: JsonField<Long>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("commands")
+                @ExcludeMissing
+                commands: JsonField<List<String>> = JsonMissing.of(),
+                @JsonProperty("max_output_length")
+                @ExcludeMissing
+                maxOutputLength: JsonField<Long> = JsonMissing.of(),
+                @JsonProperty("timeout_ms")
+                @ExcludeMissing
+                timeoutMs: JsonField<Long> = JsonMissing.of(),
+            ) : this(commands, maxOutputLength, timeoutMs, mutableMapOf())
+
+            /**
+             * Ordered shell commands for the execution environment to run.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun commands(): List<String> = commands.getRequired("commands")
+
+            /**
+             * Maximum number of UTF-8 characters to capture from combined stdout and stderr output.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun maxOutputLength(): Optional<Long> = maxOutputLength.getOptional("max_output_length")
+
+            /**
+             * Maximum wall-clock time in milliseconds to allow the shell commands to run.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun timeoutMs(): Optional<Long> = timeoutMs.getOptional("timeout_ms")
+
+            /**
+             * Returns the raw JSON value of [commands].
+             *
+             * Unlike [commands], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("commands")
+            @ExcludeMissing
+            fun _commands(): JsonField<List<String>> = commands
+
+            /**
+             * Returns the raw JSON value of [maxOutputLength].
+             *
+             * Unlike [maxOutputLength], this method doesn't throw if the JSON field has an
+             * unexpected type.
+             */
+            @JsonProperty("max_output_length")
+            @ExcludeMissing
+            fun _maxOutputLength(): JsonField<Long> = maxOutputLength
+
+            /**
+             * Returns the raw JSON value of [timeoutMs].
+             *
+             * Unlike [timeoutMs], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("timeout_ms")
+            @ExcludeMissing
+            fun _timeoutMs(): JsonField<Long> = timeoutMs
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
+            }
+
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
+
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Action].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .commands()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
+            }
+
+            /** A builder for [Action]. */
+            class Builder internal constructor() {
+
+                private var commands: JsonField<MutableList<String>>? = null
+                private var maxOutputLength: JsonField<Long> = JsonMissing.of()
+                private var timeoutMs: JsonField<Long> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                @JvmSynthetic
+                internal fun from(action: Action) = apply {
+                    commands = action.commands.map { it.toMutableList() }
+                    maxOutputLength = action.maxOutputLength
+                    timeoutMs = action.timeoutMs
+                    additionalProperties = action.additionalProperties.toMutableMap()
+                }
+
+                /** Ordered shell commands for the execution environment to run. */
+                fun commands(commands: List<String>) = commands(JsonField.of(commands))
+
+                /**
+                 * Sets [Builder.commands] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.commands] with a well-typed `List<String>` value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun commands(commands: JsonField<List<String>>) = apply {
+                    this.commands = commands.map { it.toMutableList() }
+                }
+
+                /**
+                 * Adds a single [String] to [commands].
+                 *
+                 * @throws IllegalStateException if the field was previously set to a non-list.
+                 */
+                fun addCommand(command: String) = apply {
+                    commands =
+                        (commands ?: JsonField.of(mutableListOf())).also {
+                            checkKnown("commands", it).add(command)
+                        }
+                }
+
+                /**
+                 * Maximum number of UTF-8 characters to capture from combined stdout and stderr
+                 * output.
+                 */
+                fun maxOutputLength(maxOutputLength: Long?) =
+                    maxOutputLength(JsonField.ofNullable(maxOutputLength))
+
+                /**
+                 * Alias for [Builder.maxOutputLength].
+                 *
+                 * This unboxed primitive overload exists for backwards compatibility.
+                 */
+                fun maxOutputLength(maxOutputLength: Long) =
+                    maxOutputLength(maxOutputLength as Long?)
+
+                /**
+                 * Alias for calling [Builder.maxOutputLength] with `maxOutputLength.orElse(null)`.
+                 */
+                fun maxOutputLength(maxOutputLength: Optional<Long>) =
+                    maxOutputLength(maxOutputLength.getOrNull())
+
+                /**
+                 * Sets [Builder.maxOutputLength] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.maxOutputLength] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun maxOutputLength(maxOutputLength: JsonField<Long>) = apply {
+                    this.maxOutputLength = maxOutputLength
+                }
+
+                /** Maximum wall-clock time in milliseconds to allow the shell commands to run. */
+                fun timeoutMs(timeoutMs: Long?) = timeoutMs(JsonField.ofNullable(timeoutMs))
+
+                /**
+                 * Alias for [Builder.timeoutMs].
+                 *
+                 * This unboxed primitive overload exists for backwards compatibility.
+                 */
+                fun timeoutMs(timeoutMs: Long) = timeoutMs(timeoutMs as Long?)
+
+                /** Alias for calling [Builder.timeoutMs] with `timeoutMs.orElse(null)`. */
+                fun timeoutMs(timeoutMs: Optional<Long>) = timeoutMs(timeoutMs.getOrNull())
+
+                /**
+                 * Sets [Builder.timeoutMs] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.timeoutMs] with a well-typed [Long] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun timeoutMs(timeoutMs: JsonField<Long>) = apply { this.timeoutMs = timeoutMs }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
+
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
+
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Action].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .commands()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Action =
+                    Action(
+                        checkRequired("commands", commands).map { it.toImmutable() },
+                        maxOutputLength,
+                        timeoutMs,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Action = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                commands()
+                maxOutputLength()
+                timeoutMs()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (commands.asKnown().getOrNull()?.size ?: 0) +
+                    (if (maxOutputLength.asKnown().isPresent) 1 else 0) +
+                    (if (timeoutMs.asKnown().isPresent) 1 else 0)
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Action &&
+                    commands == other.commands &&
+                    maxOutputLength == other.maxOutputLength &&
+                    timeoutMs == other.timeoutMs &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy {
+                Objects.hash(commands, maxOutputLength, timeoutMs, additionalProperties)
+            }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Action{commands=$commands, maxOutputLength=$maxOutputLength, timeoutMs=$timeoutMs, additionalProperties=$additionalProperties}"
+        }
+
+        /** The execution context that produced this tool call. */
+        @JsonDeserialize(using = Caller.Deserializer::class)
+        @JsonSerialize(using = Caller.Serializer::class)
+        class Caller
+        private constructor(
+            private val direct: JsonValue? = null,
+            private val program: Program? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+            fun program(): Optional<Program> = Optional.ofNullable(program)
+
+            fun isDirect(): Boolean = direct != null
+
+            fun isProgram(): Boolean = program != null
+
+            fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+            fun asProgram(): Program = program.getOrThrow("program")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitDirect(JsonValue direct) {
+             *         return Optional.of(direct.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    direct != null -> visitor.visitDirect(direct)
+                    program != null -> visitor.visitProgram(program)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Caller = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitDirect(direct: JsonValue) {
+                            direct.let {
+                                if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                    throw OpenAIInvalidDataException(
+                                        "'direct' is invalid, received $it"
+                                    )
+                                }
+                            }
+                        }
+
+                        override fun visitProgram(program: Program) {
+                            program.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitDirect(direct: JsonValue) =
+                            direct.let {
+                                if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0
+                            }
+
+                        override fun visitProgram(program: Program) = program.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Caller && direct == other.direct && program == other.program
+            }
+
+            override fun hashCode(): Int = Objects.hash(direct, program)
+
+            override fun toString(): String =
+                when {
+                    direct != null -> "Caller{direct=$direct}"
+                    program != null -> "Caller{program=$program}"
+                    _json != null -> "Caller{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+
+            companion object {
+
+                @JvmStatic
+                fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+                @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Caller] to a value of type [T].
+             */
+            interface Visitor<out T> {
+
+                fun visitDirect(direct: JsonValue): T
+
+                fun visitProgram(program: Program): T
+
+                /**
+                 * Maps an unknown variant of [Caller] to a value of type [T].
+                 *
+                 * An instance of [Caller] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Caller: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "direct" -> {
+                            return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let { Caller(direct = it, _json = json) }
+                                ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                        }
+                        "program" -> {
+                            return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                                Caller(program = it, _json = json)
+                            } ?: Caller(_json = json)
+                        }
+                    }
+
+                    return Caller(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+                override fun serialize(
+                    value: Caller,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.direct != null -> generator.writeObject(value.direct)
+                        value.program != null -> generator.writeObject(value.program)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Caller")
+                    }
+                }
+            }
+
+            class Program
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val callerId: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("caller_id")
+                    @ExcludeMissing
+                    callerId: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(callerId, type, mutableMapOf())
+
+                /**
+                 * The call ID of the program item that produced this tool call.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun callerId(): String = callerId.getRequired("caller_id")
+
+                /**
+                 * The caller type. Always `program`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [callerId].
+                 *
+                 * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                fun _callerId(): JsonField<String> = callerId
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Program].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Program]. */
+                class Builder internal constructor() {
+
+                    private var callerId: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("program")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(program: Program) = apply {
+                        callerId = program.callerId
+                        type = program.type
+                        additionalProperties = program.additionalProperties.toMutableMap()
+                    }
+
+                    /** The call ID of the program item that produced this tool call. */
+                    fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                    /**
+                     * Sets [Builder.callerId] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.callerId] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("program")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Program].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Program =
+                        Program(
+                            checkRequired("callerId", callerId),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Program = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    callerId()
+                    _type().let {
+                        if (it != JsonValue.from("program")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (callerId.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Program &&
+                        callerId == other.callerId &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(callerId, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        /** The environment to execute the shell commands in. */
+        @JsonDeserialize(using = Environment.Deserializer::class)
+        @JsonSerialize(using = Environment.Serializer::class)
+        class Environment
+        private constructor(
+            private val local: LocalEnvironment? = null,
+            private val containerReference: ContainerReference? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            fun local(): Optional<LocalEnvironment> = Optional.ofNullable(local)
+
+            fun containerReference(): Optional<ContainerReference> =
+                Optional.ofNullable(containerReference)
+
+            fun isLocal(): Boolean = local != null
+
+            fun isContainerReference(): Boolean = containerReference != null
+
+            fun asLocal(): LocalEnvironment = local.getOrThrow("local")
+
+            fun asContainerReference(): ContainerReference =
+                containerReference.getOrThrow("containerReference")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = environment.accept(new Environment.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitLocal(LocalEnvironment local) {
+             *         return Optional.of(local.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    local != null -> visitor.visitLocal(local)
+                    containerReference != null ->
+                        visitor.visitContainerReference(containerReference)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Environment = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitLocal(local: LocalEnvironment) {
+                            local.validate()
+                        }
+
+                        override fun visitContainerReference(
+                            containerReference: ContainerReference
+                        ) {
+                            containerReference.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitLocal(local: LocalEnvironment) = local.validity()
+
+                        override fun visitContainerReference(
+                            containerReference: ContainerReference
+                        ) = containerReference.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Environment &&
+                    local == other.local &&
+                    containerReference == other.containerReference
+            }
+
+            override fun hashCode(): Int = Objects.hash(local, containerReference)
+
+            override fun toString(): String =
+                when {
+                    local != null -> "Environment{local=$local}"
+                    containerReference != null ->
+                        "Environment{containerReference=$containerReference}"
+                    _json != null -> "Environment{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Environment")
+                }
+
+            companion object {
+
+                @JvmStatic fun ofLocal(local: LocalEnvironment) = Environment(local = local)
+
+                @JvmStatic
+                fun ofContainerReference(containerReference: ContainerReference) =
+                    Environment(containerReference = containerReference)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Environment] to a value of type
+             * [T].
+             */
+            interface Visitor<out T> {
+
+                fun visitLocal(local: LocalEnvironment): T
+
+                fun visitContainerReference(containerReference: ContainerReference): T
+
+                /**
+                 * Maps an unknown variant of [Environment] to a value of type [T].
+                 *
+                 * An instance of [Environment] can contain an unknown variant if it was
+                 * deserialized from data that doesn't match any known variant. For example, if the
+                 * SDK is on an older version than the API, then the API may respond with new
+                 * variants that the SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Environment: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Environment>(Environment::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Environment {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "local" -> {
+                            return tryDeserialize(node, jacksonTypeRef<LocalEnvironment>())?.let {
+                                Environment(local = it, _json = json)
+                            } ?: Environment(_json = json)
+                        }
+                        "container_reference" -> {
+                            return tryDeserialize(node, jacksonTypeRef<ContainerReference>())?.let {
+                                Environment(containerReference = it, _json = json)
+                            } ?: Environment(_json = json)
+                        }
+                    }
+
+                    return Environment(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Environment>(Environment::class) {
+
+                override fun serialize(
+                    value: Environment,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.local != null -> generator.writeObject(value.local)
+                        value.containerReference != null ->
+                            generator.writeObject(value.containerReference)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Environment")
+                    }
+                }
+            }
+        }
+
+        /** The status of the shell call. One of `in_progress`, `completed`, or `incomplete`. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ShellCall &&
+                action == other.action &&
+                callId == other.callId &&
+                type == other.type &&
+                id == other.id &&
+                caller == other.caller &&
+                environment == other.environment &&
+                status == other.status &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                action,
+                callId,
+                type,
+                id,
+                caller,
+                environment,
+                status,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ShellCall{action=$action, callId=$callId, type=$type, id=$id, caller=$caller, environment=$environment, status=$status, additionalProperties=$additionalProperties}"
+    }
+
+    /** The streamed output items emitted by a shell tool call. */
+    class ShellCallOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val callId: JsonField<String>,
+        private val output: JsonField<List<ResponseFunctionShellCallOutputContent>>,
+        private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val caller: JsonField<Caller>,
+        private val maxOutputLength: JsonField<Long>,
+        private val status: JsonField<Status>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("output")
+            @ExcludeMissing
+            output: JsonField<List<ResponseFunctionShellCallOutputContent>> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+            @JsonProperty("max_output_length")
+            @ExcludeMissing
+            maxOutputLength: JsonField<Long> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        ) : this(callId, output, type, id, caller, maxOutputLength, status, mutableMapOf())
+
+        /**
+         * The unique ID of the shell tool call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * Captured chunks of stdout and stderr output, along with their associated outcomes.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun output(): List<ResponseFunctionShellCallOutputContent> = output.getRequired("output")
+
+        /**
+         * The type of the item. Always `shell_call_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("shell_call_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The unique ID of the shell tool call output. Populated when this item is returned via
+         * API.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun id(): Optional<String> = id.getOptional("id")
+
+        /**
+         * The execution context that produced this tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun caller(): Optional<Caller> = caller.getOptional("caller")
+
+        /**
+         * The maximum number of UTF-8 characters captured for this shell call's combined output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun maxOutputLength(): Optional<Long> = maxOutputLength.getOptional("max_output_length")
+
+        /**
+         * The status of the shell call output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun status(): Optional<Status> = status.getOptional("status")
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output")
+        @ExcludeMissing
+        fun _output(): JsonField<List<ResponseFunctionShellCallOutputContent>> = output
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [caller].
+         *
+         * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
+        /**
+         * Returns the raw JSON value of [maxOutputLength].
+         *
+         * Unlike [maxOutputLength], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("max_output_length")
+        @ExcludeMissing
+        fun _maxOutputLength(): JsonField<Long> = maxOutputLength
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ShellCallOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .callId()
+             * .output()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ShellCallOutput]. */
+        class Builder internal constructor() {
+
+            private var callId: JsonField<String>? = null
+            private var output: JsonField<MutableList<ResponseFunctionShellCallOutputContent>>? =
+                null
+            private var type: JsonValue = JsonValue.from("shell_call_output")
+            private var id: JsonField<String> = JsonMissing.of()
+            private var caller: JsonField<Caller> = JsonMissing.of()
+            private var maxOutputLength: JsonField<Long> = JsonMissing.of()
+            private var status: JsonField<Status> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(shellCallOutput: ShellCallOutput) = apply {
+                callId = shellCallOutput.callId
+                output = shellCallOutput.output.map { it.toMutableList() }
+                type = shellCallOutput.type
+                id = shellCallOutput.id
+                caller = shellCallOutput.caller
+                maxOutputLength = shellCallOutput.maxOutputLength
+                status = shellCallOutput.status
+                additionalProperties = shellCallOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the shell tool call generated by the model. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /**
+             * Captured chunks of stdout and stderr output, along with their associated outcomes.
+             */
+            fun output(output: List<ResponseFunctionShellCallOutputContent>) =
+                output(JsonField.of(output))
+
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed
+             * `List<ResponseFunctionShellCallOutputContent>` value instead. This method is
+             * primarily for setting the field to an undocumented or not yet supported value.
+             */
+            fun output(output: JsonField<List<ResponseFunctionShellCallOutputContent>>) = apply {
+                this.output = output.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [ResponseFunctionShellCallOutputContent] to [Builder.output].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addOutput(output: ResponseFunctionShellCallOutputContent) = apply {
+                this.output =
+                    (this.output ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("output", it).add(output)
+                    }
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("shell_call_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /**
+             * The unique ID of the shell tool call output. Populated when this item is returned via
+             * API.
+             */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The execution context that produced this tool call. */
+            fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+            /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+            fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+            /**
+             * Sets [Builder.caller] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.caller] with a well-typed [Caller] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+            /** Alias for calling [caller] with `Caller.ofDirect()`. */
+            fun callerDirect() = caller(Caller.ofDirect())
+
+            /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+            fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+            /**
+             * Alias for calling [caller] with the following:
+             * ```java
+             * Caller.Program.builder()
+             *     .callerId(callerId)
+             *     .build()
+             * ```
+             */
+            fun programCaller(callerId: String) =
+                caller(Caller.Program.builder().callerId(callerId).build())
+
+            /**
+             * The maximum number of UTF-8 characters captured for this shell call's combined
+             * output.
+             */
+            fun maxOutputLength(maxOutputLength: Long?) =
+                maxOutputLength(JsonField.ofNullable(maxOutputLength))
+
+            /**
+             * Alias for [Builder.maxOutputLength].
+             *
+             * This unboxed primitive overload exists for backwards compatibility.
+             */
+            fun maxOutputLength(maxOutputLength: Long) = maxOutputLength(maxOutputLength as Long?)
+
+            /** Alias for calling [Builder.maxOutputLength] with `maxOutputLength.orElse(null)`. */
+            fun maxOutputLength(maxOutputLength: Optional<Long>) =
+                maxOutputLength(maxOutputLength.getOrNull())
+
+            /**
+             * Sets [Builder.maxOutputLength] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.maxOutputLength] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun maxOutputLength(maxOutputLength: JsonField<Long>) = apply {
+                this.maxOutputLength = maxOutputLength
+            }
+
+            /** The status of the shell call output. */
+            fun status(status: Status?) = status(JsonField.ofNullable(status))
+
+            /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+            fun status(status: Optional<Status>) = status(status.getOrNull())
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ShellCallOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .callId()
+             * .output()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ShellCallOutput =
+                ShellCallOutput(
+                    checkRequired("callId", callId),
+                    checkRequired("output", output).map { it.toImmutable() },
+                    type,
+                    id,
+                    caller,
+                    maxOutputLength,
+                    status,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ShellCallOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            callId()
+            output().forEach { it.validate() }
+            _type().let {
+                if (it != JsonValue.from("shell_call_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            id()
+            caller().ifPresent { it.validate() }
+            maxOutputLength()
+            status().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (callId.asKnown().isPresent) 1 else 0) +
+                (output.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                type.let { if (it == JsonValue.from("shell_call_output")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (caller.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (maxOutputLength.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The execution context that produced this tool call. */
+        @JsonDeserialize(using = Caller.Deserializer::class)
+        @JsonSerialize(using = Caller.Serializer::class)
+        class Caller
+        private constructor(
+            private val direct: JsonValue? = null,
+            private val program: Program? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
+
+            fun program(): Optional<Program> = Optional.ofNullable(program)
+
+            fun isDirect(): Boolean = direct != null
+
+            fun isProgram(): Boolean = program != null
+
+            fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+            fun asProgram(): Program = program.getOrThrow("program")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitDirect(JsonValue direct) {
+             *         return Optional.of(direct.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    direct != null -> visitor.visitDirect(direct)
+                    program != null -> visitor.visitProgram(program)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Caller = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitDirect(direct: JsonValue) {
+                            direct.let {
+                                if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                    throw OpenAIInvalidDataException(
+                                        "'direct' is invalid, received $it"
+                                    )
+                                }
+                            }
+                        }
+
+                        override fun visitProgram(program: Program) {
+                            program.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitDirect(direct: JsonValue) =
+                            direct.let {
+                                if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0
+                            }
+
+                        override fun visitProgram(program: Program) = program.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Caller && direct == other.direct && program == other.program
+            }
+
+            override fun hashCode(): Int = Objects.hash(direct, program)
+
+            override fun toString(): String =
+                when {
+                    direct != null -> "Caller{direct=$direct}"
+                    program != null -> "Caller{program=$program}"
+                    _json != null -> "Caller{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+
+            companion object {
+
+                @JvmStatic
+                fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+                @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Caller] to a value of type [T].
+             */
+            interface Visitor<out T> {
+
+                fun visitDirect(direct: JsonValue): T
+
+                fun visitProgram(program: Program): T
+
+                /**
+                 * Maps an unknown variant of [Caller] to a value of type [T].
+                 *
+                 * An instance of [Caller] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Caller: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "direct" -> {
+                            return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let { Caller(direct = it, _json = json) }
+                                ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                        }
+                        "program" -> {
+                            return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                                Caller(program = it, _json = json)
+                            } ?: Caller(_json = json)
+                        }
+                    }
+
+                    return Caller(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Caller>(Caller::class) {
+
+                override fun serialize(
+                    value: Caller,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.direct != null -> generator.writeObject(value.direct)
+                        value.program != null -> generator.writeObject(value.program)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Caller")
+                    }
+                }
+            }
+
+            class Program
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val callerId: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("caller_id")
+                    @ExcludeMissing
+                    callerId: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(callerId, type, mutableMapOf())
+
+                /**
+                 * The call ID of the program item that produced this tool call.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun callerId(): String = callerId.getRequired("caller_id")
+
+                /**
+                 * The caller type. Always `program`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [callerId].
+                 *
+                 * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                fun _callerId(): JsonField<String> = callerId
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Program].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Program]. */
+                class Builder internal constructor() {
+
+                    private var callerId: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("program")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(program: Program) = apply {
+                        callerId = program.callerId
+                        type = program.type
+                        additionalProperties = program.additionalProperties.toMutableMap()
+                    }
+
+                    /** The call ID of the program item that produced this tool call. */
+                    fun callerId(callerId: String) = callerId(JsonField.of(callerId))
+
+                    /**
+                     * Sets [Builder.callerId] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.callerId] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("program")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Program].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Program =
+                        Program(
+                            checkRequired("callerId", callerId),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Program = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    callerId()
+                    _type().let {
+                        if (it != JsonValue.from("program")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (callerId.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Program &&
+                        callerId == other.callerId &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(callerId, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        /** The status of the shell call output. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ShellCallOutput &&
+                callId == other.callId &&
+                output == other.output &&
+                type == other.type &&
+                id == other.id &&
+                caller == other.caller &&
+                maxOutputLength == other.maxOutputLength &&
+                status == other.status &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                callId,
+                output,
+                type,
+                id,
+                caller,
+                maxOutputLength,
+                status,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ShellCallOutput{callId=$callId, output=$output, type=$type, id=$id, caller=$caller, maxOutputLength=$maxOutputLength, status=$status, additionalProperties=$additionalProperties}"
+    }
+
+    /** A tool call representing a request to create, delete, or update files using diff patches. */
+    class ApplyPatchCall
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val callId: JsonField<String>,
+        private val operation: JsonField<Operation>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val caller: JsonField<Caller>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("operation")
+            @ExcludeMissing
+            operation: JsonField<Operation> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+        ) : this(callId, operation, status, type, id, caller, mutableMapOf())
+
+        /**
+         * The unique ID of the apply patch tool call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The specific create, delete, or update instruction for the apply_patch tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun operation(): Operation = operation.getRequired("operation")
+
+        /**
+         * The status of the apply patch tool call. One of `in_progress` or `completed`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The type of the item. Always `apply_patch_call`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("apply_patch_call")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * The unique ID of the apply patch tool call. Populated when this item is returned via API.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun id(): Optional<String> = id.getOptional("id")
+
+        /**
+         * The execution context that produced this tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun caller(): Optional<Caller> = caller.getOptional("caller")
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [operation].
+         *
+         * Unlike [operation], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("operation")
+        @ExcludeMissing
+        fun _operation(): JsonField<Operation> = operation
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [caller].
+         *
+         * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ApplyPatchCall].
+             *
+             * The following fields are required:
+             * ```java
+             * .callId()
+             * .operation()
+             * .status()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ApplyPatchCall]. */
+        class Builder internal constructor() {
+
+            private var callId: JsonField<String>? = null
+            private var operation: JsonField<Operation>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("apply_patch_call")
+            private var id: JsonField<String> = JsonMissing.of()
+            private var caller: JsonField<Caller> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(applyPatchCall: ApplyPatchCall) = apply {
+                callId = applyPatchCall.callId
+                operation = applyPatchCall.operation
+                status = applyPatchCall.status
+                type = applyPatchCall.type
+                id = applyPatchCall.id
+                caller = applyPatchCall.caller
+                additionalProperties = applyPatchCall.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the apply patch tool call generated by the model. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The specific create, delete, or update instruction for the apply_patch tool call. */
+            fun operation(operation: Operation) = operation(JsonField.of(operation))
+
+            /**
+             * Sets [Builder.operation] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.operation] with a well-typed [Operation] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun operation(operation: JsonField<Operation>) = apply { this.operation = operation }
+
+            /** Alias for calling [operation] with `Operation.ofCreateFile(createFile)`. */
+            fun operation(createFile: Operation.CreateFile) =
+                operation(Operation.ofCreateFile(createFile))
+
+            /** Alias for calling [operation] with `Operation.ofDeleteFile(deleteFile)`. */
+            fun operation(deleteFile: Operation.DeleteFile) =
+                operation(Operation.ofDeleteFile(deleteFile))
+
+            /**
+             * Alias for calling [operation] with the following:
+             * ```java
+             * Operation.DeleteFile.builder()
+             *     .path(path)
+             *     .build()
+             * ```
+             */
+            fun deleteFileOperation(path: String) =
+                operation(Operation.DeleteFile.builder().path(path).build())
+
+            /** Alias for calling [operation] with `Operation.ofUpdateFile(updateFile)`. */
+            fun operation(updateFile: Operation.UpdateFile) =
+                operation(Operation.ofUpdateFile(updateFile))
+
+            /** The status of the apply patch tool call. One of `in_progress` or `completed`. */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("apply_patch_call")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /**
+             * The unique ID of the apply patch tool call. Populated when this item is returned via
+             * API.
+             */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The execution context that produced this tool call. */
+            fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
+
+            /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+            fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
+
+            /**
+             * Sets [Builder.caller] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.caller] with a well-typed [Caller] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
+
+            /** Alias for calling [caller] with `Caller.ofDirect()`. */
+            fun callerDirect() = caller(Caller.ofDirect())
+
+            /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+            fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
+
+            /**
+             * Alias for calling [caller] with the following:
+             * ```java
+             * Caller.Program.builder()
+             *     .callerId(callerId)
+             *     .build()
+             * ```
+             */
+            fun programCaller(callerId: String) =
+                caller(Caller.Program.builder().callerId(callerId).build())
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ApplyPatchCall].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .callId()
+             * .operation()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ApplyPatchCall =
+                ApplyPatchCall(
+                    checkRequired("callId", callId),
+                    checkRequired("operation", operation),
+                    checkRequired("status", status),
+                    type,
+                    id,
+                    caller,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ApplyPatchCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            callId()
+            operation().validate()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("apply_patch_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            id()
+            caller().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (callId.asKnown().isPresent) 1 else 0) +
+                (operation.asKnown().getOrNull()?.validity() ?: 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("apply_patch_call")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (caller.asKnown().getOrNull()?.validity() ?: 0)
+
+        /** The specific create, delete, or update instruction for the apply_patch tool call. */
+        @JsonDeserialize(using = Operation.Deserializer::class)
+        @JsonSerialize(using = Operation.Serializer::class)
+        class Operation
+        private constructor(
+            private val createFile: CreateFile? = null,
+            private val deleteFile: DeleteFile? = null,
+            private val updateFile: UpdateFile? = null,
+            private val _json: JsonValue? = null,
+        ) {
+
+            /** Instruction for creating a new file via the apply_patch tool. */
+            fun createFile(): Optional<CreateFile> = Optional.ofNullable(createFile)
+
+            /** Instruction for deleting an existing file via the apply_patch tool. */
+            fun deleteFile(): Optional<DeleteFile> = Optional.ofNullable(deleteFile)
+
+            /** Instruction for updating an existing file via the apply_patch tool. */
+            fun updateFile(): Optional<UpdateFile> = Optional.ofNullable(updateFile)
+
+            fun isCreateFile(): Boolean = createFile != null
+
+            fun isDeleteFile(): Boolean = deleteFile != null
+
+            fun isUpdateFile(): Boolean = updateFile != null
+
+            /** Instruction for creating a new file via the apply_patch tool. */
+            fun asCreateFile(): CreateFile = createFile.getOrThrow("createFile")
+
+            /** Instruction for deleting an existing file via the apply_patch tool. */
+            fun asDeleteFile(): DeleteFile = deleteFile.getOrThrow("deleteFile")
+
+            /** Instruction for updating an existing file via the apply_patch tool. */
+            fun asUpdateFile(): UpdateFile = updateFile.getOrThrow("updateFile")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = operation.accept(new Operation.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitCreateFile(CreateFile createFile) {
+             *         return Optional.of(createFile.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    createFile != null -> visitor.visitCreateFile(createFile)
+                    deleteFile != null -> visitor.visitDeleteFile(deleteFile)
+                    updateFile != null -> visitor.visitUpdateFile(updateFile)
+                    else -> visitor.unknown(_json)
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Operation = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitCreateFile(createFile: CreateFile) {
+                            createFile.validate()
+                        }
+
+                        override fun visitDeleteFile(deleteFile: DeleteFile) {
+                            deleteFile.validate()
+                        }
+
+                        override fun visitUpdateFile(updateFile: UpdateFile) {
+                            updateFile.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitCreateFile(createFile: CreateFile) = createFile.validity()
+
+                        override fun visitDeleteFile(deleteFile: DeleteFile) = deleteFile.validity()
+
+                        override fun visitUpdateFile(updateFile: UpdateFile) = updateFile.validity()
+
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Operation &&
+                    createFile == other.createFile &&
+                    deleteFile == other.deleteFile &&
+                    updateFile == other.updateFile
+            }
+
+            override fun hashCode(): Int = Objects.hash(createFile, deleteFile, updateFile)
+
+            override fun toString(): String =
+                when {
+                    createFile != null -> "Operation{createFile=$createFile}"
+                    deleteFile != null -> "Operation{deleteFile=$deleteFile}"
+                    updateFile != null -> "Operation{updateFile=$updateFile}"
+                    _json != null -> "Operation{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Operation")
+                }
+
+            companion object {
+
+                /** Instruction for creating a new file via the apply_patch tool. */
+                @JvmStatic
+                fun ofCreateFile(createFile: CreateFile) = Operation(createFile = createFile)
+
+                /** Instruction for deleting an existing file via the apply_patch tool. */
+                @JvmStatic
+                fun ofDeleteFile(deleteFile: DeleteFile) = Operation(deleteFile = deleteFile)
+
+                /** Instruction for updating an existing file via the apply_patch tool. */
+                @JvmStatic
+                fun ofUpdateFile(updateFile: UpdateFile) = Operation(updateFile = updateFile)
+            }
+
+            /**
+             * An interface that defines how to map each variant of [Operation] to a value of type
+             * [T].
+             */
+            interface Visitor<out T> {
+
+                /** Instruction for creating a new file via the apply_patch tool. */
+                fun visitCreateFile(createFile: CreateFile): T
+
+                /** Instruction for deleting an existing file via the apply_patch tool. */
+                fun visitDeleteFile(deleteFile: DeleteFile): T
+
+                /** Instruction for updating an existing file via the apply_patch tool. */
+                fun visitUpdateFile(updateFile: UpdateFile): T
+
+                /**
+                 * Maps an unknown variant of [Operation] to a value of type [T].
+                 *
+                 * An instance of [Operation] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Operation: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Operation>(Operation::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Operation {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "create_file" -> {
+                            return tryDeserialize(node, jacksonTypeRef<CreateFile>())?.let {
+                                Operation(createFile = it, _json = json)
+                            } ?: Operation(_json = json)
+                        }
+                        "delete_file" -> {
+                            return tryDeserialize(node, jacksonTypeRef<DeleteFile>())?.let {
+                                Operation(deleteFile = it, _json = json)
+                            } ?: Operation(_json = json)
+                        }
+                        "update_file" -> {
+                            return tryDeserialize(node, jacksonTypeRef<UpdateFile>())?.let {
+                                Operation(updateFile = it, _json = json)
+                            } ?: Operation(_json = json)
+                        }
+                    }
+
+                    return Operation(_json = json)
+                }
+            }
+
+            internal class Serializer : BaseSerializer<Operation>(Operation::class) {
+
+                override fun serialize(
+                    value: Operation,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.createFile != null -> generator.writeObject(value.createFile)
+                        value.deleteFile != null -> generator.writeObject(value.deleteFile)
+                        value.updateFile != null -> generator.writeObject(value.updateFile)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Operation")
+                    }
+                }
+            }
+
+            /** Instruction for creating a new file via the apply_patch tool. */
+            class CreateFile
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val diff: JsonField<String>,
+                private val path: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("diff")
+                    @ExcludeMissing
+                    diff: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("path")
+                    @ExcludeMissing
+                    path: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(diff, path, type, mutableMapOf())
+
+                /**
+                 * Unified diff content to apply when creating the file.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun diff(): String = diff.getRequired("diff")
+
+                /**
+                 * Path of the file to create relative to the workspace root.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun path(): String = path.getRequired("path")
+
+                /**
+                 * The operation type. Always `create_file`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("create_file")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [diff].
+                 *
+                 * Unlike [diff], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("diff") @ExcludeMissing fun _diff(): JsonField<String> = diff
+
+                /**
+                 * Returns the raw JSON value of [path].
+                 *
+                 * Unlike [path], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("path") @ExcludeMissing fun _path(): JsonField<String> = path
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [CreateFile].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .diff()
+                     * .path()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [CreateFile]. */
+                class Builder internal constructor() {
+
+                    private var diff: JsonField<String>? = null
+                    private var path: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("create_file")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(createFile: CreateFile) = apply {
+                        diff = createFile.diff
+                        path = createFile.path
+                        type = createFile.type
+                        additionalProperties = createFile.additionalProperties.toMutableMap()
+                    }
+
+                    /** Unified diff content to apply when creating the file. */
+                    fun diff(diff: String) = diff(JsonField.of(diff))
+
+                    /**
+                     * Sets [Builder.diff] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.diff] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun diff(diff: JsonField<String>) = apply { this.diff = diff }
+
+                    /** Path of the file to create relative to the workspace root. */
+                    fun path(path: String) = path(JsonField.of(path))
+
+                    /**
+                     * Sets [Builder.path] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.path] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun path(path: JsonField<String>) = apply { this.path = path }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("create_file")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [CreateFile].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .diff()
+                     * .path()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): CreateFile =
+                        CreateFile(
+                            checkRequired("diff", diff),
+                            checkRequired("path", path),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): CreateFile = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    diff()
+                    path()
+                    _type().let {
+                        if (it != JsonValue.from("create_file")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (diff.asKnown().isPresent) 1 else 0) +
+                        (if (path.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("create_file")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is CreateFile &&
+                        diff == other.diff &&
+                        path == other.path &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(diff, path, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "CreateFile{diff=$diff, path=$path, type=$type, additionalProperties=$additionalProperties}"
+            }
+
+            /** Instruction for deleting an existing file via the apply_patch tool. */
+            class DeleteFile
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val path: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("path")
+                    @ExcludeMissing
+                    path: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(path, type, mutableMapOf())
+
+                /**
+                 * Path of the file to delete relative to the workspace root.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun path(): String = path.getRequired("path")
+
+                /**
+                 * The operation type. Always `delete_file`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("delete_file")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [path].
+                 *
+                 * Unlike [path], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("path") @ExcludeMissing fun _path(): JsonField<String> = path
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [DeleteFile].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .path()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [DeleteFile]. */
+                class Builder internal constructor() {
+
+                    private var path: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("delete_file")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(deleteFile: DeleteFile) = apply {
+                        path = deleteFile.path
+                        type = deleteFile.type
+                        additionalProperties = deleteFile.additionalProperties.toMutableMap()
+                    }
+
+                    /** Path of the file to delete relative to the workspace root. */
+                    fun path(path: String) = path(JsonField.of(path))
+
+                    /**
+                     * Sets [Builder.path] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.path] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun path(path: JsonField<String>) = apply { this.path = path }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("delete_file")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [DeleteFile].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .path()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): DeleteFile =
+                        DeleteFile(
+                            checkRequired("path", path),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): DeleteFile = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    path()
+                    _type().let {
+                        if (it != JsonValue.from("delete_file")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (path.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("delete_file")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is DeleteFile &&
+                        path == other.path &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(path, type, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "DeleteFile{path=$path, type=$type, additionalProperties=$additionalProperties}"
+            }
+
+            /** Instruction for updating an existing file via the apply_patch tool. */
+            class UpdateFile
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val diff: JsonField<String>,
+                private val path: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("diff")
+                    @ExcludeMissing
+                    diff: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("path")
+                    @ExcludeMissing
+                    path: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(diff, path, type, mutableMapOf())
+
+                /**
+                 * Unified diff content to apply to the existing file.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun diff(): String = diff.getRequired("diff")
+
+                /**
+                 * Path of the file to update relative to the workspace root.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun path(): String = path.getRequired("path")
+
+                /**
+                 * The operation type. Always `update_file`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("update_file")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+                /**
+                 * Returns the raw JSON value of [diff].
+                 *
+                 * Unlike [diff], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("diff") @ExcludeMissing fun _diff(): JsonField<String> = diff
+
+                /**
+                 * Returns the raw JSON value of [path].
+                 *
+                 * Unlike [path], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("path") @ExcludeMissing fun _path(): JsonField<String> = path
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [UpdateFile].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .diff()
+                     * .path()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [UpdateFile]. */
+                class Builder internal constructor() {
+
+                    private var diff: JsonField<String>? = null
+                    private var path: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("update_file")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(updateFile: UpdateFile) = apply {
+                        diff = updateFile.diff
+                        path = updateFile.path
+                        type = updateFile.type
+                        additionalProperties = updateFile.additionalProperties.toMutableMap()
+                    }
+
+                    /** Unified diff content to apply to the existing file. */
+                    fun diff(diff: String) = diff(JsonField.of(diff))
+
+                    /**
+                     * Sets [Builder.diff] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.diff] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun diff(diff: JsonField<String>) = apply { this.diff = diff }
+
+                    /** Path of the file to update relative to the workspace root. */
+                    fun path(path: String) = path(JsonField.of(path))
+
+                    /**
+                     * Sets [Builder.path] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.path] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun path(path: JsonField<String>) = apply { this.path = path }
+
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("update_file")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [UpdateFile].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .diff()
+                     * .path()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): UpdateFile =
+                        UpdateFile(
+                            checkRequired("diff", diff),
+                            checkRequired("path", path),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): UpdateFile = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    diff()
+                    path()
+                    _type().let {
+                        if (it != JsonValue.from("update_file")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (diff.asKnown().isPresent) 1 else 0) +
+                        (if (path.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("update_file")) 1 else 0 }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is UpdateFile &&
+                        diff == other.diff &&
+                        path == other.path &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy {
+                    Objects.hash(diff, path, type, additionalProperties)
+                }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "UpdateFile{diff=$diff, path=$path, type=$type, additionalProperties=$additionalProperties}"
+            }
+        }
+
+        /** The status of the apply patch tool call. One of `in_progress` or `completed`. */
         class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
             /**
@@ -8146,8 +11249,6 @@ private constructor(
 
                 @JvmField val COMPLETED = of("completed")
 
-                @JvmField val INCOMPLETE = of("incomplete")
-
                 @JvmStatic fun of(value: String) = Status(JsonField.of(value))
             }
 
@@ -8155,7 +11256,6 @@ private constructor(
             enum class Known {
                 IN_PROGRESS,
                 COMPLETED,
-                INCOMPLETE,
             }
 
             /**
@@ -8170,7 +11270,6 @@ private constructor(
             enum class Value {
                 IN_PROGRESS,
                 COMPLETED,
-                INCOMPLETE,
                 /**
                  * An enum member indicating that [Status] was instantiated with an unknown value.
                  */
@@ -8188,7 +11287,6 @@ private constructor(
                 when (this) {
                     IN_PROGRESS -> Value.IN_PROGRESS
                     COMPLETED -> Value.COMPLETED
-                    INCOMPLETE -> Value.INCOMPLETE
                     else -> Value._UNKNOWN
                 }
 
@@ -8205,7 +11303,6 @@ private constructor(
                 when (this) {
                     IN_PROGRESS -> Known.IN_PROGRESS
                     COMPLETED -> Known.COMPLETED
-                    INCOMPLETE -> Known.INCOMPLETE
                     else -> throw OpenAIInvalidDataException("Unknown Status: $value")
                 }
 
@@ -8273,1135 +11370,1219 @@ private constructor(
             override fun toString() = value.toString()
         }
 
-        override fun equals(other: Any?): Boolean {
-            if (this === other) {
-                return true
-            }
+        /** The execution context that produced this tool call. */
+        @JsonDeserialize(using = Caller.Deserializer::class)
+        @JsonSerialize(using = Caller.Serializer::class)
+        class Caller
+        private constructor(
+            private val direct: JsonValue? = null,
+            private val program: Program? = null,
+            private val _json: JsonValue? = null,
+        ) {
 
-            return other is ShellCallOutput &&
-                callId == other.callId &&
-                output == other.output &&
-                type == other.type &&
-                id == other.id &&
-                maxOutputLength == other.maxOutputLength &&
-                status == other.status &&
-                additionalProperties == other.additionalProperties
-        }
+            fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
 
-        private val hashCode: Int by lazy {
-            Objects.hash(callId, output, type, id, maxOutputLength, status, additionalProperties)
-        }
+            fun program(): Optional<Program> = Optional.ofNullable(program)
 
-        override fun hashCode(): Int = hashCode
+            fun isDirect(): Boolean = direct != null
 
-        override fun toString() =
-            "ShellCallOutput{callId=$callId, output=$output, type=$type, id=$id, maxOutputLength=$maxOutputLength, status=$status, additionalProperties=$additionalProperties}"
-    }
+            fun isProgram(): Boolean = program != null
 
-    /** A tool call representing a request to create, delete, or update files using diff patches. */
-    class ApplyPatchCall
-    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-    private constructor(
-        private val callId: JsonField<String>,
-        private val operation: JsonField<Operation>,
-        private val status: JsonField<Status>,
-        private val type: JsonValue,
-        private val id: JsonField<String>,
-        private val additionalProperties: MutableMap<String, JsonValue>,
-    ) {
+            fun asDirect(): JsonValue = direct.getOrThrow("direct")
 
-        @JsonCreator
-        private constructor(
-            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("operation")
-            @ExcludeMissing
-            operation: JsonField<Operation> = JsonMissing.of(),
-            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
-            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-        ) : this(callId, operation, status, type, id, mutableMapOf())
+            fun asProgram(): Program = program.getOrThrow("program")
 
-        /**
-         * The unique ID of the apply patch tool call generated by the model.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun callId(): String = callId.getRequired("call_id")
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
 
-        /**
-         * The specific create, delete, or update instruction for the apply_patch tool call.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun operation(): Operation = operation.getRequired("operation")
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitDirect(JsonValue direct) {
+             *         return Optional.of(direct.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    direct != null -> visitor.visitDirect(direct)
+                    program != null -> visitor.visitProgram(program)
+                    else -> visitor.unknown(_json)
+                }
 
-        /**
-         * The status of the apply patch tool call. One of `in_progress` or `completed`.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun status(): Status = status.getRequired("status")
+            private var validated: Boolean = false
 
-        /**
-         * The type of the item. Always `apply_patch_call`.
-         *
-         * Expected to always return the following:
-         * ```java
-         * JsonValue.from("apply_patch_call")
-         * ```
-         *
-         * However, this method can be useful for debugging and logging (e.g. if the server
-         * responded with an unexpected value).
-         */
-        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Caller = apply {
+                if (validated) {
+                    return@apply
+                }
 
-        /**
-         * The unique ID of the apply patch tool call. Populated when this item is returned via API.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun id(): Optional<String> = id.getOptional("id")
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitDirect(direct: JsonValue) {
+                            direct.let {
+                                if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                    throw OpenAIInvalidDataException(
+                                        "'direct' is invalid, received $it"
+                                    )
+                                }
+                            }
+                        }
 
-        /**
-         * Returns the raw JSON value of [callId].
-         *
-         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+                        override fun visitProgram(program: Program) {
+                            program.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
 
-        /**
-         * Returns the raw JSON value of [operation].
-         *
-         * Unlike [operation], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("operation")
-        @ExcludeMissing
-        fun _operation(): JsonField<Operation> = operation
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
 
-        /**
-         * Returns the raw JSON value of [status].
-         *
-         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitDirect(direct: JsonValue) =
+                            direct.let {
+                                if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0
+                            }
 
-        /**
-         * Returns the raw JSON value of [id].
-         *
-         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+                        override fun visitProgram(program: Program) = program.validity()
 
-        @JsonAnySetter
-        private fun putAdditionalProperty(key: String, value: JsonValue) {
-            additionalProperties.put(key, value)
-        }
+                        override fun unknown(json: JsonValue?) = 0
+                    }
+                )
 
-        @JsonAnyGetter
-        @ExcludeMissing
-        fun _additionalProperties(): Map<String, JsonValue> =
-            Collections.unmodifiableMap(additionalProperties)
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
 
-        fun toBuilder() = Builder().from(this)
+                return other is Caller && direct == other.direct && program == other.program
+            }
 
-        companion object {
+            override fun hashCode(): Int = Objects.hash(direct, program)
+
+            override fun toString(): String =
+                when {
+                    direct != null -> "Caller{direct=$direct}"
+                    program != null -> "Caller{program=$program}"
+                    _json != null -> "Caller{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
+
+            companion object {
+
+                @JvmStatic
+                fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
+
+                @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+            }
 
             /**
-             * Returns a mutable builder for constructing an instance of [ApplyPatchCall].
-             *
-             * The following fields are required:
-             * ```java
-             * .callId()
-             * .operation()
-             * .status()
-             * ```
+             * An interface that defines how to map each variant of [Caller] to a value of type [T].
              */
-            @JvmStatic fun builder() = Builder()
-        }
+            interface Visitor<out T> {
+
+                fun visitDirect(direct: JsonValue): T
+
+                fun visitProgram(program: Program): T
+
+                /**
+                 * Maps an unknown variant of [Caller] to a value of type [T].
+                 *
+                 * An instance of [Caller] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
+                 *
+                 * @throws OpenAIInvalidDataException in the default implementation.
+                 */
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Caller: $json")
+                }
+            }
+
+            internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
+
+                override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
+
+                    when (type) {
+                        "direct" -> {
+                            return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let { Caller(direct = it, _json = json) }
+                                ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                        }
+                        "program" -> {
+                            return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                                Caller(program = it, _json = json)
+                            } ?: Caller(_json = json)
+                        }
+                    }
 
-        /** A builder for [ApplyPatchCall]. */
-        class Builder internal constructor() {
+                    return Caller(_json = json)
+                }
+            }
 
-            private var callId: JsonField<String>? = null
-            private var operation: JsonField<Operation>? = null
-            private var status: JsonField<Status>? = null
-            private var type: JsonValue = JsonValue.from("apply_patch_call")
-            private var id: JsonField<String> = JsonMissing.of()
-            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+            internal class Serializer : BaseSerializer<Caller>(Caller::class) {
 
-            @JvmSynthetic
-            internal fun from(applyPatchCall: ApplyPatchCall) = apply {
-                callId = applyPatchCall.callId
-                operation = applyPatchCall.operation
-                status = applyPatchCall.status
-                type = applyPatchCall.type
-                id = applyPatchCall.id
-                additionalProperties = applyPatchCall.additionalProperties.toMutableMap()
+                override fun serialize(
+                    value: Caller,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.direct != null -> generator.writeObject(value.direct)
+                        value.program != null -> generator.writeObject(value.program)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Caller")
+                    }
+                }
             }
 
-            /** The unique ID of the apply patch tool call generated by the model. */
-            fun callId(callId: String) = callId(JsonField.of(callId))
-
-            /**
-             * Sets [Builder.callId] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.callId] with a well-typed [String] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+            class Program
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val callerId: JsonField<String>,
+                private val type: JsonValue,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
 
-            /** The specific create, delete, or update instruction for the apply_patch tool call. */
-            fun operation(operation: Operation) = operation(JsonField.of(operation))
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("caller_id")
+                    @ExcludeMissing
+                    callerId: JsonField<String> = JsonMissing.of(),
+                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+                ) : this(callerId, type, mutableMapOf())
 
-            /**
-             * Sets [Builder.operation] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.operation] with a well-typed [Operation] value
-             * instead. This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun operation(operation: JsonField<Operation>) = apply { this.operation = operation }
+                /**
+                 * The call ID of the program item that produced this tool call.
+                 *
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun callerId(): String = callerId.getRequired("caller_id")
 
-            /** Alias for calling [operation] with `Operation.ofCreateFile(createFile)`. */
-            fun operation(createFile: Operation.CreateFile) =
-                operation(Operation.ofCreateFile(createFile))
+                /**
+                 * The caller type. Always `program`.
+                 *
+                 * Expected to always return the following:
+                 * ```java
+                 * JsonValue.from("program")
+                 * ```
+                 *
+                 * However, this method can be useful for debugging and logging (e.g. if the server
+                 * responded with an unexpected value).
+                 */
+                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
-            /** Alias for calling [operation] with `Operation.ofDeleteFile(deleteFile)`. */
-            fun operation(deleteFile: Operation.DeleteFile) =
-                operation(Operation.ofDeleteFile(deleteFile))
+                /**
+                 * Returns the raw JSON value of [callerId].
+                 *
+                 * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                fun _callerId(): JsonField<String> = callerId
 
-            /**
-             * Alias for calling [operation] with the following:
-             * ```java
-             * Operation.DeleteFile.builder()
-             *     .path(path)
-             *     .build()
-             * ```
-             */
-            fun deleteFileOperation(path: String) =
-                operation(Operation.DeleteFile.builder().path(path).build())
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
 
-            /** Alias for calling [operation] with `Operation.ofUpdateFile(updateFile)`. */
-            fun operation(updateFile: Operation.UpdateFile) =
-                operation(Operation.ofUpdateFile(updateFile))
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
 
-            /** The status of the apply patch tool call. One of `in_progress` or `completed`. */
-            fun status(status: Status) = status(JsonField.of(status))
+                fun toBuilder() = Builder().from(this)
 
-            /**
-             * Sets [Builder.status] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.status] with a well-typed [Status] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun status(status: JsonField<Status>) = apply { this.status = status }
+                companion object {
 
-            /**
-             * Sets the field to an arbitrary JSON value.
-             *
-             * It is usually unnecessary to call this method because the field defaults to the
-             * following:
-             * ```java
-             * JsonValue.from("apply_patch_call")
-             * ```
-             *
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun type(type: JsonValue) = apply { this.type = type }
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Program].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
 
-            /**
-             * The unique ID of the apply patch tool call. Populated when this item is returned via
-             * API.
-             */
-            fun id(id: String?) = id(JsonField.ofNullable(id))
+                /** A builder for [Program]. */
+                class Builder internal constructor() {
 
-            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
-            fun id(id: Optional<String>) = id(id.getOrNull())
+                    private var callerId: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("program")
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
-            /**
-             * Sets [Builder.id] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.id] with a well-typed [String] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
-             */
-            fun id(id: JsonField<String>) = apply { this.id = id }
+                    @JvmSynthetic
+                    internal fun from(program: Program) = apply {
+                        callerId = program.callerId
+                        type = program.type
+                        additionalProperties = program.additionalProperties.toMutableMap()
+                    }
 
-            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                this.additionalProperties.clear()
-                putAllAdditionalProperties(additionalProperties)
-            }
+                    /** The call ID of the program item that produced this tool call. */
+                    fun callerId(callerId: String) = callerId(JsonField.of(callerId))
 
-            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                additionalProperties.put(key, value)
-            }
+                    /**
+                     * Sets [Builder.callerId] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.callerId] with a well-typed [String] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
 
-            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                this.additionalProperties.putAll(additionalProperties)
-            }
+                    /**
+                     * Sets the field to an arbitrary JSON value.
+                     *
+                     * It is usually unnecessary to call this method because the field defaults to
+                     * the following:
+                     * ```java
+                     * JsonValue.from("program")
+                     * ```
+                     *
+                     * This method is primarily for setting the field to an undocumented or not yet
+                     * supported value.
+                     */
+                    fun type(type: JsonValue) = apply { this.type = type }
 
-            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
 
-            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                keys.forEach(::removeAdditionalProperty)
-            }
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
 
-            /**
-             * Returns an immutable instance of [ApplyPatchCall].
-             *
-             * Further updates to this [Builder] will not mutate the returned instance.
-             *
-             * The following fields are required:
-             * ```java
-             * .callId()
-             * .operation()
-             * .status()
-             * ```
-             *
-             * @throws IllegalStateException if any required field is unset.
-             */
-            fun build(): ApplyPatchCall =
-                ApplyPatchCall(
-                    checkRequired("callId", callId),
-                    checkRequired("operation", operation),
-                    checkRequired("status", status),
-                    type,
-                    id,
-                    additionalProperties.toMutableMap(),
-                )
-        }
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
 
-        private var validated: Boolean = false
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
 
-        /**
-         * Validates that the types of all values in this object match their expected types
-         * recursively.
-         *
-         * This method is _not_ forwards compatible with new types from the API for existing fields.
-         *
-         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-         *   expected type.
-         */
-        fun validate(): ApplyPatchCall = apply {
-            if (validated) {
-                return@apply
-            }
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
 
-            callId()
-            operation().validate()
-            status().validate()
-            _type().let {
-                if (it != JsonValue.from("apply_patch_call")) {
-                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                    /**
+                     * Returns an immutable instance of [Program].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .callerId()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Program =
+                        Program(
+                            checkRequired("callerId", callerId),
+                            type,
+                            additionalProperties.toMutableMap(),
+                        )
                 }
-            }
-            id()
-            validated = true
-        }
 
-        fun isValid(): Boolean =
-            try {
-                validate()
-                true
-            } catch (e: OpenAIInvalidDataException) {
-                false
-            }
+                private var validated: Boolean = false
 
-        /**
-         * Returns a score indicating how many valid values are contained in this object
-         * recursively.
-         *
-         * Used for best match union deserialization.
-         */
-        @JvmSynthetic
-        internal fun validity(): Int =
-            (if (callId.asKnown().isPresent) 1 else 0) +
-                (operation.asKnown().getOrNull()?.validity() ?: 0) +
-                (status.asKnown().getOrNull()?.validity() ?: 0) +
-                type.let { if (it == JsonValue.from("apply_patch_call")) 1 else 0 } +
-                (if (id.asKnown().isPresent) 1 else 0)
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Program = apply {
+                    if (validated) {
+                        return@apply
+                    }
 
-        /** The specific create, delete, or update instruction for the apply_patch tool call. */
-        @JsonDeserialize(using = Operation.Deserializer::class)
-        @JsonSerialize(using = Operation.Serializer::class)
-        class Operation
-        private constructor(
-            private val createFile: CreateFile? = null,
-            private val deleteFile: DeleteFile? = null,
-            private val updateFile: UpdateFile? = null,
-            private val _json: JsonValue? = null,
-        ) {
+                    callerId()
+                    _type().let {
+                        if (it != JsonValue.from("program")) {
+                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                        }
+                    }
+                    validated = true
+                }
 
-            /** Instruction for creating a new file via the apply_patch tool. */
-            fun createFile(): Optional<CreateFile> = Optional.ofNullable(createFile)
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
 
-            /** Instruction for deleting an existing file via the apply_patch tool. */
-            fun deleteFile(): Optional<DeleteFile> = Optional.ofNullable(deleteFile)
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int =
+                    (if (callerId.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("program")) 1 else 0 }
 
-            /** Instruction for updating an existing file via the apply_patch tool. */
-            fun updateFile(): Optional<UpdateFile> = Optional.ofNullable(updateFile)
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
 
-            fun isCreateFile(): Boolean = createFile != null
+                    return other is Program &&
+                        callerId == other.callerId &&
+                        type == other.type &&
+                        additionalProperties == other.additionalProperties
+                }
 
-            fun isDeleteFile(): Boolean = deleteFile != null
+                private val hashCode: Int by lazy {
+                    Objects.hash(callerId, type, additionalProperties)
+                }
 
-            fun isUpdateFile(): Boolean = updateFile != null
+                override fun hashCode(): Int = hashCode
 
-            /** Instruction for creating a new file via the apply_patch tool. */
-            fun asCreateFile(): CreateFile = createFile.getOrThrow("createFile")
+                override fun toString() =
+                    "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
+            }
+        }
 
-            /** Instruction for deleting an existing file via the apply_patch tool. */
-            fun asDeleteFile(): DeleteFile = deleteFile.getOrThrow("deleteFile")
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
 
-            /** Instruction for updating an existing file via the apply_patch tool. */
-            fun asUpdateFile(): UpdateFile = updateFile.getOrThrow("updateFile")
+            return other is ApplyPatchCall &&
+                callId == other.callId &&
+                operation == other.operation &&
+                status == other.status &&
+                type == other.type &&
+                id == other.id &&
+                caller == other.caller &&
+                additionalProperties == other.additionalProperties
+        }
 
-            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+        private val hashCode: Int by lazy {
+            Objects.hash(callId, operation, status, type, id, caller, additionalProperties)
+        }
 
-            /**
-             * Maps this instance's current variant to a value of type [T] using the given
-             * [visitor].
-             *
-             * Note that this method is _not_ forwards compatible with new variants from the API,
-             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
-             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
-             * ```java
-             * import com.openai.core.JsonValue;
-             * import java.util.Optional;
-             *
-             * Optional<String> result = operation.accept(new Operation.Visitor<Optional<String>>() {
-             *     @Override
-             *     public Optional<String> visitCreateFile(CreateFile createFile) {
-             *         return Optional.of(createFile.toString());
-             *     }
-             *
-             *     // ...
-             *
-             *     @Override
-             *     public Optional<String> unknown(JsonValue json) {
-             *         // Or inspect the `json`.
-             *         return Optional.empty();
-             *     }
-             * });
-             * ```
-             *
-             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
-             *   [visitor] and the current variant is unknown.
-             */
-            fun <T> accept(visitor: Visitor<T>): T =
-                when {
-                    createFile != null -> visitor.visitCreateFile(createFile)
-                    deleteFile != null -> visitor.visitDeleteFile(deleteFile)
-                    updateFile != null -> visitor.visitUpdateFile(updateFile)
-                    else -> visitor.unknown(_json)
-                }
+        override fun hashCode(): Int = hashCode
 
-            private var validated: Boolean = false
+        override fun toString() =
+            "ApplyPatchCall{callId=$callId, operation=$operation, status=$status, type=$type, id=$id, caller=$caller, additionalProperties=$additionalProperties}"
+    }
 
-            /**
-             * Validates that the types of all values in this object match their expected types
-             * recursively.
-             *
-             * This method is _not_ forwards compatible with new types from the API for existing
-             * fields.
-             *
-             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-             *   expected type.
-             */
-            fun validate(): Operation = apply {
-                if (validated) {
-                    return@apply
-                }
+    /** The streamed output emitted by an apply patch tool call. */
+    class ApplyPatchCallOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val callId: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val caller: JsonField<Caller>,
+        private val output: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
 
-                accept(
-                    object : Visitor<Unit> {
-                        override fun visitCreateFile(createFile: CreateFile) {
-                            createFile.validate()
-                        }
+        @JsonCreator
+        private constructor(
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("caller") @ExcludeMissing caller: JsonField<Caller> = JsonMissing.of(),
+            @JsonProperty("output") @ExcludeMissing output: JsonField<String> = JsonMissing.of(),
+        ) : this(callId, status, type, id, caller, output, mutableMapOf())
 
-                        override fun visitDeleteFile(deleteFile: DeleteFile) {
-                            deleteFile.validate()
-                        }
+        /**
+         * The unique ID of the apply patch tool call generated by the model.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
 
-                        override fun visitUpdateFile(updateFile: UpdateFile) {
-                            updateFile.validate()
-                        }
-                    }
-                )
-                validated = true
-            }
+        /**
+         * The status of the apply patch tool call output. One of `completed` or `failed`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
 
-            fun isValid(): Boolean =
-                try {
-                    validate()
-                    true
-                } catch (e: OpenAIInvalidDataException) {
-                    false
-                }
+        /**
+         * The type of the item. Always `apply_patch_call_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("apply_patch_call_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
-            /**
-             * Returns a score indicating how many valid values are contained in this object
-             * recursively.
-             *
-             * Used for best match union deserialization.
-             */
-            @JvmSynthetic
-            internal fun validity(): Int =
-                accept(
-                    object : Visitor<Int> {
-                        override fun visitCreateFile(createFile: CreateFile) = createFile.validity()
+        /**
+         * The unique ID of the apply patch tool call output. Populated when this item is returned
+         * via API.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun id(): Optional<String> = id.getOptional("id")
 
-                        override fun visitDeleteFile(deleteFile: DeleteFile) = deleteFile.validity()
+        /**
+         * The execution context that produced this tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun caller(): Optional<Caller> = caller.getOptional("caller")
 
-                        override fun visitUpdateFile(updateFile: UpdateFile) = updateFile.validity()
+        /**
+         * Optional human-readable log text from the apply patch tool (e.g., patch results or
+         * errors).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun output(): Optional<String> = output.getOptional("output")
 
-                        override fun unknown(json: JsonValue?) = 0
-                    }
-                )
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
 
-            override fun equals(other: Any?): Boolean {
-                if (this === other) {
-                    return true
-                }
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
 
-                return other is Operation &&
-                    createFile == other.createFile &&
-                    deleteFile == other.deleteFile &&
-                    updateFile == other.updateFile
-            }
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
-            override fun hashCode(): Int = Objects.hash(createFile, deleteFile, updateFile)
+        /**
+         * Returns the raw JSON value of [caller].
+         *
+         * Unlike [caller], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("caller") @ExcludeMissing fun _caller(): JsonField<Caller> = caller
 
-            override fun toString(): String =
-                when {
-                    createFile != null -> "Operation{createFile=$createFile}"
-                    deleteFile != null -> "Operation{deleteFile=$deleteFile}"
-                    updateFile != null -> "Operation{updateFile=$updateFile}"
-                    _json != null -> "Operation{_unknown=$_json}"
-                    else -> throw IllegalStateException("Invalid Operation")
-                }
+        /**
+         * Returns the raw JSON value of [output].
+         *
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<String> = output
 
-            companion object {
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
 
-                /** Instruction for creating a new file via the apply_patch tool. */
-                @JvmStatic
-                fun ofCreateFile(createFile: CreateFile) = Operation(createFile = createFile)
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
 
-                /** Instruction for deleting an existing file via the apply_patch tool. */
-                @JvmStatic
-                fun ofDeleteFile(deleteFile: DeleteFile) = Operation(deleteFile = deleteFile)
+        fun toBuilder() = Builder().from(this)
 
-                /** Instruction for updating an existing file via the apply_patch tool. */
-                @JvmStatic
-                fun ofUpdateFile(updateFile: UpdateFile) = Operation(updateFile = updateFile)
-            }
+        companion object {
 
             /**
-             * An interface that defines how to map each variant of [Operation] to a value of type
-             * [T].
+             * Returns a mutable builder for constructing an instance of [ApplyPatchCallOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .callId()
+             * .status()
+             * ```
              */
-            interface Visitor<out T> {
-
-                /** Instruction for creating a new file via the apply_patch tool. */
-                fun visitCreateFile(createFile: CreateFile): T
+            @JvmStatic fun builder() = Builder()
+        }
 
-                /** Instruction for deleting an existing file via the apply_patch tool. */
-                fun visitDeleteFile(deleteFile: DeleteFile): T
+        /** A builder for [ApplyPatchCallOutput]. */
+        class Builder internal constructor() {
 
-                /** Instruction for updating an existing file via the apply_patch tool. */
-                fun visitUpdateFile(updateFile: UpdateFile): T
+            private var callId: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("apply_patch_call_output")
+            private var id: JsonField<String> = JsonMissing.of()
+            private var caller: JsonField<Caller> = JsonMissing.of()
+            private var output: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
-                /**
-                 * Maps an unknown variant of [Operation] to a value of type [T].
-                 *
-                 * An instance of [Operation] can contain an unknown variant if it was deserialized
-                 * from data that doesn't match any known variant. For example, if the SDK is on an
-                 * older version than the API, then the API may respond with new variants that the
-                 * SDK is unaware of.
-                 *
-                 * @throws OpenAIInvalidDataException in the default implementation.
-                 */
-                fun unknown(json: JsonValue?): T {
-                    throw OpenAIInvalidDataException("Unknown Operation: $json")
-                }
+            @JvmSynthetic
+            internal fun from(applyPatchCallOutput: ApplyPatchCallOutput) = apply {
+                callId = applyPatchCallOutput.callId
+                status = applyPatchCallOutput.status
+                type = applyPatchCallOutput.type
+                id = applyPatchCallOutput.id
+                caller = applyPatchCallOutput.caller
+                output = applyPatchCallOutput.output
+                additionalProperties = applyPatchCallOutput.additionalProperties.toMutableMap()
             }
 
-            internal class Deserializer : BaseDeserializer<Operation>(Operation::class) {
-
-                override fun ObjectCodec.deserialize(node: JsonNode): Operation {
-                    val json = JsonValue.fromJsonNode(node)
-                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
-
-                    when (type) {
-                        "create_file" -> {
-                            return tryDeserialize(node, jacksonTypeRef<CreateFile>())?.let {
-                                Operation(createFile = it, _json = json)
-                            } ?: Operation(_json = json)
-                        }
-                        "delete_file" -> {
-                            return tryDeserialize(node, jacksonTypeRef<DeleteFile>())?.let {
-                                Operation(deleteFile = it, _json = json)
-                            } ?: Operation(_json = json)
-                        }
-                        "update_file" -> {
-                            return tryDeserialize(node, jacksonTypeRef<UpdateFile>())?.let {
-                                Operation(updateFile = it, _json = json)
-                            } ?: Operation(_json = json)
-                        }
-                    }
+            /** The unique ID of the apply patch tool call generated by the model. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
 
-                    return Operation(_json = json)
-                }
-            }
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
 
-            internal class Serializer : BaseSerializer<Operation>(Operation::class) {
+            /** The status of the apply patch tool call output. One of `completed` or `failed`. */
+            fun status(status: Status) = status(JsonField.of(status))
 
-                override fun serialize(
-                    value: Operation,
-                    generator: JsonGenerator,
-                    provider: SerializerProvider,
-                ) {
-                    when {
-                        value.createFile != null -> generator.writeObject(value.createFile)
-                        value.deleteFile != null -> generator.writeObject(value.deleteFile)
-                        value.updateFile != null -> generator.writeObject(value.updateFile)
-                        value._json != null -> generator.writeObject(value._json)
-                        else -> throw IllegalStateException("Invalid Operation")
-                    }
-                }
-            }
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
 
-            /** Instruction for creating a new file via the apply_patch tool. */
-            class CreateFile
-            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-            private constructor(
-                private val diff: JsonField<String>,
-                private val path: JsonField<String>,
-                private val type: JsonValue,
-                private val additionalProperties: MutableMap<String, JsonValue>,
-            ) {
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("apply_patch_call_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
 
-                @JsonCreator
-                private constructor(
-                    @JsonProperty("diff")
-                    @ExcludeMissing
-                    diff: JsonField<String> = JsonMissing.of(),
-                    @JsonProperty("path")
-                    @ExcludeMissing
-                    path: JsonField<String> = JsonMissing.of(),
-                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-                ) : this(diff, path, type, mutableMapOf())
+            /**
+             * The unique ID of the apply patch tool call output. Populated when this item is
+             * returned via API.
+             */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
 
-                /**
-                 * Unified diff content to apply when creating the file.
-                 *
-                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
-                 *   value).
-                 */
-                fun diff(): String = diff.getRequired("diff")
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
 
-                /**
-                 * Path of the file to create relative to the workspace root.
-                 *
-                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
-                 *   value).
-                 */
-                fun path(): String = path.getRequired("path")
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
 
-                /**
-                 * The operation type. Always `create_file`.
-                 *
-                 * Expected to always return the following:
-                 * ```java
-                 * JsonValue.from("create_file")
-                 * ```
-                 *
-                 * However, this method can be useful for debugging and logging (e.g. if the server
-                 * responded with an unexpected value).
-                 */
-                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+            /** The execution context that produced this tool call. */
+            fun caller(caller: Caller?) = caller(JsonField.ofNullable(caller))
 
-                /**
-                 * Returns the raw JSON value of [diff].
-                 *
-                 * Unlike [diff], this method doesn't throw if the JSON field has an unexpected
-                 * type.
-                 */
-                @JsonProperty("diff") @ExcludeMissing fun _diff(): JsonField<String> = diff
+            /** Alias for calling [Builder.caller] with `caller.orElse(null)`. */
+            fun caller(caller: Optional<Caller>) = caller(caller.getOrNull())
 
-                /**
-                 * Returns the raw JSON value of [path].
-                 *
-                 * Unlike [path], this method doesn't throw if the JSON field has an unexpected
-                 * type.
-                 */
-                @JsonProperty("path") @ExcludeMissing fun _path(): JsonField<String> = path
+            /**
+             * Sets [Builder.caller] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.caller] with a well-typed [Caller] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun caller(caller: JsonField<Caller>) = apply { this.caller = caller }
 
-                @JsonAnySetter
-                private fun putAdditionalProperty(key: String, value: JsonValue) {
-                    additionalProperties.put(key, value)
-                }
+            /** Alias for calling [caller] with `Caller.ofDirect()`. */
+            fun callerDirect() = caller(Caller.ofDirect())
 
-                @JsonAnyGetter
-                @ExcludeMissing
-                fun _additionalProperties(): Map<String, JsonValue> =
-                    Collections.unmodifiableMap(additionalProperties)
+            /** Alias for calling [caller] with `Caller.ofProgram(program)`. */
+            fun caller(program: Caller.Program) = caller(Caller.ofProgram(program))
 
-                fun toBuilder() = Builder().from(this)
+            /**
+             * Alias for calling [caller] with the following:
+             * ```java
+             * Caller.Program.builder()
+             *     .callerId(callerId)
+             *     .build()
+             * ```
+             */
+            fun programCaller(callerId: String) =
+                caller(Caller.Program.builder().callerId(callerId).build())
 
-                companion object {
+            /**
+             * Optional human-readable log text from the apply patch tool (e.g., patch results or
+             * errors).
+             */
+            fun output(output: String?) = output(JsonField.ofNullable(output))
 
-                    /**
-                     * Returns a mutable builder for constructing an instance of [CreateFile].
-                     *
-                     * The following fields are required:
-                     * ```java
-                     * .diff()
-                     * .path()
-                     * ```
-                     */
-                    @JvmStatic fun builder() = Builder()
-                }
+            /** Alias for calling [Builder.output] with `output.orElse(null)`. */
+            fun output(output: Optional<String>) = output(output.getOrNull())
 
-                /** A builder for [CreateFile]. */
-                class Builder internal constructor() {
+            /**
+             * Sets [Builder.output] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.output] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun output(output: JsonField<String>) = apply { this.output = output }
 
-                    private var diff: JsonField<String>? = null
-                    private var path: JsonField<String>? = null
-                    private var type: JsonValue = JsonValue.from("create_file")
-                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
 
-                    @JvmSynthetic
-                    internal fun from(createFile: CreateFile) = apply {
-                        diff = createFile.diff
-                        path = createFile.path
-                        type = createFile.type
-                        additionalProperties = createFile.additionalProperties.toMutableMap()
-                    }
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
 
-                    /** Unified diff content to apply when creating the file. */
-                    fun diff(diff: String) = diff(JsonField.of(diff))
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
 
-                    /**
-                     * Sets [Builder.diff] to an arbitrary JSON value.
-                     *
-                     * You should usually call [Builder.diff] with a well-typed [String] value
-                     * instead. This method is primarily for setting the field to an undocumented or
-                     * not yet supported value.
-                     */
-                    fun diff(diff: JsonField<String>) = apply { this.diff = diff }
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
 
-                    /** Path of the file to create relative to the workspace root. */
-                    fun path(path: String) = path(JsonField.of(path))
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
 
-                    /**
-                     * Sets [Builder.path] to an arbitrary JSON value.
-                     *
-                     * You should usually call [Builder.path] with a well-typed [String] value
-                     * instead. This method is primarily for setting the field to an undocumented or
-                     * not yet supported value.
-                     */
-                    fun path(path: JsonField<String>) = apply { this.path = path }
+            /**
+             * Returns an immutable instance of [ApplyPatchCallOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .callId()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ApplyPatchCallOutput =
+                ApplyPatchCallOutput(
+                    checkRequired("callId", callId),
+                    checkRequired("status", status),
+                    type,
+                    id,
+                    caller,
+                    output,
+                    additionalProperties.toMutableMap(),
+                )
+        }
 
-                    /**
-                     * Sets the field to an arbitrary JSON value.
-                     *
-                     * It is usually unnecessary to call this method because the field defaults to
-                     * the following:
-                     * ```java
-                     * JsonValue.from("create_file")
-                     * ```
-                     *
-                     * This method is primarily for setting the field to an undocumented or not yet
-                     * supported value.
-                     */
-                    fun type(type: JsonValue) = apply { this.type = type }
+        private var validated: Boolean = false
 
-                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                        this.additionalProperties.clear()
-                        putAllAdditionalProperties(additionalProperties)
-                    }
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ApplyPatchCallOutput = apply {
+            if (validated) {
+                return@apply
+            }
 
-                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                        additionalProperties.put(key, value)
-                    }
+            callId()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("apply_patch_call_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            id()
+            caller().ifPresent { it.validate() }
+            output()
+            validated = true
+        }
 
-                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
-                        apply {
-                            this.additionalProperties.putAll(additionalProperties)
-                        }
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
 
-                    fun removeAdditionalProperty(key: String) = apply {
-                        additionalProperties.remove(key)
-                    }
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (callId.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("apply_patch_call_output")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (caller.asKnown().getOrNull()?.validity() ?: 0) +
+                (if (output.asKnown().isPresent) 1 else 0)
 
-                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                        keys.forEach(::removeAdditionalProperty)
-                    }
+        /** The status of the apply patch tool call output. One of `completed` or `failed`. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
-                    /**
-                     * Returns an immutable instance of [CreateFile].
-                     *
-                     * Further updates to this [Builder] will not mutate the returned instance.
-                     *
-                     * The following fields are required:
-                     * ```java
-                     * .diff()
-                     * .path()
-                     * ```
-                     *
-                     * @throws IllegalStateException if any required field is unset.
-                     */
-                    fun build(): CreateFile =
-                        CreateFile(
-                            checkRequired("diff", diff),
-                            checkRequired("path", path),
-                            type,
-                            additionalProperties.toMutableMap(),
-                        )
-                }
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val FAILED = of("failed")
 
-                private var validated: Boolean = false
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                COMPLETED,
+                FAILED,
+            }
 
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                COMPLETED,
+                FAILED,
                 /**
-                 * Validates that the types of all values in this object match their expected types
-                 * recursively.
-                 *
-                 * This method is _not_ forwards compatible with new types from the API for existing
-                 * fields.
-                 *
-                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
-                 *   its expected type.
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
                  */
-                fun validate(): CreateFile = apply {
-                    if (validated) {
-                        return@apply
-                    }
+                _UNKNOWN,
+            }
 
-                    diff()
-                    path()
-                    _type().let {
-                        if (it != JsonValue.from("create_file")) {
-                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
-                        }
-                    }
-                    validated = true
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    COMPLETED -> Value.COMPLETED
+                    FAILED -> Value.FAILED
+                    else -> Value._UNKNOWN
                 }
 
-                fun isValid(): Boolean =
-                    try {
-                        validate()
-                        true
-                    } catch (e: OpenAIInvalidDataException) {
-                        false
-                    }
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    COMPLETED -> Known.COMPLETED
+                    FAILED -> Known.FAILED
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
 
-                /**
-                 * Returns a score indicating how many valid values are contained in this object
-                 * recursively.
-                 *
-                 * Used for best match union deserialization.
-                 */
-                @JvmSynthetic
-                internal fun validity(): Int =
-                    (if (diff.asKnown().isPresent) 1 else 0) +
-                        (if (path.asKnown().isPresent) 1 else 0) +
-                        type.let { if (it == JsonValue.from("create_file")) 1 else 0 }
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
 
-                override fun equals(other: Any?): Boolean {
-                    if (this === other) {
-                        return true
-                    }
+            private var validated: Boolean = false
 
-                    return other is CreateFile &&
-                        diff == other.diff &&
-                        path == other.path &&
-                        type == other.type &&
-                        additionalProperties == other.additionalProperties
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
                 }
 
-                private val hashCode: Int by lazy {
-                    Objects.hash(diff, path, type, additionalProperties)
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
                 }
 
-                override fun hashCode(): Int = hashCode
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
 
-                override fun toString() =
-                    "CreateFile{diff=$diff, path=$path, type=$type, additionalProperties=$additionalProperties}"
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
             }
 
-            /** Instruction for deleting an existing file via the apply_patch tool. */
-            class DeleteFile
-            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-            private constructor(
-                private val path: JsonField<String>,
-                private val type: JsonValue,
-                private val additionalProperties: MutableMap<String, JsonValue>,
-            ) {
+            override fun hashCode() = value.hashCode()
 
-                @JsonCreator
-                private constructor(
-                    @JsonProperty("path")
-                    @ExcludeMissing
-                    path: JsonField<String> = JsonMissing.of(),
-                    @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-                ) : this(path, type, mutableMapOf())
+            override fun toString() = value.toString()
+        }
 
-                /**
-                 * Path of the file to delete relative to the workspace root.
-                 *
-                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
-                 *   value).
-                 */
-                fun path(): String = path.getRequired("path")
+        /** The execution context that produced this tool call. */
+        @JsonDeserialize(using = Caller.Deserializer::class)
+        @JsonSerialize(using = Caller.Serializer::class)
+        class Caller
+        private constructor(
+            private val direct: JsonValue? = null,
+            private val program: Program? = null,
+            private val _json: JsonValue? = null,
+        ) {
 
-                /**
-                 * The operation type. Always `delete_file`.
-                 *
-                 * Expected to always return the following:
-                 * ```java
-                 * JsonValue.from("delete_file")
-                 * ```
-                 *
-                 * However, this method can be useful for debugging and logging (e.g. if the server
-                 * responded with an unexpected value).
-                 */
-                @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+            fun direct(): Optional<JsonValue> = Optional.ofNullable(direct)
 
-                /**
-                 * Returns the raw JSON value of [path].
-                 *
-                 * Unlike [path], this method doesn't throw if the JSON field has an unexpected
-                 * type.
-                 */
-                @JsonProperty("path") @ExcludeMissing fun _path(): JsonField<String> = path
+            fun program(): Optional<Program> = Optional.ofNullable(program)
 
-                @JsonAnySetter
-                private fun putAdditionalProperty(key: String, value: JsonValue) {
-                    additionalProperties.put(key, value)
+            fun isDirect(): Boolean = direct != null
+
+            fun isProgram(): Boolean = program != null
+
+            fun asDirect(): JsonValue = direct.getOrThrow("direct")
+
+            fun asProgram(): Program = program.getOrThrow("program")
+
+            fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
+
+            /**
+             * Maps this instance's current variant to a value of type [T] using the given
+             * [visitor].
+             *
+             * Note that this method is _not_ forwards compatible with new variants from the API,
+             * unless [visitor] overrides [Visitor.unknown]. To handle variants not known to this
+             * version of the SDK gracefully, consider overriding [Visitor.unknown]:
+             * ```java
+             * import com.openai.core.JsonValue;
+             * import java.util.Optional;
+             *
+             * Optional<String> result = caller.accept(new Caller.Visitor<Optional<String>>() {
+             *     @Override
+             *     public Optional<String> visitDirect(JsonValue direct) {
+             *         return Optional.of(direct.toString());
+             *     }
+             *
+             *     // ...
+             *
+             *     @Override
+             *     public Optional<String> unknown(JsonValue json) {
+             *         // Or inspect the `json`.
+             *         return Optional.empty();
+             *     }
+             * });
+             * ```
+             *
+             * @throws OpenAIInvalidDataException if [Visitor.unknown] is not overridden in
+             *   [visitor] and the current variant is unknown.
+             */
+            fun <T> accept(visitor: Visitor<T>): T =
+                when {
+                    direct != null -> visitor.visitDirect(direct)
+                    program != null -> visitor.visitProgram(program)
+                    else -> visitor.unknown(_json)
                 }
 
-                @JsonAnyGetter
-                @ExcludeMissing
-                fun _additionalProperties(): Map<String, JsonValue> =
-                    Collections.unmodifiableMap(additionalProperties)
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Caller = apply {
+                if (validated) {
+                    return@apply
+                }
 
-                fun toBuilder() = Builder().from(this)
+                accept(
+                    object : Visitor<Unit> {
+                        override fun visitDirect(direct: JsonValue) {
+                            direct.let {
+                                if (it != JsonValue.from(mapOf("type" to "direct"))) {
+                                    throw OpenAIInvalidDataException(
+                                        "'direct' is invalid, received $it"
+                                    )
+                                }
+                            }
+                        }
 
-                companion object {
+                        override fun visitProgram(program: Program) {
+                            program.validate()
+                        }
+                    }
+                )
+                validated = true
+            }
 
-                    /**
-                     * Returns a mutable builder for constructing an instance of [DeleteFile].
-                     *
-                     * The following fields are required:
-                     * ```java
-                     * .path()
-                     * ```
-                     */
-                    @JvmStatic fun builder() = Builder()
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
                 }
 
-                /** A builder for [DeleteFile]. */
-                class Builder internal constructor() {
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                accept(
+                    object : Visitor<Int> {
+                        override fun visitDirect(direct: JsonValue) =
+                            direct.let {
+                                if (it == JsonValue.from(mapOf("type" to "direct"))) 1 else 0
+                            }
 
-                    private var path: JsonField<String>? = null
-                    private var type: JsonValue = JsonValue.from("delete_file")
-                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+                        override fun visitProgram(program: Program) = program.validity()
 
-                    @JvmSynthetic
-                    internal fun from(deleteFile: DeleteFile) = apply {
-                        path = deleteFile.path
-                        type = deleteFile.type
-                        additionalProperties = deleteFile.additionalProperties.toMutableMap()
+                        override fun unknown(json: JsonValue?) = 0
                     }
+                )
 
-                    /** Path of the file to delete relative to the workspace root. */
-                    fun path(path: String) = path(JsonField.of(path))
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
 
-                    /**
-                     * Sets [Builder.path] to an arbitrary JSON value.
-                     *
-                     * You should usually call [Builder.path] with a well-typed [String] value
-                     * instead. This method is primarily for setting the field to an undocumented or
-                     * not yet supported value.
-                     */
-                    fun path(path: JsonField<String>) = apply { this.path = path }
+                return other is Caller && direct == other.direct && program == other.program
+            }
 
-                    /**
-                     * Sets the field to an arbitrary JSON value.
-                     *
-                     * It is usually unnecessary to call this method because the field defaults to
-                     * the following:
-                     * ```java
-                     * JsonValue.from("delete_file")
-                     * ```
-                     *
-                     * This method is primarily for setting the field to an undocumented or not yet
-                     * supported value.
-                     */
-                    fun type(type: JsonValue) = apply { this.type = type }
+            override fun hashCode(): Int = Objects.hash(direct, program)
 
-                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                        this.additionalProperties.clear()
-                        putAllAdditionalProperties(additionalProperties)
-                    }
+            override fun toString(): String =
+                when {
+                    direct != null -> "Caller{direct=$direct}"
+                    program != null -> "Caller{program=$program}"
+                    _json != null -> "Caller{_unknown=$_json}"
+                    else -> throw IllegalStateException("Invalid Caller")
+                }
 
-                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                        additionalProperties.put(key, value)
-                    }
+            companion object {
 
-                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
-                        apply {
-                            this.additionalProperties.putAll(additionalProperties)
-                        }
+                @JvmStatic
+                fun ofDirect() = Caller(direct = JsonValue.from(mapOf("type" to "direct")))
 
-                    fun removeAdditionalProperty(key: String) = apply {
-                        additionalProperties.remove(key)
-                    }
+                @JvmStatic fun ofProgram(program: Program) = Caller(program = program)
+            }
 
-                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                        keys.forEach(::removeAdditionalProperty)
-                    }
+            /**
+             * An interface that defines how to map each variant of [Caller] to a value of type [T].
+             */
+            interface Visitor<out T> {
 
-                    /**
-                     * Returns an immutable instance of [DeleteFile].
-                     *
-                     * Further updates to this [Builder] will not mutate the returned instance.
-                     *
-                     * The following fields are required:
-                     * ```java
-                     * .path()
-                     * ```
-                     *
-                     * @throws IllegalStateException if any required field is unset.
-                     */
-                    fun build(): DeleteFile =
-                        DeleteFile(
-                            checkRequired("path", path),
-                            type,
-                            additionalProperties.toMutableMap(),
-                        )
-                }
+                fun visitDirect(direct: JsonValue): T
 
-                private var validated: Boolean = false
+                fun visitProgram(program: Program): T
 
                 /**
-                 * Validates that the types of all values in this object match their expected types
-                 * recursively.
+                 * Maps an unknown variant of [Caller] to a value of type [T].
                  *
-                 * This method is _not_ forwards compatible with new types from the API for existing
-                 * fields.
+                 * An instance of [Caller] can contain an unknown variant if it was deserialized
+                 * from data that doesn't match any known variant. For example, if the SDK is on an
+                 * older version than the API, then the API may respond with new variants that the
+                 * SDK is unaware of.
                  *
-                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
-                 *   its expected type.
+                 * @throws OpenAIInvalidDataException in the default implementation.
                  */
-                fun validate(): DeleteFile = apply {
-                    if (validated) {
-                        return@apply
-                    }
-
-                    path()
-                    _type().let {
-                        if (it != JsonValue.from("delete_file")) {
-                            throw OpenAIInvalidDataException("'type' is invalid, received $it")
-                        }
-                    }
-                    validated = true
+                fun unknown(json: JsonValue?): T {
+                    throw OpenAIInvalidDataException("Unknown Caller: $json")
                 }
+            }
 
-                fun isValid(): Boolean =
-                    try {
-                        validate()
-                        true
-                    } catch (e: OpenAIInvalidDataException) {
-                        false
-                    }
+            internal class Deserializer : BaseDeserializer<Caller>(Caller::class) {
 
-                /**
-                 * Returns a score indicating how many valid values are contained in this object
-                 * recursively.
-                 *
-                 * Used for best match union deserialization.
-                 */
-                @JvmSynthetic
-                internal fun validity(): Int =
-                    (if (path.asKnown().isPresent) 1 else 0) +
-                        type.let { if (it == JsonValue.from("delete_file")) 1 else 0 }
+                override fun ObjectCodec.deserialize(node: JsonNode): Caller {
+                    val json = JsonValue.fromJsonNode(node)
+                    val type = json.asObject().getOrNull()?.get("type")?.asString()?.getOrNull()
 
-                override fun equals(other: Any?): Boolean {
-                    if (this === other) {
-                        return true
+                    when (type) {
+                        "direct" -> {
+                            return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let { Caller(direct = it, _json = json) }
+                                ?.takeIf { it.isValid() } ?: Caller(_json = json)
+                        }
+                        "program" -> {
+                            return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                                Caller(program = it, _json = json)
+                            } ?: Caller(_json = json)
+                        }
                     }
 
-                    return other is DeleteFile &&
-                        path == other.path &&
-                        type == other.type &&
-                        additionalProperties == other.additionalProperties
+                    return Caller(_json = json)
                 }
+            }
 
-                private val hashCode: Int by lazy { Objects.hash(path, type, additionalProperties) }
-
-                override fun hashCode(): Int = hashCode
+            internal class Serializer : BaseSerializer<Caller>(Caller::class) {
 
-                override fun toString() =
-                    "DeleteFile{path=$path, type=$type, additionalProperties=$additionalProperties}"
+                override fun serialize(
+                    value: Caller,
+                    generator: JsonGenerator,
+                    provider: SerializerProvider,
+                ) {
+                    when {
+                        value.direct != null -> generator.writeObject(value.direct)
+                        value.program != null -> generator.writeObject(value.program)
+                        value._json != null -> generator.writeObject(value._json)
+                        else -> throw IllegalStateException("Invalid Caller")
+                    }
+                }
             }
 
-            /** Instruction for updating an existing file via the apply_patch tool. */
-            class UpdateFile
+            class Program
             @JsonCreator(mode = JsonCreator.Mode.DISABLED)
             private constructor(
-                private val diff: JsonField<String>,
-                private val path: JsonField<String>,
+                private val callerId: JsonField<String>,
                 private val type: JsonValue,
                 private val additionalProperties: MutableMap<String, JsonValue>,
             ) {
 
                 @JsonCreator
                 private constructor(
-                    @JsonProperty("diff")
-                    @ExcludeMissing
-                    diff: JsonField<String> = JsonMissing.of(),
-                    @JsonProperty("path")
+                    @JsonProperty("caller_id")
                     @ExcludeMissing
-                    path: JsonField<String> = JsonMissing.of(),
+                    callerId: JsonField<String> = JsonMissing.of(),
                     @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-                ) : this(diff, path, type, mutableMapOf())
-
-                /**
-                 * Unified diff content to apply to the existing file.
-                 *
-                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
-                 *   value).
-                 */
-                fun diff(): String = diff.getRequired("diff")
+                ) : this(callerId, type, mutableMapOf())
 
                 /**
-                 * Path of the file to update relative to the workspace root.
+                 * The call ID of the program item that produced this tool call.
                  *
                  * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
                  *   unexpectedly missing or null (e.g. if the server responded with an unexpected
                  *   value).
                  */
-                fun path(): String = path.getRequired("path")
+                fun callerId(): String = callerId.getRequired("caller_id")
 
                 /**
-                 * The operation type. Always `update_file`.
+                 * The caller type. Always `program`.
                  *
                  * Expected to always return the following:
                  * ```java
-                 * JsonValue.from("update_file")
+                 * JsonValue.from("program")
                  * ```
                  *
                  * However, this method can be useful for debugging and logging (e.g. if the server
@@ -9410,20 +12591,14 @@ private constructor(
                 @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
                 /**
-                 * Returns the raw JSON value of [diff].
-                 *
-                 * Unlike [diff], this method doesn't throw if the JSON field has an unexpected
-                 * type.
-                 */
-                @JsonProperty("diff") @ExcludeMissing fun _diff(): JsonField<String> = diff
-
-                /**
-                 * Returns the raw JSON value of [path].
+                 * Returns the raw JSON value of [callerId].
                  *
-                 * Unlike [path], this method doesn't throw if the JSON field has an unexpected
+                 * Unlike [callerId], this method doesn't throw if the JSON field has an unexpected
                  * type.
                  */
-                @JsonProperty("path") @ExcludeMissing fun _path(): JsonField<String> = path
+                @JsonProperty("caller_id")
+                @ExcludeMissing
+                fun _callerId(): JsonField<String> = callerId
 
                 @JsonAnySetter
                 private fun putAdditionalProperty(key: String, value: JsonValue) {
@@ -9440,56 +12615,41 @@ private constructor(
                 companion object {
 
                     /**
-                     * Returns a mutable builder for constructing an instance of [UpdateFile].
+                     * Returns a mutable builder for constructing an instance of [Program].
                      *
                      * The following fields are required:
                      * ```java
-                     * .diff()
-                     * .path()
+                     * .callerId()
                      * ```
                      */
                     @JvmStatic fun builder() = Builder()
                 }
 
-                /** A builder for [UpdateFile]. */
+                /** A builder for [Program]. */
                 class Builder internal constructor() {
 
-                    private var diff: JsonField<String>? = null
-                    private var path: JsonField<String>? = null
-                    private var type: JsonValue = JsonValue.from("update_file")
+                    private var callerId: JsonField<String>? = null
+                    private var type: JsonValue = JsonValue.from("program")
                     private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
                     @JvmSynthetic
-                    internal fun from(updateFile: UpdateFile) = apply {
-                        diff = updateFile.diff
-                        path = updateFile.path
-                        type = updateFile.type
-                        additionalProperties = updateFile.additionalProperties.toMutableMap()
+                    internal fun from(program: Program) = apply {
+                        callerId = program.callerId
+                        type = program.type
+                        additionalProperties = program.additionalProperties.toMutableMap()
                     }
 
-                    /** Unified diff content to apply to the existing file. */
-                    fun diff(diff: String) = diff(JsonField.of(diff))
-
-                    /**
-                     * Sets [Builder.diff] to an arbitrary JSON value.
-                     *
-                     * You should usually call [Builder.diff] with a well-typed [String] value
-                     * instead. This method is primarily for setting the field to an undocumented or
-                     * not yet supported value.
-                     */
-                    fun diff(diff: JsonField<String>) = apply { this.diff = diff }
-
-                    /** Path of the file to update relative to the workspace root. */
-                    fun path(path: String) = path(JsonField.of(path))
+                    /** The call ID of the program item that produced this tool call. */
+                    fun callerId(callerId: String) = callerId(JsonField.of(callerId))
 
                     /**
-                     * Sets [Builder.path] to an arbitrary JSON value.
+                     * Sets [Builder.callerId] to an arbitrary JSON value.
                      *
-                     * You should usually call [Builder.path] with a well-typed [String] value
+                     * You should usually call [Builder.callerId] with a well-typed [String] value
                      * instead. This method is primarily for setting the field to an undocumented or
                      * not yet supported value.
                      */
-                    fun path(path: JsonField<String>) = apply { this.path = path }
+                    fun callerId(callerId: JsonField<String>) = apply { this.callerId = callerId }
 
                     /**
                      * Sets the field to an arbitrary JSON value.
@@ -9497,7 +12657,7 @@ private constructor(
                      * It is usually unnecessary to call this method because the field defaults to
                      * the following:
                      * ```java
-                     * JsonValue.from("update_file")
+                     * JsonValue.from("program")
                      * ```
                      *
                      * This method is primarily for setting the field to an undocumented or not yet
@@ -9528,22 +12688,20 @@ private constructor(
                     }
 
                     /**
-                     * Returns an immutable instance of [UpdateFile].
+                     * Returns an immutable instance of [Program].
                      *
                      * Further updates to this [Builder] will not mutate the returned instance.
                      *
                      * The following fields are required:
                      * ```java
-                     * .diff()
-                     * .path()
+                     * .callerId()
                      * ```
                      *
                      * @throws IllegalStateException if any required field is unset.
                      */
-                    fun build(): UpdateFile =
-                        UpdateFile(
-                            checkRequired("diff", diff),
-                            checkRequired("path", path),
+                    fun build(): Program =
+                        Program(
+                            checkRequired("callerId", callerId),
                             type,
                             additionalProperties.toMutableMap(),
                         )
@@ -9561,15 +12719,14 @@ private constructor(
                  * @throws OpenAIInvalidDataException if any value type in this object doesn't match
                  *   its expected type.
                  */
-                fun validate(): UpdateFile = apply {
+                fun validate(): Program = apply {
                     if (validated) {
                         return@apply
                     }
 
-                    diff()
-                    path()
+                    callerId()
                     _type().let {
-                        if (it != JsonValue.from("update_file")) {
+                        if (it != JsonValue.from("program")) {
                             throw OpenAIInvalidDataException("'type' is invalid, received $it")
                         }
                     }
@@ -9592,171 +12749,29 @@ private constructor(
                  */
                 @JvmSynthetic
                 internal fun validity(): Int =
-                    (if (diff.asKnown().isPresent) 1 else 0) +
-                        (if (path.asKnown().isPresent) 1 else 0) +
-                        type.let { if (it == JsonValue.from("update_file")) 1 else 0 }
+                    (if (callerId.asKnown().isPresent) 1 else 0) +
+                        type.let { if (it == JsonValue.from("program")) 1 else 0 }
 
                 override fun equals(other: Any?): Boolean {
                     if (this === other) {
                         return true
                     }
 
-                    return other is UpdateFile &&
-                        diff == other.diff &&
-                        path == other.path &&
+                    return other is Program &&
+                        callerId == other.callerId &&
                         type == other.type &&
                         additionalProperties == other.additionalProperties
                 }
 
                 private val hashCode: Int by lazy {
-                    Objects.hash(diff, path, type, additionalProperties)
+                    Objects.hash(callerId, type, additionalProperties)
                 }
 
                 override fun hashCode(): Int = hashCode
 
                 override fun toString() =
-                    "UpdateFile{diff=$diff, path=$path, type=$type, additionalProperties=$additionalProperties}"
-            }
-        }
-
-        /** The status of the apply patch tool call. One of `in_progress` or `completed`. */
-        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
-
-            /**
-             * Returns this class instance's raw value.
-             *
-             * This is usually only useful if this instance was deserialized from data that doesn't
-             * match any known member, and you want to know that value. For example, if the SDK is
-             * on an older version than the API, then the API may respond with new members that the
-             * SDK is unaware of.
-             */
-            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
-
-            companion object {
-
-                @JvmField val IN_PROGRESS = of("in_progress")
-
-                @JvmField val COMPLETED = of("completed")
-
-                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
-            }
-
-            /** An enum containing [Status]'s known values. */
-            enum class Known {
-                IN_PROGRESS,
-                COMPLETED,
-            }
-
-            /**
-             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
-             *
-             * An instance of [Status] can contain an unknown value in a couple of cases:
-             * - It was deserialized from data that doesn't match any known member. For example, if
-             *   the SDK is on an older version than the API, then the API may respond with new
-             *   members that the SDK is unaware of.
-             * - It was constructed with an arbitrary value using the [of] method.
-             */
-            enum class Value {
-                IN_PROGRESS,
-                COMPLETED,
-                /**
-                 * An enum member indicating that [Status] was instantiated with an unknown value.
-                 */
-                _UNKNOWN,
-            }
-
-            /**
-             * Returns an enum member corresponding to this class instance's value, or
-             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
-             *
-             * Use the [known] method instead if you're certain the value is always known or if you
-             * want to throw for the unknown case.
-             */
-            fun value(): Value =
-                when (this) {
-                    IN_PROGRESS -> Value.IN_PROGRESS
-                    COMPLETED -> Value.COMPLETED
-                    else -> Value._UNKNOWN
-                }
-
-            /**
-             * Returns an enum member corresponding to this class instance's value.
-             *
-             * Use the [value] method instead if you're uncertain the value is always known and
-             * don't want to throw for the unknown case.
-             *
-             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
-             *   member.
-             */
-            fun known(): Known =
-                when (this) {
-                    IN_PROGRESS -> Known.IN_PROGRESS
-                    COMPLETED -> Known.COMPLETED
-                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
-                }
-
-            /**
-             * Returns this class instance's primitive wire representation.
-             *
-             * This differs from the [toString] method because that method is primarily for
-             * debugging and generally doesn't throw.
-             *
-             * @throws OpenAIInvalidDataException if this class instance's value does not have the
-             *   expected primitive type.
-             */
-            fun asString(): String =
-                _value().asString().orElseThrow {
-                    OpenAIInvalidDataException("Value is not a String")
-                }
-
-            private var validated: Boolean = false
-
-            /**
-             * Validates that the types of all values in this object match their expected types
-             * recursively.
-             *
-             * This method is _not_ forwards compatible with new types from the API for existing
-             * fields.
-             *
-             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-             *   expected type.
-             */
-            fun validate(): Status = apply {
-                if (validated) {
-                    return@apply
-                }
-
-                known()
-                validated = true
-            }
-
-            fun isValid(): Boolean =
-                try {
-                    validate()
-                    true
-                } catch (e: OpenAIInvalidDataException) {
-                    false
-                }
-
-            /**
-             * Returns a score indicating how many valid values are contained in this object
-             * recursively.
-             *
-             * Used for best match union deserialization.
-             */
-            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
-
-            override fun equals(other: Any?): Boolean {
-                if (this === other) {
-                    return true
-                }
-
-                return other is Status && value == other.value
+                    "Program{callerId=$callerId, type=$type, additionalProperties=$additionalProperties}"
             }
-
-            override fun hashCode() = value.hashCode()
-
-            override fun toString() = value.toString()
         }
 
         override fun equals(other: Any?): Boolean {
@@ -9764,68 +12779,79 @@ private constructor(
                 return true
             }
 
-            return other is ApplyPatchCall &&
+            return other is ApplyPatchCallOutput &&
                 callId == other.callId &&
-                operation == other.operation &&
                 status == other.status &&
                 type == other.type &&
                 id == other.id &&
+                caller == other.caller &&
+                output == other.output &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(callId, operation, status, type, id, additionalProperties)
+            Objects.hash(callId, status, type, id, caller, output, additionalProperties)
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "ApplyPatchCall{callId=$callId, operation=$operation, status=$status, type=$type, id=$id, additionalProperties=$additionalProperties}"
+            "ApplyPatchCallOutput{callId=$callId, status=$status, type=$type, id=$id, caller=$caller, output=$output, additionalProperties=$additionalProperties}"
     }
 
-    /** The streamed output emitted by an apply patch tool call. */
-    class ApplyPatchCallOutput
+    /** A list of tools available on an MCP server. */
+    class McpListTools
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
-        private val callId: JsonField<String>,
-        private val status: JsonField<Status>,
-        private val type: JsonValue,
         private val id: JsonField<String>,
-        private val output: JsonField<String>,
+        private val serverLabel: JsonField<String>,
+        private val tools: JsonField<List<Tool>>,
+        private val type: JsonValue,
+        private val error: JsonField<String>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
         @JsonCreator
         private constructor(
-            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
-            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
             @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("output") @ExcludeMissing output: JsonField<String> = JsonMissing.of(),
-        ) : this(callId, status, type, id, output, mutableMapOf())
+            @JsonProperty("server_label")
+            @ExcludeMissing
+            serverLabel: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("tools") @ExcludeMissing tools: JsonField<List<Tool>> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("error") @ExcludeMissing error: JsonField<String> = JsonMissing.of(),
+        ) : this(id, serverLabel, tools, type, error, mutableMapOf())
 
         /**
-         * The unique ID of the apply patch tool call generated by the model.
+         * The unique ID of the list.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun callId(): String = callId.getRequired("call_id")
+        fun id(): String = id.getRequired("id")
 
         /**
-         * The status of the apply patch tool call output. One of `completed` or `failed`.
+         * The label of the MCP server.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun status(): Status = status.getRequired("status")
+        fun serverLabel(): String = serverLabel.getRequired("server_label")
 
         /**
-         * The type of the item. Always `apply_patch_call_output`.
+         * The tools available on the server.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun tools(): List<Tool> = tools.getRequired("tools")
+
+        /**
+         * The type of the item. Always `mcp_list_tools`.
          *
          * Expected to always return the following:
          * ```java
-         * JsonValue.from("apply_patch_call_output")
+         * JsonValue.from("mcp_list_tools")
          * ```
          *
          * However, this method can be useful for debugging and logging (e.g. if the server
@@ -9834,50 +12860,42 @@ private constructor(
         @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
         /**
-         * The unique ID of the apply patch tool call output. Populated when this item is returned
-         * via API.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun id(): Optional<String> = id.getOptional("id")
-
-        /**
-         * Optional human-readable log text from the apply patch tool (e.g., patch results or
-         * errors).
+         * Error message if the server could not list tools.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
-        fun output(): Optional<String> = output.getOptional("output")
+        fun error(): Optional<String> = error.getOptional("error")
 
         /**
-         * Returns the raw JSON value of [callId].
+         * Returns the raw JSON value of [id].
          *
-         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
         /**
-         * Returns the raw JSON value of [status].
+         * Returns the raw JSON value of [serverLabel].
          *
-         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+        @JsonProperty("server_label")
+        @ExcludeMissing
+        fun _serverLabel(): JsonField<String> = serverLabel
 
         /**
-         * Returns the raw JSON value of [id].
+         * Returns the raw JSON value of [tools].
          *
-         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+        @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<Tool>> = tools
 
         /**
-         * Returns the raw JSON value of [output].
+         * Returns the raw JSON value of [error].
          *
-         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<String> = output
+        @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<String> = error
 
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
@@ -9894,60 +12912,89 @@ private constructor(
         companion object {
 
             /**
-             * Returns a mutable builder for constructing an instance of [ApplyPatchCallOutput].
+             * Returns a mutable builder for constructing an instance of [McpListTools].
              *
              * The following fields are required:
              * ```java
-             * .callId()
-             * .status()
+             * .id()
+             * .serverLabel()
+             * .tools()
              * ```
              */
             @JvmStatic fun builder() = Builder()
         }
 
-        /** A builder for [ApplyPatchCallOutput]. */
+        /** A builder for [McpListTools]. */
         class Builder internal constructor() {
 
-            private var callId: JsonField<String>? = null
-            private var status: JsonField<Status>? = null
-            private var type: JsonValue = JsonValue.from("apply_patch_call_output")
-            private var id: JsonField<String> = JsonMissing.of()
-            private var output: JsonField<String> = JsonMissing.of()
+            private var id: JsonField<String>? = null
+            private var serverLabel: JsonField<String>? = null
+            private var tools: JsonField<MutableList<Tool>>? = null
+            private var type: JsonValue = JsonValue.from("mcp_list_tools")
+            private var error: JsonField<String> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
-            internal fun from(applyPatchCallOutput: ApplyPatchCallOutput) = apply {
-                callId = applyPatchCallOutput.callId
-                status = applyPatchCallOutput.status
-                type = applyPatchCallOutput.type
-                id = applyPatchCallOutput.id
-                output = applyPatchCallOutput.output
-                additionalProperties = applyPatchCallOutput.additionalProperties.toMutableMap()
+            internal fun from(mcpListTools: McpListTools) = apply {
+                id = mcpListTools.id
+                serverLabel = mcpListTools.serverLabel
+                tools = mcpListTools.tools.map { it.toMutableList() }
+                type = mcpListTools.type
+                error = mcpListTools.error
+                additionalProperties = mcpListTools.additionalProperties.toMutableMap()
             }
 
-            /** The unique ID of the apply patch tool call generated by the model. */
-            fun callId(callId: String) = callId(JsonField.of(callId))
+            /** The unique ID of the list. */
+            fun id(id: String) = id(JsonField.of(id))
 
             /**
-             * Sets [Builder.callId] to an arbitrary JSON value.
+             * Sets [Builder.id] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.callId] with a well-typed [String] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The label of the MCP server. */
+            fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
+
+            /**
+             * Sets [Builder.serverLabel] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serverLabel] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+            fun serverLabel(serverLabel: JsonField<String>) = apply {
+                this.serverLabel = serverLabel
+            }
 
-            /** The status of the apply patch tool call output. One of `completed` or `failed`. */
-            fun status(status: Status) = status(JsonField.of(status))
+            /** The tools available on the server. */
+            fun tools(tools: List<Tool>) = tools(JsonField.of(tools))
 
             /**
-             * Sets [Builder.status] to an arbitrary JSON value.
+             * Sets [Builder.tools] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * You should usually call [Builder.tools] with a well-typed `List<Tool>` value instead.
              * This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun status(status: JsonField<Status>) = apply { this.status = status }
+            fun tools(tools: JsonField<List<Tool>>) = apply {
+                this.tools = tools.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [Tool] to [tools].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addTool(tool: Tool) = apply {
+                tools =
+                    (tools ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("tools", it).add(tool)
+                    }
+            }
 
             /**
              * Sets the field to an arbitrary JSON value.
@@ -9955,7 +13002,7 @@ private constructor(
              * It is usually unnecessary to call this method because the field defaults to the
              * following:
              * ```java
-             * JsonValue.from("apply_patch_call_output")
+             * JsonValue.from("mcp_list_tools")
              * ```
              *
              * This method is primarily for setting the field to an undocumented or not yet
@@ -9963,41 +13010,20 @@ private constructor(
              */
             fun type(type: JsonValue) = apply { this.type = type }
 
-            /**
-             * The unique ID of the apply patch tool call output. Populated when this item is
-             * returned via API.
-             */
-            fun id(id: String?) = id(JsonField.ofNullable(id))
-
-            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
-            fun id(id: Optional<String>) = id(id.getOrNull())
-
-            /**
-             * Sets [Builder.id] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.id] with a well-typed [String] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
-             */
-            fun id(id: JsonField<String>) = apply { this.id = id }
-
-            /**
-             * Optional human-readable log text from the apply patch tool (e.g., patch results or
-             * errors).
-             */
-            fun output(output: String?) = output(JsonField.ofNullable(output))
+            /** Error message if the server could not list tools. */
+            fun error(error: String?) = error(JsonField.ofNullable(error))
 
-            /** Alias for calling [Builder.output] with `output.orElse(null)`. */
-            fun output(output: Optional<String>) = output(output.getOrNull())
+            /** Alias for calling [Builder.error] with `error.orElse(null)`. */
+            fun error(error: Optional<String>) = error(error.getOrNull())
 
             /**
-             * Sets [Builder.output] to an arbitrary JSON value.
+             * Sets [Builder.error] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.output] with a well-typed [String] value instead.
+             * You should usually call [Builder.error] with a well-typed [String] value instead.
              * This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun output(output: JsonField<String>) = apply { this.output = output }
+            fun error(error: JsonField<String>) = apply { this.error = error }
 
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
@@ -10019,169 +13045,289 @@ private constructor(
             }
 
             /**
-             * Returns an immutable instance of [ApplyPatchCallOutput].
+             * Returns an immutable instance of [McpListTools].
              *
              * Further updates to this [Builder] will not mutate the returned instance.
              *
              * The following fields are required:
              * ```java
-             * .callId()
-             * .status()
+             * .id()
+             * .serverLabel()
+             * .tools()
              * ```
              *
              * @throws IllegalStateException if any required field is unset.
              */
-            fun build(): ApplyPatchCallOutput =
-                ApplyPatchCallOutput(
-                    checkRequired("callId", callId),
-                    checkRequired("status", status),
+            fun build(): McpListTools =
+                McpListTools(
+                    checkRequired("id", id),
+                    checkRequired("serverLabel", serverLabel),
+                    checkRequired("tools", tools).map { it.toImmutable() },
                     type,
-                    id,
-                    output,
+                    error,
                     additionalProperties.toMutableMap(),
                 )
         }
 
         private var validated: Boolean = false
 
-        /**
-         * Validates that the types of all values in this object match their expected types
-         * recursively.
-         *
-         * This method is _not_ forwards compatible with new types from the API for existing fields.
-         *
-         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-         *   expected type.
-         */
-        fun validate(): ApplyPatchCallOutput = apply {
-            if (validated) {
-                return@apply
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): McpListTools = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            serverLabel()
+            tools().forEach { it.validate() }
+            _type().let {
+                if (it != JsonValue.from("mcp_list_tools")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            error()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (serverLabel.asKnown().isPresent) 1 else 0) +
+                (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
+                type.let { if (it == JsonValue.from("mcp_list_tools")) 1 else 0 } +
+                (if (error.asKnown().isPresent) 1 else 0)
+
+        /** A tool available on an MCP server. */
+        class Tool
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val inputSchema: JsonValue,
+            private val name: JsonField<String>,
+            private val annotations: JsonValue,
+            private val description: JsonField<String>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("input_schema")
+                @ExcludeMissing
+                inputSchema: JsonValue = JsonMissing.of(),
+                @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+                @JsonProperty("annotations")
+                @ExcludeMissing
+                annotations: JsonValue = JsonMissing.of(),
+                @JsonProperty("description")
+                @ExcludeMissing
+                description: JsonField<String> = JsonMissing.of(),
+            ) : this(inputSchema, name, annotations, description, mutableMapOf())
+
+            /**
+             * The JSON schema describing the tool's input.
+             *
+             * This arbitrary value can be deserialized into a custom type using the `convert`
+             * method:
+             * ```java
+             * MyClass myObject = tool.inputSchema().convert(MyClass.class);
+             * ```
+             */
+            @JsonProperty("input_schema")
+            @ExcludeMissing
+            fun _inputSchema(): JsonValue = inputSchema
+
+            /**
+             * The name of the tool.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+             *   value).
+             */
+            fun name(): String = name.getRequired("name")
+
+            /**
+             * Additional annotations about the tool.
+             *
+             * This arbitrary value can be deserialized into a custom type using the `convert`
+             * method:
+             * ```java
+             * MyClass myObject = tool.annotations().convert(MyClass.class);
+             * ```
+             */
+            @JsonProperty("annotations") @ExcludeMissing fun _annotations(): JsonValue = annotations
+
+            /**
+             * The description of the tool.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun description(): Optional<String> = description.getOptional("description")
+
+            /**
+             * Returns the raw JSON value of [name].
+             *
+             * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+            /**
+             * Returns the raw JSON value of [description].
+             *
+             * Unlike [description], this method doesn't throw if the JSON field has an unexpected
+             * type.
+             */
+            @JsonProperty("description")
+            @ExcludeMissing
+            fun _description(): JsonField<String> = description
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
             }
 
-            callId()
-            status().validate()
-            _type().let {
-                if (it != JsonValue.from("apply_patch_call_output")) {
-                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
-                }
-            }
-            id()
-            output()
-            validated = true
-        }
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
 
-        fun isValid(): Boolean =
-            try {
-                validate()
-                true
-            } catch (e: OpenAIInvalidDataException) {
-                false
+            fun toBuilder() = Builder().from(this)
+
+            companion object {
+
+                /**
+                 * Returns a mutable builder for constructing an instance of [Tool].
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .inputSchema()
+                 * .name()
+                 * ```
+                 */
+                @JvmStatic fun builder() = Builder()
             }
 
-        /**
-         * Returns a score indicating how many valid values are contained in this object
-         * recursively.
-         *
-         * Used for best match union deserialization.
-         */
-        @JvmSynthetic
-        internal fun validity(): Int =
-            (if (callId.asKnown().isPresent) 1 else 0) +
-                (status.asKnown().getOrNull()?.validity() ?: 0) +
-                type.let { if (it == JsonValue.from("apply_patch_call_output")) 1 else 0 } +
-                (if (id.asKnown().isPresent) 1 else 0) +
-                (if (output.asKnown().isPresent) 1 else 0)
+            /** A builder for [Tool]. */
+            class Builder internal constructor() {
 
-        /** The status of the apply patch tool call output. One of `completed` or `failed`. */
-        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+                private var inputSchema: JsonValue? = null
+                private var name: JsonField<String>? = null
+                private var annotations: JsonValue = JsonMissing.of()
+                private var description: JsonField<String> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
-            /**
-             * Returns this class instance's raw value.
-             *
-             * This is usually only useful if this instance was deserialized from data that doesn't
-             * match any known member, and you want to know that value. For example, if the SDK is
-             * on an older version than the API, then the API may respond with new members that the
-             * SDK is unaware of.
-             */
-            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+                @JvmSynthetic
+                internal fun from(tool: Tool) = apply {
+                    inputSchema = tool.inputSchema
+                    name = tool.name
+                    annotations = tool.annotations
+                    description = tool.description
+                    additionalProperties = tool.additionalProperties.toMutableMap()
+                }
 
-            companion object {
+                /** The JSON schema describing the tool's input. */
+                fun inputSchema(inputSchema: JsonValue) = apply { this.inputSchema = inputSchema }
 
-                @JvmField val COMPLETED = of("completed")
+                /** The name of the tool. */
+                fun name(name: String) = name(JsonField.of(name))
 
-                @JvmField val FAILED = of("failed")
+                /**
+                 * Sets [Builder.name] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.name] with a well-typed [String] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun name(name: JsonField<String>) = apply { this.name = name }
 
-                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
-            }
+                /** Additional annotations about the tool. */
+                fun annotations(annotations: JsonValue) = apply { this.annotations = annotations }
 
-            /** An enum containing [Status]'s known values. */
-            enum class Known {
-                COMPLETED,
-                FAILED,
-            }
+                /** The description of the tool. */
+                fun description(description: String?) =
+                    description(JsonField.ofNullable(description))
+
+                /** Alias for calling [Builder.description] with `description.orElse(null)`. */
+                fun description(description: Optional<String>) =
+                    description(description.getOrNull())
 
-            /**
-             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
-             *
-             * An instance of [Status] can contain an unknown value in a couple of cases:
-             * - It was deserialized from data that doesn't match any known member. For example, if
-             *   the SDK is on an older version than the API, then the API may respond with new
-             *   members that the SDK is unaware of.
-             * - It was constructed with an arbitrary value using the [of] method.
-             */
-            enum class Value {
-                COMPLETED,
-                FAILED,
                 /**
-                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 * Sets [Builder.description] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.description] with a well-typed [String] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
                  */
-                _UNKNOWN,
-            }
+                fun description(description: JsonField<String>) = apply {
+                    this.description = description
+                }
 
-            /**
-             * Returns an enum member corresponding to this class instance's value, or
-             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
-             *
-             * Use the [known] method instead if you're certain the value is always known or if you
-             * want to throw for the unknown case.
-             */
-            fun value(): Value =
-                when (this) {
-                    COMPLETED -> Value.COMPLETED
-                    FAILED -> Value.FAILED
-                    else -> Value._UNKNOWN
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
                 }
 
-            /**
-             * Returns an enum member corresponding to this class instance's value.
-             *
-             * Use the [value] method instead if you're uncertain the value is always known and
-             * don't want to throw for the unknown case.
-             *
-             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
-             *   member.
-             */
-            fun known(): Known =
-                when (this) {
-                    COMPLETED -> Known.COMPLETED
-                    FAILED -> Known.FAILED
-                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
                 }
 
-            /**
-             * Returns this class instance's primitive wire representation.
-             *
-             * This differs from the [toString] method because that method is primarily for
-             * debugging and generally doesn't throw.
-             *
-             * @throws OpenAIInvalidDataException if this class instance's value does not have the
-             *   expected primitive type.
-             */
-            fun asString(): String =
-                _value().asString().orElseThrow {
-                    OpenAIInvalidDataException("Value is not a String")
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
+
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
                 }
 
+                /**
+                 * Returns an immutable instance of [Tool].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 *
+                 * The following fields are required:
+                 * ```java
+                 * .inputSchema()
+                 * .name()
+                 * ```
+                 *
+                 * @throws IllegalStateException if any required field is unset.
+                 */
+                fun build(): Tool =
+                    Tool(
+                        checkRequired("inputSchema", inputSchema),
+                        checkRequired("name", name),
+                        annotations,
+                        description,
+                        additionalProperties.toMutableMap(),
+                    )
+            }
+
             private var validated: Boolean = false
 
             /**
@@ -10194,12 +13340,13 @@ private constructor(
              * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
              *   expected type.
              */
-            fun validate(): Status = apply {
+            fun validate(): Tool = apply {
                 if (validated) {
                     return@apply
                 }
 
-                known()
+                name()
+                description()
                 validated = true
             }
 
@@ -10217,19 +13364,32 @@ private constructor(
              *
              * Used for best match union deserialization.
              */
-            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (if (name.asKnown().isPresent) 1 else 0) +
+                    (if (description.asKnown().isPresent) 1 else 0)
 
             override fun equals(other: Any?): Boolean {
                 if (this === other) {
                     return true
                 }
 
-                return other is Status && value == other.value
+                return other is Tool &&
+                    inputSchema == other.inputSchema &&
+                    name == other.name &&
+                    annotations == other.annotations &&
+                    description == other.description &&
+                    additionalProperties == other.additionalProperties
             }
 
-            override fun hashCode() = value.hashCode()
+            private val hashCode: Int by lazy {
+                Objects.hash(inputSchema, name, annotations, description, additionalProperties)
+            }
 
-            override fun toString() = value.toString()
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Tool{inputSchema=$inputSchema, name=$name, annotations=$annotations, description=$description, additionalProperties=$additionalProperties}"
         }
 
         override fun equals(other: Any?): Boolean {
@@ -10237,50 +13397,52 @@ private constructor(
                 return true
             }
 
-            return other is ApplyPatchCallOutput &&
-                callId == other.callId &&
-                status == other.status &&
-                type == other.type &&
+            return other is McpListTools &&
                 id == other.id &&
-                output == other.output &&
+                serverLabel == other.serverLabel &&
+                tools == other.tools &&
+                type == other.type &&
+                error == other.error &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(callId, status, type, id, output, additionalProperties)
+            Objects.hash(id, serverLabel, tools, type, error, additionalProperties)
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "ApplyPatchCallOutput{callId=$callId, status=$status, type=$type, id=$id, output=$output, additionalProperties=$additionalProperties}"
+            "McpListTools{id=$id, serverLabel=$serverLabel, tools=$tools, type=$type, error=$error, additionalProperties=$additionalProperties}"
     }
 
-    /** A list of tools available on an MCP server. */
-    class McpListTools
+    /** A request for human approval of a tool invocation. */
+    class McpApprovalRequest
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
         private val id: JsonField<String>,
+        private val arguments: JsonField<String>,
+        private val name: JsonField<String>,
         private val serverLabel: JsonField<String>,
-        private val tools: JsonField<List<Tool>>,
         private val type: JsonValue,
-        private val error: JsonField<String>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
         @JsonCreator
         private constructor(
             @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("arguments")
+            @ExcludeMissing
+            arguments: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
             @JsonProperty("server_label")
             @ExcludeMissing
             serverLabel: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("tools") @ExcludeMissing tools: JsonField<List<Tool>> = JsonMissing.of(),
             @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-            @JsonProperty("error") @ExcludeMissing error: JsonField<String> = JsonMissing.of(),
-        ) : this(id, serverLabel, tools, type, error, mutableMapOf())
+        ) : this(id, arguments, name, serverLabel, type, mutableMapOf())
 
         /**
-         * The unique ID of the list.
+         * The unique ID of the approval request.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -10288,654 +13450,348 @@ private constructor(
         fun id(): String = id.getRequired("id")
 
         /**
-         * The label of the MCP server.
+         * A JSON string of arguments for the tool.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun serverLabel(): String = serverLabel.getRequired("server_label")
+        fun arguments(): String = arguments.getRequired("arguments")
 
         /**
-         * The tools available on the server.
+         * The name of the tool to run.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun tools(): List<Tool> = tools.getRequired("tools")
-
-        /**
-         * The type of the item. Always `mcp_list_tools`.
-         *
-         * Expected to always return the following:
-         * ```java
-         * JsonValue.from("mcp_list_tools")
-         * ```
-         *
-         * However, this method can be useful for debugging and logging (e.g. if the server
-         * responded with an unexpected value).
-         */
-        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
-
-        /**
-         * Error message if the server could not list tools.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun error(): Optional<String> = error.getOptional("error")
-
-        /**
-         * Returns the raw JSON value of [id].
-         *
-         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
-
-        /**
-         * Returns the raw JSON value of [serverLabel].
-         *
-         * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("server_label")
-        @ExcludeMissing
-        fun _serverLabel(): JsonField<String> = serverLabel
+        fun name(): String = name.getRequired("name")
 
         /**
-         * Returns the raw JSON value of [tools].
+         * The label of the MCP server making the request.
          *
-         * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<Tool>> = tools
+        fun serverLabel(): String = serverLabel.getRequired("server_label")
 
         /**
-         * Returns the raw JSON value of [error].
+         * The type of the item. Always `mcp_approval_request`.
          *
-         * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<String> = error
-
-        @JsonAnySetter
-        private fun putAdditionalProperty(key: String, value: JsonValue) {
-            additionalProperties.put(key, value)
-        }
-
-        @JsonAnyGetter
-        @ExcludeMissing
-        fun _additionalProperties(): Map<String, JsonValue> =
-            Collections.unmodifiableMap(additionalProperties)
-
-        fun toBuilder() = Builder().from(this)
-
-        companion object {
-
-            /**
-             * Returns a mutable builder for constructing an instance of [McpListTools].
-             *
-             * The following fields are required:
-             * ```java
-             * .id()
-             * .serverLabel()
-             * .tools()
-             * ```
-             */
-            @JvmStatic fun builder() = Builder()
-        }
-
-        /** A builder for [McpListTools]. */
-        class Builder internal constructor() {
-
-            private var id: JsonField<String>? = null
-            private var serverLabel: JsonField<String>? = null
-            private var tools: JsonField<MutableList<Tool>>? = null
-            private var type: JsonValue = JsonValue.from("mcp_list_tools")
-            private var error: JsonField<String> = JsonMissing.of()
-            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-            @JvmSynthetic
-            internal fun from(mcpListTools: McpListTools) = apply {
-                id = mcpListTools.id
-                serverLabel = mcpListTools.serverLabel
-                tools = mcpListTools.tools.map { it.toMutableList() }
-                type = mcpListTools.type
-                error = mcpListTools.error
-                additionalProperties = mcpListTools.additionalProperties.toMutableMap()
-            }
-
-            /** The unique ID of the list. */
-            fun id(id: String) = id(JsonField.of(id))
-
-            /**
-             * Sets [Builder.id] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.id] with a well-typed [String] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
-             */
-            fun id(id: JsonField<String>) = apply { this.id = id }
-
-            /** The label of the MCP server. */
-            fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
-
-            /**
-             * Sets [Builder.serverLabel] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.serverLabel] with a well-typed [String] value
-             * instead. This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun serverLabel(serverLabel: JsonField<String>) = apply {
-                this.serverLabel = serverLabel
-            }
-
-            /** The tools available on the server. */
-            fun tools(tools: List<Tool>) = tools(JsonField.of(tools))
-
-            /**
-             * Sets [Builder.tools] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.tools] with a well-typed `List<Tool>` value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun tools(tools: JsonField<List<Tool>>) = apply {
-                this.tools = tools.map { it.toMutableList() }
-            }
-
-            /**
-             * Adds a single [Tool] to [tools].
-             *
-             * @throws IllegalStateException if the field was previously set to a non-list.
-             */
-            fun addTool(tool: Tool) = apply {
-                tools =
-                    (tools ?: JsonField.of(mutableListOf())).also {
-                        checkKnown("tools", it).add(tool)
-                    }
-            }
-
-            /**
-             * Sets the field to an arbitrary JSON value.
-             *
-             * It is usually unnecessary to call this method because the field defaults to the
-             * following:
-             * ```java
-             * JsonValue.from("mcp_list_tools")
-             * ```
-             *
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun type(type: JsonValue) = apply { this.type = type }
-
-            /** Error message if the server could not list tools. */
-            fun error(error: String?) = error(JsonField.ofNullable(error))
-
-            /** Alias for calling [Builder.error] with `error.orElse(null)`. */
-            fun error(error: Optional<String>) = error(error.getOrNull())
-
-            /**
-             * Sets [Builder.error] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.error] with a well-typed [String] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun error(error: JsonField<String>) = apply { this.error = error }
-
-            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                this.additionalProperties.clear()
-                putAllAdditionalProperties(additionalProperties)
-            }
-
-            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                additionalProperties.put(key, value)
-            }
-
-            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                this.additionalProperties.putAll(additionalProperties)
-            }
-
-            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
-
-            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                keys.forEach(::removeAdditionalProperty)
-            }
-
-            /**
-             * Returns an immutable instance of [McpListTools].
-             *
-             * Further updates to this [Builder] will not mutate the returned instance.
-             *
-             * The following fields are required:
-             * ```java
-             * .id()
-             * .serverLabel()
-             * .tools()
-             * ```
-             *
-             * @throws IllegalStateException if any required field is unset.
-             */
-            fun build(): McpListTools =
-                McpListTools(
-                    checkRequired("id", id),
-                    checkRequired("serverLabel", serverLabel),
-                    checkRequired("tools", tools).map { it.toImmutable() },
-                    type,
-                    error,
-                    additionalProperties.toMutableMap(),
-                )
-        }
-
-        private var validated: Boolean = false
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("mcp_approval_request")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
         /**
-         * Validates that the types of all values in this object match their expected types
-         * recursively.
-         *
-         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         * Returns the raw JSON value of [id].
          *
-         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-         *   expected type.
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
          */
-        fun validate(): McpListTools = apply {
-            if (validated) {
-                return@apply
-            }
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
-            id()
-            serverLabel()
-            tools().forEach { it.validate() }
-            _type().let {
-                if (it != JsonValue.from("mcp_list_tools")) {
-                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
-                }
-            }
-            error()
-            validated = true
-        }
+        /**
+         * Returns the raw JSON value of [arguments].
+         *
+         * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
 
-        fun isValid(): Boolean =
-            try {
-                validate()
-                true
-            } catch (e: OpenAIInvalidDataException) {
-                false
-            }
+        /**
+         * Returns the raw JSON value of [name].
+         *
+         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
 
         /**
-         * Returns a score indicating how many valid values are contained in this object
-         * recursively.
+         * Returns the raw JSON value of [serverLabel].
          *
-         * Used for best match union deserialization.
+         * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JvmSynthetic
-        internal fun validity(): Int =
-            (if (id.asKnown().isPresent) 1 else 0) +
-                (if (serverLabel.asKnown().isPresent) 1 else 0) +
-                (tools.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
-                type.let { if (it == JsonValue.from("mcp_list_tools")) 1 else 0 } +
-                (if (error.asKnown().isPresent) 1 else 0)
+        @JsonProperty("server_label")
+        @ExcludeMissing
+        fun _serverLabel(): JsonField<String> = serverLabel
 
-        /** A tool available on an MCP server. */
-        class Tool
-        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
-        private constructor(
-            private val inputSchema: JsonValue,
-            private val name: JsonField<String>,
-            private val annotations: JsonValue,
-            private val description: JsonField<String>,
-            private val additionalProperties: MutableMap<String, JsonValue>,
-        ) {
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
 
-            @JsonCreator
-            private constructor(
-                @JsonProperty("input_schema")
-                @ExcludeMissing
-                inputSchema: JsonValue = JsonMissing.of(),
-                @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
-                @JsonProperty("annotations")
-                @ExcludeMissing
-                annotations: JsonValue = JsonMissing.of(),
-                @JsonProperty("description")
-                @ExcludeMissing
-                description: JsonField<String> = JsonMissing.of(),
-            ) : this(inputSchema, name, annotations, description, mutableMapOf())
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
 
-            /**
-             * The JSON schema describing the tool's input.
-             *
-             * This arbitrary value can be deserialized into a custom type using the `convert`
-             * method:
-             * ```java
-             * MyClass myObject = tool.inputSchema().convert(MyClass.class);
-             * ```
-             */
-            @JsonProperty("input_schema")
-            @ExcludeMissing
-            fun _inputSchema(): JsonValue = inputSchema
+        fun toBuilder() = Builder().from(this)
 
-            /**
-             * The name of the tool.
-             *
-             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-             *   unexpectedly missing or null (e.g. if the server responded with an unexpected
-             *   value).
-             */
-            fun name(): String = name.getRequired("name")
+        companion object {
 
             /**
-             * Additional annotations about the tool.
+             * Returns a mutable builder for constructing an instance of [McpApprovalRequest].
              *
-             * This arbitrary value can be deserialized into a custom type using the `convert`
-             * method:
+             * The following fields are required:
              * ```java
-             * MyClass myObject = tool.annotations().convert(MyClass.class);
+             * .id()
+             * .arguments()
+             * .name()
+             * .serverLabel()
              * ```
              */
-            @JsonProperty("annotations") @ExcludeMissing fun _annotations(): JsonValue = annotations
-
-            /**
-             * The description of the tool.
-             *
-             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
-             *   the server responded with an unexpected value).
-             */
-            fun description(): Optional<String> = description.getOptional("description")
-
-            /**
-             * Returns the raw JSON value of [name].
-             *
-             * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
-             */
-            @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
-
-            /**
-             * Returns the raw JSON value of [description].
-             *
-             * Unlike [description], this method doesn't throw if the JSON field has an unexpected
-             * type.
-             */
-            @JsonProperty("description")
-            @ExcludeMissing
-            fun _description(): JsonField<String> = description
-
-            @JsonAnySetter
-            private fun putAdditionalProperty(key: String, value: JsonValue) {
-                additionalProperties.put(key, value)
-            }
-
-            @JsonAnyGetter
-            @ExcludeMissing
-            fun _additionalProperties(): Map<String, JsonValue> =
-                Collections.unmodifiableMap(additionalProperties)
+            @JvmStatic fun builder() = Builder()
+        }
 
-            fun toBuilder() = Builder().from(this)
+        /** A builder for [McpApprovalRequest]. */
+        class Builder internal constructor() {
 
-            companion object {
+            private var id: JsonField<String>? = null
+            private var arguments: JsonField<String>? = null
+            private var name: JsonField<String>? = null
+            private var serverLabel: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("mcp_approval_request")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
-                /**
-                 * Returns a mutable builder for constructing an instance of [Tool].
-                 *
-                 * The following fields are required:
-                 * ```java
-                 * .inputSchema()
-                 * .name()
-                 * ```
-                 */
-                @JvmStatic fun builder() = Builder()
+            @JvmSynthetic
+            internal fun from(mcpApprovalRequest: McpApprovalRequest) = apply {
+                id = mcpApprovalRequest.id
+                arguments = mcpApprovalRequest.arguments
+                name = mcpApprovalRequest.name
+                serverLabel = mcpApprovalRequest.serverLabel
+                type = mcpApprovalRequest.type
+                additionalProperties = mcpApprovalRequest.additionalProperties.toMutableMap()
             }
 
-            /** A builder for [Tool]. */
-            class Builder internal constructor() {
-
-                private var inputSchema: JsonValue? = null
-                private var name: JsonField<String>? = null
-                private var annotations: JsonValue = JsonMissing.of()
-                private var description: JsonField<String> = JsonMissing.of()
-                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
-
-                @JvmSynthetic
-                internal fun from(tool: Tool) = apply {
-                    inputSchema = tool.inputSchema
-                    name = tool.name
-                    annotations = tool.annotations
-                    description = tool.description
-                    additionalProperties = tool.additionalProperties.toMutableMap()
-                }
-
-                /** The JSON schema describing the tool's input. */
-                fun inputSchema(inputSchema: JsonValue) = apply { this.inputSchema = inputSchema }
-
-                /** The name of the tool. */
-                fun name(name: String) = name(JsonField.of(name))
-
-                /**
-                 * Sets [Builder.name] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.name] with a well-typed [String] value instead.
-                 * This method is primarily for setting the field to an undocumented or not yet
-                 * supported value.
-                 */
-                fun name(name: JsonField<String>) = apply { this.name = name }
-
-                /** Additional annotations about the tool. */
-                fun annotations(annotations: JsonValue) = apply { this.annotations = annotations }
-
-                /** The description of the tool. */
-                fun description(description: String?) =
-                    description(JsonField.ofNullable(description))
-
-                /** Alias for calling [Builder.description] with `description.orElse(null)`. */
-                fun description(description: Optional<String>) =
-                    description(description.getOrNull())
+            /** The unique ID of the approval request. */
+            fun id(id: String) = id(JsonField.of(id))
 
-                /**
-                 * Sets [Builder.description] to an arbitrary JSON value.
-                 *
-                 * You should usually call [Builder.description] with a well-typed [String] value
-                 * instead. This method is primarily for setting the field to an undocumented or not
-                 * yet supported value.
-                 */
-                fun description(description: JsonField<String>) = apply {
-                    this.description = description
-                }
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
 
-                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
-                    this.additionalProperties.clear()
-                    putAllAdditionalProperties(additionalProperties)
-                }
+            /** A JSON string of arguments for the tool. */
+            fun arguments(arguments: String) = arguments(JsonField.of(arguments))
 
-                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
-                    additionalProperties.put(key, value)
-                }
+            /**
+             * Sets [Builder.arguments] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.arguments] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
 
-                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
-                    apply {
-                        this.additionalProperties.putAll(additionalProperties)
-                    }
+            /** The name of the tool to run. */
+            fun name(name: String) = name(JsonField.of(name))
 
-                fun removeAdditionalProperty(key: String) = apply {
-                    additionalProperties.remove(key)
-                }
+            /**
+             * Sets [Builder.name] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.name] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun name(name: JsonField<String>) = apply { this.name = name }
 
-                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
-                    keys.forEach(::removeAdditionalProperty)
-                }
+            /** The label of the MCP server making the request. */
+            fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
 
-                /**
-                 * Returns an immutable instance of [Tool].
-                 *
-                 * Further updates to this [Builder] will not mutate the returned instance.
-                 *
-                 * The following fields are required:
-                 * ```java
-                 * .inputSchema()
-                 * .name()
-                 * ```
-                 *
-                 * @throws IllegalStateException if any required field is unset.
-                 */
-                fun build(): Tool =
-                    Tool(
-                        checkRequired("inputSchema", inputSchema),
-                        checkRequired("name", name),
-                        annotations,
-                        description,
-                        additionalProperties.toMutableMap(),
-                    )
+            /**
+             * Sets [Builder.serverLabel] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serverLabel] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun serverLabel(serverLabel: JsonField<String>) = apply {
+                this.serverLabel = serverLabel
             }
 
-            private var validated: Boolean = false
-
             /**
-             * Validates that the types of all values in this object match their expected types
-             * recursively.
+             * Sets the field to an arbitrary JSON value.
              *
-             * This method is _not_ forwards compatible with new types from the API for existing
-             * fields.
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("mcp_approval_request")
+             * ```
              *
-             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-             *   expected type.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            fun validate(): Tool = apply {
-                if (validated) {
-                    return@apply
-                }
+            fun type(type: JsonValue) = apply { this.type = type }
 
-                name()
-                description()
-                validated = true
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
             }
 
-            fun isValid(): Boolean =
-                try {
-                    validate()
-                    true
-                } catch (e: OpenAIInvalidDataException) {
-                    false
-                }
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
 
             /**
-             * Returns a score indicating how many valid values are contained in this object
-             * recursively.
+             * Returns an immutable instance of [McpApprovalRequest].
              *
-             * Used for best match union deserialization.
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .arguments()
+             * .name()
+             * .serverLabel()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
              */
-            @JvmSynthetic
-            internal fun validity(): Int =
-                (if (name.asKnown().isPresent) 1 else 0) +
-                    (if (description.asKnown().isPresent) 1 else 0)
+            fun build(): McpApprovalRequest =
+                McpApprovalRequest(
+                    checkRequired("id", id),
+                    checkRequired("arguments", arguments),
+                    checkRequired("name", name),
+                    checkRequired("serverLabel", serverLabel),
+                    type,
+                    additionalProperties.toMutableMap(),
+                )
+        }
 
-            override fun equals(other: Any?): Boolean {
-                if (this === other) {
-                    return true
-                }
+        private var validated: Boolean = false
 
-                return other is Tool &&
-                    inputSchema == other.inputSchema &&
-                    name == other.name &&
-                    annotations == other.annotations &&
-                    description == other.description &&
-                    additionalProperties == other.additionalProperties
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): McpApprovalRequest = apply {
+            if (validated) {
+                return@apply
             }
 
-            private val hashCode: Int by lazy {
-                Objects.hash(inputSchema, name, annotations, description, additionalProperties)
+            id()
+            arguments()
+            name()
+            serverLabel()
+            _type().let {
+                if (it != JsonValue.from("mcp_approval_request")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
             }
+            validated = true
+        }
 
-            override fun hashCode(): Int = hashCode
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
 
-            override fun toString() =
-                "Tool{inputSchema=$inputSchema, name=$name, annotations=$annotations, description=$description, additionalProperties=$additionalProperties}"
-        }
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (arguments.asKnown().isPresent) 1 else 0) +
+                (if (name.asKnown().isPresent) 1 else 0) +
+                (if (serverLabel.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("mcp_approval_request")) 1 else 0 }
 
         override fun equals(other: Any?): Boolean {
             if (this === other) {
                 return true
             }
 
-            return other is McpListTools &&
+            return other is McpApprovalRequest &&
                 id == other.id &&
+                arguments == other.arguments &&
+                name == other.name &&
                 serverLabel == other.serverLabel &&
-                tools == other.tools &&
                 type == other.type &&
-                error == other.error &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(id, serverLabel, tools, type, error, additionalProperties)
+            Objects.hash(id, arguments, name, serverLabel, type, additionalProperties)
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "McpListTools{id=$id, serverLabel=$serverLabel, tools=$tools, type=$type, error=$error, additionalProperties=$additionalProperties}"
+            "McpApprovalRequest{id=$id, arguments=$arguments, name=$name, serverLabel=$serverLabel, type=$type, additionalProperties=$additionalProperties}"
     }
 
-    /** A request for human approval of a tool invocation. */
-    class McpApprovalRequest
+    /** A response to an MCP approval request. */
+    class McpApprovalResponse
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
-        private val id: JsonField<String>,
-        private val arguments: JsonField<String>,
-        private val name: JsonField<String>,
-        private val serverLabel: JsonField<String>,
+        private val approvalRequestId: JsonField<String>,
+        private val approve: JsonField<Boolean>,
         private val type: JsonValue,
+        private val id: JsonField<String>,
+        private val reason: JsonField<String>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
         @JsonCreator
         private constructor(
-            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("arguments")
-            @ExcludeMissing
-            arguments: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("server_label")
+            @JsonProperty("approval_request_id")
             @ExcludeMissing
-            serverLabel: JsonField<String> = JsonMissing.of(),
+            approvalRequestId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("approve") @ExcludeMissing approve: JsonField<Boolean> = JsonMissing.of(),
             @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-        ) : this(id, arguments, name, serverLabel, type, mutableMapOf())
-
-        /**
-         * The unique ID of the approval request.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun id(): String = id.getRequired("id")
-
-        /**
-         * A JSON string of arguments for the tool.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun arguments(): String = arguments.getRequired("arguments")
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("reason") @ExcludeMissing reason: JsonField<String> = JsonMissing.of(),
+        ) : this(approvalRequestId, approve, type, id, reason, mutableMapOf())
 
         /**
-         * The name of the tool to run.
+         * The ID of the approval request being answered.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun name(): String = name.getRequired("name")
+        fun approvalRequestId(): String = approvalRequestId.getRequired("approval_request_id")
 
         /**
-         * The label of the MCP server making the request.
+         * Whether the request was approved.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun serverLabel(): String = serverLabel.getRequired("server_label")
+        fun approve(): Boolean = approve.getRequired("approve")
 
         /**
-         * The type of the item. Always `mcp_approval_request`.
+         * The type of the item. Always `mcp_approval_response`.
          *
          * Expected to always return the following:
          * ```java
-         * JsonValue.from("mcp_approval_request")
+         * JsonValue.from("mcp_approval_response")
          * ```
          *
          * However, this method can be useful for debugging and logging (e.g. if the server
@@ -10944,34 +13800,51 @@ private constructor(
         @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
         /**
-         * Returns the raw JSON value of [id].
+         * The unique ID of the approval response
          *
-         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
          */
-        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+        fun id(): Optional<String> = id.getOptional("id")
 
         /**
-         * Returns the raw JSON value of [arguments].
+         * Optional reason for the decision.
          *
-         * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
          */
-        @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
+        fun reason(): Optional<String> = reason.getOptional("reason")
 
         /**
-         * Returns the raw JSON value of [name].
+         * Returns the raw JSON value of [approvalRequestId].
          *
-         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [approvalRequestId], this method doesn't throw if the JSON field has an unexpected
+         * type.
          */
-        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+        @JsonProperty("approval_request_id")
+        @ExcludeMissing
+        fun _approvalRequestId(): JsonField<String> = approvalRequestId
 
         /**
-         * Returns the raw JSON value of [serverLabel].
+         * Returns the raw JSON value of [approve].
          *
-         * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [approve], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("server_label")
-        @ExcludeMissing
-        fun _serverLabel(): JsonField<String> = serverLabel
+        @JsonProperty("approve") @ExcludeMissing fun _approve(): JsonField<Boolean> = approve
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [reason].
+         *
+         * Unlike [reason], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("reason") @ExcludeMissing fun _reason(): JsonField<String> = reason
 
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
@@ -10988,102 +13861,107 @@ private constructor(
         companion object {
 
             /**
-             * Returns a mutable builder for constructing an instance of [McpApprovalRequest].
+             * Returns a mutable builder for constructing an instance of [McpApprovalResponse].
              *
              * The following fields are required:
              * ```java
-             * .id()
-             * .arguments()
-             * .name()
-             * .serverLabel()
+             * .approvalRequestId()
+             * .approve()
              * ```
              */
             @JvmStatic fun builder() = Builder()
         }
 
-        /** A builder for [McpApprovalRequest]. */
+        /** A builder for [McpApprovalResponse]. */
         class Builder internal constructor() {
 
-            private var id: JsonField<String>? = null
-            private var arguments: JsonField<String>? = null
-            private var name: JsonField<String>? = null
-            private var serverLabel: JsonField<String>? = null
-            private var type: JsonValue = JsonValue.from("mcp_approval_request")
+            private var approvalRequestId: JsonField<String>? = null
+            private var approve: JsonField<Boolean>? = null
+            private var type: JsonValue = JsonValue.from("mcp_approval_response")
+            private var id: JsonField<String> = JsonMissing.of()
+            private var reason: JsonField<String> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
-            internal fun from(mcpApprovalRequest: McpApprovalRequest) = apply {
-                id = mcpApprovalRequest.id
-                arguments = mcpApprovalRequest.arguments
-                name = mcpApprovalRequest.name
-                serverLabel = mcpApprovalRequest.serverLabel
-                type = mcpApprovalRequest.type
-                additionalProperties = mcpApprovalRequest.additionalProperties.toMutableMap()
+            internal fun from(mcpApprovalResponse: McpApprovalResponse) = apply {
+                approvalRequestId = mcpApprovalResponse.approvalRequestId
+                approve = mcpApprovalResponse.approve
+                type = mcpApprovalResponse.type
+                id = mcpApprovalResponse.id
+                reason = mcpApprovalResponse.reason
+                additionalProperties = mcpApprovalResponse.additionalProperties.toMutableMap()
             }
 
-            /** The unique ID of the approval request. */
-            fun id(id: String) = id(JsonField.of(id))
+            /** The ID of the approval request being answered. */
+            fun approvalRequestId(approvalRequestId: String) =
+                approvalRequestId(JsonField.of(approvalRequestId))
 
             /**
-             * Sets [Builder.id] to an arbitrary JSON value.
+             * Sets [Builder.approvalRequestId] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.id] with a well-typed [String] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
+             * You should usually call [Builder.approvalRequestId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            fun id(id: JsonField<String>) = apply { this.id = id }
+            fun approvalRequestId(approvalRequestId: JsonField<String>) = apply {
+                this.approvalRequestId = approvalRequestId
+            }
 
-            /** A JSON string of arguments for the tool. */
-            fun arguments(arguments: String) = arguments(JsonField.of(arguments))
+            /** Whether the request was approved. */
+            fun approve(approve: Boolean) = approve(JsonField.of(approve))
 
             /**
-             * Sets [Builder.arguments] to an arbitrary JSON value.
+             * Sets [Builder.approve] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.arguments] with a well-typed [String] value instead.
+             * You should usually call [Builder.approve] with a well-typed [Boolean] value instead.
              * This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
-
-            /** The name of the tool to run. */
-            fun name(name: String) = name(JsonField.of(name))
+            fun approve(approve: JsonField<Boolean>) = apply { this.approve = approve }
 
             /**
-             * Sets [Builder.name] to an arbitrary JSON value.
+             * Sets the field to an arbitrary JSON value.
              *
-             * You should usually call [Builder.name] with a well-typed [String] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("mcp_approval_response")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            fun name(name: JsonField<String>) = apply { this.name = name }
+            fun type(type: JsonValue) = apply { this.type = type }
 
-            /** The label of the MCP server making the request. */
-            fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
+            /** The unique ID of the approval response */
+            fun id(id: String?) = id(JsonField.ofNullable(id))
+
+            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
+            fun id(id: Optional<String>) = id(id.getOrNull())
 
             /**
-             * Sets [Builder.serverLabel] to an arbitrary JSON value.
+             * Sets [Builder.id] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.serverLabel] with a well-typed [String] value
-             * instead. This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
              */
-            fun serverLabel(serverLabel: JsonField<String>) = apply {
-                this.serverLabel = serverLabel
-            }
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** Optional reason for the decision. */
+            fun reason(reason: String?) = reason(JsonField.ofNullable(reason))
+
+            /** Alias for calling [Builder.reason] with `reason.orElse(null)`. */
+            fun reason(reason: Optional<String>) = reason(reason.getOrNull())
 
             /**
-             * Sets the field to an arbitrary JSON value.
-             *
-             * It is usually unnecessary to call this method because the field defaults to the
-             * following:
-             * ```java
-             * JsonValue.from("mcp_approval_request")
-             * ```
+             * Sets [Builder.reason] to an arbitrary JSON value.
              *
+             * You should usually call [Builder.reason] with a well-typed [String] value instead.
              * This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun type(type: JsonValue) = apply { this.type = type }
+            fun reason(reason: JsonField<String>) = apply { this.reason = reason }
 
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
@@ -11105,27 +13983,25 @@ private constructor(
             }
 
             /**
-             * Returns an immutable instance of [McpApprovalRequest].
+             * Returns an immutable instance of [McpApprovalResponse].
              *
              * Further updates to this [Builder] will not mutate the returned instance.
              *
              * The following fields are required:
              * ```java
-             * .id()
-             * .arguments()
-             * .name()
-             * .serverLabel()
+             * .approvalRequestId()
+             * .approve()
              * ```
              *
              * @throws IllegalStateException if any required field is unset.
              */
-            fun build(): McpApprovalRequest =
-                McpApprovalRequest(
-                    checkRequired("id", id),
-                    checkRequired("arguments", arguments),
-                    checkRequired("name", name),
-                    checkRequired("serverLabel", serverLabel),
+            fun build(): McpApprovalResponse =
+                McpApprovalResponse(
+                    checkRequired("approvalRequestId", approvalRequestId),
+                    checkRequired("approve", approve),
                     type,
+                    id,
+                    reason,
                     additionalProperties.toMutableMap(),
                 )
         }
@@ -11141,20 +14017,20 @@ private constructor(
          * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
          *   expected type.
          */
-        fun validate(): McpApprovalRequest = apply {
+        fun validate(): McpApprovalResponse = apply {
             if (validated) {
                 return@apply
             }
 
-            id()
-            arguments()
-            name()
-            serverLabel()
+            approvalRequestId()
+            approve()
             _type().let {
-                if (it != JsonValue.from("mcp_approval_request")) {
+                if (it != JsonValue.from("mcp_approval_response")) {
                     throw OpenAIInvalidDataException("'type' is invalid, received $it")
                 }
             }
+            id()
+            reason()
             validated = true
         }
 
@@ -11174,81 +14050,120 @@ private constructor(
          */
         @JvmSynthetic
         internal fun validity(): Int =
-            (if (id.asKnown().isPresent) 1 else 0) +
-                (if (arguments.asKnown().isPresent) 1 else 0) +
-                (if (name.asKnown().isPresent) 1 else 0) +
-                (if (serverLabel.asKnown().isPresent) 1 else 0) +
-                type.let { if (it == JsonValue.from("mcp_approval_request")) 1 else 0 }
+            (if (approvalRequestId.asKnown().isPresent) 1 else 0) +
+                (if (approve.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("mcp_approval_response")) 1 else 0 } +
+                (if (id.asKnown().isPresent) 1 else 0) +
+                (if (reason.asKnown().isPresent) 1 else 0)
 
         override fun equals(other: Any?): Boolean {
             if (this === other) {
                 return true
             }
 
-            return other is McpApprovalRequest &&
-                id == other.id &&
-                arguments == other.arguments &&
-                name == other.name &&
-                serverLabel == other.serverLabel &&
+            return other is McpApprovalResponse &&
+                approvalRequestId == other.approvalRequestId &&
+                approve == other.approve &&
                 type == other.type &&
+                id == other.id &&
+                reason == other.reason &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(id, arguments, name, serverLabel, type, additionalProperties)
+            Objects.hash(approvalRequestId, approve, type, id, reason, additionalProperties)
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "McpApprovalRequest{id=$id, arguments=$arguments, name=$name, serverLabel=$serverLabel, type=$type, additionalProperties=$additionalProperties}"
+            "McpApprovalResponse{approvalRequestId=$approvalRequestId, approve=$approve, type=$type, id=$id, reason=$reason, additionalProperties=$additionalProperties}"
     }
 
-    /** A response to an MCP approval request. */
-    class McpApprovalResponse
+    /** An invocation of a tool on an MCP server. */
+    class McpCall
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
-        private val approvalRequestId: JsonField<String>,
-        private val approve: JsonField<Boolean>,
-        private val type: JsonValue,
         private val id: JsonField<String>,
-        private val reason: JsonField<String>,
+        private val arguments: JsonField<String>,
+        private val name: JsonField<String>,
+        private val serverLabel: JsonField<String>,
+        private val type: JsonValue,
+        private val approvalRequestId: JsonField<String>,
+        private val error: JsonField<String>,
+        private val output: JsonField<String>,
+        private val status: JsonField<Status>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
         @JsonCreator
         private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("arguments")
+            @ExcludeMissing
+            arguments: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("server_label")
+            @ExcludeMissing
+            serverLabel: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
             @JsonProperty("approval_request_id")
             @ExcludeMissing
             approvalRequestId: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("approve") @ExcludeMissing approve: JsonField<Boolean> = JsonMissing.of(),
-            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("reason") @ExcludeMissing reason: JsonField<String> = JsonMissing.of(),
-        ) : this(approvalRequestId, approve, type, id, reason, mutableMapOf())
+            @JsonProperty("error") @ExcludeMissing error: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("output") @ExcludeMissing output: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+        ) : this(
+            id,
+            arguments,
+            name,
+            serverLabel,
+            type,
+            approvalRequestId,
+            error,
+            output,
+            status,
+            mutableMapOf(),
+        )
 
         /**
-         * The ID of the approval request being answered.
+         * The unique ID of the tool call.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun approvalRequestId(): String = approvalRequestId.getRequired("approval_request_id")
+        fun id(): String = id.getRequired("id")
 
         /**
-         * Whether the request was approved.
+         * A JSON string of the arguments passed to the tool.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun approve(): Boolean = approve.getRequired("approve")
+        fun arguments(): String = arguments.getRequired("arguments")
 
         /**
-         * The type of the item. Always `mcp_approval_response`.
+         * The name of the tool that was run.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun name(): String = name.getRequired("name")
+
+        /**
+         * The label of the MCP server running the tool.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun serverLabel(): String = serverLabel.getRequired("server_label")
+
+        /**
+         * The type of the item. Always `mcp_call`.
          *
          * Expected to always return the following:
          * ```java
-         * JsonValue.from("mcp_approval_response")
+         * JsonValue.from("mcp_call")
          * ```
          *
          * However, this method can be useful for debugging and logging (e.g. if the server
@@ -11257,20 +14172,70 @@ private constructor(
         @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
         /**
-         * The unique ID of the approval response
+         * Unique identifier for the MCP tool call approval request. Include this value in a
+         * subsequent `mcp_approval_response` input to approve or reject the corresponding tool
+         * call.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
-        fun id(): Optional<String> = id.getOptional("id")
+        fun approvalRequestId(): Optional<String> =
+            approvalRequestId.getOptional("approval_request_id")
 
         /**
-         * Optional reason for the decision.
+         * The error from the tool call, if any.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
          *   server responded with an unexpected value).
          */
-        fun reason(): Optional<String> = reason.getOptional("reason")
+        fun error(): Optional<String> = error.getOptional("error")
+
+        /**
+         * The output from the tool call.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun output(): Optional<String> = output.getOptional("output")
+
+        /**
+         * The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `calling`,
+         * or `failed`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun status(): Optional<Status> = status.getOptional("status")
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [arguments].
+         *
+         * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
+
+        /**
+         * Returns the raw JSON value of [name].
+         *
+         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
+
+        /**
+         * Returns the raw JSON value of [serverLabel].
+         *
+         * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("server_label")
+        @ExcludeMissing
+        fun _serverLabel(): JsonField<String> = serverLabel
 
         /**
          * Returns the raw JSON value of [approvalRequestId].
@@ -11283,25 +14248,25 @@ private constructor(
         fun _approvalRequestId(): JsonField<String> = approvalRequestId
 
         /**
-         * Returns the raw JSON value of [approve].
+         * Returns the raw JSON value of [error].
          *
-         * Unlike [approve], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("approve") @ExcludeMissing fun _approve(): JsonField<Boolean> = approve
+        @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<String> = error
 
         /**
-         * Returns the raw JSON value of [id].
+         * Returns the raw JSON value of [output].
          *
-         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+        @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<String> = output
 
         /**
-         * Returns the raw JSON value of [reason].
+         * Returns the raw JSON value of [status].
          *
-         * Unlike [reason], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("reason") @ExcludeMissing fun _reason(): JsonField<String> = reason
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
 
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
@@ -11318,107 +14283,180 @@ private constructor(
         companion object {
 
             /**
-             * Returns a mutable builder for constructing an instance of [McpApprovalResponse].
+             * Returns a mutable builder for constructing an instance of [McpCall].
              *
              * The following fields are required:
              * ```java
-             * .approvalRequestId()
-             * .approve()
+             * .id()
+             * .arguments()
+             * .name()
+             * .serverLabel()
              * ```
              */
             @JvmStatic fun builder() = Builder()
         }
 
-        /** A builder for [McpApprovalResponse]. */
+        /** A builder for [McpCall]. */
         class Builder internal constructor() {
 
-            private var approvalRequestId: JsonField<String>? = null
-            private var approve: JsonField<Boolean>? = null
-            private var type: JsonValue = JsonValue.from("mcp_approval_response")
-            private var id: JsonField<String> = JsonMissing.of()
-            private var reason: JsonField<String> = JsonMissing.of()
+            private var id: JsonField<String>? = null
+            private var arguments: JsonField<String>? = null
+            private var name: JsonField<String>? = null
+            private var serverLabel: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("mcp_call")
+            private var approvalRequestId: JsonField<String> = JsonMissing.of()
+            private var error: JsonField<String> = JsonMissing.of()
+            private var output: JsonField<String> = JsonMissing.of()
+            private var status: JsonField<Status> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
-            internal fun from(mcpApprovalResponse: McpApprovalResponse) = apply {
-                approvalRequestId = mcpApprovalResponse.approvalRequestId
-                approve = mcpApprovalResponse.approve
-                type = mcpApprovalResponse.type
-                id = mcpApprovalResponse.id
-                reason = mcpApprovalResponse.reason
-                additionalProperties = mcpApprovalResponse.additionalProperties.toMutableMap()
+            internal fun from(mcpCall: McpCall) = apply {
+                id = mcpCall.id
+                arguments = mcpCall.arguments
+                name = mcpCall.name
+                serverLabel = mcpCall.serverLabel
+                type = mcpCall.type
+                approvalRequestId = mcpCall.approvalRequestId
+                error = mcpCall.error
+                output = mcpCall.output
+                status = mcpCall.status
+                additionalProperties = mcpCall.additionalProperties.toMutableMap()
             }
 
-            /** The ID of the approval request being answered. */
-            fun approvalRequestId(approvalRequestId: String) =
-                approvalRequestId(JsonField.of(approvalRequestId))
+            /** The unique ID of the tool call. */
+            fun id(id: String) = id(JsonField.of(id))
 
             /**
-             * Sets [Builder.approvalRequestId] to an arbitrary JSON value.
+             * Sets [Builder.id] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.approvalRequestId] with a well-typed [String] value
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** A JSON string of the arguments passed to the tool. */
+            fun arguments(arguments: String) = arguments(JsonField.of(arguments))
+
+            /**
+             * Sets [Builder.arguments] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.arguments] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
+
+            /** The name of the tool that was run. */
+            fun name(name: String) = name(JsonField.of(name))
+
+            /**
+             * Sets [Builder.name] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.name] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun name(name: JsonField<String>) = apply { this.name = name }
+
+            /** The label of the MCP server running the tool. */
+            fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
+
+            /**
+             * Sets [Builder.serverLabel] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.serverLabel] with a well-typed [String] value
              * instead. This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun approvalRequestId(approvalRequestId: JsonField<String>) = apply {
-                this.approvalRequestId = approvalRequestId
+            fun serverLabel(serverLabel: JsonField<String>) = apply {
+                this.serverLabel = serverLabel
             }
 
-            /** Whether the request was approved. */
-            fun approve(approve: Boolean) = approve(JsonField.of(approve))
-
             /**
-             * Sets [Builder.approve] to an arbitrary JSON value.
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("mcp_call")
+             * ```
              *
-             * You should usually call [Builder.approve] with a well-typed [Boolean] value instead.
              * This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun approve(approve: JsonField<Boolean>) = apply { this.approve = approve }
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            /**
+             * Unique identifier for the MCP tool call approval request. Include this value in a
+             * subsequent `mcp_approval_response` input to approve or reject the corresponding tool
+             * call.
+             */
+            fun approvalRequestId(approvalRequestId: String?) =
+                approvalRequestId(JsonField.ofNullable(approvalRequestId))
+
+            /**
+             * Alias for calling [Builder.approvalRequestId] with `approvalRequestId.orElse(null)`.
+             */
+            fun approvalRequestId(approvalRequestId: Optional<String>) =
+                approvalRequestId(approvalRequestId.getOrNull())
+
+            /**
+             * Sets [Builder.approvalRequestId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.approvalRequestId] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun approvalRequestId(approvalRequestId: JsonField<String>) = apply {
+                this.approvalRequestId = approvalRequestId
+            }
+
+            /** The error from the tool call, if any. */
+            fun error(error: String?) = error(JsonField.ofNullable(error))
+
+            /** Alias for calling [Builder.error] with `error.orElse(null)`. */
+            fun error(error: Optional<String>) = error(error.getOrNull())
 
             /**
-             * Sets the field to an arbitrary JSON value.
-             *
-             * It is usually unnecessary to call this method because the field defaults to the
-             * following:
-             * ```java
-             * JsonValue.from("mcp_approval_response")
-             * ```
+             * Sets [Builder.error] to an arbitrary JSON value.
              *
+             * You should usually call [Builder.error] with a well-typed [String] value instead.
              * This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun type(type: JsonValue) = apply { this.type = type }
+            fun error(error: JsonField<String>) = apply { this.error = error }
 
-            /** The unique ID of the approval response */
-            fun id(id: String?) = id(JsonField.ofNullable(id))
+            /** The output from the tool call. */
+            fun output(output: String?) = output(JsonField.ofNullable(output))
 
-            /** Alias for calling [Builder.id] with `id.orElse(null)`. */
-            fun id(id: Optional<String>) = id(id.getOrNull())
+            /** Alias for calling [Builder.output] with `output.orElse(null)`. */
+            fun output(output: Optional<String>) = output(output.getOrNull())
 
             /**
-             * Sets [Builder.id] to an arbitrary JSON value.
+             * Sets [Builder.output] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.id] with a well-typed [String] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
+             * You should usually call [Builder.output] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            fun id(id: JsonField<String>) = apply { this.id = id }
-
-            /** Optional reason for the decision. */
-            fun reason(reason: String?) = reason(JsonField.ofNullable(reason))
+            fun output(output: JsonField<String>) = apply { this.output = output }
 
-            /** Alias for calling [Builder.reason] with `reason.orElse(null)`. */
-            fun reason(reason: Optional<String>) = reason(reason.getOrNull())
+            /**
+             * The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
+             * `calling`, or `failed`.
+             */
+            fun status(status: Status) = status(JsonField.of(status))
 
             /**
-             * Sets [Builder.reason] to an arbitrary JSON value.
+             * Sets [Builder.status] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.reason] with a well-typed [String] value instead.
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
              * This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun reason(reason: JsonField<String>) = apply { this.reason = reason }
+            fun status(status: JsonField<Status>) = apply { this.status = status }
 
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
@@ -11440,151 +14478,310 @@ private constructor(
             }
 
             /**
-             * Returns an immutable instance of [McpApprovalResponse].
+             * Returns an immutable instance of [McpCall].
              *
              * Further updates to this [Builder] will not mutate the returned instance.
              *
              * The following fields are required:
              * ```java
-             * .approvalRequestId()
-             * .approve()
+             * .id()
+             * .arguments()
+             * .name()
+             * .serverLabel()
              * ```
              *
              * @throws IllegalStateException if any required field is unset.
              */
-            fun build(): McpApprovalResponse =
-                McpApprovalResponse(
-                    checkRequired("approvalRequestId", approvalRequestId),
-                    checkRequired("approve", approve),
+            fun build(): McpCall =
+                McpCall(
+                    checkRequired("id", id),
+                    checkRequired("arguments", arguments),
+                    checkRequired("name", name),
+                    checkRequired("serverLabel", serverLabel),
                     type,
-                    id,
-                    reason,
+                    approvalRequestId,
+                    error,
+                    output,
+                    status,
                     additionalProperties.toMutableMap(),
                 )
         }
 
         private var validated: Boolean = false
 
-        /**
-         * Validates that the types of all values in this object match their expected types
-         * recursively.
-         *
-         * This method is _not_ forwards compatible with new types from the API for existing fields.
-         *
-         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-         *   expected type.
-         */
-        fun validate(): McpApprovalResponse = apply {
-            if (validated) {
-                return@apply
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): McpCall = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            arguments()
+            name()
+            serverLabel()
+            _type().let {
+                if (it != JsonValue.from("mcp_call")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            approvalRequestId()
+            error()
+            output()
+            status().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (arguments.asKnown().isPresent) 1 else 0) +
+                (if (name.asKnown().isPresent) 1 else 0) +
+                (if (serverLabel.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("mcp_call")) 1 else 0 } +
+                (if (approvalRequestId.asKnown().isPresent) 1 else 0) +
+                (if (error.asKnown().isPresent) 1 else 0) +
+                (if (output.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0)
+
+        /**
+         * The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `calling`,
+         * or `failed`.
+         */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IN_PROGRESS = of("in_progress")
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmField val CALLING = of("calling")
+
+                @JvmField val FAILED = of("failed")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                CALLING,
+                FAILED,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IN_PROGRESS,
+                COMPLETED,
+                INCOMPLETE,
+                CALLING,
+                FAILED,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IN_PROGRESS -> Value.IN_PROGRESS
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    CALLING -> Value.CALLING
+                    FAILED -> Value.FAILED
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IN_PROGRESS -> Known.IN_PROGRESS
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    CALLING -> Known.CALLING
+                    FAILED -> Known.FAILED
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
             }
 
-            approvalRequestId()
-            approve()
-            _type().let {
-                if (it != JsonValue.from("mcp_approval_response")) {
-                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
                 }
-            }
-            id()
-            reason()
-            validated = true
-        }
 
-        fun isValid(): Boolean =
-            try {
-                validate()
-                true
-            } catch (e: OpenAIInvalidDataException) {
-                false
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
             }
 
-        /**
-         * Returns a score indicating how many valid values are contained in this object
-         * recursively.
-         *
-         * Used for best match union deserialization.
-         */
-        @JvmSynthetic
-        internal fun validity(): Int =
-            (if (approvalRequestId.asKnown().isPresent) 1 else 0) +
-                (if (approve.asKnown().isPresent) 1 else 0) +
-                type.let { if (it == JsonValue.from("mcp_approval_response")) 1 else 0 } +
-                (if (id.asKnown().isPresent) 1 else 0) +
-                (if (reason.asKnown().isPresent) 1 else 0)
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
 
         override fun equals(other: Any?): Boolean {
             if (this === other) {
                 return true
             }
 
-            return other is McpApprovalResponse &&
-                approvalRequestId == other.approvalRequestId &&
-                approve == other.approve &&
-                type == other.type &&
+            return other is McpCall &&
                 id == other.id &&
-                reason == other.reason &&
+                arguments == other.arguments &&
+                name == other.name &&
+                serverLabel == other.serverLabel &&
+                type == other.type &&
+                approvalRequestId == other.approvalRequestId &&
+                error == other.error &&
+                output == other.output &&
+                status == other.status &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(approvalRequestId, approve, type, id, reason, additionalProperties)
+            Objects.hash(
+                id,
+                arguments,
+                name,
+                serverLabel,
+                type,
+                approvalRequestId,
+                error,
+                output,
+                status,
+                additionalProperties,
+            )
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "McpApprovalResponse{approvalRequestId=$approvalRequestId, approve=$approve, type=$type, id=$id, reason=$reason, additionalProperties=$additionalProperties}"
+            "McpCall{id=$id, arguments=$arguments, name=$name, serverLabel=$serverLabel, type=$type, approvalRequestId=$approvalRequestId, error=$error, output=$output, status=$status, additionalProperties=$additionalProperties}"
     }
 
-    /** An invocation of a tool on an MCP server. */
-    class McpCall
+    /** An internal identifier for an item to reference. */
+    class ItemReference
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
         private val id: JsonField<String>,
-        private val arguments: JsonField<String>,
-        private val name: JsonField<String>,
-        private val serverLabel: JsonField<String>,
-        private val type: JsonValue,
-        private val approvalRequestId: JsonField<String>,
-        private val error: JsonField<String>,
-        private val output: JsonField<String>,
-        private val status: JsonField<Status>,
+        private val type: JsonField<Type>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
         @JsonCreator
         private constructor(
             @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("arguments")
-            @ExcludeMissing
-            arguments: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("name") @ExcludeMissing name: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("server_label")
-            @ExcludeMissing
-            serverLabel: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-            @JsonProperty("approval_request_id")
-            @ExcludeMissing
-            approvalRequestId: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("error") @ExcludeMissing error: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("output") @ExcludeMissing output: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
-        ) : this(
-            id,
-            arguments,
-            name,
-            serverLabel,
-            type,
-            approvalRequestId,
-            error,
-            output,
-            status,
-            mutableMapOf(),
-        )
+            @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
+        ) : this(id, type, mutableMapOf())
 
         /**
-         * The unique ID of the tool call.
+         * The ID of the item to reference.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -11592,138 +14789,26 @@ private constructor(
         fun id(): String = id.getRequired("id")
 
         /**
-         * A JSON string of the arguments passed to the tool.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun arguments(): String = arguments.getRequired("arguments")
-
-        /**
-         * The name of the tool that was run.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun name(): String = name.getRequired("name")
-
-        /**
-         * The label of the MCP server running the tool.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
-         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
-         */
-        fun serverLabel(): String = serverLabel.getRequired("server_label")
-
-        /**
-         * The type of the item. Always `mcp_call`.
-         *
-         * Expected to always return the following:
-         * ```java
-         * JsonValue.from("mcp_call")
-         * ```
-         *
-         * However, this method can be useful for debugging and logging (e.g. if the server
-         * responded with an unexpected value).
-         */
-        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
-
-        /**
-         * Unique identifier for the MCP tool call approval request. Include this value in a
-         * subsequent `mcp_approval_response` input to approve or reject the corresponding tool
-         * call.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun approvalRequestId(): Optional<String> =
-            approvalRequestId.getOptional("approval_request_id")
-
-        /**
-         * The error from the tool call, if any.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun error(): Optional<String> = error.getOptional("error")
-
-        /**
-         * The output from the tool call.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun output(): Optional<String> = output.getOptional("output")
-
-        /**
-         * The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `calling`,
-         * or `failed`.
-         *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
-         */
-        fun status(): Optional<Status> = status.getOptional("status")
-
-        /**
-         * Returns the raw JSON value of [id].
-         *
-         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
-
-        /**
-         * Returns the raw JSON value of [arguments].
-         *
-         * Unlike [arguments], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("arguments") @ExcludeMissing fun _arguments(): JsonField<String> = arguments
-
-        /**
-         * Returns the raw JSON value of [name].
-         *
-         * Unlike [name], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("name") @ExcludeMissing fun _name(): JsonField<String> = name
-
-        /**
-         * Returns the raw JSON value of [serverLabel].
-         *
-         * Unlike [serverLabel], this method doesn't throw if the JSON field has an unexpected type.
-         */
-        @JsonProperty("server_label")
-        @ExcludeMissing
-        fun _serverLabel(): JsonField<String> = serverLabel
-
-        /**
-         * Returns the raw JSON value of [approvalRequestId].
-         *
-         * Unlike [approvalRequestId], this method doesn't throw if the JSON field has an unexpected
-         * type.
-         */
-        @JsonProperty("approval_request_id")
-        @ExcludeMissing
-        fun _approvalRequestId(): JsonField<String> = approvalRequestId
-
-        /**
-         * Returns the raw JSON value of [error].
+         * The type of item to reference. Always `item_reference`.
          *
-         * Unlike [error], this method doesn't throw if the JSON field has an unexpected type.
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
          */
-        @JsonProperty("error") @ExcludeMissing fun _error(): JsonField<String> = error
+        fun type(): Optional<Type> = type.getOptional("type")
 
         /**
-         * Returns the raw JSON value of [output].
+         * Returns the raw JSON value of [id].
          *
-         * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<String> = output
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
         /**
-         * Returns the raw JSON value of [status].
+         * Returns the raw JSON value of [type].
          *
-         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
 
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
@@ -11740,48 +14825,31 @@ private constructor(
         companion object {
 
             /**
-             * Returns a mutable builder for constructing an instance of [McpCall].
+             * Returns a mutable builder for constructing an instance of [ItemReference].
              *
              * The following fields are required:
              * ```java
              * .id()
-             * .arguments()
-             * .name()
-             * .serverLabel()
              * ```
              */
             @JvmStatic fun builder() = Builder()
         }
 
-        /** A builder for [McpCall]. */
+        /** A builder for [ItemReference]. */
         class Builder internal constructor() {
 
             private var id: JsonField<String>? = null
-            private var arguments: JsonField<String>? = null
-            private var name: JsonField<String>? = null
-            private var serverLabel: JsonField<String>? = null
-            private var type: JsonValue = JsonValue.from("mcp_call")
-            private var approvalRequestId: JsonField<String> = JsonMissing.of()
-            private var error: JsonField<String> = JsonMissing.of()
-            private var output: JsonField<String> = JsonMissing.of()
-            private var status: JsonField<Status> = JsonMissing.of()
+            private var type: JsonField<Type> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
-            internal fun from(mcpCall: McpCall) = apply {
-                id = mcpCall.id
-                arguments = mcpCall.arguments
-                name = mcpCall.name
-                serverLabel = mcpCall.serverLabel
-                type = mcpCall.type
-                approvalRequestId = mcpCall.approvalRequestId
-                error = mcpCall.error
-                output = mcpCall.output
-                status = mcpCall.status
-                additionalProperties = mcpCall.additionalProperties.toMutableMap()
+            internal fun from(itemReference: ItemReference) = apply {
+                id = itemReference.id
+                type = itemReference.type
+                additionalProperties = itemReference.additionalProperties.toMutableMap()
             }
 
-            /** The unique ID of the tool call. */
+            /** The ID of the item to reference. */
             fun id(id: String) = id(JsonField.of(id))
 
             /**
@@ -11793,127 +14861,20 @@ private constructor(
              */
             fun id(id: JsonField<String>) = apply { this.id = id }
 
-            /** A JSON string of the arguments passed to the tool. */
-            fun arguments(arguments: String) = arguments(JsonField.of(arguments))
-
-            /**
-             * Sets [Builder.arguments] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.arguments] with a well-typed [String] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun arguments(arguments: JsonField<String>) = apply { this.arguments = arguments }
+            /** The type of item to reference. Always `item_reference`. */
+            fun type(type: Type?) = type(JsonField.ofNullable(type))
 
-            /** The name of the tool that was run. */
-            fun name(name: String) = name(JsonField.of(name))
+            /** Alias for calling [Builder.type] with `type.orElse(null)`. */
+            fun type(type: Optional<Type>) = type(type.getOrNull())
 
             /**
-             * Sets [Builder.name] to an arbitrary JSON value.
+             * Sets [Builder.type] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.name] with a well-typed [String] value instead. This
+             * You should usually call [Builder.type] with a well-typed [Type] value instead. This
              * method is primarily for setting the field to an undocumented or not yet supported
              * value.
              */
-            fun name(name: JsonField<String>) = apply { this.name = name }
-
-            /** The label of the MCP server running the tool. */
-            fun serverLabel(serverLabel: String) = serverLabel(JsonField.of(serverLabel))
-
-            /**
-             * Sets [Builder.serverLabel] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.serverLabel] with a well-typed [String] value
-             * instead. This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun serverLabel(serverLabel: JsonField<String>) = apply {
-                this.serverLabel = serverLabel
-            }
-
-            /**
-             * Sets the field to an arbitrary JSON value.
-             *
-             * It is usually unnecessary to call this method because the field defaults to the
-             * following:
-             * ```java
-             * JsonValue.from("mcp_call")
-             * ```
-             *
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun type(type: JsonValue) = apply { this.type = type }
-
-            /**
-             * Unique identifier for the MCP tool call approval request. Include this value in a
-             * subsequent `mcp_approval_response` input to approve or reject the corresponding tool
-             * call.
-             */
-            fun approvalRequestId(approvalRequestId: String?) =
-                approvalRequestId(JsonField.ofNullable(approvalRequestId))
-
-            /**
-             * Alias for calling [Builder.approvalRequestId] with `approvalRequestId.orElse(null)`.
-             */
-            fun approvalRequestId(approvalRequestId: Optional<String>) =
-                approvalRequestId(approvalRequestId.getOrNull())
-
-            /**
-             * Sets [Builder.approvalRequestId] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.approvalRequestId] with a well-typed [String] value
-             * instead. This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun approvalRequestId(approvalRequestId: JsonField<String>) = apply {
-                this.approvalRequestId = approvalRequestId
-            }
-
-            /** The error from the tool call, if any. */
-            fun error(error: String?) = error(JsonField.ofNullable(error))
-
-            /** Alias for calling [Builder.error] with `error.orElse(null)`. */
-            fun error(error: Optional<String>) = error(error.getOrNull())
-
-            /**
-             * Sets [Builder.error] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.error] with a well-typed [String] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun error(error: JsonField<String>) = apply { this.error = error }
-
-            /** The output from the tool call. */
-            fun output(output: String?) = output(JsonField.ofNullable(output))
-
-            /** Alias for calling [Builder.output] with `output.orElse(null)`. */
-            fun output(output: Optional<String>) = output(output.getOrNull())
-
-            /**
-             * Sets [Builder.output] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.output] with a well-typed [String] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun output(output: JsonField<String>) = apply { this.output = output }
-
-            /**
-             * The status of the tool call. One of `in_progress`, `completed`, `incomplete`,
-             * `calling`, or `failed`.
-             */
-            fun status(status: Status) = status(JsonField.of(status))
-
-            /**
-             * Sets [Builder.status] to an arbitrary JSON value.
-             *
-             * You should usually call [Builder.status] with a well-typed [Status] value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
-             * supported value.
-             */
-            fun status(status: JsonField<Status>) = apply { this.status = status }
+            fun type(type: JsonField<Type>) = apply { this.type = type }
 
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
@@ -11935,33 +14896,19 @@ private constructor(
             }
 
             /**
-             * Returns an immutable instance of [McpCall].
+             * Returns an immutable instance of [ItemReference].
              *
              * Further updates to this [Builder] will not mutate the returned instance.
              *
              * The following fields are required:
              * ```java
              * .id()
-             * .arguments()
-             * .name()
-             * .serverLabel()
              * ```
              *
              * @throws IllegalStateException if any required field is unset.
              */
-            fun build(): McpCall =
-                McpCall(
-                    checkRequired("id", id),
-                    checkRequired("arguments", arguments),
-                    checkRequired("name", name),
-                    checkRequired("serverLabel", serverLabel),
-                    type,
-                    approvalRequestId,
-                    error,
-                    output,
-                    status,
-                    additionalProperties.toMutableMap(),
-                )
+            fun build(): ItemReference =
+                ItemReference(checkRequired("id", id), type, additionalProperties.toMutableMap())
         }
 
         private var validated: Boolean = false
@@ -11975,24 +14922,13 @@ private constructor(
          * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
          *   expected type.
          */
-        fun validate(): McpCall = apply {
+        fun validate(): ItemReference = apply {
             if (validated) {
                 return@apply
             }
 
             id()
-            arguments()
-            name()
-            serverLabel()
-            _type().let {
-                if (it != JsonValue.from("mcp_call")) {
-                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
-                }
-            }
-            approvalRequestId()
-            error()
-            output()
-            status().ifPresent { it.validate() }
+            type().ifPresent { it.validate() }
             validated = true
         }
 
@@ -12012,21 +14948,10 @@ private constructor(
          */
         @JvmSynthetic
         internal fun validity(): Int =
-            (if (id.asKnown().isPresent) 1 else 0) +
-                (if (arguments.asKnown().isPresent) 1 else 0) +
-                (if (name.asKnown().isPresent) 1 else 0) +
-                (if (serverLabel.asKnown().isPresent) 1 else 0) +
-                type.let { if (it == JsonValue.from("mcp_call")) 1 else 0 } +
-                (if (approvalRequestId.asKnown().isPresent) 1 else 0) +
-                (if (error.asKnown().isPresent) 1 else 0) +
-                (if (output.asKnown().isPresent) 1 else 0) +
-                (status.asKnown().getOrNull()?.validity() ?: 0)
+            (if (id.asKnown().isPresent) 1 else 0) + (type.asKnown().getOrNull()?.validity() ?: 0)
 
-        /**
-         * The status of the tool call. One of `in_progress`, `completed`, `incomplete`, `calling`,
-         * or `failed`.
-         */
-        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+        /** The type of item to reference. Always `item_reference`. */
+        class Type @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
             /**
              * Returns this class instance's raw value.
@@ -12040,46 +14965,28 @@ private constructor(
 
             companion object {
 
-                @JvmField val IN_PROGRESS = of("in_progress")
-
-                @JvmField val COMPLETED = of("completed")
-
-                @JvmField val INCOMPLETE = of("incomplete")
-
-                @JvmField val CALLING = of("calling")
-
-                @JvmField val FAILED = of("failed")
+                @JvmField val ITEM_REFERENCE = of("item_reference")
 
-                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+                @JvmStatic fun of(value: String) = Type(JsonField.of(value))
             }
 
-            /** An enum containing [Status]'s known values. */
+            /** An enum containing [Type]'s known values. */
             enum class Known {
-                IN_PROGRESS,
-                COMPLETED,
-                INCOMPLETE,
-                CALLING,
-                FAILED,
+                ITEM_REFERENCE
             }
 
             /**
-             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
              *
-             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * An instance of [Type] can contain an unknown value in a couple of cases:
              * - It was deserialized from data that doesn't match any known member. For example, if
              *   the SDK is on an older version than the API, then the API may respond with new
              *   members that the SDK is unaware of.
              * - It was constructed with an arbitrary value using the [of] method.
              */
             enum class Value {
-                IN_PROGRESS,
-                COMPLETED,
-                INCOMPLETE,
-                CALLING,
-                FAILED,
-                /**
-                 * An enum member indicating that [Status] was instantiated with an unknown value.
-                 */
+                ITEM_REFERENCE,
+                /** An enum member indicating that [Type] was instantiated with an unknown value. */
                 _UNKNOWN,
             }
 
@@ -12092,11 +14999,7 @@ private constructor(
              */
             fun value(): Value =
                 when (this) {
-                    IN_PROGRESS -> Value.IN_PROGRESS
-                    COMPLETED -> Value.COMPLETED
-                    INCOMPLETE -> Value.INCOMPLETE
-                    CALLING -> Value.CALLING
-                    FAILED -> Value.FAILED
+                    ITEM_REFERENCE -> Value.ITEM_REFERENCE
                     else -> Value._UNKNOWN
                 }
 
@@ -12111,12 +15014,8 @@ private constructor(
              */
             fun known(): Known =
                 when (this) {
-                    IN_PROGRESS -> Known.IN_PROGRESS
-                    COMPLETED -> Known.COMPLETED
-                    INCOMPLETE -> Known.INCOMPLETE
-                    CALLING -> Known.CALLING
-                    FAILED -> Known.FAILED
-                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                    ITEM_REFERENCE -> Known.ITEM_REFERENCE
+                    else -> throw OpenAIInvalidDataException("Unknown Type: $value")
                 }
 
             /**
@@ -12145,7 +15044,7 @@ private constructor(
              * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
              *   expected type.
              */
-            fun validate(): Status = apply {
+            fun validate(): Type = apply {
                 if (validated) {
                     return@apply
                 }
@@ -12170,75 +15069,388 @@ private constructor(
              */
             @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
 
-            override fun equals(other: Any?): Boolean {
-                if (this === other) {
-                    return true
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Type && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ItemReference &&
+                id == other.id &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(id, type, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ItemReference{id=$id, type=$type, additionalProperties=$additionalProperties}"
+    }
+
+    class Program
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val callId: JsonField<String>,
+        private val code: JsonField<String>,
+        private val fingerprint: JsonField<String>,
+        private val type: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("code") @ExcludeMissing code: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("fingerprint")
+            @ExcludeMissing
+            fingerprint: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(id, callId, code, fingerprint, type, mutableMapOf())
+
+        /**
+         * The unique ID of this program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The stable call ID of the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The JavaScript source executed by programmatic tool calling.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun code(): String = code.getRequired("code")
+
+        /**
+         * Opaque program replay fingerprint that must be round-tripped.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun fingerprint(): String = fingerprint.getRequired("fingerprint")
+
+        /**
+         * The item type. Always `program`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("program")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [code].
+         *
+         * Unlike [code], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<String> = code
+
+        /**
+         * Returns the raw JSON value of [fingerprint].
+         *
+         * Unlike [fingerprint], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("fingerprint")
+        @ExcludeMissing
+        fun _fingerprint(): JsonField<String> = fingerprint
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Program].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .code()
+             * .fingerprint()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Program]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var callId: JsonField<String>? = null
+            private var code: JsonField<String>? = null
+            private var fingerprint: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("program")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(program: Program) = apply {
+                id = program.id
+                callId = program.callId
+                code = program.code
+                fingerprint = program.fingerprint
+                type = program.type
+                additionalProperties = program.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of this program item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The stable call ID of the program item. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The JavaScript source executed by programmatic tool calling. */
+            fun code(code: String) = code(JsonField.of(code))
+
+            /**
+             * Sets [Builder.code] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.code] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun code(code: JsonField<String>) = apply { this.code = code }
+
+            /** Opaque program replay fingerprint that must be round-tripped. */
+            fun fingerprint(fingerprint: String) = fingerprint(JsonField.of(fingerprint))
+
+            /**
+             * Sets [Builder.fingerprint] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.fingerprint] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun fingerprint(fingerprint: JsonField<String>) = apply {
+                this.fingerprint = fingerprint
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Program].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .code()
+             * .fingerprint()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Program =
+                Program(
+                    checkRequired("id", id),
+                    checkRequired("callId", callId),
+                    checkRequired("code", code),
+                    checkRequired("fingerprint", fingerprint),
+                    type,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Program = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            callId()
+            code()
+            fingerprint()
+            _type().let {
+                if (it != JsonValue.from("program")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
                 }
-
-                return other is Status && value == other.value
             }
+            validated = true
+        }
 
-            override fun hashCode() = value.hashCode()
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
 
-            override fun toString() = value.toString()
-        }
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (if (code.asKnown().isPresent) 1 else 0) +
+                (if (fingerprint.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("program")) 1 else 0 }
 
         override fun equals(other: Any?): Boolean {
             if (this === other) {
                 return true
             }
 
-            return other is McpCall &&
+            return other is Program &&
                 id == other.id &&
-                arguments == other.arguments &&
-                name == other.name &&
-                serverLabel == other.serverLabel &&
+                callId == other.callId &&
+                code == other.code &&
+                fingerprint == other.fingerprint &&
                 type == other.type &&
-                approvalRequestId == other.approvalRequestId &&
-                error == other.error &&
-                output == other.output &&
-                status == other.status &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(
-                id,
-                arguments,
-                name,
-                serverLabel,
-                type,
-                approvalRequestId,
-                error,
-                output,
-                status,
-                additionalProperties,
-            )
+            Objects.hash(id, callId, code, fingerprint, type, additionalProperties)
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "McpCall{id=$id, arguments=$arguments, name=$name, serverLabel=$serverLabel, type=$type, approvalRequestId=$approvalRequestId, error=$error, output=$output, status=$status, additionalProperties=$additionalProperties}"
+            "Program{id=$id, callId=$callId, code=$code, fingerprint=$fingerprint, type=$type, additionalProperties=$additionalProperties}"
     }
 
-    /** An internal identifier for an item to reference. */
-    class ItemReference
+    class ProgramOutput
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
         private val id: JsonField<String>,
-        private val type: JsonField<Type>,
+        private val callId: JsonField<String>,
+        private val result: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
         @JsonCreator
         private constructor(
             @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("type") @ExcludeMissing type: JsonField<Type> = JsonMissing.of(),
-        ) : this(id, type, mutableMapOf())
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("result") @ExcludeMissing result: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(id, callId, result, status, type, mutableMapOf())
 
         /**
-         * The ID of the item to reference.
+         * The unique ID of this program output item.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -12246,12 +15458,41 @@ private constructor(
         fun id(): String = id.getRequired("id")
 
         /**
-         * The type of item to reference. Always `item_reference`.
+         * The call ID of the program item.
          *
-         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
-         *   server responded with an unexpected value).
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun type(): Optional<Type> = type.getOptional("type")
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The result produced by the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun result(): String = result.getRequired("result")
+
+        /**
+         * The terminal status of the program output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The item type. Always `program_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("program_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
         /**
          * Returns the raw JSON value of [id].
@@ -12261,11 +15502,25 @@ private constructor(
         @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
         /**
-         * Returns the raw JSON value of [type].
+         * Returns the raw JSON value of [callId].
          *
-         * Unlike [type], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("type") @ExcludeMissing fun _type(): JsonField<Type> = type
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [result].
+         *
+         * Unlike [result], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("result") @ExcludeMissing fun _result(): JsonField<String> = result
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
 
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
@@ -12282,31 +15537,40 @@ private constructor(
         companion object {
 
             /**
-             * Returns a mutable builder for constructing an instance of [ItemReference].
+             * Returns a mutable builder for constructing an instance of [ProgramOutput].
              *
              * The following fields are required:
              * ```java
              * .id()
+             * .callId()
+             * .result()
+             * .status()
              * ```
              */
             @JvmStatic fun builder() = Builder()
         }
 
-        /** A builder for [ItemReference]. */
+        /** A builder for [ProgramOutput]. */
         class Builder internal constructor() {
 
             private var id: JsonField<String>? = null
-            private var type: JsonField<Type> = JsonMissing.of()
+            private var callId: JsonField<String>? = null
+            private var result: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("program_output")
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
-            internal fun from(itemReference: ItemReference) = apply {
-                id = itemReference.id
-                type = itemReference.type
-                additionalProperties = itemReference.additionalProperties.toMutableMap()
+            internal fun from(programOutput: ProgramOutput) = apply {
+                id = programOutput.id
+                callId = programOutput.callId
+                result = programOutput.result
+                status = programOutput.status
+                type = programOutput.type
+                additionalProperties = programOutput.additionalProperties.toMutableMap()
             }
 
-            /** The ID of the item to reference. */
+            /** The unique ID of this program output item. */
             fun id(id: String) = id(JsonField.of(id))
 
             /**
@@ -12318,20 +15582,55 @@ private constructor(
              */
             fun id(id: JsonField<String>) = apply { this.id = id }
 
-            /** The type of item to reference. Always `item_reference`. */
-            fun type(type: Type?) = type(JsonField.ofNullable(type))
+            /** The call ID of the program item. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
 
-            /** Alias for calling [Builder.type] with `type.orElse(null)`. */
-            fun type(type: Optional<Type>) = type(type.getOrNull())
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The result produced by the program item. */
+            fun result(result: String) = result(JsonField.of(result))
 
             /**
-             * Sets [Builder.type] to an arbitrary JSON value.
+             * Sets [Builder.result] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.type] with a well-typed [Type] value instead. This
-             * method is primarily for setting the field to an undocumented or not yet supported
-             * value.
+             * You should usually call [Builder.result] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            fun type(type: JsonField<Type>) = apply { this.type = type }
+            fun result(result: JsonField<String>) = apply { this.result = result }
+
+            /** The terminal status of the program output. */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("program_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
 
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
@@ -12353,19 +15652,29 @@ private constructor(
             }
 
             /**
-             * Returns an immutable instance of [ItemReference].
+             * Returns an immutable instance of [ProgramOutput].
              *
              * Further updates to this [Builder] will not mutate the returned instance.
              *
              * The following fields are required:
              * ```java
              * .id()
+             * .callId()
+             * .result()
+             * .status()
              * ```
              *
              * @throws IllegalStateException if any required field is unset.
              */
-            fun build(): ItemReference =
-                ItemReference(checkRequired("id", id), type, additionalProperties.toMutableMap())
+            fun build(): ProgramOutput =
+                ProgramOutput(
+                    checkRequired("id", id),
+                    checkRequired("callId", callId),
+                    checkRequired("result", result),
+                    checkRequired("status", status),
+                    type,
+                    additionalProperties.toMutableMap(),
+                )
         }
 
         private var validated: Boolean = false
@@ -12379,13 +15688,20 @@ private constructor(
          * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
          *   expected type.
          */
-        fun validate(): ItemReference = apply {
+        fun validate(): ProgramOutput = apply {
             if (validated) {
                 return@apply
             }
 
             id()
-            type().ifPresent { it.validate() }
+            callId()
+            result()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("program_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
             validated = true
         }
 
@@ -12405,10 +15721,14 @@ private constructor(
          */
         @JvmSynthetic
         internal fun validity(): Int =
-            (if (id.asKnown().isPresent) 1 else 0) + (type.asKnown().getOrNull()?.validity() ?: 0)
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (if (result.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("program_output")) 1 else 0 }
 
-        /** The type of item to reference. Always `item_reference`. */
-        class Type @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+        /** The terminal status of the program output. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
             /**
              * Returns this class instance's raw value.
@@ -12422,28 +15742,34 @@ private constructor(
 
             companion object {
 
-                @JvmField val ITEM_REFERENCE = of("item_reference")
+                @JvmField val COMPLETED = of("completed")
 
-                @JvmStatic fun of(value: String) = Type(JsonField.of(value))
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
             }
 
-            /** An enum containing [Type]'s known values. */
+            /** An enum containing [Status]'s known values. */
             enum class Known {
-                ITEM_REFERENCE
+                COMPLETED,
+                INCOMPLETE,
             }
 
             /**
-             * An enum containing [Type]'s known values, as well as an [_UNKNOWN] member.
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
              *
-             * An instance of [Type] can contain an unknown value in a couple of cases:
+             * An instance of [Status] can contain an unknown value in a couple of cases:
              * - It was deserialized from data that doesn't match any known member. For example, if
              *   the SDK is on an older version than the API, then the API may respond with new
              *   members that the SDK is unaware of.
              * - It was constructed with an arbitrary value using the [of] method.
              */
             enum class Value {
-                ITEM_REFERENCE,
-                /** An enum member indicating that [Type] was instantiated with an unknown value. */
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
                 _UNKNOWN,
             }
 
@@ -12456,7 +15782,8 @@ private constructor(
              */
             fun value(): Value =
                 when (this) {
-                    ITEM_REFERENCE -> Value.ITEM_REFERENCE
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
                     else -> Value._UNKNOWN
                 }
 
@@ -12471,8 +15798,9 @@ private constructor(
              */
             fun known(): Known =
                 when (this) {
-                    ITEM_REFERENCE -> Known.ITEM_REFERENCE
-                    else -> throw OpenAIInvalidDataException("Unknown Type: $value")
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
                 }
 
             /**
@@ -12501,7 +15829,7 @@ private constructor(
              * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
              *   expected type.
              */
-            fun validate(): Type = apply {
+            fun validate(): Status = apply {
                 if (validated) {
                     return@apply
                 }
@@ -12531,7 +15859,7 @@ private constructor(
                     return true
                 }
 
-                return other is Type && value == other.value
+                return other is Status && value == other.value
             }
 
             override fun hashCode() = value.hashCode()
@@ -12544,17 +15872,22 @@ private constructor(
                 return true
             }
 
-            return other is ItemReference &&
+            return other is ProgramOutput &&
                 id == other.id &&
+                callId == other.callId &&
+                result == other.result &&
+                status == other.status &&
                 type == other.type &&
                 additionalProperties == other.additionalProperties
         }
 
-        private val hashCode: Int by lazy { Objects.hash(id, type, additionalProperties) }
+        private val hashCode: Int by lazy {
+            Objects.hash(id, callId, result, status, type, additionalProperties)
+        }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "ItemReference{id=$id, type=$type, additionalProperties=$additionalProperties}"
+            "ProgramOutput{id=$id, callId=$callId, result=$result, status=$status, type=$type, additionalProperties=$additionalProperties}"
     }
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputText.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputText.kt
index ae42dc5eb..dbaea2cf4 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputText.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputText.kt
@@ -14,6 +14,8 @@ import com.openai.core.checkRequired
 import com.openai.errors.OpenAIInvalidDataException
 import java.util.Collections
 import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
 
 /** A text input to the model. */
 class ResponseInputText
@@ -21,6 +23,7 @@ class ResponseInputText
 private constructor(
     private val text: JsonField<String>,
     private val type: JsonValue,
+    private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -28,7 +31,10 @@ private constructor(
     private constructor(
         @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-    ) : this(text, type, mutableMapOf())
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+    ) : this(text, type, promptCacheBreakpoint, mutableMapOf())
 
     /**
      * The text input to the model.
@@ -51,6 +57,16 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+        promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
     /**
      * Returns the raw JSON value of [text].
      *
@@ -58,6 +74,16 @@ private constructor(
      */
     @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
 
+    /**
+     * Returns the raw JSON value of [promptCacheBreakpoint].
+     *
+     * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_breakpoint")
+    @ExcludeMissing
+    fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -88,12 +114,14 @@ private constructor(
 
         private var text: JsonField<String>? = null
         private var type: JsonValue = JsonValue.from("input_text")
+        private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
         internal fun from(responseInputText: ResponseInputText) = apply {
             text = responseInputText.text
             type = responseInputText.type
+            promptCacheBreakpoint = responseInputText.promptCacheBreakpoint
             additionalProperties = responseInputText.additionalProperties.toMutableMap()
         }
 
@@ -122,6 +150,24 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint) =
+            promptCacheBreakpoint(JsonField.of(promptCacheBreakpoint))
+
+        /**
+         * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+         * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) = apply {
+            this.promptCacheBreakpoint = promptCacheBreakpoint
+        }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -157,6 +203,7 @@ private constructor(
             ResponseInputText(
                 checkRequired("text", text),
                 type,
+                promptCacheBreakpoint,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -182,6 +229,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        promptCacheBreakpoint().ifPresent { it.validate() }
         validated = true
     }
 
@@ -201,7 +249,170 @@ private constructor(
     @JvmSynthetic
     internal fun validity(): Int =
         (if (text.asKnown().isPresent) 1 else 0) +
-            type.let { if (it == JsonValue.from("input_text")) 1 else 0 }
+            type.let { if (it == JsonValue.from("input_text")) 1 else 0 } +
+            (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     */
+    class PromptCacheBreakpoint
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+        ) : this(mode, mutableMapOf())
+
+        /**
+         * The breakpoint mode. Always `explicit`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("explicit")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheBreakpoint].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheBreakpoint]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonValue = JsonValue.from("explicit")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                mode = promptCacheBreakpoint.mode
+                additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheBreakpoint].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheBreakpoint =
+                PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheBreakpoint = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _mode().let {
+                if (it != JsonValue.from("explicit")) {
+                    throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheBreakpoint &&
+                mode == other.mode &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+    }
 
     override fun equals(other: Any?): Boolean {
         if (this === other) {
@@ -211,13 +422,16 @@ private constructor(
         return other is ResponseInputText &&
             text == other.text &&
             type == other.type &&
+            promptCacheBreakpoint == other.promptCacheBreakpoint &&
             additionalProperties == other.additionalProperties
     }
 
-    private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+    private val hashCode: Int by lazy {
+        Objects.hash(text, type, promptCacheBreakpoint, additionalProperties)
+    }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseInputText{text=$text, type=$type, additionalProperties=$additionalProperties}"
+        "ResponseInputText{text=$text, type=$type, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputTextContent.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputTextContent.kt
index 6206319f2..9088c06d3 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputTextContent.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputTextContent.kt
@@ -14,6 +14,8 @@ import com.openai.core.checkRequired
 import com.openai.errors.OpenAIInvalidDataException
 import java.util.Collections
 import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
 
 /** A text input to the model. */
 class ResponseInputTextContent
@@ -21,6 +23,7 @@ class ResponseInputTextContent
 private constructor(
     private val text: JsonField<String>,
     private val type: JsonValue,
+    private val promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -28,7 +31,10 @@ private constructor(
     private constructor(
         @JsonProperty("text") @ExcludeMissing text: JsonField<String> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-    ) : this(text, type, mutableMapOf())
+        @JsonProperty("prompt_cache_breakpoint")
+        @ExcludeMissing
+        promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of(),
+    ) : this(text, type, promptCacheBreakpoint, mutableMapOf())
 
     /**
      * The text input to the model.
@@ -51,6 +57,16 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheBreakpoint(): Optional<PromptCacheBreakpoint> =
+        promptCacheBreakpoint.getOptional("prompt_cache_breakpoint")
+
     /**
      * Returns the raw JSON value of [text].
      *
@@ -58,6 +74,16 @@ private constructor(
      */
     @JsonProperty("text") @ExcludeMissing fun _text(): JsonField<String> = text
 
+    /**
+     * Returns the raw JSON value of [promptCacheBreakpoint].
+     *
+     * Unlike [promptCacheBreakpoint], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_breakpoint")
+    @ExcludeMissing
+    fun _promptCacheBreakpoint(): JsonField<PromptCacheBreakpoint> = promptCacheBreakpoint
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -88,12 +114,14 @@ private constructor(
 
         private var text: JsonField<String>? = null
         private var type: JsonValue = JsonValue.from("input_text")
+        private var promptCacheBreakpoint: JsonField<PromptCacheBreakpoint> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
         internal fun from(responseInputTextContent: ResponseInputTextContent) = apply {
             text = responseInputTextContent.text
             type = responseInputTextContent.type
+            promptCacheBreakpoint = responseInputTextContent.promptCacheBreakpoint
             additionalProperties = responseInputTextContent.additionalProperties.toMutableMap()
         }
 
@@ -122,6 +150,31 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /**
+         * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+         * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: PromptCacheBreakpoint?) =
+            promptCacheBreakpoint(JsonField.ofNullable(promptCacheBreakpoint))
+
+        /**
+         * Alias for calling [Builder.promptCacheBreakpoint] with
+         * `promptCacheBreakpoint.orElse(null)`.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: Optional<PromptCacheBreakpoint>) =
+            promptCacheBreakpoint(promptCacheBreakpoint.getOrNull())
+
+        /**
+         * Sets [Builder.promptCacheBreakpoint] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheBreakpoint] with a well-typed
+         * [PromptCacheBreakpoint] value instead. This method is primarily for setting the field to
+         * an undocumented or not yet supported value.
+         */
+        fun promptCacheBreakpoint(promptCacheBreakpoint: JsonField<PromptCacheBreakpoint>) = apply {
+            this.promptCacheBreakpoint = promptCacheBreakpoint
+        }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -157,6 +210,7 @@ private constructor(
             ResponseInputTextContent(
                 checkRequired("text", text),
                 type,
+                promptCacheBreakpoint,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -182,6 +236,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        promptCacheBreakpoint().ifPresent { it.validate() }
         validated = true
     }
 
@@ -201,7 +256,170 @@ private constructor(
     @JvmSynthetic
     internal fun validity(): Int =
         (if (text.asKnown().isPresent) 1 else 0) +
-            type.let { if (it == JsonValue.from("input_text")) 1 else 0 }
+            type.let { if (it == JsonValue.from("input_text")) 1 else 0 } +
+            (promptCacheBreakpoint.asKnown().getOrNull()?.validity() ?: 0)
+
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL from the
+     * request's `prompt_cache_options.ttl`; the boundary is not rounded to a token block.
+     */
+    class PromptCacheBreakpoint
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonValue = JsonMissing.of()
+        ) : this(mode, mutableMapOf())
+
+        /**
+         * The breakpoint mode. Always `explicit`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("explicit")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonValue = mode
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [PromptCacheBreakpoint].
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheBreakpoint]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonValue = JsonValue.from("explicit")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheBreakpoint: PromptCacheBreakpoint) = apply {
+                mode = promptCacheBreakpoint.mode
+                additionalProperties = promptCacheBreakpoint.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("explicit")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun mode(mode: JsonValue) = apply { this.mode = mode }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheBreakpoint].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheBreakpoint =
+                PromptCacheBreakpoint(mode, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheBreakpoint = apply {
+            if (validated) {
+                return@apply
+            }
+
+            _mode().let {
+                if (it != JsonValue.from("explicit")) {
+                    throw OpenAIInvalidDataException("'mode' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int = mode.let { if (it == JsonValue.from("explicit")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheBreakpoint &&
+                mode == other.mode &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheBreakpoint{mode=$mode, additionalProperties=$additionalProperties}"
+    }
 
     override fun equals(other: Any?): Boolean {
         if (this === other) {
@@ -211,13 +429,16 @@ private constructor(
         return other is ResponseInputTextContent &&
             text == other.text &&
             type == other.type &&
+            promptCacheBreakpoint == other.promptCacheBreakpoint &&
             additionalProperties == other.additionalProperties
     }
 
-    private val hashCode: Int by lazy { Objects.hash(text, type, additionalProperties) }
+    private val hashCode: Int by lazy {
+        Objects.hash(text, type, promptCacheBreakpoint, additionalProperties)
+    }
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseInputTextContent{text=$text, type=$type, additionalProperties=$additionalProperties}"
+        "ResponseInputTextContent{text=$text, type=$type, promptCacheBreakpoint=$promptCacheBreakpoint, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseItem.kt
index 2bab2b9c5..29235369d 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseItem.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseItem.kt
@@ -48,6 +48,8 @@ private constructor(
     private val toolSearchOutput: ResponseToolSearchOutputItem? = null,
     private val additionalTools: AdditionalTools? = null,
     private val reasoning: ResponseReasoningItem? = null,
+    private val program: Program? = null,
+    private val programOutput: ProgramOutput? = null,
     private val compaction: ResponseCompactionItem? = null,
     private val imageGenerationCall: ImageGenerationCall? = null,
     private val codeInterpreterCall: ResponseCodeInterpreterToolCall? = null,
@@ -122,6 +124,10 @@ private constructor(
      */
     fun reasoning(): Optional<ResponseReasoningItem> = Optional.ofNullable(reasoning)
 
+    fun program(): Optional<Program> = Optional.ofNullable(program)
+
+    fun programOutput(): Optional<ProgramOutput> = Optional.ofNullable(programOutput)
+
     /**
      * A compaction item generated by the
      * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
@@ -201,6 +207,10 @@ private constructor(
 
     fun isReasoning(): Boolean = reasoning != null
 
+    fun isProgram(): Boolean = program != null
+
+    fun isProgramOutput(): Boolean = programOutput != null
+
     fun isCompaction(): Boolean = compaction != null
 
     fun isImageGenerationCall(): Boolean = imageGenerationCall != null
@@ -287,6 +297,10 @@ private constructor(
      */
     fun asReasoning(): ResponseReasoningItem = reasoning.getOrThrow("reasoning")
 
+    fun asProgram(): Program = program.getOrThrow("program")
+
+    fun asProgramOutput(): ProgramOutput = programOutput.getOrThrow("programOutput")
+
     /**
      * A compaction item generated by the
      * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
@@ -390,6 +404,8 @@ private constructor(
             toolSearchOutput != null -> visitor.visitToolSearchOutput(toolSearchOutput)
             additionalTools != null -> visitor.visitAdditionalTools(additionalTools)
             reasoning != null -> visitor.visitReasoning(reasoning)
+            program != null -> visitor.visitProgram(program)
+            programOutput != null -> visitor.visitProgramOutput(programOutput)
             compaction != null -> visitor.visitCompaction(compaction)
             imageGenerationCall != null -> visitor.visitImageGenerationCall(imageGenerationCall)
             codeInterpreterCall != null -> visitor.visitCodeInterpreterCall(codeInterpreterCall)
@@ -481,6 +497,14 @@ private constructor(
                     reasoning.validate()
                 }
 
+                override fun visitProgram(program: Program) {
+                    program.validate()
+                }
+
+                override fun visitProgramOutput(programOutput: ProgramOutput) {
+                    programOutput.validate()
+                }
+
                 override fun visitCompaction(compaction: ResponseCompactionItem) {
                     compaction.validate()
                 }
@@ -609,6 +633,11 @@ private constructor(
 
                 override fun visitReasoning(reasoning: ResponseReasoningItem) = reasoning.validity()
 
+                override fun visitProgram(program: Program) = program.validity()
+
+                override fun visitProgramOutput(programOutput: ProgramOutput) =
+                    programOutput.validity()
+
                 override fun visitCompaction(compaction: ResponseCompactionItem) =
                     compaction.validity()
 
@@ -678,6 +707,8 @@ private constructor(
             toolSearchOutput == other.toolSearchOutput &&
             additionalTools == other.additionalTools &&
             reasoning == other.reasoning &&
+            program == other.program &&
+            programOutput == other.programOutput &&
             compaction == other.compaction &&
             imageGenerationCall == other.imageGenerationCall &&
             codeInterpreterCall == other.codeInterpreterCall &&
@@ -709,6 +740,8 @@ private constructor(
             toolSearchOutput,
             additionalTools,
             reasoning,
+            program,
+            programOutput,
             compaction,
             imageGenerationCall,
             codeInterpreterCall,
@@ -742,6 +775,8 @@ private constructor(
             toolSearchOutput != null -> "ResponseItem{toolSearchOutput=$toolSearchOutput}"
             additionalTools != null -> "ResponseItem{additionalTools=$additionalTools}"
             reasoning != null -> "ResponseItem{reasoning=$reasoning}"
+            program != null -> "ResponseItem{program=$program}"
+            programOutput != null -> "ResponseItem{programOutput=$programOutput}"
             compaction != null -> "ResponseItem{compaction=$compaction}"
             imageGenerationCall != null -> "ResponseItem{imageGenerationCall=$imageGenerationCall}"
             codeInterpreterCall != null -> "ResponseItem{codeInterpreterCall=$codeInterpreterCall}"
@@ -840,6 +875,12 @@ private constructor(
         @JvmStatic
         fun ofReasoning(reasoning: ResponseReasoningItem) = ResponseItem(reasoning = reasoning)
 
+        @JvmStatic fun ofProgram(program: Program) = ResponseItem(program = program)
+
+        @JvmStatic
+        fun ofProgramOutput(programOutput: ProgramOutput) =
+            ResponseItem(programOutput = programOutput)
+
         /**
          * A compaction item generated by the
          * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
@@ -971,6 +1012,10 @@ private constructor(
          */
         fun visitReasoning(reasoning: ResponseReasoningItem): T
 
+        fun visitProgram(program: Program): T
+
+        fun visitProgramOutput(programOutput: ProgramOutput): T
+
         /**
          * A compaction item generated by the
          * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
@@ -1121,6 +1166,16 @@ private constructor(
                         ResponseItem(reasoning = it, _json = json)
                     } ?: ResponseItem(_json = json)
                 }
+                "program" -> {
+                    return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                        ResponseItem(program = it, _json = json)
+                    } ?: ResponseItem(_json = json)
+                }
+                "program_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ProgramOutput>())?.let {
+                        ResponseItem(programOutput = it, _json = json)
+                    } ?: ResponseItem(_json = json)
+                }
                 "compaction" -> {
                     return tryDeserialize(node, jacksonTypeRef<ResponseCompactionItem>())?.let {
                         ResponseItem(compaction = it, _json = json)
@@ -1227,6 +1282,8 @@ private constructor(
                 value.toolSearchOutput != null -> generator.writeObject(value.toolSearchOutput)
                 value.additionalTools != null -> generator.writeObject(value.additionalTools)
                 value.reasoning != null -> generator.writeObject(value.reasoning)
+                value.program != null -> generator.writeObject(value.program)
+                value.programOutput != null -> generator.writeObject(value.programOutput)
                 value.compaction != null -> generator.writeObject(value.compaction)
                 value.imageGenerationCall != null ->
                     generator.writeObject(value.imageGenerationCall)
@@ -1501,6 +1558,9 @@ private constructor(
                     )
                 )
 
+            /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+            fun addToolProgrammaticToolCalling() = addTool(Tool.ofProgrammaticToolCalling())
+
             /** Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`. */
             fun addTool(imageGeneration: Tool.ImageGeneration) =
                 addTool(Tool.ofImageGeneration(imageGeneration))
@@ -1839,6 +1899,796 @@ private constructor(
             "AdditionalTools{id=$id, role=$role, tools=$tools, type=$type, additionalProperties=$additionalProperties}"
     }
 
+    class Program
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val callId: JsonField<String>,
+        private val code: JsonField<String>,
+        private val fingerprint: JsonField<String>,
+        private val type: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("code") @ExcludeMissing code: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("fingerprint")
+            @ExcludeMissing
+            fingerprint: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(id, callId, code, fingerprint, type, mutableMapOf())
+
+        /**
+         * The unique ID of the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The stable call ID of the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The JavaScript source executed by programmatic tool calling.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun code(): String = code.getRequired("code")
+
+        /**
+         * Opaque program replay fingerprint that must be round-tripped.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun fingerprint(): String = fingerprint.getRequired("fingerprint")
+
+        /**
+         * The type of the item. Always `program`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("program")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [code].
+         *
+         * Unlike [code], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<String> = code
+
+        /**
+         * Returns the raw JSON value of [fingerprint].
+         *
+         * Unlike [fingerprint], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("fingerprint")
+        @ExcludeMissing
+        fun _fingerprint(): JsonField<String> = fingerprint
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Program].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .code()
+             * .fingerprint()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Program]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var callId: JsonField<String>? = null
+            private var code: JsonField<String>? = null
+            private var fingerprint: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("program")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(program: Program) = apply {
+                id = program.id
+                callId = program.callId
+                code = program.code
+                fingerprint = program.fingerprint
+                type = program.type
+                additionalProperties = program.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the program item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The stable call ID of the program item. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The JavaScript source executed by programmatic tool calling. */
+            fun code(code: String) = code(JsonField.of(code))
+
+            /**
+             * Sets [Builder.code] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.code] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun code(code: JsonField<String>) = apply { this.code = code }
+
+            /** Opaque program replay fingerprint that must be round-tripped. */
+            fun fingerprint(fingerprint: String) = fingerprint(JsonField.of(fingerprint))
+
+            /**
+             * Sets [Builder.fingerprint] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.fingerprint] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun fingerprint(fingerprint: JsonField<String>) = apply {
+                this.fingerprint = fingerprint
+            }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Program].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .code()
+             * .fingerprint()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Program =
+                Program(
+                    checkRequired("id", id),
+                    checkRequired("callId", callId),
+                    checkRequired("code", code),
+                    checkRequired("fingerprint", fingerprint),
+                    type,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Program = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            callId()
+            code()
+            fingerprint()
+            _type().let {
+                if (it != JsonValue.from("program")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (if (code.asKnown().isPresent) 1 else 0) +
+                (if (fingerprint.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("program")) 1 else 0 }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Program &&
+                id == other.id &&
+                callId == other.callId &&
+                code == other.code &&
+                fingerprint == other.fingerprint &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, callId, code, fingerprint, type, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Program{id=$id, callId=$callId, code=$code, fingerprint=$fingerprint, type=$type, additionalProperties=$additionalProperties}"
+    }
+
+    class ProgramOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val callId: JsonField<String>,
+        private val result: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("result") @ExcludeMissing result: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(id, callId, result, status, type, mutableMapOf())
+
+        /**
+         * The unique ID of the program output item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The call ID of the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The result produced by the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun result(): String = result.getRequired("result")
+
+        /**
+         * The terminal status of the program output item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The type of the item. Always `program_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("program_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [result].
+         *
+         * Unlike [result], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("result") @ExcludeMissing fun _result(): JsonField<String> = result
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ProgramOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .result()
+             * .status()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ProgramOutput]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var callId: JsonField<String>? = null
+            private var result: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("program_output")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(programOutput: ProgramOutput) = apply {
+                id = programOutput.id
+                callId = programOutput.callId
+                result = programOutput.result
+                status = programOutput.status
+                type = programOutput.type
+                additionalProperties = programOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the program output item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The call ID of the program item. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The result produced by the program item. */
+            fun result(result: String) = result(JsonField.of(result))
+
+            /**
+             * Sets [Builder.result] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.result] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun result(result: JsonField<String>) = apply { this.result = result }
+
+            /** The terminal status of the program output item. */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("program_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ProgramOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .result()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ProgramOutput =
+                ProgramOutput(
+                    checkRequired("id", id),
+                    checkRequired("callId", callId),
+                    checkRequired("result", result),
+                    checkRequired("status", status),
+                    type,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ProgramOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            callId()
+            result()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("program_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (if (result.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("program_output")) 1 else 0 }
+
+        /** The terminal status of the program output item. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ProgramOutput &&
+                id == other.id &&
+                callId == other.callId &&
+                result == other.result &&
+                status == other.status &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, callId, result, status, type, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ProgramOutput{id=$id, callId=$callId, result=$result, status=$status, type=$type, additionalProperties=$additionalProperties}"
+    }
+
     /** An image generation request made by the model. */
     class ImageGenerationCall
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseOutputItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseOutputItem.kt
index a3388b576..df8cbcaf6 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseOutputItem.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseOutputItem.kt
@@ -43,6 +43,8 @@ private constructor(
     private val computerCall: ResponseComputerToolCall? = null,
     private val computerCallOutput: ResponseComputerToolCallOutputItem? = null,
     private val reasoning: ResponseReasoningItem? = null,
+    private val program: Program? = null,
+    private val programOutput: ProgramOutput? = null,
     private val toolSearchCall: ResponseToolSearchCall? = null,
     private val toolSearchOutput: ResponseToolSearchOutputItem? = null,
     private val additionalTools: AdditionalTools? = null,
@@ -109,6 +111,10 @@ private constructor(
      */
     fun reasoning(): Optional<ResponseReasoningItem> = Optional.ofNullable(reasoning)
 
+    fun program(): Optional<Program> = Optional.ofNullable(program)
+
+    fun programOutput(): Optional<ProgramOutput> = Optional.ofNullable(programOutput)
+
     fun toolSearchCall(): Optional<ResponseToolSearchCall> = Optional.ofNullable(toolSearchCall)
 
     fun toolSearchOutput(): Optional<ResponseToolSearchOutputItem> =
@@ -187,6 +193,10 @@ private constructor(
 
     fun isReasoning(): Boolean = reasoning != null
 
+    fun isProgram(): Boolean = program != null
+
+    fun isProgramOutput(): Boolean = programOutput != null
+
     fun isToolSearchCall(): Boolean = toolSearchCall != null
 
     fun isToolSearchOutput(): Boolean = toolSearchOutput != null
@@ -268,6 +278,10 @@ private constructor(
      */
     fun asReasoning(): ResponseReasoningItem = reasoning.getOrThrow("reasoning")
 
+    fun asProgram(): Program = program.getOrThrow("program")
+
+    fun asProgramOutput(): ProgramOutput = programOutput.getOrThrow("programOutput")
+
     fun asToolSearchCall(): ResponseToolSearchCall = toolSearchCall.getOrThrow("toolSearchCall")
 
     fun asToolSearchOutput(): ResponseToolSearchOutputItem =
@@ -372,6 +386,8 @@ private constructor(
             computerCall != null -> visitor.visitComputerCall(computerCall)
             computerCallOutput != null -> visitor.visitComputerCallOutput(computerCallOutput)
             reasoning != null -> visitor.visitReasoning(reasoning)
+            program != null -> visitor.visitProgram(program)
+            programOutput != null -> visitor.visitProgramOutput(programOutput)
             toolSearchCall != null -> visitor.visitToolSearchCall(toolSearchCall)
             toolSearchOutput != null -> visitor.visitToolSearchOutput(toolSearchOutput)
             additionalTools != null -> visitor.visitAdditionalTools(additionalTools)
@@ -446,6 +462,14 @@ private constructor(
                     reasoning.validate()
                 }
 
+                override fun visitProgram(program: Program) {
+                    program.validate()
+                }
+
+                override fun visitProgramOutput(programOutput: ProgramOutput) {
+                    programOutput.validate()
+                }
+
                 override fun visitToolSearchCall(toolSearchCall: ResponseToolSearchCall) {
                     toolSearchCall.validate()
                 }
@@ -571,6 +595,11 @@ private constructor(
 
                 override fun visitReasoning(reasoning: ResponseReasoningItem) = reasoning.validity()
 
+                override fun visitProgram(program: Program) = program.validity()
+
+                override fun visitProgramOutput(programOutput: ProgramOutput) =
+                    programOutput.validity()
+
                 override fun visitToolSearchCall(toolSearchCall: ResponseToolSearchCall) =
                     toolSearchCall.validity()
 
@@ -645,6 +674,8 @@ private constructor(
             computerCall == other.computerCall &&
             computerCallOutput == other.computerCallOutput &&
             reasoning == other.reasoning &&
+            program == other.program &&
+            programOutput == other.programOutput &&
             toolSearchCall == other.toolSearchCall &&
             toolSearchOutput == other.toolSearchOutput &&
             additionalTools == other.additionalTools &&
@@ -675,6 +706,8 @@ private constructor(
             computerCall,
             computerCallOutput,
             reasoning,
+            program,
+            programOutput,
             toolSearchCall,
             toolSearchOutput,
             additionalTools,
@@ -707,6 +740,8 @@ private constructor(
             computerCallOutput != null ->
                 "ResponseOutputItem{computerCallOutput=$computerCallOutput}"
             reasoning != null -> "ResponseOutputItem{reasoning=$reasoning}"
+            program != null -> "ResponseOutputItem{program=$program}"
+            programOutput != null -> "ResponseOutputItem{programOutput=$programOutput}"
             toolSearchCall != null -> "ResponseOutputItem{toolSearchCall=$toolSearchCall}"
             toolSearchOutput != null -> "ResponseOutputItem{toolSearchOutput=$toolSearchOutput}"
             additionalTools != null -> "ResponseOutputItem{additionalTools=$additionalTools}"
@@ -796,6 +831,12 @@ private constructor(
         fun ofReasoning(reasoning: ResponseReasoningItem) =
             ResponseOutputItem(reasoning = reasoning)
 
+        @JvmStatic fun ofProgram(program: Program) = ResponseOutputItem(program = program)
+
+        @JvmStatic
+        fun ofProgramOutput(programOutput: ProgramOutput) =
+            ResponseOutputItem(programOutput = programOutput)
+
         @JvmStatic
         fun ofToolSearchCall(toolSearchCall: ResponseToolSearchCall) =
             ResponseOutputItem(toolSearchCall = toolSearchCall)
@@ -934,6 +975,10 @@ private constructor(
          */
         fun visitReasoning(reasoning: ResponseReasoningItem): T
 
+        fun visitProgram(program: Program): T
+
+        fun visitProgramOutput(programOutput: ProgramOutput): T
+
         fun visitToolSearchCall(toolSearchCall: ResponseToolSearchCall): T
 
         fun visitToolSearchOutput(toolSearchOutput: ResponseToolSearchOutputItem): T
@@ -1056,6 +1101,16 @@ private constructor(
                         ResponseOutputItem(reasoning = it, _json = json)
                     } ?: ResponseOutputItem(_json = json)
                 }
+                "program" -> {
+                    return tryDeserialize(node, jacksonTypeRef<Program>())?.let {
+                        ResponseOutputItem(program = it, _json = json)
+                    } ?: ResponseOutputItem(_json = json)
+                }
+                "program_output" -> {
+                    return tryDeserialize(node, jacksonTypeRef<ProgramOutput>())?.let {
+                        ResponseOutputItem(programOutput = it, _json = json)
+                    } ?: ResponseOutputItem(_json = json)
+                }
                 "tool_search_call" -> {
                     return tryDeserialize(node, jacksonTypeRef<ResponseToolSearchCall>())?.let {
                         ResponseOutputItem(toolSearchCall = it, _json = json)
@@ -1171,6 +1226,8 @@ private constructor(
                 value.computerCall != null -> generator.writeObject(value.computerCall)
                 value.computerCallOutput != null -> generator.writeObject(value.computerCallOutput)
                 value.reasoning != null -> generator.writeObject(value.reasoning)
+                value.program != null -> generator.writeObject(value.program)
+                value.programOutput != null -> generator.writeObject(value.programOutput)
                 value.toolSearchCall != null -> generator.writeObject(value.toolSearchCall)
                 value.toolSearchOutput != null -> generator.writeObject(value.toolSearchOutput)
                 value.additionalTools != null -> generator.writeObject(value.additionalTools)
@@ -1201,12 +1258,13 @@ private constructor(
         }
     }
 
-    class AdditionalTools
+    class Program
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
         private val id: JsonField<String>,
-        private val role: JsonField<Role>,
-        private val tools: JsonField<List<Tool>>,
+        private val callId: JsonField<String>,
+        private val code: JsonField<String>,
+        private val fingerprint: JsonField<String>,
         private val type: JsonValue,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
@@ -1214,13 +1272,16 @@ private constructor(
         @JsonCreator
         private constructor(
             @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
-            @JsonProperty("role") @ExcludeMissing role: JsonField<Role> = JsonMissing.of(),
-            @JsonProperty("tools") @ExcludeMissing tools: JsonField<List<Tool>> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("code") @ExcludeMissing code: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("fingerprint")
+            @ExcludeMissing
+            fingerprint: JsonField<String> = JsonMissing.of(),
             @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-        ) : this(id, role, tools, type, mutableMapOf())
+        ) : this(id, callId, code, fingerprint, type, mutableMapOf())
 
         /**
-         * The unique ID of the additional tools item.
+         * The unique ID of the program item.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
@@ -1228,27 +1289,35 @@ private constructor(
         fun id(): String = id.getRequired("id")
 
         /**
-         * The role that provided the additional tools.
+         * The stable call ID of the program item.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun role(): Role = role.getRequired("role")
+        fun callId(): String = callId.getRequired("call_id")
 
         /**
-         * The additional tool definitions made available at this item.
+         * The JavaScript source executed by programmatic tool calling.
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
-        fun tools(): List<Tool> = tools.getRequired("tools")
+        fun code(): String = code.getRequired("code")
 
         /**
-         * The type of the item. Always `additional_tools`.
+         * Opaque program replay fingerprint that must be round-tripped.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun fingerprint(): String = fingerprint.getRequired("fingerprint")
+
+        /**
+         * The type of the item. Always `program`.
          *
          * Expected to always return the following:
          * ```java
-         * JsonValue.from("additional_tools")
+         * JsonValue.from("program")
          * ```
          *
          * However, this method can be useful for debugging and logging (e.g. if the server
@@ -1264,18 +1333,27 @@ private constructor(
         @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
 
         /**
-         * Returns the raw JSON value of [role].
+         * Returns the raw JSON value of [callId].
          *
-         * Unlike [role], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("role") @ExcludeMissing fun _role(): JsonField<Role> = role
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
 
         /**
-         * Returns the raw JSON value of [tools].
+         * Returns the raw JSON value of [code].
          *
-         * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+         * Unlike [code], this method doesn't throw if the JSON field has an unexpected type.
          */
-        @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<Tool>> = tools
+        @JsonProperty("code") @ExcludeMissing fun _code(): JsonField<String> = code
+
+        /**
+         * Returns the raw JSON value of [fingerprint].
+         *
+         * Unlike [fingerprint], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("fingerprint")
+        @ExcludeMissing
+        fun _fingerprint(): JsonField<String> = fingerprint
 
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
@@ -1292,37 +1370,40 @@ private constructor(
         companion object {
 
             /**
-             * Returns a mutable builder for constructing an instance of [AdditionalTools].
+             * Returns a mutable builder for constructing an instance of [Program].
              *
              * The following fields are required:
              * ```java
              * .id()
-             * .role()
-             * .tools()
+             * .callId()
+             * .code()
+             * .fingerprint()
              * ```
              */
             @JvmStatic fun builder() = Builder()
         }
 
-        /** A builder for [AdditionalTools]. */
+        /** A builder for [Program]. */
         class Builder internal constructor() {
 
             private var id: JsonField<String>? = null
-            private var role: JsonField<Role>? = null
-            private var tools: JsonField<MutableList<Tool>>? = null
-            private var type: JsonValue = JsonValue.from("additional_tools")
+            private var callId: JsonField<String>? = null
+            private var code: JsonField<String>? = null
+            private var fingerprint: JsonField<String>? = null
+            private var type: JsonValue = JsonValue.from("program")
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
-            internal fun from(additionalTools: AdditionalTools) = apply {
-                id = additionalTools.id
-                role = additionalTools.role
-                tools = additionalTools.tools.map { it.toMutableList() }
-                type = additionalTools.type
-                additionalProperties = additionalTools.additionalProperties.toMutableMap()
+            internal fun from(program: Program) = apply {
+                id = program.id
+                callId = program.callId
+                code = program.code
+                fingerprint = program.fingerprint
+                type = program.type
+                additionalProperties = program.additionalProperties.toMutableMap()
             }
 
-            /** The unique ID of the additional tools item. */
+            /** The unique ID of the program item. */
             fun id(id: String) = id(JsonField.of(id))
 
             /**
@@ -1334,119 +1415,888 @@ private constructor(
              */
             fun id(id: JsonField<String>) = apply { this.id = id }
 
-            /** The role that provided the additional tools. */
-            fun role(role: Role) = role(JsonField.of(role))
+            /** The stable call ID of the program item. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
 
             /**
-             * Sets [Builder.role] to an arbitrary JSON value.
+             * Sets [Builder.callId] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.role] with a well-typed [Role] value instead. This
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The JavaScript source executed by programmatic tool calling. */
+            fun code(code: String) = code(JsonField.of(code))
+
+            /**
+             * Sets [Builder.code] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.code] with a well-typed [String] value instead. This
              * method is primarily for setting the field to an undocumented or not yet supported
              * value.
              */
-            fun role(role: JsonField<Role>) = apply { this.role = role }
+            fun code(code: JsonField<String>) = apply { this.code = code }
 
-            /** The additional tool definitions made available at this item. */
-            fun tools(tools: List<Tool>) = tools(JsonField.of(tools))
+            /** Opaque program replay fingerprint that must be round-tripped. */
+            fun fingerprint(fingerprint: String) = fingerprint(JsonField.of(fingerprint))
 
             /**
-             * Sets [Builder.tools] to an arbitrary JSON value.
+             * Sets [Builder.fingerprint] to an arbitrary JSON value.
              *
-             * You should usually call [Builder.tools] with a well-typed `List<Tool>` value instead.
-             * This method is primarily for setting the field to an undocumented or not yet
+             * You should usually call [Builder.fingerprint] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
              * supported value.
              */
-            fun tools(tools: JsonField<List<Tool>>) = apply {
-                this.tools = tools.map { it.toMutableList() }
+            fun fingerprint(fingerprint: JsonField<String>) = apply {
+                this.fingerprint = fingerprint
             }
 
             /**
-             * Adds a single [Tool] to [tools].
+             * Sets the field to an arbitrary JSON value.
              *
-             * @throws IllegalStateException if the field was previously set to a non-list.
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("program")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
              */
-            fun addTool(tool: Tool) = apply {
-                tools =
-                    (tools ?: JsonField.of(mutableListOf())).also {
-                        checkKnown("tools", it).add(tool)
-                    }
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
             }
 
-            /** Alias for calling [addTool] with `Tool.ofFunction(function)`. */
-            fun addTool(function: FunctionTool) = addTool(Tool.ofFunction(function))
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
 
-            /** Alias for calling [addTool] with `Tool.ofFileSearch(fileSearch)`. */
-            fun addTool(fileSearch: FileSearchTool) = addTool(Tool.ofFileSearch(fileSearch))
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
 
             /**
-             * Alias for calling [addTool] with the following:
+             * Returns an immutable instance of [Program].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
              * ```java
-             * FileSearchTool.builder()
-             *     .vectorStoreIds(vectorStoreIds)
-             *     .build()
+             * .id()
+             * .callId()
+             * .code()
+             * .fingerprint()
              * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
              */
-            fun addFileSearchTool(vectorStoreIds: List<String>) =
-                addTool(FileSearchTool.builder().vectorStoreIds(vectorStoreIds).build())
+            fun build(): Program =
+                Program(
+                    checkRequired("id", id),
+                    checkRequired("callId", callId),
+                    checkRequired("code", code),
+                    checkRequired("fingerprint", fingerprint),
+                    type,
+                    additionalProperties.toMutableMap(),
+                )
+        }
 
-            /** Alias for calling [addTool] with `Tool.ofComputer(computer)`. */
-            fun addTool(computer: ComputerTool) = addTool(Tool.ofComputer(computer))
+        private var validated: Boolean = false
 
-            /** Alias for calling [addTool] with `Tool.ofComputerUsePreview(computerUsePreview)`. */
-            fun addTool(computerUsePreview: ComputerUsePreviewTool) =
-                addTool(Tool.ofComputerUsePreview(computerUsePreview))
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Program = apply {
+            if (validated) {
+                return@apply
+            }
 
-            /** Alias for calling [addTool] with `Tool.ofWebSearch(webSearch)`. */
-            fun addTool(webSearch: WebSearchTool) = addTool(Tool.ofWebSearch(webSearch))
+            id()
+            callId()
+            code()
+            fingerprint()
+            _type().let {
+                if (it != JsonValue.from("program")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
 
-            /** Alias for calling [addTool] with `Tool.ofMcp(mcp)`. */
-            fun addTool(mcp: Tool.Mcp) = addTool(Tool.ofMcp(mcp))
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
 
-            /**
-             * Alias for calling [addTool] with the following:
-             * ```java
-             * Tool.Mcp.builder()
-             *     .serverLabel(serverLabel)
-             *     .build()
-             * ```
-             */
-            fun addMcpTool(serverLabel: String) =
-                addTool(Tool.Mcp.builder().serverLabel(serverLabel).build())
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (if (code.asKnown().isPresent) 1 else 0) +
+                (if (fingerprint.asKnown().isPresent) 1 else 0) +
+                type.let { if (it == JsonValue.from("program")) 1 else 0 }
 
-            /** Alias for calling [addTool] with `Tool.ofCodeInterpreter(codeInterpreter)`. */
-            fun addTool(codeInterpreter: Tool.CodeInterpreter) =
-                addTool(Tool.ofCodeInterpreter(codeInterpreter))
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
 
-            /**
-             * Alias for calling [addTool] with the following:
-             * ```java
-             * Tool.CodeInterpreter.builder()
-             *     .container(container)
-             *     .build()
-             * ```
-             */
-            fun addCodeInterpreterTool(container: Tool.CodeInterpreter.Container) =
-                addTool(Tool.CodeInterpreter.builder().container(container).build())
+            return other is Program &&
+                id == other.id &&
+                callId == other.callId &&
+                code == other.code &&
+                fingerprint == other.fingerprint &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
 
-            /**
-             * Alias for calling [addCodeInterpreterTool] with
-             * `Tool.CodeInterpreter.Container.ofString(string)`.
-             */
-            fun addCodeInterpreterTool(string: String) =
-                addCodeInterpreterTool(Tool.CodeInterpreter.Container.ofString(string))
+        private val hashCode: Int by lazy {
+            Objects.hash(id, callId, code, fingerprint, type, additionalProperties)
+        }
 
-            /**
-             * Alias for calling [addCodeInterpreterTool] with
-             * `Tool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)`.
-             */
-            fun addCodeInterpreterTool(
-                codeInterpreterToolAuto: Tool.CodeInterpreter.Container.CodeInterpreterToolAuto
-            ) =
-                addCodeInterpreterTool(
-                    Tool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(
-                        codeInterpreterToolAuto
-                    )
-                )
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Program{id=$id, callId=$callId, code=$code, fingerprint=$fingerprint, type=$type, additionalProperties=$additionalProperties}"
+    }
+
+    class ProgramOutput
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val callId: JsonField<String>,
+        private val result: JsonField<String>,
+        private val status: JsonField<Status>,
+        private val type: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("call_id") @ExcludeMissing callId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("result") @ExcludeMissing result: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(id, callId, result, status, type, mutableMapOf())
+
+        /**
+         * The unique ID of the program output item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The call ID of the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun callId(): String = callId.getRequired("call_id")
+
+        /**
+         * The result produced by the program item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun result(): String = result.getRequired("result")
+
+        /**
+         * The terminal status of the program output item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun status(): Status = status.getRequired("status")
+
+        /**
+         * The type of the item. Always `program_output`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("program_output")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [callId].
+         *
+         * Unlike [callId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("call_id") @ExcludeMissing fun _callId(): JsonField<String> = callId
+
+        /**
+         * Returns the raw JSON value of [result].
+         *
+         * Unlike [result], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("result") @ExcludeMissing fun _result(): JsonField<String> = result
+
+        /**
+         * Returns the raw JSON value of [status].
+         *
+         * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [ProgramOutput].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .result()
+             * .status()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [ProgramOutput]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var callId: JsonField<String>? = null
+            private var result: JsonField<String>? = null
+            private var status: JsonField<Status>? = null
+            private var type: JsonValue = JsonValue.from("program_output")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(programOutput: ProgramOutput) = apply {
+                id = programOutput.id
+                callId = programOutput.callId
+                result = programOutput.result
+                status = programOutput.status
+                type = programOutput.type
+                additionalProperties = programOutput.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the program output item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The call ID of the program item. */
+            fun callId(callId: String) = callId(JsonField.of(callId))
+
+            /**
+             * Sets [Builder.callId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.callId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun callId(callId: JsonField<String>) = apply { this.callId = callId }
+
+            /** The result produced by the program item. */
+            fun result(result: String) = result(JsonField.of(result))
+
+            /**
+             * Sets [Builder.result] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.result] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun result(result: JsonField<String>) = apply { this.result = result }
+
+            /** The terminal status of the program output item. */
+            fun status(status: Status) = status(JsonField.of(status))
+
+            /**
+             * Sets [Builder.status] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.status] with a well-typed [Status] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun status(status: JsonField<Status>) = apply { this.status = status }
+
+            /**
+             * Sets the field to an arbitrary JSON value.
+             *
+             * It is usually unnecessary to call this method because the field defaults to the
+             * following:
+             * ```java
+             * JsonValue.from("program_output")
+             * ```
+             *
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun type(type: JsonValue) = apply { this.type = type }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [ProgramOutput].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .callId()
+             * .result()
+             * .status()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): ProgramOutput =
+                ProgramOutput(
+                    checkRequired("id", id),
+                    checkRequired("callId", callId),
+                    checkRequired("result", result),
+                    checkRequired("status", status),
+                    type,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): ProgramOutput = apply {
+            if (validated) {
+                return@apply
+            }
+
+            id()
+            callId()
+            result()
+            status().validate()
+            _type().let {
+                if (it != JsonValue.from("program_output")) {
+                    throw OpenAIInvalidDataException("'type' is invalid, received $it")
+                }
+            }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (id.asKnown().isPresent) 1 else 0) +
+                (if (callId.asKnown().isPresent) 1 else 0) +
+                (if (result.asKnown().isPresent) 1 else 0) +
+                (status.asKnown().getOrNull()?.validity() ?: 0) +
+                type.let { if (it == JsonValue.from("program_output")) 1 else 0 }
+
+        /** The terminal status of the program output item. */
+        class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val COMPLETED = of("completed")
+
+                @JvmField val INCOMPLETE = of("incomplete")
+
+                @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+            }
+
+            /** An enum containing [Status]'s known values. */
+            enum class Known {
+                COMPLETED,
+                INCOMPLETE,
+            }
+
+            /**
+             * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Status] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                COMPLETED,
+                INCOMPLETE,
+                /**
+                 * An enum member indicating that [Status] was instantiated with an unknown value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    COMPLETED -> Value.COMPLETED
+                    INCOMPLETE -> Value.INCOMPLETE
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    COMPLETED -> Known.COMPLETED
+                    INCOMPLETE -> Known.INCOMPLETE
+                    else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Status = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Status && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is ProgramOutput &&
+                id == other.id &&
+                callId == other.callId &&
+                result == other.result &&
+                status == other.status &&
+                type == other.type &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(id, callId, result, status, type, additionalProperties)
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "ProgramOutput{id=$id, callId=$callId, result=$result, status=$status, type=$type, additionalProperties=$additionalProperties}"
+    }
+
+    class AdditionalTools
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val id: JsonField<String>,
+        private val role: JsonField<Role>,
+        private val tools: JsonField<List<Tool>>,
+        private val type: JsonValue,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("role") @ExcludeMissing role: JsonField<Role> = JsonMissing.of(),
+            @JsonProperty("tools") @ExcludeMissing tools: JsonField<List<Tool>> = JsonMissing.of(),
+            @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        ) : this(id, role, tools, type, mutableMapOf())
+
+        /**
+         * The unique ID of the additional tools item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun id(): String = id.getRequired("id")
+
+        /**
+         * The role that provided the additional tools.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun role(): Role = role.getRequired("role")
+
+        /**
+         * The additional tool definitions made available at this item.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun tools(): List<Tool> = tools.getRequired("tools")
+
+        /**
+         * The type of the item. Always `additional_tools`.
+         *
+         * Expected to always return the following:
+         * ```java
+         * JsonValue.from("additional_tools")
+         * ```
+         *
+         * However, this method can be useful for debugging and logging (e.g. if the server
+         * responded with an unexpected value).
+         */
+        @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+        /**
+         * Returns the raw JSON value of [id].
+         *
+         * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+        /**
+         * Returns the raw JSON value of [role].
+         *
+         * Unlike [role], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("role") @ExcludeMissing fun _role(): JsonField<Role> = role
+
+        /**
+         * Returns the raw JSON value of [tools].
+         *
+         * Unlike [tools], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("tools") @ExcludeMissing fun _tools(): JsonField<List<Tool>> = tools
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [AdditionalTools].
+             *
+             * The following fields are required:
+             * ```java
+             * .id()
+             * .role()
+             * .tools()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [AdditionalTools]. */
+        class Builder internal constructor() {
+
+            private var id: JsonField<String>? = null
+            private var role: JsonField<Role>? = null
+            private var tools: JsonField<MutableList<Tool>>? = null
+            private var type: JsonValue = JsonValue.from("additional_tools")
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(additionalTools: AdditionalTools) = apply {
+                id = additionalTools.id
+                role = additionalTools.role
+                tools = additionalTools.tools.map { it.toMutableList() }
+                type = additionalTools.type
+                additionalProperties = additionalTools.additionalProperties.toMutableMap()
+            }
+
+            /** The unique ID of the additional tools item. */
+            fun id(id: String) = id(JsonField.of(id))
+
+            /**
+             * Sets [Builder.id] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.id] with a well-typed [String] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun id(id: JsonField<String>) = apply { this.id = id }
+
+            /** The role that provided the additional tools. */
+            fun role(role: Role) = role(JsonField.of(role))
+
+            /**
+             * Sets [Builder.role] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.role] with a well-typed [Role] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun role(role: JsonField<Role>) = apply { this.role = role }
+
+            /** The additional tool definitions made available at this item. */
+            fun tools(tools: List<Tool>) = tools(JsonField.of(tools))
+
+            /**
+             * Sets [Builder.tools] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.tools] with a well-typed `List<Tool>` value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun tools(tools: JsonField<List<Tool>>) = apply {
+                this.tools = tools.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [Tool] to [tools].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addTool(tool: Tool) = apply {
+                tools =
+                    (tools ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("tools", it).add(tool)
+                    }
+            }
+
+            /** Alias for calling [addTool] with `Tool.ofFunction(function)`. */
+            fun addTool(function: FunctionTool) = addTool(Tool.ofFunction(function))
+
+            /** Alias for calling [addTool] with `Tool.ofFileSearch(fileSearch)`. */
+            fun addTool(fileSearch: FileSearchTool) = addTool(Tool.ofFileSearch(fileSearch))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * FileSearchTool.builder()
+             *     .vectorStoreIds(vectorStoreIds)
+             *     .build()
+             * ```
+             */
+            fun addFileSearchTool(vectorStoreIds: List<String>) =
+                addTool(FileSearchTool.builder().vectorStoreIds(vectorStoreIds).build())
+
+            /** Alias for calling [addTool] with `Tool.ofComputer(computer)`. */
+            fun addTool(computer: ComputerTool) = addTool(Tool.ofComputer(computer))
+
+            /** Alias for calling [addTool] with `Tool.ofComputerUsePreview(computerUsePreview)`. */
+            fun addTool(computerUsePreview: ComputerUsePreviewTool) =
+                addTool(Tool.ofComputerUsePreview(computerUsePreview))
+
+            /** Alias for calling [addTool] with `Tool.ofWebSearch(webSearch)`. */
+            fun addTool(webSearch: WebSearchTool) = addTool(Tool.ofWebSearch(webSearch))
+
+            /** Alias for calling [addTool] with `Tool.ofMcp(mcp)`. */
+            fun addTool(mcp: Tool.Mcp) = addTool(Tool.ofMcp(mcp))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * Tool.Mcp.builder()
+             *     .serverLabel(serverLabel)
+             *     .build()
+             * ```
+             */
+            fun addMcpTool(serverLabel: String) =
+                addTool(Tool.Mcp.builder().serverLabel(serverLabel).build())
+
+            /** Alias for calling [addTool] with `Tool.ofCodeInterpreter(codeInterpreter)`. */
+            fun addTool(codeInterpreter: Tool.CodeInterpreter) =
+                addTool(Tool.ofCodeInterpreter(codeInterpreter))
+
+            /**
+             * Alias for calling [addTool] with the following:
+             * ```java
+             * Tool.CodeInterpreter.builder()
+             *     .container(container)
+             *     .build()
+             * ```
+             */
+            fun addCodeInterpreterTool(container: Tool.CodeInterpreter.Container) =
+                addTool(Tool.CodeInterpreter.builder().container(container).build())
+
+            /**
+             * Alias for calling [addCodeInterpreterTool] with
+             * `Tool.CodeInterpreter.Container.ofString(string)`.
+             */
+            fun addCodeInterpreterTool(string: String) =
+                addCodeInterpreterTool(Tool.CodeInterpreter.Container.ofString(string))
+
+            /**
+             * Alias for calling [addCodeInterpreterTool] with
+             * `Tool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)`.
+             */
+            fun addCodeInterpreterTool(
+                codeInterpreterToolAuto: Tool.CodeInterpreter.Container.CodeInterpreterToolAuto
+            ) =
+                addCodeInterpreterTool(
+                    Tool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(
+                        codeInterpreterToolAuto
+                    )
+                )
+
+            /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+            fun addToolProgrammaticToolCalling() = addTool(Tool.ofProgrammaticToolCalling())
 
             /** Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`. */
             fun addTool(imageGeneration: Tool.ImageGeneration) =
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseOutputItemAddedEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseOutputItemAddedEvent.kt
index 27fb22bc9..de58f6986 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseOutputItemAddedEvent.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseOutputItemAddedEvent.kt
@@ -194,6 +194,13 @@ private constructor(
         /** Alias for calling [item] with `ResponseOutputItem.ofReasoning(reasoning)`. */
         fun item(reasoning: ResponseReasoningItem) = item(ResponseOutputItem.ofReasoning(reasoning))
 
+        /** Alias for calling [item] with `ResponseOutputItem.ofProgram(program)`. */
+        fun item(program: ResponseOutputItem.Program) = item(ResponseOutputItem.ofProgram(program))
+
+        /** Alias for calling [item] with `ResponseOutputItem.ofProgramOutput(programOutput)`. */
+        fun item(programOutput: ResponseOutputItem.ProgramOutput) =
+            item(ResponseOutputItem.ofProgramOutput(programOutput))
+
         /** Alias for calling [item] with `ResponseOutputItem.ofToolSearchCall(toolSearchCall)`. */
         fun item(toolSearchCall: ResponseToolSearchCall) =
             item(ResponseOutputItem.ofToolSearchCall(toolSearchCall))
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseOutputItemDoneEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseOutputItemDoneEvent.kt
index af5837884..d6f4a72a6 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseOutputItemDoneEvent.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseOutputItemDoneEvent.kt
@@ -194,6 +194,13 @@ private constructor(
         /** Alias for calling [item] with `ResponseOutputItem.ofReasoning(reasoning)`. */
         fun item(reasoning: ResponseReasoningItem) = item(ResponseOutputItem.ofReasoning(reasoning))
 
+        /** Alias for calling [item] with `ResponseOutputItem.ofProgram(program)`. */
+        fun item(program: ResponseOutputItem.Program) = item(ResponseOutputItem.ofProgram(program))
+
+        /** Alias for calling [item] with `ResponseOutputItem.ofProgramOutput(programOutput)`. */
+        fun item(programOutput: ResponseOutputItem.ProgramOutput) =
+            item(ResponseOutputItem.ofProgramOutput(programOutput))
+
         /** Alias for calling [item] with `ResponseOutputItem.ofToolSearchCall(toolSearchCall)`. */
         fun item(toolSearchCall: ResponseToolSearchCall) =
             item(ResponseOutputItem.ofToolSearchCall(toolSearchCall))
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseReasoningSummaryPartDoneEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseReasoningSummaryPartDoneEvent.kt
index f211d5da3..3f7a342b1 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseReasoningSummaryPartDoneEvent.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseReasoningSummaryPartDoneEvent.kt
@@ -6,6 +6,7 @@ import com.fasterxml.jackson.annotation.JsonAnyGetter
 import com.fasterxml.jackson.annotation.JsonAnySetter
 import com.fasterxml.jackson.annotation.JsonCreator
 import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
 import com.openai.core.ExcludeMissing
 import com.openai.core.JsonField
 import com.openai.core.JsonMissing
@@ -14,6 +15,7 @@ import com.openai.core.checkRequired
 import com.openai.errors.OpenAIInvalidDataException
 import java.util.Collections
 import java.util.Objects
+import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
 /** Emitted when a reasoning summary part is completed. */
@@ -26,6 +28,7 @@ private constructor(
     private val sequenceNumber: JsonField<Long>,
     private val summaryIndex: JsonField<Long>,
     private val type: JsonValue,
+    private val status: JsonField<Status>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
@@ -43,7 +46,8 @@ private constructor(
         @ExcludeMissing
         summaryIndex: JsonField<Long> = JsonMissing.of(),
         @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-    ) : this(itemId, outputIndex, part, sequenceNumber, summaryIndex, type, mutableMapOf())
+        @JsonProperty("status") @ExcludeMissing status: JsonField<Status> = JsonMissing.of(),
+    ) : this(itemId, outputIndex, part, sequenceNumber, summaryIndex, type, status, mutableMapOf())
 
     /**
      * The ID of the item this summary part is associated with.
@@ -98,6 +102,15 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * The completion status of the summary part. Omitted when the part completed normally and set
+     * to `incomplete` when generation was interrupted.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun status(): Optional<Status> = status.getOptional("status")
+
     /**
      * Returns the raw JSON value of [itemId].
      *
@@ -137,6 +150,13 @@ private constructor(
     @ExcludeMissing
     fun _summaryIndex(): JsonField<Long> = summaryIndex
 
+    /**
+     * Returns the raw JSON value of [status].
+     *
+     * Unlike [status], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("status") @ExcludeMissing fun _status(): JsonField<Status> = status
+
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
         additionalProperties.put(key, value)
@@ -176,6 +196,7 @@ private constructor(
         private var sequenceNumber: JsonField<Long>? = null
         private var summaryIndex: JsonField<Long>? = null
         private var type: JsonValue = JsonValue.from("response.reasoning_summary_part.done")
+        private var status: JsonField<Status> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -188,6 +209,7 @@ private constructor(
             sequenceNumber = responseReasoningSummaryPartDoneEvent.sequenceNumber
             summaryIndex = responseReasoningSummaryPartDoneEvent.summaryIndex
             type = responseReasoningSummaryPartDoneEvent.type
+            status = responseReasoningSummaryPartDoneEvent.status
             additionalProperties =
                 responseReasoningSummaryPartDoneEvent.additionalProperties.toMutableMap()
         }
@@ -266,6 +288,20 @@ private constructor(
          */
         fun type(type: JsonValue) = apply { this.type = type }
 
+        /**
+         * The completion status of the summary part. Omitted when the part completed normally and
+         * set to `incomplete` when generation was interrupted.
+         */
+        fun status(status: Status) = status(JsonField.of(status))
+
+        /**
+         * Sets [Builder.status] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.status] with a well-typed [Status] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun status(status: JsonField<Status>) = apply { this.status = status }
+
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -309,6 +345,7 @@ private constructor(
                 checkRequired("sequenceNumber", sequenceNumber),
                 checkRequired("summaryIndex", summaryIndex),
                 type,
+                status,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -338,6 +375,7 @@ private constructor(
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        status().ifPresent { it.validate() }
         validated = true
     }
 
@@ -361,7 +399,10 @@ private constructor(
             (part.asKnown().getOrNull()?.validity() ?: 0) +
             (if (sequenceNumber.asKnown().isPresent) 1 else 0) +
             (if (summaryIndex.asKnown().isPresent) 1 else 0) +
-            type.let { if (it == JsonValue.from("response.reasoning_summary_part.done")) 1 else 0 }
+            type.let {
+                if (it == JsonValue.from("response.reasoning_summary_part.done")) 1 else 0
+            } +
+            (status.asKnown().getOrNull()?.validity() ?: 0)
 
     /** The completed summary part. */
     class Part
@@ -569,6 +610,138 @@ private constructor(
             "Part{text=$text, type=$type, additionalProperties=$additionalProperties}"
     }
 
+    /**
+     * The completion status of the summary part. Omitted when the part completed normally and set
+     * to `incomplete` when generation was interrupted.
+     */
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val INCOMPLETE = of("incomplete")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            INCOMPLETE
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            INCOMPLETE,
+            /** An enum member indicating that [Status] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                INCOMPLETE -> Value.INCOMPLETE
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                INCOMPLETE -> Known.INCOMPLETE
+                else -> throw OpenAIInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
@@ -581,6 +754,7 @@ private constructor(
             sequenceNumber == other.sequenceNumber &&
             summaryIndex == other.summaryIndex &&
             type == other.type &&
+            status == other.status &&
             additionalProperties == other.additionalProperties
     }
 
@@ -592,6 +766,7 @@ private constructor(
             sequenceNumber,
             summaryIndex,
             type,
+            status,
             additionalProperties,
         )
     }
@@ -599,5 +774,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponseReasoningSummaryPartDoneEvent{itemId=$itemId, outputIndex=$outputIndex, part=$part, sequenceNumber=$sequenceNumber, summaryIndex=$summaryIndex, type=$type, additionalProperties=$additionalProperties}"
+        "ResponseReasoningSummaryPartDoneEvent{itemId=$itemId, outputIndex=$outputIndex, part=$part, sequenceNumber=$sequenceNumber, summaryIndex=$summaryIndex, type=$type, status=$status, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseToolSearchOutputItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseToolSearchOutputItem.kt
index 6f11e6838..09cc927f1 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseToolSearchOutputItem.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseToolSearchOutputItem.kt
@@ -348,6 +348,9 @@ private constructor(
                 Tool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)
             )
 
+        /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+        fun addToolProgrammaticToolCalling() = addTool(Tool.ofProgrammaticToolCalling())
+
         /** Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`. */
         fun addTool(imageGeneration: Tool.ImageGeneration) =
             addTool(Tool.ofImageGeneration(imageGeneration))
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseToolSearchOutputItemParam.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseToolSearchOutputItemParam.kt
index 72274cbf1..134bf468d 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseToolSearchOutputItemParam.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseToolSearchOutputItemParam.kt
@@ -280,6 +280,9 @@ private constructor(
                 Tool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)
             )
 
+        /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+        fun addToolProgrammaticToolCalling() = addTool(Tool.ofProgrammaticToolCalling())
+
         /** Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`. */
         fun addTool(imageGeneration: Tool.ImageGeneration) =
             addTool(Tool.ofImageGeneration(imageGeneration))
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseUsage.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseUsage.kt
index f7179b732..3913d74a5 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseUsage.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseUsage.kt
@@ -351,16 +351,28 @@ private constructor(
     class InputTokensDetails
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
+        private val cacheWriteTokens: JsonField<Long>,
         private val cachedTokens: JsonField<Long>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
         @JsonCreator
         private constructor(
+            @JsonProperty("cache_write_tokens")
+            @ExcludeMissing
+            cacheWriteTokens: JsonField<Long> = JsonMissing.of(),
             @JsonProperty("cached_tokens")
             @ExcludeMissing
-            cachedTokens: JsonField<Long> = JsonMissing.of()
-        ) : this(cachedTokens, mutableMapOf())
+            cachedTokens: JsonField<Long> = JsonMissing.of(),
+        ) : this(cacheWriteTokens, cachedTokens, mutableMapOf())
+
+        /**
+         * The number of input tokens that were written to the cache.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun cacheWriteTokens(): Long = cacheWriteTokens.getRequired("cache_write_tokens")
 
         /**
          * The number of tokens that were retrieved from the cache.
@@ -371,6 +383,16 @@ private constructor(
          */
         fun cachedTokens(): Long = cachedTokens.getRequired("cached_tokens")
 
+        /**
+         * Returns the raw JSON value of [cacheWriteTokens].
+         *
+         * Unlike [cacheWriteTokens], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("cache_write_tokens")
+        @ExcludeMissing
+        fun _cacheWriteTokens(): JsonField<Long> = cacheWriteTokens
+
         /**
          * Returns the raw JSON value of [cachedTokens].
          *
@@ -400,6 +422,7 @@ private constructor(
              *
              * The following fields are required:
              * ```java
+             * .cacheWriteTokens()
              * .cachedTokens()
              * ```
              */
@@ -409,15 +432,32 @@ private constructor(
         /** A builder for [InputTokensDetails]. */
         class Builder internal constructor() {
 
+            private var cacheWriteTokens: JsonField<Long>? = null
             private var cachedTokens: JsonField<Long>? = null
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
             internal fun from(inputTokensDetails: InputTokensDetails) = apply {
+                cacheWriteTokens = inputTokensDetails.cacheWriteTokens
                 cachedTokens = inputTokensDetails.cachedTokens
                 additionalProperties = inputTokensDetails.additionalProperties.toMutableMap()
             }
 
+            /** The number of input tokens that were written to the cache. */
+            fun cacheWriteTokens(cacheWriteTokens: Long) =
+                cacheWriteTokens(JsonField.of(cacheWriteTokens))
+
+            /**
+             * Sets [Builder.cacheWriteTokens] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.cacheWriteTokens] with a well-typed [Long] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun cacheWriteTokens(cacheWriteTokens: JsonField<Long>) = apply {
+                this.cacheWriteTokens = cacheWriteTokens
+            }
+
             /**
              * The number of tokens that were retrieved from the cache.
              * [More on prompt caching](https://platform.openai.com/docs/guides/prompt-caching).
@@ -461,6 +501,7 @@ private constructor(
              *
              * The following fields are required:
              * ```java
+             * .cacheWriteTokens()
              * .cachedTokens()
              * ```
              *
@@ -468,6 +509,7 @@ private constructor(
              */
             fun build(): InputTokensDetails =
                 InputTokensDetails(
+                    checkRequired("cacheWriteTokens", cacheWriteTokens),
                     checkRequired("cachedTokens", cachedTokens),
                     additionalProperties.toMutableMap(),
                 )
@@ -489,6 +531,7 @@ private constructor(
                 return@apply
             }
 
+            cacheWriteTokens()
             cachedTokens()
             validated = true
         }
@@ -508,7 +551,9 @@ private constructor(
          * Used for best match union deserialization.
          */
         @JvmSynthetic
-        internal fun validity(): Int = (if (cachedTokens.asKnown().isPresent) 1 else 0)
+        internal fun validity(): Int =
+            (if (cacheWriteTokens.asKnown().isPresent) 1 else 0) +
+                (if (cachedTokens.asKnown().isPresent) 1 else 0)
 
         override fun equals(other: Any?): Boolean {
             if (this === other) {
@@ -516,16 +561,19 @@ private constructor(
             }
 
             return other is InputTokensDetails &&
+                cacheWriteTokens == other.cacheWriteTokens &&
                 cachedTokens == other.cachedTokens &&
                 additionalProperties == other.additionalProperties
         }
 
-        private val hashCode: Int by lazy { Objects.hash(cachedTokens, additionalProperties) }
+        private val hashCode: Int by lazy {
+            Objects.hash(cacheWriteTokens, cachedTokens, additionalProperties)
+        }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "InputTokensDetails{cachedTokens=$cachedTokens, additionalProperties=$additionalProperties}"
+            "InputTokensDetails{cacheWriteTokens=$cacheWriteTokens, cachedTokens=$cachedTokens, additionalProperties=$additionalProperties}"
     }
 
     /** A detailed breakdown of the output tokens. */
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponsesClientEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponsesClientEvent.kt
index ca991f7a1..eb6ac35be 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponsesClientEvent.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/ResponsesClientEvent.kt
@@ -53,6 +53,7 @@ private constructor(
     private val previousResponseId: JsonField<String>,
     private val prompt: JsonField<ResponsePrompt>,
     private val promptCacheKey: JsonField<String>,
+    private val promptCacheOptions: JsonField<PromptCacheOptions>,
     private val promptCacheRetention: JsonField<PromptCacheRetention>,
     private val reasoning: JsonField<Reasoning>,
     private val safetyIdentifier: JsonField<String>,
@@ -113,6 +114,9 @@ private constructor(
         @JsonProperty("prompt_cache_key")
         @ExcludeMissing
         promptCacheKey: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("prompt_cache_options")
+        @ExcludeMissing
+        promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of(),
         @JsonProperty("prompt_cache_retention")
         @ExcludeMissing
         promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of(),
@@ -165,6 +169,7 @@ private constructor(
         previousResponseId,
         prompt,
         promptCacheKey,
+        promptCacheOptions,
         promptCacheRetention,
         reasoning,
         safetyIdentifier,
@@ -364,10 +369,30 @@ private constructor(
     fun promptCacheKey(): Optional<String> = promptCacheKey.getOptional("prompt_cache_key")
 
     /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+     * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+     * content blocks with `prompt_cache_breakpoint`. Each request can write up to four breakpoints.
+     * For cache matching, OpenAI considers up to the latest 80 breakpoints in the conversation,
+     * without a content-block lookback limit. Set `mode` to `explicit` to disable the implicit
+     * breakpoint. The `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for current
+     * details.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun promptCacheOptions(): Optional<PromptCacheOptions> =
+        promptCacheOptions.getOptional("prompt_cache_options")
+
+    /**
+     * Deprecated. Use `prompt_cache_options.ttl` instead.
+     *
      * The retention policy for the prompt cache. Set to `24h` to enable extended prompt caching,
      * which keeps cached prefixes active for longer, up to a maximum of 24 hours.
      * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
-     * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+     * This field expresses a maximum retention policy, while `prompt_cache_options.ttl` expresses a
+     * minimum cache lifetime. The two fields are independent and do not interact. For `gpt-5.5`,
+     * `gpt-5.5-pro`, and future models, only `24h` is supported.
      *
      * For older models that support both `in_memory` and `24h`, the default depends on your
      * organization's data retention policy:
@@ -378,6 +403,7 @@ private constructor(
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
+    @Deprecated("deprecated")
     fun promptCacheRetention(): Optional<PromptCacheRetention> =
         promptCacheRetention.getOptional("prompt_cache_retention")
 
@@ -681,12 +707,23 @@ private constructor(
     @ExcludeMissing
     fun _promptCacheKey(): JsonField<String> = promptCacheKey
 
+    /**
+     * Returns the raw JSON value of [promptCacheOptions].
+     *
+     * Unlike [promptCacheOptions], this method doesn't throw if the JSON field has an unexpected
+     * type.
+     */
+    @JsonProperty("prompt_cache_options")
+    @ExcludeMissing
+    fun _promptCacheOptions(): JsonField<PromptCacheOptions> = promptCacheOptions
+
     /**
      * Returns the raw JSON value of [promptCacheRetention].
      *
      * Unlike [promptCacheRetention], this method doesn't throw if the JSON field has an unexpected
      * type.
      */
+    @Deprecated("deprecated")
     @JsonProperty("prompt_cache_retention")
     @ExcludeMissing
     fun _promptCacheRetention(): JsonField<PromptCacheRetention> = promptCacheRetention
@@ -841,6 +878,7 @@ private constructor(
         private var previousResponseId: JsonField<String> = JsonMissing.of()
         private var prompt: JsonField<ResponsePrompt> = JsonMissing.of()
         private var promptCacheKey: JsonField<String> = JsonMissing.of()
+        private var promptCacheOptions: JsonField<PromptCacheOptions> = JsonMissing.of()
         private var promptCacheRetention: JsonField<PromptCacheRetention> = JsonMissing.of()
         private var reasoning: JsonField<Reasoning> = JsonMissing.of()
         private var safetyIdentifier: JsonField<String> = JsonMissing.of()
@@ -876,6 +914,7 @@ private constructor(
             previousResponseId = responsesClientEvent.previousResponseId
             prompt = responsesClientEvent.prompt
             promptCacheKey = responsesClientEvent.promptCacheKey
+            promptCacheOptions = responsesClientEvent.promptCacheOptions
             promptCacheRetention = responsesClientEvent.promptCacheRetention
             reasoning = responsesClientEvent.reasoning
             safetyIdentifier = responsesClientEvent.safetyIdentifier
@@ -1300,9 +1339,38 @@ private constructor(
         }
 
         /**
+         * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+         * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+         * content blocks with `prompt_cache_breakpoint`. Each request can write up to four
+         * breakpoints. For cache matching, OpenAI considers up to the latest 80 breakpoints in the
+         * conversation, without a content-block lookback limit. Set `mode` to `explicit` to disable
+         * the implicit breakpoint. The `ttl` defaults to `30m`, which is currently the only
+         * supported value. See the
+         * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for
+         * current details.
+         */
+        fun promptCacheOptions(promptCacheOptions: PromptCacheOptions) =
+            promptCacheOptions(JsonField.of(promptCacheOptions))
+
+        /**
+         * Sets [Builder.promptCacheOptions] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.promptCacheOptions] with a well-typed
+         * [PromptCacheOptions] value instead. This method is primarily for setting the field to an
+         * undocumented or not yet supported value.
+         */
+        fun promptCacheOptions(promptCacheOptions: JsonField<PromptCacheOptions>) = apply {
+            this.promptCacheOptions = promptCacheOptions
+        }
+
+        /**
+         * Deprecated. Use `prompt_cache_options.ttl` instead.
+         *
          * The retention policy for the prompt cache. Set to `24h` to enable extended prompt
          * caching, which keeps cached prefixes active for longer, up to a maximum of 24 hours.
          * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+         * This field expresses a maximum retention policy, while `prompt_cache_options.ttl`
+         * expresses a minimum cache lifetime. The two fields are independent and do not interact.
          * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
          *
          * For older models that support both `in_memory` and `24h`, the default depends on your
@@ -1311,6 +1379,7 @@ private constructor(
          * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is
          *   not specified.
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(promptCacheRetention: PromptCacheRetention?) =
             promptCacheRetention(JsonField.ofNullable(promptCacheRetention))
 
@@ -1318,6 +1387,7 @@ private constructor(
          * Alias for calling [Builder.promptCacheRetention] with
          * `promptCacheRetention.orElse(null)`.
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(promptCacheRetention: Optional<PromptCacheRetention>) =
             promptCacheRetention(promptCacheRetention.getOrNull())
 
@@ -1328,6 +1398,7 @@ private constructor(
          * [PromptCacheRetention] value instead. This method is primarily for setting the field to
          * an undocumented or not yet supported value.
          */
+        @Deprecated("deprecated")
         fun promptCacheRetention(promptCacheRetention: JsonField<PromptCacheRetention>) = apply {
             this.promptCacheRetention = promptCacheRetention
         }
@@ -1548,6 +1619,13 @@ private constructor(
         /** Alias for calling [toolChoice] with `ToolChoice.ofCustom(custom)`. */
         fun toolChoice(custom: ToolChoiceCustom) = toolChoice(ToolChoice.ofCustom(custom))
 
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofSpecificProgrammaticToolCallingParam()`.
+         */
+        fun toolChoiceSpecificProgrammaticToolCallingParam() =
+            toolChoice(ToolChoice.ofSpecificProgrammaticToolCallingParam())
+
         /** Alias for calling [toolChoice] with `ToolChoice.ofApplyPatch(applyPatch)`. */
         fun toolChoice(applyPatch: ToolChoiceApplyPatch) =
             toolChoice(ToolChoice.ofApplyPatch(applyPatch))
@@ -1670,6 +1748,9 @@ private constructor(
                 Tool.CodeInterpreter.Container.ofCodeInterpreterToolAuto(codeInterpreterToolAuto)
             )
 
+        /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+        fun addToolProgrammaticToolCalling() = addTool(Tool.ofProgrammaticToolCalling())
+
         /** Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`. */
         fun addTool(imageGeneration: Tool.ImageGeneration) =
             addTool(Tool.ofImageGeneration(imageGeneration))
@@ -1843,6 +1924,7 @@ private constructor(
                 previousResponseId,
                 prompt,
                 promptCacheKey,
+                promptCacheOptions,
                 promptCacheRetention,
                 reasoning,
                 safetyIdentifier,
@@ -1897,6 +1979,7 @@ private constructor(
         previousResponseId()
         prompt().ifPresent { it.validate() }
         promptCacheKey()
+        promptCacheOptions().ifPresent { it.validate() }
         promptCacheRetention().ifPresent { it.validate() }
         reasoning().ifPresent { it.validate() }
         safetyIdentifier()
@@ -1946,6 +2029,7 @@ private constructor(
             (if (previousResponseId.asKnown().isPresent) 1 else 0) +
             (prompt.asKnown().getOrNull()?.validity() ?: 0) +
             (if (promptCacheKey.asKnown().isPresent) 1 else 0) +
+            (promptCacheOptions.asKnown().getOrNull()?.validity() ?: 0) +
             (promptCacheRetention.asKnown().getOrNull()?.validity() ?: 0) +
             (reasoning.asKnown().getOrNull()?.validity() ?: 0) +
             (if (safetyIdentifier.asKnown().isPresent) 1 else 0) +
@@ -2782,13 +2866,15 @@ private constructor(
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
         private val model: JsonField<String>,
+        private val policy: JsonField<Policy>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
         @JsonCreator
         private constructor(
-            @JsonProperty("model") @ExcludeMissing model: JsonField<String> = JsonMissing.of()
-        ) : this(model, mutableMapOf())
+            @JsonProperty("model") @ExcludeMissing model: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("policy") @ExcludeMissing policy: JsonField<Policy> = JsonMissing.of(),
+        ) : this(model, policy, mutableMapOf())
 
         /**
          * The moderation model to use for moderated completions, e.g. 'omni-moderation-latest'.
@@ -2798,6 +2884,14 @@ private constructor(
          */
         fun model(): String = model.getRequired("model")
 
+        /**
+         * The policy to apply to moderated response input and output.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun policy(): Optional<Policy> = policy.getOptional("policy")
+
         /**
          * Returns the raw JSON value of [model].
          *
@@ -2805,6 +2899,13 @@ private constructor(
          */
         @JsonProperty("model") @ExcludeMissing fun _model(): JsonField<String> = model
 
+        /**
+         * Returns the raw JSON value of [policy].
+         *
+         * Unlike [policy], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("policy") @ExcludeMissing fun _policy(): JsonField<Policy> = policy
+
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
             additionalProperties.put(key, value)
@@ -2834,11 +2935,13 @@ private constructor(
         class Builder internal constructor() {
 
             private var model: JsonField<String>? = null
+            private var policy: JsonField<Policy> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
             internal fun from(moderation: Moderation) = apply {
                 model = moderation.model
+                policy = moderation.policy
                 additionalProperties = moderation.additionalProperties.toMutableMap()
             }
 
@@ -2856,6 +2959,21 @@ private constructor(
              */
             fun model(model: JsonField<String>) = apply { this.model = model }
 
+            /** The policy to apply to moderated response input and output. */
+            fun policy(policy: Policy?) = policy(JsonField.ofNullable(policy))
+
+            /** Alias for calling [Builder.policy] with `policy.orElse(null)`. */
+            fun policy(policy: Optional<Policy>) = policy(policy.getOrNull())
+
+            /**
+             * Sets [Builder.policy] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.policy] with a well-typed [Policy] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun policy(policy: JsonField<Policy>) = apply { this.policy = policy }
+
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
                 putAllAdditionalProperties(additionalProperties)
@@ -2888,7 +3006,11 @@ private constructor(
              * @throws IllegalStateException if any required field is unset.
              */
             fun build(): Moderation =
-                Moderation(checkRequired("model", model), additionalProperties.toMutableMap())
+                Moderation(
+                    checkRequired("model", model),
+                    policy,
+                    additionalProperties.toMutableMap(),
+                )
         }
 
         private var validated: Boolean = false
@@ -2908,6 +3030,7 @@ private constructor(
             }
 
             model()
+            policy().ifPresent { it.validate() }
             validated = true
         }
 
@@ -2925,199 +3048,1525 @@ private constructor(
          *
          * Used for best match union deserialization.
          */
-        @JvmSynthetic internal fun validity(): Int = (if (model.asKnown().isPresent) 1 else 0)
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (model.asKnown().isPresent) 1 else 0) +
+                (policy.asKnown().getOrNull()?.validity() ?: 0)
 
-        override fun equals(other: Any?): Boolean {
-            if (this === other) {
-                return true
+        /** The policy to apply to moderated response input and output. */
+        class Policy
+        @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+        private constructor(
+            private val input: JsonField<Input>,
+            private val output: JsonField<Output>,
+            private val additionalProperties: MutableMap<String, JsonValue>,
+        ) {
+
+            @JsonCreator
+            private constructor(
+                @JsonProperty("input") @ExcludeMissing input: JsonField<Input> = JsonMissing.of(),
+                @JsonProperty("output") @ExcludeMissing output: JsonField<Output> = JsonMissing.of(),
+            ) : this(input, output, mutableMapOf())
+
+            /**
+             * The moderation policy for the response input.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun input(): Optional<Input> = input.getOptional("input")
+
+            /**
+             * The moderation policy for the response output.
+             *
+             * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if
+             *   the server responded with an unexpected value).
+             */
+            fun output(): Optional<Output> = output.getOptional("output")
+
+            /**
+             * Returns the raw JSON value of [input].
+             *
+             * Unlike [input], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("input") @ExcludeMissing fun _input(): JsonField<Input> = input
+
+            /**
+             * Returns the raw JSON value of [output].
+             *
+             * Unlike [output], this method doesn't throw if the JSON field has an unexpected type.
+             */
+            @JsonProperty("output") @ExcludeMissing fun _output(): JsonField<Output> = output
+
+            @JsonAnySetter
+            private fun putAdditionalProperty(key: String, value: JsonValue) {
+                additionalProperties.put(key, value)
             }
 
-            return other is Moderation &&
-                model == other.model &&
-                additionalProperties == other.additionalProperties
-        }
+            @JsonAnyGetter
+            @ExcludeMissing
+            fun _additionalProperties(): Map<String, JsonValue> =
+                Collections.unmodifiableMap(additionalProperties)
 
-        private val hashCode: Int by lazy { Objects.hash(model, additionalProperties) }
+            fun toBuilder() = Builder().from(this)
 
-        override fun hashCode(): Int = hashCode
+            companion object {
 
-        override fun toString() =
-            "Moderation{model=$model, additionalProperties=$additionalProperties}"
-    }
+                /** Returns a mutable builder for constructing an instance of [Policy]. */
+                @JvmStatic fun builder() = Builder()
+            }
 
-    /**
-     * The retention policy for the prompt cache. Set to `24h` to enable extended prompt caching,
-     * which keeps cached prefixes active for longer, up to a maximum of 24 hours.
-     * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
-     * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
-     *
-     * For older models that support both `in_memory` and `24h`, the default depends on your
-     * organization's data retention policy:
-     * - Organizations without ZDR enabled default to `24h`.
-     * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is not
-     *   specified.
-     */
-    class PromptCacheRetention
-    @JsonCreator
-    private constructor(private val value: JsonField<String>) : Enum {
+            /** A builder for [Policy]. */
+            class Builder internal constructor() {
 
-        /**
-         * Returns this class instance's raw value.
-         *
-         * This is usually only useful if this instance was deserialized from data that doesn't
-         * match any known member, and you want to know that value. For example, if the SDK is on an
-         * older version than the API, then the API may respond with new members that the SDK is
-         * unaware of.
-         */
-        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+                private var input: JsonField<Input> = JsonMissing.of()
+                private var output: JsonField<Output> = JsonMissing.of()
+                private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
-        companion object {
+                @JvmSynthetic
+                internal fun from(policy: Policy) = apply {
+                    input = policy.input
+                    output = policy.output
+                    additionalProperties = policy.additionalProperties.toMutableMap()
+                }
 
-            @JvmField val IN_MEMORY = of("in_memory")
+                /** The moderation policy for the response input. */
+                fun input(input: Input?) = input(JsonField.ofNullable(input))
+
+                /** Alias for calling [Builder.input] with `input.orElse(null)`. */
+                fun input(input: Optional<Input>) = input(input.getOrNull())
+
+                /**
+                 * Sets [Builder.input] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.input] with a well-typed [Input] value instead.
+                 * This method is primarily for setting the field to an undocumented or not yet
+                 * supported value.
+                 */
+                fun input(input: JsonField<Input>) = apply { this.input = input }
+
+                /** The moderation policy for the response output. */
+                fun output(output: Output?) = output(JsonField.ofNullable(output))
+
+                /** Alias for calling [Builder.output] with `output.orElse(null)`. */
+                fun output(output: Optional<Output>) = output(output.getOrNull())
+
+                /**
+                 * Sets [Builder.output] to an arbitrary JSON value.
+                 *
+                 * You should usually call [Builder.output] with a well-typed [Output] value
+                 * instead. This method is primarily for setting the field to an undocumented or not
+                 * yet supported value.
+                 */
+                fun output(output: JsonField<Output>) = apply { this.output = output }
+
+                fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                    this.additionalProperties.clear()
+                    putAllAdditionalProperties(additionalProperties)
+                }
 
-            @JvmField val _24H = of("24h")
+                fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                    additionalProperties.put(key, value)
+                }
 
-            @JvmStatic fun of(value: String) = PromptCacheRetention(JsonField.of(value))
-        }
+                fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                    apply {
+                        this.additionalProperties.putAll(additionalProperties)
+                    }
 
-        /** An enum containing [PromptCacheRetention]'s known values. */
-        enum class Known {
-            IN_MEMORY,
-            _24H,
-        }
+                fun removeAdditionalProperty(key: String) = apply {
+                    additionalProperties.remove(key)
+                }
+
+                fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                    keys.forEach(::removeAdditionalProperty)
+                }
+
+                /**
+                 * Returns an immutable instance of [Policy].
+                 *
+                 * Further updates to this [Builder] will not mutate the returned instance.
+                 */
+                fun build(): Policy = Policy(input, output, additionalProperties.toMutableMap())
+            }
+
+            private var validated: Boolean = false
 
-        /**
-         * An enum containing [PromptCacheRetention]'s known values, as well as an [_UNKNOWN]
-         * member.
-         *
-         * An instance of [PromptCacheRetention] can contain an unknown value in a couple of cases:
-         * - It was deserialized from data that doesn't match any known member. For example, if the
-         *   SDK is on an older version than the API, then the API may respond with new members that
-         *   the SDK is unaware of.
-         * - It was constructed with an arbitrary value using the [of] method.
-         */
-        enum class Value {
-            IN_MEMORY,
-            _24H,
             /**
-             * An enum member indicating that [PromptCacheRetention] was instantiated with an
-             * unknown value.
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
              */
-            _UNKNOWN,
-        }
+            fun validate(): Policy = apply {
+                if (validated) {
+                    return@apply
+                }
 
-        /**
-         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
-         * if the class was instantiated with an unknown value.
-         *
-         * Use the [known] method instead if you're certain the value is always known or if you want
-         * to throw for the unknown case.
-         */
-        fun value(): Value =
-            when (this) {
-                IN_MEMORY -> Value.IN_MEMORY
-                _24H -> Value._24H
-                else -> Value._UNKNOWN
+                input().ifPresent { it.validate() }
+                output().ifPresent { it.validate() }
+                validated = true
             }
 
-        /**
-         * Returns an enum member corresponding to this class instance's value.
-         *
-         * Use the [value] method instead if you're uncertain the value is always known and don't
-         * want to throw for the unknown case.
-         *
-         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
-         *   member.
-         */
-        fun known(): Known =
-            when (this) {
-                IN_MEMORY -> Known.IN_MEMORY
-                _24H -> Known._24H
-                else -> throw OpenAIInvalidDataException("Unknown PromptCacheRetention: $value")
-            }
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
 
-        /**
-         * Returns this class instance's primitive wire representation.
-         *
-         * This differs from the [toString] method because that method is primarily for debugging
-         * and generally doesn't throw.
-         *
-         * @throws OpenAIInvalidDataException if this class instance's value does not have the
-         *   expected primitive type.
-         */
-        fun asString(): String =
-            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic
+            internal fun validity(): Int =
+                (input.asKnown().getOrNull()?.validity() ?: 0) +
+                    (output.asKnown().getOrNull()?.validity() ?: 0)
+
+            /** The moderation policy for the response input. */
+            class Input
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val mode: JsonField<Mode>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
 
-        private var validated: Boolean = false
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of()
+                ) : this(mode, mutableMapOf())
+
+                /**
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun mode(): Mode = mode.getRequired("mode")
+
+                /**
+                 * Returns the raw JSON value of [mode].
+                 *
+                 * Unlike [mode], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
 
-        /**
-         * Validates that the types of all values in this object match their expected types
-         * recursively.
-         *
-         * This method is _not_ forwards compatible with new types from the API for existing fields.
-         *
-         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
-         *   expected type.
-         */
-        fun validate(): PromptCacheRetention = apply {
-            if (validated) {
-                return@apply
-            }
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
 
-            known()
-            validated = true
-        }
+                fun toBuilder() = Builder().from(this)
 
-        fun isValid(): Boolean =
-            try {
-                validate()
-                true
-            } catch (e: OpenAIInvalidDataException) {
-                false
-            }
+                companion object {
 
-        /**
-         * Returns a score indicating how many valid values are contained in this object
-         * recursively.
-         *
-         * Used for best match union deserialization.
-         */
-        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Input].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .mode()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
 
-        override fun equals(other: Any?): Boolean {
-            if (this === other) {
-                return true
-            }
+                /** A builder for [Input]. */
+                class Builder internal constructor() {
 
-            return other is PromptCacheRetention && value == other.value
-        }
+                    private var mode: JsonField<Mode>? = null
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
-        override fun hashCode() = value.hashCode()
+                    @JvmSynthetic
+                    internal fun from(input: Input) = apply {
+                        mode = input.mode
+                        additionalProperties = input.additionalProperties.toMutableMap()
+                    }
 
-        override fun toString() = value.toString()
-    }
+                    fun mode(mode: Mode) = mode(JsonField.of(mode))
 
-    /**
-     * Specifies the processing type used for serving the request.
-     * - If set to 'auto', then the request will be processed with the service tier configured in
-     *   the Project settings. Unless otherwise configured, the Project will use 'default'.
-     * - If set to 'default', then the request will be processed with the standard pricing and
-     *   performance for the selected model.
-     * - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
-     *   '[priority](https://openai.com/api-priority-processing/)', then the request will be
-     *   processed with the corresponding service tier.
-     * - When not set, the default behavior is 'auto'.
-     *
-     *   When the `service_tier` parameter is set, the response body will include the `service_tier`
-     *   value based on the processing mode actually used to serve the request. This response value
-     *   may be different from the value set in the parameter.
-     */
-    class ServiceTier @JsonCreator private constructor(private val value: JsonField<String>) :
-        Enum {
+                    /**
+                     * Sets [Builder.mode] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.mode] with a well-typed [Mode] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
 
-        /**
-         * Returns this class instance's raw value.
-         *
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Input].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .mode()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Input =
+                        Input(checkRequired("mode", mode), additionalProperties.toMutableMap())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Input = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    mode().validate()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int = (mode.asKnown().getOrNull()?.validity() ?: 0)
+
+                class Mode @JsonCreator private constructor(private val value: JsonField<String>) :
+                    Enum {
+
+                    /**
+                     * Returns this class instance's raw value.
+                     *
+                     * This is usually only useful if this instance was deserialized from data that
+                     * doesn't match any known member, and you want to know that value. For example,
+                     * if the SDK is on an older version than the API, then the API may respond with
+                     * new members that the SDK is unaware of.
+                     */
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    fun _value(): JsonField<String> = value
+
+                    companion object {
+
+                        @JvmField val SCORE = of("score")
+
+                        @JvmField val BLOCK = of("block")
+
+                        @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+                    }
+
+                    /** An enum containing [Mode]'s known values. */
+                    enum class Known {
+                        SCORE,
+                        BLOCK,
+                    }
+
+                    /**
+                     * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+                     *
+                     * An instance of [Mode] can contain an unknown value in a couple of cases:
+                     * - It was deserialized from data that doesn't match any known member. For
+                     *   example, if the SDK is on an older version than the API, then the API may
+                     *   respond with new members that the SDK is unaware of.
+                     * - It was constructed with an arbitrary value using the [of] method.
+                     */
+                    enum class Value {
+                        SCORE,
+                        BLOCK,
+                        /**
+                         * An enum member indicating that [Mode] was instantiated with an unknown
+                         * value.
+                         */
+                        _UNKNOWN,
+                    }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value, or
+                     * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                     *
+                     * Use the [known] method instead if you're certain the value is always known or
+                     * if you want to throw for the unknown case.
+                     */
+                    fun value(): Value =
+                        when (this) {
+                            SCORE -> Value.SCORE
+                            BLOCK -> Value.BLOCK
+                            else -> Value._UNKNOWN
+                        }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value.
+                     *
+                     * Use the [value] method instead if you're uncertain the value is always known
+                     * and don't want to throw for the unknown case.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                     *   known member.
+                     */
+                    fun known(): Known =
+                        when (this) {
+                            SCORE -> Known.SCORE
+                            BLOCK -> Known.BLOCK
+                            else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                        }
+
+                    /**
+                     * Returns this class instance's primitive wire representation.
+                     *
+                     * This differs from the [toString] method because that method is primarily for
+                     * debugging and generally doesn't throw.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value does not
+                     *   have the expected primitive type.
+                     */
+                    fun asString(): String =
+                        _value().asString().orElseThrow {
+                            OpenAIInvalidDataException("Value is not a String")
+                        }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): Mode = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        known()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Mode && value == other.value
+                    }
+
+                    override fun hashCode() = value.hashCode()
+
+                    override fun toString() = value.toString()
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Input &&
+                        mode == other.mode &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Input{mode=$mode, additionalProperties=$additionalProperties}"
+            }
+
+            /** The moderation policy for the response output. */
+            class Output
+            @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+            private constructor(
+                private val mode: JsonField<Mode>,
+                private val additionalProperties: MutableMap<String, JsonValue>,
+            ) {
+
+                @JsonCreator
+                private constructor(
+                    @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of()
+                ) : this(mode, mutableMapOf())
+
+                /**
+                 * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+                 *   unexpectedly missing or null (e.g. if the server responded with an unexpected
+                 *   value).
+                 */
+                fun mode(): Mode = mode.getRequired("mode")
+
+                /**
+                 * Returns the raw JSON value of [mode].
+                 *
+                 * Unlike [mode], this method doesn't throw if the JSON field has an unexpected
+                 * type.
+                 */
+                @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+                @JsonAnySetter
+                private fun putAdditionalProperty(key: String, value: JsonValue) {
+                    additionalProperties.put(key, value)
+                }
+
+                @JsonAnyGetter
+                @ExcludeMissing
+                fun _additionalProperties(): Map<String, JsonValue> =
+                    Collections.unmodifiableMap(additionalProperties)
+
+                fun toBuilder() = Builder().from(this)
+
+                companion object {
+
+                    /**
+                     * Returns a mutable builder for constructing an instance of [Output].
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .mode()
+                     * ```
+                     */
+                    @JvmStatic fun builder() = Builder()
+                }
+
+                /** A builder for [Output]. */
+                class Builder internal constructor() {
+
+                    private var mode: JsonField<Mode>? = null
+                    private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+                    @JvmSynthetic
+                    internal fun from(output: Output) = apply {
+                        mode = output.mode
+                        additionalProperties = output.additionalProperties.toMutableMap()
+                    }
+
+                    fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+                    /**
+                     * Sets [Builder.mode] to an arbitrary JSON value.
+                     *
+                     * You should usually call [Builder.mode] with a well-typed [Mode] value
+                     * instead. This method is primarily for setting the field to an undocumented or
+                     * not yet supported value.
+                     */
+                    fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+                    fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                        this.additionalProperties.clear()
+                        putAllAdditionalProperties(additionalProperties)
+                    }
+
+                    fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                        additionalProperties.put(key, value)
+                    }
+
+                    fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) =
+                        apply {
+                            this.additionalProperties.putAll(additionalProperties)
+                        }
+
+                    fun removeAdditionalProperty(key: String) = apply {
+                        additionalProperties.remove(key)
+                    }
+
+                    fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                        keys.forEach(::removeAdditionalProperty)
+                    }
+
+                    /**
+                     * Returns an immutable instance of [Output].
+                     *
+                     * Further updates to this [Builder] will not mutate the returned instance.
+                     *
+                     * The following fields are required:
+                     * ```java
+                     * .mode()
+                     * ```
+                     *
+                     * @throws IllegalStateException if any required field is unset.
+                     */
+                    fun build(): Output =
+                        Output(checkRequired("mode", mode), additionalProperties.toMutableMap())
+                }
+
+                private var validated: Boolean = false
+
+                /**
+                 * Validates that the types of all values in this object match their expected types
+                 * recursively.
+                 *
+                 * This method is _not_ forwards compatible with new types from the API for existing
+                 * fields.
+                 *
+                 * @throws OpenAIInvalidDataException if any value type in this object doesn't match
+                 *   its expected type.
+                 */
+                fun validate(): Output = apply {
+                    if (validated) {
+                        return@apply
+                    }
+
+                    mode().validate()
+                    validated = true
+                }
+
+                fun isValid(): Boolean =
+                    try {
+                        validate()
+                        true
+                    } catch (e: OpenAIInvalidDataException) {
+                        false
+                    }
+
+                /**
+                 * Returns a score indicating how many valid values are contained in this object
+                 * recursively.
+                 *
+                 * Used for best match union deserialization.
+                 */
+                @JvmSynthetic
+                internal fun validity(): Int = (mode.asKnown().getOrNull()?.validity() ?: 0)
+
+                class Mode @JsonCreator private constructor(private val value: JsonField<String>) :
+                    Enum {
+
+                    /**
+                     * Returns this class instance's raw value.
+                     *
+                     * This is usually only useful if this instance was deserialized from data that
+                     * doesn't match any known member, and you want to know that value. For example,
+                     * if the SDK is on an older version than the API, then the API may respond with
+                     * new members that the SDK is unaware of.
+                     */
+                    @com.fasterxml.jackson.annotation.JsonValue
+                    fun _value(): JsonField<String> = value
+
+                    companion object {
+
+                        @JvmField val SCORE = of("score")
+
+                        @JvmField val BLOCK = of("block")
+
+                        @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+                    }
+
+                    /** An enum containing [Mode]'s known values. */
+                    enum class Known {
+                        SCORE,
+                        BLOCK,
+                    }
+
+                    /**
+                     * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+                     *
+                     * An instance of [Mode] can contain an unknown value in a couple of cases:
+                     * - It was deserialized from data that doesn't match any known member. For
+                     *   example, if the SDK is on an older version than the API, then the API may
+                     *   respond with new members that the SDK is unaware of.
+                     * - It was constructed with an arbitrary value using the [of] method.
+                     */
+                    enum class Value {
+                        SCORE,
+                        BLOCK,
+                        /**
+                         * An enum member indicating that [Mode] was instantiated with an unknown
+                         * value.
+                         */
+                        _UNKNOWN,
+                    }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value, or
+                     * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+                     *
+                     * Use the [known] method instead if you're certain the value is always known or
+                     * if you want to throw for the unknown case.
+                     */
+                    fun value(): Value =
+                        when (this) {
+                            SCORE -> Value.SCORE
+                            BLOCK -> Value.BLOCK
+                            else -> Value._UNKNOWN
+                        }
+
+                    /**
+                     * Returns an enum member corresponding to this class instance's value.
+                     *
+                     * Use the [value] method instead if you're uncertain the value is always known
+                     * and don't want to throw for the unknown case.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value is a not a
+                     *   known member.
+                     */
+                    fun known(): Known =
+                        when (this) {
+                            SCORE -> Known.SCORE
+                            BLOCK -> Known.BLOCK
+                            else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                        }
+
+                    /**
+                     * Returns this class instance's primitive wire representation.
+                     *
+                     * This differs from the [toString] method because that method is primarily for
+                     * debugging and generally doesn't throw.
+                     *
+                     * @throws OpenAIInvalidDataException if this class instance's value does not
+                     *   have the expected primitive type.
+                     */
+                    fun asString(): String =
+                        _value().asString().orElseThrow {
+                            OpenAIInvalidDataException("Value is not a String")
+                        }
+
+                    private var validated: Boolean = false
+
+                    /**
+                     * Validates that the types of all values in this object match their expected
+                     * types recursively.
+                     *
+                     * This method is _not_ forwards compatible with new types from the API for
+                     * existing fields.
+                     *
+                     * @throws OpenAIInvalidDataException if any value type in this object doesn't
+                     *   match its expected type.
+                     */
+                    fun validate(): Mode = apply {
+                        if (validated) {
+                            return@apply
+                        }
+
+                        known()
+                        validated = true
+                    }
+
+                    fun isValid(): Boolean =
+                        try {
+                            validate()
+                            true
+                        } catch (e: OpenAIInvalidDataException) {
+                            false
+                        }
+
+                    /**
+                     * Returns a score indicating how many valid values are contained in this object
+                     * recursively.
+                     *
+                     * Used for best match union deserialization.
+                     */
+                    @JvmSynthetic
+                    internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+                    override fun equals(other: Any?): Boolean {
+                        if (this === other) {
+                            return true
+                        }
+
+                        return other is Mode && value == other.value
+                    }
+
+                    override fun hashCode() = value.hashCode()
+
+                    override fun toString() = value.toString()
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) {
+                        return true
+                    }
+
+                    return other is Output &&
+                        mode == other.mode &&
+                        additionalProperties == other.additionalProperties
+                }
+
+                private val hashCode: Int by lazy { Objects.hash(mode, additionalProperties) }
+
+                override fun hashCode(): Int = hashCode
+
+                override fun toString() =
+                    "Output{mode=$mode, additionalProperties=$additionalProperties}"
+            }
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Policy &&
+                    input == other.input &&
+                    output == other.output &&
+                    additionalProperties == other.additionalProperties
+            }
+
+            private val hashCode: Int by lazy { Objects.hash(input, output, additionalProperties) }
+
+            override fun hashCode(): Int = hashCode
+
+            override fun toString() =
+                "Policy{input=$input, output=$output, additionalProperties=$additionalProperties}"
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Moderation &&
+                model == other.model &&
+                policy == other.policy &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(model, policy, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Moderation{model=$model, policy=$policy, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By default, OpenAI
+     * automatically chooses one implicit cache breakpoint. You can add explicit breakpoints to
+     * content blocks with `prompt_cache_breakpoint`. Each request can write up to four breakpoints.
+     * For cache matching, OpenAI considers up to the latest 80 breakpoints in the conversation,
+     * without a content-block lookback limit. Set `mode` to `explicit` to disable the implicit
+     * breakpoint. The `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching) for current
+     * details.
+     */
+    class PromptCacheOptions
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val mode: JsonField<Mode>,
+        private val ttl: JsonField<Ttl>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("mode") @ExcludeMissing mode: JsonField<Mode> = JsonMissing.of(),
+            @JsonProperty("ttl") @ExcludeMissing ttl: JsonField<Ttl> = JsonMissing.of(),
+        ) : this(mode, ttl, mutableMapOf())
+
+        /**
+         * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults to
+         * `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up to the
+         * latest three explicit breakpoints in the request. With `explicit`, OpenAI does not create
+         * an implicit breakpoint and writes up to the latest four explicit breakpoints. If there
+         * are no explicit breakpoints, the request does not use prompt caching.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun mode(): Optional<Mode> = mode.getOptional("mode")
+
+        /**
+         * The minimum lifetime applied to every implicit and explicit cache breakpoint written by
+         * the request. Defaults to `30m`, which is currently the only supported value. The backend
+         * may retain cache entries for longer.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun ttl(): Optional<Ttl> = ttl.getOptional("ttl")
+
+        /**
+         * Returns the raw JSON value of [mode].
+         *
+         * Unlike [mode], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("mode") @ExcludeMissing fun _mode(): JsonField<Mode> = mode
+
+        /**
+         * Returns the raw JSON value of [ttl].
+         *
+         * Unlike [ttl], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("ttl") @ExcludeMissing fun _ttl(): JsonField<Ttl> = ttl
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /** Returns a mutable builder for constructing an instance of [PromptCacheOptions]. */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [PromptCacheOptions]. */
+        class Builder internal constructor() {
+
+            private var mode: JsonField<Mode> = JsonMissing.of()
+            private var ttl: JsonField<Ttl> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(promptCacheOptions: PromptCacheOptions) = apply {
+                mode = promptCacheOptions.mode
+                ttl = promptCacheOptions.ttl
+                additionalProperties = promptCacheOptions.additionalProperties.toMutableMap()
+            }
+
+            /**
+             * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults
+             * to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up
+             * to the latest three explicit breakpoints in the request. With `explicit`, OpenAI does
+             * not create an implicit breakpoint and writes up to the latest four explicit
+             * breakpoints. If there are no explicit breakpoints, the request does not use prompt
+             * caching.
+             */
+            fun mode(mode: Mode) = mode(JsonField.of(mode))
+
+            /**
+             * Sets [Builder.mode] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.mode] with a well-typed [Mode] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun mode(mode: JsonField<Mode>) = apply { this.mode = mode }
+
+            /**
+             * The minimum lifetime applied to every implicit and explicit cache breakpoint written
+             * by the request. Defaults to `30m`, which is currently the only supported value. The
+             * backend may retain cache entries for longer.
+             */
+            fun ttl(ttl: Ttl) = ttl(JsonField.of(ttl))
+
+            /**
+             * Sets [Builder.ttl] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.ttl] with a well-typed [Ttl] value instead. This
+             * method is primarily for setting the field to an undocumented or not yet supported
+             * value.
+             */
+            fun ttl(ttl: JsonField<Ttl>) = apply { this.ttl = ttl }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [PromptCacheOptions].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             */
+            fun build(): PromptCacheOptions =
+                PromptCacheOptions(mode, ttl, additionalProperties.toMutableMap())
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheOptions = apply {
+            if (validated) {
+                return@apply
+            }
+
+            mode().ifPresent { it.validate() }
+            ttl().ifPresent { it.validate() }
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (mode.asKnown().getOrNull()?.validity() ?: 0) +
+                (ttl.asKnown().getOrNull()?.validity() ?: 0)
+
+        /**
+         * Controls whether OpenAI automatically creates an implicit cache breakpoint. Defaults to
+         * `implicit`. With `implicit`, OpenAI creates one implicit breakpoint and writes up to the
+         * latest three explicit breakpoints in the request. With `explicit`, OpenAI does not create
+         * an implicit breakpoint and writes up to the latest four explicit breakpoints. If there
+         * are no explicit breakpoints, the request does not use prompt caching.
+         */
+        class Mode @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val IMPLICIT = of("implicit")
+
+                @JvmField val EXPLICIT = of("explicit")
+
+                @JvmStatic fun of(value: String) = Mode(JsonField.of(value))
+            }
+
+            /** An enum containing [Mode]'s known values. */
+            enum class Known {
+                IMPLICIT,
+                EXPLICIT,
+            }
+
+            /**
+             * An enum containing [Mode]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Mode] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                IMPLICIT,
+                EXPLICIT,
+                /** An enum member indicating that [Mode] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    IMPLICIT -> Value.IMPLICIT
+                    EXPLICIT -> Value.EXPLICIT
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    IMPLICIT -> Known.IMPLICIT
+                    EXPLICIT -> Known.EXPLICIT
+                    else -> throw OpenAIInvalidDataException("Unknown Mode: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Mode = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Mode && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        /**
+         * The minimum lifetime applied to every implicit and explicit cache breakpoint written by
+         * the request. Defaults to `30m`, which is currently the only supported value. The backend
+         * may retain cache entries for longer.
+         */
+        class Ttl @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val _30M = of("30m")
+
+                @JvmStatic fun of(value: String) = Ttl(JsonField.of(value))
+            }
+
+            /** An enum containing [Ttl]'s known values. */
+            enum class Known {
+                _30M
+            }
+
+            /**
+             * An enum containing [Ttl]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [Ttl] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                _30M,
+                /** An enum member indicating that [Ttl] was instantiated with an unknown value. */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    _30M -> Value._30M
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    _30M -> Known._30M
+                    else -> throw OpenAIInvalidDataException("Unknown Ttl: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): Ttl = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is Ttl && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheOptions &&
+                mode == other.mode &&
+                ttl == other.ttl &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy { Objects.hash(mode, ttl, additionalProperties) }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "PromptCacheOptions{mode=$mode, ttl=$ttl, additionalProperties=$additionalProperties}"
+    }
+
+    /**
+     * Deprecated. Use `prompt_cache_options.ttl` instead.
+     *
+     * The retention policy for the prompt cache. Set to `24h` to enable extended prompt caching,
+     * which keeps cached prefixes active for longer, up to a maximum of 24 hours.
+     * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
+     * This field expresses a maximum retention policy, while `prompt_cache_options.ttl` expresses a
+     * minimum cache lifetime. The two fields are independent and do not interact. For `gpt-5.5`,
+     * `gpt-5.5-pro`, and future models, only `24h` is supported.
+     *
+     * For older models that support both `in_memory` and `24h`, the default depends on your
+     * organization's data retention policy:
+     * - Organizations without ZDR enabled default to `24h`.
+     * - Organizations with ZDR enabled default to `in_memory` when `prompt_cache_retention` is not
+     *   specified.
+     */
+    @Deprecated("deprecated")
+    class PromptCacheRetention
+    @JsonCreator
+    private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val IN_MEMORY = of("in_memory")
+
+            @JvmField val _24H = of("24h")
+
+            @JvmStatic fun of(value: String) = PromptCacheRetention(JsonField.of(value))
+        }
+
+        /** An enum containing [PromptCacheRetention]'s known values. */
+        enum class Known {
+            IN_MEMORY,
+            _24H,
+        }
+
+        /**
+         * An enum containing [PromptCacheRetention]'s known values, as well as an [_UNKNOWN]
+         * member.
+         *
+         * An instance of [PromptCacheRetention] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            IN_MEMORY,
+            _24H,
+            /**
+             * An enum member indicating that [PromptCacheRetention] was instantiated with an
+             * unknown value.
+             */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                IN_MEMORY -> Value.IN_MEMORY
+                _24H -> Value._24H
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                IN_MEMORY -> Known.IN_MEMORY
+                _24H -> Known._24H
+                else -> throw OpenAIInvalidDataException("Unknown PromptCacheRetention: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): PromptCacheRetention = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is PromptCacheRetention && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    /**
+     * Specifies the processing type used for serving the request.
+     * - If set to 'auto', then the request will be processed with the service tier configured in
+     *   the Project settings. Unless otherwise configured, the Project will use 'default'.
+     * - If set to 'default', then the request will be processed with the standard pricing and
+     *   performance for the selected model.
+     * - If set to '[flex](https://platform.openai.com/docs/guides/flex-processing)' or
+     *   '[priority](https://openai.com/api-priority-processing/)', then the request will be
+     *   processed with the corresponding service tier.
+     * - When not set, the default behavior is 'auto'.
+     *
+     *   When the `service_tier` parameter is set, the response body will include the `service_tier`
+     *   value based on the processing mode actually used to serve the request. This response value
+     *   may be different from the value set in the parameter.
+     */
+    class ServiceTier @JsonCreator private constructor(private val value: JsonField<String>) :
+        Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
          * This is usually only useful if this instance was deserialized from data that doesn't
          * match any known member, and you want to know that value. For example, if the SDK is on an
          * older version than the API, then the API may respond with new members that the SDK is
@@ -3455,6 +4904,7 @@ private constructor(
         private val function: ToolChoiceFunction? = null,
         private val mcp: ToolChoiceMcp? = null,
         private val custom: ToolChoiceCustom? = null,
+        private val specificProgrammaticToolCallingParam: JsonValue? = null,
         private val applyPatch: ToolChoiceApplyPatch? = null,
         private val shell: ToolChoiceShell? = null,
         private val _json: JsonValue? = null,
@@ -3490,6 +4940,9 @@ private constructor(
         /** Use this option to force the model to call a specific custom tool. */
         fun custom(): Optional<ToolChoiceCustom> = Optional.ofNullable(custom)
 
+        fun specificProgrammaticToolCallingParam(): Optional<JsonValue> =
+            Optional.ofNullable(specificProgrammaticToolCallingParam)
+
         /** Forces the model to call the apply_patch tool when executing a tool call. */
         fun applyPatch(): Optional<ToolChoiceApplyPatch> = Optional.ofNullable(applyPatch)
 
@@ -3508,6 +4961,9 @@ private constructor(
 
         fun isCustom(): Boolean = custom != null
 
+        fun isSpecificProgrammaticToolCallingParam(): Boolean =
+            specificProgrammaticToolCallingParam != null
+
         fun isApplyPatch(): Boolean = applyPatch != null
 
         fun isShell(): Boolean = shell != null
@@ -3542,6 +4998,9 @@ private constructor(
         /** Use this option to force the model to call a specific custom tool. */
         fun asCustom(): ToolChoiceCustom = custom.getOrThrow("custom")
 
+        fun asSpecificProgrammaticToolCallingParam(): JsonValue =
+            specificProgrammaticToolCallingParam.getOrThrow("specificProgrammaticToolCallingParam")
+
         /** Forces the model to call the apply_patch tool when executing a tool call. */
         fun asApplyPatch(): ToolChoiceApplyPatch = applyPatch.getOrThrow("applyPatch")
 
@@ -3587,6 +5046,10 @@ private constructor(
                 function != null -> visitor.visitFunction(function)
                 mcp != null -> visitor.visitMcp(mcp)
                 custom != null -> visitor.visitCustom(custom)
+                specificProgrammaticToolCallingParam != null ->
+                    visitor.visitSpecificProgrammaticToolCallingParam(
+                        specificProgrammaticToolCallingParam
+                    )
                 applyPatch != null -> visitor.visitApplyPatch(applyPatch)
                 shell != null -> visitor.visitShell(shell)
                 else -> visitor.unknown(_json)
@@ -3634,6 +5097,20 @@ private constructor(
                         custom.validate()
                     }
 
+                    override fun visitSpecificProgrammaticToolCallingParam(
+                        specificProgrammaticToolCallingParam: JsonValue
+                    ) {
+                        specificProgrammaticToolCallingParam.let {
+                            if (
+                                it != JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                            ) {
+                                throw OpenAIInvalidDataException(
+                                    "'specificProgrammaticToolCallingParam' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
                     override fun visitApplyPatch(applyPatch: ToolChoiceApplyPatch) {
                         applyPatch.validate()
                     }
@@ -3676,6 +5153,15 @@ private constructor(
 
                     override fun visitCustom(custom: ToolChoiceCustom) = custom.validity()
 
+                    override fun visitSpecificProgrammaticToolCallingParam(
+                        specificProgrammaticToolCallingParam: JsonValue
+                    ) =
+                        specificProgrammaticToolCallingParam.let {
+                            if (it == JsonValue.from(mapOf("type" to "programmatic_tool_calling")))
+                                1
+                            else 0
+                        }
+
                     override fun visitApplyPatch(applyPatch: ToolChoiceApplyPatch) =
                         applyPatch.validity()
 
@@ -3697,12 +5183,24 @@ private constructor(
                 function == other.function &&
                 mcp == other.mcp &&
                 custom == other.custom &&
+                specificProgrammaticToolCallingParam ==
+                    other.specificProgrammaticToolCallingParam &&
                 applyPatch == other.applyPatch &&
                 shell == other.shell
         }
 
         override fun hashCode(): Int =
-            Objects.hash(options, allowed, types, function, mcp, custom, applyPatch, shell)
+            Objects.hash(
+                options,
+                allowed,
+                types,
+                function,
+                mcp,
+                custom,
+                specificProgrammaticToolCallingParam,
+                applyPatch,
+                shell,
+            )
 
         override fun toString(): String =
             when {
@@ -3712,6 +5210,8 @@ private constructor(
                 function != null -> "ToolChoice{function=$function}"
                 mcp != null -> "ToolChoice{mcp=$mcp}"
                 custom != null -> "ToolChoice{custom=$custom}"
+                specificProgrammaticToolCallingParam != null ->
+                    "ToolChoice{specificProgrammaticToolCallingParam=$specificProgrammaticToolCallingParam}"
                 applyPatch != null -> "ToolChoice{applyPatch=$applyPatch}"
                 shell != null -> "ToolChoice{shell=$shell}"
                 _json != null -> "ToolChoice{_unknown=$_json}"
@@ -3753,6 +5253,13 @@ private constructor(
             /** Use this option to force the model to call a specific custom tool. */
             @JvmStatic fun ofCustom(custom: ToolChoiceCustom) = ToolChoice(custom = custom)
 
+            @JvmStatic
+            fun ofSpecificProgrammaticToolCallingParam() =
+                ToolChoice(
+                    specificProgrammaticToolCallingParam =
+                        JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                )
+
             /** Forces the model to call the apply_patch tool when executing a tool call. */
             @JvmStatic
             fun ofApplyPatch(applyPatch: ToolChoiceApplyPatch) = ToolChoice(applyPatch = applyPatch)
@@ -3798,6 +5305,10 @@ private constructor(
             /** Use this option to force the model to call a specific custom tool. */
             fun visitCustom(custom: ToolChoiceCustom): T
 
+            fun visitSpecificProgrammaticToolCallingParam(
+                specificProgrammaticToolCallingParam: JsonValue
+            ): T
+
             /** Forces the model to call the apply_patch tool when executing a tool call. */
             fun visitApplyPatch(applyPatch: ToolChoiceApplyPatch): T
 
@@ -3826,6 +5337,14 @@ private constructor(
 
                 val bestMatches =
                     sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let {
+                                    ToolChoice(
+                                        specificProgrammaticToolCallingParam = it,
+                                        _json = json,
+                                    )
+                                }
+                                ?.takeIf { it.isValid() },
                             tryDeserialize(node, jacksonTypeRef<ToolChoiceOptions>())?.let {
                                 ToolChoice(options = it, _json = json)
                             },
@@ -3881,6 +5400,8 @@ private constructor(
                     value.function != null -> generator.writeObject(value.function)
                     value.mcp != null -> generator.writeObject(value.mcp)
                     value.custom != null -> generator.writeObject(value.custom)
+                    value.specificProgrammaticToolCallingParam != null ->
+                        generator.writeObject(value.specificProgrammaticToolCallingParam)
                     value.applyPatch != null -> generator.writeObject(value.applyPatch)
                     value.shell != null -> generator.writeObject(value.shell)
                     value._json != null -> generator.writeObject(value._json)
@@ -4057,6 +5578,7 @@ private constructor(
             previousResponseId == other.previousResponseId &&
             prompt == other.prompt &&
             promptCacheKey == other.promptCacheKey &&
+            promptCacheOptions == other.promptCacheOptions &&
             promptCacheRetention == other.promptCacheRetention &&
             reasoning == other.reasoning &&
             safetyIdentifier == other.safetyIdentifier &&
@@ -4093,6 +5615,7 @@ private constructor(
             previousResponseId,
             prompt,
             promptCacheKey,
+            promptCacheOptions,
             promptCacheRetention,
             reasoning,
             safetyIdentifier,
@@ -4115,5 +5638,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ResponsesClientEvent{type=$type, background=$background, contextManagement=$contextManagement, conversation=$conversation, include=$include, input=$input, instructions=$instructions, maxOutputTokens=$maxOutputTokens, maxToolCalls=$maxToolCalls, metadata=$metadata, model=$model, moderation=$moderation, parallelToolCalls=$parallelToolCalls, previousResponseId=$previousResponseId, prompt=$prompt, promptCacheKey=$promptCacheKey, promptCacheRetention=$promptCacheRetention, reasoning=$reasoning, safetyIdentifier=$safetyIdentifier, serviceTier=$serviceTier, store=$store, stream=$stream, streamOptions=$streamOptions, temperature=$temperature, text=$text, toolChoice=$toolChoice, tools=$tools, topLogprobs=$topLogprobs, topP=$topP, truncation=$truncation, user=$user, additionalProperties=$additionalProperties}"
+        "ResponsesClientEvent{type=$type, background=$background, contextManagement=$contextManagement, conversation=$conversation, include=$include, input=$input, instructions=$instructions, maxOutputTokens=$maxOutputTokens, maxToolCalls=$maxToolCalls, metadata=$metadata, model=$model, moderation=$moderation, parallelToolCalls=$parallelToolCalls, previousResponseId=$previousResponseId, prompt=$prompt, promptCacheKey=$promptCacheKey, promptCacheOptions=$promptCacheOptions, promptCacheRetention=$promptCacheRetention, reasoning=$reasoning, safetyIdentifier=$safetyIdentifier, serviceTier=$serviceTier, store=$store, stream=$stream, streamOptions=$streamOptions, temperature=$temperature, text=$text, toolChoice=$toolChoice, tools=$tools, topLogprobs=$topLogprobs, topP=$topP, truncation=$truncation, user=$user, additionalProperties=$additionalProperties}"
 }
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/Tool.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/Tool.kt
index d69809bdf..da0ea494b 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/Tool.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/Tool.kt
@@ -43,6 +43,7 @@ private constructor(
     private val webSearch: WebSearchTool? = null,
     private val mcp: Mcp? = null,
     private val codeInterpreter: CodeInterpreter? = null,
+    private val programmaticToolCalling: JsonValue? = null,
     private val imageGeneration: ImageGeneration? = null,
     private val localShell: JsonValue? = null,
     private val shell: FunctionShellTool? = null,
@@ -94,6 +95,9 @@ private constructor(
     /** A tool that runs Python code to help generate a response to a prompt. */
     fun codeInterpreter(): Optional<CodeInterpreter> = Optional.ofNullable(codeInterpreter)
 
+    fun programmaticToolCalling(): Optional<JsonValue> =
+        Optional.ofNullable(programmaticToolCalling)
+
     /** A tool that generates images using the GPT image models. */
     fun imageGeneration(): Optional<ImageGeneration> = Optional.ofNullable(imageGeneration)
 
@@ -138,6 +142,8 @@ private constructor(
 
     fun isCodeInterpreter(): Boolean = codeInterpreter != null
 
+    fun isProgrammaticToolCalling(): Boolean = programmaticToolCalling != null
+
     fun isImageGeneration(): Boolean = imageGeneration != null
 
     fun isLocalShell(): Boolean = localShell != null
@@ -194,6 +200,9 @@ private constructor(
     /** A tool that runs Python code to help generate a response to a prompt. */
     fun asCodeInterpreter(): CodeInterpreter = codeInterpreter.getOrThrow("codeInterpreter")
 
+    fun asProgrammaticToolCalling(): JsonValue =
+        programmaticToolCalling.getOrThrow("programmaticToolCalling")
+
     /** A tool that generates images using the GPT image models. */
     fun asImageGeneration(): ImageGeneration = imageGeneration.getOrThrow("imageGeneration")
 
@@ -264,6 +273,8 @@ private constructor(
             webSearch != null -> visitor.visitWebSearch(webSearch)
             mcp != null -> visitor.visitMcp(mcp)
             codeInterpreter != null -> visitor.visitCodeInterpreter(codeInterpreter)
+            programmaticToolCalling != null ->
+                visitor.visitProgrammaticToolCalling(programmaticToolCalling)
             imageGeneration != null -> visitor.visitImageGeneration(imageGeneration)
             localShell != null -> visitor.visitLocalShell(localShell)
             shell != null -> visitor.visitShell(shell)
@@ -320,6 +331,16 @@ private constructor(
                     codeInterpreter.validate()
                 }
 
+                override fun visitProgrammaticToolCalling(programmaticToolCalling: JsonValue) {
+                    programmaticToolCalling.let {
+                        if (it != JsonValue.from(mapOf("type" to "programmatic_tool_calling"))) {
+                            throw OpenAIInvalidDataException(
+                                "'programmaticToolCalling' is invalid, received $it"
+                            )
+                        }
+                    }
+                }
+
                 override fun visitImageGeneration(imageGeneration: ImageGeneration) {
                     imageGeneration.validate()
                 }
@@ -395,6 +416,12 @@ private constructor(
                 override fun visitCodeInterpreter(codeInterpreter: CodeInterpreter) =
                     codeInterpreter.validity()
 
+                override fun visitProgrammaticToolCalling(programmaticToolCalling: JsonValue) =
+                    programmaticToolCalling.let {
+                        if (it == JsonValue.from(mapOf("type" to "programmatic_tool_calling"))) 1
+                        else 0
+                    }
+
                 override fun visitImageGeneration(imageGeneration: ImageGeneration) =
                     imageGeneration.validity()
 
@@ -433,6 +460,7 @@ private constructor(
             webSearch == other.webSearch &&
             mcp == other.mcp &&
             codeInterpreter == other.codeInterpreter &&
+            programmaticToolCalling == other.programmaticToolCalling &&
             imageGeneration == other.imageGeneration &&
             localShell == other.localShell &&
             shell == other.shell &&
@@ -452,6 +480,7 @@ private constructor(
             webSearch,
             mcp,
             codeInterpreter,
+            programmaticToolCalling,
             imageGeneration,
             localShell,
             shell,
@@ -471,6 +500,8 @@ private constructor(
             webSearch != null -> "Tool{webSearch=$webSearch}"
             mcp != null -> "Tool{mcp=$mcp}"
             codeInterpreter != null -> "Tool{codeInterpreter=$codeInterpreter}"
+            programmaticToolCalling != null ->
+                "Tool{programmaticToolCalling=$programmaticToolCalling}"
             imageGeneration != null -> "Tool{imageGeneration=$imageGeneration}"
             localShell != null -> "Tool{localShell=$localShell}"
             shell != null -> "Tool{shell=$shell}"
@@ -529,6 +560,13 @@ private constructor(
         fun ofCodeInterpreter(codeInterpreter: CodeInterpreter) =
             Tool(codeInterpreter = codeInterpreter)
 
+        @JvmStatic
+        fun ofProgrammaticToolCalling() =
+            Tool(
+                programmaticToolCalling =
+                    JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+            )
+
         /** A tool that generates images using the GPT image models. */
         @JvmStatic
         fun ofImageGeneration(imageGeneration: ImageGeneration) =
@@ -608,6 +646,8 @@ private constructor(
         /** A tool that runs Python code to help generate a response to a prompt. */
         fun visitCodeInterpreter(codeInterpreter: CodeInterpreter): T
 
+        fun visitProgrammaticToolCalling(programmaticToolCalling: JsonValue): T
+
         /** A tool that generates images using the GPT image models. */
         fun visitImageGeneration(imageGeneration: ImageGeneration): T
 
@@ -689,6 +729,11 @@ private constructor(
                         Tool(codeInterpreter = it, _json = json)
                     } ?: Tool(_json = json)
                 }
+                "programmatic_tool_calling" -> {
+                    return tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                        ?.let { Tool(programmaticToolCalling = it, _json = json) }
+                        ?.takeIf { it.isValid() } ?: Tool(_json = json)
+                }
                 "image_generation" -> {
                     return tryDeserialize(node, jacksonTypeRef<ImageGeneration>())?.let {
                         Tool(imageGeneration = it, _json = json)
@@ -765,6 +810,8 @@ private constructor(
                 value.webSearch != null -> generator.writeObject(value.webSearch)
                 value.mcp != null -> generator.writeObject(value.mcp)
                 value.codeInterpreter != null -> generator.writeObject(value.codeInterpreter)
+                value.programmaticToolCalling != null ->
+                    generator.writeObject(value.programmaticToolCalling)
                 value.imageGeneration != null -> generator.writeObject(value.imageGeneration)
                 value.localShell != null -> generator.writeObject(value.localShell)
                 value.shell != null -> generator.writeObject(value.shell)
@@ -788,6 +835,7 @@ private constructor(
     private constructor(
         private val serverLabel: JsonField<String>,
         private val type: JsonValue,
+        private val allowedCallers: JsonField<List<AllowedCaller>>,
         private val allowedTools: JsonField<AllowedTools>,
         private val authorization: JsonField<String>,
         private val connectorId: JsonField<ConnectorId>,
@@ -806,6 +854,9 @@ private constructor(
             @ExcludeMissing
             serverLabel: JsonField<String> = JsonMissing.of(),
             @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+            @JsonProperty("allowed_callers")
+            @ExcludeMissing
+            allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
             @JsonProperty("allowed_tools")
             @ExcludeMissing
             allowedTools: JsonField<AllowedTools> = JsonMissing.of(),
@@ -834,6 +885,7 @@ private constructor(
         ) : this(
             serverLabel,
             type,
+            allowedCallers,
             allowedTools,
             authorization,
             connectorId,
@@ -867,6 +919,15 @@ private constructor(
          */
         @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+        /**
+         * The tool invocation context(s).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun allowedCallers(): Optional<List<AllowedCaller>> =
+            allowedCallers.getOptional("allowed_callers")
+
         /**
          * List of allowed tool names or a filter object.
          *
@@ -967,6 +1028,16 @@ private constructor(
         @ExcludeMissing
         fun _serverLabel(): JsonField<String> = serverLabel
 
+        /**
+         * Returns the raw JSON value of [allowedCallers].
+         *
+         * Unlike [allowedCallers], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("allowed_callers")
+        @ExcludeMissing
+        fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
         /**
          * Returns the raw JSON value of [allowedTools].
          *
@@ -1077,6 +1148,7 @@ private constructor(
 
             private var serverLabel: JsonField<String>? = null
             private var type: JsonValue = JsonValue.from("mcp")
+            private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
             private var allowedTools: JsonField<AllowedTools> = JsonMissing.of()
             private var authorization: JsonField<String> = JsonMissing.of()
             private var connectorId: JsonField<ConnectorId> = JsonMissing.of()
@@ -1092,6 +1164,7 @@ private constructor(
             internal fun from(mcp: Mcp) = apply {
                 serverLabel = mcp.serverLabel
                 type = mcp.type
+                allowedCallers = mcp.allowedCallers.map { it.toMutableList() }
                 allowedTools = mcp.allowedTools
                 authorization = mcp.authorization
                 connectorId = mcp.connectorId
@@ -1132,6 +1205,37 @@ private constructor(
              */
             fun type(type: JsonValue) = apply { this.type = type }
 
+            /** The tool invocation context(s). */
+            fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+                allowedCallers(JsonField.ofNullable(allowedCallers))
+
+            /** Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`. */
+            fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+                allowedCallers(allowedCallers.getOrNull())
+
+            /**
+             * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.allowedCallers] with a well-typed
+             * `List<AllowedCaller>` value instead. This method is primarily for setting the field
+             * to an undocumented or not yet supported value.
+             */
+            fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+                this.allowedCallers = allowedCallers.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [AllowedCaller] to [allowedCallers].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+                allowedCallers =
+                    (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("allowedCallers", it).add(allowedCaller)
+                    }
+            }
+
             /** List of allowed tool names or a filter object. */
             fun allowedTools(allowedTools: AllowedTools?) =
                 allowedTools(JsonField.ofNullable(allowedTools))
@@ -1352,6 +1456,7 @@ private constructor(
                 Mcp(
                     checkRequired("serverLabel", serverLabel),
                     type,
+                    (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
                     allowedTools,
                     authorization,
                     connectorId,
@@ -1387,6 +1492,7 @@ private constructor(
                     throw OpenAIInvalidDataException("'type' is invalid, received $it")
                 }
             }
+            allowedCallers().ifPresent { it.forEach { it.validate() } }
             allowedTools().ifPresent { it.validate() }
             authorization()
             connectorId().ifPresent { it.validate() }
@@ -1417,6 +1523,7 @@ private constructor(
         internal fun validity(): Int =
             (if (serverLabel.asKnown().isPresent) 1 else 0) +
                 type.let { if (it == JsonValue.from("mcp")) 1 else 0 } +
+                (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
                 (allowedTools.asKnown().getOrNull()?.validity() ?: 0) +
                 (if (authorization.asKnown().isPresent) 1 else 0) +
                 (connectorId.asKnown().getOrNull()?.validity() ?: 0) +
@@ -1427,6 +1534,147 @@ private constructor(
                 (if (serverUrl.asKnown().isPresent) 1 else 0) +
                 (if (tunnelId.asKnown().isPresent) 1 else 0)
 
+        class AllowedCaller @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val DIRECT = of("direct")
+
+                @JvmField val PROGRAMMATIC = of("programmatic")
+
+                @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+            }
+
+            /** An enum containing [AllowedCaller]'s known values. */
+            enum class Known {
+                DIRECT,
+                PROGRAMMATIC,
+            }
+
+            /**
+             * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                DIRECT,
+                PROGRAMMATIC,
+                /**
+                 * An enum member indicating that [AllowedCaller] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    DIRECT -> Value.DIRECT
+                    PROGRAMMATIC -> Value.PROGRAMMATIC
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    DIRECT -> Known.DIRECT
+                    PROGRAMMATIC -> Known.PROGRAMMATIC
+                    else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): AllowedCaller = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is AllowedCaller && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
         /** List of allowed tool names or a filter object. */
         @JsonDeserialize(using = AllowedTools.Deserializer::class)
         @JsonSerialize(using = AllowedTools.Serializer::class)
@@ -3306,6 +3554,7 @@ private constructor(
             return other is Mcp &&
                 serverLabel == other.serverLabel &&
                 type == other.type &&
+                allowedCallers == other.allowedCallers &&
                 allowedTools == other.allowedTools &&
                 authorization == other.authorization &&
                 connectorId == other.connectorId &&
@@ -3322,6 +3571,7 @@ private constructor(
             Objects.hash(
                 serverLabel,
                 type,
+                allowedCallers,
                 allowedTools,
                 authorization,
                 connectorId,
@@ -3338,7 +3588,7 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Mcp{serverLabel=$serverLabel, type=$type, allowedTools=$allowedTools, authorization=$authorization, connectorId=$connectorId, deferLoading=$deferLoading, headers=$headers, requireApproval=$requireApproval, serverDescription=$serverDescription, serverUrl=$serverUrl, tunnelId=$tunnelId, additionalProperties=$additionalProperties}"
+            "Mcp{serverLabel=$serverLabel, type=$type, allowedCallers=$allowedCallers, allowedTools=$allowedTools, authorization=$authorization, connectorId=$connectorId, deferLoading=$deferLoading, headers=$headers, requireApproval=$requireApproval, serverDescription=$serverDescription, serverUrl=$serverUrl, tunnelId=$tunnelId, additionalProperties=$additionalProperties}"
     }
 
     /** A tool that runs Python code to help generate a response to a prompt. */
@@ -3347,6 +3597,7 @@ private constructor(
     private constructor(
         private val container: JsonField<Container>,
         private val type: JsonValue,
+        private val allowedCallers: JsonField<List<AllowedCaller>>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
@@ -3356,7 +3607,10 @@ private constructor(
             @ExcludeMissing
             container: JsonField<Container> = JsonMissing.of(),
             @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-        ) : this(container, type, mutableMapOf())
+            @JsonProperty("allowed_callers")
+            @ExcludeMissing
+            allowedCallers: JsonField<List<AllowedCaller>> = JsonMissing.of(),
+        ) : this(container, type, allowedCallers, mutableMapOf())
 
         /**
          * The code interpreter container. Can be a container ID or an object that specifies
@@ -3381,6 +3635,15 @@ private constructor(
          */
         @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+        /**
+         * The tool invocation context(s).
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun allowedCallers(): Optional<List<AllowedCaller>> =
+            allowedCallers.getOptional("allowed_callers")
+
         /**
          * Returns the raw JSON value of [container].
          *
@@ -3390,6 +3653,16 @@ private constructor(
         @ExcludeMissing
         fun _container(): JsonField<Container> = container
 
+        /**
+         * Returns the raw JSON value of [allowedCallers].
+         *
+         * Unlike [allowedCallers], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("allowed_callers")
+        @ExcludeMissing
+        fun _allowedCallers(): JsonField<List<AllowedCaller>> = allowedCallers
+
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
             additionalProperties.put(key, value)
@@ -3420,12 +3693,14 @@ private constructor(
 
             private var container: JsonField<Container>? = null
             private var type: JsonValue = JsonValue.from("code_interpreter")
+            private var allowedCallers: JsonField<MutableList<AllowedCaller>>? = null
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
             internal fun from(codeInterpreter: CodeInterpreter) = apply {
                 container = codeInterpreter.container
                 type = codeInterpreter.type
+                allowedCallers = codeInterpreter.allowedCallers.map { it.toMutableList() }
                 additionalProperties = codeInterpreter.additionalProperties.toMutableMap()
             }
 
@@ -3469,6 +3744,37 @@ private constructor(
              */
             fun type(type: JsonValue) = apply { this.type = type }
 
+            /** The tool invocation context(s). */
+            fun allowedCallers(allowedCallers: List<AllowedCaller>?) =
+                allowedCallers(JsonField.ofNullable(allowedCallers))
+
+            /** Alias for calling [Builder.allowedCallers] with `allowedCallers.orElse(null)`. */
+            fun allowedCallers(allowedCallers: Optional<List<AllowedCaller>>) =
+                allowedCallers(allowedCallers.getOrNull())
+
+            /**
+             * Sets [Builder.allowedCallers] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.allowedCallers] with a well-typed
+             * `List<AllowedCaller>` value instead. This method is primarily for setting the field
+             * to an undocumented or not yet supported value.
+             */
+            fun allowedCallers(allowedCallers: JsonField<List<AllowedCaller>>) = apply {
+                this.allowedCallers = allowedCallers.map { it.toMutableList() }
+            }
+
+            /**
+             * Adds a single [AllowedCaller] to [allowedCallers].
+             *
+             * @throws IllegalStateException if the field was previously set to a non-list.
+             */
+            fun addAllowedCaller(allowedCaller: AllowedCaller) = apply {
+                allowedCallers =
+                    (allowedCallers ?: JsonField.of(mutableListOf())).also {
+                        checkKnown("allowedCallers", it).add(allowedCaller)
+                    }
+            }
+
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
                 putAllAdditionalProperties(additionalProperties)
@@ -3504,6 +3810,7 @@ private constructor(
                 CodeInterpreter(
                     checkRequired("container", container),
                     type,
+                    (allowedCallers ?: JsonMissing.of()).map { it.toImmutable() },
                     additionalProperties.toMutableMap(),
                 )
         }
@@ -3530,6 +3837,7 @@ private constructor(
                     throw OpenAIInvalidDataException("'type' is invalid, received $it")
                 }
             }
+            allowedCallers().ifPresent { it.forEach { it.validate() } }
             validated = true
         }
 
@@ -3550,7 +3858,8 @@ private constructor(
         @JvmSynthetic
         internal fun validity(): Int =
             (container.asKnown().getOrNull()?.validity() ?: 0) +
-                type.let { if (it == JsonValue.from("code_interpreter")) 1 else 0 }
+                type.let { if (it == JsonValue.from("code_interpreter")) 1 else 0 } +
+                (allowedCallers.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0)
 
         /**
          * The code interpreter container. Can be a container ID or an object that specifies
@@ -4545,6 +4854,147 @@ private constructor(
             }
         }
 
+        class AllowedCaller @JsonCreator private constructor(private val value: JsonField<String>) :
+            Enum {
+
+            /**
+             * Returns this class instance's raw value.
+             *
+             * This is usually only useful if this instance was deserialized from data that doesn't
+             * match any known member, and you want to know that value. For example, if the SDK is
+             * on an older version than the API, then the API may respond with new members that the
+             * SDK is unaware of.
+             */
+            @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+            companion object {
+
+                @JvmField val DIRECT = of("direct")
+
+                @JvmField val PROGRAMMATIC = of("programmatic")
+
+                @JvmStatic fun of(value: String) = AllowedCaller(JsonField.of(value))
+            }
+
+            /** An enum containing [AllowedCaller]'s known values. */
+            enum class Known {
+                DIRECT,
+                PROGRAMMATIC,
+            }
+
+            /**
+             * An enum containing [AllowedCaller]'s known values, as well as an [_UNKNOWN] member.
+             *
+             * An instance of [AllowedCaller] can contain an unknown value in a couple of cases:
+             * - It was deserialized from data that doesn't match any known member. For example, if
+             *   the SDK is on an older version than the API, then the API may respond with new
+             *   members that the SDK is unaware of.
+             * - It was constructed with an arbitrary value using the [of] method.
+             */
+            enum class Value {
+                DIRECT,
+                PROGRAMMATIC,
+                /**
+                 * An enum member indicating that [AllowedCaller] was instantiated with an unknown
+                 * value.
+                 */
+                _UNKNOWN,
+            }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value, or
+             * [Value._UNKNOWN] if the class was instantiated with an unknown value.
+             *
+             * Use the [known] method instead if you're certain the value is always known or if you
+             * want to throw for the unknown case.
+             */
+            fun value(): Value =
+                when (this) {
+                    DIRECT -> Value.DIRECT
+                    PROGRAMMATIC -> Value.PROGRAMMATIC
+                    else -> Value._UNKNOWN
+                }
+
+            /**
+             * Returns an enum member corresponding to this class instance's value.
+             *
+             * Use the [value] method instead if you're uncertain the value is always known and
+             * don't want to throw for the unknown case.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+             *   member.
+             */
+            fun known(): Known =
+                when (this) {
+                    DIRECT -> Known.DIRECT
+                    PROGRAMMATIC -> Known.PROGRAMMATIC
+                    else -> throw OpenAIInvalidDataException("Unknown AllowedCaller: $value")
+                }
+
+            /**
+             * Returns this class instance's primitive wire representation.
+             *
+             * This differs from the [toString] method because that method is primarily for
+             * debugging and generally doesn't throw.
+             *
+             * @throws OpenAIInvalidDataException if this class instance's value does not have the
+             *   expected primitive type.
+             */
+            fun asString(): String =
+                _value().asString().orElseThrow {
+                    OpenAIInvalidDataException("Value is not a String")
+                }
+
+            private var validated: Boolean = false
+
+            /**
+             * Validates that the types of all values in this object match their expected types
+             * recursively.
+             *
+             * This method is _not_ forwards compatible with new types from the API for existing
+             * fields.
+             *
+             * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+             *   expected type.
+             */
+            fun validate(): AllowedCaller = apply {
+                if (validated) {
+                    return@apply
+                }
+
+                known()
+                validated = true
+            }
+
+            fun isValid(): Boolean =
+                try {
+                    validate()
+                    true
+                } catch (e: OpenAIInvalidDataException) {
+                    false
+                }
+
+            /**
+             * Returns a score indicating how many valid values are contained in this object
+             * recursively.
+             *
+             * Used for best match union deserialization.
+             */
+            @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+            override fun equals(other: Any?): Boolean {
+                if (this === other) {
+                    return true
+                }
+
+                return other is AllowedCaller && value == other.value
+            }
+
+            override fun hashCode() = value.hashCode()
+
+            override fun toString() = value.toString()
+        }
+
         override fun equals(other: Any?): Boolean {
             if (this === other) {
                 return true
@@ -4553,15 +5003,18 @@ private constructor(
             return other is CodeInterpreter &&
                 container == other.container &&
                 type == other.type &&
+                allowedCallers == other.allowedCallers &&
                 additionalProperties == other.additionalProperties
         }
 
-        private val hashCode: Int by lazy { Objects.hash(container, type, additionalProperties) }
+        private val hashCode: Int by lazy {
+            Objects.hash(container, type, allowedCallers, additionalProperties)
+        }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "CodeInterpreter{container=$container, type=$type, additionalProperties=$additionalProperties}"
+            "CodeInterpreter{container=$container, type=$type, allowedCallers=$allowedCallers, additionalProperties=$additionalProperties}"
     }
 
     /** A tool that generates images using the GPT image models. */
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/inputitems/InputItemListPage.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/inputitems/InputItemListPage.kt
index 20a5b437b..e957029c1 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/inputitems/InputItemListPage.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/inputitems/InputItemListPage.kt
@@ -112,6 +112,14 @@ private constructor(
                                 reasoning: ResponseReasoningItem
                             ): Optional<String> = reasoning._id().getOptional("id")
 
+                            override fun visitProgram(
+                                program: ResponseItem.Program
+                            ): Optional<String> = program._id().getOptional("id")
+
+                            override fun visitProgramOutput(
+                                programOutput: ResponseItem.ProgramOutput
+                            ): Optional<String> = programOutput._id().getOptional("id")
+
                             override fun visitCompaction(
                                 compaction: ResponseCompactionItem
                             ): Optional<String> = compaction._id().getOptional("id")
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/inputitems/InputItemListPageAsync.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/inputitems/InputItemListPageAsync.kt
index fd777ef67..93054a45e 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/inputitems/InputItemListPageAsync.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/inputitems/InputItemListPageAsync.kt
@@ -115,6 +115,14 @@ private constructor(
                                 reasoning: ResponseReasoningItem
                             ): Optional<String> = reasoning._id().getOptional("id")
 
+                            override fun visitProgram(
+                                program: ResponseItem.Program
+                            ): Optional<String> = program._id().getOptional("id")
+
+                            override fun visitProgramOutput(
+                                programOutput: ResponseItem.ProgramOutput
+                            ): Optional<String> = programOutput._id().getOptional("id")
+
                             override fun visitCompaction(
                                 compaction: ResponseCompactionItem
                             ): Optional<String> = compaction._id().getOptional("id")
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/inputitems/ResponseItemList.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/inputitems/ResponseItemList.kt
index 8fe286f95..bab68444f 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/inputitems/ResponseItemList.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/inputitems/ResponseItemList.kt
@@ -265,6 +265,13 @@ private constructor(
         /** Alias for calling [addData] with `ResponseItem.ofReasoning(reasoning)`. */
         fun addData(reasoning: ResponseReasoningItem) = addData(ResponseItem.ofReasoning(reasoning))
 
+        /** Alias for calling [addData] with `ResponseItem.ofProgram(program)`. */
+        fun addData(program: ResponseItem.Program) = addData(ResponseItem.ofProgram(program))
+
+        /** Alias for calling [addData] with `ResponseItem.ofProgramOutput(programOutput)`. */
+        fun addData(programOutput: ResponseItem.ProgramOutput) =
+            addData(ResponseItem.ofProgramOutput(programOutput))
+
         /** Alias for calling [addData] with `ResponseItem.ofCompaction(compaction)`. */
         fun addData(compaction: ResponseCompactionItem) =
             addData(ResponseItem.ofCompaction(compaction))
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/inputtokens/InputTokenCountParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/inputtokens/InputTokenCountParams.kt
index bbc637a89..1cab0eda2 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/inputtokens/InputTokenCountParams.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/inputtokens/InputTokenCountParams.kt
@@ -569,6 +569,14 @@ private constructor(
         /** Alias for calling [toolChoice] with `ToolChoice.ofCustom(custom)`. */
         fun toolChoice(custom: ToolChoiceCustom) = apply { body.toolChoice(custom) }
 
+        /**
+         * Alias for calling [toolChoice] with
+         * `ToolChoice.ofSpecificProgrammaticToolCallingParam()`.
+         */
+        fun toolChoiceSpecificProgrammaticToolCallingParam() = apply {
+            body.toolChoiceSpecificProgrammaticToolCallingParam()
+        }
+
         /** Alias for calling [toolChoice] with `ToolChoice.ofApplyPatch(applyPatch)`. */
         fun toolChoice(applyPatch: ToolChoiceApplyPatch) = apply { body.toolChoice(applyPatch) }
 
@@ -671,6 +679,9 @@ private constructor(
             codeInterpreterToolAuto: Tool.CodeInterpreter.Container.CodeInterpreterToolAuto
         ) = apply { body.addCodeInterpreterTool(codeInterpreterToolAuto) }
 
+        /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+        fun addToolProgrammaticToolCalling() = apply { body.addToolProgrammaticToolCalling() }
+
         /** Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`. */
         fun addTool(imageGeneration: Tool.ImageGeneration) = apply { body.addTool(imageGeneration) }
 
@@ -1462,6 +1473,13 @@ private constructor(
             /** Alias for calling [toolChoice] with `ToolChoice.ofCustom(custom)`. */
             fun toolChoice(custom: ToolChoiceCustom) = toolChoice(ToolChoice.ofCustom(custom))
 
+            /**
+             * Alias for calling [toolChoice] with
+             * `ToolChoice.ofSpecificProgrammaticToolCallingParam()`.
+             */
+            fun toolChoiceSpecificProgrammaticToolCallingParam() =
+                toolChoice(ToolChoice.ofSpecificProgrammaticToolCallingParam())
+
             /** Alias for calling [toolChoice] with `ToolChoice.ofApplyPatch(applyPatch)`. */
             fun toolChoice(applyPatch: ToolChoiceApplyPatch) =
                 toolChoice(ToolChoice.ofApplyPatch(applyPatch))
@@ -1577,6 +1595,9 @@ private constructor(
                     )
                 )
 
+            /** Alias for calling [addTool] with `Tool.ofProgrammaticToolCalling()`. */
+            fun addToolProgrammaticToolCalling() = addTool(Tool.ofProgrammaticToolCalling())
+
             /** Alias for calling [addTool] with `Tool.ofImageGeneration(imageGeneration)`. */
             fun addTool(imageGeneration: Tool.ImageGeneration) =
                 addTool(Tool.ofImageGeneration(imageGeneration))
@@ -2805,6 +2826,7 @@ private constructor(
         private val function: ToolChoiceFunction? = null,
         private val mcp: ToolChoiceMcp? = null,
         private val custom: ToolChoiceCustom? = null,
+        private val specificProgrammaticToolCallingParam: JsonValue? = null,
         private val applyPatch: ToolChoiceApplyPatch? = null,
         private val shell: ToolChoiceShell? = null,
         private val _json: JsonValue? = null,
@@ -2840,6 +2862,9 @@ private constructor(
         /** Use this option to force the model to call a specific custom tool. */
         fun custom(): Optional<ToolChoiceCustom> = Optional.ofNullable(custom)
 
+        fun specificProgrammaticToolCallingParam(): Optional<JsonValue> =
+            Optional.ofNullable(specificProgrammaticToolCallingParam)
+
         /** Forces the model to call the apply_patch tool when executing a tool call. */
         fun applyPatch(): Optional<ToolChoiceApplyPatch> = Optional.ofNullable(applyPatch)
 
@@ -2858,6 +2883,9 @@ private constructor(
 
         fun isCustom(): Boolean = custom != null
 
+        fun isSpecificProgrammaticToolCallingParam(): Boolean =
+            specificProgrammaticToolCallingParam != null
+
         fun isApplyPatch(): Boolean = applyPatch != null
 
         fun isShell(): Boolean = shell != null
@@ -2892,6 +2920,9 @@ private constructor(
         /** Use this option to force the model to call a specific custom tool. */
         fun asCustom(): ToolChoiceCustom = custom.getOrThrow("custom")
 
+        fun asSpecificProgrammaticToolCallingParam(): JsonValue =
+            specificProgrammaticToolCallingParam.getOrThrow("specificProgrammaticToolCallingParam")
+
         /** Forces the model to call the apply_patch tool when executing a tool call. */
         fun asApplyPatch(): ToolChoiceApplyPatch = applyPatch.getOrThrow("applyPatch")
 
@@ -2937,6 +2968,10 @@ private constructor(
                 function != null -> visitor.visitFunction(function)
                 mcp != null -> visitor.visitMcp(mcp)
                 custom != null -> visitor.visitCustom(custom)
+                specificProgrammaticToolCallingParam != null ->
+                    visitor.visitSpecificProgrammaticToolCallingParam(
+                        specificProgrammaticToolCallingParam
+                    )
                 applyPatch != null -> visitor.visitApplyPatch(applyPatch)
                 shell != null -> visitor.visitShell(shell)
                 else -> visitor.unknown(_json)
@@ -2984,6 +3019,20 @@ private constructor(
                         custom.validate()
                     }
 
+                    override fun visitSpecificProgrammaticToolCallingParam(
+                        specificProgrammaticToolCallingParam: JsonValue
+                    ) {
+                        specificProgrammaticToolCallingParam.let {
+                            if (
+                                it != JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                            ) {
+                                throw OpenAIInvalidDataException(
+                                    "'specificProgrammaticToolCallingParam' is invalid, received $it"
+                                )
+                            }
+                        }
+                    }
+
                     override fun visitApplyPatch(applyPatch: ToolChoiceApplyPatch) {
                         applyPatch.validate()
                     }
@@ -3026,6 +3075,15 @@ private constructor(
 
                     override fun visitCustom(custom: ToolChoiceCustom) = custom.validity()
 
+                    override fun visitSpecificProgrammaticToolCallingParam(
+                        specificProgrammaticToolCallingParam: JsonValue
+                    ) =
+                        specificProgrammaticToolCallingParam.let {
+                            if (it == JsonValue.from(mapOf("type" to "programmatic_tool_calling")))
+                                1
+                            else 0
+                        }
+
                     override fun visitApplyPatch(applyPatch: ToolChoiceApplyPatch) =
                         applyPatch.validity()
 
@@ -3047,12 +3105,24 @@ private constructor(
                 function == other.function &&
                 mcp == other.mcp &&
                 custom == other.custom &&
+                specificProgrammaticToolCallingParam ==
+                    other.specificProgrammaticToolCallingParam &&
                 applyPatch == other.applyPatch &&
                 shell == other.shell
         }
 
         override fun hashCode(): Int =
-            Objects.hash(options, allowed, types, function, mcp, custom, applyPatch, shell)
+            Objects.hash(
+                options,
+                allowed,
+                types,
+                function,
+                mcp,
+                custom,
+                specificProgrammaticToolCallingParam,
+                applyPatch,
+                shell,
+            )
 
         override fun toString(): String =
             when {
@@ -3062,6 +3132,8 @@ private constructor(
                 function != null -> "ToolChoice{function=$function}"
                 mcp != null -> "ToolChoice{mcp=$mcp}"
                 custom != null -> "ToolChoice{custom=$custom}"
+                specificProgrammaticToolCallingParam != null ->
+                    "ToolChoice{specificProgrammaticToolCallingParam=$specificProgrammaticToolCallingParam}"
                 applyPatch != null -> "ToolChoice{applyPatch=$applyPatch}"
                 shell != null -> "ToolChoice{shell=$shell}"
                 _json != null -> "ToolChoice{_unknown=$_json}"
@@ -3103,6 +3175,13 @@ private constructor(
             /** Use this option to force the model to call a specific custom tool. */
             @JvmStatic fun ofCustom(custom: ToolChoiceCustom) = ToolChoice(custom = custom)
 
+            @JvmStatic
+            fun ofSpecificProgrammaticToolCallingParam() =
+                ToolChoice(
+                    specificProgrammaticToolCallingParam =
+                        JsonValue.from(mapOf("type" to "programmatic_tool_calling"))
+                )
+
             /** Forces the model to call the apply_patch tool when executing a tool call. */
             @JvmStatic
             fun ofApplyPatch(applyPatch: ToolChoiceApplyPatch) = ToolChoice(applyPatch = applyPatch)
@@ -3148,6 +3227,10 @@ private constructor(
             /** Use this option to force the model to call a specific custom tool. */
             fun visitCustom(custom: ToolChoiceCustom): T
 
+            fun visitSpecificProgrammaticToolCallingParam(
+                specificProgrammaticToolCallingParam: JsonValue
+            ): T
+
             /** Forces the model to call the apply_patch tool when executing a tool call. */
             fun visitApplyPatch(applyPatch: ToolChoiceApplyPatch): T
 
@@ -3176,6 +3259,14 @@ private constructor(
 
                 val bestMatches =
                     sequenceOf(
+                            tryDeserialize(node, jacksonTypeRef<JsonValue>())
+                                ?.let {
+                                    ToolChoice(
+                                        specificProgrammaticToolCallingParam = it,
+                                        _json = json,
+                                    )
+                                }
+                                ?.takeIf { it.isValid() },
                             tryDeserialize(node, jacksonTypeRef<ToolChoiceOptions>())?.let {
                                 ToolChoice(options = it, _json = json)
                             },
@@ -3231,6 +3322,8 @@ private constructor(
                     value.function != null -> generator.writeObject(value.function)
                     value.mcp != null -> generator.writeObject(value.mcp)
                     value.custom != null -> generator.writeObject(value.custom)
+                    value.specificProgrammaticToolCallingParam != null ->
+                        generator.writeObject(value.specificProgrammaticToolCallingParam)
                     value.applyPatch != null -> generator.writeObject(value.applyPatch)
                     value.shell != null -> generator.writeObject(value.shell)
                     value._json != null -> generator.writeObject(value._json)
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/webhooks/SafetyIdentifierBlockedWebhookEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/webhooks/SafetyIdentifierBlockedWebhookEvent.kt
new file mode 100644
index 000000000..94fbbf03a
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/models/webhooks/SafetyIdentifierBlockedWebhookEvent.kt
@@ -0,0 +1,809 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.webhooks
+
+import com.fasterxml.jackson.annotation.JsonAnyGetter
+import com.fasterxml.jackson.annotation.JsonAnySetter
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.fasterxml.jackson.annotation.JsonProperty
+import com.openai.core.Enum
+import com.openai.core.ExcludeMissing
+import com.openai.core.JsonField
+import com.openai.core.JsonMissing
+import com.openai.core.JsonValue
+import com.openai.core.checkRequired
+import com.openai.errors.OpenAIInvalidDataException
+import java.util.Collections
+import java.util.Objects
+import java.util.Optional
+import kotlin.jvm.optionals.getOrNull
+
+/** Sent when a request associated with a safety identifier has been blocked. */
+class SafetyIdentifierBlockedWebhookEvent
+@JsonCreator(mode = JsonCreator.Mode.DISABLED)
+private constructor(
+    private val id: JsonField<String>,
+    private val createdAt: JsonField<Long>,
+    private val data: JsonField<Data>,
+    private val type: JsonValue,
+    private val object_: JsonField<Object>,
+    private val additionalProperties: MutableMap<String, JsonValue>,
+) {
+
+    @JsonCreator
+    private constructor(
+        @JsonProperty("id") @ExcludeMissing id: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("created_at") @ExcludeMissing createdAt: JsonField<Long> = JsonMissing.of(),
+        @JsonProperty("data") @ExcludeMissing data: JsonField<Data> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
+        @JsonProperty("object") @ExcludeMissing object_: JsonField<Object> = JsonMissing.of(),
+    ) : this(id, createdAt, data, type, object_, mutableMapOf())
+
+    /**
+     * The unique ID of the event.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun id(): String = id.getRequired("id")
+
+    /**
+     * The Unix timestamp (in seconds) of when the request was blocked.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun createdAt(): Long = createdAt.getRequired("created_at")
+
+    /**
+     * Event data payload.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+     *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+     */
+    fun data(): Data = data.getRequired("data")
+
+    /**
+     * The type of the event. Always `safety_identifier.blocked`.
+     *
+     * Expected to always return the following:
+     * ```java
+     * JsonValue.from("safety_identifier.blocked")
+     * ```
+     *
+     * However, this method can be useful for debugging and logging (e.g. if the server responded
+     * with an unexpected value).
+     */
+    @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
+
+    /**
+     * The object of the event. Always `event`.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun object_(): Optional<Object> = object_.getOptional("object")
+
+    /**
+     * Returns the raw JSON value of [id].
+     *
+     * Unlike [id], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("id") @ExcludeMissing fun _id(): JsonField<String> = id
+
+    /**
+     * Returns the raw JSON value of [createdAt].
+     *
+     * Unlike [createdAt], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("created_at") @ExcludeMissing fun _createdAt(): JsonField<Long> = createdAt
+
+    /**
+     * Returns the raw JSON value of [data].
+     *
+     * Unlike [data], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("data") @ExcludeMissing fun _data(): JsonField<Data> = data
+
+    /**
+     * Returns the raw JSON value of [object_].
+     *
+     * Unlike [object_], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("object") @ExcludeMissing fun _object_(): JsonField<Object> = object_
+
+    @JsonAnySetter
+    private fun putAdditionalProperty(key: String, value: JsonValue) {
+        additionalProperties.put(key, value)
+    }
+
+    @JsonAnyGetter
+    @ExcludeMissing
+    fun _additionalProperties(): Map<String, JsonValue> =
+        Collections.unmodifiableMap(additionalProperties)
+
+    fun toBuilder() = Builder().from(this)
+
+    companion object {
+
+        /**
+         * Returns a mutable builder for constructing an instance of
+         * [SafetyIdentifierBlockedWebhookEvent].
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .createdAt()
+         * .data()
+         * ```
+         */
+        @JvmStatic fun builder() = Builder()
+    }
+
+    /** A builder for [SafetyIdentifierBlockedWebhookEvent]. */
+    class Builder internal constructor() {
+
+        private var id: JsonField<String>? = null
+        private var createdAt: JsonField<Long>? = null
+        private var data: JsonField<Data>? = null
+        private var type: JsonValue = JsonValue.from("safety_identifier.blocked")
+        private var object_: JsonField<Object> = JsonMissing.of()
+        private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+        @JvmSynthetic
+        internal fun from(
+            safetyIdentifierBlockedWebhookEvent: SafetyIdentifierBlockedWebhookEvent
+        ) = apply {
+            id = safetyIdentifierBlockedWebhookEvent.id
+            createdAt = safetyIdentifierBlockedWebhookEvent.createdAt
+            data = safetyIdentifierBlockedWebhookEvent.data
+            type = safetyIdentifierBlockedWebhookEvent.type
+            object_ = safetyIdentifierBlockedWebhookEvent.object_
+            additionalProperties =
+                safetyIdentifierBlockedWebhookEvent.additionalProperties.toMutableMap()
+        }
+
+        /** The unique ID of the event. */
+        fun id(id: String) = id(JsonField.of(id))
+
+        /**
+         * Sets [Builder.id] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.id] with a well-typed [String] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun id(id: JsonField<String>) = apply { this.id = id }
+
+        /** The Unix timestamp (in seconds) of when the request was blocked. */
+        fun createdAt(createdAt: Long) = createdAt(JsonField.of(createdAt))
+
+        /**
+         * Sets [Builder.createdAt] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.createdAt] with a well-typed [Long] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun createdAt(createdAt: JsonField<Long>) = apply { this.createdAt = createdAt }
+
+        /** Event data payload. */
+        fun data(data: Data) = data(JsonField.of(data))
+
+        /**
+         * Sets [Builder.data] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.data] with a well-typed [Data] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun data(data: JsonField<Data>) = apply { this.data = data }
+
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("safety_identifier.blocked")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
+        /** The object of the event. Always `event`. */
+        fun object_(object_: Object) = object_(JsonField.of(object_))
+
+        /**
+         * Sets [Builder.object_] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.object_] with a well-typed [Object] value instead. This
+         * method is primarily for setting the field to an undocumented or not yet supported value.
+         */
+        fun object_(object_: JsonField<Object>) = apply { this.object_ = object_ }
+
+        fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.clear()
+            putAllAdditionalProperties(additionalProperties)
+        }
+
+        fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+            additionalProperties.put(key, value)
+        }
+
+        fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+            this.additionalProperties.putAll(additionalProperties)
+        }
+
+        fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+        fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+            keys.forEach(::removeAdditionalProperty)
+        }
+
+        /**
+         * Returns an immutable instance of [SafetyIdentifierBlockedWebhookEvent].
+         *
+         * Further updates to this [Builder] will not mutate the returned instance.
+         *
+         * The following fields are required:
+         * ```java
+         * .id()
+         * .createdAt()
+         * .data()
+         * ```
+         *
+         * @throws IllegalStateException if any required field is unset.
+         */
+        fun build(): SafetyIdentifierBlockedWebhookEvent =
+            SafetyIdentifierBlockedWebhookEvent(
+                checkRequired("id", id),
+                checkRequired("createdAt", createdAt),
+                checkRequired("data", data),
+                type,
+                object_,
+                additionalProperties.toMutableMap(),
+            )
+    }
+
+    private var validated: Boolean = false
+
+    /**
+     * Validates that the types of all values in this object match their expected types recursively.
+     *
+     * This method is _not_ forwards compatible with new types from the API for existing fields.
+     *
+     * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+     *   expected type.
+     */
+    fun validate(): SafetyIdentifierBlockedWebhookEvent = apply {
+        if (validated) {
+            return@apply
+        }
+
+        id()
+        createdAt()
+        data().validate()
+        _type().let {
+            if (it != JsonValue.from("safety_identifier.blocked")) {
+                throw OpenAIInvalidDataException("'type' is invalid, received $it")
+            }
+        }
+        object_().ifPresent { it.validate() }
+        validated = true
+    }
+
+    fun isValid(): Boolean =
+        try {
+            validate()
+            true
+        } catch (e: OpenAIInvalidDataException) {
+            false
+        }
+
+    /**
+     * Returns a score indicating how many valid values are contained in this object recursively.
+     *
+     * Used for best match union deserialization.
+     */
+    @JvmSynthetic
+    internal fun validity(): Int =
+        (if (id.asKnown().isPresent) 1 else 0) +
+            (if (createdAt.asKnown().isPresent) 1 else 0) +
+            (data.asKnown().getOrNull()?.validity() ?: 0) +
+            type.let { if (it == JsonValue.from("safety_identifier.blocked")) 1 else 0 } +
+            (object_.asKnown().getOrNull()?.validity() ?: 0)
+
+    /** Event data payload. */
+    class Data
+    @JsonCreator(mode = JsonCreator.Mode.DISABLED)
+    private constructor(
+        private val safetyCategory: JsonField<String>,
+        private val safetyIdentifier: JsonField<String>,
+        private val model: JsonField<String>,
+        private val projectId: JsonField<String>,
+        private val requestId: JsonField<String>,
+        private val additionalProperties: MutableMap<String, JsonValue>,
+    ) {
+
+        @JsonCreator
+        private constructor(
+            @JsonProperty("safety_category")
+            @ExcludeMissing
+            safetyCategory: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("safety_identifier")
+            @ExcludeMissing
+            safetyIdentifier: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("model") @ExcludeMissing model: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("project_id")
+            @ExcludeMissing
+            projectId: JsonField<String> = JsonMissing.of(),
+            @JsonProperty("request_id")
+            @ExcludeMissing
+            requestId: JsonField<String> = JsonMissing.of(),
+        ) : this(safetyCategory, safetyIdentifier, model, projectId, requestId, mutableMapOf())
+
+        /**
+         * The safety category that triggered the block, such as `bio` or `cyber`.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun safetyCategory(): String = safetyCategory.getRequired("safety_category")
+
+        /**
+         * The stable safety identifier associated with the blocked request.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type or is
+         *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
+         */
+        fun safetyIdentifier(): String = safetyIdentifier.getRequired("safety_identifier")
+
+        /**
+         * The model used for the blocked request, if available.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun model(): Optional<String> = model.getOptional("model")
+
+        /**
+         * The project associated with the blocked request, if available.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun projectId(): Optional<String> = projectId.getOptional("project_id")
+
+        /**
+         * The OpenAI request ID for the blocked request, if available.
+         *
+         * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+         *   server responded with an unexpected value).
+         */
+        fun requestId(): Optional<String> = requestId.getOptional("request_id")
+
+        /**
+         * Returns the raw JSON value of [safetyCategory].
+         *
+         * Unlike [safetyCategory], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("safety_category")
+        @ExcludeMissing
+        fun _safetyCategory(): JsonField<String> = safetyCategory
+
+        /**
+         * Returns the raw JSON value of [safetyIdentifier].
+         *
+         * Unlike [safetyIdentifier], this method doesn't throw if the JSON field has an unexpected
+         * type.
+         */
+        @JsonProperty("safety_identifier")
+        @ExcludeMissing
+        fun _safetyIdentifier(): JsonField<String> = safetyIdentifier
+
+        /**
+         * Returns the raw JSON value of [model].
+         *
+         * Unlike [model], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("model") @ExcludeMissing fun _model(): JsonField<String> = model
+
+        /**
+         * Returns the raw JSON value of [projectId].
+         *
+         * Unlike [projectId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("project_id") @ExcludeMissing fun _projectId(): JsonField<String> = projectId
+
+        /**
+         * Returns the raw JSON value of [requestId].
+         *
+         * Unlike [requestId], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("request_id") @ExcludeMissing fun _requestId(): JsonField<String> = requestId
+
+        @JsonAnySetter
+        private fun putAdditionalProperty(key: String, value: JsonValue) {
+            additionalProperties.put(key, value)
+        }
+
+        @JsonAnyGetter
+        @ExcludeMissing
+        fun _additionalProperties(): Map<String, JsonValue> =
+            Collections.unmodifiableMap(additionalProperties)
+
+        fun toBuilder() = Builder().from(this)
+
+        companion object {
+
+            /**
+             * Returns a mutable builder for constructing an instance of [Data].
+             *
+             * The following fields are required:
+             * ```java
+             * .safetyCategory()
+             * .safetyIdentifier()
+             * ```
+             */
+            @JvmStatic fun builder() = Builder()
+        }
+
+        /** A builder for [Data]. */
+        class Builder internal constructor() {
+
+            private var safetyCategory: JsonField<String>? = null
+            private var safetyIdentifier: JsonField<String>? = null
+            private var model: JsonField<String> = JsonMissing.of()
+            private var projectId: JsonField<String> = JsonMissing.of()
+            private var requestId: JsonField<String> = JsonMissing.of()
+            private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
+
+            @JvmSynthetic
+            internal fun from(data: Data) = apply {
+                safetyCategory = data.safetyCategory
+                safetyIdentifier = data.safetyIdentifier
+                model = data.model
+                projectId = data.projectId
+                requestId = data.requestId
+                additionalProperties = data.additionalProperties.toMutableMap()
+            }
+
+            /** The safety category that triggered the block, such as `bio` or `cyber`. */
+            fun safetyCategory(safetyCategory: String) =
+                safetyCategory(JsonField.of(safetyCategory))
+
+            /**
+             * Sets [Builder.safetyCategory] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.safetyCategory] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun safetyCategory(safetyCategory: JsonField<String>) = apply {
+                this.safetyCategory = safetyCategory
+            }
+
+            /** The stable safety identifier associated with the blocked request. */
+            fun safetyIdentifier(safetyIdentifier: String) =
+                safetyIdentifier(JsonField.of(safetyIdentifier))
+
+            /**
+             * Sets [Builder.safetyIdentifier] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.safetyIdentifier] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun safetyIdentifier(safetyIdentifier: JsonField<String>) = apply {
+                this.safetyIdentifier = safetyIdentifier
+            }
+
+            /** The model used for the blocked request, if available. */
+            fun model(model: String) = model(JsonField.of(model))
+
+            /**
+             * Sets [Builder.model] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.model] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun model(model: JsonField<String>) = apply { this.model = model }
+
+            /** The project associated with the blocked request, if available. */
+            fun projectId(projectId: String) = projectId(JsonField.of(projectId))
+
+            /**
+             * Sets [Builder.projectId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.projectId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun projectId(projectId: JsonField<String>) = apply { this.projectId = projectId }
+
+            /** The OpenAI request ID for the blocked request, if available. */
+            fun requestId(requestId: String) = requestId(JsonField.of(requestId))
+
+            /**
+             * Sets [Builder.requestId] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.requestId] with a well-typed [String] value instead.
+             * This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun requestId(requestId: JsonField<String>) = apply { this.requestId = requestId }
+
+            fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.clear()
+                putAllAdditionalProperties(additionalProperties)
+            }
+
+            fun putAdditionalProperty(key: String, value: JsonValue) = apply {
+                additionalProperties.put(key, value)
+            }
+
+            fun putAllAdditionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
+                this.additionalProperties.putAll(additionalProperties)
+            }
+
+            fun removeAdditionalProperty(key: String) = apply { additionalProperties.remove(key) }
+
+            fun removeAllAdditionalProperties(keys: Set<String>) = apply {
+                keys.forEach(::removeAdditionalProperty)
+            }
+
+            /**
+             * Returns an immutable instance of [Data].
+             *
+             * Further updates to this [Builder] will not mutate the returned instance.
+             *
+             * The following fields are required:
+             * ```java
+             * .safetyCategory()
+             * .safetyIdentifier()
+             * ```
+             *
+             * @throws IllegalStateException if any required field is unset.
+             */
+            fun build(): Data =
+                Data(
+                    checkRequired("safetyCategory", safetyCategory),
+                    checkRequired("safetyIdentifier", safetyIdentifier),
+                    model,
+                    projectId,
+                    requestId,
+                    additionalProperties.toMutableMap(),
+                )
+        }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Data = apply {
+            if (validated) {
+                return@apply
+            }
+
+            safetyCategory()
+            safetyIdentifier()
+            model()
+            projectId()
+            requestId()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic
+        internal fun validity(): Int =
+            (if (safetyCategory.asKnown().isPresent) 1 else 0) +
+                (if (safetyIdentifier.asKnown().isPresent) 1 else 0) +
+                (if (model.asKnown().isPresent) 1 else 0) +
+                (if (projectId.asKnown().isPresent) 1 else 0) +
+                (if (requestId.asKnown().isPresent) 1 else 0)
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Data &&
+                safetyCategory == other.safetyCategory &&
+                safetyIdentifier == other.safetyIdentifier &&
+                model == other.model &&
+                projectId == other.projectId &&
+                requestId == other.requestId &&
+                additionalProperties == other.additionalProperties
+        }
+
+        private val hashCode: Int by lazy {
+            Objects.hash(
+                safetyCategory,
+                safetyIdentifier,
+                model,
+                projectId,
+                requestId,
+                additionalProperties,
+            )
+        }
+
+        override fun hashCode(): Int = hashCode
+
+        override fun toString() =
+            "Data{safetyCategory=$safetyCategory, safetyIdentifier=$safetyIdentifier, model=$model, projectId=$projectId, requestId=$requestId, additionalProperties=$additionalProperties}"
+    }
+
+    /** The object of the event. Always `event`. */
+    class Object @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
+
+        /**
+         * Returns this class instance's raw value.
+         *
+         * This is usually only useful if this instance was deserialized from data that doesn't
+         * match any known member, and you want to know that value. For example, if the SDK is on an
+         * older version than the API, then the API may respond with new members that the SDK is
+         * unaware of.
+         */
+        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<String> = value
+
+        companion object {
+
+            @JvmField val EVENT = of("event")
+
+            @JvmStatic fun of(value: String) = Object(JsonField.of(value))
+        }
+
+        /** An enum containing [Object]'s known values. */
+        enum class Known {
+            EVENT
+        }
+
+        /**
+         * An enum containing [Object]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Object] can contain an unknown value in a couple of cases:
+         * - It was deserialized from data that doesn't match any known member. For example, if the
+         *   SDK is on an older version than the API, then the API may respond with new members that
+         *   the SDK is unaware of.
+         * - It was constructed with an arbitrary value using the [of] method.
+         */
+        enum class Value {
+            EVENT,
+            /** An enum member indicating that [Object] was instantiated with an unknown value. */
+            _UNKNOWN,
+        }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
+         * if the class was instantiated with an unknown value.
+         *
+         * Use the [known] method instead if you're certain the value is always known or if you want
+         * to throw for the unknown case.
+         */
+        fun value(): Value =
+            when (this) {
+                EVENT -> Value.EVENT
+                else -> Value._UNKNOWN
+            }
+
+        /**
+         * Returns an enum member corresponding to this class instance's value.
+         *
+         * Use the [value] method instead if you're uncertain the value is always known and don't
+         * want to throw for the unknown case.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                EVENT -> Known.EVENT
+                else -> throw OpenAIInvalidDataException("Unknown Object: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws OpenAIInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow { OpenAIInvalidDataException("Value is not a String") }
+
+        private var validated: Boolean = false
+
+        /**
+         * Validates that the types of all values in this object match their expected types
+         * recursively.
+         *
+         * This method is _not_ forwards compatible with new types from the API for existing fields.
+         *
+         * @throws OpenAIInvalidDataException if any value type in this object doesn't match its
+         *   expected type.
+         */
+        fun validate(): Object = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: OpenAIInvalidDataException) {
+                false
+            }
+
+        /**
+         * Returns a score indicating how many valid values are contained in this object
+         * recursively.
+         *
+         * Used for best match union deserialization.
+         */
+        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
+
+        override fun equals(other: Any?): Boolean {
+            if (this === other) {
+                return true
+            }
+
+            return other is Object && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) {
+            return true
+        }
+
+        return other is SafetyIdentifierBlockedWebhookEvent &&
+            id == other.id &&
+            createdAt == other.createdAt &&
+            data == other.data &&
+            type == other.type &&
+            object_ == other.object_ &&
+            additionalProperties == other.additionalProperties
+    }
+
+    private val hashCode: Int by lazy {
+        Objects.hash(id, createdAt, data, type, object_, additionalProperties)
+    }
+
+    override fun hashCode(): Int = hashCode
+
+    override fun toString() =
+        "SafetyIdentifierBlockedWebhookEvent{id=$id, createdAt=$createdAt, data=$data, type=$type, object_=$object_, additionalProperties=$additionalProperties}"
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/webhooks/UnwrapWebhookEvent.kt b/openai-java-core/src/main/kotlin/com/openai/models/webhooks/UnwrapWebhookEvent.kt
index b578ffa71..f28e265c7 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/webhooks/UnwrapWebhookEvent.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/webhooks/UnwrapWebhookEvent.kt
@@ -38,6 +38,7 @@ private constructor(
     private val responseCompleted: ResponseCompletedWebhookEvent? = null,
     private val responseFailed: ResponseFailedWebhookEvent? = null,
     private val responseIncomplete: ResponseIncompleteWebhookEvent? = null,
+    private val safetyIdentifierBlocked: SafetyIdentifierBlockedWebhookEvent? = null,
     private val _json: JsonValue? = null,
 ) {
 
@@ -95,6 +96,10 @@ private constructor(
     fun responseIncomplete(): Optional<ResponseIncompleteWebhookEvent> =
         Optional.ofNullable(responseIncomplete)
 
+    /** Sent when a request associated with a safety identifier has been blocked. */
+    fun safetyIdentifierBlocked(): Optional<SafetyIdentifierBlockedWebhookEvent> =
+        Optional.ofNullable(safetyIdentifierBlocked)
+
     fun isBatchCancelled(): Boolean = batchCancelled != null
 
     fun isBatchCompleted(): Boolean = batchCompleted != null
@@ -125,6 +130,8 @@ private constructor(
 
     fun isResponseIncomplete(): Boolean = responseIncomplete != null
 
+    fun isSafetyIdentifierBlocked(): Boolean = safetyIdentifierBlocked != null
+
     /** Sent when a batch API request has been cancelled. */
     fun asBatchCancelled(): BatchCancelledWebhookEvent = batchCancelled.getOrThrow("batchCancelled")
 
@@ -179,6 +186,10 @@ private constructor(
     fun asResponseIncomplete(): ResponseIncompleteWebhookEvent =
         responseIncomplete.getOrThrow("responseIncomplete")
 
+    /** Sent when a request associated with a safety identifier has been blocked. */
+    fun asSafetyIdentifierBlocked(): SafetyIdentifierBlockedWebhookEvent =
+        safetyIdentifierBlocked.getOrThrow("safetyIdentifierBlocked")
+
     fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
 
     /**
@@ -229,6 +240,8 @@ private constructor(
             responseCompleted != null -> visitor.visitResponseCompleted(responseCompleted)
             responseFailed != null -> visitor.visitResponseFailed(responseFailed)
             responseIncomplete != null -> visitor.visitResponseIncomplete(responseIncomplete)
+            safetyIdentifierBlocked != null ->
+                visitor.visitSafetyIdentifierBlocked(safetyIdentifierBlocked)
             else -> visitor.unknown(_json)
         }
 
@@ -322,6 +335,12 @@ private constructor(
                 ) {
                     responseIncomplete.validate()
                 }
+
+                override fun visitSafetyIdentifierBlocked(
+                    safetyIdentifierBlocked: SafetyIdentifierBlockedWebhookEvent
+                ) {
+                    safetyIdentifierBlocked.validate()
+                }
             }
         )
         validated = true
@@ -396,6 +415,10 @@ private constructor(
                     responseIncomplete: ResponseIncompleteWebhookEvent
                 ) = responseIncomplete.validity()
 
+                override fun visitSafetyIdentifierBlocked(
+                    safetyIdentifierBlocked: SafetyIdentifierBlockedWebhookEvent
+                ) = safetyIdentifierBlocked.validity()
+
                 override fun unknown(json: JsonValue?) = 0
             }
         )
@@ -420,7 +443,8 @@ private constructor(
             responseCancelled == other.responseCancelled &&
             responseCompleted == other.responseCompleted &&
             responseFailed == other.responseFailed &&
-            responseIncomplete == other.responseIncomplete
+            responseIncomplete == other.responseIncomplete &&
+            safetyIdentifierBlocked == other.safetyIdentifierBlocked
     }
 
     override fun hashCode(): Int =
@@ -440,6 +464,7 @@ private constructor(
             responseCompleted,
             responseFailed,
             responseIncomplete,
+            safetyIdentifierBlocked,
         )
 
     override fun toString(): String =
@@ -464,6 +489,8 @@ private constructor(
             responseFailed != null -> "UnwrapWebhookEvent{responseFailed=$responseFailed}"
             responseIncomplete != null ->
                 "UnwrapWebhookEvent{responseIncomplete=$responseIncomplete}"
+            safetyIdentifierBlocked != null ->
+                "UnwrapWebhookEvent{safetyIdentifierBlocked=$safetyIdentifierBlocked}"
             _json != null -> "UnwrapWebhookEvent{_unknown=$_json}"
             else -> throw IllegalStateException("Invalid UnwrapWebhookEvent")
         }
@@ -544,6 +571,12 @@ private constructor(
         @JvmStatic
         fun ofResponseIncomplete(responseIncomplete: ResponseIncompleteWebhookEvent) =
             UnwrapWebhookEvent(responseIncomplete = responseIncomplete)
+
+        /** Sent when a request associated with a safety identifier has been blocked. */
+        @JvmStatic
+        fun ofSafetyIdentifierBlocked(
+            safetyIdentifierBlocked: SafetyIdentifierBlockedWebhookEvent
+        ) = UnwrapWebhookEvent(safetyIdentifierBlocked = safetyIdentifierBlocked)
     }
 
     /**
@@ -601,6 +634,11 @@ private constructor(
         /** Sent when a background response has been interrupted. */
         fun visitResponseIncomplete(responseIncomplete: ResponseIncompleteWebhookEvent): T
 
+        /** Sent when a request associated with a safety identifier has been blocked. */
+        fun visitSafetyIdentifierBlocked(
+            safetyIdentifierBlocked: SafetyIdentifierBlockedWebhookEvent
+        ): T
+
         /**
          * Maps an unknown variant of [UnwrapWebhookEvent] to a value of type [T].
          *
@@ -704,6 +742,14 @@ private constructor(
                         ?.let { UnwrapWebhookEvent(responseIncomplete = it, _json = json) }
                         ?: UnwrapWebhookEvent(_json = json)
                 }
+                "safety_identifier.blocked" -> {
+                    return tryDeserialize(
+                            node,
+                            jacksonTypeRef<SafetyIdentifierBlockedWebhookEvent>(),
+                        )
+                        ?.let { UnwrapWebhookEvent(safetyIdentifierBlocked = it, _json = json) }
+                        ?: UnwrapWebhookEvent(_json = json)
+                }
             }
 
             return UnwrapWebhookEvent(_json = json)
@@ -737,6 +783,8 @@ private constructor(
                 value.responseCompleted != null -> generator.writeObject(value.responseCompleted)
                 value.responseFailed != null -> generator.writeObject(value.responseFailed)
                 value.responseIncomplete != null -> generator.writeObject(value.responseIncomplete)
+                value.safetyIdentifierBlocked != null ->
+                    generator.writeObject(value.safetyIdentifierBlocked)
                 value._json != null -> generator.writeObject(value._json)
                 else -> throw IllegalStateException("Invalid UnwrapWebhookEvent")
             }
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt b/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt
index c397c4244..41deb75b4 100644
--- a/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt
@@ -23,10 +23,6 @@ interface BetaServiceAsync {
      */
     fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaServiceAsync
 
-    @Deprecated(
-        "Realtime has now launched and is generally available. The old beta API is now deprecated."
-    )
-    fun realtime(): RealtimeServiceAsync
 
     fun chatkit(): ChatKitServiceAsync
 
@@ -47,10 +43,6 @@ interface BetaServiceAsync {
          */
         fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaServiceAsync.WithRawResponse
 
-        @Deprecated(
-            "Realtime has now launched and is generally available. The old beta API is now deprecated."
-        )
-        fun realtime(): RealtimeServiceAsync.WithRawResponse
 
         fun chatkit(): ChatKitServiceAsync.WithRawResponse
 
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsyncImpl.kt b/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsyncImpl.kt
index b14046b1d..d567c77ee 100644
--- a/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsyncImpl.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsyncImpl.kt
@@ -20,7 +20,6 @@ class BetaServiceAsyncImpl internal constructor(private val clientOptions: Clien
         WithRawResponseImpl(clientOptions)
     }
 
-    private val realtime: RealtimeServiceAsync by lazy { RealtimeServiceAsyncImpl(clientOptions) }
 
     private val chatkit: ChatKitServiceAsync by lazy { ChatKitServiceAsyncImpl(clientOptions) }
 
@@ -35,10 +34,6 @@ class BetaServiceAsyncImpl internal constructor(private val clientOptions: Clien
     override fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaServiceAsync =
         BetaServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
-    @Deprecated(
-        "Realtime has now launched and is generally available. The old beta API is now deprecated."
-    )
-    override fun realtime(): RealtimeServiceAsync = realtime
 
     override fun chatkit(): ChatKitServiceAsync = chatkit
 
@@ -52,9 +47,6 @@ class BetaServiceAsyncImpl internal constructor(private val clientOptions: Clien
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
         BetaServiceAsync.WithRawResponse {
 
-        private val realtime: RealtimeServiceAsync.WithRawResponse by lazy {
-            RealtimeServiceAsyncImpl.WithRawResponseImpl(clientOptions)
-        }
 
         private val chatkit: ChatKitServiceAsync.WithRawResponse by lazy {
             ChatKitServiceAsyncImpl.WithRawResponseImpl(clientOptions)
@@ -75,10 +67,6 @@ class BetaServiceAsyncImpl internal constructor(private val clientOptions: Clien
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
-        @Deprecated(
-            "Realtime has now launched and is generally available. The old beta API is now deprecated."
-        )
-        override fun realtime(): RealtimeServiceAsync.WithRawResponse = realtime
 
         override fun chatkit(): ChatKitServiceAsync.WithRawResponse = chatkit
 
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/async/beta/ResponseServiceAsync.kt b/openai-java-core/src/main/kotlin/com/openai/services/async/beta/ResponseServiceAsync.kt
new file mode 100644
index 000000000..a44b764fd
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/services/async/beta/ResponseServiceAsync.kt
@@ -0,0 +1,517 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.async.beta
+
+import com.google.errorprone.annotations.MustBeClosed
+import com.openai.core.ClientOptions
+import com.openai.core.RequestOptions
+import com.openai.core.http.AsyncStreamResponse
+import com.openai.core.http.HttpResponse
+import com.openai.core.http.HttpResponseFor
+import com.openai.core.http.StreamResponse
+import com.openai.models.beta.responses.BetaCompactedResponse
+import com.openai.models.beta.responses.BetaResponse
+import com.openai.models.beta.responses.BetaResponseStreamEvent
+import com.openai.models.beta.responses.ResponseCancelParams
+import com.openai.models.beta.responses.ResponseCompactParams
+import com.openai.models.beta.responses.ResponseCreateParams
+import com.openai.models.beta.responses.ResponseDeleteParams
+import com.openai.models.beta.responses.ResponseRetrieveParams
+import com.openai.services.async.beta.responses.InputItemServiceAsync
+import com.openai.services.async.beta.responses.InputTokenServiceAsync
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+interface ResponseServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): ResponseServiceAsync
+
+    fun inputItems(): InputItemServiceAsync
+
+    fun inputTokens(): InputTokenServiceAsync
+
+    /**
+     * Creates a model response. Provide [text](https://platform.openai.com/docs/guides/text) or
+     * [image](https://platform.openai.com/docs/guides/images) inputs to generate
+     * [text](https://platform.openai.com/docs/guides/text) or
+     * [JSON](https://platform.openai.com/docs/guides/structured-outputs) outputs. Have the model
+     * call your own [custom code](https://platform.openai.com/docs/guides/function-calling) or use
+     * built-in [tools](https://platform.openai.com/docs/guides/tools) like
+     * [web search](https://platform.openai.com/docs/guides/tools-web-search) or
+     * [file search](https://platform.openai.com/docs/guides/tools-file-search) to use your own data
+     * as input for the model's response.
+     */
+    fun create(): CompletableFuture<BetaResponse> = create(ResponseCreateParams.none())
+
+    /** @see create */
+    fun create(
+        params: ResponseCreateParams = ResponseCreateParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<BetaResponse>
+
+    /** @see create */
+    fun create(
+        params: ResponseCreateParams = ResponseCreateParams.none()
+    ): CompletableFuture<BetaResponse> = create(params, RequestOptions.none())
+
+    /** @see create */
+    fun create(requestOptions: RequestOptions): CompletableFuture<BetaResponse> =
+        create(ResponseCreateParams.none(), requestOptions)
+
+    /**
+     * Creates a model response. Provide [text](https://platform.openai.com/docs/guides/text) or
+     * [image](https://platform.openai.com/docs/guides/images) inputs to generate
+     * [text](https://platform.openai.com/docs/guides/text) or
+     * [JSON](https://platform.openai.com/docs/guides/structured-outputs) outputs. Have the model
+     * call your own [custom code](https://platform.openai.com/docs/guides/function-calling) or use
+     * built-in [tools](https://platform.openai.com/docs/guides/tools) like
+     * [web search](https://platform.openai.com/docs/guides/tools-web-search) or
+     * [file search](https://platform.openai.com/docs/guides/tools-file-search) to use your own data
+     * as input for the model's response.
+     */
+    fun createStreaming(): AsyncStreamResponse<BetaResponseStreamEvent> =
+        createStreaming(ResponseCreateParams.none())
+
+    /** @see createStreaming */
+    fun createStreaming(
+        params: ResponseCreateParams = ResponseCreateParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): AsyncStreamResponse<BetaResponseStreamEvent>
+
+    /** @see createStreaming */
+    fun createStreaming(
+        params: ResponseCreateParams = ResponseCreateParams.none()
+    ): AsyncStreamResponse<BetaResponseStreamEvent> = createStreaming(params, RequestOptions.none())
+
+    /** @see createStreaming */
+    fun createStreaming(
+        requestOptions: RequestOptions
+    ): AsyncStreamResponse<BetaResponseStreamEvent> =
+        createStreaming(ResponseCreateParams.none(), requestOptions)
+
+    /** Retrieves a model response with the given ID. */
+    fun retrieve(responseId: String): CompletableFuture<BetaResponse> =
+        retrieve(responseId, ResponseRetrieveParams.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        responseId: String,
+        params: ResponseRetrieveParams = ResponseRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<BetaResponse> =
+        retrieve(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(
+        responseId: String,
+        params: ResponseRetrieveParams = ResponseRetrieveParams.none(),
+    ): CompletableFuture<BetaResponse> = retrieve(responseId, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: ResponseRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<BetaResponse>
+
+    /** @see retrieve */
+    fun retrieve(params: ResponseRetrieveParams): CompletableFuture<BetaResponse> =
+        retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        responseId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<BetaResponse> =
+        retrieve(responseId, ResponseRetrieveParams.none(), requestOptions)
+
+    /** Retrieves a model response with the given ID. */
+    fun retrieveStreaming(responseId: String): AsyncStreamResponse<BetaResponseStreamEvent> =
+        retrieveStreaming(responseId, ResponseRetrieveParams.none())
+
+    /** @see retrieveStreaming */
+    fun retrieveStreaming(
+        responseId: String,
+        params: ResponseRetrieveParams = ResponseRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): AsyncStreamResponse<BetaResponseStreamEvent> =
+        retrieveStreaming(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+    /** @see retrieveStreaming */
+    fun retrieveStreaming(
+        responseId: String,
+        params: ResponseRetrieveParams = ResponseRetrieveParams.none(),
+    ): AsyncStreamResponse<BetaResponseStreamEvent> =
+        retrieveStreaming(responseId, params, RequestOptions.none())
+
+    /** @see retrieveStreaming */
+    fun retrieveStreaming(
+        params: ResponseRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): AsyncStreamResponse<BetaResponseStreamEvent>
+
+    /** @see retrieveStreaming */
+    fun retrieveStreaming(
+        params: ResponseRetrieveParams
+    ): AsyncStreamResponse<BetaResponseStreamEvent> =
+        retrieveStreaming(params, RequestOptions.none())
+
+    /** @see retrieveStreaming */
+    fun retrieveStreaming(
+        responseId: String,
+        requestOptions: RequestOptions,
+    ): AsyncStreamResponse<BetaResponseStreamEvent> =
+        retrieveStreaming(responseId, ResponseRetrieveParams.none(), requestOptions)
+
+    /** Deletes a model response with the given ID. */
+    fun delete(responseId: String): CompletableFuture<Void?> =
+        delete(responseId, ResponseDeleteParams.none())
+
+    /** @see delete */
+    fun delete(
+        responseId: String,
+        params: ResponseDeleteParams = ResponseDeleteParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<Void?> =
+        delete(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+    /** @see delete */
+    fun delete(
+        responseId: String,
+        params: ResponseDeleteParams = ResponseDeleteParams.none(),
+    ): CompletableFuture<Void?> = delete(responseId, params, RequestOptions.none())
+
+    /** @see delete */
+    fun delete(
+        params: ResponseDeleteParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<Void?>
+
+    /** @see delete */
+    fun delete(params: ResponseDeleteParams): CompletableFuture<Void?> =
+        delete(params, RequestOptions.none())
+
+    /** @see delete */
+    fun delete(responseId: String, requestOptions: RequestOptions): CompletableFuture<Void?> =
+        delete(responseId, ResponseDeleteParams.none(), requestOptions)
+
+    /**
+     * Cancels a model response with the given ID. Only responses created with the `background`
+     * parameter set to `true` can be cancelled.
+     * [Learn more](https://platform.openai.com/docs/guides/background).
+     */
+    fun cancel(responseId: String): CompletableFuture<BetaResponse> =
+        cancel(responseId, ResponseCancelParams.none())
+
+    /** @see cancel */
+    fun cancel(
+        responseId: String,
+        params: ResponseCancelParams = ResponseCancelParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<BetaResponse> =
+        cancel(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+    /** @see cancel */
+    fun cancel(
+        responseId: String,
+        params: ResponseCancelParams = ResponseCancelParams.none(),
+    ): CompletableFuture<BetaResponse> = cancel(responseId, params, RequestOptions.none())
+
+    /** @see cancel */
+    fun cancel(
+        params: ResponseCancelParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<BetaResponse>
+
+    /** @see cancel */
+    fun cancel(params: ResponseCancelParams): CompletableFuture<BetaResponse> =
+        cancel(params, RequestOptions.none())
+
+    /** @see cancel */
+    fun cancel(
+        responseId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<BetaResponse> =
+        cancel(responseId, ResponseCancelParams.none(), requestOptions)
+
+    /**
+     * Compact a conversation. Returns a compacted response object.
+     *
+     * Learn when and how to compact long-running conversations in the
+     * [conversation state guide](https://platform.openai.com/docs/guides/conversation-state#managing-the-context-window).
+     * For ZDR-compatible compaction details, see
+     * [Compaction (advanced)](https://platform.openai.com/docs/guides/conversation-state#compaction-advanced).
+     */
+    fun compact(params: ResponseCompactParams): CompletableFuture<BetaCompactedResponse> =
+        compact(params, RequestOptions.none())
+
+    /** @see compact */
+    fun compact(
+        params: ResponseCompactParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<BetaCompactedResponse>
+
+    /**
+     * A view of [ResponseServiceAsync] that provides access to raw HTTP responses for each method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): ResponseServiceAsync.WithRawResponse
+
+        fun inputItems(): InputItemServiceAsync.WithRawResponse
+
+        fun inputTokens(): InputTokenServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /responses?beta=true`, but is otherwise the same as
+         * [ResponseServiceAsync.create].
+         */
+        fun create(): CompletableFuture<HttpResponseFor<BetaResponse>> =
+            create(ResponseCreateParams.none())
+
+        /** @see create */
+        fun create(
+            params: ResponseCreateParams = ResponseCreateParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<BetaResponse>>
+
+        /** @see create */
+        fun create(
+            params: ResponseCreateParams = ResponseCreateParams.none()
+        ): CompletableFuture<HttpResponseFor<BetaResponse>> = create(params, RequestOptions.none())
+
+        /** @see create */
+        fun create(
+            requestOptions: RequestOptions
+        ): CompletableFuture<HttpResponseFor<BetaResponse>> =
+            create(ResponseCreateParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /responses?beta=true`, but is otherwise the same as
+         * [ResponseServiceAsync.createStreaming].
+         */
+        @MustBeClosed
+        fun createStreaming():
+            CompletableFuture<HttpResponseFor<StreamResponse<BetaResponseStreamEvent>>> =
+            createStreaming(ResponseCreateParams.none())
+
+        /** @see createStreaming */
+        @MustBeClosed
+        fun createStreaming(
+            params: ResponseCreateParams = ResponseCreateParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<StreamResponse<BetaResponseStreamEvent>>>
+
+        /** @see createStreaming */
+        @MustBeClosed
+        fun createStreaming(
+            params: ResponseCreateParams = ResponseCreateParams.none()
+        ): CompletableFuture<HttpResponseFor<StreamResponse<BetaResponseStreamEvent>>> =
+            createStreaming(params, RequestOptions.none())
+
+        /** @see createStreaming */
+        @MustBeClosed
+        fun createStreaming(
+            requestOptions: RequestOptions
+        ): CompletableFuture<HttpResponseFor<StreamResponse<BetaResponseStreamEvent>>> =
+            createStreaming(ResponseCreateParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /responses/{response_id}?beta=true`, but is
+         * otherwise the same as [ResponseServiceAsync.retrieve].
+         */
+        fun retrieve(responseId: String): CompletableFuture<HttpResponseFor<BetaResponse>> =
+            retrieve(responseId, ResponseRetrieveParams.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            responseId: String,
+            params: ResponseRetrieveParams = ResponseRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<BetaResponse>> =
+            retrieve(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+        /** @see retrieve */
+        fun retrieve(
+            responseId: String,
+            params: ResponseRetrieveParams = ResponseRetrieveParams.none(),
+        ): CompletableFuture<HttpResponseFor<BetaResponse>> =
+            retrieve(responseId, params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            params: ResponseRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<BetaResponse>>
+
+        /** @see retrieve */
+        fun retrieve(
+            params: ResponseRetrieveParams
+        ): CompletableFuture<HttpResponseFor<BetaResponse>> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        fun retrieve(
+            responseId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<BetaResponse>> =
+            retrieve(responseId, ResponseRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /responses/{response_id}?beta=true`, but is
+         * otherwise the same as [ResponseServiceAsync.retrieveStreaming].
+         */
+        @MustBeClosed
+        fun retrieveStreaming(
+            responseId: String
+        ): CompletableFuture<HttpResponseFor<StreamResponse<BetaResponseStreamEvent>>> =
+            retrieveStreaming(responseId, ResponseRetrieveParams.none())
+
+        /** @see retrieveStreaming */
+        @MustBeClosed
+        fun retrieveStreaming(
+            responseId: String,
+            params: ResponseRetrieveParams = ResponseRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<StreamResponse<BetaResponseStreamEvent>>> =
+            retrieveStreaming(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+        /** @see retrieveStreaming */
+        @MustBeClosed
+        fun retrieveStreaming(
+            responseId: String,
+            params: ResponseRetrieveParams = ResponseRetrieveParams.none(),
+        ): CompletableFuture<HttpResponseFor<StreamResponse<BetaResponseStreamEvent>>> =
+            retrieveStreaming(responseId, params, RequestOptions.none())
+
+        /** @see retrieveStreaming */
+        @MustBeClosed
+        fun retrieveStreaming(
+            params: ResponseRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<StreamResponse<BetaResponseStreamEvent>>>
+
+        /** @see retrieveStreaming */
+        @MustBeClosed
+        fun retrieveStreaming(
+            params: ResponseRetrieveParams
+        ): CompletableFuture<HttpResponseFor<StreamResponse<BetaResponseStreamEvent>>> =
+            retrieveStreaming(params, RequestOptions.none())
+
+        /** @see retrieveStreaming */
+        @MustBeClosed
+        fun retrieveStreaming(
+            responseId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<StreamResponse<BetaResponseStreamEvent>>> =
+            retrieveStreaming(responseId, ResponseRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `delete /responses/{response_id}?beta=true`, but is
+         * otherwise the same as [ResponseServiceAsync.delete].
+         */
+        fun delete(responseId: String): CompletableFuture<HttpResponse> =
+            delete(responseId, ResponseDeleteParams.none())
+
+        /** @see delete */
+        fun delete(
+            responseId: String,
+            params: ResponseDeleteParams = ResponseDeleteParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponse> =
+            delete(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+        /** @see delete */
+        fun delete(
+            responseId: String,
+            params: ResponseDeleteParams = ResponseDeleteParams.none(),
+        ): CompletableFuture<HttpResponse> = delete(responseId, params, RequestOptions.none())
+
+        /** @see delete */
+        fun delete(
+            params: ResponseDeleteParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponse>
+
+        /** @see delete */
+        fun delete(params: ResponseDeleteParams): CompletableFuture<HttpResponse> =
+            delete(params, RequestOptions.none())
+
+        /** @see delete */
+        fun delete(
+            responseId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponse> =
+            delete(responseId, ResponseDeleteParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /responses/{response_id}/cancel?beta=true`, but is
+         * otherwise the same as [ResponseServiceAsync.cancel].
+         */
+        fun cancel(responseId: String): CompletableFuture<HttpResponseFor<BetaResponse>> =
+            cancel(responseId, ResponseCancelParams.none())
+
+        /** @see cancel */
+        fun cancel(
+            responseId: String,
+            params: ResponseCancelParams = ResponseCancelParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<BetaResponse>> =
+            cancel(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+        /** @see cancel */
+        fun cancel(
+            responseId: String,
+            params: ResponseCancelParams = ResponseCancelParams.none(),
+        ): CompletableFuture<HttpResponseFor<BetaResponse>> =
+            cancel(responseId, params, RequestOptions.none())
+
+        /** @see cancel */
+        fun cancel(
+            params: ResponseCancelParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<BetaResponse>>
+
+        /** @see cancel */
+        fun cancel(params: ResponseCancelParams): CompletableFuture<HttpResponseFor<BetaResponse>> =
+            cancel(params, RequestOptions.none())
+
+        /** @see cancel */
+        fun cancel(
+            responseId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<BetaResponse>> =
+            cancel(responseId, ResponseCancelParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /responses/compact?beta=true`, but is otherwise the
+         * same as [ResponseServiceAsync.compact].
+         */
+        fun compact(
+            params: ResponseCompactParams
+        ): CompletableFuture<HttpResponseFor<BetaCompactedResponse>> =
+            compact(params, RequestOptions.none())
+
+        /** @see compact */
+        fun compact(
+            params: ResponseCompactParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<BetaCompactedResponse>>
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/async/beta/ResponseServiceAsyncImpl.kt b/openai-java-core/src/main/kotlin/com/openai/services/async/beta/ResponseServiceAsyncImpl.kt
new file mode 100644
index 000000000..9ac4eb375
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/services/async/beta/ResponseServiceAsyncImpl.kt
@@ -0,0 +1,418 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.async.beta
+
+import com.openai.core.ClientOptions
+import com.openai.core.JsonValue
+import com.openai.core.RequestOptions
+import com.openai.core.SecurityOptions
+import com.openai.core.checkRequired
+import com.openai.core.handlers.emptyHandler
+import com.openai.core.handlers.errorBodyHandler
+import com.openai.core.handlers.errorHandler
+import com.openai.core.handlers.jsonHandler
+import com.openai.core.handlers.mapJson
+import com.openai.core.handlers.sseHandler
+import com.openai.core.http.AsyncStreamResponse
+import com.openai.core.http.HttpMethod
+import com.openai.core.http.HttpRequest
+import com.openai.core.http.HttpResponse
+import com.openai.core.http.HttpResponse.Handler
+import com.openai.core.http.HttpResponseFor
+import com.openai.core.http.StreamResponse
+import com.openai.core.http.json
+import com.openai.core.http.map
+import com.openai.core.http.parseable
+import com.openai.core.http.toAsync
+import com.openai.core.prepareAsync
+import com.openai.models.beta.responses.BetaCompactedResponse
+import com.openai.models.beta.responses.BetaResponse
+import com.openai.models.beta.responses.BetaResponseStreamEvent
+import com.openai.models.beta.responses.ResponseCancelParams
+import com.openai.models.beta.responses.ResponseCompactParams
+import com.openai.models.beta.responses.ResponseCreateParams
+import com.openai.models.beta.responses.ResponseDeleteParams
+import com.openai.models.beta.responses.ResponseRetrieveParams
+import com.openai.services.async.beta.responses.InputItemServiceAsync
+import com.openai.services.async.beta.responses.InputItemServiceAsyncImpl
+import com.openai.services.async.beta.responses.InputTokenServiceAsync
+import com.openai.services.async.beta.responses.InputTokenServiceAsyncImpl
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+class ResponseServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    ResponseServiceAsync {
+
+    private val withRawResponse: ResponseServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    private val inputItems: InputItemServiceAsync by lazy {
+        InputItemServiceAsyncImpl(clientOptions)
+    }
+
+    private val inputTokens: InputTokenServiceAsync by lazy {
+        InputTokenServiceAsyncImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): ResponseServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): ResponseServiceAsync =
+        ResponseServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun inputItems(): InputItemServiceAsync = inputItems
+
+    override fun inputTokens(): InputTokenServiceAsync = inputTokens
+
+    override fun create(
+        params: ResponseCreateParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<BetaResponse> =
+        // post /responses?beta=true
+        withRawResponse().create(params, requestOptions).thenApply { it.parse() }
+
+    override fun createStreaming(
+        params: ResponseCreateParams,
+        requestOptions: RequestOptions,
+    ): AsyncStreamResponse<BetaResponseStreamEvent> =
+        // post /responses?beta=true
+        withRawResponse()
+            .createStreaming(params, requestOptions)
+            .thenApply { it.parse() }
+            .toAsync(clientOptions.streamHandlerExecutor)
+
+    override fun retrieve(
+        params: ResponseRetrieveParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<BetaResponse> =
+        // get /responses/{response_id}?beta=true
+        withRawResponse().retrieve(params, requestOptions).thenApply { it.parse() }
+
+    override fun retrieveStreaming(
+        params: ResponseRetrieveParams,
+        requestOptions: RequestOptions,
+    ): AsyncStreamResponse<BetaResponseStreamEvent> =
+        // get /responses/{response_id}?beta=true
+        withRawResponse()
+            .retrieveStreaming(params, requestOptions)
+            .thenApply { it.parse() }
+            .toAsync(clientOptions.streamHandlerExecutor)
+
+    override fun delete(
+        params: ResponseDeleteParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<Void?> =
+        // delete /responses/{response_id}?beta=true
+        withRawResponse().delete(params, requestOptions).thenAccept {}
+
+    override fun cancel(
+        params: ResponseCancelParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<BetaResponse> =
+        // post /responses/{response_id}/cancel?beta=true
+        withRawResponse().cancel(params, requestOptions).thenApply { it.parse() }
+
+    override fun compact(
+        params: ResponseCompactParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<BetaCompactedResponse> =
+        // post /responses/compact?beta=true
+        withRawResponse().compact(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        ResponseServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        private val inputItems: InputItemServiceAsync.WithRawResponse by lazy {
+            InputItemServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val inputTokens: InputTokenServiceAsync.WithRawResponse by lazy {
+            InputTokenServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): ResponseServiceAsync.WithRawResponse =
+            ResponseServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        override fun inputItems(): InputItemServiceAsync.WithRawResponse = inputItems
+
+        override fun inputTokens(): InputTokenServiceAsync.WithRawResponse = inputTokens
+
+        private val createHandler: Handler<BetaResponse> =
+            jsonHandler<BetaResponse>(clientOptions.jsonMapper)
+
+        override fun create(
+            params: ResponseCreateParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<BetaResponse>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses")
+                    .putQueryParam("beta", "true")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { createHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val createStreamingHandler: Handler<StreamResponse<BetaResponseStreamEvent>> =
+            sseHandler(clientOptions.jsonMapper).mapJson<BetaResponseStreamEvent>()
+
+        override fun createStreaming(
+            params: ResponseCreateParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<StreamResponse<BetaResponseStreamEvent>>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses")
+                    .putQueryParam("beta", "true")
+                    .putHeader("Accept", "text/event-stream")
+                    .body(
+                        json(
+                            clientOptions.jsonMapper,
+                            params
+                                ._body()
+                                .toBuilder()
+                                .putAdditionalProperty("stream", JsonValue.from(true))
+                                .build(),
+                        )
+                    )
+                    .build()
+                    .prepareAsync(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .let { createStreamingHandler.handle(it) }
+                            .let { streamResponse ->
+                                if (requestOptions.responseValidation!!) {
+                                    streamResponse.map { it.validate() }
+                                } else {
+                                    streamResponse
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val retrieveHandler: Handler<BetaResponse> =
+            jsonHandler<BetaResponse>(clientOptions.jsonMapper)
+
+        override fun retrieve(
+            params: ResponseRetrieveParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<BetaResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("responseId", params.responseId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses", params._pathParam(0))
+                    .putQueryParam("beta", "true")
+                    .build()
+                    .prepareAsync(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { retrieveHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val retrieveStreamingHandler: Handler<StreamResponse<BetaResponseStreamEvent>> =
+            sseHandler(clientOptions.jsonMapper).mapJson<BetaResponseStreamEvent>()
+
+        override fun retrieveStreaming(
+            params: ResponseRetrieveParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<StreamResponse<BetaResponseStreamEvent>>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("responseId", params.responseId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses", params._pathParam(0))
+                    .putAllQueryParams(mapOf("beta" to "true", "stream" to "true"))
+                    .putHeader("Accept", "text/event-stream")
+                    .build()
+                    .prepareAsync(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .let { retrieveStreamingHandler.handle(it) }
+                            .let { streamResponse ->
+                                if (requestOptions.responseValidation!!) {
+                                    streamResponse.map { it.validate() }
+                                } else {
+                                    streamResponse
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val deleteHandler: Handler<Void?> = emptyHandler()
+
+        override fun delete(
+            params: ResponseDeleteParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("responseId", params.responseId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses", params._pathParam(0))
+                    .putQueryParam("beta", "true")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepareAsync(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response.use { deleteHandler.handle(it) }
+                    }
+                }
+        }
+
+        private val cancelHandler: Handler<BetaResponse> =
+            jsonHandler<BetaResponse>(clientOptions.jsonMapper)
+
+        override fun cancel(
+            params: ResponseCancelParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<BetaResponse>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("responseId", params.responseId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses", params._pathParam(0), "cancel")
+                    .putQueryParam("beta", "true")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepareAsync(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { cancelHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+
+        private val compactHandler: Handler<BetaCompactedResponse> =
+            jsonHandler<BetaCompactedResponse>(clientOptions.jsonMapper)
+
+        override fun compact(
+            params: ResponseCompactParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<BetaCompactedResponse>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses", "compact")
+                    .putQueryParam("beta", "true")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { compactHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/async/beta/responses/InputItemServiceAsync.kt b/openai-java-core/src/main/kotlin/com/openai/services/async/beta/responses/InputItemServiceAsync.kt
new file mode 100644
index 000000000..80b422488
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/services/async/beta/responses/InputItemServiceAsync.kt
@@ -0,0 +1,117 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.async.beta.responses
+
+import com.openai.core.ClientOptions
+import com.openai.core.RequestOptions
+import com.openai.core.http.HttpResponseFor
+import com.openai.models.beta.responses.inputitems.InputItemListPageAsync
+import com.openai.models.beta.responses.inputitems.InputItemListParams
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+interface InputItemServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): InputItemServiceAsync
+
+    /** Returns a list of input items for a given response. */
+    fun list(responseId: String): CompletableFuture<InputItemListPageAsync> =
+        list(responseId, InputItemListParams.none())
+
+    /** @see list */
+    fun list(
+        responseId: String,
+        params: InputItemListParams = InputItemListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<InputItemListPageAsync> =
+        list(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+    /** @see list */
+    fun list(
+        responseId: String,
+        params: InputItemListParams = InputItemListParams.none(),
+    ): CompletableFuture<InputItemListPageAsync> = list(responseId, params, RequestOptions.none())
+
+    /** @see list */
+    fun list(
+        params: InputItemListParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<InputItemListPageAsync>
+
+    /** @see list */
+    fun list(params: InputItemListParams): CompletableFuture<InputItemListPageAsync> =
+        list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(
+        responseId: String,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<InputItemListPageAsync> =
+        list(responseId, InputItemListParams.none(), requestOptions)
+
+    /**
+     * A view of [InputItemServiceAsync] that provides access to raw HTTP responses for each method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): InputItemServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /responses/{response_id}/input_items?beta=true`, but
+         * is otherwise the same as [InputItemServiceAsync.list].
+         */
+        fun list(responseId: String): CompletableFuture<HttpResponseFor<InputItemListPageAsync>> =
+            list(responseId, InputItemListParams.none())
+
+        /** @see list */
+        fun list(
+            responseId: String,
+            params: InputItemListParams = InputItemListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<InputItemListPageAsync>> =
+            list(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+        /** @see list */
+        fun list(
+            responseId: String,
+            params: InputItemListParams = InputItemListParams.none(),
+        ): CompletableFuture<HttpResponseFor<InputItemListPageAsync>> =
+            list(responseId, params, RequestOptions.none())
+
+        /** @see list */
+        fun list(
+            params: InputItemListParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<InputItemListPageAsync>>
+
+        /** @see list */
+        fun list(
+            params: InputItemListParams
+        ): CompletableFuture<HttpResponseFor<InputItemListPageAsync>> =
+            list(params, RequestOptions.none())
+
+        /** @see list */
+        fun list(
+            responseId: String,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<InputItemListPageAsync>> =
+            list(responseId, InputItemListParams.none(), requestOptions)
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/async/beta/responses/InputItemServiceAsyncImpl.kt b/openai-java-core/src/main/kotlin/com/openai/services/async/beta/responses/InputItemServiceAsyncImpl.kt
new file mode 100644
index 000000000..d379173f7
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/services/async/beta/responses/InputItemServiceAsyncImpl.kt
@@ -0,0 +1,104 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.async.beta.responses
+
+import com.openai.core.ClientOptions
+import com.openai.core.RequestOptions
+import com.openai.core.SecurityOptions
+import com.openai.core.checkRequired
+import com.openai.core.handlers.errorBodyHandler
+import com.openai.core.handlers.errorHandler
+import com.openai.core.handlers.jsonHandler
+import com.openai.core.http.HttpMethod
+import com.openai.core.http.HttpRequest
+import com.openai.core.http.HttpResponse
+import com.openai.core.http.HttpResponse.Handler
+import com.openai.core.http.HttpResponseFor
+import com.openai.core.http.parseable
+import com.openai.core.prepareAsync
+import com.openai.models.beta.responses.inputitems.BetaResponseItemList
+import com.openai.models.beta.responses.inputitems.InputItemListPageAsync
+import com.openai.models.beta.responses.inputitems.InputItemListParams
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+class InputItemServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    InputItemServiceAsync {
+
+    private val withRawResponse: InputItemServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): InputItemServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): InputItemServiceAsync =
+        InputItemServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun list(
+        params: InputItemListParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<InputItemListPageAsync> =
+        // get /responses/{response_id}/input_items?beta=true
+        withRawResponse().list(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        InputItemServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): InputItemServiceAsync.WithRawResponse =
+            InputItemServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val listHandler: Handler<BetaResponseItemList> =
+            jsonHandler<BetaResponseItemList>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: InputItemListParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<InputItemListPageAsync>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("responseId", params.responseId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses", params._pathParam(0), "input_items")
+                    .putQueryParam("beta", "true")
+                    .build()
+                    .prepareAsync(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { listHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                            .let {
+                                InputItemListPageAsync.builder()
+                                    .service(InputItemServiceAsyncImpl(clientOptions))
+                                    .streamHandlerExecutor(clientOptions.streamHandlerExecutor)
+                                    .params(params)
+                                    .response(it)
+                                    .build()
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/async/beta/responses/InputTokenServiceAsync.kt b/openai-java-core/src/main/kotlin/com/openai/services/async/beta/responses/InputTokenServiceAsync.kt
new file mode 100644
index 000000000..a18e2baea
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/services/async/beta/responses/InputTokenServiceAsync.kt
@@ -0,0 +1,89 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.async.beta.responses
+
+import com.openai.core.ClientOptions
+import com.openai.core.RequestOptions
+import com.openai.core.http.HttpResponseFor
+import com.openai.models.beta.responses.inputtokens.InputTokenCountParams
+import com.openai.models.beta.responses.inputtokens.InputTokenCountResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+interface InputTokenServiceAsync {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): InputTokenServiceAsync
+
+    /**
+     * Returns input token counts of the request.
+     *
+     * Returns an object with `object` set to `response.input_tokens` and an `input_tokens` count.
+     */
+    fun count(): CompletableFuture<InputTokenCountResponse> = count(InputTokenCountParams.none())
+
+    /** @see count */
+    fun count(
+        params: InputTokenCountParams = InputTokenCountParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): CompletableFuture<InputTokenCountResponse>
+
+    /** @see count */
+    fun count(
+        params: InputTokenCountParams = InputTokenCountParams.none()
+    ): CompletableFuture<InputTokenCountResponse> = count(params, RequestOptions.none())
+
+    /** @see count */
+    fun count(requestOptions: RequestOptions): CompletableFuture<InputTokenCountResponse> =
+        count(InputTokenCountParams.none(), requestOptions)
+
+    /**
+     * A view of [InputTokenServiceAsync] that provides access to raw HTTP responses for each
+     * method.
+     */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): InputTokenServiceAsync.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /responses/input_tokens?beta=true`, but is
+         * otherwise the same as [InputTokenServiceAsync.count].
+         */
+        fun count(): CompletableFuture<HttpResponseFor<InputTokenCountResponse>> =
+            count(InputTokenCountParams.none())
+
+        /** @see count */
+        fun count(
+            params: InputTokenCountParams = InputTokenCountParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): CompletableFuture<HttpResponseFor<InputTokenCountResponse>>
+
+        /** @see count */
+        fun count(
+            params: InputTokenCountParams = InputTokenCountParams.none()
+        ): CompletableFuture<HttpResponseFor<InputTokenCountResponse>> =
+            count(params, RequestOptions.none())
+
+        /** @see count */
+        fun count(
+            requestOptions: RequestOptions
+        ): CompletableFuture<HttpResponseFor<InputTokenCountResponse>> =
+            count(InputTokenCountParams.none(), requestOptions)
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/async/beta/responses/InputTokenServiceAsyncImpl.kt b/openai-java-core/src/main/kotlin/com/openai/services/async/beta/responses/InputTokenServiceAsyncImpl.kt
new file mode 100644
index 000000000..199c2f47d
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/services/async/beta/responses/InputTokenServiceAsyncImpl.kt
@@ -0,0 +1,92 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.async.beta.responses
+
+import com.openai.core.ClientOptions
+import com.openai.core.RequestOptions
+import com.openai.core.SecurityOptions
+import com.openai.core.handlers.errorBodyHandler
+import com.openai.core.handlers.errorHandler
+import com.openai.core.handlers.jsonHandler
+import com.openai.core.http.HttpMethod
+import com.openai.core.http.HttpRequest
+import com.openai.core.http.HttpResponse
+import com.openai.core.http.HttpResponse.Handler
+import com.openai.core.http.HttpResponseFor
+import com.openai.core.http.json
+import com.openai.core.http.parseable
+import com.openai.core.prepareAsync
+import com.openai.models.beta.responses.inputtokens.InputTokenCountParams
+import com.openai.models.beta.responses.inputtokens.InputTokenCountResponse
+import java.util.concurrent.CompletableFuture
+import java.util.function.Consumer
+
+class InputTokenServiceAsyncImpl internal constructor(private val clientOptions: ClientOptions) :
+    InputTokenServiceAsync {
+
+    private val withRawResponse: InputTokenServiceAsync.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): InputTokenServiceAsync.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): InputTokenServiceAsync =
+        InputTokenServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun count(
+        params: InputTokenCountParams,
+        requestOptions: RequestOptions,
+    ): CompletableFuture<InputTokenCountResponse> =
+        // post /responses/input_tokens?beta=true
+        withRawResponse().count(params, requestOptions).thenApply { it.parse() }
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        InputTokenServiceAsync.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): InputTokenServiceAsync.WithRawResponse =
+            InputTokenServiceAsyncImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val countHandler: Handler<InputTokenCountResponse> =
+            jsonHandler<InputTokenCountResponse>(clientOptions.jsonMapper)
+
+        override fun count(
+            params: InputTokenCountParams,
+            requestOptions: RequestOptions,
+        ): CompletableFuture<HttpResponseFor<InputTokenCountResponse>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses", "input_tokens")
+                    .putQueryParam("beta", "true")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepareAsync(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            return request
+                .thenComposeAsync { clientOptions.httpClient.executeAsync(it, requestOptions) }
+                .thenApply { response ->
+                    errorHandler.handle(response).parseable {
+                        response
+                            .use { countHandler.handle(it) }
+                            .also {
+                                if (requestOptions.responseValidation!!) {
+                                    it.validate()
+                                }
+                            }
+                    }
+                }
+        }
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaService.kt b/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaService.kt
index d01d6d8ba..e8e313176 100644
--- a/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaService.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaService.kt
@@ -23,10 +23,6 @@ interface BetaService {
      */
     fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaService
 
-    @Deprecated(
-        "Realtime has now launched and is generally available. The old beta API is now deprecated."
-    )
-    fun realtime(): RealtimeService
 
     fun chatkit(): ChatKitService
 
@@ -47,10 +43,6 @@ interface BetaService {
          */
         fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaService.WithRawResponse
 
-        @Deprecated(
-            "Realtime has now launched and is generally available. The old beta API is now deprecated."
-        )
-        fun realtime(): RealtimeService.WithRawResponse
 
         fun chatkit(): ChatKitService.WithRawResponse
 
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaServiceImpl.kt b/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaServiceImpl.kt
index 1dcc747d3..448a0c05f 100644
--- a/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaServiceImpl.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaServiceImpl.kt
@@ -19,7 +19,6 @@ class BetaServiceImpl internal constructor(private val clientOptions: ClientOpti
         WithRawResponseImpl(clientOptions)
     }
 
-    private val realtime: RealtimeService by lazy { RealtimeServiceImpl(clientOptions) }
 
     private val chatkit: ChatKitService by lazy { ChatKitServiceImpl(clientOptions) }
 
@@ -32,10 +31,6 @@ class BetaServiceImpl internal constructor(private val clientOptions: ClientOpti
     override fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaService =
         BetaServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
-    @Deprecated(
-        "Realtime has now launched and is generally available. The old beta API is now deprecated."
-    )
-    override fun realtime(): RealtimeService = realtime
 
     override fun chatkit(): ChatKitService = chatkit
 
@@ -49,9 +44,6 @@ class BetaServiceImpl internal constructor(private val clientOptions: ClientOpti
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
         BetaService.WithRawResponse {
 
-        private val realtime: RealtimeService.WithRawResponse by lazy {
-            RealtimeServiceImpl.WithRawResponseImpl(clientOptions)
-        }
 
         private val chatkit: ChatKitService.WithRawResponse by lazy {
             ChatKitServiceImpl.WithRawResponseImpl(clientOptions)
@@ -72,10 +64,6 @@ class BetaServiceImpl internal constructor(private val clientOptions: ClientOpti
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
-        @Deprecated(
-            "Realtime has now launched and is generally available. The old beta API is now deprecated."
-        )
-        override fun realtime(): RealtimeService.WithRawResponse = realtime
 
         override fun chatkit(): ChatKitService.WithRawResponse = chatkit
 
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/ResponseService.kt b/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/ResponseService.kt
new file mode 100644
index 000000000..93de14a15
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/ResponseService.kt
@@ -0,0 +1,508 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.blocking.beta
+
+import com.google.errorprone.annotations.MustBeClosed
+import com.openai.core.ClientOptions
+import com.openai.core.RequestOptions
+import com.openai.core.http.HttpResponse
+import com.openai.core.http.HttpResponseFor
+import com.openai.core.http.StreamResponse
+import com.openai.models.beta.responses.BetaCompactedResponse
+import com.openai.models.beta.responses.BetaResponse
+import com.openai.models.beta.responses.BetaResponseStreamEvent
+import com.openai.models.beta.responses.ResponseCancelParams
+import com.openai.models.beta.responses.ResponseCompactParams
+import com.openai.models.beta.responses.ResponseCreateParams
+import com.openai.models.beta.responses.ResponseDeleteParams
+import com.openai.models.beta.responses.ResponseRetrieveParams
+import com.openai.services.blocking.beta.responses.InputItemService
+import com.openai.services.blocking.beta.responses.InputTokenService
+import java.util.function.Consumer
+
+interface ResponseService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): ResponseService
+
+    fun inputItems(): InputItemService
+
+    fun inputTokens(): InputTokenService
+
+    /**
+     * Creates a model response. Provide [text](https://platform.openai.com/docs/guides/text) or
+     * [image](https://platform.openai.com/docs/guides/images) inputs to generate
+     * [text](https://platform.openai.com/docs/guides/text) or
+     * [JSON](https://platform.openai.com/docs/guides/structured-outputs) outputs. Have the model
+     * call your own [custom code](https://platform.openai.com/docs/guides/function-calling) or use
+     * built-in [tools](https://platform.openai.com/docs/guides/tools) like
+     * [web search](https://platform.openai.com/docs/guides/tools-web-search) or
+     * [file search](https://platform.openai.com/docs/guides/tools-file-search) to use your own data
+     * as input for the model's response.
+     */
+    fun create(): BetaResponse = create(ResponseCreateParams.none())
+
+    /** @see create */
+    fun create(
+        params: ResponseCreateParams = ResponseCreateParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): BetaResponse
+
+    /** @see create */
+    fun create(params: ResponseCreateParams = ResponseCreateParams.none()): BetaResponse =
+        create(params, RequestOptions.none())
+
+    /** @see create */
+    fun create(requestOptions: RequestOptions): BetaResponse =
+        create(ResponseCreateParams.none(), requestOptions)
+
+    /**
+     * Creates a model response. Provide [text](https://platform.openai.com/docs/guides/text) or
+     * [image](https://platform.openai.com/docs/guides/images) inputs to generate
+     * [text](https://platform.openai.com/docs/guides/text) or
+     * [JSON](https://platform.openai.com/docs/guides/structured-outputs) outputs. Have the model
+     * call your own [custom code](https://platform.openai.com/docs/guides/function-calling) or use
+     * built-in [tools](https://platform.openai.com/docs/guides/tools) like
+     * [web search](https://platform.openai.com/docs/guides/tools-web-search) or
+     * [file search](https://platform.openai.com/docs/guides/tools-file-search) to use your own data
+     * as input for the model's response.
+     */
+    @MustBeClosed
+    fun createStreaming(): StreamResponse<BetaResponseStreamEvent> =
+        createStreaming(ResponseCreateParams.none())
+
+    /** @see createStreaming */
+    @MustBeClosed
+    fun createStreaming(
+        params: ResponseCreateParams = ResponseCreateParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): StreamResponse<BetaResponseStreamEvent>
+
+    /** @see createStreaming */
+    @MustBeClosed
+    fun createStreaming(
+        params: ResponseCreateParams = ResponseCreateParams.none()
+    ): StreamResponse<BetaResponseStreamEvent> = createStreaming(params, RequestOptions.none())
+
+    /** @see createStreaming */
+    @MustBeClosed
+    fun createStreaming(requestOptions: RequestOptions): StreamResponse<BetaResponseStreamEvent> =
+        createStreaming(ResponseCreateParams.none(), requestOptions)
+
+    /** Retrieves a model response with the given ID. */
+    fun retrieve(responseId: String): BetaResponse =
+        retrieve(responseId, ResponseRetrieveParams.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        responseId: String,
+        params: ResponseRetrieveParams = ResponseRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): BetaResponse = retrieve(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+    /** @see retrieve */
+    fun retrieve(
+        responseId: String,
+        params: ResponseRetrieveParams = ResponseRetrieveParams.none(),
+    ): BetaResponse = retrieve(responseId, params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(
+        params: ResponseRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): BetaResponse
+
+    /** @see retrieve */
+    fun retrieve(params: ResponseRetrieveParams): BetaResponse =
+        retrieve(params, RequestOptions.none())
+
+    /** @see retrieve */
+    fun retrieve(responseId: String, requestOptions: RequestOptions): BetaResponse =
+        retrieve(responseId, ResponseRetrieveParams.none(), requestOptions)
+
+    /** Retrieves a model response with the given ID. */
+    @MustBeClosed
+    fun retrieveStreaming(responseId: String): StreamResponse<BetaResponseStreamEvent> =
+        retrieveStreaming(responseId, ResponseRetrieveParams.none())
+
+    /** @see retrieveStreaming */
+    @MustBeClosed
+    fun retrieveStreaming(
+        responseId: String,
+        params: ResponseRetrieveParams = ResponseRetrieveParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): StreamResponse<BetaResponseStreamEvent> =
+        retrieveStreaming(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+    /** @see retrieveStreaming */
+    @MustBeClosed
+    fun retrieveStreaming(
+        responseId: String,
+        params: ResponseRetrieveParams = ResponseRetrieveParams.none(),
+    ): StreamResponse<BetaResponseStreamEvent> =
+        retrieveStreaming(responseId, params, RequestOptions.none())
+
+    /** @see retrieveStreaming */
+    @MustBeClosed
+    fun retrieveStreaming(
+        params: ResponseRetrieveParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): StreamResponse<BetaResponseStreamEvent>
+
+    /** @see retrieveStreaming */
+    @MustBeClosed
+    fun retrieveStreaming(params: ResponseRetrieveParams): StreamResponse<BetaResponseStreamEvent> =
+        retrieveStreaming(params, RequestOptions.none())
+
+    /** @see retrieveStreaming */
+    @MustBeClosed
+    fun retrieveStreaming(
+        responseId: String,
+        requestOptions: RequestOptions,
+    ): StreamResponse<BetaResponseStreamEvent> =
+        retrieveStreaming(responseId, ResponseRetrieveParams.none(), requestOptions)
+
+    /** Deletes a model response with the given ID. */
+    fun delete(responseId: String) = delete(responseId, ResponseDeleteParams.none())
+
+    /** @see delete */
+    fun delete(
+        responseId: String,
+        params: ResponseDeleteParams = ResponseDeleteParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ) = delete(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+    /** @see delete */
+    fun delete(responseId: String, params: ResponseDeleteParams = ResponseDeleteParams.none()) =
+        delete(responseId, params, RequestOptions.none())
+
+    /** @see delete */
+    fun delete(params: ResponseDeleteParams, requestOptions: RequestOptions = RequestOptions.none())
+
+    /** @see delete */
+    fun delete(params: ResponseDeleteParams) = delete(params, RequestOptions.none())
+
+    /** @see delete */
+    fun delete(responseId: String, requestOptions: RequestOptions) =
+        delete(responseId, ResponseDeleteParams.none(), requestOptions)
+
+    /**
+     * Cancels a model response with the given ID. Only responses created with the `background`
+     * parameter set to `true` can be cancelled.
+     * [Learn more](https://platform.openai.com/docs/guides/background).
+     */
+    fun cancel(responseId: String): BetaResponse = cancel(responseId, ResponseCancelParams.none())
+
+    /** @see cancel */
+    fun cancel(
+        responseId: String,
+        params: ResponseCancelParams = ResponseCancelParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): BetaResponse = cancel(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+    /** @see cancel */
+    fun cancel(
+        responseId: String,
+        params: ResponseCancelParams = ResponseCancelParams.none(),
+    ): BetaResponse = cancel(responseId, params, RequestOptions.none())
+
+    /** @see cancel */
+    fun cancel(
+        params: ResponseCancelParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): BetaResponse
+
+    /** @see cancel */
+    fun cancel(params: ResponseCancelParams): BetaResponse = cancel(params, RequestOptions.none())
+
+    /** @see cancel */
+    fun cancel(responseId: String, requestOptions: RequestOptions): BetaResponse =
+        cancel(responseId, ResponseCancelParams.none(), requestOptions)
+
+    /**
+     * Compact a conversation. Returns a compacted response object.
+     *
+     * Learn when and how to compact long-running conversations in the
+     * [conversation state guide](https://platform.openai.com/docs/guides/conversation-state#managing-the-context-window).
+     * For ZDR-compatible compaction details, see
+     * [Compaction (advanced)](https://platform.openai.com/docs/guides/conversation-state#compaction-advanced).
+     */
+    fun compact(params: ResponseCompactParams): BetaCompactedResponse =
+        compact(params, RequestOptions.none())
+
+    /** @see compact */
+    fun compact(
+        params: ResponseCompactParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): BetaCompactedResponse
+
+    /** A view of [ResponseService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): ResponseService.WithRawResponse
+
+        fun inputItems(): InputItemService.WithRawResponse
+
+        fun inputTokens(): InputTokenService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /responses?beta=true`, but is otherwise the same as
+         * [ResponseService.create].
+         */
+        @MustBeClosed
+        fun create(): HttpResponseFor<BetaResponse> = create(ResponseCreateParams.none())
+
+        /** @see create */
+        @MustBeClosed
+        fun create(
+            params: ResponseCreateParams = ResponseCreateParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<BetaResponse>
+
+        /** @see create */
+        @MustBeClosed
+        fun create(
+            params: ResponseCreateParams = ResponseCreateParams.none()
+        ): HttpResponseFor<BetaResponse> = create(params, RequestOptions.none())
+
+        /** @see create */
+        @MustBeClosed
+        fun create(requestOptions: RequestOptions): HttpResponseFor<BetaResponse> =
+            create(ResponseCreateParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /responses?beta=true`, but is otherwise the same as
+         * [ResponseService.createStreaming].
+         */
+        @MustBeClosed
+        fun createStreaming(): HttpResponseFor<StreamResponse<BetaResponseStreamEvent>> =
+            createStreaming(ResponseCreateParams.none())
+
+        /** @see createStreaming */
+        @MustBeClosed
+        fun createStreaming(
+            params: ResponseCreateParams = ResponseCreateParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<StreamResponse<BetaResponseStreamEvent>>
+
+        /** @see createStreaming */
+        @MustBeClosed
+        fun createStreaming(
+            params: ResponseCreateParams = ResponseCreateParams.none()
+        ): HttpResponseFor<StreamResponse<BetaResponseStreamEvent>> =
+            createStreaming(params, RequestOptions.none())
+
+        /** @see createStreaming */
+        @MustBeClosed
+        fun createStreaming(
+            requestOptions: RequestOptions
+        ): HttpResponseFor<StreamResponse<BetaResponseStreamEvent>> =
+            createStreaming(ResponseCreateParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /responses/{response_id}?beta=true`, but is
+         * otherwise the same as [ResponseService.retrieve].
+         */
+        @MustBeClosed
+        fun retrieve(responseId: String): HttpResponseFor<BetaResponse> =
+            retrieve(responseId, ResponseRetrieveParams.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            responseId: String,
+            params: ResponseRetrieveParams = ResponseRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<BetaResponse> =
+            retrieve(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            responseId: String,
+            params: ResponseRetrieveParams = ResponseRetrieveParams.none(),
+        ): HttpResponseFor<BetaResponse> = retrieve(responseId, params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            params: ResponseRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<BetaResponse>
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(params: ResponseRetrieveParams): HttpResponseFor<BetaResponse> =
+            retrieve(params, RequestOptions.none())
+
+        /** @see retrieve */
+        @MustBeClosed
+        fun retrieve(
+            responseId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<BetaResponse> =
+            retrieve(responseId, ResponseRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `get /responses/{response_id}?beta=true`, but is
+         * otherwise the same as [ResponseService.retrieveStreaming].
+         */
+        @MustBeClosed
+        fun retrieveStreaming(
+            responseId: String
+        ): HttpResponseFor<StreamResponse<BetaResponseStreamEvent>> =
+            retrieveStreaming(responseId, ResponseRetrieveParams.none())
+
+        /** @see retrieveStreaming */
+        @MustBeClosed
+        fun retrieveStreaming(
+            responseId: String,
+            params: ResponseRetrieveParams = ResponseRetrieveParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<StreamResponse<BetaResponseStreamEvent>> =
+            retrieveStreaming(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+        /** @see retrieveStreaming */
+        @MustBeClosed
+        fun retrieveStreaming(
+            responseId: String,
+            params: ResponseRetrieveParams = ResponseRetrieveParams.none(),
+        ): HttpResponseFor<StreamResponse<BetaResponseStreamEvent>> =
+            retrieveStreaming(responseId, params, RequestOptions.none())
+
+        /** @see retrieveStreaming */
+        @MustBeClosed
+        fun retrieveStreaming(
+            params: ResponseRetrieveParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<StreamResponse<BetaResponseStreamEvent>>
+
+        /** @see retrieveStreaming */
+        @MustBeClosed
+        fun retrieveStreaming(
+            params: ResponseRetrieveParams
+        ): HttpResponseFor<StreamResponse<BetaResponseStreamEvent>> =
+            retrieveStreaming(params, RequestOptions.none())
+
+        /** @see retrieveStreaming */
+        @MustBeClosed
+        fun retrieveStreaming(
+            responseId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<StreamResponse<BetaResponseStreamEvent>> =
+            retrieveStreaming(responseId, ResponseRetrieveParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `delete /responses/{response_id}?beta=true`, but is
+         * otherwise the same as [ResponseService.delete].
+         */
+        @MustBeClosed
+        fun delete(responseId: String): HttpResponse =
+            delete(responseId, ResponseDeleteParams.none())
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(
+            responseId: String,
+            params: ResponseDeleteParams = ResponseDeleteParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponse = delete(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(
+            responseId: String,
+            params: ResponseDeleteParams = ResponseDeleteParams.none(),
+        ): HttpResponse = delete(responseId, params, RequestOptions.none())
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(
+            params: ResponseDeleteParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponse
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(params: ResponseDeleteParams): HttpResponse =
+            delete(params, RequestOptions.none())
+
+        /** @see delete */
+        @MustBeClosed
+        fun delete(responseId: String, requestOptions: RequestOptions): HttpResponse =
+            delete(responseId, ResponseDeleteParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /responses/{response_id}/cancel?beta=true`, but is
+         * otherwise the same as [ResponseService.cancel].
+         */
+        @MustBeClosed
+        fun cancel(responseId: String): HttpResponseFor<BetaResponse> =
+            cancel(responseId, ResponseCancelParams.none())
+
+        /** @see cancel */
+        @MustBeClosed
+        fun cancel(
+            responseId: String,
+            params: ResponseCancelParams = ResponseCancelParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<BetaResponse> =
+            cancel(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+        /** @see cancel */
+        @MustBeClosed
+        fun cancel(
+            responseId: String,
+            params: ResponseCancelParams = ResponseCancelParams.none(),
+        ): HttpResponseFor<BetaResponse> = cancel(responseId, params, RequestOptions.none())
+
+        /** @see cancel */
+        @MustBeClosed
+        fun cancel(
+            params: ResponseCancelParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<BetaResponse>
+
+        /** @see cancel */
+        @MustBeClosed
+        fun cancel(params: ResponseCancelParams): HttpResponseFor<BetaResponse> =
+            cancel(params, RequestOptions.none())
+
+        /** @see cancel */
+        @MustBeClosed
+        fun cancel(
+            responseId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<BetaResponse> =
+            cancel(responseId, ResponseCancelParams.none(), requestOptions)
+
+        /**
+         * Returns a raw HTTP response for `post /responses/compact?beta=true`, but is otherwise the
+         * same as [ResponseService.compact].
+         */
+        @MustBeClosed
+        fun compact(params: ResponseCompactParams): HttpResponseFor<BetaCompactedResponse> =
+            compact(params, RequestOptions.none())
+
+        /** @see compact */
+        @MustBeClosed
+        fun compact(
+            params: ResponseCompactParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<BetaCompactedResponse>
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/ResponseServiceImpl.kt b/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/ResponseServiceImpl.kt
new file mode 100644
index 000000000..98a378825
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/ResponseServiceImpl.kt
@@ -0,0 +1,382 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.blocking.beta
+
+import com.openai.core.ClientOptions
+import com.openai.core.JsonValue
+import com.openai.core.RequestOptions
+import com.openai.core.SecurityOptions
+import com.openai.core.checkRequired
+import com.openai.core.handlers.emptyHandler
+import com.openai.core.handlers.errorBodyHandler
+import com.openai.core.handlers.errorHandler
+import com.openai.core.handlers.jsonHandler
+import com.openai.core.handlers.mapJson
+import com.openai.core.handlers.sseHandler
+import com.openai.core.http.HttpMethod
+import com.openai.core.http.HttpRequest
+import com.openai.core.http.HttpResponse
+import com.openai.core.http.HttpResponse.Handler
+import com.openai.core.http.HttpResponseFor
+import com.openai.core.http.StreamResponse
+import com.openai.core.http.json
+import com.openai.core.http.map
+import com.openai.core.http.parseable
+import com.openai.core.prepare
+import com.openai.models.beta.responses.BetaCompactedResponse
+import com.openai.models.beta.responses.BetaResponse
+import com.openai.models.beta.responses.BetaResponseStreamEvent
+import com.openai.models.beta.responses.ResponseCancelParams
+import com.openai.models.beta.responses.ResponseCompactParams
+import com.openai.models.beta.responses.ResponseCreateParams
+import com.openai.models.beta.responses.ResponseDeleteParams
+import com.openai.models.beta.responses.ResponseRetrieveParams
+import com.openai.services.blocking.beta.responses.InputItemService
+import com.openai.services.blocking.beta.responses.InputItemServiceImpl
+import com.openai.services.blocking.beta.responses.InputTokenService
+import com.openai.services.blocking.beta.responses.InputTokenServiceImpl
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+class ResponseServiceImpl internal constructor(private val clientOptions: ClientOptions) :
+    ResponseService {
+
+    private val withRawResponse: ResponseService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    private val inputItems: InputItemService by lazy { InputItemServiceImpl(clientOptions) }
+
+    private val inputTokens: InputTokenService by lazy { InputTokenServiceImpl(clientOptions) }
+
+    override fun withRawResponse(): ResponseService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): ResponseService =
+        ResponseServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun inputItems(): InputItemService = inputItems
+
+    override fun inputTokens(): InputTokenService = inputTokens
+
+    override fun create(
+        params: ResponseCreateParams,
+        requestOptions: RequestOptions,
+    ): BetaResponse =
+        // post /responses?beta=true
+        withRawResponse().create(params, requestOptions).parse()
+
+    override fun createStreaming(
+        params: ResponseCreateParams,
+        requestOptions: RequestOptions,
+    ): StreamResponse<BetaResponseStreamEvent> =
+        // post /responses?beta=true
+        withRawResponse().createStreaming(params, requestOptions).parse()
+
+    override fun retrieve(
+        params: ResponseRetrieveParams,
+        requestOptions: RequestOptions,
+    ): BetaResponse =
+        // get /responses/{response_id}?beta=true
+        withRawResponse().retrieve(params, requestOptions).parse()
+
+    override fun retrieveStreaming(
+        params: ResponseRetrieveParams,
+        requestOptions: RequestOptions,
+    ): StreamResponse<BetaResponseStreamEvent> =
+        // get /responses/{response_id}?beta=true
+        withRawResponse().retrieveStreaming(params, requestOptions).parse()
+
+    override fun delete(params: ResponseDeleteParams, requestOptions: RequestOptions) {
+        // delete /responses/{response_id}?beta=true
+        withRawResponse().delete(params, requestOptions)
+    }
+
+    override fun cancel(
+        params: ResponseCancelParams,
+        requestOptions: RequestOptions,
+    ): BetaResponse =
+        // post /responses/{response_id}/cancel?beta=true
+        withRawResponse().cancel(params, requestOptions).parse()
+
+    override fun compact(
+        params: ResponseCompactParams,
+        requestOptions: RequestOptions,
+    ): BetaCompactedResponse =
+        // post /responses/compact?beta=true
+        withRawResponse().compact(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        ResponseService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        private val inputItems: InputItemService.WithRawResponse by lazy {
+            InputItemServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        private val inputTokens: InputTokenService.WithRawResponse by lazy {
+            InputTokenServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): ResponseService.WithRawResponse =
+            ResponseServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        override fun inputItems(): InputItemService.WithRawResponse = inputItems
+
+        override fun inputTokens(): InputTokenService.WithRawResponse = inputTokens
+
+        private val createHandler: Handler<BetaResponse> =
+            jsonHandler<BetaResponse>(clientOptions.jsonMapper)
+
+        override fun create(
+            params: ResponseCreateParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<BetaResponse> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses")
+                    .putQueryParam("beta", "true")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { createHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val createStreamingHandler: Handler<StreamResponse<BetaResponseStreamEvent>> =
+            sseHandler(clientOptions.jsonMapper).mapJson<BetaResponseStreamEvent>()
+
+        override fun createStreaming(
+            params: ResponseCreateParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<StreamResponse<BetaResponseStreamEvent>> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses")
+                    .putQueryParam("beta", "true")
+                    .putHeader("Accept", "text/event-stream")
+                    .body(
+                        json(
+                            clientOptions.jsonMapper,
+                            params
+                                ._body()
+                                .toBuilder()
+                                .putAdditionalProperty("stream", JsonValue.from(true))
+                                .build(),
+                        )
+                    )
+                    .build()
+                    .prepare(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .let { createStreamingHandler.handle(it) }
+                    .let { streamResponse ->
+                        if (requestOptions.responseValidation!!) {
+                            streamResponse.map { it.validate() }
+                        } else {
+                            streamResponse
+                        }
+                    }
+            }
+        }
+
+        private val retrieveHandler: Handler<BetaResponse> =
+            jsonHandler<BetaResponse>(clientOptions.jsonMapper)
+
+        override fun retrieve(
+            params: ResponseRetrieveParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<BetaResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("responseId", params.responseId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses", params._pathParam(0))
+                    .putQueryParam("beta", "true")
+                    .build()
+                    .prepare(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { retrieveHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val retrieveStreamingHandler: Handler<StreamResponse<BetaResponseStreamEvent>> =
+            sseHandler(clientOptions.jsonMapper).mapJson<BetaResponseStreamEvent>()
+
+        override fun retrieveStreaming(
+            params: ResponseRetrieveParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<StreamResponse<BetaResponseStreamEvent>> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("responseId", params.responseId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses", params._pathParam(0))
+                    .putAllQueryParams(mapOf("beta" to "true", "stream" to "true"))
+                    .putHeader("Accept", "text/event-stream")
+                    .build()
+                    .prepare(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .let { retrieveStreamingHandler.handle(it) }
+                    .let { streamResponse ->
+                        if (requestOptions.responseValidation!!) {
+                            streamResponse.map { it.validate() }
+                        } else {
+                            streamResponse
+                        }
+                    }
+            }
+        }
+
+        private val deleteHandler: Handler<Void?> = emptyHandler()
+
+        override fun delete(
+            params: ResponseDeleteParams,
+            requestOptions: RequestOptions,
+        ): HttpResponse {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("responseId", params.responseId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.DELETE)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses", params._pathParam(0))
+                    .putQueryParam("beta", "true")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepare(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response.use { deleteHandler.handle(it) }
+            }
+        }
+
+        private val cancelHandler: Handler<BetaResponse> =
+            jsonHandler<BetaResponse>(clientOptions.jsonMapper)
+
+        override fun cancel(
+            params: ResponseCancelParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<BetaResponse> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("responseId", params.responseId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses", params._pathParam(0), "cancel")
+                    .putQueryParam("beta", "true")
+                    .apply { params._body().ifPresent { body(json(clientOptions.jsonMapper, it)) } }
+                    .build()
+                    .prepare(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { cancelHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+
+        private val compactHandler: Handler<BetaCompactedResponse> =
+            jsonHandler<BetaCompactedResponse>(clientOptions.jsonMapper)
+
+        override fun compact(
+            params: ResponseCompactParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<BetaCompactedResponse> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses", "compact")
+                    .putQueryParam("beta", "true")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { compactHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/responses/InputItemService.kt b/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/responses/InputItemService.kt
new file mode 100644
index 000000000..14fddb75a
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/responses/InputItemService.kt
@@ -0,0 +1,110 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.blocking.beta.responses
+
+import com.google.errorprone.annotations.MustBeClosed
+import com.openai.core.ClientOptions
+import com.openai.core.RequestOptions
+import com.openai.core.http.HttpResponseFor
+import com.openai.models.beta.responses.inputitems.InputItemListPage
+import com.openai.models.beta.responses.inputitems.InputItemListParams
+import java.util.function.Consumer
+
+interface InputItemService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): InputItemService
+
+    /** Returns a list of input items for a given response. */
+    fun list(responseId: String): InputItemListPage = list(responseId, InputItemListParams.none())
+
+    /** @see list */
+    fun list(
+        responseId: String,
+        params: InputItemListParams = InputItemListParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): InputItemListPage = list(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+    /** @see list */
+    fun list(
+        responseId: String,
+        params: InputItemListParams = InputItemListParams.none(),
+    ): InputItemListPage = list(responseId, params, RequestOptions.none())
+
+    /** @see list */
+    fun list(
+        params: InputItemListParams,
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): InputItemListPage
+
+    /** @see list */
+    fun list(params: InputItemListParams): InputItemListPage = list(params, RequestOptions.none())
+
+    /** @see list */
+    fun list(responseId: String, requestOptions: RequestOptions): InputItemListPage =
+        list(responseId, InputItemListParams.none(), requestOptions)
+
+    /** A view of [InputItemService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(modifier: Consumer<ClientOptions.Builder>): InputItemService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `get /responses/{response_id}/input_items?beta=true`, but
+         * is otherwise the same as [InputItemService.list].
+         */
+        @MustBeClosed
+        fun list(responseId: String): HttpResponseFor<InputItemListPage> =
+            list(responseId, InputItemListParams.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            responseId: String,
+            params: InputItemListParams = InputItemListParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<InputItemListPage> =
+            list(params.toBuilder().responseId(responseId).build(), requestOptions)
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            responseId: String,
+            params: InputItemListParams = InputItemListParams.none(),
+        ): HttpResponseFor<InputItemListPage> = list(responseId, params, RequestOptions.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            params: InputItemListParams,
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<InputItemListPage>
+
+        /** @see list */
+        @MustBeClosed
+        fun list(params: InputItemListParams): HttpResponseFor<InputItemListPage> =
+            list(params, RequestOptions.none())
+
+        /** @see list */
+        @MustBeClosed
+        fun list(
+            responseId: String,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<InputItemListPage> =
+            list(responseId, InputItemListParams.none(), requestOptions)
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/responses/InputItemServiceImpl.kt b/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/responses/InputItemServiceImpl.kt
new file mode 100644
index 000000000..b5e2a9ce1
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/responses/InputItemServiceImpl.kt
@@ -0,0 +1,99 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.blocking.beta.responses
+
+import com.openai.core.ClientOptions
+import com.openai.core.RequestOptions
+import com.openai.core.SecurityOptions
+import com.openai.core.checkRequired
+import com.openai.core.handlers.errorBodyHandler
+import com.openai.core.handlers.errorHandler
+import com.openai.core.handlers.jsonHandler
+import com.openai.core.http.HttpMethod
+import com.openai.core.http.HttpRequest
+import com.openai.core.http.HttpResponse
+import com.openai.core.http.HttpResponse.Handler
+import com.openai.core.http.HttpResponseFor
+import com.openai.core.http.parseable
+import com.openai.core.prepare
+import com.openai.models.beta.responses.inputitems.BetaResponseItemList
+import com.openai.models.beta.responses.inputitems.InputItemListPage
+import com.openai.models.beta.responses.inputitems.InputItemListParams
+import java.util.function.Consumer
+import kotlin.jvm.optionals.getOrNull
+
+class InputItemServiceImpl internal constructor(private val clientOptions: ClientOptions) :
+    InputItemService {
+
+    private val withRawResponse: InputItemService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): InputItemService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): InputItemService =
+        InputItemServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun list(
+        params: InputItemListParams,
+        requestOptions: RequestOptions,
+    ): InputItemListPage =
+        // get /responses/{response_id}/input_items?beta=true
+        withRawResponse().list(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        InputItemService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): InputItemService.WithRawResponse =
+            InputItemServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val listHandler: Handler<BetaResponseItemList> =
+            jsonHandler<BetaResponseItemList>(clientOptions.jsonMapper)
+
+        override fun list(
+            params: InputItemListParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<InputItemListPage> {
+            // We check here instead of in the params builder because this can be specified
+            // positionally or in the params class.
+            checkRequired("responseId", params.responseId().getOrNull())
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.GET)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses", params._pathParam(0), "input_items")
+                    .putQueryParam("beta", "true")
+                    .build()
+                    .prepare(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { listHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+                    .let {
+                        InputItemListPage.builder()
+                            .service(InputItemServiceImpl(clientOptions))
+                            .params(params)
+                            .response(it)
+                            .build()
+                    }
+            }
+        }
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/responses/InputTokenService.kt b/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/responses/InputTokenService.kt
new file mode 100644
index 000000000..edab010b0
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/responses/InputTokenService.kt
@@ -0,0 +1,86 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.blocking.beta.responses
+
+import com.google.errorprone.annotations.MustBeClosed
+import com.openai.core.ClientOptions
+import com.openai.core.RequestOptions
+import com.openai.core.http.HttpResponseFor
+import com.openai.models.beta.responses.inputtokens.InputTokenCountParams
+import com.openai.models.beta.responses.inputtokens.InputTokenCountResponse
+import java.util.function.Consumer
+
+interface InputTokenService {
+
+    /**
+     * Returns a view of this service that provides access to raw HTTP responses for each method.
+     */
+    fun withRawResponse(): WithRawResponse
+
+    /**
+     * Returns a view of this service with the given option modifications applied.
+     *
+     * The original service is not modified.
+     */
+    fun withOptions(modifier: Consumer<ClientOptions.Builder>): InputTokenService
+
+    /**
+     * Returns input token counts of the request.
+     *
+     * Returns an object with `object` set to `response.input_tokens` and an `input_tokens` count.
+     */
+    fun count(): InputTokenCountResponse = count(InputTokenCountParams.none())
+
+    /** @see count */
+    fun count(
+        params: InputTokenCountParams = InputTokenCountParams.none(),
+        requestOptions: RequestOptions = RequestOptions.none(),
+    ): InputTokenCountResponse
+
+    /** @see count */
+    fun count(
+        params: InputTokenCountParams = InputTokenCountParams.none()
+    ): InputTokenCountResponse = count(params, RequestOptions.none())
+
+    /** @see count */
+    fun count(requestOptions: RequestOptions): InputTokenCountResponse =
+        count(InputTokenCountParams.none(), requestOptions)
+
+    /** A view of [InputTokenService] that provides access to raw HTTP responses for each method. */
+    interface WithRawResponse {
+
+        /**
+         * Returns a view of this service with the given option modifications applied.
+         *
+         * The original service is not modified.
+         */
+        fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): InputTokenService.WithRawResponse
+
+        /**
+         * Returns a raw HTTP response for `post /responses/input_tokens?beta=true`, but is
+         * otherwise the same as [InputTokenService.count].
+         */
+        @MustBeClosed
+        fun count(): HttpResponseFor<InputTokenCountResponse> = count(InputTokenCountParams.none())
+
+        /** @see count */
+        @MustBeClosed
+        fun count(
+            params: InputTokenCountParams = InputTokenCountParams.none(),
+            requestOptions: RequestOptions = RequestOptions.none(),
+        ): HttpResponseFor<InputTokenCountResponse>
+
+        /** @see count */
+        @MustBeClosed
+        fun count(
+            params: InputTokenCountParams = InputTokenCountParams.none()
+        ): HttpResponseFor<InputTokenCountResponse> = count(params, RequestOptions.none())
+
+        /** @see count */
+        @MustBeClosed
+        fun count(requestOptions: RequestOptions): HttpResponseFor<InputTokenCountResponse> =
+            count(InputTokenCountParams.none(), requestOptions)
+    }
+}
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/responses/InputTokenServiceImpl.kt b/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/responses/InputTokenServiceImpl.kt
new file mode 100644
index 000000000..10c8b1ef0
--- /dev/null
+++ b/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/responses/InputTokenServiceImpl.kt
@@ -0,0 +1,88 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.blocking.beta.responses
+
+import com.openai.core.ClientOptions
+import com.openai.core.RequestOptions
+import com.openai.core.SecurityOptions
+import com.openai.core.handlers.errorBodyHandler
+import com.openai.core.handlers.errorHandler
+import com.openai.core.handlers.jsonHandler
+import com.openai.core.http.HttpMethod
+import com.openai.core.http.HttpRequest
+import com.openai.core.http.HttpResponse
+import com.openai.core.http.HttpResponse.Handler
+import com.openai.core.http.HttpResponseFor
+import com.openai.core.http.json
+import com.openai.core.http.parseable
+import com.openai.core.prepare
+import com.openai.models.beta.responses.inputtokens.InputTokenCountParams
+import com.openai.models.beta.responses.inputtokens.InputTokenCountResponse
+import java.util.function.Consumer
+
+class InputTokenServiceImpl internal constructor(private val clientOptions: ClientOptions) :
+    InputTokenService {
+
+    private val withRawResponse: InputTokenService.WithRawResponse by lazy {
+        WithRawResponseImpl(clientOptions)
+    }
+
+    override fun withRawResponse(): InputTokenService.WithRawResponse = withRawResponse
+
+    override fun withOptions(modifier: Consumer<ClientOptions.Builder>): InputTokenService =
+        InputTokenServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
+
+    override fun count(
+        params: InputTokenCountParams,
+        requestOptions: RequestOptions,
+    ): InputTokenCountResponse =
+        // post /responses/input_tokens?beta=true
+        withRawResponse().count(params, requestOptions).parse()
+
+    class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
+        InputTokenService.WithRawResponse {
+
+        private val errorHandler: Handler<HttpResponse> =
+            errorHandler(errorBodyHandler(clientOptions.jsonMapper))
+
+        override fun withOptions(
+            modifier: Consumer<ClientOptions.Builder>
+        ): InputTokenService.WithRawResponse =
+            InputTokenServiceImpl.WithRawResponseImpl(
+                clientOptions.toBuilder().apply(modifier::accept).build()
+            )
+
+        private val countHandler: Handler<InputTokenCountResponse> =
+            jsonHandler<InputTokenCountResponse>(clientOptions.jsonMapper)
+
+        override fun count(
+            params: InputTokenCountParams,
+            requestOptions: RequestOptions,
+        ): HttpResponseFor<InputTokenCountResponse> {
+            val request =
+                HttpRequest.builder()
+                    .method(HttpMethod.POST)
+                    .baseUrl(clientOptions.baseUrl())
+                    .addPathSegments("responses", "input_tokens")
+                    .putQueryParam("beta", "true")
+                    .body(json(clientOptions.jsonMapper, params._body()))
+                    .build()
+                    .prepare(
+                        clientOptions,
+                        params,
+                        SecurityOptions.builder().bearerAuth(true).build(),
+                    )
+            val requestOptions = requestOptions.applyDefaults(RequestOptions.from(clientOptions))
+            val response = clientOptions.httpClient.execute(request, requestOptions)
+            return errorHandler.handle(response).parseable {
+                response
+                    .use { countHandler.handle(it) }
+                    .also {
+                        if (requestOptions.responseValidation!!) {
+                            it.validate()
+                        }
+                    }
+            }
+        }
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/AllModelsTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/AllModelsTest.kt
index b03baa738..717284f4a 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/AllModelsTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/AllModelsTest.kt
@@ -41,7 +41,7 @@ internal class AllModelsTest {
 
     @Test
     fun ofChatModel() {
-        val chatModel = ChatModel.GPT_5_4
+        val chatModel = ChatModel.GPT_5_6_SOL
 
         val allModels = AllModels.ofChatModel(chatModel)
 
@@ -53,7 +53,7 @@ internal class AllModelsTest {
     @Test
     fun ofChatModelRoundtrip() {
         val jsonMapper = jsonMapper()
-        val allModels = AllModels.ofChatModel(ChatModel.GPT_5_4)
+        val allModels = AllModels.ofChatModel(ChatModel.GPT_5_6_SOL)
 
         val roundtrippedAllModels =
             jsonMapper.readValue(
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/ReasoningTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/ReasoningTest.kt
index 48ece51b3..0b1fd6f1a 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/ReasoningTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/ReasoningTest.kt
@@ -16,12 +16,14 @@ internal class ReasoningTest {
                 .context(Reasoning.Context.AUTO)
                 .effort(ReasoningEffort.NONE)
                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                .mode(Reasoning.Mode.STANDARD)
                 .summary(Reasoning.Summary.AUTO)
                 .build()
 
         assertThat(reasoning.context()).contains(Reasoning.Context.AUTO)
         assertThat(reasoning.effort()).contains(ReasoningEffort.NONE)
         assertThat(reasoning.generateSummary()).contains(Reasoning.GenerateSummary.AUTO)
+        assertThat(reasoning.mode()).contains(Reasoning.Mode.STANDARD)
         assertThat(reasoning.summary()).contains(Reasoning.Summary.AUTO)
     }
 
@@ -33,6 +35,7 @@ internal class ReasoningTest {
                 .context(Reasoning.Context.AUTO)
                 .effort(ReasoningEffort.NONE)
                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                .mode(Reasoning.Mode.STANDARD)
                 .summary(Reasoning.Summary.AUTO)
                 .build()
 
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/ResponsesModelTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/ResponsesModelTest.kt
index 031180494..ca3a2e3b1 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/ResponsesModelTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/ResponsesModelTest.kt
@@ -41,7 +41,7 @@ internal class ResponsesModelTest {
 
     @Test
     fun ofChat() {
-        val chat = ChatModel.GPT_5_4
+        val chat = ChatModel.GPT_5_6_SOL
 
         val responsesModel = ResponsesModel.ofChat(chat)
 
@@ -53,7 +53,7 @@ internal class ResponsesModelTest {
     @Test
     fun ofChatRoundtrip() {
         val jsonMapper = jsonMapper()
-        val responsesModel = ResponsesModel.ofChat(ChatModel.GPT_5_4)
+        val responsesModel = ResponsesModel.ofChat(ChatModel.GPT_5_6_SOL)
 
         val roundtrippedResponsesModel =
             jsonMapper.readValue(
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaApplyPatchToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaApplyPatchToolTest.kt
new file mode 100644
index 000000000..c88dd17b2
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaApplyPatchToolTest.kt
@@ -0,0 +1,40 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaApplyPatchToolTest {
+
+    @Test
+    fun create() {
+        val betaApplyPatchTool =
+            BetaApplyPatchTool.builder()
+                .addAllowedCaller(BetaApplyPatchTool.AllowedCaller.DIRECT)
+                .build()
+
+        assertThat(betaApplyPatchTool.allowedCallers().getOrNull())
+            .containsExactly(BetaApplyPatchTool.AllowedCaller.DIRECT)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaApplyPatchTool =
+            BetaApplyPatchTool.builder()
+                .addAllowedCaller(BetaApplyPatchTool.AllowedCaller.DIRECT)
+                .build()
+
+        val roundtrippedBetaApplyPatchTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaApplyPatchTool),
+                jacksonTypeRef<BetaApplyPatchTool>(),
+            )
+
+        assertThat(roundtrippedBetaApplyPatchTool).isEqualTo(betaApplyPatchTool)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaCompactedResponseTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaCompactedResponseTest.kt
new file mode 100644
index 000000000..4c724ca8b
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaCompactedResponseTest.kt
@@ -0,0 +1,211 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaCompactedResponseTest {
+
+    @Test
+    fun create() {
+        val betaCompactedResponse =
+            BetaCompactedResponse.builder()
+                .id("id")
+                .createdAt(0L)
+                .addOutput(
+                    BetaResponseOutputMessage.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseOutputText.builder()
+                                .addAnnotation(
+                                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                                        .fileId("file_id")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                                .text("text")
+                                .addLogprob(
+                                    BetaResponseOutputText.Logprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .addTopLogprob(
+                                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                        .agent(
+                            BetaResponseOutputMessage.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                        .build()
+                )
+                .usage(
+                    BetaResponseUsage.builder()
+                        .inputTokens(0L)
+                        .inputTokensDetails(
+                            BetaResponseUsage.InputTokensDetails.builder()
+                                .cacheWriteTokens(0L)
+                                .cachedTokens(0L)
+                                .build()
+                        )
+                        .outputTokens(0L)
+                        .outputTokensDetails(
+                            BetaResponseUsage.OutputTokensDetails.builder()
+                                .reasoningTokens(0L)
+                                .build()
+                        )
+                        .totalTokens(0L)
+                        .build()
+                )
+                .build()
+
+        assertThat(betaCompactedResponse.id()).isEqualTo("id")
+        assertThat(betaCompactedResponse.createdAt()).isEqualTo(0L)
+        assertThat(betaCompactedResponse.output())
+            .containsExactly(
+                BetaResponseOutputItem.ofMessage(
+                    BetaResponseOutputMessage.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseOutputText.builder()
+                                .addAnnotation(
+                                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                                        .fileId("file_id")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                                .text("text")
+                                .addLogprob(
+                                    BetaResponseOutputText.Logprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .addTopLogprob(
+                                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                        .agent(
+                            BetaResponseOutputMessage.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                        .build()
+                )
+            )
+        assertThat(betaCompactedResponse.usage())
+            .isEqualTo(
+                BetaResponseUsage.builder()
+                    .inputTokens(0L)
+                    .inputTokensDetails(
+                        BetaResponseUsage.InputTokensDetails.builder()
+                            .cacheWriteTokens(0L)
+                            .cachedTokens(0L)
+                            .build()
+                    )
+                    .outputTokens(0L)
+                    .outputTokensDetails(
+                        BetaResponseUsage.OutputTokensDetails.builder().reasoningTokens(0L).build()
+                    )
+                    .totalTokens(0L)
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaCompactedResponse =
+            BetaCompactedResponse.builder()
+                .id("id")
+                .createdAt(0L)
+                .addOutput(
+                    BetaResponseOutputMessage.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseOutputText.builder()
+                                .addAnnotation(
+                                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                                        .fileId("file_id")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                                .text("text")
+                                .addLogprob(
+                                    BetaResponseOutputText.Logprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .addTopLogprob(
+                                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                        .agent(
+                            BetaResponseOutputMessage.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                        .build()
+                )
+                .usage(
+                    BetaResponseUsage.builder()
+                        .inputTokens(0L)
+                        .inputTokensDetails(
+                            BetaResponseUsage.InputTokensDetails.builder()
+                                .cacheWriteTokens(0L)
+                                .cachedTokens(0L)
+                                .build()
+                        )
+                        .outputTokens(0L)
+                        .outputTokensDetails(
+                            BetaResponseUsage.OutputTokensDetails.builder()
+                                .reasoningTokens(0L)
+                                .build()
+                        )
+                        .totalTokens(0L)
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaCompactedResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaCompactedResponse),
+                jacksonTypeRef<BetaCompactedResponse>(),
+            )
+
+        assertThat(roundtrippedBetaCompactedResponse).isEqualTo(betaCompactedResponse)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaComputerActionTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaComputerActionTest.kt
new file mode 100644
index 000000000..7226f24ca
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaComputerActionTest.kt
@@ -0,0 +1,361 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import com.openai.errors.OpenAIInvalidDataException
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.assertThrows
+import org.junit.jupiter.params.ParameterizedTest
+import org.junit.jupiter.params.provider.EnumSource
+
+internal class BetaComputerActionTest {
+
+    @Test
+    fun ofClick() {
+        val click =
+            BetaComputerAction.Click.builder()
+                .button(BetaComputerAction.Click.Button.LEFT)
+                .x(0L)
+                .y(0L)
+                .addKey("string")
+                .build()
+
+        val betaComputerAction = BetaComputerAction.ofClick(click)
+
+        assertThat(betaComputerAction.click()).contains(click)
+        assertThat(betaComputerAction.doubleClick()).isEmpty
+        assertThat(betaComputerAction.drag()).isEmpty
+        assertThat(betaComputerAction.keypress()).isEmpty
+        assertThat(betaComputerAction.move()).isEmpty
+        assertThat(betaComputerAction.screenshot()).isEmpty
+        assertThat(betaComputerAction.scroll()).isEmpty
+        assertThat(betaComputerAction.type()).isEmpty
+        assertThat(betaComputerAction.wait()).isEmpty
+    }
+
+    @Test
+    fun ofClickRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaComputerAction =
+            BetaComputerAction.ofClick(
+                BetaComputerAction.Click.builder()
+                    .button(BetaComputerAction.Click.Button.LEFT)
+                    .x(0L)
+                    .y(0L)
+                    .addKey("string")
+                    .build()
+            )
+
+        val roundtrippedBetaComputerAction =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaComputerAction),
+                jacksonTypeRef<BetaComputerAction>(),
+            )
+
+        assertThat(roundtrippedBetaComputerAction).isEqualTo(betaComputerAction)
+    }
+
+    @Test
+    fun ofDoubleClick() {
+        val doubleClick =
+            BetaComputerAction.DoubleClick.builder().addKey("string").x(0L).y(0L).build()
+
+        val betaComputerAction = BetaComputerAction.ofDoubleClick(doubleClick)
+
+        assertThat(betaComputerAction.click()).isEmpty
+        assertThat(betaComputerAction.doubleClick()).contains(doubleClick)
+        assertThat(betaComputerAction.drag()).isEmpty
+        assertThat(betaComputerAction.keypress()).isEmpty
+        assertThat(betaComputerAction.move()).isEmpty
+        assertThat(betaComputerAction.screenshot()).isEmpty
+        assertThat(betaComputerAction.scroll()).isEmpty
+        assertThat(betaComputerAction.type()).isEmpty
+        assertThat(betaComputerAction.wait()).isEmpty
+    }
+
+    @Test
+    fun ofDoubleClickRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaComputerAction =
+            BetaComputerAction.ofDoubleClick(
+                BetaComputerAction.DoubleClick.builder().addKey("string").x(0L).y(0L).build()
+            )
+
+        val roundtrippedBetaComputerAction =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaComputerAction),
+                jacksonTypeRef<BetaComputerAction>(),
+            )
+
+        assertThat(roundtrippedBetaComputerAction).isEqualTo(betaComputerAction)
+    }
+
+    @Test
+    fun ofDrag() {
+        val drag =
+            BetaComputerAction.Drag.builder()
+                .addPath(BetaComputerAction.Drag.Path.builder().x(0L).y(0L).build())
+                .addKey("string")
+                .build()
+
+        val betaComputerAction = BetaComputerAction.ofDrag(drag)
+
+        assertThat(betaComputerAction.click()).isEmpty
+        assertThat(betaComputerAction.doubleClick()).isEmpty
+        assertThat(betaComputerAction.drag()).contains(drag)
+        assertThat(betaComputerAction.keypress()).isEmpty
+        assertThat(betaComputerAction.move()).isEmpty
+        assertThat(betaComputerAction.screenshot()).isEmpty
+        assertThat(betaComputerAction.scroll()).isEmpty
+        assertThat(betaComputerAction.type()).isEmpty
+        assertThat(betaComputerAction.wait()).isEmpty
+    }
+
+    @Test
+    fun ofDragRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaComputerAction =
+            BetaComputerAction.ofDrag(
+                BetaComputerAction.Drag.builder()
+                    .addPath(BetaComputerAction.Drag.Path.builder().x(0L).y(0L).build())
+                    .addKey("string")
+                    .build()
+            )
+
+        val roundtrippedBetaComputerAction =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaComputerAction),
+                jacksonTypeRef<BetaComputerAction>(),
+            )
+
+        assertThat(roundtrippedBetaComputerAction).isEqualTo(betaComputerAction)
+    }
+
+    @Test
+    fun ofKeypress() {
+        val keypress = BetaComputerAction.Keypress.builder().addKey("string").build()
+
+        val betaComputerAction = BetaComputerAction.ofKeypress(keypress)
+
+        assertThat(betaComputerAction.click()).isEmpty
+        assertThat(betaComputerAction.doubleClick()).isEmpty
+        assertThat(betaComputerAction.drag()).isEmpty
+        assertThat(betaComputerAction.keypress()).contains(keypress)
+        assertThat(betaComputerAction.move()).isEmpty
+        assertThat(betaComputerAction.screenshot()).isEmpty
+        assertThat(betaComputerAction.scroll()).isEmpty
+        assertThat(betaComputerAction.type()).isEmpty
+        assertThat(betaComputerAction.wait()).isEmpty
+    }
+
+    @Test
+    fun ofKeypressRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaComputerAction =
+            BetaComputerAction.ofKeypress(
+                BetaComputerAction.Keypress.builder().addKey("string").build()
+            )
+
+        val roundtrippedBetaComputerAction =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaComputerAction),
+                jacksonTypeRef<BetaComputerAction>(),
+            )
+
+        assertThat(roundtrippedBetaComputerAction).isEqualTo(betaComputerAction)
+    }
+
+    @Test
+    fun ofMove() {
+        val move = BetaComputerAction.Move.builder().x(0L).y(0L).addKey("string").build()
+
+        val betaComputerAction = BetaComputerAction.ofMove(move)
+
+        assertThat(betaComputerAction.click()).isEmpty
+        assertThat(betaComputerAction.doubleClick()).isEmpty
+        assertThat(betaComputerAction.drag()).isEmpty
+        assertThat(betaComputerAction.keypress()).isEmpty
+        assertThat(betaComputerAction.move()).contains(move)
+        assertThat(betaComputerAction.screenshot()).isEmpty
+        assertThat(betaComputerAction.scroll()).isEmpty
+        assertThat(betaComputerAction.type()).isEmpty
+        assertThat(betaComputerAction.wait()).isEmpty
+    }
+
+    @Test
+    fun ofMoveRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaComputerAction =
+            BetaComputerAction.ofMove(
+                BetaComputerAction.Move.builder().x(0L).y(0L).addKey("string").build()
+            )
+
+        val roundtrippedBetaComputerAction =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaComputerAction),
+                jacksonTypeRef<BetaComputerAction>(),
+            )
+
+        assertThat(roundtrippedBetaComputerAction).isEqualTo(betaComputerAction)
+    }
+
+    @Test
+    fun ofScreenshot() {
+        val betaComputerAction = BetaComputerAction.ofScreenshot()
+
+        assertThat(betaComputerAction.click()).isEmpty
+        assertThat(betaComputerAction.doubleClick()).isEmpty
+        assertThat(betaComputerAction.drag()).isEmpty
+        assertThat(betaComputerAction.keypress()).isEmpty
+        assertThat(betaComputerAction.move()).isEmpty
+        assertThat(betaComputerAction.screenshot())
+            .contains(JsonValue.from(mapOf("type" to "screenshot")))
+        assertThat(betaComputerAction.scroll()).isEmpty
+        assertThat(betaComputerAction.type()).isEmpty
+        assertThat(betaComputerAction.wait()).isEmpty
+    }
+
+    @Test
+    fun ofScreenshotRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaComputerAction = BetaComputerAction.ofScreenshot()
+
+        val roundtrippedBetaComputerAction =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaComputerAction),
+                jacksonTypeRef<BetaComputerAction>(),
+            )
+
+        assertThat(roundtrippedBetaComputerAction).isEqualTo(betaComputerAction)
+    }
+
+    @Test
+    fun ofScroll() {
+        val scroll =
+            BetaComputerAction.Scroll.builder()
+                .scrollX(0L)
+                .scrollY(0L)
+                .x(0L)
+                .y(0L)
+                .addKey("string")
+                .build()
+
+        val betaComputerAction = BetaComputerAction.ofScroll(scroll)
+
+        assertThat(betaComputerAction.click()).isEmpty
+        assertThat(betaComputerAction.doubleClick()).isEmpty
+        assertThat(betaComputerAction.drag()).isEmpty
+        assertThat(betaComputerAction.keypress()).isEmpty
+        assertThat(betaComputerAction.move()).isEmpty
+        assertThat(betaComputerAction.screenshot()).isEmpty
+        assertThat(betaComputerAction.scroll()).contains(scroll)
+        assertThat(betaComputerAction.type()).isEmpty
+        assertThat(betaComputerAction.wait()).isEmpty
+    }
+
+    @Test
+    fun ofScrollRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaComputerAction =
+            BetaComputerAction.ofScroll(
+                BetaComputerAction.Scroll.builder()
+                    .scrollX(0L)
+                    .scrollY(0L)
+                    .x(0L)
+                    .y(0L)
+                    .addKey("string")
+                    .build()
+            )
+
+        val roundtrippedBetaComputerAction =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaComputerAction),
+                jacksonTypeRef<BetaComputerAction>(),
+            )
+
+        assertThat(roundtrippedBetaComputerAction).isEqualTo(betaComputerAction)
+    }
+
+    @Test
+    fun ofType() {
+        val type = BetaComputerAction.Type.builder().text("text").build()
+
+        val betaComputerAction = BetaComputerAction.ofType(type)
+
+        assertThat(betaComputerAction.click()).isEmpty
+        assertThat(betaComputerAction.doubleClick()).isEmpty
+        assertThat(betaComputerAction.drag()).isEmpty
+        assertThat(betaComputerAction.keypress()).isEmpty
+        assertThat(betaComputerAction.move()).isEmpty
+        assertThat(betaComputerAction.screenshot()).isEmpty
+        assertThat(betaComputerAction.scroll()).isEmpty
+        assertThat(betaComputerAction.type()).contains(type)
+        assertThat(betaComputerAction.wait()).isEmpty
+    }
+
+    @Test
+    fun ofTypeRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaComputerAction =
+            BetaComputerAction.ofType(BetaComputerAction.Type.builder().text("text").build())
+
+        val roundtrippedBetaComputerAction =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaComputerAction),
+                jacksonTypeRef<BetaComputerAction>(),
+            )
+
+        assertThat(roundtrippedBetaComputerAction).isEqualTo(betaComputerAction)
+    }
+
+    @Test
+    fun ofWait() {
+        val betaComputerAction = BetaComputerAction.ofWait()
+
+        assertThat(betaComputerAction.click()).isEmpty
+        assertThat(betaComputerAction.doubleClick()).isEmpty
+        assertThat(betaComputerAction.drag()).isEmpty
+        assertThat(betaComputerAction.keypress()).isEmpty
+        assertThat(betaComputerAction.move()).isEmpty
+        assertThat(betaComputerAction.screenshot()).isEmpty
+        assertThat(betaComputerAction.scroll()).isEmpty
+        assertThat(betaComputerAction.type()).isEmpty
+        assertThat(betaComputerAction.wait()).contains(JsonValue.from(mapOf("type" to "wait")))
+    }
+
+    @Test
+    fun ofWaitRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaComputerAction = BetaComputerAction.ofWait()
+
+        val roundtrippedBetaComputerAction =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaComputerAction),
+                jacksonTypeRef<BetaComputerAction>(),
+            )
+
+        assertThat(roundtrippedBetaComputerAction).isEqualTo(betaComputerAction)
+    }
+
+    enum class IncompatibleJsonShapeTestCase(val value: JsonValue) {
+        BOOLEAN(JsonValue.from(false)),
+        STRING(JsonValue.from("invalid")),
+        INTEGER(JsonValue.from(-1)),
+        FLOAT(JsonValue.from(3.14)),
+        ARRAY(JsonValue.from(listOf("invalid", "array"))),
+    }
+
+    @ParameterizedTest
+    @EnumSource
+    fun incompatibleJsonShapeDeserializesToUnknown(testCase: IncompatibleJsonShapeTestCase) {
+        val betaComputerAction =
+            jsonMapper().convertValue(testCase.value, jacksonTypeRef<BetaComputerAction>())
+
+        val e = assertThrows<OpenAIInvalidDataException> { betaComputerAction.validate() }
+        assertThat(e).hasMessageStartingWith("Unknown ")
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaComputerToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaComputerToolTest.kt
new file mode 100644
index 000000000..f84116274
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaComputerToolTest.kt
@@ -0,0 +1,30 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaComputerToolTest {
+
+    @Test
+    fun create() {
+        val betaComputerTool = BetaComputerTool.builder().build()
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaComputerTool = BetaComputerTool.builder().build()
+
+        val roundtrippedBetaComputerTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaComputerTool),
+                jacksonTypeRef<BetaComputerTool>(),
+            )
+
+        assertThat(roundtrippedBetaComputerTool).isEqualTo(betaComputerTool)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaComputerUsePreviewToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaComputerUsePreviewToolTest.kt
new file mode 100644
index 000000000..b80536e10
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaComputerUsePreviewToolTest.kt
@@ -0,0 +1,45 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaComputerUsePreviewToolTest {
+
+    @Test
+    fun create() {
+        val betaComputerUsePreviewTool =
+            BetaComputerUsePreviewTool.builder()
+                .displayHeight(0L)
+                .displayWidth(0L)
+                .environment(BetaComputerUsePreviewTool.Environment.WINDOWS)
+                .build()
+
+        assertThat(betaComputerUsePreviewTool.displayHeight()).isEqualTo(0L)
+        assertThat(betaComputerUsePreviewTool.displayWidth()).isEqualTo(0L)
+        assertThat(betaComputerUsePreviewTool.environment())
+            .isEqualTo(BetaComputerUsePreviewTool.Environment.WINDOWS)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaComputerUsePreviewTool =
+            BetaComputerUsePreviewTool.builder()
+                .displayHeight(0L)
+                .displayWidth(0L)
+                .environment(BetaComputerUsePreviewTool.Environment.WINDOWS)
+                .build()
+
+        val roundtrippedBetaComputerUsePreviewTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaComputerUsePreviewTool),
+                jacksonTypeRef<BetaComputerUsePreviewTool>(),
+            )
+
+        assertThat(roundtrippedBetaComputerUsePreviewTool).isEqualTo(betaComputerUsePreviewTool)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerAutoTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerAutoTest.kt
new file mode 100644
index 000000000..8a3f5d448
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerAutoTest.kt
@@ -0,0 +1,58 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaContainerAutoTest {
+
+    @Test
+    fun create() {
+        val betaContainerAuto =
+            BetaContainerAuto.builder()
+                .addFileId("file-123")
+                .memoryLimit(BetaContainerAuto.MemoryLimit._1G)
+                .networkPolicy(BetaContainerNetworkPolicyDisabled.builder().build())
+                .addSkill(BetaSkillReference.builder().skillId("x").version("version").build())
+                .build()
+
+        assertThat(betaContainerAuto.fileIds().getOrNull()).containsExactly("file-123")
+        assertThat(betaContainerAuto.memoryLimit()).contains(BetaContainerAuto.MemoryLimit._1G)
+        assertThat(betaContainerAuto.networkPolicy())
+            .contains(
+                BetaContainerAuto.NetworkPolicy.ofDisabled(
+                    BetaContainerNetworkPolicyDisabled.builder().build()
+                )
+            )
+        assertThat(betaContainerAuto.skills().getOrNull())
+            .containsExactly(
+                BetaContainerAuto.Skill.ofReference(
+                    BetaSkillReference.builder().skillId("x").version("version").build()
+                )
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaContainerAuto =
+            BetaContainerAuto.builder()
+                .addFileId("file-123")
+                .memoryLimit(BetaContainerAuto.MemoryLimit._1G)
+                .networkPolicy(BetaContainerNetworkPolicyDisabled.builder().build())
+                .addSkill(BetaSkillReference.builder().skillId("x").version("version").build())
+                .build()
+
+        val roundtrippedBetaContainerAuto =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaContainerAuto),
+                jacksonTypeRef<BetaContainerAuto>(),
+            )
+
+        assertThat(roundtrippedBetaContainerAuto).isEqualTo(betaContainerAuto)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyAllowlistTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyAllowlistTest.kt
new file mode 100644
index 000000000..ee38ed578
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyAllowlistTest.kt
@@ -0,0 +1,62 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaContainerNetworkPolicyAllowlistTest {
+
+    @Test
+    fun create() {
+        val betaContainerNetworkPolicyAllowlist =
+            BetaContainerNetworkPolicyAllowlist.builder()
+                .addAllowedDomain("string")
+                .addDomainSecret(
+                    BetaContainerNetworkPolicyDomainSecret.builder()
+                        .domain("x")
+                        .name("x")
+                        .value("x")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaContainerNetworkPolicyAllowlist.allowedDomains()).containsExactly("string")
+        assertThat(betaContainerNetworkPolicyAllowlist.domainSecrets().getOrNull())
+            .containsExactly(
+                BetaContainerNetworkPolicyDomainSecret.builder()
+                    .domain("x")
+                    .name("x")
+                    .value("x")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaContainerNetworkPolicyAllowlist =
+            BetaContainerNetworkPolicyAllowlist.builder()
+                .addAllowedDomain("string")
+                .addDomainSecret(
+                    BetaContainerNetworkPolicyDomainSecret.builder()
+                        .domain("x")
+                        .name("x")
+                        .value("x")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaContainerNetworkPolicyAllowlist =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaContainerNetworkPolicyAllowlist),
+                jacksonTypeRef<BetaContainerNetworkPolicyAllowlist>(),
+            )
+
+        assertThat(roundtrippedBetaContainerNetworkPolicyAllowlist)
+            .isEqualTo(betaContainerNetworkPolicyAllowlist)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyDisabledTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyDisabledTest.kt
new file mode 100644
index 000000000..027ea5006
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyDisabledTest.kt
@@ -0,0 +1,33 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaContainerNetworkPolicyDisabledTest {
+
+    @Test
+    fun create() {
+        val betaContainerNetworkPolicyDisabled =
+            BetaContainerNetworkPolicyDisabled.builder().build()
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaContainerNetworkPolicyDisabled =
+            BetaContainerNetworkPolicyDisabled.builder().build()
+
+        val roundtrippedBetaContainerNetworkPolicyDisabled =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaContainerNetworkPolicyDisabled),
+                jacksonTypeRef<BetaContainerNetworkPolicyDisabled>(),
+            )
+
+        assertThat(roundtrippedBetaContainerNetworkPolicyDisabled)
+            .isEqualTo(betaContainerNetworkPolicyDisabled)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyDomainSecretTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyDomainSecretTest.kt
new file mode 100644
index 000000000..6dfe17064
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerNetworkPolicyDomainSecretTest.kt
@@ -0,0 +1,45 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaContainerNetworkPolicyDomainSecretTest {
+
+    @Test
+    fun create() {
+        val betaContainerNetworkPolicyDomainSecret =
+            BetaContainerNetworkPolicyDomainSecret.builder()
+                .domain("x")
+                .name("x")
+                .value("x")
+                .build()
+
+        assertThat(betaContainerNetworkPolicyDomainSecret.domain()).isEqualTo("x")
+        assertThat(betaContainerNetworkPolicyDomainSecret.name()).isEqualTo("x")
+        assertThat(betaContainerNetworkPolicyDomainSecret.value()).isEqualTo("x")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaContainerNetworkPolicyDomainSecret =
+            BetaContainerNetworkPolicyDomainSecret.builder()
+                .domain("x")
+                .name("x")
+                .value("x")
+                .build()
+
+        val roundtrippedBetaContainerNetworkPolicyDomainSecret =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaContainerNetworkPolicyDomainSecret),
+                jacksonTypeRef<BetaContainerNetworkPolicyDomainSecret>(),
+            )
+
+        assertThat(roundtrippedBetaContainerNetworkPolicyDomainSecret)
+            .isEqualTo(betaContainerNetworkPolicyDomainSecret)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerReferenceTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerReferenceTest.kt
new file mode 100644
index 000000000..dc9a5f841
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaContainerReferenceTest.kt
@@ -0,0 +1,34 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaContainerReferenceTest {
+
+    @Test
+    fun create() {
+        val betaContainerReference =
+            BetaContainerReference.builder().containerId("cntr_123").build()
+
+        assertThat(betaContainerReference.containerId()).isEqualTo("cntr_123")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaContainerReference =
+            BetaContainerReference.builder().containerId("cntr_123").build()
+
+        val roundtrippedBetaContainerReference =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaContainerReference),
+                jacksonTypeRef<BetaContainerReference>(),
+            )
+
+        assertThat(roundtrippedBetaContainerReference).isEqualTo(betaContainerReference)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaCustomToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaCustomToolTest.kt
new file mode 100644
index 000000000..24de70b1c
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaCustomToolTest.kt
@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaCustomToolTest {
+
+    @Test
+    fun create() {
+        val betaCustomTool =
+            BetaCustomTool.builder()
+                .name("name")
+                .addAllowedCaller(BetaCustomTool.AllowedCaller.DIRECT)
+                .deferLoading(true)
+                .description("description")
+                .formatText()
+                .build()
+
+        assertThat(betaCustomTool.name()).isEqualTo("name")
+        assertThat(betaCustomTool.allowedCallers().getOrNull())
+            .containsExactly(BetaCustomTool.AllowedCaller.DIRECT)
+        assertThat(betaCustomTool.deferLoading()).contains(true)
+        assertThat(betaCustomTool.description()).contains("description")
+        assertThat(betaCustomTool.format()).contains(BetaCustomTool.Format.ofText())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaCustomTool =
+            BetaCustomTool.builder()
+                .name("name")
+                .addAllowedCaller(BetaCustomTool.AllowedCaller.DIRECT)
+                .deferLoading(true)
+                .description("description")
+                .formatText()
+                .build()
+
+        val roundtrippedBetaCustomTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaCustomTool),
+                jacksonTypeRef<BetaCustomTool>(),
+            )
+
+        assertThat(roundtrippedBetaCustomTool).isEqualTo(betaCustomTool)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaEasyInputMessageTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaEasyInputMessageTest.kt
new file mode 100644
index 000000000..b134d0318
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaEasyInputMessageTest.kt
@@ -0,0 +1,48 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaEasyInputMessageTest {
+
+    @Test
+    fun create() {
+        val betaEasyInputMessage =
+            BetaEasyInputMessage.builder()
+                .content("string")
+                .role(BetaEasyInputMessage.Role.USER)
+                .phase(BetaEasyInputMessage.Phase.COMMENTARY)
+                .type(BetaEasyInputMessage.Type.MESSAGE)
+                .build()
+
+        assertThat(betaEasyInputMessage.content())
+            .isEqualTo(BetaEasyInputMessage.Content.ofTextInput("string"))
+        assertThat(betaEasyInputMessage.role()).isEqualTo(BetaEasyInputMessage.Role.USER)
+        assertThat(betaEasyInputMessage.phase()).contains(BetaEasyInputMessage.Phase.COMMENTARY)
+        assertThat(betaEasyInputMessage.type()).contains(BetaEasyInputMessage.Type.MESSAGE)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaEasyInputMessage =
+            BetaEasyInputMessage.builder()
+                .content("string")
+                .role(BetaEasyInputMessage.Role.USER)
+                .phase(BetaEasyInputMessage.Phase.COMMENTARY)
+                .type(BetaEasyInputMessage.Type.MESSAGE)
+                .build()
+
+        val roundtrippedBetaEasyInputMessage =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaEasyInputMessage),
+                jacksonTypeRef<BetaEasyInputMessage>(),
+            )
+
+        assertThat(roundtrippedBetaEasyInputMessage).isEqualTo(betaEasyInputMessage)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaFileSearchToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaFileSearchToolTest.kt
new file mode 100644
index 000000000..92589f284
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaFileSearchToolTest.kt
@@ -0,0 +1,102 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaFileSearchToolTest {
+
+    @Test
+    fun create() {
+        val betaFileSearchTool =
+            BetaFileSearchTool.builder()
+                .addVectorStoreId("string")
+                .filters(
+                    BetaFileSearchTool.Filters.ComparisonFilter.builder()
+                        .key("key")
+                        .type(BetaFileSearchTool.Filters.ComparisonFilter.Type.EQ)
+                        .value("string")
+                        .build()
+                )
+                .maxNumResults(0L)
+                .rankingOptions(
+                    BetaFileSearchTool.RankingOptions.builder()
+                        .hybridSearch(
+                            BetaFileSearchTool.RankingOptions.HybridSearch.builder()
+                                .embeddingWeight(0.0)
+                                .textWeight(0.0)
+                                .build()
+                        )
+                        .ranker(BetaFileSearchTool.RankingOptions.Ranker.AUTO)
+                        .scoreThreshold(0.0)
+                        .build()
+                )
+                .build()
+
+        assertThat(betaFileSearchTool.vectorStoreIds()).containsExactly("string")
+        assertThat(betaFileSearchTool.filters())
+            .contains(
+                BetaFileSearchTool.Filters.ofComparisonFilter(
+                    BetaFileSearchTool.Filters.ComparisonFilter.builder()
+                        .key("key")
+                        .type(BetaFileSearchTool.Filters.ComparisonFilter.Type.EQ)
+                        .value("string")
+                        .build()
+                )
+            )
+        assertThat(betaFileSearchTool.maxNumResults()).contains(0L)
+        assertThat(betaFileSearchTool.rankingOptions())
+            .contains(
+                BetaFileSearchTool.RankingOptions.builder()
+                    .hybridSearch(
+                        BetaFileSearchTool.RankingOptions.HybridSearch.builder()
+                            .embeddingWeight(0.0)
+                            .textWeight(0.0)
+                            .build()
+                    )
+                    .ranker(BetaFileSearchTool.RankingOptions.Ranker.AUTO)
+                    .scoreThreshold(0.0)
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaFileSearchTool =
+            BetaFileSearchTool.builder()
+                .addVectorStoreId("string")
+                .filters(
+                    BetaFileSearchTool.Filters.ComparisonFilter.builder()
+                        .key("key")
+                        .type(BetaFileSearchTool.Filters.ComparisonFilter.Type.EQ)
+                        .value("string")
+                        .build()
+                )
+                .maxNumResults(0L)
+                .rankingOptions(
+                    BetaFileSearchTool.RankingOptions.builder()
+                        .hybridSearch(
+                            BetaFileSearchTool.RankingOptions.HybridSearch.builder()
+                                .embeddingWeight(0.0)
+                                .textWeight(0.0)
+                                .build()
+                        )
+                        .ranker(BetaFileSearchTool.RankingOptions.Ranker.AUTO)
+                        .scoreThreshold(0.0)
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaFileSearchTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaFileSearchTool),
+                jacksonTypeRef<BetaFileSearchTool>(),
+            )
+
+        assertThat(roundtrippedBetaFileSearchTool).isEqualTo(betaFileSearchTool)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaFunctionShellToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaFunctionShellToolTest.kt
new file mode 100644
index 000000000..f449c2599
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaFunctionShellToolTest.kt
@@ -0,0 +1,73 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaFunctionShellToolTest {
+
+    @Test
+    fun create() {
+        val betaFunctionShellTool =
+            BetaFunctionShellTool.builder()
+                .addAllowedCaller(BetaFunctionShellTool.AllowedCaller.DIRECT)
+                .environment(
+                    BetaContainerAuto.builder()
+                        .addFileId("file-123")
+                        .memoryLimit(BetaContainerAuto.MemoryLimit._1G)
+                        .networkPolicy(BetaContainerNetworkPolicyDisabled.builder().build())
+                        .addSkill(
+                            BetaSkillReference.builder().skillId("x").version("version").build()
+                        )
+                        .build()
+                )
+                .build()
+
+        assertThat(betaFunctionShellTool.allowedCallers().getOrNull())
+            .containsExactly(BetaFunctionShellTool.AllowedCaller.DIRECT)
+        assertThat(betaFunctionShellTool.environment())
+            .contains(
+                BetaFunctionShellTool.Environment.ofContainerAuto(
+                    BetaContainerAuto.builder()
+                        .addFileId("file-123")
+                        .memoryLimit(BetaContainerAuto.MemoryLimit._1G)
+                        .networkPolicy(BetaContainerNetworkPolicyDisabled.builder().build())
+                        .addSkill(
+                            BetaSkillReference.builder().skillId("x").version("version").build()
+                        )
+                        .build()
+                )
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaFunctionShellTool =
+            BetaFunctionShellTool.builder()
+                .addAllowedCaller(BetaFunctionShellTool.AllowedCaller.DIRECT)
+                .environment(
+                    BetaContainerAuto.builder()
+                        .addFileId("file-123")
+                        .memoryLimit(BetaContainerAuto.MemoryLimit._1G)
+                        .networkPolicy(BetaContainerNetworkPolicyDisabled.builder().build())
+                        .addSkill(
+                            BetaSkillReference.builder().skillId("x").version("version").build()
+                        )
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaFunctionShellTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaFunctionShellTool),
+                jacksonTypeRef<BetaFunctionShellTool>(),
+            )
+
+        assertThat(roundtrippedBetaFunctionShellTool).isEqualTo(betaFunctionShellTool)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaFunctionToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaFunctionToolTest.kt
new file mode 100644
index 000000000..74b888e08
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaFunctionToolTest.kt
@@ -0,0 +1,85 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaFunctionToolTest {
+
+    @Test
+    fun create() {
+        val betaFunctionTool =
+            BetaFunctionTool.builder()
+                .name("name")
+                .parameters(
+                    BetaFunctionTool.Parameters.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                        .build()
+                )
+                .strict(true)
+                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                .deferLoading(true)
+                .description("description")
+                .outputSchema(
+                    BetaFunctionTool.OutputSchema.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                        .build()
+                )
+                .build()
+
+        assertThat(betaFunctionTool.name()).isEqualTo("name")
+        assertThat(betaFunctionTool.parameters())
+            .contains(
+                BetaFunctionTool.Parameters.builder()
+                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                    .build()
+            )
+        assertThat(betaFunctionTool.strict()).contains(true)
+        assertThat(betaFunctionTool.allowedCallers().getOrNull())
+            .containsExactly(BetaFunctionTool.AllowedCaller.DIRECT)
+        assertThat(betaFunctionTool.deferLoading()).contains(true)
+        assertThat(betaFunctionTool.description()).contains("description")
+        assertThat(betaFunctionTool.outputSchema())
+            .contains(
+                BetaFunctionTool.OutputSchema.builder()
+                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaFunctionTool =
+            BetaFunctionTool.builder()
+                .name("name")
+                .parameters(
+                    BetaFunctionTool.Parameters.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                        .build()
+                )
+                .strict(true)
+                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                .deferLoading(true)
+                .description("description")
+                .outputSchema(
+                    BetaFunctionTool.OutputSchema.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaFunctionTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaFunctionTool),
+                jacksonTypeRef<BetaFunctionTool>(),
+            )
+
+        assertThat(roundtrippedBetaFunctionTool).isEqualTo(betaFunctionTool)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaInlineSkillSourceTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaInlineSkillSourceTest.kt
new file mode 100644
index 000000000..276693e40
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaInlineSkillSourceTest.kt
@@ -0,0 +1,32 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaInlineSkillSourceTest {
+
+    @Test
+    fun create() {
+        val betaInlineSkillSource = BetaInlineSkillSource.builder().data("x").build()
+
+        assertThat(betaInlineSkillSource.data()).isEqualTo("x")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaInlineSkillSource = BetaInlineSkillSource.builder().data("x").build()
+
+        val roundtrippedBetaInlineSkillSource =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaInlineSkillSource),
+                jacksonTypeRef<BetaInlineSkillSource>(),
+            )
+
+        assertThat(roundtrippedBetaInlineSkillSource).isEqualTo(betaInlineSkillSource)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaInlineSkillTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaInlineSkillTest.kt
new file mode 100644
index 000000000..26d437e0c
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaInlineSkillTest.kt
@@ -0,0 +1,45 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaInlineSkillTest {
+
+    @Test
+    fun create() {
+        val betaInlineSkill =
+            BetaInlineSkill.builder()
+                .description("description")
+                .name("name")
+                .source(BetaInlineSkillSource.builder().data("x").build())
+                .build()
+
+        assertThat(betaInlineSkill.description()).isEqualTo("description")
+        assertThat(betaInlineSkill.name()).isEqualTo("name")
+        assertThat(betaInlineSkill.source())
+            .isEqualTo(BetaInlineSkillSource.builder().data("x").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaInlineSkill =
+            BetaInlineSkill.builder()
+                .description("description")
+                .name("name")
+                .source(BetaInlineSkillSource.builder().data("x").build())
+                .build()
+
+        val roundtrippedBetaInlineSkill =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaInlineSkill),
+                jacksonTypeRef<BetaInlineSkill>(),
+            )
+
+        assertThat(roundtrippedBetaInlineSkill).isEqualTo(betaInlineSkill)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaLocalEnvironmentTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaLocalEnvironmentTest.kt
new file mode 100644
index 000000000..0af007229
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaLocalEnvironmentTest.kt
@@ -0,0 +1,58 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaLocalEnvironmentTest {
+
+    @Test
+    fun create() {
+        val betaLocalEnvironment =
+            BetaLocalEnvironment.builder()
+                .addSkill(
+                    BetaLocalSkill.builder()
+                        .description("description")
+                        .name("name")
+                        .path("path")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaLocalEnvironment.skills().getOrNull())
+            .containsExactly(
+                BetaLocalSkill.builder()
+                    .description("description")
+                    .name("name")
+                    .path("path")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaLocalEnvironment =
+            BetaLocalEnvironment.builder()
+                .addSkill(
+                    BetaLocalSkill.builder()
+                        .description("description")
+                        .name("name")
+                        .path("path")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaLocalEnvironment =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaLocalEnvironment),
+                jacksonTypeRef<BetaLocalEnvironment>(),
+            )
+
+        assertThat(roundtrippedBetaLocalEnvironment).isEqualTo(betaLocalEnvironment)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaLocalSkillTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaLocalSkillTest.kt
new file mode 100644
index 000000000..fb0258385
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaLocalSkillTest.kt
@@ -0,0 +1,36 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaLocalSkillTest {
+
+    @Test
+    fun create() {
+        val betaLocalSkill =
+            BetaLocalSkill.builder().description("description").name("name").path("path").build()
+
+        assertThat(betaLocalSkill.description()).isEqualTo("description")
+        assertThat(betaLocalSkill.name()).isEqualTo("name")
+        assertThat(betaLocalSkill.path()).isEqualTo("path")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaLocalSkill =
+            BetaLocalSkill.builder().description("description").name("name").path("path").build()
+
+        val roundtrippedBetaLocalSkill =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaLocalSkill),
+                jacksonTypeRef<BetaLocalSkill>(),
+            )
+
+        assertThat(roundtrippedBetaLocalSkill).isEqualTo(betaLocalSkill)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaNamespaceToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaNamespaceToolTest.kt
new file mode 100644
index 000000000..d3c38ef86
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaNamespaceToolTest.kt
@@ -0,0 +1,90 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaNamespaceToolTest {
+
+    @Test
+    fun create() {
+        val betaNamespaceTool =
+            BetaNamespaceTool.builder()
+                .description("x")
+                .name("x")
+                .addTool(
+                    BetaNamespaceTool.Tool.Function.builder()
+                        .name("name")
+                        .addAllowedCaller(BetaNamespaceTool.Tool.Function.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaNamespaceTool.Tool.Function.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .parameters(JsonValue.from(mapOf<String, Any>()))
+                        .strict(true)
+                        .build()
+                )
+                .build()
+
+        assertThat(betaNamespaceTool.description()).isEqualTo("x")
+        assertThat(betaNamespaceTool.name()).isEqualTo("x")
+        assertThat(betaNamespaceTool.tools())
+            .containsExactly(
+                BetaNamespaceTool.Tool.ofFunction(
+                    BetaNamespaceTool.Tool.Function.builder()
+                        .name("name")
+                        .addAllowedCaller(BetaNamespaceTool.Tool.Function.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaNamespaceTool.Tool.Function.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .parameters(JsonValue.from(mapOf<String, Any>()))
+                        .strict(true)
+                        .build()
+                )
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaNamespaceTool =
+            BetaNamespaceTool.builder()
+                .description("x")
+                .name("x")
+                .addTool(
+                    BetaNamespaceTool.Tool.Function.builder()
+                        .name("name")
+                        .addAllowedCaller(BetaNamespaceTool.Tool.Function.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaNamespaceTool.Tool.Function.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .parameters(JsonValue.from(mapOf<String, Any>()))
+                        .strict(true)
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaNamespaceTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaNamespaceTool),
+                jacksonTypeRef<BetaNamespaceTool>(),
+            )
+
+        assertThat(roundtrippedBetaNamespaceTool).isEqualTo(betaNamespaceTool)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseApplyPatchToolCallOutputTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseApplyPatchToolCallOutputTest.kt
new file mode 100644
index 000000000..cb14bcf5d
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseApplyPatchToolCallOutputTest.kt
@@ -0,0 +1,70 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseApplyPatchToolCallOutputTest {
+
+    @Test
+    fun create() {
+        val betaResponseApplyPatchToolCallOutput =
+            BetaResponseApplyPatchToolCallOutput.builder()
+                .id("id")
+                .callId("call_id")
+                .status(BetaResponseApplyPatchToolCallOutput.Status.COMPLETED)
+                .agent(
+                    BetaResponseApplyPatchToolCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .output("output")
+                .build()
+
+        assertThat(betaResponseApplyPatchToolCallOutput.id()).isEqualTo("id")
+        assertThat(betaResponseApplyPatchToolCallOutput.callId()).isEqualTo("call_id")
+        assertThat(betaResponseApplyPatchToolCallOutput.status())
+            .isEqualTo(BetaResponseApplyPatchToolCallOutput.Status.COMPLETED)
+        assertThat(betaResponseApplyPatchToolCallOutput.agent())
+            .contains(
+                BetaResponseApplyPatchToolCallOutput.Agent.builder().agentName("agent_name").build()
+            )
+        assertThat(betaResponseApplyPatchToolCallOutput.caller())
+            .contains(BetaResponseApplyPatchToolCallOutput.Caller.ofDirect())
+        assertThat(betaResponseApplyPatchToolCallOutput.createdBy()).contains("created_by")
+        assertThat(betaResponseApplyPatchToolCallOutput.output()).contains("output")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseApplyPatchToolCallOutput =
+            BetaResponseApplyPatchToolCallOutput.builder()
+                .id("id")
+                .callId("call_id")
+                .status(BetaResponseApplyPatchToolCallOutput.Status.COMPLETED)
+                .agent(
+                    BetaResponseApplyPatchToolCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .output("output")
+                .build()
+
+        val roundtrippedBetaResponseApplyPatchToolCallOutput =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseApplyPatchToolCallOutput),
+                jacksonTypeRef<BetaResponseApplyPatchToolCallOutput>(),
+            )
+
+        assertThat(roundtrippedBetaResponseApplyPatchToolCallOutput)
+            .isEqualTo(betaResponseApplyPatchToolCallOutput)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseApplyPatchToolCallTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseApplyPatchToolCallTest.kt
new file mode 100644
index 000000000..9ffff7747
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseApplyPatchToolCallTest.kt
@@ -0,0 +1,84 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseApplyPatchToolCallTest {
+
+    @Test
+    fun create() {
+        val betaResponseApplyPatchToolCall =
+            BetaResponseApplyPatchToolCall.builder()
+                .id("id")
+                .callId("call_id")
+                .operation(
+                    BetaResponseApplyPatchToolCall.Operation.CreateFile.builder()
+                        .diff("diff")
+                        .path("path")
+                        .build()
+                )
+                .status(BetaResponseApplyPatchToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseApplyPatchToolCall.Agent.builder().agentName("agent_name").build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .build()
+
+        assertThat(betaResponseApplyPatchToolCall.id()).isEqualTo("id")
+        assertThat(betaResponseApplyPatchToolCall.callId()).isEqualTo("call_id")
+        assertThat(betaResponseApplyPatchToolCall.operation())
+            .isEqualTo(
+                BetaResponseApplyPatchToolCall.Operation.ofCreateFile(
+                    BetaResponseApplyPatchToolCall.Operation.CreateFile.builder()
+                        .diff("diff")
+                        .path("path")
+                        .build()
+                )
+            )
+        assertThat(betaResponseApplyPatchToolCall.status())
+            .isEqualTo(BetaResponseApplyPatchToolCall.Status.IN_PROGRESS)
+        assertThat(betaResponseApplyPatchToolCall.agent())
+            .contains(
+                BetaResponseApplyPatchToolCall.Agent.builder().agentName("agent_name").build()
+            )
+        assertThat(betaResponseApplyPatchToolCall.caller())
+            .contains(BetaResponseApplyPatchToolCall.Caller.ofDirect())
+        assertThat(betaResponseApplyPatchToolCall.createdBy()).contains("created_by")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseApplyPatchToolCall =
+            BetaResponseApplyPatchToolCall.builder()
+                .id("id")
+                .callId("call_id")
+                .operation(
+                    BetaResponseApplyPatchToolCall.Operation.CreateFile.builder()
+                        .diff("diff")
+                        .path("path")
+                        .build()
+                )
+                .status(BetaResponseApplyPatchToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseApplyPatchToolCall.Agent.builder().agentName("agent_name").build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .build()
+
+        val roundtrippedBetaResponseApplyPatchToolCall =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseApplyPatchToolCall),
+                jacksonTypeRef<BetaResponseApplyPatchToolCall>(),
+            )
+
+        assertThat(roundtrippedBetaResponseApplyPatchToolCall)
+            .isEqualTo(betaResponseApplyPatchToolCall)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseAudioDeltaEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseAudioDeltaEventTest.kt
new file mode 100644
index 000000000..2b6bf66e3
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseAudioDeltaEventTest.kt
@@ -0,0 +1,45 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseAudioDeltaEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseAudioDeltaEvent =
+            BetaResponseAudioDeltaEvent.builder()
+                .delta("delta")
+                .sequenceNumber(0L)
+                .agent(BetaResponseAudioDeltaEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        assertThat(betaResponseAudioDeltaEvent.delta()).isEqualTo("delta")
+        assertThat(betaResponseAudioDeltaEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseAudioDeltaEvent.agent())
+            .contains(BetaResponseAudioDeltaEvent.Agent.builder().agentName("agent_name").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseAudioDeltaEvent =
+            BetaResponseAudioDeltaEvent.builder()
+                .delta("delta")
+                .sequenceNumber(0L)
+                .agent(BetaResponseAudioDeltaEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val roundtrippedBetaResponseAudioDeltaEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseAudioDeltaEvent),
+                jacksonTypeRef<BetaResponseAudioDeltaEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseAudioDeltaEvent).isEqualTo(betaResponseAudioDeltaEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseAudioDoneEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseAudioDoneEventTest.kt
new file mode 100644
index 000000000..dc98330e9
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseAudioDoneEventTest.kt
@@ -0,0 +1,42 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseAudioDoneEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseAudioDoneEvent =
+            BetaResponseAudioDoneEvent.builder()
+                .sequenceNumber(0L)
+                .agent(BetaResponseAudioDoneEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        assertThat(betaResponseAudioDoneEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseAudioDoneEvent.agent())
+            .contains(BetaResponseAudioDoneEvent.Agent.builder().agentName("agent_name").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseAudioDoneEvent =
+            BetaResponseAudioDoneEvent.builder()
+                .sequenceNumber(0L)
+                .agent(BetaResponseAudioDoneEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val roundtrippedBetaResponseAudioDoneEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseAudioDoneEvent),
+                jacksonTypeRef<BetaResponseAudioDoneEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseAudioDoneEvent).isEqualTo(betaResponseAudioDoneEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseAudioTranscriptDeltaEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseAudioTranscriptDeltaEventTest.kt
new file mode 100644
index 000000000..634eabdd8
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseAudioTranscriptDeltaEventTest.kt
@@ -0,0 +1,58 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseAudioTranscriptDeltaEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseAudioTranscriptDeltaEvent =
+            BetaResponseAudioTranscriptDeltaEvent.builder()
+                .delta("delta")
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseAudioTranscriptDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseAudioTranscriptDeltaEvent.delta()).isEqualTo("delta")
+        assertThat(betaResponseAudioTranscriptDeltaEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseAudioTranscriptDeltaEvent.agent())
+            .contains(
+                BetaResponseAudioTranscriptDeltaEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseAudioTranscriptDeltaEvent =
+            BetaResponseAudioTranscriptDeltaEvent.builder()
+                .delta("delta")
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseAudioTranscriptDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseAudioTranscriptDeltaEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseAudioTranscriptDeltaEvent),
+                jacksonTypeRef<BetaResponseAudioTranscriptDeltaEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseAudioTranscriptDeltaEvent)
+            .isEqualTo(betaResponseAudioTranscriptDeltaEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseAudioTranscriptDoneEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseAudioTranscriptDoneEventTest.kt
new file mode 100644
index 000000000..397b4dfdf
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseAudioTranscriptDoneEventTest.kt
@@ -0,0 +1,53 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseAudioTranscriptDoneEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseAudioTranscriptDoneEvent =
+            BetaResponseAudioTranscriptDoneEvent.builder()
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseAudioTranscriptDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseAudioTranscriptDoneEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseAudioTranscriptDoneEvent.agent())
+            .contains(
+                BetaResponseAudioTranscriptDoneEvent.Agent.builder().agentName("agent_name").build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseAudioTranscriptDoneEvent =
+            BetaResponseAudioTranscriptDoneEvent.builder()
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseAudioTranscriptDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseAudioTranscriptDoneEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseAudioTranscriptDoneEvent),
+                jacksonTypeRef<BetaResponseAudioTranscriptDoneEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseAudioTranscriptDoneEvent)
+            .isEqualTo(betaResponseAudioTranscriptDoneEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCodeDeltaEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCodeDeltaEventTest.kt
new file mode 100644
index 000000000..33bfd7945
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCodeDeltaEventTest.kt
@@ -0,0 +1,64 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseCodeInterpreterCallCodeDeltaEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseCodeInterpreterCallCodeDeltaEvent =
+            BetaResponseCodeInterpreterCallCodeDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallCodeDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseCodeInterpreterCallCodeDeltaEvent.delta()).isEqualTo("delta")
+        assertThat(betaResponseCodeInterpreterCallCodeDeltaEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseCodeInterpreterCallCodeDeltaEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseCodeInterpreterCallCodeDeltaEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseCodeInterpreterCallCodeDeltaEvent.agent())
+            .contains(
+                BetaResponseCodeInterpreterCallCodeDeltaEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseCodeInterpreterCallCodeDeltaEvent =
+            BetaResponseCodeInterpreterCallCodeDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallCodeDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseCodeInterpreterCallCodeDeltaEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseCodeInterpreterCallCodeDeltaEvent),
+                jacksonTypeRef<BetaResponseCodeInterpreterCallCodeDeltaEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseCodeInterpreterCallCodeDeltaEvent)
+            .isEqualTo(betaResponseCodeInterpreterCallCodeDeltaEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCodeDoneEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCodeDoneEventTest.kt
new file mode 100644
index 000000000..e6ca92676
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCodeDoneEventTest.kt
@@ -0,0 +1,64 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseCodeInterpreterCallCodeDoneEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseCodeInterpreterCallCodeDoneEvent =
+            BetaResponseCodeInterpreterCallCodeDoneEvent.builder()
+                .code("code")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallCodeDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseCodeInterpreterCallCodeDoneEvent.code()).isEqualTo("code")
+        assertThat(betaResponseCodeInterpreterCallCodeDoneEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseCodeInterpreterCallCodeDoneEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseCodeInterpreterCallCodeDoneEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseCodeInterpreterCallCodeDoneEvent.agent())
+            .contains(
+                BetaResponseCodeInterpreterCallCodeDoneEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseCodeInterpreterCallCodeDoneEvent =
+            BetaResponseCodeInterpreterCallCodeDoneEvent.builder()
+                .code("code")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallCodeDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseCodeInterpreterCallCodeDoneEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseCodeInterpreterCallCodeDoneEvent),
+                jacksonTypeRef<BetaResponseCodeInterpreterCallCodeDoneEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseCodeInterpreterCallCodeDoneEvent)
+            .isEqualTo(betaResponseCodeInterpreterCallCodeDoneEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCompletedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCompletedEventTest.kt
new file mode 100644
index 000000000..5e86249fe
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallCompletedEventTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseCodeInterpreterCallCompletedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseCodeInterpreterCallCompletedEvent =
+            BetaResponseCodeInterpreterCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseCodeInterpreterCallCompletedEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseCodeInterpreterCallCompletedEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseCodeInterpreterCallCompletedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseCodeInterpreterCallCompletedEvent.agent())
+            .contains(
+                BetaResponseCodeInterpreterCallCompletedEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseCodeInterpreterCallCompletedEvent =
+            BetaResponseCodeInterpreterCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseCodeInterpreterCallCompletedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseCodeInterpreterCallCompletedEvent),
+                jacksonTypeRef<BetaResponseCodeInterpreterCallCompletedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseCodeInterpreterCallCompletedEvent)
+            .isEqualTo(betaResponseCodeInterpreterCallCompletedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallInProgressEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallInProgressEventTest.kt
new file mode 100644
index 000000000..1a36f09e3
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallInProgressEventTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseCodeInterpreterCallInProgressEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseCodeInterpreterCallInProgressEvent =
+            BetaResponseCodeInterpreterCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseCodeInterpreterCallInProgressEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseCodeInterpreterCallInProgressEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseCodeInterpreterCallInProgressEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseCodeInterpreterCallInProgressEvent.agent())
+            .contains(
+                BetaResponseCodeInterpreterCallInProgressEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseCodeInterpreterCallInProgressEvent =
+            BetaResponseCodeInterpreterCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseCodeInterpreterCallInProgressEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseCodeInterpreterCallInProgressEvent),
+                jacksonTypeRef<BetaResponseCodeInterpreterCallInProgressEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseCodeInterpreterCallInProgressEvent)
+            .isEqualTo(betaResponseCodeInterpreterCallInProgressEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallInterpretingEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallInterpretingEventTest.kt
new file mode 100644
index 000000000..74a049469
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterCallInterpretingEventTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseCodeInterpreterCallInterpretingEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseCodeInterpreterCallInterpretingEvent =
+            BetaResponseCodeInterpreterCallInterpretingEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallInterpretingEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseCodeInterpreterCallInterpretingEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseCodeInterpreterCallInterpretingEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseCodeInterpreterCallInterpretingEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseCodeInterpreterCallInterpretingEvent.agent())
+            .contains(
+                BetaResponseCodeInterpreterCallInterpretingEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseCodeInterpreterCallInterpretingEvent =
+            BetaResponseCodeInterpreterCallInterpretingEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallInterpretingEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseCodeInterpreterCallInterpretingEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseCodeInterpreterCallInterpretingEvent),
+                jacksonTypeRef<BetaResponseCodeInterpreterCallInterpretingEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseCodeInterpreterCallInterpretingEvent)
+            .isEqualTo(betaResponseCodeInterpreterCallInterpretingEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterToolCallTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterToolCallTest.kt
new file mode 100644
index 000000000..eae57ea30
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCodeInterpreterToolCallTest.kt
@@ -0,0 +1,72 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseCodeInterpreterToolCallTest {
+
+    @Test
+    fun create() {
+        val betaResponseCodeInterpreterToolCall =
+            BetaResponseCodeInterpreterToolCall.builder()
+                .id("id")
+                .code("code")
+                .containerId("container_id")
+                .addLogsOutput("logs")
+                .status(BetaResponseCodeInterpreterToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseCodeInterpreterToolCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseCodeInterpreterToolCall.id()).isEqualTo("id")
+        assertThat(betaResponseCodeInterpreterToolCall.code()).contains("code")
+        assertThat(betaResponseCodeInterpreterToolCall.containerId()).isEqualTo("container_id")
+        assertThat(betaResponseCodeInterpreterToolCall.outputs().getOrNull())
+            .containsExactly(
+                BetaResponseCodeInterpreterToolCall.Output.ofLogs(
+                    BetaResponseCodeInterpreterToolCall.Output.Logs.builder().logs("logs").build()
+                )
+            )
+        assertThat(betaResponseCodeInterpreterToolCall.status())
+            .isEqualTo(BetaResponseCodeInterpreterToolCall.Status.IN_PROGRESS)
+        assertThat(betaResponseCodeInterpreterToolCall.agent())
+            .contains(
+                BetaResponseCodeInterpreterToolCall.Agent.builder().agentName("agent_name").build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseCodeInterpreterToolCall =
+            BetaResponseCodeInterpreterToolCall.builder()
+                .id("id")
+                .code("code")
+                .containerId("container_id")
+                .addLogsOutput("logs")
+                .status(BetaResponseCodeInterpreterToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseCodeInterpreterToolCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseCodeInterpreterToolCall =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseCodeInterpreterToolCall),
+                jacksonTypeRef<BetaResponseCodeInterpreterToolCall>(),
+            )
+
+        assertThat(roundtrippedBetaResponseCodeInterpreterToolCall)
+            .isEqualTo(betaResponseCodeInterpreterToolCall)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCompactionItemParamTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCompactionItemParamTest.kt
new file mode 100644
index 000000000..6bd7d52e2
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCompactionItemParamTest.kt
@@ -0,0 +1,53 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseCompactionItemParamTest {
+
+    @Test
+    fun create() {
+        val betaResponseCompactionItemParam =
+            BetaResponseCompactionItemParam.builder()
+                .encryptedContent("encrypted_content")
+                .id("cmp_123")
+                .agent(
+                    BetaResponseCompactionItemParam.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        assertThat(betaResponseCompactionItemParam.encryptedContent())
+            .isEqualTo("encrypted_content")
+        assertThat(betaResponseCompactionItemParam.id()).contains("cmp_123")
+        assertThat(betaResponseCompactionItemParam.agent())
+            .contains(
+                BetaResponseCompactionItemParam.Agent.builder().agentName("agent_name").build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseCompactionItemParam =
+            BetaResponseCompactionItemParam.builder()
+                .encryptedContent("encrypted_content")
+                .id("cmp_123")
+                .agent(
+                    BetaResponseCompactionItemParam.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseCompactionItemParam =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseCompactionItemParam),
+                jacksonTypeRef<BetaResponseCompactionItemParam>(),
+            )
+
+        assertThat(roundtrippedBetaResponseCompactionItemParam)
+            .isEqualTo(betaResponseCompactionItemParam)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCompactionItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCompactionItemTest.kt
new file mode 100644
index 000000000..046c254a4
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCompactionItemTest.kt
@@ -0,0 +1,48 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseCompactionItemTest {
+
+    @Test
+    fun create() {
+        val betaResponseCompactionItem =
+            BetaResponseCompactionItem.builder()
+                .id("id")
+                .encryptedContent("encrypted_content")
+                .agent(BetaResponseCompactionItem.Agent.builder().agentName("agent_name").build())
+                .createdBy("created_by")
+                .build()
+
+        assertThat(betaResponseCompactionItem.id()).isEqualTo("id")
+        assertThat(betaResponseCompactionItem.encryptedContent()).isEqualTo("encrypted_content")
+        assertThat(betaResponseCompactionItem.agent())
+            .contains(BetaResponseCompactionItem.Agent.builder().agentName("agent_name").build())
+        assertThat(betaResponseCompactionItem.createdBy()).contains("created_by")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseCompactionItem =
+            BetaResponseCompactionItem.builder()
+                .id("id")
+                .encryptedContent("encrypted_content")
+                .agent(BetaResponseCompactionItem.Agent.builder().agentName("agent_name").build())
+                .createdBy("created_by")
+                .build()
+
+        val roundtrippedBetaResponseCompactionItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseCompactionItem),
+                jacksonTypeRef<BetaResponseCompactionItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseCompactionItem).isEqualTo(betaResponseCompactionItem)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCompletedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCompletedEventTest.kt
new file mode 100644
index 000000000..6dd94b5fc
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCompletedEventTest.kt
@@ -0,0 +1,683 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseCompletedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseCompletedEvent =
+            BetaResponseCompletedEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseCompletedEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        assertThat(betaResponseCompletedEvent.response())
+            .isEqualTo(
+                BetaResponse.builder()
+                    .id("id")
+                    .createdAt(0.0)
+                    .error(
+                        BetaResponseError.builder()
+                            .code(BetaResponseError.Code.SERVER_ERROR)
+                            .message("message")
+                            .build()
+                    )
+                    .incompleteDetails(
+                        BetaResponse.IncompleteDetails.builder()
+                            .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                            .build()
+                    )
+                    .instructions("string")
+                    .metadata(
+                        BetaResponse.Metadata.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                            .build()
+                    )
+                    .model(BetaResponse.Model.GPT_5_1)
+                    .addOutput(
+                        BetaResponseOutputMessage.builder()
+                            .id("id")
+                            .addContent(
+                                BetaResponseOutputText.builder()
+                                    .addAnnotation(
+                                        BetaResponseOutputText.Annotation.FileCitation.builder()
+                                            .fileId("file_id")
+                                            .filename("filename")
+                                            .index(0L)
+                                            .build()
+                                    )
+                                    .text("text")
+                                    .addLogprob(
+                                        BetaResponseOutputText.Logprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .addTopLogprob(
+                                                BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                            .agent(
+                                BetaResponseOutputMessage.Agent.builder()
+                                    .agentName("agent_name")
+                                    .build()
+                            )
+                            .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                            .build()
+                    )
+                    .parallelToolCalls(true)
+                    .temperature(1.0)
+                    .toolChoice(BetaToolChoiceOptions.NONE)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .topP(1.0)
+                    .background(true)
+                    .completedAt(0.0)
+                    .conversation(BetaResponse.Conversation.builder().id("id").build())
+                    .maxOutputTokens(0L)
+                    .maxToolCalls(0L)
+                    .moderation(
+                        BetaResponse.Moderation.builder()
+                            .input(
+                                BetaResponse.Moderation.Input.ModerationResult.builder()
+                                    .categories(
+                                        BetaResponse.Moderation.Input.ModerationResult.Categories
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(true))
+                                            .build()
+                                    )
+                                    .categoryAppliedInputTypes(
+                                        BetaResponse.Moderation.Input.ModerationResult
+                                            .CategoryAppliedInputTypes
+                                            .builder()
+                                            .putAdditionalProperty(
+                                                "foo",
+                                                JsonValue.from(listOf("text")),
+                                            )
+                                            .build()
+                                    )
+                                    .categoryScores(
+                                        BetaResponse.Moderation.Input.ModerationResult
+                                            .CategoryScores
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(0))
+                                            .build()
+                                    )
+                                    .flagged(true)
+                                    .model("model")
+                                    .build()
+                            )
+                            .output(
+                                BetaResponse.Moderation.Output.ModerationResult.builder()
+                                    .categories(
+                                        BetaResponse.Moderation.Output.ModerationResult.Categories
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(true))
+                                            .build()
+                                    )
+                                    .categoryAppliedInputTypes(
+                                        BetaResponse.Moderation.Output.ModerationResult
+                                            .CategoryAppliedInputTypes
+                                            .builder()
+                                            .putAdditionalProperty(
+                                                "foo",
+                                                JsonValue.from(listOf("text")),
+                                            )
+                                            .build()
+                                    )
+                                    .categoryScores(
+                                        BetaResponse.Moderation.Output.ModerationResult
+                                            .CategoryScores
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(0))
+                                            .build()
+                                    )
+                                    .flagged(true)
+                                    .model("model")
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .previousResponseId("previous_response_id")
+                    .prompt(
+                        BetaResponsePrompt.builder()
+                            .id("id")
+                            .variables(
+                                BetaResponsePrompt.Variables.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .version("version")
+                            .build()
+                    )
+                    .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        BetaResponse.PromptCacheOptions.builder()
+                            .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
+                    .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                    .reasoning(
+                        BetaResponse.Reasoning.builder()
+                            .context(BetaResponse.Reasoning.Context.AUTO)
+                            .effort(BetaResponse.Reasoning.Effort.NONE)
+                            .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                            .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                            .summary(BetaResponse.Reasoning.Summary.AUTO)
+                            .build()
+                    )
+                    .safetyIdentifier("safety-identifier-1234")
+                    .serviceTier(BetaResponse.ServiceTier.AUTO)
+                    .status(BetaResponseStatus.COMPLETED)
+                    .text(
+                        BetaResponseTextConfig.builder()
+                            .formatText()
+                            .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                            .build()
+                    )
+                    .topLogprobs(0L)
+                    .truncation(BetaResponse.Truncation.AUTO)
+                    .usage(
+                        BetaResponseUsage.builder()
+                            .inputTokens(0L)
+                            .inputTokensDetails(
+                                BetaResponseUsage.InputTokensDetails.builder()
+                                    .cacheWriteTokens(0L)
+                                    .cachedTokens(0L)
+                                    .build()
+                            )
+                            .outputTokens(0L)
+                            .outputTokensDetails(
+                                BetaResponseUsage.OutputTokensDetails.builder()
+                                    .reasoningTokens(0L)
+                                    .build()
+                            )
+                            .totalTokens(0L)
+                            .build()
+                    )
+                    .user("user-1234")
+                    .build()
+            )
+        assertThat(betaResponseCompletedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseCompletedEvent.agent())
+            .contains(BetaResponseCompletedEvent.Agent.builder().agentName("agent_name").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseCompletedEvent =
+            BetaResponseCompletedEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseCompletedEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val roundtrippedBetaResponseCompletedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseCompletedEvent),
+                jacksonTypeRef<BetaResponseCompletedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseCompletedEvent).isEqualTo(betaResponseCompletedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallOutputItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallOutputItemTest.kt
new file mode 100644
index 000000000..0af1999e9
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallOutputItemTest.kt
@@ -0,0 +1,107 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseComputerToolCallOutputItemTest {
+
+    @Test
+    fun create() {
+        val betaResponseComputerToolCallOutputItem =
+            BetaResponseComputerToolCallOutputItem.builder()
+                .id("id")
+                .callId("call_id")
+                .output(
+                    BetaResponseComputerToolCallOutputScreenshot.builder()
+                        .fileId("file_id")
+                        .imageUrl("https://example.com")
+                        .build()
+                )
+                .status(BetaResponseComputerToolCallOutputItem.Status.COMPLETED)
+                .addAcknowledgedSafetyCheck(
+                    BetaResponseComputerToolCallOutputItem.AcknowledgedSafetyCheck.builder()
+                        .id("id")
+                        .code("code")
+                        .message("message")
+                        .build()
+                )
+                .agent(
+                    BetaResponseComputerToolCallOutputItem.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .createdBy("created_by")
+                .build()
+
+        assertThat(betaResponseComputerToolCallOutputItem.id()).isEqualTo("id")
+        assertThat(betaResponseComputerToolCallOutputItem.callId()).isEqualTo("call_id")
+        assertThat(betaResponseComputerToolCallOutputItem.output())
+            .isEqualTo(
+                BetaResponseComputerToolCallOutputScreenshot.builder()
+                    .fileId("file_id")
+                    .imageUrl("https://example.com")
+                    .build()
+            )
+        assertThat(betaResponseComputerToolCallOutputItem.status())
+            .isEqualTo(BetaResponseComputerToolCallOutputItem.Status.COMPLETED)
+        assertThat(betaResponseComputerToolCallOutputItem.acknowledgedSafetyChecks().getOrNull())
+            .containsExactly(
+                BetaResponseComputerToolCallOutputItem.AcknowledgedSafetyCheck.builder()
+                    .id("id")
+                    .code("code")
+                    .message("message")
+                    .build()
+            )
+        assertThat(betaResponseComputerToolCallOutputItem.agent())
+            .contains(
+                BetaResponseComputerToolCallOutputItem.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+        assertThat(betaResponseComputerToolCallOutputItem.createdBy()).contains("created_by")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseComputerToolCallOutputItem =
+            BetaResponseComputerToolCallOutputItem.builder()
+                .id("id")
+                .callId("call_id")
+                .output(
+                    BetaResponseComputerToolCallOutputScreenshot.builder()
+                        .fileId("file_id")
+                        .imageUrl("https://example.com")
+                        .build()
+                )
+                .status(BetaResponseComputerToolCallOutputItem.Status.COMPLETED)
+                .addAcknowledgedSafetyCheck(
+                    BetaResponseComputerToolCallOutputItem.AcknowledgedSafetyCheck.builder()
+                        .id("id")
+                        .code("code")
+                        .message("message")
+                        .build()
+                )
+                .agent(
+                    BetaResponseComputerToolCallOutputItem.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .createdBy("created_by")
+                .build()
+
+        val roundtrippedBetaResponseComputerToolCallOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseComputerToolCallOutputItem),
+                jacksonTypeRef<BetaResponseComputerToolCallOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseComputerToolCallOutputItem)
+            .isEqualTo(betaResponseComputerToolCallOutputItem)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallOutputScreenshotTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallOutputScreenshotTest.kt
new file mode 100644
index 000000000..81242974f
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallOutputScreenshotTest.kt
@@ -0,0 +1,43 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseComputerToolCallOutputScreenshotTest {
+
+    @Test
+    fun create() {
+        val betaResponseComputerToolCallOutputScreenshot =
+            BetaResponseComputerToolCallOutputScreenshot.builder()
+                .fileId("file_id")
+                .imageUrl("https://example.com")
+                .build()
+
+        assertThat(betaResponseComputerToolCallOutputScreenshot.fileId()).contains("file_id")
+        assertThat(betaResponseComputerToolCallOutputScreenshot.imageUrl())
+            .contains("https://example.com")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseComputerToolCallOutputScreenshot =
+            BetaResponseComputerToolCallOutputScreenshot.builder()
+                .fileId("file_id")
+                .imageUrl("https://example.com")
+                .build()
+
+        val roundtrippedBetaResponseComputerToolCallOutputScreenshot =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseComputerToolCallOutputScreenshot),
+                jacksonTypeRef<BetaResponseComputerToolCallOutputScreenshot>(),
+            )
+
+        assertThat(roundtrippedBetaResponseComputerToolCallOutputScreenshot)
+            .isEqualTo(betaResponseComputerToolCallOutputScreenshot)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallTest.kt
new file mode 100644
index 000000000..d0d1d0697
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseComputerToolCallTest.kt
@@ -0,0 +1,130 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseComputerToolCallTest {
+
+    @Test
+    fun create() {
+        val betaResponseComputerToolCall =
+            BetaResponseComputerToolCall.builder()
+                .id("id")
+                .callId("call_id")
+                .addPendingSafetyCheck(
+                    BetaResponseComputerToolCall.PendingSafetyCheck.builder()
+                        .id("id")
+                        .code("code")
+                        .message("message")
+                        .build()
+                )
+                .status(BetaResponseComputerToolCall.Status.IN_PROGRESS)
+                .type(BetaResponseComputerToolCall.Type.COMPUTER_CALL)
+                .action(
+                    BetaComputerAction.Click.builder()
+                        .button(BetaComputerAction.Click.Button.LEFT)
+                        .x(0L)
+                        .y(0L)
+                        .addKey("string")
+                        .build()
+                )
+                .addAction(
+                    BetaComputerAction.Click.builder()
+                        .button(BetaComputerAction.Click.Button.LEFT)
+                        .x(0L)
+                        .y(0L)
+                        .addKey("string")
+                        .build()
+                )
+                .agent(BetaResponseComputerToolCall.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        assertThat(betaResponseComputerToolCall.id()).isEqualTo("id")
+        assertThat(betaResponseComputerToolCall.callId()).isEqualTo("call_id")
+        assertThat(betaResponseComputerToolCall.pendingSafetyChecks())
+            .containsExactly(
+                BetaResponseComputerToolCall.PendingSafetyCheck.builder()
+                    .id("id")
+                    .code("code")
+                    .message("message")
+                    .build()
+            )
+        assertThat(betaResponseComputerToolCall.status())
+            .isEqualTo(BetaResponseComputerToolCall.Status.IN_PROGRESS)
+        assertThat(betaResponseComputerToolCall.type())
+            .isEqualTo(BetaResponseComputerToolCall.Type.COMPUTER_CALL)
+        assertThat(betaResponseComputerToolCall.action())
+            .contains(
+                BetaComputerAction.ofClick(
+                    BetaComputerAction.Click.builder()
+                        .button(BetaComputerAction.Click.Button.LEFT)
+                        .x(0L)
+                        .y(0L)
+                        .addKey("string")
+                        .build()
+                )
+            )
+        assertThat(betaResponseComputerToolCall.actions().getOrNull())
+            .containsExactly(
+                BetaComputerAction.ofClick(
+                    BetaComputerAction.Click.builder()
+                        .button(BetaComputerAction.Click.Button.LEFT)
+                        .x(0L)
+                        .y(0L)
+                        .addKey("string")
+                        .build()
+                )
+            )
+        assertThat(betaResponseComputerToolCall.agent())
+            .contains(BetaResponseComputerToolCall.Agent.builder().agentName("agent_name").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseComputerToolCall =
+            BetaResponseComputerToolCall.builder()
+                .id("id")
+                .callId("call_id")
+                .addPendingSafetyCheck(
+                    BetaResponseComputerToolCall.PendingSafetyCheck.builder()
+                        .id("id")
+                        .code("code")
+                        .message("message")
+                        .build()
+                )
+                .status(BetaResponseComputerToolCall.Status.IN_PROGRESS)
+                .type(BetaResponseComputerToolCall.Type.COMPUTER_CALL)
+                .action(
+                    BetaComputerAction.Click.builder()
+                        .button(BetaComputerAction.Click.Button.LEFT)
+                        .x(0L)
+                        .y(0L)
+                        .addKey("string")
+                        .build()
+                )
+                .addAction(
+                    BetaComputerAction.Click.builder()
+                        .button(BetaComputerAction.Click.Button.LEFT)
+                        .x(0L)
+                        .y(0L)
+                        .addKey("string")
+                        .build()
+                )
+                .agent(BetaResponseComputerToolCall.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val roundtrippedBetaResponseComputerToolCall =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseComputerToolCall),
+                jacksonTypeRef<BetaResponseComputerToolCall>(),
+            )
+
+        assertThat(roundtrippedBetaResponseComputerToolCall).isEqualTo(betaResponseComputerToolCall)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseContainerReferenceTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseContainerReferenceTest.kt
new file mode 100644
index 000000000..cd163bd04
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseContainerReferenceTest.kt
@@ -0,0 +1,35 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseContainerReferenceTest {
+
+    @Test
+    fun create() {
+        val betaResponseContainerReference =
+            BetaResponseContainerReference.builder().containerId("container_id").build()
+
+        assertThat(betaResponseContainerReference.containerId()).isEqualTo("container_id")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseContainerReference =
+            BetaResponseContainerReference.builder().containerId("container_id").build()
+
+        val roundtrippedBetaResponseContainerReference =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseContainerReference),
+                jacksonTypeRef<BetaResponseContainerReference>(),
+            )
+
+        assertThat(roundtrippedBetaResponseContainerReference)
+            .isEqualTo(betaResponseContainerReference)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseContentPartAddedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseContentPartAddedEventTest.kt
new file mode 100644
index 000000000..9b6bc09bb
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseContentPartAddedEventTest.kt
@@ -0,0 +1,143 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseContentPartAddedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseContentPartAddedEvent =
+            BetaResponseContentPartAddedEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .part(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseContentPartAddedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseContentPartAddedEvent.contentIndex()).isEqualTo(0L)
+        assertThat(betaResponseContentPartAddedEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseContentPartAddedEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseContentPartAddedEvent.part())
+            .isEqualTo(
+                BetaResponseContentPartAddedEvent.Part.ofOutputText(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+            )
+        assertThat(betaResponseContentPartAddedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseContentPartAddedEvent.agent())
+            .contains(
+                BetaResponseContentPartAddedEvent.Agent.builder().agentName("agent_name").build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseContentPartAddedEvent =
+            BetaResponseContentPartAddedEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .part(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseContentPartAddedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseContentPartAddedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseContentPartAddedEvent),
+                jacksonTypeRef<BetaResponseContentPartAddedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseContentPartAddedEvent)
+            .isEqualTo(betaResponseContentPartAddedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseContentPartDoneEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseContentPartDoneEventTest.kt
new file mode 100644
index 000000000..c41438c25
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseContentPartDoneEventTest.kt
@@ -0,0 +1,139 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseContentPartDoneEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseContentPartDoneEvent =
+            BetaResponseContentPartDoneEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .part(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseContentPartDoneEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        assertThat(betaResponseContentPartDoneEvent.contentIndex()).isEqualTo(0L)
+        assertThat(betaResponseContentPartDoneEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseContentPartDoneEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseContentPartDoneEvent.part())
+            .isEqualTo(
+                BetaResponseContentPartDoneEvent.Part.ofOutputText(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+            )
+        assertThat(betaResponseContentPartDoneEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseContentPartDoneEvent.agent())
+            .contains(
+                BetaResponseContentPartDoneEvent.Agent.builder().agentName("agent_name").build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseContentPartDoneEvent =
+            BetaResponseContentPartDoneEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .part(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseContentPartDoneEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseContentPartDoneEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseContentPartDoneEvent),
+                jacksonTypeRef<BetaResponseContentPartDoneEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseContentPartDoneEvent)
+            .isEqualTo(betaResponseContentPartDoneEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseContentTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseContentTest.kt
new file mode 100644
index 000000000..1bd156058
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseContentTest.kt
@@ -0,0 +1,312 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import com.openai.errors.OpenAIInvalidDataException
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.assertThrows
+import org.junit.jupiter.params.ParameterizedTest
+import org.junit.jupiter.params.provider.EnumSource
+
+internal class BetaResponseContentTest {
+
+    @Test
+    fun ofInputText() {
+        val inputText =
+            BetaResponseInputText.builder()
+                .text("text")
+                .promptCacheBreakpoint(
+                    BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        val betaResponseContent = BetaResponseContent.ofInputText(inputText)
+
+        assertThat(betaResponseContent.inputText()).contains(inputText)
+        assertThat(betaResponseContent.inputImage()).isEmpty
+        assertThat(betaResponseContent.inputFile()).isEmpty
+        assertThat(betaResponseContent.outputText()).isEmpty
+        assertThat(betaResponseContent.outputRefusal()).isEmpty
+        assertThat(betaResponseContent.reasoningText()).isEmpty
+    }
+
+    @Test
+    fun ofInputTextRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseContent =
+            BetaResponseContent.ofInputText(
+                BetaResponseInputText.builder()
+                    .text("text")
+                    .promptCacheBreakpoint(
+                        BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseContent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseContent),
+                jacksonTypeRef<BetaResponseContent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseContent).isEqualTo(betaResponseContent)
+    }
+
+    @Test
+    fun ofInputImage() {
+        val inputImage =
+            BetaResponseInputImage.builder()
+                .detail(BetaResponseInputImage.Detail.LOW)
+                .fileId("file_id")
+                .imageUrl("https://example.com")
+                .promptCacheBreakpoint(
+                    BetaResponseInputImage.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        val betaResponseContent = BetaResponseContent.ofInputImage(inputImage)
+
+        assertThat(betaResponseContent.inputText()).isEmpty
+        assertThat(betaResponseContent.inputImage()).contains(inputImage)
+        assertThat(betaResponseContent.inputFile()).isEmpty
+        assertThat(betaResponseContent.outputText()).isEmpty
+        assertThat(betaResponseContent.outputRefusal()).isEmpty
+        assertThat(betaResponseContent.reasoningText()).isEmpty
+    }
+
+    @Test
+    fun ofInputImageRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseContent =
+            BetaResponseContent.ofInputImage(
+                BetaResponseInputImage.builder()
+                    .detail(BetaResponseInputImage.Detail.LOW)
+                    .fileId("file_id")
+                    .imageUrl("https://example.com")
+                    .promptCacheBreakpoint(
+                        BetaResponseInputImage.PromptCacheBreakpoint.builder().build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseContent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseContent),
+                jacksonTypeRef<BetaResponseContent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseContent).isEqualTo(betaResponseContent)
+    }
+
+    @Test
+    fun ofInputFile() {
+        val inputFile =
+            BetaResponseInputFile.builder()
+                .detail(BetaResponseInputFile.Detail.AUTO)
+                .fileData("file_data")
+                .fileId("file_id")
+                .fileUrl("https://example.com")
+                .filename("filename")
+                .promptCacheBreakpoint(
+                    BetaResponseInputFile.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        val betaResponseContent = BetaResponseContent.ofInputFile(inputFile)
+
+        assertThat(betaResponseContent.inputText()).isEmpty
+        assertThat(betaResponseContent.inputImage()).isEmpty
+        assertThat(betaResponseContent.inputFile()).contains(inputFile)
+        assertThat(betaResponseContent.outputText()).isEmpty
+        assertThat(betaResponseContent.outputRefusal()).isEmpty
+        assertThat(betaResponseContent.reasoningText()).isEmpty
+    }
+
+    @Test
+    fun ofInputFileRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseContent =
+            BetaResponseContent.ofInputFile(
+                BetaResponseInputFile.builder()
+                    .detail(BetaResponseInputFile.Detail.AUTO)
+                    .fileData("file_data")
+                    .fileId("file_id")
+                    .fileUrl("https://example.com")
+                    .filename("filename")
+                    .promptCacheBreakpoint(
+                        BetaResponseInputFile.PromptCacheBreakpoint.builder().build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseContent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseContent),
+                jacksonTypeRef<BetaResponseContent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseContent).isEqualTo(betaResponseContent)
+    }
+
+    @Test
+    fun ofOutputText() {
+        val outputText =
+            BetaResponseOutputText.builder()
+                .addAnnotation(
+                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                        .fileId("file_id")
+                        .filename("filename")
+                        .index(0L)
+                        .build()
+                )
+                .text("text")
+                .addLogprob(
+                    BetaResponseOutputText.Logprob.builder()
+                        .token("token")
+                        .addByte(0L)
+                        .logprob(0.0)
+                        .addTopLogprob(
+                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .build()
+                        )
+                        .build()
+                )
+                .build()
+
+        val betaResponseContent = BetaResponseContent.ofOutputText(outputText)
+
+        assertThat(betaResponseContent.inputText()).isEmpty
+        assertThat(betaResponseContent.inputImage()).isEmpty
+        assertThat(betaResponseContent.inputFile()).isEmpty
+        assertThat(betaResponseContent.outputText()).contains(outputText)
+        assertThat(betaResponseContent.outputRefusal()).isEmpty
+        assertThat(betaResponseContent.reasoningText()).isEmpty
+    }
+
+    @Test
+    fun ofOutputTextRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseContent =
+            BetaResponseContent.ofOutputText(
+                BetaResponseOutputText.builder()
+                    .addAnnotation(
+                        BetaResponseOutputText.Annotation.FileCitation.builder()
+                            .fileId("file_id")
+                            .filename("filename")
+                            .index(0L)
+                            .build()
+                    )
+                    .text("text")
+                    .addLogprob(
+                        BetaResponseOutputText.Logprob.builder()
+                            .token("token")
+                            .addByte(0L)
+                            .logprob(0.0)
+                            .addTopLogprob(
+                                BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                    .token("token")
+                                    .addByte(0L)
+                                    .logprob(0.0)
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseContent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseContent),
+                jacksonTypeRef<BetaResponseContent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseContent).isEqualTo(betaResponseContent)
+    }
+
+    @Test
+    fun ofOutputRefusal() {
+        val outputRefusal = BetaResponseOutputRefusal.builder().refusal("refusal").build()
+
+        val betaResponseContent = BetaResponseContent.ofOutputRefusal(outputRefusal)
+
+        assertThat(betaResponseContent.inputText()).isEmpty
+        assertThat(betaResponseContent.inputImage()).isEmpty
+        assertThat(betaResponseContent.inputFile()).isEmpty
+        assertThat(betaResponseContent.outputText()).isEmpty
+        assertThat(betaResponseContent.outputRefusal()).contains(outputRefusal)
+        assertThat(betaResponseContent.reasoningText()).isEmpty
+    }
+
+    @Test
+    fun ofOutputRefusalRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseContent =
+            BetaResponseContent.ofOutputRefusal(
+                BetaResponseOutputRefusal.builder().refusal("refusal").build()
+            )
+
+        val roundtrippedBetaResponseContent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseContent),
+                jacksonTypeRef<BetaResponseContent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseContent).isEqualTo(betaResponseContent)
+    }
+
+    @Test
+    fun ofReasoningText() {
+        val reasoningText = BetaResponseContent.ReasoningText.builder().text("text").build()
+
+        val betaResponseContent = BetaResponseContent.ofReasoningText(reasoningText)
+
+        assertThat(betaResponseContent.inputText()).isEmpty
+        assertThat(betaResponseContent.inputImage()).isEmpty
+        assertThat(betaResponseContent.inputFile()).isEmpty
+        assertThat(betaResponseContent.outputText()).isEmpty
+        assertThat(betaResponseContent.outputRefusal()).isEmpty
+        assertThat(betaResponseContent.reasoningText()).contains(reasoningText)
+    }
+
+    @Test
+    fun ofReasoningTextRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseContent =
+            BetaResponseContent.ofReasoningText(
+                BetaResponseContent.ReasoningText.builder().text("text").build()
+            )
+
+        val roundtrippedBetaResponseContent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseContent),
+                jacksonTypeRef<BetaResponseContent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseContent).isEqualTo(betaResponseContent)
+    }
+
+    enum class IncompatibleJsonShapeTestCase(val value: JsonValue) {
+        BOOLEAN(JsonValue.from(false)),
+        STRING(JsonValue.from("invalid")),
+        INTEGER(JsonValue.from(-1)),
+        FLOAT(JsonValue.from(3.14)),
+        ARRAY(JsonValue.from(listOf("invalid", "array"))),
+    }
+
+    @ParameterizedTest
+    @EnumSource
+    fun incompatibleJsonShapeDeserializesToUnknown(testCase: IncompatibleJsonShapeTestCase) {
+        val betaResponseContent =
+            jsonMapper().convertValue(testCase.value, jacksonTypeRef<BetaResponseContent>())
+
+        val e = assertThrows<OpenAIInvalidDataException> { betaResponseContent.validate() }
+        assertThat(e).hasMessageStartingWith("Unknown ")
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseConversationParamTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseConversationParamTest.kt
new file mode 100644
index 000000000..11954711e
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseConversationParamTest.kt
@@ -0,0 +1,35 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseConversationParamTest {
+
+    @Test
+    fun create() {
+        val betaResponseConversationParam =
+            BetaResponseConversationParam.builder().id("conv_123").build()
+
+        assertThat(betaResponseConversationParam.id()).isEqualTo("conv_123")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseConversationParam =
+            BetaResponseConversationParam.builder().id("conv_123").build()
+
+        val roundtrippedBetaResponseConversationParam =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseConversationParam),
+                jacksonTypeRef<BetaResponseConversationParam>(),
+            )
+
+        assertThat(roundtrippedBetaResponseConversationParam)
+            .isEqualTo(betaResponseConversationParam)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCreatedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCreatedEventTest.kt
new file mode 100644
index 000000000..08f9742c6
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCreatedEventTest.kt
@@ -0,0 +1,683 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseCreatedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseCreatedEvent =
+            BetaResponseCreatedEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseCreatedEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        assertThat(betaResponseCreatedEvent.response())
+            .isEqualTo(
+                BetaResponse.builder()
+                    .id("id")
+                    .createdAt(0.0)
+                    .error(
+                        BetaResponseError.builder()
+                            .code(BetaResponseError.Code.SERVER_ERROR)
+                            .message("message")
+                            .build()
+                    )
+                    .incompleteDetails(
+                        BetaResponse.IncompleteDetails.builder()
+                            .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                            .build()
+                    )
+                    .instructions("string")
+                    .metadata(
+                        BetaResponse.Metadata.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                            .build()
+                    )
+                    .model(BetaResponse.Model.GPT_5_1)
+                    .addOutput(
+                        BetaResponseOutputMessage.builder()
+                            .id("id")
+                            .addContent(
+                                BetaResponseOutputText.builder()
+                                    .addAnnotation(
+                                        BetaResponseOutputText.Annotation.FileCitation.builder()
+                                            .fileId("file_id")
+                                            .filename("filename")
+                                            .index(0L)
+                                            .build()
+                                    )
+                                    .text("text")
+                                    .addLogprob(
+                                        BetaResponseOutputText.Logprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .addTopLogprob(
+                                                BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                            .agent(
+                                BetaResponseOutputMessage.Agent.builder()
+                                    .agentName("agent_name")
+                                    .build()
+                            )
+                            .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                            .build()
+                    )
+                    .parallelToolCalls(true)
+                    .temperature(1.0)
+                    .toolChoice(BetaToolChoiceOptions.NONE)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .topP(1.0)
+                    .background(true)
+                    .completedAt(0.0)
+                    .conversation(BetaResponse.Conversation.builder().id("id").build())
+                    .maxOutputTokens(0L)
+                    .maxToolCalls(0L)
+                    .moderation(
+                        BetaResponse.Moderation.builder()
+                            .input(
+                                BetaResponse.Moderation.Input.ModerationResult.builder()
+                                    .categories(
+                                        BetaResponse.Moderation.Input.ModerationResult.Categories
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(true))
+                                            .build()
+                                    )
+                                    .categoryAppliedInputTypes(
+                                        BetaResponse.Moderation.Input.ModerationResult
+                                            .CategoryAppliedInputTypes
+                                            .builder()
+                                            .putAdditionalProperty(
+                                                "foo",
+                                                JsonValue.from(listOf("text")),
+                                            )
+                                            .build()
+                                    )
+                                    .categoryScores(
+                                        BetaResponse.Moderation.Input.ModerationResult
+                                            .CategoryScores
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(0))
+                                            .build()
+                                    )
+                                    .flagged(true)
+                                    .model("model")
+                                    .build()
+                            )
+                            .output(
+                                BetaResponse.Moderation.Output.ModerationResult.builder()
+                                    .categories(
+                                        BetaResponse.Moderation.Output.ModerationResult.Categories
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(true))
+                                            .build()
+                                    )
+                                    .categoryAppliedInputTypes(
+                                        BetaResponse.Moderation.Output.ModerationResult
+                                            .CategoryAppliedInputTypes
+                                            .builder()
+                                            .putAdditionalProperty(
+                                                "foo",
+                                                JsonValue.from(listOf("text")),
+                                            )
+                                            .build()
+                                    )
+                                    .categoryScores(
+                                        BetaResponse.Moderation.Output.ModerationResult
+                                            .CategoryScores
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(0))
+                                            .build()
+                                    )
+                                    .flagged(true)
+                                    .model("model")
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .previousResponseId("previous_response_id")
+                    .prompt(
+                        BetaResponsePrompt.builder()
+                            .id("id")
+                            .variables(
+                                BetaResponsePrompt.Variables.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .version("version")
+                            .build()
+                    )
+                    .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        BetaResponse.PromptCacheOptions.builder()
+                            .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
+                    .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                    .reasoning(
+                        BetaResponse.Reasoning.builder()
+                            .context(BetaResponse.Reasoning.Context.AUTO)
+                            .effort(BetaResponse.Reasoning.Effort.NONE)
+                            .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                            .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                            .summary(BetaResponse.Reasoning.Summary.AUTO)
+                            .build()
+                    )
+                    .safetyIdentifier("safety-identifier-1234")
+                    .serviceTier(BetaResponse.ServiceTier.AUTO)
+                    .status(BetaResponseStatus.COMPLETED)
+                    .text(
+                        BetaResponseTextConfig.builder()
+                            .formatText()
+                            .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                            .build()
+                    )
+                    .topLogprobs(0L)
+                    .truncation(BetaResponse.Truncation.AUTO)
+                    .usage(
+                        BetaResponseUsage.builder()
+                            .inputTokens(0L)
+                            .inputTokensDetails(
+                                BetaResponseUsage.InputTokensDetails.builder()
+                                    .cacheWriteTokens(0L)
+                                    .cachedTokens(0L)
+                                    .build()
+                            )
+                            .outputTokens(0L)
+                            .outputTokensDetails(
+                                BetaResponseUsage.OutputTokensDetails.builder()
+                                    .reasoningTokens(0L)
+                                    .build()
+                            )
+                            .totalTokens(0L)
+                            .build()
+                    )
+                    .user("user-1234")
+                    .build()
+            )
+        assertThat(betaResponseCreatedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseCreatedEvent.agent())
+            .contains(BetaResponseCreatedEvent.Agent.builder().agentName("agent_name").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseCreatedEvent =
+            BetaResponseCreatedEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseCreatedEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val roundtrippedBetaResponseCreatedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseCreatedEvent),
+                jacksonTypeRef<BetaResponseCreatedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseCreatedEvent).isEqualTo(betaResponseCreatedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallInputDeltaEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallInputDeltaEventTest.kt
new file mode 100644
index 000000000..af6d672d7
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallInputDeltaEventTest.kt
@@ -0,0 +1,64 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseCustomToolCallInputDeltaEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseCustomToolCallInputDeltaEvent =
+            BetaResponseCustomToolCallInputDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCustomToolCallInputDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseCustomToolCallInputDeltaEvent.delta()).isEqualTo("delta")
+        assertThat(betaResponseCustomToolCallInputDeltaEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseCustomToolCallInputDeltaEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseCustomToolCallInputDeltaEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseCustomToolCallInputDeltaEvent.agent())
+            .contains(
+                BetaResponseCustomToolCallInputDeltaEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseCustomToolCallInputDeltaEvent =
+            BetaResponseCustomToolCallInputDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCustomToolCallInputDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseCustomToolCallInputDeltaEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseCustomToolCallInputDeltaEvent),
+                jacksonTypeRef<BetaResponseCustomToolCallInputDeltaEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseCustomToolCallInputDeltaEvent)
+            .isEqualTo(betaResponseCustomToolCallInputDeltaEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallInputDoneEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallInputDoneEventTest.kt
new file mode 100644
index 000000000..a243a0a03
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallInputDoneEventTest.kt
@@ -0,0 +1,64 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseCustomToolCallInputDoneEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseCustomToolCallInputDoneEvent =
+            BetaResponseCustomToolCallInputDoneEvent.builder()
+                .input("input")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCustomToolCallInputDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseCustomToolCallInputDoneEvent.input()).isEqualTo("input")
+        assertThat(betaResponseCustomToolCallInputDoneEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseCustomToolCallInputDoneEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseCustomToolCallInputDoneEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseCustomToolCallInputDoneEvent.agent())
+            .contains(
+                BetaResponseCustomToolCallInputDoneEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseCustomToolCallInputDoneEvent =
+            BetaResponseCustomToolCallInputDoneEvent.builder()
+                .input("input")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCustomToolCallInputDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseCustomToolCallInputDoneEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseCustomToolCallInputDoneEvent),
+                jacksonTypeRef<BetaResponseCustomToolCallInputDoneEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseCustomToolCallInputDoneEvent)
+            .isEqualTo(betaResponseCustomToolCallInputDoneEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallItemTest.kt
new file mode 100644
index 000000000..15b69d4fe
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallItemTest.kt
@@ -0,0 +1,66 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseCustomToolCallItemTest {
+
+    @Test
+    fun create() {
+        val betaResponseCustomToolCallItem =
+            BetaResponseCustomToolCallItem.builder()
+                .callId("call_id")
+                .input("input")
+                .name("name")
+                .id("id")
+                .agent(BetaResponseCustomToolCall.Agent.builder().agentName("agent_name").build())
+                .callerDirect()
+                .namespace("namespace")
+                .status(BetaResponseCustomToolCallItem.Status.IN_PROGRESS)
+                .createdBy("created_by")
+                .build()
+
+        assertThat(betaResponseCustomToolCallItem.callId()).isEqualTo("call_id")
+        assertThat(betaResponseCustomToolCallItem.input()).isEqualTo("input")
+        assertThat(betaResponseCustomToolCallItem.name()).isEqualTo("name")
+        assertThat(betaResponseCustomToolCallItem.id()).contains("id")
+        assertThat(betaResponseCustomToolCallItem.agent())
+            .contains(BetaResponseCustomToolCall.Agent.builder().agentName("agent_name").build())
+        assertThat(betaResponseCustomToolCallItem.caller())
+            .contains(BetaResponseCustomToolCall.Caller.ofDirect())
+        assertThat(betaResponseCustomToolCallItem.namespace()).contains("namespace")
+        assertThat(betaResponseCustomToolCallItem.status())
+            .isEqualTo(BetaResponseCustomToolCallItem.Status.IN_PROGRESS)
+        assertThat(betaResponseCustomToolCallItem.createdBy()).contains("created_by")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseCustomToolCallItem =
+            BetaResponseCustomToolCallItem.builder()
+                .callId("call_id")
+                .input("input")
+                .name("name")
+                .id("id")
+                .agent(BetaResponseCustomToolCall.Agent.builder().agentName("agent_name").build())
+                .callerDirect()
+                .namespace("namespace")
+                .status(BetaResponseCustomToolCallItem.Status.IN_PROGRESS)
+                .createdBy("created_by")
+                .build()
+
+        val roundtrippedBetaResponseCustomToolCallItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseCustomToolCallItem),
+                jacksonTypeRef<BetaResponseCustomToolCallItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseCustomToolCallItem)
+            .isEqualTo(betaResponseCustomToolCallItem)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallOutputItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallOutputItemTest.kt
new file mode 100644
index 000000000..3aaf3f964
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallOutputItemTest.kt
@@ -0,0 +1,67 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseCustomToolCallOutputItemTest {
+
+    @Test
+    fun create() {
+        val betaResponseCustomToolCallOutputItem =
+            BetaResponseCustomToolCallOutputItem.builder()
+                .callId("call_id")
+                .output("string")
+                .id("id")
+                .agent(
+                    BetaResponseCustomToolCallOutput.Agent.builder().agentName("agent_name").build()
+                )
+                .callerDirect()
+                .status(BetaResponseCustomToolCallOutputItem.Status.IN_PROGRESS)
+                .createdBy("created_by")
+                .build()
+
+        assertThat(betaResponseCustomToolCallOutputItem.callId()).isEqualTo("call_id")
+        assertThat(betaResponseCustomToolCallOutputItem.output())
+            .isEqualTo(BetaResponseCustomToolCallOutput.Output.ofString("string"))
+        assertThat(betaResponseCustomToolCallOutputItem.id()).contains("id")
+        assertThat(betaResponseCustomToolCallOutputItem.agent())
+            .contains(
+                BetaResponseCustomToolCallOutput.Agent.builder().agentName("agent_name").build()
+            )
+        assertThat(betaResponseCustomToolCallOutputItem.caller())
+            .contains(BetaResponseCustomToolCallOutput.Caller.ofDirect())
+        assertThat(betaResponseCustomToolCallOutputItem.status())
+            .isEqualTo(BetaResponseCustomToolCallOutputItem.Status.IN_PROGRESS)
+        assertThat(betaResponseCustomToolCallOutputItem.createdBy()).contains("created_by")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseCustomToolCallOutputItem =
+            BetaResponseCustomToolCallOutputItem.builder()
+                .callId("call_id")
+                .output("string")
+                .id("id")
+                .agent(
+                    BetaResponseCustomToolCallOutput.Agent.builder().agentName("agent_name").build()
+                )
+                .callerDirect()
+                .status(BetaResponseCustomToolCallOutputItem.Status.IN_PROGRESS)
+                .createdBy("created_by")
+                .build()
+
+        val roundtrippedBetaResponseCustomToolCallOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseCustomToolCallOutputItem),
+                jacksonTypeRef<BetaResponseCustomToolCallOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseCustomToolCallOutputItem)
+            .isEqualTo(betaResponseCustomToolCallOutputItem)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallOutputTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallOutputTest.kt
new file mode 100644
index 000000000..f6f9c5ee8
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallOutputTest.kt
@@ -0,0 +1,60 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseCustomToolCallOutputTest {
+
+    @Test
+    fun create() {
+        val betaResponseCustomToolCallOutput =
+            BetaResponseCustomToolCallOutput.builder()
+                .callId("call_id")
+                .output("string")
+                .id("id")
+                .agent(
+                    BetaResponseCustomToolCallOutput.Agent.builder().agentName("agent_name").build()
+                )
+                .callerDirect()
+                .build()
+
+        assertThat(betaResponseCustomToolCallOutput.callId()).isEqualTo("call_id")
+        assertThat(betaResponseCustomToolCallOutput.output())
+            .isEqualTo(BetaResponseCustomToolCallOutput.Output.ofString("string"))
+        assertThat(betaResponseCustomToolCallOutput.id()).contains("id")
+        assertThat(betaResponseCustomToolCallOutput.agent())
+            .contains(
+                BetaResponseCustomToolCallOutput.Agent.builder().agentName("agent_name").build()
+            )
+        assertThat(betaResponseCustomToolCallOutput.caller())
+            .contains(BetaResponseCustomToolCallOutput.Caller.ofDirect())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseCustomToolCallOutput =
+            BetaResponseCustomToolCallOutput.builder()
+                .callId("call_id")
+                .output("string")
+                .id("id")
+                .agent(
+                    BetaResponseCustomToolCallOutput.Agent.builder().agentName("agent_name").build()
+                )
+                .callerDirect()
+                .build()
+
+        val roundtrippedBetaResponseCustomToolCallOutput =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseCustomToolCallOutput),
+                jacksonTypeRef<BetaResponseCustomToolCallOutput>(),
+            )
+
+        assertThat(roundtrippedBetaResponseCustomToolCallOutput)
+            .isEqualTo(betaResponseCustomToolCallOutput)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallTest.kt
new file mode 100644
index 000000000..e63f37fa6
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseCustomToolCallTest.kt
@@ -0,0 +1,58 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseCustomToolCallTest {
+
+    @Test
+    fun create() {
+        val betaResponseCustomToolCall =
+            BetaResponseCustomToolCall.builder()
+                .callId("call_id")
+                .input("input")
+                .name("name")
+                .id("id")
+                .agent(BetaResponseCustomToolCall.Agent.builder().agentName("agent_name").build())
+                .callerDirect()
+                .namespace("namespace")
+                .build()
+
+        assertThat(betaResponseCustomToolCall.callId()).isEqualTo("call_id")
+        assertThat(betaResponseCustomToolCall.input()).isEqualTo("input")
+        assertThat(betaResponseCustomToolCall.name()).isEqualTo("name")
+        assertThat(betaResponseCustomToolCall.id()).contains("id")
+        assertThat(betaResponseCustomToolCall.agent())
+            .contains(BetaResponseCustomToolCall.Agent.builder().agentName("agent_name").build())
+        assertThat(betaResponseCustomToolCall.caller())
+            .contains(BetaResponseCustomToolCall.Caller.ofDirect())
+        assertThat(betaResponseCustomToolCall.namespace()).contains("namespace")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseCustomToolCall =
+            BetaResponseCustomToolCall.builder()
+                .callId("call_id")
+                .input("input")
+                .name("name")
+                .id("id")
+                .agent(BetaResponseCustomToolCall.Agent.builder().agentName("agent_name").build())
+                .callerDirect()
+                .namespace("namespace")
+                .build()
+
+        val roundtrippedBetaResponseCustomToolCall =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseCustomToolCall),
+                jacksonTypeRef<BetaResponseCustomToolCall>(),
+            )
+
+        assertThat(roundtrippedBetaResponseCustomToolCall).isEqualTo(betaResponseCustomToolCall)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseErrorEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseErrorEventTest.kt
new file mode 100644
index 000000000..78b25ef36
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseErrorEventTest.kt
@@ -0,0 +1,51 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseErrorEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseErrorEvent =
+            BetaResponseErrorEvent.builder()
+                .code("code")
+                .message("message")
+                .param("param")
+                .sequenceNumber(0L)
+                .agent(BetaResponseErrorEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        assertThat(betaResponseErrorEvent.code()).contains("code")
+        assertThat(betaResponseErrorEvent.message()).isEqualTo("message")
+        assertThat(betaResponseErrorEvent.param()).contains("param")
+        assertThat(betaResponseErrorEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseErrorEvent.agent())
+            .contains(BetaResponseErrorEvent.Agent.builder().agentName("agent_name").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseErrorEvent =
+            BetaResponseErrorEvent.builder()
+                .code("code")
+                .message("message")
+                .param("param")
+                .sequenceNumber(0L)
+                .agent(BetaResponseErrorEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val roundtrippedBetaResponseErrorEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseErrorEvent),
+                jacksonTypeRef<BetaResponseErrorEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseErrorEvent).isEqualTo(betaResponseErrorEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseErrorTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseErrorTest.kt
new file mode 100644
index 000000000..4dc6271a4
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseErrorTest.kt
@@ -0,0 +1,41 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseErrorTest {
+
+    @Test
+    fun create() {
+        val betaResponseError =
+            BetaResponseError.builder()
+                .code(BetaResponseError.Code.SERVER_ERROR)
+                .message("message")
+                .build()
+
+        assertThat(betaResponseError.code()).isEqualTo(BetaResponseError.Code.SERVER_ERROR)
+        assertThat(betaResponseError.message()).isEqualTo("message")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseError =
+            BetaResponseError.builder()
+                .code(BetaResponseError.Code.SERVER_ERROR)
+                .message("message")
+                .build()
+
+        val roundtrippedBetaResponseError =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseError),
+                jacksonTypeRef<BetaResponseError>(),
+            )
+
+        assertThat(roundtrippedBetaResponseError).isEqualTo(betaResponseError)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFailedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFailedEventTest.kt
new file mode 100644
index 000000000..ddc83f66f
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFailedEventTest.kt
@@ -0,0 +1,683 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseFailedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseFailedEvent =
+            BetaResponseFailedEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseFailedEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        assertThat(betaResponseFailedEvent.response())
+            .isEqualTo(
+                BetaResponse.builder()
+                    .id("id")
+                    .createdAt(0.0)
+                    .error(
+                        BetaResponseError.builder()
+                            .code(BetaResponseError.Code.SERVER_ERROR)
+                            .message("message")
+                            .build()
+                    )
+                    .incompleteDetails(
+                        BetaResponse.IncompleteDetails.builder()
+                            .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                            .build()
+                    )
+                    .instructions("string")
+                    .metadata(
+                        BetaResponse.Metadata.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                            .build()
+                    )
+                    .model(BetaResponse.Model.GPT_5_1)
+                    .addOutput(
+                        BetaResponseOutputMessage.builder()
+                            .id("id")
+                            .addContent(
+                                BetaResponseOutputText.builder()
+                                    .addAnnotation(
+                                        BetaResponseOutputText.Annotation.FileCitation.builder()
+                                            .fileId("file_id")
+                                            .filename("filename")
+                                            .index(0L)
+                                            .build()
+                                    )
+                                    .text("text")
+                                    .addLogprob(
+                                        BetaResponseOutputText.Logprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .addTopLogprob(
+                                                BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                            .agent(
+                                BetaResponseOutputMessage.Agent.builder()
+                                    .agentName("agent_name")
+                                    .build()
+                            )
+                            .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                            .build()
+                    )
+                    .parallelToolCalls(true)
+                    .temperature(1.0)
+                    .toolChoice(BetaToolChoiceOptions.NONE)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .topP(1.0)
+                    .background(true)
+                    .completedAt(0.0)
+                    .conversation(BetaResponse.Conversation.builder().id("id").build())
+                    .maxOutputTokens(0L)
+                    .maxToolCalls(0L)
+                    .moderation(
+                        BetaResponse.Moderation.builder()
+                            .input(
+                                BetaResponse.Moderation.Input.ModerationResult.builder()
+                                    .categories(
+                                        BetaResponse.Moderation.Input.ModerationResult.Categories
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(true))
+                                            .build()
+                                    )
+                                    .categoryAppliedInputTypes(
+                                        BetaResponse.Moderation.Input.ModerationResult
+                                            .CategoryAppliedInputTypes
+                                            .builder()
+                                            .putAdditionalProperty(
+                                                "foo",
+                                                JsonValue.from(listOf("text")),
+                                            )
+                                            .build()
+                                    )
+                                    .categoryScores(
+                                        BetaResponse.Moderation.Input.ModerationResult
+                                            .CategoryScores
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(0))
+                                            .build()
+                                    )
+                                    .flagged(true)
+                                    .model("model")
+                                    .build()
+                            )
+                            .output(
+                                BetaResponse.Moderation.Output.ModerationResult.builder()
+                                    .categories(
+                                        BetaResponse.Moderation.Output.ModerationResult.Categories
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(true))
+                                            .build()
+                                    )
+                                    .categoryAppliedInputTypes(
+                                        BetaResponse.Moderation.Output.ModerationResult
+                                            .CategoryAppliedInputTypes
+                                            .builder()
+                                            .putAdditionalProperty(
+                                                "foo",
+                                                JsonValue.from(listOf("text")),
+                                            )
+                                            .build()
+                                    )
+                                    .categoryScores(
+                                        BetaResponse.Moderation.Output.ModerationResult
+                                            .CategoryScores
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(0))
+                                            .build()
+                                    )
+                                    .flagged(true)
+                                    .model("model")
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .previousResponseId("previous_response_id")
+                    .prompt(
+                        BetaResponsePrompt.builder()
+                            .id("id")
+                            .variables(
+                                BetaResponsePrompt.Variables.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .version("version")
+                            .build()
+                    )
+                    .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        BetaResponse.PromptCacheOptions.builder()
+                            .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
+                    .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                    .reasoning(
+                        BetaResponse.Reasoning.builder()
+                            .context(BetaResponse.Reasoning.Context.AUTO)
+                            .effort(BetaResponse.Reasoning.Effort.NONE)
+                            .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                            .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                            .summary(BetaResponse.Reasoning.Summary.AUTO)
+                            .build()
+                    )
+                    .safetyIdentifier("safety-identifier-1234")
+                    .serviceTier(BetaResponse.ServiceTier.AUTO)
+                    .status(BetaResponseStatus.COMPLETED)
+                    .text(
+                        BetaResponseTextConfig.builder()
+                            .formatText()
+                            .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                            .build()
+                    )
+                    .topLogprobs(0L)
+                    .truncation(BetaResponse.Truncation.AUTO)
+                    .usage(
+                        BetaResponseUsage.builder()
+                            .inputTokens(0L)
+                            .inputTokensDetails(
+                                BetaResponseUsage.InputTokensDetails.builder()
+                                    .cacheWriteTokens(0L)
+                                    .cachedTokens(0L)
+                                    .build()
+                            )
+                            .outputTokens(0L)
+                            .outputTokensDetails(
+                                BetaResponseUsage.OutputTokensDetails.builder()
+                                    .reasoningTokens(0L)
+                                    .build()
+                            )
+                            .totalTokens(0L)
+                            .build()
+                    )
+                    .user("user-1234")
+                    .build()
+            )
+        assertThat(betaResponseFailedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseFailedEvent.agent())
+            .contains(BetaResponseFailedEvent.Agent.builder().agentName("agent_name").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFailedEvent =
+            BetaResponseFailedEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseFailedEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val roundtrippedBetaResponseFailedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFailedEvent),
+                jacksonTypeRef<BetaResponseFailedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFailedEvent).isEqualTo(betaResponseFailedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallCompletedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallCompletedEventTest.kt
new file mode 100644
index 000000000..4eeb1bd45
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallCompletedEventTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseFileSearchCallCompletedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseFileSearchCallCompletedEvent =
+            BetaResponseFileSearchCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFileSearchCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseFileSearchCallCompletedEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseFileSearchCallCompletedEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseFileSearchCallCompletedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseFileSearchCallCompletedEvent.agent())
+            .contains(
+                BetaResponseFileSearchCallCompletedEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFileSearchCallCompletedEvent =
+            BetaResponseFileSearchCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFileSearchCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseFileSearchCallCompletedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFileSearchCallCompletedEvent),
+                jacksonTypeRef<BetaResponseFileSearchCallCompletedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFileSearchCallCompletedEvent)
+            .isEqualTo(betaResponseFileSearchCallCompletedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallInProgressEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallInProgressEventTest.kt
new file mode 100644
index 000000000..6afdba7f9
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallInProgressEventTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseFileSearchCallInProgressEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseFileSearchCallInProgressEvent =
+            BetaResponseFileSearchCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFileSearchCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseFileSearchCallInProgressEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseFileSearchCallInProgressEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseFileSearchCallInProgressEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseFileSearchCallInProgressEvent.agent())
+            .contains(
+                BetaResponseFileSearchCallInProgressEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFileSearchCallInProgressEvent =
+            BetaResponseFileSearchCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFileSearchCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseFileSearchCallInProgressEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFileSearchCallInProgressEvent),
+                jacksonTypeRef<BetaResponseFileSearchCallInProgressEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFileSearchCallInProgressEvent)
+            .isEqualTo(betaResponseFileSearchCallInProgressEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallSearchingEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallSearchingEventTest.kt
new file mode 100644
index 000000000..f4f71bf82
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchCallSearchingEventTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseFileSearchCallSearchingEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseFileSearchCallSearchingEvent =
+            BetaResponseFileSearchCallSearchingEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFileSearchCallSearchingEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseFileSearchCallSearchingEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseFileSearchCallSearchingEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseFileSearchCallSearchingEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseFileSearchCallSearchingEvent.agent())
+            .contains(
+                BetaResponseFileSearchCallSearchingEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFileSearchCallSearchingEvent =
+            BetaResponseFileSearchCallSearchingEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFileSearchCallSearchingEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseFileSearchCallSearchingEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFileSearchCallSearchingEvent),
+                jacksonTypeRef<BetaResponseFileSearchCallSearchingEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFileSearchCallSearchingEvent)
+            .isEqualTo(betaResponseFileSearchCallSearchingEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchToolCallTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchToolCallTest.kt
new file mode 100644
index 000000000..ec5894cf3
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFileSearchToolCallTest.kt
@@ -0,0 +1,98 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseFileSearchToolCallTest {
+
+    @Test
+    fun create() {
+        val betaResponseFileSearchToolCall =
+            BetaResponseFileSearchToolCall.builder()
+                .id("id")
+                .addQuery("string")
+                .status(BetaResponseFileSearchToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFileSearchToolCall.Agent.builder().agentName("agent_name").build()
+                )
+                .addResult(
+                    BetaResponseFileSearchToolCall.Result.builder()
+                        .attributes(
+                            BetaResponseFileSearchToolCall.Result.Attributes.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .fileId("file_id")
+                        .filename("filename")
+                        .score(0.0f)
+                        .text("text")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseFileSearchToolCall.id()).isEqualTo("id")
+        assertThat(betaResponseFileSearchToolCall.queries()).containsExactly("string")
+        assertThat(betaResponseFileSearchToolCall.status())
+            .isEqualTo(BetaResponseFileSearchToolCall.Status.IN_PROGRESS)
+        assertThat(betaResponseFileSearchToolCall.agent())
+            .contains(
+                BetaResponseFileSearchToolCall.Agent.builder().agentName("agent_name").build()
+            )
+        assertThat(betaResponseFileSearchToolCall.results().getOrNull())
+            .containsExactly(
+                BetaResponseFileSearchToolCall.Result.builder()
+                    .attributes(
+                        BetaResponseFileSearchToolCall.Result.Attributes.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                            .build()
+                    )
+                    .fileId("file_id")
+                    .filename("filename")
+                    .score(0.0f)
+                    .text("text")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFileSearchToolCall =
+            BetaResponseFileSearchToolCall.builder()
+                .id("id")
+                .addQuery("string")
+                .status(BetaResponseFileSearchToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFileSearchToolCall.Agent.builder().agentName("agent_name").build()
+                )
+                .addResult(
+                    BetaResponseFileSearchToolCall.Result.builder()
+                        .attributes(
+                            BetaResponseFileSearchToolCall.Result.Attributes.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .fileId("file_id")
+                        .filename("filename")
+                        .score(0.0f)
+                        .text("text")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseFileSearchToolCall =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFileSearchToolCall),
+                jacksonTypeRef<BetaResponseFileSearchToolCall>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFileSearchToolCall)
+            .isEqualTo(betaResponseFileSearchToolCall)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFormatTextConfigTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFormatTextConfigTest.kt
new file mode 100644
index 000000000..02b475b63
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFormatTextConfigTest.kt
@@ -0,0 +1,130 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import com.openai.errors.OpenAIInvalidDataException
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.assertThrows
+import org.junit.jupiter.params.ParameterizedTest
+import org.junit.jupiter.params.provider.EnumSource
+
+internal class BetaResponseFormatTextConfigTest {
+
+    @Test
+    fun ofText() {
+        val betaResponseFormatTextConfig = BetaResponseFormatTextConfig.ofText()
+
+        assertThat(betaResponseFormatTextConfig.text())
+            .contains(JsonValue.from(mapOf("type" to "text")))
+        assertThat(betaResponseFormatTextConfig.jsonSchema()).isEmpty
+        assertThat(betaResponseFormatTextConfig.jsonObject()).isEmpty
+    }
+
+    @Test
+    fun ofTextRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFormatTextConfig = BetaResponseFormatTextConfig.ofText()
+
+        val roundtrippedBetaResponseFormatTextConfig =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFormatTextConfig),
+                jacksonTypeRef<BetaResponseFormatTextConfig>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFormatTextConfig).isEqualTo(betaResponseFormatTextConfig)
+    }
+
+    @Test
+    fun ofJsonSchema() {
+        val jsonSchema =
+            BetaResponseFormatTextJsonSchemaConfig.builder()
+                .name("name")
+                .schema(
+                    BetaResponseFormatTextJsonSchemaConfig.Schema.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                        .build()
+                )
+                .description("description")
+                .strict(true)
+                .build()
+
+        val betaResponseFormatTextConfig = BetaResponseFormatTextConfig.ofJsonSchema(jsonSchema)
+
+        assertThat(betaResponseFormatTextConfig.text()).isEmpty
+        assertThat(betaResponseFormatTextConfig.jsonSchema()).contains(jsonSchema)
+        assertThat(betaResponseFormatTextConfig.jsonObject()).isEmpty
+    }
+
+    @Test
+    fun ofJsonSchemaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFormatTextConfig =
+            BetaResponseFormatTextConfig.ofJsonSchema(
+                BetaResponseFormatTextJsonSchemaConfig.builder()
+                    .name("name")
+                    .schema(
+                        BetaResponseFormatTextJsonSchemaConfig.Schema.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                            .build()
+                    )
+                    .description("description")
+                    .strict(true)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseFormatTextConfig =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFormatTextConfig),
+                jacksonTypeRef<BetaResponseFormatTextConfig>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFormatTextConfig).isEqualTo(betaResponseFormatTextConfig)
+    }
+
+    @Test
+    fun ofJsonObject() {
+        val betaResponseFormatTextConfig = BetaResponseFormatTextConfig.ofJsonObject()
+
+        assertThat(betaResponseFormatTextConfig.text()).isEmpty
+        assertThat(betaResponseFormatTextConfig.jsonSchema()).isEmpty
+        assertThat(betaResponseFormatTextConfig.jsonObject())
+            .contains(JsonValue.from(mapOf("type" to "json_object")))
+    }
+
+    @Test
+    fun ofJsonObjectRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFormatTextConfig = BetaResponseFormatTextConfig.ofJsonObject()
+
+        val roundtrippedBetaResponseFormatTextConfig =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFormatTextConfig),
+                jacksonTypeRef<BetaResponseFormatTextConfig>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFormatTextConfig).isEqualTo(betaResponseFormatTextConfig)
+    }
+
+    enum class IncompatibleJsonShapeTestCase(val value: JsonValue) {
+        BOOLEAN(JsonValue.from(false)),
+        STRING(JsonValue.from("invalid")),
+        INTEGER(JsonValue.from(-1)),
+        FLOAT(JsonValue.from(3.14)),
+        ARRAY(JsonValue.from(listOf("invalid", "array"))),
+    }
+
+    @ParameterizedTest
+    @EnumSource
+    fun incompatibleJsonShapeDeserializesToUnknown(testCase: IncompatibleJsonShapeTestCase) {
+        val betaResponseFormatTextConfig =
+            jsonMapper()
+                .convertValue(testCase.value, jacksonTypeRef<BetaResponseFormatTextConfig>())
+
+        val e = assertThrows<OpenAIInvalidDataException> { betaResponseFormatTextConfig.validate() }
+        assertThat(e).hasMessageStartingWith("Unknown ")
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFormatTextJsonSchemaConfigTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFormatTextJsonSchemaConfigTest.kt
new file mode 100644
index 000000000..1741dadcc
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFormatTextJsonSchemaConfigTest.kt
@@ -0,0 +1,62 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseFormatTextJsonSchemaConfigTest {
+
+    @Test
+    fun create() {
+        val betaResponseFormatTextJsonSchemaConfig =
+            BetaResponseFormatTextJsonSchemaConfig.builder()
+                .name("name")
+                .schema(
+                    BetaResponseFormatTextJsonSchemaConfig.Schema.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                        .build()
+                )
+                .description("description")
+                .strict(true)
+                .build()
+
+        assertThat(betaResponseFormatTextJsonSchemaConfig.name()).isEqualTo("name")
+        assertThat(betaResponseFormatTextJsonSchemaConfig.schema())
+            .isEqualTo(
+                BetaResponseFormatTextJsonSchemaConfig.Schema.builder()
+                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                    .build()
+            )
+        assertThat(betaResponseFormatTextJsonSchemaConfig.description()).contains("description")
+        assertThat(betaResponseFormatTextJsonSchemaConfig.strict()).contains(true)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFormatTextJsonSchemaConfig =
+            BetaResponseFormatTextJsonSchemaConfig.builder()
+                .name("name")
+                .schema(
+                    BetaResponseFormatTextJsonSchemaConfig.Schema.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                        .build()
+                )
+                .description("description")
+                .strict(true)
+                .build()
+
+        val roundtrippedBetaResponseFormatTextJsonSchemaConfig =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFormatTextJsonSchemaConfig),
+                jacksonTypeRef<BetaResponseFormatTextJsonSchemaConfig>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFormatTextJsonSchemaConfig)
+            .isEqualTo(betaResponseFormatTextJsonSchemaConfig)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallArgumentsDeltaEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallArgumentsDeltaEventTest.kt
new file mode 100644
index 000000000..db8971c04
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallArgumentsDeltaEventTest.kt
@@ -0,0 +1,64 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseFunctionCallArgumentsDeltaEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseFunctionCallArgumentsDeltaEvent =
+            BetaResponseFunctionCallArgumentsDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFunctionCallArgumentsDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseFunctionCallArgumentsDeltaEvent.delta()).isEqualTo("delta")
+        assertThat(betaResponseFunctionCallArgumentsDeltaEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseFunctionCallArgumentsDeltaEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseFunctionCallArgumentsDeltaEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseFunctionCallArgumentsDeltaEvent.agent())
+            .contains(
+                BetaResponseFunctionCallArgumentsDeltaEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFunctionCallArgumentsDeltaEvent =
+            BetaResponseFunctionCallArgumentsDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFunctionCallArgumentsDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseFunctionCallArgumentsDeltaEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFunctionCallArgumentsDeltaEvent),
+                jacksonTypeRef<BetaResponseFunctionCallArgumentsDeltaEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFunctionCallArgumentsDeltaEvent)
+            .isEqualTo(betaResponseFunctionCallArgumentsDeltaEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallArgumentsDoneEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallArgumentsDoneEventTest.kt
new file mode 100644
index 000000000..82c6f95a1
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallArgumentsDoneEventTest.kt
@@ -0,0 +1,67 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseFunctionCallArgumentsDoneEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseFunctionCallArgumentsDoneEvent =
+            BetaResponseFunctionCallArgumentsDoneEvent.builder()
+                .arguments("arguments")
+                .itemId("item_id")
+                .name("name")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFunctionCallArgumentsDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseFunctionCallArgumentsDoneEvent.arguments()).isEqualTo("arguments")
+        assertThat(betaResponseFunctionCallArgumentsDoneEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseFunctionCallArgumentsDoneEvent.name()).isEqualTo("name")
+        assertThat(betaResponseFunctionCallArgumentsDoneEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseFunctionCallArgumentsDoneEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseFunctionCallArgumentsDoneEvent.agent())
+            .contains(
+                BetaResponseFunctionCallArgumentsDoneEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFunctionCallArgumentsDoneEvent =
+            BetaResponseFunctionCallArgumentsDoneEvent.builder()
+                .arguments("arguments")
+                .itemId("item_id")
+                .name("name")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFunctionCallArgumentsDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseFunctionCallArgumentsDoneEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFunctionCallArgumentsDoneEvent),
+                jacksonTypeRef<BetaResponseFunctionCallArgumentsDoneEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFunctionCallArgumentsDoneEvent)
+            .isEqualTo(betaResponseFunctionCallArgumentsDoneEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallOutputItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallOutputItemTest.kt
new file mode 100644
index 000000000..5861e772b
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionCallOutputItemTest.kt
@@ -0,0 +1,173 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import com.openai.errors.OpenAIInvalidDataException
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.assertThrows
+import org.junit.jupiter.params.ParameterizedTest
+import org.junit.jupiter.params.provider.EnumSource
+
+internal class BetaResponseFunctionCallOutputItemTest {
+
+    @Test
+    fun ofInputText() {
+        val inputText =
+            BetaResponseInputTextContent.builder()
+                .text("text")
+                .promptCacheBreakpoint(
+                    BetaResponseInputTextContent.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        val betaResponseFunctionCallOutputItem =
+            BetaResponseFunctionCallOutputItem.ofInputText(inputText)
+
+        assertThat(betaResponseFunctionCallOutputItem.inputText()).contains(inputText)
+        assertThat(betaResponseFunctionCallOutputItem.inputImage()).isEmpty
+        assertThat(betaResponseFunctionCallOutputItem.inputFile()).isEmpty
+    }
+
+    @Test
+    fun ofInputTextRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFunctionCallOutputItem =
+            BetaResponseFunctionCallOutputItem.ofInputText(
+                BetaResponseInputTextContent.builder()
+                    .text("text")
+                    .promptCacheBreakpoint(
+                        BetaResponseInputTextContent.PromptCacheBreakpoint.builder().build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseFunctionCallOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFunctionCallOutputItem),
+                jacksonTypeRef<BetaResponseFunctionCallOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFunctionCallOutputItem)
+            .isEqualTo(betaResponseFunctionCallOutputItem)
+    }
+
+    @Test
+    fun ofInputImage() {
+        val inputImage =
+            BetaResponseInputImageContent.builder()
+                .detail(BetaResponseInputImageContent.Detail.LOW)
+                .fileId("file-123")
+                .imageUrl("https://example.com")
+                .promptCacheBreakpoint(
+                    BetaResponseInputImageContent.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        val betaResponseFunctionCallOutputItem =
+            BetaResponseFunctionCallOutputItem.ofInputImage(inputImage)
+
+        assertThat(betaResponseFunctionCallOutputItem.inputText()).isEmpty
+        assertThat(betaResponseFunctionCallOutputItem.inputImage()).contains(inputImage)
+        assertThat(betaResponseFunctionCallOutputItem.inputFile()).isEmpty
+    }
+
+    @Test
+    fun ofInputImageRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFunctionCallOutputItem =
+            BetaResponseFunctionCallOutputItem.ofInputImage(
+                BetaResponseInputImageContent.builder()
+                    .detail(BetaResponseInputImageContent.Detail.LOW)
+                    .fileId("file-123")
+                    .imageUrl("https://example.com")
+                    .promptCacheBreakpoint(
+                        BetaResponseInputImageContent.PromptCacheBreakpoint.builder().build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseFunctionCallOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFunctionCallOutputItem),
+                jacksonTypeRef<BetaResponseFunctionCallOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFunctionCallOutputItem)
+            .isEqualTo(betaResponseFunctionCallOutputItem)
+    }
+
+    @Test
+    fun ofInputFile() {
+        val inputFile =
+            BetaResponseInputFileContent.builder()
+                .detail(BetaResponseInputFileContent.Detail.AUTO)
+                .fileData("file_data")
+                .fileId("file-123")
+                .fileUrl("https://example.com")
+                .filename("filename")
+                .promptCacheBreakpoint(
+                    BetaResponseInputFileContent.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        val betaResponseFunctionCallOutputItem =
+            BetaResponseFunctionCallOutputItem.ofInputFile(inputFile)
+
+        assertThat(betaResponseFunctionCallOutputItem.inputText()).isEmpty
+        assertThat(betaResponseFunctionCallOutputItem.inputImage()).isEmpty
+        assertThat(betaResponseFunctionCallOutputItem.inputFile()).contains(inputFile)
+    }
+
+    @Test
+    fun ofInputFileRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFunctionCallOutputItem =
+            BetaResponseFunctionCallOutputItem.ofInputFile(
+                BetaResponseInputFileContent.builder()
+                    .detail(BetaResponseInputFileContent.Detail.AUTO)
+                    .fileData("file_data")
+                    .fileId("file-123")
+                    .fileUrl("https://example.com")
+                    .filename("filename")
+                    .promptCacheBreakpoint(
+                        BetaResponseInputFileContent.PromptCacheBreakpoint.builder().build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseFunctionCallOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFunctionCallOutputItem),
+                jacksonTypeRef<BetaResponseFunctionCallOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFunctionCallOutputItem)
+            .isEqualTo(betaResponseFunctionCallOutputItem)
+    }
+
+    enum class IncompatibleJsonShapeTestCase(val value: JsonValue) {
+        BOOLEAN(JsonValue.from(false)),
+        STRING(JsonValue.from("invalid")),
+        INTEGER(JsonValue.from(-1)),
+        FLOAT(JsonValue.from(3.14)),
+        ARRAY(JsonValue.from(listOf("invalid", "array"))),
+    }
+
+    @ParameterizedTest
+    @EnumSource
+    fun incompatibleJsonShapeDeserializesToUnknown(testCase: IncompatibleJsonShapeTestCase) {
+        val betaResponseFunctionCallOutputItem =
+            jsonMapper()
+                .convertValue(testCase.value, jacksonTypeRef<BetaResponseFunctionCallOutputItem>())
+
+        val e =
+            assertThrows<OpenAIInvalidDataException> {
+                betaResponseFunctionCallOutputItem.validate()
+            }
+        assertThat(e).hasMessageStartingWith("Unknown ")
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellCallOutputContentTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellCallOutputContentTest.kt
new file mode 100644
index 000000000..88328ad66
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellCallOutputContentTest.kt
@@ -0,0 +1,46 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseFunctionShellCallOutputContentTest {
+
+    @Test
+    fun create() {
+        val betaResponseFunctionShellCallOutputContent =
+            BetaResponseFunctionShellCallOutputContent.builder()
+                .outcomeTimeout()
+                .stderr("stderr")
+                .stdout("stdout")
+                .build()
+
+        assertThat(betaResponseFunctionShellCallOutputContent.outcome())
+            .isEqualTo(BetaResponseFunctionShellCallOutputContent.Outcome.ofTimeout())
+        assertThat(betaResponseFunctionShellCallOutputContent.stderr()).isEqualTo("stderr")
+        assertThat(betaResponseFunctionShellCallOutputContent.stdout()).isEqualTo("stdout")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFunctionShellCallOutputContent =
+            BetaResponseFunctionShellCallOutputContent.builder()
+                .outcomeTimeout()
+                .stderr("stderr")
+                .stdout("stdout")
+                .build()
+
+        val roundtrippedBetaResponseFunctionShellCallOutputContent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFunctionShellCallOutputContent),
+                jacksonTypeRef<BetaResponseFunctionShellCallOutputContent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFunctionShellCallOutputContent)
+            .isEqualTo(betaResponseFunctionShellCallOutputContent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellToolCallOutputTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellToolCallOutputTest.kt
new file mode 100644
index 000000000..5a7bc7d02
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellToolCallOutputTest.kt
@@ -0,0 +1,97 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseFunctionShellToolCallOutputTest {
+
+    @Test
+    fun create() {
+        val betaResponseFunctionShellToolCallOutput =
+            BetaResponseFunctionShellToolCallOutput.builder()
+                .id("id")
+                .callId("call_id")
+                .maxOutputLength(0L)
+                .addOutput(
+                    BetaResponseFunctionShellToolCallOutput.Output.builder()
+                        .outcomeTimeout()
+                        .stderr("stderr")
+                        .stdout("stdout")
+                        .createdBy("created_by")
+                        .build()
+                )
+                .status(BetaResponseFunctionShellToolCallOutput.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionShellToolCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .build()
+
+        assertThat(betaResponseFunctionShellToolCallOutput.id()).isEqualTo("id")
+        assertThat(betaResponseFunctionShellToolCallOutput.callId()).isEqualTo("call_id")
+        assertThat(betaResponseFunctionShellToolCallOutput.maxOutputLength()).contains(0L)
+        assertThat(betaResponseFunctionShellToolCallOutput.output())
+            .containsExactly(
+                BetaResponseFunctionShellToolCallOutput.Output.builder()
+                    .outcomeTimeout()
+                    .stderr("stderr")
+                    .stdout("stdout")
+                    .createdBy("created_by")
+                    .build()
+            )
+        assertThat(betaResponseFunctionShellToolCallOutput.status())
+            .isEqualTo(BetaResponseFunctionShellToolCallOutput.Status.IN_PROGRESS)
+        assertThat(betaResponseFunctionShellToolCallOutput.agent())
+            .contains(
+                BetaResponseFunctionShellToolCallOutput.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+        assertThat(betaResponseFunctionShellToolCallOutput.caller())
+            .contains(BetaResponseFunctionShellToolCallOutput.Caller.ofDirect())
+        assertThat(betaResponseFunctionShellToolCallOutput.createdBy()).contains("created_by")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFunctionShellToolCallOutput =
+            BetaResponseFunctionShellToolCallOutput.builder()
+                .id("id")
+                .callId("call_id")
+                .maxOutputLength(0L)
+                .addOutput(
+                    BetaResponseFunctionShellToolCallOutput.Output.builder()
+                        .outcomeTimeout()
+                        .stderr("stderr")
+                        .stdout("stdout")
+                        .createdBy("created_by")
+                        .build()
+                )
+                .status(BetaResponseFunctionShellToolCallOutput.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionShellToolCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .build()
+
+        val roundtrippedBetaResponseFunctionShellToolCallOutput =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFunctionShellToolCallOutput),
+                jacksonTypeRef<BetaResponseFunctionShellToolCallOutput>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFunctionShellToolCallOutput)
+            .isEqualTo(betaResponseFunctionShellToolCallOutput)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellToolCallTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellToolCallTest.kt
new file mode 100644
index 000000000..c43868cb0
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionShellToolCallTest.kt
@@ -0,0 +1,97 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseFunctionShellToolCallTest {
+
+    @Test
+    fun create() {
+        val betaResponseFunctionShellToolCall =
+            BetaResponseFunctionShellToolCall.builder()
+                .id("id")
+                .action(
+                    BetaResponseFunctionShellToolCall.Action.builder()
+                        .addCommand("string")
+                        .maxOutputLength(0L)
+                        .timeoutMs(0L)
+                        .build()
+                )
+                .callId("call_id")
+                .environment(BetaResponseLocalEnvironment.builder().build())
+                .status(BetaResponseFunctionShellToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionShellToolCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .build()
+
+        assertThat(betaResponseFunctionShellToolCall.id()).isEqualTo("id")
+        assertThat(betaResponseFunctionShellToolCall.action())
+            .isEqualTo(
+                BetaResponseFunctionShellToolCall.Action.builder()
+                    .addCommand("string")
+                    .maxOutputLength(0L)
+                    .timeoutMs(0L)
+                    .build()
+            )
+        assertThat(betaResponseFunctionShellToolCall.callId()).isEqualTo("call_id")
+        assertThat(betaResponseFunctionShellToolCall.environment())
+            .contains(
+                BetaResponseFunctionShellToolCall.Environment.ofLocal(
+                    BetaResponseLocalEnvironment.builder().build()
+                )
+            )
+        assertThat(betaResponseFunctionShellToolCall.status())
+            .isEqualTo(BetaResponseFunctionShellToolCall.Status.IN_PROGRESS)
+        assertThat(betaResponseFunctionShellToolCall.agent())
+            .contains(
+                BetaResponseFunctionShellToolCall.Agent.builder().agentName("agent_name").build()
+            )
+        assertThat(betaResponseFunctionShellToolCall.caller())
+            .contains(BetaResponseFunctionShellToolCall.Caller.ofDirect())
+        assertThat(betaResponseFunctionShellToolCall.createdBy()).contains("created_by")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFunctionShellToolCall =
+            BetaResponseFunctionShellToolCall.builder()
+                .id("id")
+                .action(
+                    BetaResponseFunctionShellToolCall.Action.builder()
+                        .addCommand("string")
+                        .maxOutputLength(0L)
+                        .timeoutMs(0L)
+                        .build()
+                )
+                .callId("call_id")
+                .environment(BetaResponseLocalEnvironment.builder().build())
+                .status(BetaResponseFunctionShellToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionShellToolCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .build()
+
+        val roundtrippedBetaResponseFunctionShellToolCall =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFunctionShellToolCall),
+                jacksonTypeRef<BetaResponseFunctionShellToolCall>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFunctionShellToolCall)
+            .isEqualTo(betaResponseFunctionShellToolCall)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallItemTest.kt
new file mode 100644
index 000000000..19e415741
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallItemTest.kt
@@ -0,0 +1,66 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseFunctionToolCallItemTest {
+
+    @Test
+    fun create() {
+        val betaResponseFunctionToolCallItem =
+            BetaResponseFunctionToolCallItem.builder()
+                .arguments("arguments")
+                .callId("call_id")
+                .name("name")
+                .id("id")
+                .agent(BetaResponseFunctionToolCall.Agent.builder().agentName("agent_name").build())
+                .callerDirect()
+                .namespace("namespace")
+                .status(BetaResponseFunctionToolCall.Status.IN_PROGRESS)
+                .createdBy("created_by")
+                .build()
+
+        assertThat(betaResponseFunctionToolCallItem.arguments()).isEqualTo("arguments")
+        assertThat(betaResponseFunctionToolCallItem.callId()).isEqualTo("call_id")
+        assertThat(betaResponseFunctionToolCallItem.name()).isEqualTo("name")
+        assertThat(betaResponseFunctionToolCallItem.id()).contains("id")
+        assertThat(betaResponseFunctionToolCallItem.agent())
+            .contains(BetaResponseFunctionToolCall.Agent.builder().agentName("agent_name").build())
+        assertThat(betaResponseFunctionToolCallItem.caller())
+            .contains(BetaResponseFunctionToolCall.Caller.ofDirect())
+        assertThat(betaResponseFunctionToolCallItem.namespace()).contains("namespace")
+        assertThat(betaResponseFunctionToolCallItem.status())
+            .contains(BetaResponseFunctionToolCall.Status.IN_PROGRESS)
+        assertThat(betaResponseFunctionToolCallItem.createdBy()).contains("created_by")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFunctionToolCallItem =
+            BetaResponseFunctionToolCallItem.builder()
+                .arguments("arguments")
+                .callId("call_id")
+                .name("name")
+                .id("id")
+                .agent(BetaResponseFunctionToolCall.Agent.builder().agentName("agent_name").build())
+                .callerDirect()
+                .namespace("namespace")
+                .status(BetaResponseFunctionToolCall.Status.IN_PROGRESS)
+                .createdBy("created_by")
+                .build()
+
+        val roundtrippedBetaResponseFunctionToolCallItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFunctionToolCallItem),
+                jacksonTypeRef<BetaResponseFunctionToolCallItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFunctionToolCallItem)
+            .isEqualTo(betaResponseFunctionToolCallItem)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallOutputItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallOutputItemTest.kt
new file mode 100644
index 000000000..653f8c375
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallOutputItemTest.kt
@@ -0,0 +1,73 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseFunctionToolCallOutputItemTest {
+
+    @Test
+    fun create() {
+        val betaResponseFunctionToolCallOutputItem =
+            BetaResponseFunctionToolCallOutputItem.builder()
+                .id("id")
+                .callId("call_id")
+                .output("string")
+                .status(BetaResponseFunctionToolCallOutputItem.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionToolCallOutputItem.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .build()
+
+        assertThat(betaResponseFunctionToolCallOutputItem.id()).isEqualTo("id")
+        assertThat(betaResponseFunctionToolCallOutputItem.callId()).isEqualTo("call_id")
+        assertThat(betaResponseFunctionToolCallOutputItem.output())
+            .isEqualTo(BetaResponseFunctionToolCallOutputItem.Output.ofString("string"))
+        assertThat(betaResponseFunctionToolCallOutputItem.status())
+            .isEqualTo(BetaResponseFunctionToolCallOutputItem.Status.IN_PROGRESS)
+        assertThat(betaResponseFunctionToolCallOutputItem.agent())
+            .contains(
+                BetaResponseFunctionToolCallOutputItem.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+        assertThat(betaResponseFunctionToolCallOutputItem.caller())
+            .contains(BetaResponseFunctionToolCallOutputItem.Caller.ofDirect())
+        assertThat(betaResponseFunctionToolCallOutputItem.createdBy()).contains("created_by")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFunctionToolCallOutputItem =
+            BetaResponseFunctionToolCallOutputItem.builder()
+                .id("id")
+                .callId("call_id")
+                .output("string")
+                .status(BetaResponseFunctionToolCallOutputItem.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionToolCallOutputItem.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .build()
+
+        val roundtrippedBetaResponseFunctionToolCallOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFunctionToolCallOutputItem),
+                jacksonTypeRef<BetaResponseFunctionToolCallOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFunctionToolCallOutputItem)
+            .isEqualTo(betaResponseFunctionToolCallOutputItem)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallTest.kt
new file mode 100644
index 000000000..880abb1c7
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionToolCallTest.kt
@@ -0,0 +1,62 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseFunctionToolCallTest {
+
+    @Test
+    fun create() {
+        val betaResponseFunctionToolCall =
+            BetaResponseFunctionToolCall.builder()
+                .arguments("arguments")
+                .callId("call_id")
+                .name("name")
+                .id("id")
+                .agent(BetaResponseFunctionToolCall.Agent.builder().agentName("agent_name").build())
+                .callerDirect()
+                .namespace("namespace")
+                .status(BetaResponseFunctionToolCall.Status.IN_PROGRESS)
+                .build()
+
+        assertThat(betaResponseFunctionToolCall.arguments()).isEqualTo("arguments")
+        assertThat(betaResponseFunctionToolCall.callId()).isEqualTo("call_id")
+        assertThat(betaResponseFunctionToolCall.name()).isEqualTo("name")
+        assertThat(betaResponseFunctionToolCall.id()).contains("id")
+        assertThat(betaResponseFunctionToolCall.agent())
+            .contains(BetaResponseFunctionToolCall.Agent.builder().agentName("agent_name").build())
+        assertThat(betaResponseFunctionToolCall.caller())
+            .contains(BetaResponseFunctionToolCall.Caller.ofDirect())
+        assertThat(betaResponseFunctionToolCall.namespace()).contains("namespace")
+        assertThat(betaResponseFunctionToolCall.status())
+            .contains(BetaResponseFunctionToolCall.Status.IN_PROGRESS)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFunctionToolCall =
+            BetaResponseFunctionToolCall.builder()
+                .arguments("arguments")
+                .callId("call_id")
+                .name("name")
+                .id("id")
+                .agent(BetaResponseFunctionToolCall.Agent.builder().agentName("agent_name").build())
+                .callerDirect()
+                .namespace("namespace")
+                .status(BetaResponseFunctionToolCall.Status.IN_PROGRESS)
+                .build()
+
+        val roundtrippedBetaResponseFunctionToolCall =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFunctionToolCall),
+                jacksonTypeRef<BetaResponseFunctionToolCall>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFunctionToolCall).isEqualTo(betaResponseFunctionToolCall)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionWebSearchTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionWebSearchTest.kt
new file mode 100644
index 000000000..994787a7e
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseFunctionWebSearchTest.kt
@@ -0,0 +1,87 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseFunctionWebSearchTest {
+
+    @Test
+    fun create() {
+        val betaResponseFunctionWebSearch =
+            BetaResponseFunctionWebSearch.builder()
+                .id("id")
+                .action(
+                    BetaResponseFunctionWebSearch.Action.Search.builder()
+                        .addQuery("string")
+                        .query("query")
+                        .addSource(
+                            BetaResponseFunctionWebSearch.Action.Search.Source.builder()
+                                .url("https://example.com")
+                                .build()
+                        )
+                        .build()
+                )
+                .status(BetaResponseFunctionWebSearch.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionWebSearch.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        assertThat(betaResponseFunctionWebSearch.id()).isEqualTo("id")
+        assertThat(betaResponseFunctionWebSearch.action())
+            .isEqualTo(
+                BetaResponseFunctionWebSearch.Action.ofSearch(
+                    BetaResponseFunctionWebSearch.Action.Search.builder()
+                        .addQuery("string")
+                        .query("query")
+                        .addSource(
+                            BetaResponseFunctionWebSearch.Action.Search.Source.builder()
+                                .url("https://example.com")
+                                .build()
+                        )
+                        .build()
+                )
+            )
+        assertThat(betaResponseFunctionWebSearch.status())
+            .isEqualTo(BetaResponseFunctionWebSearch.Status.IN_PROGRESS)
+        assertThat(betaResponseFunctionWebSearch.agent())
+            .contains(BetaResponseFunctionWebSearch.Agent.builder().agentName("agent_name").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseFunctionWebSearch =
+            BetaResponseFunctionWebSearch.builder()
+                .id("id")
+                .action(
+                    BetaResponseFunctionWebSearch.Action.Search.builder()
+                        .addQuery("string")
+                        .query("query")
+                        .addSource(
+                            BetaResponseFunctionWebSearch.Action.Search.Source.builder()
+                                .url("https://example.com")
+                                .build()
+                        )
+                        .build()
+                )
+                .status(BetaResponseFunctionWebSearch.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionWebSearch.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseFunctionWebSearch =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseFunctionWebSearch),
+                jacksonTypeRef<BetaResponseFunctionWebSearch>(),
+            )
+
+        assertThat(roundtrippedBetaResponseFunctionWebSearch)
+            .isEqualTo(betaResponseFunctionWebSearch)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallCompletedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallCompletedEventTest.kt
new file mode 100644
index 000000000..10e56ddfd
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallCompletedEventTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseImageGenCallCompletedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseImageGenCallCompletedEvent =
+            BetaResponseImageGenCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseImageGenCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseImageGenCallCompletedEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseImageGenCallCompletedEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseImageGenCallCompletedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseImageGenCallCompletedEvent.agent())
+            .contains(
+                BetaResponseImageGenCallCompletedEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseImageGenCallCompletedEvent =
+            BetaResponseImageGenCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseImageGenCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseImageGenCallCompletedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseImageGenCallCompletedEvent),
+                jacksonTypeRef<BetaResponseImageGenCallCompletedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseImageGenCallCompletedEvent)
+            .isEqualTo(betaResponseImageGenCallCompletedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallGeneratingEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallGeneratingEventTest.kt
new file mode 100644
index 000000000..1f8598b80
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallGeneratingEventTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseImageGenCallGeneratingEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseImageGenCallGeneratingEvent =
+            BetaResponseImageGenCallGeneratingEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseImageGenCallGeneratingEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseImageGenCallGeneratingEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseImageGenCallGeneratingEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseImageGenCallGeneratingEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseImageGenCallGeneratingEvent.agent())
+            .contains(
+                BetaResponseImageGenCallGeneratingEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseImageGenCallGeneratingEvent =
+            BetaResponseImageGenCallGeneratingEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseImageGenCallGeneratingEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseImageGenCallGeneratingEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseImageGenCallGeneratingEvent),
+                jacksonTypeRef<BetaResponseImageGenCallGeneratingEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseImageGenCallGeneratingEvent)
+            .isEqualTo(betaResponseImageGenCallGeneratingEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallInProgressEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallInProgressEventTest.kt
new file mode 100644
index 000000000..0ddc01133
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallInProgressEventTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseImageGenCallInProgressEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseImageGenCallInProgressEvent =
+            BetaResponseImageGenCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseImageGenCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseImageGenCallInProgressEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseImageGenCallInProgressEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseImageGenCallInProgressEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseImageGenCallInProgressEvent.agent())
+            .contains(
+                BetaResponseImageGenCallInProgressEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseImageGenCallInProgressEvent =
+            BetaResponseImageGenCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseImageGenCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseImageGenCallInProgressEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseImageGenCallInProgressEvent),
+                jacksonTypeRef<BetaResponseImageGenCallInProgressEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseImageGenCallInProgressEvent)
+            .isEqualTo(betaResponseImageGenCallInProgressEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallPartialImageEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallPartialImageEventTest.kt
new file mode 100644
index 000000000..c88d679b0
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseImageGenCallPartialImageEventTest.kt
@@ -0,0 +1,68 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseImageGenCallPartialImageEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseImageGenCallPartialImageEvent =
+            BetaResponseImageGenCallPartialImageEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .partialImageB64("partial_image_b64")
+                .partialImageIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseImageGenCallPartialImageEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseImageGenCallPartialImageEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseImageGenCallPartialImageEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseImageGenCallPartialImageEvent.partialImageB64())
+            .isEqualTo("partial_image_b64")
+        assertThat(betaResponseImageGenCallPartialImageEvent.partialImageIndex()).isEqualTo(0L)
+        assertThat(betaResponseImageGenCallPartialImageEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseImageGenCallPartialImageEvent.agent())
+            .contains(
+                BetaResponseImageGenCallPartialImageEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseImageGenCallPartialImageEvent =
+            BetaResponseImageGenCallPartialImageEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .partialImageB64("partial_image_b64")
+                .partialImageIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseImageGenCallPartialImageEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseImageGenCallPartialImageEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseImageGenCallPartialImageEvent),
+                jacksonTypeRef<BetaResponseImageGenCallPartialImageEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseImageGenCallPartialImageEvent)
+            .isEqualTo(betaResponseImageGenCallPartialImageEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInProgressEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInProgressEventTest.kt
new file mode 100644
index 000000000..ddda07e1f
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInProgressEventTest.kt
@@ -0,0 +1,683 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseInProgressEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseInProgressEvent =
+            BetaResponseInProgressEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseInProgressEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        assertThat(betaResponseInProgressEvent.response())
+            .isEqualTo(
+                BetaResponse.builder()
+                    .id("id")
+                    .createdAt(0.0)
+                    .error(
+                        BetaResponseError.builder()
+                            .code(BetaResponseError.Code.SERVER_ERROR)
+                            .message("message")
+                            .build()
+                    )
+                    .incompleteDetails(
+                        BetaResponse.IncompleteDetails.builder()
+                            .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                            .build()
+                    )
+                    .instructions("string")
+                    .metadata(
+                        BetaResponse.Metadata.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                            .build()
+                    )
+                    .model(BetaResponse.Model.GPT_5_1)
+                    .addOutput(
+                        BetaResponseOutputMessage.builder()
+                            .id("id")
+                            .addContent(
+                                BetaResponseOutputText.builder()
+                                    .addAnnotation(
+                                        BetaResponseOutputText.Annotation.FileCitation.builder()
+                                            .fileId("file_id")
+                                            .filename("filename")
+                                            .index(0L)
+                                            .build()
+                                    )
+                                    .text("text")
+                                    .addLogprob(
+                                        BetaResponseOutputText.Logprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .addTopLogprob(
+                                                BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                            .agent(
+                                BetaResponseOutputMessage.Agent.builder()
+                                    .agentName("agent_name")
+                                    .build()
+                            )
+                            .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                            .build()
+                    )
+                    .parallelToolCalls(true)
+                    .temperature(1.0)
+                    .toolChoice(BetaToolChoiceOptions.NONE)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .topP(1.0)
+                    .background(true)
+                    .completedAt(0.0)
+                    .conversation(BetaResponse.Conversation.builder().id("id").build())
+                    .maxOutputTokens(0L)
+                    .maxToolCalls(0L)
+                    .moderation(
+                        BetaResponse.Moderation.builder()
+                            .input(
+                                BetaResponse.Moderation.Input.ModerationResult.builder()
+                                    .categories(
+                                        BetaResponse.Moderation.Input.ModerationResult.Categories
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(true))
+                                            .build()
+                                    )
+                                    .categoryAppliedInputTypes(
+                                        BetaResponse.Moderation.Input.ModerationResult
+                                            .CategoryAppliedInputTypes
+                                            .builder()
+                                            .putAdditionalProperty(
+                                                "foo",
+                                                JsonValue.from(listOf("text")),
+                                            )
+                                            .build()
+                                    )
+                                    .categoryScores(
+                                        BetaResponse.Moderation.Input.ModerationResult
+                                            .CategoryScores
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(0))
+                                            .build()
+                                    )
+                                    .flagged(true)
+                                    .model("model")
+                                    .build()
+                            )
+                            .output(
+                                BetaResponse.Moderation.Output.ModerationResult.builder()
+                                    .categories(
+                                        BetaResponse.Moderation.Output.ModerationResult.Categories
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(true))
+                                            .build()
+                                    )
+                                    .categoryAppliedInputTypes(
+                                        BetaResponse.Moderation.Output.ModerationResult
+                                            .CategoryAppliedInputTypes
+                                            .builder()
+                                            .putAdditionalProperty(
+                                                "foo",
+                                                JsonValue.from(listOf("text")),
+                                            )
+                                            .build()
+                                    )
+                                    .categoryScores(
+                                        BetaResponse.Moderation.Output.ModerationResult
+                                            .CategoryScores
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(0))
+                                            .build()
+                                    )
+                                    .flagged(true)
+                                    .model("model")
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .previousResponseId("previous_response_id")
+                    .prompt(
+                        BetaResponsePrompt.builder()
+                            .id("id")
+                            .variables(
+                                BetaResponsePrompt.Variables.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .version("version")
+                            .build()
+                    )
+                    .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        BetaResponse.PromptCacheOptions.builder()
+                            .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
+                    .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                    .reasoning(
+                        BetaResponse.Reasoning.builder()
+                            .context(BetaResponse.Reasoning.Context.AUTO)
+                            .effort(BetaResponse.Reasoning.Effort.NONE)
+                            .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                            .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                            .summary(BetaResponse.Reasoning.Summary.AUTO)
+                            .build()
+                    )
+                    .safetyIdentifier("safety-identifier-1234")
+                    .serviceTier(BetaResponse.ServiceTier.AUTO)
+                    .status(BetaResponseStatus.COMPLETED)
+                    .text(
+                        BetaResponseTextConfig.builder()
+                            .formatText()
+                            .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                            .build()
+                    )
+                    .topLogprobs(0L)
+                    .truncation(BetaResponse.Truncation.AUTO)
+                    .usage(
+                        BetaResponseUsage.builder()
+                            .inputTokens(0L)
+                            .inputTokensDetails(
+                                BetaResponseUsage.InputTokensDetails.builder()
+                                    .cacheWriteTokens(0L)
+                                    .cachedTokens(0L)
+                                    .build()
+                            )
+                            .outputTokens(0L)
+                            .outputTokensDetails(
+                                BetaResponseUsage.OutputTokensDetails.builder()
+                                    .reasoningTokens(0L)
+                                    .build()
+                            )
+                            .totalTokens(0L)
+                            .build()
+                    )
+                    .user("user-1234")
+                    .build()
+            )
+        assertThat(betaResponseInProgressEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseInProgressEvent.agent())
+            .contains(BetaResponseInProgressEvent.Agent.builder().agentName("agent_name").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInProgressEvent =
+            BetaResponseInProgressEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseInProgressEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val roundtrippedBetaResponseInProgressEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInProgressEvent),
+                jacksonTypeRef<BetaResponseInProgressEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInProgressEvent).isEqualTo(betaResponseInProgressEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseIncompleteEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseIncompleteEventTest.kt
new file mode 100644
index 000000000..be3f37fcf
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseIncompleteEventTest.kt
@@ -0,0 +1,683 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseIncompleteEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseIncompleteEvent =
+            BetaResponseIncompleteEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseIncompleteEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        assertThat(betaResponseIncompleteEvent.response())
+            .isEqualTo(
+                BetaResponse.builder()
+                    .id("id")
+                    .createdAt(0.0)
+                    .error(
+                        BetaResponseError.builder()
+                            .code(BetaResponseError.Code.SERVER_ERROR)
+                            .message("message")
+                            .build()
+                    )
+                    .incompleteDetails(
+                        BetaResponse.IncompleteDetails.builder()
+                            .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                            .build()
+                    )
+                    .instructions("string")
+                    .metadata(
+                        BetaResponse.Metadata.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                            .build()
+                    )
+                    .model(BetaResponse.Model.GPT_5_1)
+                    .addOutput(
+                        BetaResponseOutputMessage.builder()
+                            .id("id")
+                            .addContent(
+                                BetaResponseOutputText.builder()
+                                    .addAnnotation(
+                                        BetaResponseOutputText.Annotation.FileCitation.builder()
+                                            .fileId("file_id")
+                                            .filename("filename")
+                                            .index(0L)
+                                            .build()
+                                    )
+                                    .text("text")
+                                    .addLogprob(
+                                        BetaResponseOutputText.Logprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .addTopLogprob(
+                                                BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                            .agent(
+                                BetaResponseOutputMessage.Agent.builder()
+                                    .agentName("agent_name")
+                                    .build()
+                            )
+                            .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                            .build()
+                    )
+                    .parallelToolCalls(true)
+                    .temperature(1.0)
+                    .toolChoice(BetaToolChoiceOptions.NONE)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .topP(1.0)
+                    .background(true)
+                    .completedAt(0.0)
+                    .conversation(BetaResponse.Conversation.builder().id("id").build())
+                    .maxOutputTokens(0L)
+                    .maxToolCalls(0L)
+                    .moderation(
+                        BetaResponse.Moderation.builder()
+                            .input(
+                                BetaResponse.Moderation.Input.ModerationResult.builder()
+                                    .categories(
+                                        BetaResponse.Moderation.Input.ModerationResult.Categories
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(true))
+                                            .build()
+                                    )
+                                    .categoryAppliedInputTypes(
+                                        BetaResponse.Moderation.Input.ModerationResult
+                                            .CategoryAppliedInputTypes
+                                            .builder()
+                                            .putAdditionalProperty(
+                                                "foo",
+                                                JsonValue.from(listOf("text")),
+                                            )
+                                            .build()
+                                    )
+                                    .categoryScores(
+                                        BetaResponse.Moderation.Input.ModerationResult
+                                            .CategoryScores
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(0))
+                                            .build()
+                                    )
+                                    .flagged(true)
+                                    .model("model")
+                                    .build()
+                            )
+                            .output(
+                                BetaResponse.Moderation.Output.ModerationResult.builder()
+                                    .categories(
+                                        BetaResponse.Moderation.Output.ModerationResult.Categories
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(true))
+                                            .build()
+                                    )
+                                    .categoryAppliedInputTypes(
+                                        BetaResponse.Moderation.Output.ModerationResult
+                                            .CategoryAppliedInputTypes
+                                            .builder()
+                                            .putAdditionalProperty(
+                                                "foo",
+                                                JsonValue.from(listOf("text")),
+                                            )
+                                            .build()
+                                    )
+                                    .categoryScores(
+                                        BetaResponse.Moderation.Output.ModerationResult
+                                            .CategoryScores
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(0))
+                                            .build()
+                                    )
+                                    .flagged(true)
+                                    .model("model")
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .previousResponseId("previous_response_id")
+                    .prompt(
+                        BetaResponsePrompt.builder()
+                            .id("id")
+                            .variables(
+                                BetaResponsePrompt.Variables.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .version("version")
+                            .build()
+                    )
+                    .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        BetaResponse.PromptCacheOptions.builder()
+                            .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
+                    .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                    .reasoning(
+                        BetaResponse.Reasoning.builder()
+                            .context(BetaResponse.Reasoning.Context.AUTO)
+                            .effort(BetaResponse.Reasoning.Effort.NONE)
+                            .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                            .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                            .summary(BetaResponse.Reasoning.Summary.AUTO)
+                            .build()
+                    )
+                    .safetyIdentifier("safety-identifier-1234")
+                    .serviceTier(BetaResponse.ServiceTier.AUTO)
+                    .status(BetaResponseStatus.COMPLETED)
+                    .text(
+                        BetaResponseTextConfig.builder()
+                            .formatText()
+                            .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                            .build()
+                    )
+                    .topLogprobs(0L)
+                    .truncation(BetaResponse.Truncation.AUTO)
+                    .usage(
+                        BetaResponseUsage.builder()
+                            .inputTokens(0L)
+                            .inputTokensDetails(
+                                BetaResponseUsage.InputTokensDetails.builder()
+                                    .cacheWriteTokens(0L)
+                                    .cachedTokens(0L)
+                                    .build()
+                            )
+                            .outputTokens(0L)
+                            .outputTokensDetails(
+                                BetaResponseUsage.OutputTokensDetails.builder()
+                                    .reasoningTokens(0L)
+                                    .build()
+                            )
+                            .totalTokens(0L)
+                            .build()
+                    )
+                    .user("user-1234")
+                    .build()
+            )
+        assertThat(betaResponseIncompleteEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseIncompleteEvent.agent())
+            .contains(BetaResponseIncompleteEvent.Agent.builder().agentName("agent_name").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseIncompleteEvent =
+            BetaResponseIncompleteEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseIncompleteEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val roundtrippedBetaResponseIncompleteEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseIncompleteEvent),
+                jacksonTypeRef<BetaResponseIncompleteEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseIncompleteEvent).isEqualTo(betaResponseIncompleteEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInjectCreatedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInjectCreatedEventTest.kt
new file mode 100644
index 000000000..de4f4983f
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInjectCreatedEventTest.kt
@@ -0,0 +1,45 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseInjectCreatedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseInjectCreatedEvent =
+            BetaResponseInjectCreatedEvent.builder()
+                .responseId("response_id")
+                .sequenceNumber(0L)
+                .streamId("stream_id")
+                .build()
+
+        assertThat(betaResponseInjectCreatedEvent.responseId()).isEqualTo("response_id")
+        assertThat(betaResponseInjectCreatedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseInjectCreatedEvent.streamId()).contains("stream_id")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInjectCreatedEvent =
+            BetaResponseInjectCreatedEvent.builder()
+                .responseId("response_id")
+                .sequenceNumber(0L)
+                .streamId("stream_id")
+                .build()
+
+        val roundtrippedBetaResponseInjectCreatedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInjectCreatedEvent),
+                jacksonTypeRef<BetaResponseInjectCreatedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInjectCreatedEvent)
+            .isEqualTo(betaResponseInjectCreatedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInjectEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInjectEventTest.kt
new file mode 100644
index 000000000..2c8570884
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInjectEventTest.kt
@@ -0,0 +1,65 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseInjectEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseInjectEvent =
+            BetaResponseInjectEvent.builder()
+                .addInput(
+                    BetaEasyInputMessage.builder()
+                        .content("string")
+                        .role(BetaEasyInputMessage.Role.USER)
+                        .phase(BetaEasyInputMessage.Phase.COMMENTARY)
+                        .type(BetaEasyInputMessage.Type.MESSAGE)
+                        .build()
+                )
+                .responseId("response_id")
+                .build()
+
+        assertThat(betaResponseInjectEvent.input())
+            .containsExactly(
+                BetaResponseInputItem.ofBetaEasyInputMessage(
+                    BetaEasyInputMessage.builder()
+                        .content("string")
+                        .role(BetaEasyInputMessage.Role.USER)
+                        .phase(BetaEasyInputMessage.Phase.COMMENTARY)
+                        .type(BetaEasyInputMessage.Type.MESSAGE)
+                        .build()
+                )
+            )
+        assertThat(betaResponseInjectEvent.responseId()).isEqualTo("response_id")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInjectEvent =
+            BetaResponseInjectEvent.builder()
+                .addInput(
+                    BetaEasyInputMessage.builder()
+                        .content("string")
+                        .role(BetaEasyInputMessage.Role.USER)
+                        .phase(BetaEasyInputMessage.Phase.COMMENTARY)
+                        .type(BetaEasyInputMessage.Type.MESSAGE)
+                        .build()
+                )
+                .responseId("response_id")
+                .build()
+
+        val roundtrippedBetaResponseInjectEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInjectEvent),
+                jacksonTypeRef<BetaResponseInjectEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInjectEvent).isEqualTo(betaResponseInjectEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInjectFailedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInjectFailedEventTest.kt
new file mode 100644
index 000000000..20ff8ac99
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInjectFailedEventTest.kt
@@ -0,0 +1,91 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseInjectFailedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseInjectFailedEvent =
+            BetaResponseInjectFailedEvent.builder()
+                .error(
+                    BetaResponseInjectFailedEvent.Error.builder()
+                        .code(BetaResponseInjectFailedEvent.Error.Code.RESPONSE_ALREADY_COMPLETED)
+                        .message("message")
+                        .build()
+                )
+                .addInput(
+                    BetaEasyInputMessage.builder()
+                        .content("string")
+                        .role(BetaEasyInputMessage.Role.USER)
+                        .phase(BetaEasyInputMessage.Phase.COMMENTARY)
+                        .type(BetaEasyInputMessage.Type.MESSAGE)
+                        .build()
+                )
+                .responseId("response_id")
+                .sequenceNumber(0L)
+                .streamId("stream_id")
+                .build()
+
+        assertThat(betaResponseInjectFailedEvent.error())
+            .isEqualTo(
+                BetaResponseInjectFailedEvent.Error.builder()
+                    .code(BetaResponseInjectFailedEvent.Error.Code.RESPONSE_ALREADY_COMPLETED)
+                    .message("message")
+                    .build()
+            )
+        assertThat(betaResponseInjectFailedEvent.input())
+            .containsExactly(
+                BetaResponseInputItem.ofBetaEasyInputMessage(
+                    BetaEasyInputMessage.builder()
+                        .content("string")
+                        .role(BetaEasyInputMessage.Role.USER)
+                        .phase(BetaEasyInputMessage.Phase.COMMENTARY)
+                        .type(BetaEasyInputMessage.Type.MESSAGE)
+                        .build()
+                )
+            )
+        assertThat(betaResponseInjectFailedEvent.responseId()).isEqualTo("response_id")
+        assertThat(betaResponseInjectFailedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseInjectFailedEvent.streamId()).contains("stream_id")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInjectFailedEvent =
+            BetaResponseInjectFailedEvent.builder()
+                .error(
+                    BetaResponseInjectFailedEvent.Error.builder()
+                        .code(BetaResponseInjectFailedEvent.Error.Code.RESPONSE_ALREADY_COMPLETED)
+                        .message("message")
+                        .build()
+                )
+                .addInput(
+                    BetaEasyInputMessage.builder()
+                        .content("string")
+                        .role(BetaEasyInputMessage.Role.USER)
+                        .phase(BetaEasyInputMessage.Phase.COMMENTARY)
+                        .type(BetaEasyInputMessage.Type.MESSAGE)
+                        .build()
+                )
+                .responseId("response_id")
+                .sequenceNumber(0L)
+                .streamId("stream_id")
+                .build()
+
+        val roundtrippedBetaResponseInjectFailedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInjectFailedEvent),
+                jacksonTypeRef<BetaResponseInjectFailedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInjectFailedEvent)
+            .isEqualTo(betaResponseInjectFailedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputAudioTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputAudioTest.kt
new file mode 100644
index 000000000..fc4804ac3
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputAudioTest.kt
@@ -0,0 +1,54 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseInputAudioTest {
+
+    @Test
+    fun create() {
+        val betaResponseInputAudio =
+            BetaResponseInputAudio.builder()
+                .inputAudio(
+                    BetaResponseInputAudio.InputAudio.builder()
+                        .data("data")
+                        .format(BetaResponseInputAudio.InputAudio.Format.MP3)
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseInputAudio.inputAudio())
+            .isEqualTo(
+                BetaResponseInputAudio.InputAudio.builder()
+                    .data("data")
+                    .format(BetaResponseInputAudio.InputAudio.Format.MP3)
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputAudio =
+            BetaResponseInputAudio.builder()
+                .inputAudio(
+                    BetaResponseInputAudio.InputAudio.builder()
+                        .data("data")
+                        .format(BetaResponseInputAudio.InputAudio.Format.MP3)
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseInputAudio =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputAudio),
+                jacksonTypeRef<BetaResponseInputAudio>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputAudio).isEqualTo(betaResponseInputAudio)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputContentTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputContentTest.kt
new file mode 100644
index 000000000..8b88ff18d
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputContentTest.kt
@@ -0,0 +1,163 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import com.openai.errors.OpenAIInvalidDataException
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.assertThrows
+import org.junit.jupiter.params.ParameterizedTest
+import org.junit.jupiter.params.provider.EnumSource
+
+internal class BetaResponseInputContentTest {
+
+    @Test
+    fun ofInputText() {
+        val inputText =
+            BetaResponseInputText.builder()
+                .text("text")
+                .promptCacheBreakpoint(
+                    BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        val betaResponseInputContent = BetaResponseInputContent.ofInputText(inputText)
+
+        assertThat(betaResponseInputContent.inputText()).contains(inputText)
+        assertThat(betaResponseInputContent.inputImage()).isEmpty
+        assertThat(betaResponseInputContent.inputFile()).isEmpty
+    }
+
+    @Test
+    fun ofInputTextRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputContent =
+            BetaResponseInputContent.ofInputText(
+                BetaResponseInputText.builder()
+                    .text("text")
+                    .promptCacheBreakpoint(
+                        BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputContent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputContent),
+                jacksonTypeRef<BetaResponseInputContent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputContent).isEqualTo(betaResponseInputContent)
+    }
+
+    @Test
+    fun ofInputImage() {
+        val inputImage =
+            BetaResponseInputImage.builder()
+                .detail(BetaResponseInputImage.Detail.LOW)
+                .fileId("file_id")
+                .imageUrl("https://example.com")
+                .promptCacheBreakpoint(
+                    BetaResponseInputImage.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        val betaResponseInputContent = BetaResponseInputContent.ofInputImage(inputImage)
+
+        assertThat(betaResponseInputContent.inputText()).isEmpty
+        assertThat(betaResponseInputContent.inputImage()).contains(inputImage)
+        assertThat(betaResponseInputContent.inputFile()).isEmpty
+    }
+
+    @Test
+    fun ofInputImageRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputContent =
+            BetaResponseInputContent.ofInputImage(
+                BetaResponseInputImage.builder()
+                    .detail(BetaResponseInputImage.Detail.LOW)
+                    .fileId("file_id")
+                    .imageUrl("https://example.com")
+                    .promptCacheBreakpoint(
+                        BetaResponseInputImage.PromptCacheBreakpoint.builder().build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputContent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputContent),
+                jacksonTypeRef<BetaResponseInputContent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputContent).isEqualTo(betaResponseInputContent)
+    }
+
+    @Test
+    fun ofInputFile() {
+        val inputFile =
+            BetaResponseInputFile.builder()
+                .detail(BetaResponseInputFile.Detail.AUTO)
+                .fileData("file_data")
+                .fileId("file_id")
+                .fileUrl("https://example.com")
+                .filename("filename")
+                .promptCacheBreakpoint(
+                    BetaResponseInputFile.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        val betaResponseInputContent = BetaResponseInputContent.ofInputFile(inputFile)
+
+        assertThat(betaResponseInputContent.inputText()).isEmpty
+        assertThat(betaResponseInputContent.inputImage()).isEmpty
+        assertThat(betaResponseInputContent.inputFile()).contains(inputFile)
+    }
+
+    @Test
+    fun ofInputFileRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputContent =
+            BetaResponseInputContent.ofInputFile(
+                BetaResponseInputFile.builder()
+                    .detail(BetaResponseInputFile.Detail.AUTO)
+                    .fileData("file_data")
+                    .fileId("file_id")
+                    .fileUrl("https://example.com")
+                    .filename("filename")
+                    .promptCacheBreakpoint(
+                        BetaResponseInputFile.PromptCacheBreakpoint.builder().build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputContent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputContent),
+                jacksonTypeRef<BetaResponseInputContent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputContent).isEqualTo(betaResponseInputContent)
+    }
+
+    enum class IncompatibleJsonShapeTestCase(val value: JsonValue) {
+        BOOLEAN(JsonValue.from(false)),
+        STRING(JsonValue.from("invalid")),
+        INTEGER(JsonValue.from(-1)),
+        FLOAT(JsonValue.from(3.14)),
+        ARRAY(JsonValue.from(listOf("invalid", "array"))),
+    }
+
+    @ParameterizedTest
+    @EnumSource
+    fun incompatibleJsonShapeDeserializesToUnknown(testCase: IncompatibleJsonShapeTestCase) {
+        val betaResponseInputContent =
+            jsonMapper().convertValue(testCase.value, jacksonTypeRef<BetaResponseInputContent>())
+
+        val e = assertThrows<OpenAIInvalidDataException> { betaResponseInputContent.validate() }
+        assertThat(e).hasMessageStartingWith("Unknown ")
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputFileContentTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputFileContentTest.kt
new file mode 100644
index 000000000..87a2cbc47
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputFileContentTest.kt
@@ -0,0 +1,59 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseInputFileContentTest {
+
+    @Test
+    fun create() {
+        val betaResponseInputFileContent =
+            BetaResponseInputFileContent.builder()
+                .detail(BetaResponseInputFileContent.Detail.AUTO)
+                .fileData("file_data")
+                .fileId("file-123")
+                .fileUrl("https://example.com")
+                .filename("filename")
+                .promptCacheBreakpoint(
+                    BetaResponseInputFileContent.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        assertThat(betaResponseInputFileContent.detail())
+            .contains(BetaResponseInputFileContent.Detail.AUTO)
+        assertThat(betaResponseInputFileContent.fileData()).contains("file_data")
+        assertThat(betaResponseInputFileContent.fileId()).contains("file-123")
+        assertThat(betaResponseInputFileContent.fileUrl()).contains("https://example.com")
+        assertThat(betaResponseInputFileContent.filename()).contains("filename")
+        assertThat(betaResponseInputFileContent.promptCacheBreakpoint())
+            .contains(BetaResponseInputFileContent.PromptCacheBreakpoint.builder().build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputFileContent =
+            BetaResponseInputFileContent.builder()
+                .detail(BetaResponseInputFileContent.Detail.AUTO)
+                .fileData("file_data")
+                .fileId("file-123")
+                .fileUrl("https://example.com")
+                .filename("filename")
+                .promptCacheBreakpoint(
+                    BetaResponseInputFileContent.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseInputFileContent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputFileContent),
+                jacksonTypeRef<BetaResponseInputFileContent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputFileContent).isEqualTo(betaResponseInputFileContent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputFileTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputFileTest.kt
new file mode 100644
index 000000000..4f8def863
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputFileTest.kt
@@ -0,0 +1,58 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseInputFileTest {
+
+    @Test
+    fun create() {
+        val betaResponseInputFile =
+            BetaResponseInputFile.builder()
+                .detail(BetaResponseInputFile.Detail.AUTO)
+                .fileData("file_data")
+                .fileId("file_id")
+                .fileUrl("https://example.com")
+                .filename("filename")
+                .promptCacheBreakpoint(
+                    BetaResponseInputFile.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        assertThat(betaResponseInputFile.detail()).contains(BetaResponseInputFile.Detail.AUTO)
+        assertThat(betaResponseInputFile.fileData()).contains("file_data")
+        assertThat(betaResponseInputFile.fileId()).contains("file_id")
+        assertThat(betaResponseInputFile.fileUrl()).contains("https://example.com")
+        assertThat(betaResponseInputFile.filename()).contains("filename")
+        assertThat(betaResponseInputFile.promptCacheBreakpoint())
+            .contains(BetaResponseInputFile.PromptCacheBreakpoint.builder().build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputFile =
+            BetaResponseInputFile.builder()
+                .detail(BetaResponseInputFile.Detail.AUTO)
+                .fileData("file_data")
+                .fileId("file_id")
+                .fileUrl("https://example.com")
+                .filename("filename")
+                .promptCacheBreakpoint(
+                    BetaResponseInputFile.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseInputFile =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputFile),
+                jacksonTypeRef<BetaResponseInputFile>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputFile).isEqualTo(betaResponseInputFile)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputImageContentTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputImageContentTest.kt
new file mode 100644
index 000000000..d0d3a7889
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputImageContentTest.kt
@@ -0,0 +1,54 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseInputImageContentTest {
+
+    @Test
+    fun create() {
+        val betaResponseInputImageContent =
+            BetaResponseInputImageContent.builder()
+                .detail(BetaResponseInputImageContent.Detail.LOW)
+                .fileId("file-123")
+                .imageUrl("https://example.com")
+                .promptCacheBreakpoint(
+                    BetaResponseInputImageContent.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        assertThat(betaResponseInputImageContent.detail())
+            .contains(BetaResponseInputImageContent.Detail.LOW)
+        assertThat(betaResponseInputImageContent.fileId()).contains("file-123")
+        assertThat(betaResponseInputImageContent.imageUrl()).contains("https://example.com")
+        assertThat(betaResponseInputImageContent.promptCacheBreakpoint())
+            .contains(BetaResponseInputImageContent.PromptCacheBreakpoint.builder().build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputImageContent =
+            BetaResponseInputImageContent.builder()
+                .detail(BetaResponseInputImageContent.Detail.LOW)
+                .fileId("file-123")
+                .imageUrl("https://example.com")
+                .promptCacheBreakpoint(
+                    BetaResponseInputImageContent.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseInputImageContent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputImageContent),
+                jacksonTypeRef<BetaResponseInputImageContent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputImageContent)
+            .isEqualTo(betaResponseInputImageContent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputImageTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputImageTest.kt
new file mode 100644
index 000000000..66f9477f3
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputImageTest.kt
@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseInputImageTest {
+
+    @Test
+    fun create() {
+        val betaResponseInputImage =
+            BetaResponseInputImage.builder()
+                .detail(BetaResponseInputImage.Detail.LOW)
+                .fileId("file_id")
+                .imageUrl("https://example.com")
+                .promptCacheBreakpoint(
+                    BetaResponseInputImage.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        assertThat(betaResponseInputImage.detail()).isEqualTo(BetaResponseInputImage.Detail.LOW)
+        assertThat(betaResponseInputImage.fileId()).contains("file_id")
+        assertThat(betaResponseInputImage.imageUrl()).contains("https://example.com")
+        assertThat(betaResponseInputImage.promptCacheBreakpoint())
+            .contains(BetaResponseInputImage.PromptCacheBreakpoint.builder().build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputImage =
+            BetaResponseInputImage.builder()
+                .detail(BetaResponseInputImage.Detail.LOW)
+                .fileId("file_id")
+                .imageUrl("https://example.com")
+                .promptCacheBreakpoint(
+                    BetaResponseInputImage.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseInputImage =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputImage),
+                jacksonTypeRef<BetaResponseInputImage>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputImage).isEqualTo(betaResponseInputImage)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputItemTest.kt
new file mode 100644
index 000000000..5caf40e7f
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputItemTest.kt
@@ -0,0 +1,3220 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import com.openai.errors.OpenAIInvalidDataException
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.assertThrows
+import org.junit.jupiter.params.ParameterizedTest
+import org.junit.jupiter.params.provider.EnumSource
+
+internal class BetaResponseInputItemTest {
+
+    @Test
+    fun ofBetaEasyInputMessage() {
+        val betaEasyInputMessage =
+            BetaEasyInputMessage.builder()
+                .content("string")
+                .role(BetaEasyInputMessage.Role.USER)
+                .phase(BetaEasyInputMessage.Phase.COMMENTARY)
+                .type(BetaEasyInputMessage.Type.MESSAGE)
+                .build()
+
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofBetaEasyInputMessage(betaEasyInputMessage)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).contains(betaEasyInputMessage)
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofBetaEasyInputMessageRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofBetaEasyInputMessage(
+                BetaEasyInputMessage.builder()
+                    .content("string")
+                    .role(BetaEasyInputMessage.Role.USER)
+                    .phase(BetaEasyInputMessage.Phase.COMMENTARY)
+                    .type(BetaEasyInputMessage.Type.MESSAGE)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofMessage() {
+        val message =
+            BetaResponseInputItem.Message.builder()
+                .addContent(
+                    BetaResponseInputText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
+                .role(BetaResponseInputItem.Message.Role.USER)
+                .agent(
+                    BetaResponseInputItem.Message.Agent.builder().agentName("agent_name").build()
+                )
+                .status(BetaResponseInputItem.Message.Status.IN_PROGRESS)
+                .type(BetaResponseInputItem.Message.Type.MESSAGE)
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofMessage(message)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).contains(message)
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMessageRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofMessage(
+                BetaResponseInputItem.Message.builder()
+                    .addContent(
+                        BetaResponseInputText.builder()
+                            .text("text")
+                            .promptCacheBreakpoint(
+                                BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                            )
+                            .build()
+                    )
+                    .role(BetaResponseInputItem.Message.Role.USER)
+                    .agent(
+                        BetaResponseInputItem.Message.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .status(BetaResponseInputItem.Message.Status.IN_PROGRESS)
+                    .type(BetaResponseInputItem.Message.Type.MESSAGE)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofBetaResponseOutputMessage() {
+        val betaResponseOutputMessage =
+            BetaResponseOutputMessage.builder()
+                .id("id")
+                .addContent(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                .agent(BetaResponseOutputMessage.Agent.builder().agentName("agent_name").build())
+                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                .build()
+
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofBetaResponseOutputMessage(betaResponseOutputMessage)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage())
+            .contains(betaResponseOutputMessage)
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofBetaResponseOutputMessageRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofBetaResponseOutputMessage(
+                BetaResponseOutputMessage.builder()
+                    .id("id")
+                    .addContent(
+                        BetaResponseOutputText.builder()
+                            .addAnnotation(
+                                BetaResponseOutputText.Annotation.FileCitation.builder()
+                                    .fileId("file_id")
+                                    .filename("filename")
+                                    .index(0L)
+                                    .build()
+                            )
+                            .text("text")
+                            .addLogprob(
+                                BetaResponseOutputText.Logprob.builder()
+                                    .token("token")
+                                    .addByte(0L)
+                                    .logprob(0.0)
+                                    .addTopLogprob(
+                                        BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseOutputMessage.Agent.builder().agentName("agent_name").build()
+                    )
+                    .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofFileSearchCall() {
+        val fileSearchCall =
+            BetaResponseFileSearchToolCall.builder()
+                .id("id")
+                .addQuery("string")
+                .status(BetaResponseFileSearchToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFileSearchToolCall.Agent.builder().agentName("agent_name").build()
+                )
+                .addResult(
+                    BetaResponseFileSearchToolCall.Result.builder()
+                        .attributes(
+                            BetaResponseFileSearchToolCall.Result.Attributes.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .fileId("file_id")
+                        .filename("filename")
+                        .score(0.0f)
+                        .text("text")
+                        .build()
+                )
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofFileSearchCall(fileSearchCall)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).contains(fileSearchCall)
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofFileSearchCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofFileSearchCall(
+                BetaResponseFileSearchToolCall.builder()
+                    .id("id")
+                    .addQuery("string")
+                    .status(BetaResponseFileSearchToolCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseFileSearchToolCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .addResult(
+                        BetaResponseFileSearchToolCall.Result.builder()
+                            .attributes(
+                                BetaResponseFileSearchToolCall.Result.Attributes.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .fileId("file_id")
+                            .filename("filename")
+                            .score(0.0f)
+                            .text("text")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofComputerCall() {
+        val computerCall =
+            BetaResponseComputerToolCall.builder()
+                .id("id")
+                .callId("call_id")
+                .addPendingSafetyCheck(
+                    BetaResponseComputerToolCall.PendingSafetyCheck.builder()
+                        .id("id")
+                        .code("code")
+                        .message("message")
+                        .build()
+                )
+                .status(BetaResponseComputerToolCall.Status.IN_PROGRESS)
+                .type(BetaResponseComputerToolCall.Type.COMPUTER_CALL)
+                .action(
+                    BetaComputerAction.Click.builder()
+                        .button(BetaComputerAction.Click.Button.LEFT)
+                        .x(0L)
+                        .y(0L)
+                        .addKey("string")
+                        .build()
+                )
+                .addAction(
+                    BetaComputerAction.Click.builder()
+                        .button(BetaComputerAction.Click.Button.LEFT)
+                        .x(0L)
+                        .y(0L)
+                        .addKey("string")
+                        .build()
+                )
+                .agent(BetaResponseComputerToolCall.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofComputerCall(computerCall)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).contains(computerCall)
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofComputerCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofComputerCall(
+                BetaResponseComputerToolCall.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .addPendingSafetyCheck(
+                        BetaResponseComputerToolCall.PendingSafetyCheck.builder()
+                            .id("id")
+                            .code("code")
+                            .message("message")
+                            .build()
+                    )
+                    .status(BetaResponseComputerToolCall.Status.IN_PROGRESS)
+                    .type(BetaResponseComputerToolCall.Type.COMPUTER_CALL)
+                    .action(
+                        BetaComputerAction.Click.builder()
+                            .button(BetaComputerAction.Click.Button.LEFT)
+                            .x(0L)
+                            .y(0L)
+                            .addKey("string")
+                            .build()
+                    )
+                    .addAction(
+                        BetaComputerAction.Click.builder()
+                            .button(BetaComputerAction.Click.Button.LEFT)
+                            .x(0L)
+                            .y(0L)
+                            .addKey("string")
+                            .build()
+                    )
+                    .agent(
+                        BetaResponseComputerToolCall.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofComputerCallOutput() {
+        val computerCallOutput =
+            BetaResponseInputItem.ComputerCallOutput.builder()
+                .callId("x")
+                .output(
+                    BetaResponseComputerToolCallOutputScreenshot.builder()
+                        .fileId("file_id")
+                        .imageUrl("https://example.com")
+                        .build()
+                )
+                .id("cuo_123")
+                .addAcknowledgedSafetyCheck(
+                    BetaResponseInputItem.ComputerCallOutput.AcknowledgedSafetyCheck.builder()
+                        .id("id")
+                        .code("code")
+                        .message("message")
+                        .build()
+                )
+                .agent(
+                    BetaResponseInputItem.ComputerCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .status(BetaResponseInputItem.ComputerCallOutput.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofComputerCallOutput(computerCallOutput)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).contains(computerCallOutput)
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofComputerCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofComputerCallOutput(
+                BetaResponseInputItem.ComputerCallOutput.builder()
+                    .callId("x")
+                    .output(
+                        BetaResponseComputerToolCallOutputScreenshot.builder()
+                            .fileId("file_id")
+                            .imageUrl("https://example.com")
+                            .build()
+                    )
+                    .id("cuo_123")
+                    .addAcknowledgedSafetyCheck(
+                        BetaResponseInputItem.ComputerCallOutput.AcknowledgedSafetyCheck.builder()
+                            .id("id")
+                            .code("code")
+                            .message("message")
+                            .build()
+                    )
+                    .agent(
+                        BetaResponseInputItem.ComputerCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .status(BetaResponseInputItem.ComputerCallOutput.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofWebSearchCall() {
+        val webSearchCall =
+            BetaResponseFunctionWebSearch.builder()
+                .id("id")
+                .action(
+                    BetaResponseFunctionWebSearch.Action.Search.builder()
+                        .addQuery("string")
+                        .query("query")
+                        .addSource(
+                            BetaResponseFunctionWebSearch.Action.Search.Source.builder()
+                                .url("https://example.com")
+                                .build()
+                        )
+                        .build()
+                )
+                .status(BetaResponseFunctionWebSearch.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionWebSearch.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofWebSearchCall(webSearchCall)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).contains(webSearchCall)
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofWebSearchCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofWebSearchCall(
+                BetaResponseFunctionWebSearch.builder()
+                    .id("id")
+                    .action(
+                        BetaResponseFunctionWebSearch.Action.Search.builder()
+                            .addQuery("string")
+                            .query("query")
+                            .addSource(
+                                BetaResponseFunctionWebSearch.Action.Search.Source.builder()
+                                    .url("https://example.com")
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .status(BetaResponseFunctionWebSearch.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseFunctionWebSearch.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofFunctionCall() {
+        val functionCall =
+            BetaResponseFunctionToolCall.builder()
+                .arguments("arguments")
+                .callId("call_id")
+                .name("name")
+                .id("id")
+                .agent(BetaResponseFunctionToolCall.Agent.builder().agentName("agent_name").build())
+                .callerDirect()
+                .namespace("namespace")
+                .status(BetaResponseFunctionToolCall.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofFunctionCall(functionCall)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).contains(functionCall)
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofFunctionCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofFunctionCall(
+                BetaResponseFunctionToolCall.builder()
+                    .arguments("arguments")
+                    .callId("call_id")
+                    .name("name")
+                    .id("id")
+                    .agent(
+                        BetaResponseFunctionToolCall.Agent.builder().agentName("agent_name").build()
+                    )
+                    .callerDirect()
+                    .namespace("namespace")
+                    .status(BetaResponseFunctionToolCall.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofFunctionCallOutput() {
+        val functionCallOutput =
+            BetaResponseInputItem.FunctionCallOutput.builder()
+                .callId("x")
+                .output("string")
+                .id("fc_123")
+                .agent(
+                    BetaResponseInputItem.FunctionCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .status(BetaResponseInputItem.FunctionCallOutput.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofFunctionCallOutput(functionCallOutput)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).contains(functionCallOutput)
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofFunctionCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofFunctionCallOutput(
+                BetaResponseInputItem.FunctionCallOutput.builder()
+                    .callId("x")
+                    .output("string")
+                    .id("fc_123")
+                    .agent(
+                        BetaResponseInputItem.FunctionCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .status(BetaResponseInputItem.FunctionCallOutput.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofAgentMessage() {
+        val agentMessage =
+            BetaResponseInputItem.AgentMessage.builder()
+                .author("author")
+                .addContent(
+                    BetaResponseInputTextContent.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            BetaResponseInputTextContent.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
+                .recipient("recipient")
+                .id("amsg_123")
+                .agent(
+                    BetaResponseInputItem.AgentMessage.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofAgentMessage(agentMessage)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).contains(agentMessage)
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofAgentMessageRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofAgentMessage(
+                BetaResponseInputItem.AgentMessage.builder()
+                    .author("author")
+                    .addContent(
+                        BetaResponseInputTextContent.builder()
+                            .text("text")
+                            .promptCacheBreakpoint(
+                                BetaResponseInputTextContent.PromptCacheBreakpoint.builder().build()
+                            )
+                            .build()
+                    )
+                    .recipient("recipient")
+                    .id("amsg_123")
+                    .agent(
+                        BetaResponseInputItem.AgentMessage.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofMultiAgentCall() {
+        val multiAgentCall =
+            BetaResponseInputItem.MultiAgentCall.builder()
+                .action(BetaResponseInputItem.MultiAgentCall.Action.SPAWN_AGENT)
+                .arguments("arguments")
+                .callId("x")
+                .id("mac_123")
+                .agent(
+                    BetaResponseInputItem.MultiAgentCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofMultiAgentCall(multiAgentCall)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).contains(multiAgentCall)
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMultiAgentCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofMultiAgentCall(
+                BetaResponseInputItem.MultiAgentCall.builder()
+                    .action(BetaResponseInputItem.MultiAgentCall.Action.SPAWN_AGENT)
+                    .arguments("arguments")
+                    .callId("x")
+                    .id("mac_123")
+                    .agent(
+                        BetaResponseInputItem.MultiAgentCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofMultiAgentCallOutput() {
+        val multiAgentCallOutput =
+            BetaResponseInputItem.MultiAgentCallOutput.builder()
+                .action(BetaResponseInputItem.MultiAgentCallOutput.Action.SPAWN_AGENT)
+                .callId("x")
+                .addOutput(
+                    BetaResponseInputItem.MultiAgentCallOutput.Output.builder()
+                        .text("text")
+                        .annotationsOfBetaFileCitationParams(
+                            listOf(
+                                BetaResponseInputItem.MultiAgentCallOutput.Output.Annotations
+                                    .BetaFileCitationParam
+                                    .builder()
+                                    .fileId("file-123")
+                                    .filename("filename")
+                                    .index(0L)
+                                    .build()
+                            )
+                        )
+                        .build()
+                )
+                .id("maco_123")
+                .agent(
+                    BetaResponseInputItem.MultiAgentCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofMultiAgentCallOutput(multiAgentCallOutput)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).contains(multiAgentCallOutput)
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMultiAgentCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofMultiAgentCallOutput(
+                BetaResponseInputItem.MultiAgentCallOutput.builder()
+                    .action(BetaResponseInputItem.MultiAgentCallOutput.Action.SPAWN_AGENT)
+                    .callId("x")
+                    .addOutput(
+                        BetaResponseInputItem.MultiAgentCallOutput.Output.builder()
+                            .text("text")
+                            .annotationsOfBetaFileCitationParams(
+                                listOf(
+                                    BetaResponseInputItem.MultiAgentCallOutput.Output.Annotations
+                                        .BetaFileCitationParam
+                                        .builder()
+                                        .fileId("file-123")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                            )
+                            .build()
+                    )
+                    .id("maco_123")
+                    .agent(
+                        BetaResponseInputItem.MultiAgentCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofToolSearchCall() {
+        val toolSearchCall =
+            BetaResponseInputItem.ToolSearchCall.builder()
+                .arguments(JsonValue.from(mapOf<String, Any>()))
+                .id("tsc_123")
+                .agent(
+                    BetaResponseInputItem.ToolSearchCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callId("x")
+                .execution(BetaResponseInputItem.ToolSearchCall.Execution.SERVER)
+                .status(BetaResponseInputItem.ToolSearchCall.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofToolSearchCall(toolSearchCall)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).contains(toolSearchCall)
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofToolSearchCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofToolSearchCall(
+                BetaResponseInputItem.ToolSearchCall.builder()
+                    .arguments(JsonValue.from(mapOf<String, Any>()))
+                    .id("tsc_123")
+                    .agent(
+                        BetaResponseInputItem.ToolSearchCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callId("x")
+                    .execution(BetaResponseInputItem.ToolSearchCall.Execution.SERVER)
+                    .status(BetaResponseInputItem.ToolSearchCall.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofToolSearchOutput() {
+        val toolSearchOutput =
+            BetaResponseToolSearchOutputItemParam.builder()
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .id("tso_123")
+                .agent(
+                    BetaResponseToolSearchOutputItemParam.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callId("x")
+                .execution(BetaResponseToolSearchOutputItemParam.Execution.SERVER)
+                .status(BetaResponseToolSearchOutputItemParam.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofToolSearchOutput(toolSearchOutput)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).contains(toolSearchOutput)
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofToolSearchOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofToolSearchOutput(
+                BetaResponseToolSearchOutputItemParam.builder()
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .id("tso_123")
+                    .agent(
+                        BetaResponseToolSearchOutputItemParam.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callId("x")
+                    .execution(BetaResponseToolSearchOutputItemParam.Execution.SERVER)
+                    .status(BetaResponseToolSearchOutputItemParam.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofAdditionalTools() {
+        val additionalTools =
+            BetaResponseInputItem.AdditionalTools.builder()
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .id("at_123")
+                .agent(
+                    BetaResponseInputItem.AdditionalTools.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofAdditionalTools(additionalTools)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).contains(additionalTools)
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofAdditionalToolsRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofAdditionalTools(
+                BetaResponseInputItem.AdditionalTools.builder()
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .id("at_123")
+                    .agent(
+                        BetaResponseInputItem.AdditionalTools.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofReasoning() {
+        val reasoning =
+            BetaResponseReasoningItem.builder()
+                .id("id")
+                .addSummary(BetaResponseReasoningItem.Summary.builder().text("text").build())
+                .agent(BetaResponseReasoningItem.Agent.builder().agentName("agent_name").build())
+                .addContent(BetaResponseReasoningItem.Content.builder().text("text").build())
+                .encryptedContent("encrypted_content")
+                .status(BetaResponseReasoningItem.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofReasoning(reasoning)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).contains(reasoning)
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofReasoningRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofReasoning(
+                BetaResponseReasoningItem.builder()
+                    .id("id")
+                    .addSummary(BetaResponseReasoningItem.Summary.builder().text("text").build())
+                    .agent(
+                        BetaResponseReasoningItem.Agent.builder().agentName("agent_name").build()
+                    )
+                    .addContent(BetaResponseReasoningItem.Content.builder().text("text").build())
+                    .encryptedContent("encrypted_content")
+                    .status(BetaResponseReasoningItem.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofCompaction() {
+        val compaction =
+            BetaResponseCompactionItemParam.builder()
+                .encryptedContent("encrypted_content")
+                .id("cmp_123")
+                .agent(
+                    BetaResponseCompactionItemParam.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofCompaction(compaction)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).contains(compaction)
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofCompactionRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofCompaction(
+                BetaResponseCompactionItemParam.builder()
+                    .encryptedContent("encrypted_content")
+                    .id("cmp_123")
+                    .agent(
+                        BetaResponseCompactionItemParam.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofImageGenerationCall() {
+        val imageGenerationCall =
+            BetaResponseInputItem.ImageGenerationCall.builder()
+                .id("id")
+                .result("result")
+                .status(BetaResponseInputItem.ImageGenerationCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseInputItem.ImageGenerationCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofImageGenerationCall(imageGenerationCall)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).contains(imageGenerationCall)
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofImageGenerationCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofImageGenerationCall(
+                BetaResponseInputItem.ImageGenerationCall.builder()
+                    .id("id")
+                    .result("result")
+                    .status(BetaResponseInputItem.ImageGenerationCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseInputItem.ImageGenerationCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofCodeInterpreterCall() {
+        val codeInterpreterCall =
+            BetaResponseCodeInterpreterToolCall.builder()
+                .id("id")
+                .code("code")
+                .containerId("container_id")
+                .addLogsOutput("logs")
+                .status(BetaResponseCodeInterpreterToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseCodeInterpreterToolCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofCodeInterpreterCall(codeInterpreterCall)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).contains(codeInterpreterCall)
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofCodeInterpreterCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofCodeInterpreterCall(
+                BetaResponseCodeInterpreterToolCall.builder()
+                    .id("id")
+                    .code("code")
+                    .containerId("container_id")
+                    .addLogsOutput("logs")
+                    .status(BetaResponseCodeInterpreterToolCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseCodeInterpreterToolCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofLocalShellCall() {
+        val localShellCall =
+            BetaResponseInputItem.LocalShellCall.builder()
+                .id("id")
+                .action(
+                    BetaResponseInputItem.LocalShellCall.Action.builder()
+                        .addCommand("string")
+                        .env(
+                            BetaResponseInputItem.LocalShellCall.Action.Env.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .timeoutMs(0L)
+                        .user("user")
+                        .workingDirectory("working_directory")
+                        .build()
+                )
+                .callId("call_id")
+                .status(BetaResponseInputItem.LocalShellCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseInputItem.LocalShellCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofLocalShellCall(localShellCall)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).contains(localShellCall)
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofLocalShellCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofLocalShellCall(
+                BetaResponseInputItem.LocalShellCall.builder()
+                    .id("id")
+                    .action(
+                        BetaResponseInputItem.LocalShellCall.Action.builder()
+                            .addCommand("string")
+                            .env(
+                                BetaResponseInputItem.LocalShellCall.Action.Env.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .timeoutMs(0L)
+                            .user("user")
+                            .workingDirectory("working_directory")
+                            .build()
+                    )
+                    .callId("call_id")
+                    .status(BetaResponseInputItem.LocalShellCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseInputItem.LocalShellCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofLocalShellCallOutput() {
+        val localShellCallOutput =
+            BetaResponseInputItem.LocalShellCallOutput.builder()
+                .id("id")
+                .output("output")
+                .agent(
+                    BetaResponseInputItem.LocalShellCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .status(BetaResponseInputItem.LocalShellCallOutput.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofLocalShellCallOutput(localShellCallOutput)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).contains(localShellCallOutput)
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofLocalShellCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofLocalShellCallOutput(
+                BetaResponseInputItem.LocalShellCallOutput.builder()
+                    .id("id")
+                    .output("output")
+                    .agent(
+                        BetaResponseInputItem.LocalShellCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .status(BetaResponseInputItem.LocalShellCallOutput.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofShellCall() {
+        val shellCall =
+            BetaResponseInputItem.ShellCall.builder()
+                .action(
+                    BetaResponseInputItem.ShellCall.Action.builder()
+                        .addCommand("string")
+                        .maxOutputLength(0L)
+                        .timeoutMs(0L)
+                        .build()
+                )
+                .callId("x")
+                .id("sh_123")
+                .agent(
+                    BetaResponseInputItem.ShellCall.Agent.builder().agentName("agent_name").build()
+                )
+                .callerDirect()
+                .environment(
+                    BetaLocalEnvironment.builder()
+                        .addSkill(
+                            BetaLocalSkill.builder()
+                                .description("description")
+                                .name("name")
+                                .path("path")
+                                .build()
+                        )
+                        .build()
+                )
+                .status(BetaResponseInputItem.ShellCall.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofShellCall(shellCall)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).contains(shellCall)
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofShellCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofShellCall(
+                BetaResponseInputItem.ShellCall.builder()
+                    .action(
+                        BetaResponseInputItem.ShellCall.Action.builder()
+                            .addCommand("string")
+                            .maxOutputLength(0L)
+                            .timeoutMs(0L)
+                            .build()
+                    )
+                    .callId("x")
+                    .id("sh_123")
+                    .agent(
+                        BetaResponseInputItem.ShellCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .environment(
+                        BetaLocalEnvironment.builder()
+                            .addSkill(
+                                BetaLocalSkill.builder()
+                                    .description("description")
+                                    .name("name")
+                                    .path("path")
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .status(BetaResponseInputItem.ShellCall.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofShellCallOutput() {
+        val shellCallOutput =
+            BetaResponseInputItem.ShellCallOutput.builder()
+                .callId("x")
+                .addOutput(
+                    BetaResponseFunctionShellCallOutputContent.builder()
+                        .outcomeTimeout()
+                        .stderr("stderr")
+                        .stdout("stdout")
+                        .build()
+                )
+                .id("sho_123")
+                .agent(
+                    BetaResponseInputItem.ShellCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .maxOutputLength(0L)
+                .status(BetaResponseInputItem.ShellCallOutput.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofShellCallOutput(shellCallOutput)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).contains(shellCallOutput)
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofShellCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofShellCallOutput(
+                BetaResponseInputItem.ShellCallOutput.builder()
+                    .callId("x")
+                    .addOutput(
+                        BetaResponseFunctionShellCallOutputContent.builder()
+                            .outcomeTimeout()
+                            .stderr("stderr")
+                            .stdout("stdout")
+                            .build()
+                    )
+                    .id("sho_123")
+                    .agent(
+                        BetaResponseInputItem.ShellCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .maxOutputLength(0L)
+                    .status(BetaResponseInputItem.ShellCallOutput.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofApplyPatchCall() {
+        val applyPatchCall =
+            BetaResponseInputItem.ApplyPatchCall.builder()
+                .callId("x")
+                .operation(
+                    BetaResponseInputItem.ApplyPatchCall.Operation.CreateFile.builder()
+                        .diff("diff")
+                        .path("x")
+                        .build()
+                )
+                .status(BetaResponseInputItem.ApplyPatchCall.Status.IN_PROGRESS)
+                .id("apc_123")
+                .agent(
+                    BetaResponseInputItem.ApplyPatchCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofApplyPatchCall(applyPatchCall)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).contains(applyPatchCall)
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofApplyPatchCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofApplyPatchCall(
+                BetaResponseInputItem.ApplyPatchCall.builder()
+                    .callId("x")
+                    .operation(
+                        BetaResponseInputItem.ApplyPatchCall.Operation.CreateFile.builder()
+                            .diff("diff")
+                            .path("x")
+                            .build()
+                    )
+                    .status(BetaResponseInputItem.ApplyPatchCall.Status.IN_PROGRESS)
+                    .id("apc_123")
+                    .agent(
+                        BetaResponseInputItem.ApplyPatchCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofApplyPatchCallOutput() {
+        val applyPatchCallOutput =
+            BetaResponseInputItem.ApplyPatchCallOutput.builder()
+                .callId("x")
+                .status(BetaResponseInputItem.ApplyPatchCallOutput.Status.COMPLETED)
+                .id("apco_123")
+                .agent(
+                    BetaResponseInputItem.ApplyPatchCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .output("output")
+                .build()
+
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofApplyPatchCallOutput(applyPatchCallOutput)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).contains(applyPatchCallOutput)
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofApplyPatchCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofApplyPatchCallOutput(
+                BetaResponseInputItem.ApplyPatchCallOutput.builder()
+                    .callId("x")
+                    .status(BetaResponseInputItem.ApplyPatchCallOutput.Status.COMPLETED)
+                    .id("apco_123")
+                    .agent(
+                        BetaResponseInputItem.ApplyPatchCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .output("output")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofMcpListTools() {
+        val mcpListTools =
+            BetaResponseInputItem.McpListTools.builder()
+                .id("id")
+                .serverLabel("server_label")
+                .addTool(
+                    BetaResponseInputItem.McpListTools.Tool.builder()
+                        .inputSchema(JsonValue.from(mapOf<String, Any>()))
+                        .name("name")
+                        .annotations(JsonValue.from(mapOf<String, Any>()))
+                        .description("description")
+                        .build()
+                )
+                .agent(
+                    BetaResponseInputItem.McpListTools.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .error("error")
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofMcpListTools(mcpListTools)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).contains(mcpListTools)
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMcpListToolsRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofMcpListTools(
+                BetaResponseInputItem.McpListTools.builder()
+                    .id("id")
+                    .serverLabel("server_label")
+                    .addTool(
+                        BetaResponseInputItem.McpListTools.Tool.builder()
+                            .inputSchema(JsonValue.from(mapOf<String, Any>()))
+                            .name("name")
+                            .annotations(JsonValue.from(mapOf<String, Any>()))
+                            .description("description")
+                            .build()
+                    )
+                    .agent(
+                        BetaResponseInputItem.McpListTools.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .error("error")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofMcpApprovalRequest() {
+        val mcpApprovalRequest =
+            BetaResponseInputItem.McpApprovalRequest.builder()
+                .id("id")
+                .arguments("arguments")
+                .name("name")
+                .serverLabel("server_label")
+                .agent(
+                    BetaResponseInputItem.McpApprovalRequest.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofMcpApprovalRequest(mcpApprovalRequest)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).contains(mcpApprovalRequest)
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMcpApprovalRequestRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofMcpApprovalRequest(
+                BetaResponseInputItem.McpApprovalRequest.builder()
+                    .id("id")
+                    .arguments("arguments")
+                    .name("name")
+                    .serverLabel("server_label")
+                    .agent(
+                        BetaResponseInputItem.McpApprovalRequest.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofMcpApprovalResponse() {
+        val mcpApprovalResponse =
+            BetaResponseInputItem.McpApprovalResponse.builder()
+                .approvalRequestId("approval_request_id")
+                .approve(true)
+                .id("id")
+                .agent(
+                    BetaResponseInputItem.McpApprovalResponse.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .reason("reason")
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofMcpApprovalResponse(mcpApprovalResponse)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).contains(mcpApprovalResponse)
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMcpApprovalResponseRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofMcpApprovalResponse(
+                BetaResponseInputItem.McpApprovalResponse.builder()
+                    .approvalRequestId("approval_request_id")
+                    .approve(true)
+                    .id("id")
+                    .agent(
+                        BetaResponseInputItem.McpApprovalResponse.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .reason("reason")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofMcpCall() {
+        val mcpCall =
+            BetaResponseInputItem.McpCall.builder()
+                .id("id")
+                .arguments("arguments")
+                .name("name")
+                .serverLabel("server_label")
+                .agent(
+                    BetaResponseInputItem.McpCall.Agent.builder().agentName("agent_name").build()
+                )
+                .approvalRequestId("approval_request_id")
+                .error("error")
+                .output("output")
+                .status(BetaResponseInputItem.McpCall.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofMcpCall(mcpCall)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).contains(mcpCall)
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMcpCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofMcpCall(
+                BetaResponseInputItem.McpCall.builder()
+                    .id("id")
+                    .arguments("arguments")
+                    .name("name")
+                    .serverLabel("server_label")
+                    .agent(
+                        BetaResponseInputItem.McpCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .approvalRequestId("approval_request_id")
+                    .error("error")
+                    .output("output")
+                    .status(BetaResponseInputItem.McpCall.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofCustomToolCallOutput() {
+        val customToolCallOutput =
+            BetaResponseCustomToolCallOutput.builder()
+                .callId("call_id")
+                .output("string")
+                .id("id")
+                .agent(
+                    BetaResponseCustomToolCallOutput.Agent.builder().agentName("agent_name").build()
+                )
+                .callerDirect()
+                .build()
+
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofCustomToolCallOutput(customToolCallOutput)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).contains(customToolCallOutput)
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofCustomToolCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofCustomToolCallOutput(
+                BetaResponseCustomToolCallOutput.builder()
+                    .callId("call_id")
+                    .output("string")
+                    .id("id")
+                    .agent(
+                        BetaResponseCustomToolCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofCustomToolCall() {
+        val customToolCall =
+            BetaResponseCustomToolCall.builder()
+                .callId("call_id")
+                .input("input")
+                .name("name")
+                .id("id")
+                .agent(BetaResponseCustomToolCall.Agent.builder().agentName("agent_name").build())
+                .callerDirect()
+                .namespace("namespace")
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofCustomToolCall(customToolCall)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).contains(customToolCall)
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofCustomToolCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofCustomToolCall(
+                BetaResponseCustomToolCall.builder()
+                    .callId("call_id")
+                    .input("input")
+                    .name("name")
+                    .id("id")
+                    .agent(
+                        BetaResponseCustomToolCall.Agent.builder().agentName("agent_name").build()
+                    )
+                    .callerDirect()
+                    .namespace("namespace")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofCompactionTrigger() {
+        val compactionTrigger =
+            BetaResponseInputItem.CompactionTrigger.builder()
+                .agent(
+                    BetaResponseInputItem.CompactionTrigger.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofCompactionTrigger(compactionTrigger)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).contains(compactionTrigger)
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofCompactionTriggerRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofCompactionTrigger(
+                BetaResponseInputItem.CompactionTrigger.builder()
+                    .agent(
+                        BetaResponseInputItem.CompactionTrigger.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofItemReference() {
+        val itemReference =
+            BetaResponseInputItem.ItemReference.builder()
+                .id("id")
+                .agent(
+                    BetaResponseInputItem.ItemReference.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .type(BetaResponseInputItem.ItemReference.Type.ITEM_REFERENCE)
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofItemReference(itemReference)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).contains(itemReference)
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofItemReferenceRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofItemReference(
+                BetaResponseInputItem.ItemReference.builder()
+                    .id("id")
+                    .agent(
+                        BetaResponseInputItem.ItemReference.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .type(BetaResponseInputItem.ItemReference.Type.ITEM_REFERENCE)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofProgram() {
+        val program =
+            BetaResponseInputItem.Program.builder()
+                .id("cm_123")
+                .callId("x")
+                .code("code")
+                .fingerprint("fingerprint")
+                .agent(
+                    BetaResponseInputItem.Program.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofProgram(program)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).contains(program)
+        assertThat(betaResponseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofProgramRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofProgram(
+                BetaResponseInputItem.Program.builder()
+                    .id("cm_123")
+                    .callId("x")
+                    .code("code")
+                    .fingerprint("fingerprint")
+                    .agent(
+                        BetaResponseInputItem.Program.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    @Test
+    fun ofProgramOutput() {
+        val programOutput =
+            BetaResponseInputItem.ProgramOutput.builder()
+                .id("cmo_123")
+                .callId("x")
+                .result("result")
+                .status(BetaResponseInputItem.ProgramOutput.Status.COMPLETED)
+                .agent(
+                    BetaResponseInputItem.ProgramOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseInputItem = BetaResponseInputItem.ofProgramOutput(programOutput)
+
+        assertThat(betaResponseInputItem.betaEasyInputMessage()).isEmpty
+        assertThat(betaResponseInputItem.message()).isEmpty
+        assertThat(betaResponseInputItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseInputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCall()).isEmpty
+        assertThat(betaResponseInputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCall()).isEmpty
+        assertThat(betaResponseInputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.agentMessage()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseInputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseInputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseInputItem.additionalTools()).isEmpty
+        assertThat(betaResponseInputItem.reasoning()).isEmpty
+        assertThat(betaResponseInputItem.compaction()).isEmpty
+        assertThat(betaResponseInputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCall()).isEmpty
+        assertThat(betaResponseInputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.shellCall()).isEmpty
+        assertThat(betaResponseInputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseInputItem.mcpCall()).isEmpty
+        assertThat(betaResponseInputItem.customToolCallOutput()).isEmpty
+        assertThat(betaResponseInputItem.customToolCall()).isEmpty
+        assertThat(betaResponseInputItem.compactionTrigger()).isEmpty
+        assertThat(betaResponseInputItem.itemReference()).isEmpty
+        assertThat(betaResponseInputItem.program()).isEmpty
+        assertThat(betaResponseInputItem.programOutput()).contains(programOutput)
+    }
+
+    @Test
+    fun ofProgramOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputItem =
+            BetaResponseInputItem.ofProgramOutput(
+                BetaResponseInputItem.ProgramOutput.builder()
+                    .id("cmo_123")
+                    .callId("x")
+                    .result("result")
+                    .status(BetaResponseInputItem.ProgramOutput.Status.COMPLETED)
+                    .agent(
+                        BetaResponseInputItem.ProgramOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputItem),
+                jacksonTypeRef<BetaResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputItem).isEqualTo(betaResponseInputItem)
+    }
+
+    enum class IncompatibleJsonShapeTestCase(val value: JsonValue) {
+        BOOLEAN(JsonValue.from(false)),
+        STRING(JsonValue.from("invalid")),
+        INTEGER(JsonValue.from(-1)),
+        FLOAT(JsonValue.from(3.14)),
+        ARRAY(JsonValue.from(listOf("invalid", "array"))),
+    }
+
+    @ParameterizedTest
+    @EnumSource
+    fun incompatibleJsonShapeDeserializesToUnknown(testCase: IncompatibleJsonShapeTestCase) {
+        val betaResponseInputItem =
+            jsonMapper().convertValue(testCase.value, jacksonTypeRef<BetaResponseInputItem>())
+
+        val e = assertThrows<OpenAIInvalidDataException> { betaResponseInputItem.validate() }
+        assertThat(e).hasMessageStartingWith("Unknown ")
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputMessageItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputMessageItemTest.kt
new file mode 100644
index 000000000..8597bd81c
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputMessageItemTest.kt
@@ -0,0 +1,77 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseInputMessageItemTest {
+
+    @Test
+    fun create() {
+        val betaResponseInputMessageItem =
+            BetaResponseInputMessageItem.builder()
+                .id("id")
+                .addContent(
+                    BetaResponseInputText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
+                .role(BetaResponseInputMessageItem.Role.USER)
+                .agent(BetaResponseInputMessageItem.Agent.builder().agentName("agent_name").build())
+                .status(BetaResponseInputMessageItem.Status.IN_PROGRESS)
+                .build()
+
+        assertThat(betaResponseInputMessageItem.id()).isEqualTo("id")
+        assertThat(betaResponseInputMessageItem.content())
+            .containsExactly(
+                BetaResponseInputContent.ofInputText(
+                    BetaResponseInputText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
+            )
+        assertThat(betaResponseInputMessageItem.role())
+            .isEqualTo(BetaResponseInputMessageItem.Role.USER)
+        assertThat(betaResponseInputMessageItem.agent())
+            .contains(BetaResponseInputMessageItem.Agent.builder().agentName("agent_name").build())
+        assertThat(betaResponseInputMessageItem.status())
+            .contains(BetaResponseInputMessageItem.Status.IN_PROGRESS)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputMessageItem =
+            BetaResponseInputMessageItem.builder()
+                .id("id")
+                .addContent(
+                    BetaResponseInputText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
+                .role(BetaResponseInputMessageItem.Role.USER)
+                .agent(BetaResponseInputMessageItem.Agent.builder().agentName("agent_name").build())
+                .status(BetaResponseInputMessageItem.Status.IN_PROGRESS)
+                .build()
+
+        val roundtrippedBetaResponseInputMessageItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputMessageItem),
+                jacksonTypeRef<BetaResponseInputMessageItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputMessageItem).isEqualTo(betaResponseInputMessageItem)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputTextContentTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputTextContentTest.kt
new file mode 100644
index 000000000..654b2c511
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputTextContentTest.kt
@@ -0,0 +1,46 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseInputTextContentTest {
+
+    @Test
+    fun create() {
+        val betaResponseInputTextContent =
+            BetaResponseInputTextContent.builder()
+                .text("text")
+                .promptCacheBreakpoint(
+                    BetaResponseInputTextContent.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        assertThat(betaResponseInputTextContent.text()).isEqualTo("text")
+        assertThat(betaResponseInputTextContent.promptCacheBreakpoint())
+            .contains(BetaResponseInputTextContent.PromptCacheBreakpoint.builder().build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputTextContent =
+            BetaResponseInputTextContent.builder()
+                .text("text")
+                .promptCacheBreakpoint(
+                    BetaResponseInputTextContent.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseInputTextContent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputTextContent),
+                jacksonTypeRef<BetaResponseInputTextContent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputTextContent).isEqualTo(betaResponseInputTextContent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputTextTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputTextTest.kt
new file mode 100644
index 000000000..81e21fb98
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseInputTextTest.kt
@@ -0,0 +1,46 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseInputTextTest {
+
+    @Test
+    fun create() {
+        val betaResponseInputText =
+            BetaResponseInputText.builder()
+                .text("text")
+                .promptCacheBreakpoint(
+                    BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        assertThat(betaResponseInputText.text()).isEqualTo("text")
+        assertThat(betaResponseInputText.promptCacheBreakpoint())
+            .contains(BetaResponseInputText.PromptCacheBreakpoint.builder().build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseInputText =
+            BetaResponseInputText.builder()
+                .text("text")
+                .promptCacheBreakpoint(
+                    BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseInputText =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseInputText),
+                jacksonTypeRef<BetaResponseInputText>(),
+            )
+
+        assertThat(roundtrippedBetaResponseInputText).isEqualTo(betaResponseInputText)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseItemTest.kt
new file mode 100644
index 000000000..bd7389cf2
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseItemTest.kt
@@ -0,0 +1,2891 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import com.openai.errors.OpenAIInvalidDataException
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.assertThrows
+import org.junit.jupiter.params.ParameterizedTest
+import org.junit.jupiter.params.provider.EnumSource
+
+internal class BetaResponseItemTest {
+
+    @Test
+    fun ofBetaResponseInputMessageItem() {
+        val betaResponseInputMessageItem =
+            BetaResponseInputMessageItem.builder()
+                .id("id")
+                .addContent(
+                    BetaResponseInputText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
+                .role(BetaResponseInputMessageItem.Role.USER)
+                .agent(BetaResponseInputMessageItem.Agent.builder().agentName("agent_name").build())
+                .status(BetaResponseInputMessageItem.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseItem =
+            BetaResponseItem.ofBetaResponseInputMessageItem(betaResponseInputMessageItem)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem())
+            .contains(betaResponseInputMessageItem)
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofBetaResponseInputMessageItemRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofBetaResponseInputMessageItem(
+                BetaResponseInputMessageItem.builder()
+                    .id("id")
+                    .addContent(
+                        BetaResponseInputText.builder()
+                            .text("text")
+                            .promptCacheBreakpoint(
+                                BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                            )
+                            .build()
+                    )
+                    .role(BetaResponseInputMessageItem.Role.USER)
+                    .agent(
+                        BetaResponseInputMessageItem.Agent.builder().agentName("agent_name").build()
+                    )
+                    .status(BetaResponseInputMessageItem.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofBetaResponseOutputMessage() {
+        val betaResponseOutputMessage =
+            BetaResponseOutputMessage.builder()
+                .id("id")
+                .addContent(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                .agent(BetaResponseOutputMessage.Agent.builder().agentName("agent_name").build())
+                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                .build()
+
+        val betaResponseItem =
+            BetaResponseItem.ofBetaResponseOutputMessage(betaResponseOutputMessage)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).contains(betaResponseOutputMessage)
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofBetaResponseOutputMessageRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofBetaResponseOutputMessage(
+                BetaResponseOutputMessage.builder()
+                    .id("id")
+                    .addContent(
+                        BetaResponseOutputText.builder()
+                            .addAnnotation(
+                                BetaResponseOutputText.Annotation.FileCitation.builder()
+                                    .fileId("file_id")
+                                    .filename("filename")
+                                    .index(0L)
+                                    .build()
+                            )
+                            .text("text")
+                            .addLogprob(
+                                BetaResponseOutputText.Logprob.builder()
+                                    .token("token")
+                                    .addByte(0L)
+                                    .logprob(0.0)
+                                    .addTopLogprob(
+                                        BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseOutputMessage.Agent.builder().agentName("agent_name").build()
+                    )
+                    .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofFileSearchCall() {
+        val fileSearchCall =
+            BetaResponseFileSearchToolCall.builder()
+                .id("id")
+                .addQuery("string")
+                .status(BetaResponseFileSearchToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFileSearchToolCall.Agent.builder().agentName("agent_name").build()
+                )
+                .addResult(
+                    BetaResponseFileSearchToolCall.Result.builder()
+                        .attributes(
+                            BetaResponseFileSearchToolCall.Result.Attributes.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .fileId("file_id")
+                        .filename("filename")
+                        .score(0.0f)
+                        .text("text")
+                        .build()
+                )
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofFileSearchCall(fileSearchCall)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).contains(fileSearchCall)
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofFileSearchCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofFileSearchCall(
+                BetaResponseFileSearchToolCall.builder()
+                    .id("id")
+                    .addQuery("string")
+                    .status(BetaResponseFileSearchToolCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseFileSearchToolCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .addResult(
+                        BetaResponseFileSearchToolCall.Result.builder()
+                            .attributes(
+                                BetaResponseFileSearchToolCall.Result.Attributes.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .fileId("file_id")
+                            .filename("filename")
+                            .score(0.0f)
+                            .text("text")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofComputerCall() {
+        val computerCall =
+            BetaResponseComputerToolCall.builder()
+                .id("id")
+                .callId("call_id")
+                .addPendingSafetyCheck(
+                    BetaResponseComputerToolCall.PendingSafetyCheck.builder()
+                        .id("id")
+                        .code("code")
+                        .message("message")
+                        .build()
+                )
+                .status(BetaResponseComputerToolCall.Status.IN_PROGRESS)
+                .type(BetaResponseComputerToolCall.Type.COMPUTER_CALL)
+                .action(
+                    BetaComputerAction.Click.builder()
+                        .button(BetaComputerAction.Click.Button.LEFT)
+                        .x(0L)
+                        .y(0L)
+                        .addKey("string")
+                        .build()
+                )
+                .addAction(
+                    BetaComputerAction.Click.builder()
+                        .button(BetaComputerAction.Click.Button.LEFT)
+                        .x(0L)
+                        .y(0L)
+                        .addKey("string")
+                        .build()
+                )
+                .agent(BetaResponseComputerToolCall.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofComputerCall(computerCall)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).contains(computerCall)
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofComputerCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofComputerCall(
+                BetaResponseComputerToolCall.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .addPendingSafetyCheck(
+                        BetaResponseComputerToolCall.PendingSafetyCheck.builder()
+                            .id("id")
+                            .code("code")
+                            .message("message")
+                            .build()
+                    )
+                    .status(BetaResponseComputerToolCall.Status.IN_PROGRESS)
+                    .type(BetaResponseComputerToolCall.Type.COMPUTER_CALL)
+                    .action(
+                        BetaComputerAction.Click.builder()
+                            .button(BetaComputerAction.Click.Button.LEFT)
+                            .x(0L)
+                            .y(0L)
+                            .addKey("string")
+                            .build()
+                    )
+                    .addAction(
+                        BetaComputerAction.Click.builder()
+                            .button(BetaComputerAction.Click.Button.LEFT)
+                            .x(0L)
+                            .y(0L)
+                            .addKey("string")
+                            .build()
+                    )
+                    .agent(
+                        BetaResponseComputerToolCall.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofComputerCallOutput() {
+        val computerCallOutput =
+            BetaResponseComputerToolCallOutputItem.builder()
+                .id("id")
+                .callId("call_id")
+                .output(
+                    BetaResponseComputerToolCallOutputScreenshot.builder()
+                        .fileId("file_id")
+                        .imageUrl("https://example.com")
+                        .build()
+                )
+                .status(BetaResponseComputerToolCallOutputItem.Status.COMPLETED)
+                .addAcknowledgedSafetyCheck(
+                    BetaResponseComputerToolCallOutputItem.AcknowledgedSafetyCheck.builder()
+                        .id("id")
+                        .code("code")
+                        .message("message")
+                        .build()
+                )
+                .agent(
+                    BetaResponseComputerToolCallOutputItem.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofComputerCallOutput(computerCallOutput)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).contains(computerCallOutput)
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofComputerCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofComputerCallOutput(
+                BetaResponseComputerToolCallOutputItem.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .output(
+                        BetaResponseComputerToolCallOutputScreenshot.builder()
+                            .fileId("file_id")
+                            .imageUrl("https://example.com")
+                            .build()
+                    )
+                    .status(BetaResponseComputerToolCallOutputItem.Status.COMPLETED)
+                    .addAcknowledgedSafetyCheck(
+                        BetaResponseComputerToolCallOutputItem.AcknowledgedSafetyCheck.builder()
+                            .id("id")
+                            .code("code")
+                            .message("message")
+                            .build()
+                    )
+                    .agent(
+                        BetaResponseComputerToolCallOutputItem.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofWebSearchCall() {
+        val webSearchCall =
+            BetaResponseFunctionWebSearch.builder()
+                .id("id")
+                .action(
+                    BetaResponseFunctionWebSearch.Action.Search.builder()
+                        .addQuery("string")
+                        .query("query")
+                        .addSource(
+                            BetaResponseFunctionWebSearch.Action.Search.Source.builder()
+                                .url("https://example.com")
+                                .build()
+                        )
+                        .build()
+                )
+                .status(BetaResponseFunctionWebSearch.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionWebSearch.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofWebSearchCall(webSearchCall)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).contains(webSearchCall)
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofWebSearchCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofWebSearchCall(
+                BetaResponseFunctionWebSearch.builder()
+                    .id("id")
+                    .action(
+                        BetaResponseFunctionWebSearch.Action.Search.builder()
+                            .addQuery("string")
+                            .query("query")
+                            .addSource(
+                                BetaResponseFunctionWebSearch.Action.Search.Source.builder()
+                                    .url("https://example.com")
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .status(BetaResponseFunctionWebSearch.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseFunctionWebSearch.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofFunctionCall() {
+        val functionCall =
+            BetaResponseFunctionToolCallItem.builder()
+                .arguments("arguments")
+                .callId("call_id")
+                .name("name")
+                .id("id")
+                .agent(BetaResponseFunctionToolCall.Agent.builder().agentName("agent_name").build())
+                .callerDirect()
+                .namespace("namespace")
+                .status(BetaResponseFunctionToolCall.Status.IN_PROGRESS)
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofFunctionCall(functionCall)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).contains(functionCall)
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofFunctionCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofFunctionCall(
+                BetaResponseFunctionToolCallItem.builder()
+                    .arguments("arguments")
+                    .callId("call_id")
+                    .name("name")
+                    .id("id")
+                    .agent(
+                        BetaResponseFunctionToolCall.Agent.builder().agentName("agent_name").build()
+                    )
+                    .callerDirect()
+                    .namespace("namespace")
+                    .status(BetaResponseFunctionToolCall.Status.IN_PROGRESS)
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofFunctionCallOutput() {
+        val functionCallOutput =
+            BetaResponseFunctionToolCallOutputItem.builder()
+                .id("id")
+                .callId("call_id")
+                .output("string")
+                .status(BetaResponseFunctionToolCallOutputItem.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionToolCallOutputItem.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofFunctionCallOutput(functionCallOutput)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).contains(functionCallOutput)
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofFunctionCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofFunctionCallOutput(
+                BetaResponseFunctionToolCallOutputItem.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .output("string")
+                    .status(BetaResponseFunctionToolCallOutputItem.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseFunctionToolCallOutputItem.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofAgentMessage() {
+        val agentMessage =
+            BetaResponseItem.AgentMessage.builder()
+                .id("id")
+                .author("author")
+                .addContent(
+                    BetaResponseInputText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
+                .recipient("recipient")
+                .agent(
+                    BetaResponseItem.AgentMessage.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofAgentMessage(agentMessage)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).contains(agentMessage)
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofAgentMessageRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofAgentMessage(
+                BetaResponseItem.AgentMessage.builder()
+                    .id("id")
+                    .author("author")
+                    .addContent(
+                        BetaResponseInputText.builder()
+                            .text("text")
+                            .promptCacheBreakpoint(
+                                BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                            )
+                            .build()
+                    )
+                    .recipient("recipient")
+                    .agent(
+                        BetaResponseItem.AgentMessage.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofMultiAgentCall() {
+        val multiAgentCall =
+            BetaResponseItem.MultiAgentCall.builder()
+                .id("id")
+                .action(BetaResponseItem.MultiAgentCall.Action.SPAWN_AGENT)
+                .arguments("arguments")
+                .callId("call_id")
+                .agent(
+                    BetaResponseItem.MultiAgentCall.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofMultiAgentCall(multiAgentCall)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).contains(multiAgentCall)
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMultiAgentCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofMultiAgentCall(
+                BetaResponseItem.MultiAgentCall.builder()
+                    .id("id")
+                    .action(BetaResponseItem.MultiAgentCall.Action.SPAWN_AGENT)
+                    .arguments("arguments")
+                    .callId("call_id")
+                    .agent(
+                        BetaResponseItem.MultiAgentCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofMultiAgentCallOutput() {
+        val multiAgentCallOutput =
+            BetaResponseItem.MultiAgentCallOutput.builder()
+                .id("id")
+                .action(BetaResponseItem.MultiAgentCallOutput.Action.SPAWN_AGENT)
+                .callId("call_id")
+                .addOutput(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .agent(
+                    BetaResponseItem.MultiAgentCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofMultiAgentCallOutput(multiAgentCallOutput)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).contains(multiAgentCallOutput)
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMultiAgentCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofMultiAgentCallOutput(
+                BetaResponseItem.MultiAgentCallOutput.builder()
+                    .id("id")
+                    .action(BetaResponseItem.MultiAgentCallOutput.Action.SPAWN_AGENT)
+                    .callId("call_id")
+                    .addOutput(
+                        BetaResponseOutputText.builder()
+                            .addAnnotation(
+                                BetaResponseOutputText.Annotation.FileCitation.builder()
+                                    .fileId("file_id")
+                                    .filename("filename")
+                                    .index(0L)
+                                    .build()
+                            )
+                            .text("text")
+                            .addLogprob(
+                                BetaResponseOutputText.Logprob.builder()
+                                    .token("token")
+                                    .addByte(0L)
+                                    .logprob(0.0)
+                                    .addTopLogprob(
+                                        BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .agent(
+                        BetaResponseItem.MultiAgentCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofToolSearchCall() {
+        val toolSearchCall =
+            BetaResponseToolSearchCall.builder()
+                .id("id")
+                .arguments(JsonValue.from(mapOf<String, Any>()))
+                .callId("call_id")
+                .execution(BetaResponseToolSearchCall.Execution.SERVER)
+                .status(BetaResponseToolSearchCall.Status.IN_PROGRESS)
+                .agent(BetaResponseToolSearchCall.Agent.builder().agentName("agent_name").build())
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofToolSearchCall(toolSearchCall)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).contains(toolSearchCall)
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofToolSearchCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofToolSearchCall(
+                BetaResponseToolSearchCall.builder()
+                    .id("id")
+                    .arguments(JsonValue.from(mapOf<String, Any>()))
+                    .callId("call_id")
+                    .execution(BetaResponseToolSearchCall.Execution.SERVER)
+                    .status(BetaResponseToolSearchCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseToolSearchCall.Agent.builder().agentName("agent_name").build()
+                    )
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofToolSearchOutput() {
+        val toolSearchOutput =
+            BetaResponseToolSearchOutputItem.builder()
+                .id("id")
+                .callId("call_id")
+                .execution(BetaResponseToolSearchOutputItem.Execution.SERVER)
+                .status(BetaResponseToolSearchOutputItem.Status.IN_PROGRESS)
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .agent(
+                    BetaResponseToolSearchOutputItem.Agent.builder().agentName("agent_name").build()
+                )
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofToolSearchOutput(toolSearchOutput)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).contains(toolSearchOutput)
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofToolSearchOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofToolSearchOutput(
+                BetaResponseToolSearchOutputItem.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .execution(BetaResponseToolSearchOutputItem.Execution.SERVER)
+                    .status(BetaResponseToolSearchOutputItem.Status.IN_PROGRESS)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .agent(
+                        BetaResponseToolSearchOutputItem.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofAdditionalTools() {
+        val additionalTools =
+            BetaResponseItem.AdditionalTools.builder()
+                .id("id")
+                .role(BetaResponseItem.AdditionalTools.Role.UNKNOWN)
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .agent(
+                    BetaResponseItem.AdditionalTools.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofAdditionalTools(additionalTools)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).contains(additionalTools)
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofAdditionalToolsRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofAdditionalTools(
+                BetaResponseItem.AdditionalTools.builder()
+                    .id("id")
+                    .role(BetaResponseItem.AdditionalTools.Role.UNKNOWN)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .agent(
+                        BetaResponseItem.AdditionalTools.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofReasoning() {
+        val reasoning =
+            BetaResponseReasoningItem.builder()
+                .id("id")
+                .addSummary(BetaResponseReasoningItem.Summary.builder().text("text").build())
+                .agent(BetaResponseReasoningItem.Agent.builder().agentName("agent_name").build())
+                .addContent(BetaResponseReasoningItem.Content.builder().text("text").build())
+                .encryptedContent("encrypted_content")
+                .status(BetaResponseReasoningItem.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofReasoning(reasoning)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).contains(reasoning)
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofReasoningRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofReasoning(
+                BetaResponseReasoningItem.builder()
+                    .id("id")
+                    .addSummary(BetaResponseReasoningItem.Summary.builder().text("text").build())
+                    .agent(
+                        BetaResponseReasoningItem.Agent.builder().agentName("agent_name").build()
+                    )
+                    .addContent(BetaResponseReasoningItem.Content.builder().text("text").build())
+                    .encryptedContent("encrypted_content")
+                    .status(BetaResponseReasoningItem.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofProgram() {
+        val program =
+            BetaResponseItem.Program.builder()
+                .id("id")
+                .callId("call_id")
+                .code("code")
+                .fingerprint("fingerprint")
+                .agent(BetaResponseItem.Program.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofProgram(program)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).contains(program)
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofProgramRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofProgram(
+                BetaResponseItem.Program.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .code("code")
+                    .fingerprint("fingerprint")
+                    .agent(BetaResponseItem.Program.Agent.builder().agentName("agent_name").build())
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofProgramOutput() {
+        val programOutput =
+            BetaResponseItem.ProgramOutput.builder()
+                .id("id")
+                .callId("call_id")
+                .result("result")
+                .status(BetaResponseItem.ProgramOutput.Status.COMPLETED)
+                .agent(
+                    BetaResponseItem.ProgramOutput.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofProgramOutput(programOutput)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).contains(programOutput)
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofProgramOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofProgramOutput(
+                BetaResponseItem.ProgramOutput.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .result("result")
+                    .status(BetaResponseItem.ProgramOutput.Status.COMPLETED)
+                    .agent(
+                        BetaResponseItem.ProgramOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofCompaction() {
+        val compaction =
+            BetaResponseCompactionItem.builder()
+                .id("id")
+                .encryptedContent("encrypted_content")
+                .agent(BetaResponseCompactionItem.Agent.builder().agentName("agent_name").build())
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofCompaction(compaction)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).contains(compaction)
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofCompactionRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofCompaction(
+                BetaResponseCompactionItem.builder()
+                    .id("id")
+                    .encryptedContent("encrypted_content")
+                    .agent(
+                        BetaResponseCompactionItem.Agent.builder().agentName("agent_name").build()
+                    )
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofImageGenerationCall() {
+        val imageGenerationCall =
+            BetaResponseItem.ImageGenerationCall.builder()
+                .id("id")
+                .result("result")
+                .status(BetaResponseItem.ImageGenerationCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseItem.ImageGenerationCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofImageGenerationCall(imageGenerationCall)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).contains(imageGenerationCall)
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofImageGenerationCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofImageGenerationCall(
+                BetaResponseItem.ImageGenerationCall.builder()
+                    .id("id")
+                    .result("result")
+                    .status(BetaResponseItem.ImageGenerationCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseItem.ImageGenerationCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofCodeInterpreterCall() {
+        val codeInterpreterCall =
+            BetaResponseCodeInterpreterToolCall.builder()
+                .id("id")
+                .code("code")
+                .containerId("container_id")
+                .addLogsOutput("logs")
+                .status(BetaResponseCodeInterpreterToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseCodeInterpreterToolCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofCodeInterpreterCall(codeInterpreterCall)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).contains(codeInterpreterCall)
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofCodeInterpreterCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofCodeInterpreterCall(
+                BetaResponseCodeInterpreterToolCall.builder()
+                    .id("id")
+                    .code("code")
+                    .containerId("container_id")
+                    .addLogsOutput("logs")
+                    .status(BetaResponseCodeInterpreterToolCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseCodeInterpreterToolCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofLocalShellCall() {
+        val localShellCall =
+            BetaResponseItem.LocalShellCall.builder()
+                .id("id")
+                .action(
+                    BetaResponseItem.LocalShellCall.Action.builder()
+                        .addCommand("string")
+                        .env(
+                            BetaResponseItem.LocalShellCall.Action.Env.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .timeoutMs(0L)
+                        .user("user")
+                        .workingDirectory("working_directory")
+                        .build()
+                )
+                .callId("call_id")
+                .status(BetaResponseItem.LocalShellCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseItem.LocalShellCall.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofLocalShellCall(localShellCall)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).contains(localShellCall)
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofLocalShellCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofLocalShellCall(
+                BetaResponseItem.LocalShellCall.builder()
+                    .id("id")
+                    .action(
+                        BetaResponseItem.LocalShellCall.Action.builder()
+                            .addCommand("string")
+                            .env(
+                                BetaResponseItem.LocalShellCall.Action.Env.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .timeoutMs(0L)
+                            .user("user")
+                            .workingDirectory("working_directory")
+                            .build()
+                    )
+                    .callId("call_id")
+                    .status(BetaResponseItem.LocalShellCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseItem.LocalShellCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofLocalShellCallOutput() {
+        val localShellCallOutput =
+            BetaResponseItem.LocalShellCallOutput.builder()
+                .id("id")
+                .output("output")
+                .agent(
+                    BetaResponseItem.LocalShellCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .status(BetaResponseItem.LocalShellCallOutput.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofLocalShellCallOutput(localShellCallOutput)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).contains(localShellCallOutput)
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofLocalShellCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofLocalShellCallOutput(
+                BetaResponseItem.LocalShellCallOutput.builder()
+                    .id("id")
+                    .output("output")
+                    .agent(
+                        BetaResponseItem.LocalShellCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .status(BetaResponseItem.LocalShellCallOutput.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofShellCall() {
+        val shellCall =
+            BetaResponseFunctionShellToolCall.builder()
+                .id("id")
+                .action(
+                    BetaResponseFunctionShellToolCall.Action.builder()
+                        .addCommand("string")
+                        .maxOutputLength(0L)
+                        .timeoutMs(0L)
+                        .build()
+                )
+                .callId("call_id")
+                .environment(BetaResponseLocalEnvironment.builder().build())
+                .status(BetaResponseFunctionShellToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionShellToolCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofShellCall(shellCall)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).contains(shellCall)
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofShellCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofShellCall(
+                BetaResponseFunctionShellToolCall.builder()
+                    .id("id")
+                    .action(
+                        BetaResponseFunctionShellToolCall.Action.builder()
+                            .addCommand("string")
+                            .maxOutputLength(0L)
+                            .timeoutMs(0L)
+                            .build()
+                    )
+                    .callId("call_id")
+                    .environment(BetaResponseLocalEnvironment.builder().build())
+                    .status(BetaResponseFunctionShellToolCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseFunctionShellToolCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofShellCallOutput() {
+        val shellCallOutput =
+            BetaResponseFunctionShellToolCallOutput.builder()
+                .id("id")
+                .callId("call_id")
+                .maxOutputLength(0L)
+                .addOutput(
+                    BetaResponseFunctionShellToolCallOutput.Output.builder()
+                        .outcomeTimeout()
+                        .stderr("stderr")
+                        .stdout("stdout")
+                        .createdBy("created_by")
+                        .build()
+                )
+                .status(BetaResponseFunctionShellToolCallOutput.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionShellToolCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofShellCallOutput(shellCallOutput)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).contains(shellCallOutput)
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofShellCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofShellCallOutput(
+                BetaResponseFunctionShellToolCallOutput.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .maxOutputLength(0L)
+                    .addOutput(
+                        BetaResponseFunctionShellToolCallOutput.Output.builder()
+                            .outcomeTimeout()
+                            .stderr("stderr")
+                            .stdout("stdout")
+                            .createdBy("created_by")
+                            .build()
+                    )
+                    .status(BetaResponseFunctionShellToolCallOutput.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseFunctionShellToolCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofApplyPatchCall() {
+        val applyPatchCall =
+            BetaResponseApplyPatchToolCall.builder()
+                .id("id")
+                .callId("call_id")
+                .operation(
+                    BetaResponseApplyPatchToolCall.Operation.CreateFile.builder()
+                        .diff("diff")
+                        .path("path")
+                        .build()
+                )
+                .status(BetaResponseApplyPatchToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseApplyPatchToolCall.Agent.builder().agentName("agent_name").build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofApplyPatchCall(applyPatchCall)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).contains(applyPatchCall)
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofApplyPatchCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofApplyPatchCall(
+                BetaResponseApplyPatchToolCall.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .operation(
+                        BetaResponseApplyPatchToolCall.Operation.CreateFile.builder()
+                            .diff("diff")
+                            .path("path")
+                            .build()
+                    )
+                    .status(BetaResponseApplyPatchToolCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseApplyPatchToolCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofApplyPatchCallOutput() {
+        val applyPatchCallOutput =
+            BetaResponseApplyPatchToolCallOutput.builder()
+                .id("id")
+                .callId("call_id")
+                .status(BetaResponseApplyPatchToolCallOutput.Status.COMPLETED)
+                .agent(
+                    BetaResponseApplyPatchToolCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .output("output")
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofApplyPatchCallOutput(applyPatchCallOutput)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).contains(applyPatchCallOutput)
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofApplyPatchCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofApplyPatchCallOutput(
+                BetaResponseApplyPatchToolCallOutput.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .status(BetaResponseApplyPatchToolCallOutput.Status.COMPLETED)
+                    .agent(
+                        BetaResponseApplyPatchToolCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .createdBy("created_by")
+                    .output("output")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofMcpListTools() {
+        val mcpListTools =
+            BetaResponseItem.McpListTools.builder()
+                .id("id")
+                .serverLabel("server_label")
+                .addTool(
+                    BetaResponseItem.McpListTools.Tool.builder()
+                        .inputSchema(JsonValue.from(mapOf<String, Any>()))
+                        .name("name")
+                        .annotations(JsonValue.from(mapOf<String, Any>()))
+                        .description("description")
+                        .build()
+                )
+                .agent(
+                    BetaResponseItem.McpListTools.Agent.builder().agentName("agent_name").build()
+                )
+                .error("error")
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofMcpListTools(mcpListTools)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).contains(mcpListTools)
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMcpListToolsRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofMcpListTools(
+                BetaResponseItem.McpListTools.builder()
+                    .id("id")
+                    .serverLabel("server_label")
+                    .addTool(
+                        BetaResponseItem.McpListTools.Tool.builder()
+                            .inputSchema(JsonValue.from(mapOf<String, Any>()))
+                            .name("name")
+                            .annotations(JsonValue.from(mapOf<String, Any>()))
+                            .description("description")
+                            .build()
+                    )
+                    .agent(
+                        BetaResponseItem.McpListTools.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .error("error")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofMcpApprovalRequest() {
+        val mcpApprovalRequest =
+            BetaResponseItem.McpApprovalRequest.builder()
+                .id("id")
+                .arguments("arguments")
+                .name("name")
+                .serverLabel("server_label")
+                .agent(
+                    BetaResponseItem.McpApprovalRequest.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofMcpApprovalRequest(mcpApprovalRequest)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).contains(mcpApprovalRequest)
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMcpApprovalRequestRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofMcpApprovalRequest(
+                BetaResponseItem.McpApprovalRequest.builder()
+                    .id("id")
+                    .arguments("arguments")
+                    .name("name")
+                    .serverLabel("server_label")
+                    .agent(
+                        BetaResponseItem.McpApprovalRequest.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofMcpApprovalResponse() {
+        val mcpApprovalResponse =
+            BetaResponseItem.McpApprovalResponse.builder()
+                .id("id")
+                .approvalRequestId("approval_request_id")
+                .approve(true)
+                .agent(
+                    BetaResponseItem.McpApprovalResponse.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .reason("reason")
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofMcpApprovalResponse(mcpApprovalResponse)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).contains(mcpApprovalResponse)
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMcpApprovalResponseRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofMcpApprovalResponse(
+                BetaResponseItem.McpApprovalResponse.builder()
+                    .id("id")
+                    .approvalRequestId("approval_request_id")
+                    .approve(true)
+                    .agent(
+                        BetaResponseItem.McpApprovalResponse.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .reason("reason")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofMcpCall() {
+        val mcpCall =
+            BetaResponseItem.McpCall.builder()
+                .id("id")
+                .arguments("arguments")
+                .name("name")
+                .serverLabel("server_label")
+                .agent(BetaResponseItem.McpCall.Agent.builder().agentName("agent_name").build())
+                .approvalRequestId("approval_request_id")
+                .error("error")
+                .output("output")
+                .status(BetaResponseItem.McpCall.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofMcpCall(mcpCall)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).contains(mcpCall)
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMcpCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofMcpCall(
+                BetaResponseItem.McpCall.builder()
+                    .id("id")
+                    .arguments("arguments")
+                    .name("name")
+                    .serverLabel("server_label")
+                    .agent(BetaResponseItem.McpCall.Agent.builder().agentName("agent_name").build())
+                    .approvalRequestId("approval_request_id")
+                    .error("error")
+                    .output("output")
+                    .status(BetaResponseItem.McpCall.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofCustomToolCall() {
+        val customToolCall =
+            BetaResponseCustomToolCallItem.builder()
+                .callId("call_id")
+                .input("input")
+                .name("name")
+                .id("id")
+                .agent(BetaResponseCustomToolCall.Agent.builder().agentName("agent_name").build())
+                .callerDirect()
+                .namespace("namespace")
+                .status(BetaResponseCustomToolCallItem.Status.IN_PROGRESS)
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofCustomToolCall(customToolCall)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).contains(customToolCall)
+        assertThat(betaResponseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofCustomToolCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofCustomToolCall(
+                BetaResponseCustomToolCallItem.builder()
+                    .callId("call_id")
+                    .input("input")
+                    .name("name")
+                    .id("id")
+                    .agent(
+                        BetaResponseCustomToolCall.Agent.builder().agentName("agent_name").build()
+                    )
+                    .callerDirect()
+                    .namespace("namespace")
+                    .status(BetaResponseCustomToolCallItem.Status.IN_PROGRESS)
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    @Test
+    fun ofCustomToolCallOutput() {
+        val customToolCallOutput =
+            BetaResponseCustomToolCallOutputItem.builder()
+                .callId("call_id")
+                .output("string")
+                .id("id")
+                .agent(
+                    BetaResponseCustomToolCallOutput.Agent.builder().agentName("agent_name").build()
+                )
+                .callerDirect()
+                .status(BetaResponseCustomToolCallOutputItem.Status.IN_PROGRESS)
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseItem = BetaResponseItem.ofCustomToolCallOutput(customToolCallOutput)
+
+        assertThat(betaResponseItem.betaResponseInputMessageItem()).isEmpty
+        assertThat(betaResponseItem.betaResponseOutputMessage()).isEmpty
+        assertThat(betaResponseItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseItem.computerCall()).isEmpty
+        assertThat(betaResponseItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseItem.webSearchCall()).isEmpty
+        assertThat(betaResponseItem.functionCall()).isEmpty
+        assertThat(betaResponseItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseItem.agentMessage()).isEmpty
+        assertThat(betaResponseItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseItem.additionalTools()).isEmpty
+        assertThat(betaResponseItem.reasoning()).isEmpty
+        assertThat(betaResponseItem.program()).isEmpty
+        assertThat(betaResponseItem.programOutput()).isEmpty
+        assertThat(betaResponseItem.compaction()).isEmpty
+        assertThat(betaResponseItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseItem.localShellCall()).isEmpty
+        assertThat(betaResponseItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseItem.shellCall()).isEmpty
+        assertThat(betaResponseItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseItem.mcpListTools()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseItem.mcpCall()).isEmpty
+        assertThat(betaResponseItem.customToolCall()).isEmpty
+        assertThat(betaResponseItem.customToolCallOutput()).contains(customToolCallOutput)
+    }
+
+    @Test
+    fun ofCustomToolCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItem =
+            BetaResponseItem.ofCustomToolCallOutput(
+                BetaResponseCustomToolCallOutputItem.builder()
+                    .callId("call_id")
+                    .output("string")
+                    .id("id")
+                    .agent(
+                        BetaResponseCustomToolCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .status(BetaResponseCustomToolCallOutputItem.Status.IN_PROGRESS)
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItem),
+                jacksonTypeRef<BetaResponseItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItem).isEqualTo(betaResponseItem)
+    }
+
+    enum class IncompatibleJsonShapeTestCase(val value: JsonValue) {
+        BOOLEAN(JsonValue.from(false)),
+        STRING(JsonValue.from("invalid")),
+        INTEGER(JsonValue.from(-1)),
+        FLOAT(JsonValue.from(3.14)),
+        ARRAY(JsonValue.from(listOf("invalid", "array"))),
+    }
+
+    @ParameterizedTest
+    @EnumSource
+    fun incompatibleJsonShapeDeserializesToUnknown(testCase: IncompatibleJsonShapeTestCase) {
+        val betaResponseItem =
+            jsonMapper().convertValue(testCase.value, jacksonTypeRef<BetaResponseItem>())
+
+        val e = assertThrows<OpenAIInvalidDataException> { betaResponseItem.validate() }
+        assertThat(e).hasMessageStartingWith("Unknown ")
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseLocalEnvironmentTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseLocalEnvironmentTest.kt
new file mode 100644
index 000000000..eff9ba22f
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseLocalEnvironmentTest.kt
@@ -0,0 +1,30 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseLocalEnvironmentTest {
+
+    @Test
+    fun create() {
+        val betaResponseLocalEnvironment = BetaResponseLocalEnvironment.builder().build()
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseLocalEnvironment = BetaResponseLocalEnvironment.builder().build()
+
+        val roundtrippedBetaResponseLocalEnvironment =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseLocalEnvironment),
+                jacksonTypeRef<BetaResponseLocalEnvironment>(),
+            )
+
+        assertThat(roundtrippedBetaResponseLocalEnvironment).isEqualTo(betaResponseLocalEnvironment)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallArgumentsDeltaEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallArgumentsDeltaEventTest.kt
new file mode 100644
index 000000000..5dc112e46
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallArgumentsDeltaEventTest.kt
@@ -0,0 +1,64 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseMcpCallArgumentsDeltaEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseMcpCallArgumentsDeltaEvent =
+            BetaResponseMcpCallArgumentsDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallArgumentsDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseMcpCallArgumentsDeltaEvent.delta()).isEqualTo("delta")
+        assertThat(betaResponseMcpCallArgumentsDeltaEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseMcpCallArgumentsDeltaEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseMcpCallArgumentsDeltaEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseMcpCallArgumentsDeltaEvent.agent())
+            .contains(
+                BetaResponseMcpCallArgumentsDeltaEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseMcpCallArgumentsDeltaEvent =
+            BetaResponseMcpCallArgumentsDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallArgumentsDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseMcpCallArgumentsDeltaEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseMcpCallArgumentsDeltaEvent),
+                jacksonTypeRef<BetaResponseMcpCallArgumentsDeltaEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseMcpCallArgumentsDeltaEvent)
+            .isEqualTo(betaResponseMcpCallArgumentsDeltaEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallArgumentsDoneEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallArgumentsDoneEventTest.kt
new file mode 100644
index 000000000..7e02eb3a7
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallArgumentsDoneEventTest.kt
@@ -0,0 +1,64 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseMcpCallArgumentsDoneEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseMcpCallArgumentsDoneEvent =
+            BetaResponseMcpCallArgumentsDoneEvent.builder()
+                .arguments("arguments")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallArgumentsDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseMcpCallArgumentsDoneEvent.arguments()).isEqualTo("arguments")
+        assertThat(betaResponseMcpCallArgumentsDoneEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseMcpCallArgumentsDoneEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseMcpCallArgumentsDoneEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseMcpCallArgumentsDoneEvent.agent())
+            .contains(
+                BetaResponseMcpCallArgumentsDoneEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseMcpCallArgumentsDoneEvent =
+            BetaResponseMcpCallArgumentsDoneEvent.builder()
+                .arguments("arguments")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallArgumentsDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseMcpCallArgumentsDoneEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseMcpCallArgumentsDoneEvent),
+                jacksonTypeRef<BetaResponseMcpCallArgumentsDoneEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseMcpCallArgumentsDoneEvent)
+            .isEqualTo(betaResponseMcpCallArgumentsDoneEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallCompletedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallCompletedEventTest.kt
new file mode 100644
index 000000000..a1444a84d
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallCompletedEventTest.kt
@@ -0,0 +1,59 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseMcpCallCompletedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseMcpCallCompletedEvent =
+            BetaResponseMcpCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseMcpCallCompletedEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseMcpCallCompletedEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseMcpCallCompletedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseMcpCallCompletedEvent.agent())
+            .contains(
+                BetaResponseMcpCallCompletedEvent.Agent.builder().agentName("agent_name").build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseMcpCallCompletedEvent =
+            BetaResponseMcpCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseMcpCallCompletedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseMcpCallCompletedEvent),
+                jacksonTypeRef<BetaResponseMcpCallCompletedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseMcpCallCompletedEvent)
+            .isEqualTo(betaResponseMcpCallCompletedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallFailedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallFailedEventTest.kt
new file mode 100644
index 000000000..3aa4ab21e
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallFailedEventTest.kt
@@ -0,0 +1,55 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseMcpCallFailedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseMcpCallFailedEvent =
+            BetaResponseMcpCallFailedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallFailedEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        assertThat(betaResponseMcpCallFailedEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseMcpCallFailedEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseMcpCallFailedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseMcpCallFailedEvent.agent())
+            .contains(
+                BetaResponseMcpCallFailedEvent.Agent.builder().agentName("agent_name").build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseMcpCallFailedEvent =
+            BetaResponseMcpCallFailedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallFailedEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseMcpCallFailedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseMcpCallFailedEvent),
+                jacksonTypeRef<BetaResponseMcpCallFailedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseMcpCallFailedEvent)
+            .isEqualTo(betaResponseMcpCallFailedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallInProgressEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallInProgressEventTest.kt
new file mode 100644
index 000000000..4acb6b6b2
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpCallInProgressEventTest.kt
@@ -0,0 +1,59 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseMcpCallInProgressEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseMcpCallInProgressEvent =
+            BetaResponseMcpCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseMcpCallInProgressEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseMcpCallInProgressEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseMcpCallInProgressEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseMcpCallInProgressEvent.agent())
+            .contains(
+                BetaResponseMcpCallInProgressEvent.Agent.builder().agentName("agent_name").build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseMcpCallInProgressEvent =
+            BetaResponseMcpCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseMcpCallInProgressEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseMcpCallInProgressEvent),
+                jacksonTypeRef<BetaResponseMcpCallInProgressEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseMcpCallInProgressEvent)
+            .isEqualTo(betaResponseMcpCallInProgressEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsCompletedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsCompletedEventTest.kt
new file mode 100644
index 000000000..d15f77e1b
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsCompletedEventTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseMcpListToolsCompletedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseMcpListToolsCompletedEvent =
+            BetaResponseMcpListToolsCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpListToolsCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseMcpListToolsCompletedEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseMcpListToolsCompletedEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseMcpListToolsCompletedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseMcpListToolsCompletedEvent.agent())
+            .contains(
+                BetaResponseMcpListToolsCompletedEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseMcpListToolsCompletedEvent =
+            BetaResponseMcpListToolsCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpListToolsCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseMcpListToolsCompletedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseMcpListToolsCompletedEvent),
+                jacksonTypeRef<BetaResponseMcpListToolsCompletedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseMcpListToolsCompletedEvent)
+            .isEqualTo(betaResponseMcpListToolsCompletedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsFailedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsFailedEventTest.kt
new file mode 100644
index 000000000..cec83d7c5
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsFailedEventTest.kt
@@ -0,0 +1,59 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseMcpListToolsFailedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseMcpListToolsFailedEvent =
+            BetaResponseMcpListToolsFailedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpListToolsFailedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseMcpListToolsFailedEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseMcpListToolsFailedEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseMcpListToolsFailedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseMcpListToolsFailedEvent.agent())
+            .contains(
+                BetaResponseMcpListToolsFailedEvent.Agent.builder().agentName("agent_name").build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseMcpListToolsFailedEvent =
+            BetaResponseMcpListToolsFailedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpListToolsFailedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseMcpListToolsFailedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseMcpListToolsFailedEvent),
+                jacksonTypeRef<BetaResponseMcpListToolsFailedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseMcpListToolsFailedEvent)
+            .isEqualTo(betaResponseMcpListToolsFailedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsInProgressEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsInProgressEventTest.kt
new file mode 100644
index 000000000..9002e0a46
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseMcpListToolsInProgressEventTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseMcpListToolsInProgressEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseMcpListToolsInProgressEvent =
+            BetaResponseMcpListToolsInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpListToolsInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseMcpListToolsInProgressEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseMcpListToolsInProgressEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseMcpListToolsInProgressEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseMcpListToolsInProgressEvent.agent())
+            .contains(
+                BetaResponseMcpListToolsInProgressEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseMcpListToolsInProgressEvent =
+            BetaResponseMcpListToolsInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpListToolsInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseMcpListToolsInProgressEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseMcpListToolsInProgressEvent),
+                jacksonTypeRef<BetaResponseMcpListToolsInProgressEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseMcpListToolsInProgressEvent)
+            .isEqualTo(betaResponseMcpListToolsInProgressEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputAudioTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputAudioTest.kt
new file mode 100644
index 000000000..4c943272a
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputAudioTest.kt
@@ -0,0 +1,35 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseOutputAudioTest {
+
+    @Test
+    fun create() {
+        val betaResponseOutputAudio =
+            BetaResponseOutputAudio.builder().data("data").transcript("transcript").build()
+
+        assertThat(betaResponseOutputAudio.data()).isEqualTo("data")
+        assertThat(betaResponseOutputAudio.transcript()).isEqualTo("transcript")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputAudio =
+            BetaResponseOutputAudio.builder().data("data").transcript("transcript").build()
+
+        val roundtrippedBetaResponseOutputAudio =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputAudio),
+                jacksonTypeRef<BetaResponseOutputAudio>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputAudio).isEqualTo(betaResponseOutputAudio)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemAddedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemAddedEventTest.kt
new file mode 100644
index 000000000..ed7715961
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemAddedEventTest.kt
@@ -0,0 +1,169 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseOutputItemAddedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseOutputItemAddedEvent =
+            BetaResponseOutputItemAddedEvent.builder()
+                .item(
+                    BetaResponseOutputMessage.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseOutputText.builder()
+                                .addAnnotation(
+                                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                                        .fileId("file_id")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                                .text("text")
+                                .addLogprob(
+                                    BetaResponseOutputText.Logprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .addTopLogprob(
+                                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                        .agent(
+                            BetaResponseOutputMessage.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                        .build()
+                )
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseOutputItemAddedEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        assertThat(betaResponseOutputItemAddedEvent.item())
+            .isEqualTo(
+                BetaResponseOutputItem.ofMessage(
+                    BetaResponseOutputMessage.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseOutputText.builder()
+                                .addAnnotation(
+                                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                                        .fileId("file_id")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                                .text("text")
+                                .addLogprob(
+                                    BetaResponseOutputText.Logprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .addTopLogprob(
+                                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                        .agent(
+                            BetaResponseOutputMessage.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                        .build()
+                )
+            )
+        assertThat(betaResponseOutputItemAddedEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseOutputItemAddedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseOutputItemAddedEvent.agent())
+            .contains(
+                BetaResponseOutputItemAddedEvent.Agent.builder().agentName("agent_name").build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItemAddedEvent =
+            BetaResponseOutputItemAddedEvent.builder()
+                .item(
+                    BetaResponseOutputMessage.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseOutputText.builder()
+                                .addAnnotation(
+                                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                                        .fileId("file_id")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                                .text("text")
+                                .addLogprob(
+                                    BetaResponseOutputText.Logprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .addTopLogprob(
+                                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                        .agent(
+                            BetaResponseOutputMessage.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                        .build()
+                )
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseOutputItemAddedEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseOutputItemAddedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItemAddedEvent),
+                jacksonTypeRef<BetaResponseOutputItemAddedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItemAddedEvent)
+            .isEqualTo(betaResponseOutputItemAddedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemDoneEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemDoneEventTest.kt
new file mode 100644
index 000000000..a5c235d2c
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemDoneEventTest.kt
@@ -0,0 +1,169 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseOutputItemDoneEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseOutputItemDoneEvent =
+            BetaResponseOutputItemDoneEvent.builder()
+                .item(
+                    BetaResponseOutputMessage.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseOutputText.builder()
+                                .addAnnotation(
+                                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                                        .fileId("file_id")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                                .text("text")
+                                .addLogprob(
+                                    BetaResponseOutputText.Logprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .addTopLogprob(
+                                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                        .agent(
+                            BetaResponseOutputMessage.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                        .build()
+                )
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseOutputItemDoneEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        assertThat(betaResponseOutputItemDoneEvent.item())
+            .isEqualTo(
+                BetaResponseOutputItem.ofMessage(
+                    BetaResponseOutputMessage.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseOutputText.builder()
+                                .addAnnotation(
+                                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                                        .fileId("file_id")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                                .text("text")
+                                .addLogprob(
+                                    BetaResponseOutputText.Logprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .addTopLogprob(
+                                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                        .agent(
+                            BetaResponseOutputMessage.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                        .build()
+                )
+            )
+        assertThat(betaResponseOutputItemDoneEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseOutputItemDoneEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseOutputItemDoneEvent.agent())
+            .contains(
+                BetaResponseOutputItemDoneEvent.Agent.builder().agentName("agent_name").build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItemDoneEvent =
+            BetaResponseOutputItemDoneEvent.builder()
+                .item(
+                    BetaResponseOutputMessage.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseOutputText.builder()
+                                .addAnnotation(
+                                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                                        .fileId("file_id")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                                .text("text")
+                                .addLogprob(
+                                    BetaResponseOutputText.Logprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .addTopLogprob(
+                                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                        .agent(
+                            BetaResponseOutputMessage.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                        .build()
+                )
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseOutputItemDoneEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseOutputItemDoneEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItemDoneEvent),
+                jacksonTypeRef<BetaResponseOutputItemDoneEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItemDoneEvent)
+            .isEqualTo(betaResponseOutputItemDoneEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemTest.kt
new file mode 100644
index 000000000..283a29b60
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputItemTest.kt
@@ -0,0 +1,2796 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import com.openai.errors.OpenAIInvalidDataException
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.assertThrows
+import org.junit.jupiter.params.ParameterizedTest
+import org.junit.jupiter.params.provider.EnumSource
+
+internal class BetaResponseOutputItemTest {
+
+    @Test
+    fun ofMessage() {
+        val message =
+            BetaResponseOutputMessage.builder()
+                .id("id")
+                .addContent(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                .agent(BetaResponseOutputMessage.Agent.builder().agentName("agent_name").build())
+                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofMessage(message)
+
+        assertThat(betaResponseOutputItem.message()).contains(message)
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMessageRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofMessage(
+                BetaResponseOutputMessage.builder()
+                    .id("id")
+                    .addContent(
+                        BetaResponseOutputText.builder()
+                            .addAnnotation(
+                                BetaResponseOutputText.Annotation.FileCitation.builder()
+                                    .fileId("file_id")
+                                    .filename("filename")
+                                    .index(0L)
+                                    .build()
+                            )
+                            .text("text")
+                            .addLogprob(
+                                BetaResponseOutputText.Logprob.builder()
+                                    .token("token")
+                                    .addByte(0L)
+                                    .logprob(0.0)
+                                    .addTopLogprob(
+                                        BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseOutputMessage.Agent.builder().agentName("agent_name").build()
+                    )
+                    .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofFileSearchCall() {
+        val fileSearchCall =
+            BetaResponseFileSearchToolCall.builder()
+                .id("id")
+                .addQuery("string")
+                .status(BetaResponseFileSearchToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFileSearchToolCall.Agent.builder().agentName("agent_name").build()
+                )
+                .addResult(
+                    BetaResponseFileSearchToolCall.Result.builder()
+                        .attributes(
+                            BetaResponseFileSearchToolCall.Result.Attributes.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .fileId("file_id")
+                        .filename("filename")
+                        .score(0.0f)
+                        .text("text")
+                        .build()
+                )
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofFileSearchCall(fileSearchCall)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).contains(fileSearchCall)
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofFileSearchCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofFileSearchCall(
+                BetaResponseFileSearchToolCall.builder()
+                    .id("id")
+                    .addQuery("string")
+                    .status(BetaResponseFileSearchToolCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseFileSearchToolCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .addResult(
+                        BetaResponseFileSearchToolCall.Result.builder()
+                            .attributes(
+                                BetaResponseFileSearchToolCall.Result.Attributes.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .fileId("file_id")
+                            .filename("filename")
+                            .score(0.0f)
+                            .text("text")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofFunctionCall() {
+        val functionCall =
+            BetaResponseFunctionToolCall.builder()
+                .arguments("arguments")
+                .callId("call_id")
+                .name("name")
+                .id("id")
+                .agent(BetaResponseFunctionToolCall.Agent.builder().agentName("agent_name").build())
+                .callerDirect()
+                .namespace("namespace")
+                .status(BetaResponseFunctionToolCall.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofFunctionCall(functionCall)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).contains(functionCall)
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofFunctionCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofFunctionCall(
+                BetaResponseFunctionToolCall.builder()
+                    .arguments("arguments")
+                    .callId("call_id")
+                    .name("name")
+                    .id("id")
+                    .agent(
+                        BetaResponseFunctionToolCall.Agent.builder().agentName("agent_name").build()
+                    )
+                    .callerDirect()
+                    .namespace("namespace")
+                    .status(BetaResponseFunctionToolCall.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofFunctionCallOutput() {
+        val functionCallOutput =
+            BetaResponseFunctionToolCallOutputItem.builder()
+                .id("id")
+                .callId("call_id")
+                .output("string")
+                .status(BetaResponseFunctionToolCallOutputItem.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionToolCallOutputItem.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofFunctionCallOutput(functionCallOutput)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).contains(functionCallOutput)
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofFunctionCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofFunctionCallOutput(
+                BetaResponseFunctionToolCallOutputItem.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .output("string")
+                    .status(BetaResponseFunctionToolCallOutputItem.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseFunctionToolCallOutputItem.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofAgentMessage() {
+        val agentMessage =
+            BetaResponseOutputItem.AgentMessage.builder()
+                .id("id")
+                .author("author")
+                .addContent(
+                    BetaResponseInputText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
+                .recipient("recipient")
+                .agent(
+                    BetaResponseOutputItem.AgentMessage.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofAgentMessage(agentMessage)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).contains(agentMessage)
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofAgentMessageRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofAgentMessage(
+                BetaResponseOutputItem.AgentMessage.builder()
+                    .id("id")
+                    .author("author")
+                    .addContent(
+                        BetaResponseInputText.builder()
+                            .text("text")
+                            .promptCacheBreakpoint(
+                                BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                            )
+                            .build()
+                    )
+                    .recipient("recipient")
+                    .agent(
+                        BetaResponseOutputItem.AgentMessage.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofMultiAgentCall() {
+        val multiAgentCall =
+            BetaResponseOutputItem.MultiAgentCall.builder()
+                .id("id")
+                .action(BetaResponseOutputItem.MultiAgentCall.Action.SPAWN_AGENT)
+                .arguments("arguments")
+                .callId("call_id")
+                .agent(
+                    BetaResponseOutputItem.MultiAgentCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofMultiAgentCall(multiAgentCall)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).contains(multiAgentCall)
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMultiAgentCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofMultiAgentCall(
+                BetaResponseOutputItem.MultiAgentCall.builder()
+                    .id("id")
+                    .action(BetaResponseOutputItem.MultiAgentCall.Action.SPAWN_AGENT)
+                    .arguments("arguments")
+                    .callId("call_id")
+                    .agent(
+                        BetaResponseOutputItem.MultiAgentCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofMultiAgentCallOutput() {
+        val multiAgentCallOutput =
+            BetaResponseOutputItem.MultiAgentCallOutput.builder()
+                .id("id")
+                .action(BetaResponseOutputItem.MultiAgentCallOutput.Action.SPAWN_AGENT)
+                .callId("call_id")
+                .addOutput(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .agent(
+                    BetaResponseOutputItem.MultiAgentCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofMultiAgentCallOutput(multiAgentCallOutput)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).contains(multiAgentCallOutput)
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMultiAgentCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofMultiAgentCallOutput(
+                BetaResponseOutputItem.MultiAgentCallOutput.builder()
+                    .id("id")
+                    .action(BetaResponseOutputItem.MultiAgentCallOutput.Action.SPAWN_AGENT)
+                    .callId("call_id")
+                    .addOutput(
+                        BetaResponseOutputText.builder()
+                            .addAnnotation(
+                                BetaResponseOutputText.Annotation.FileCitation.builder()
+                                    .fileId("file_id")
+                                    .filename("filename")
+                                    .index(0L)
+                                    .build()
+                            )
+                            .text("text")
+                            .addLogprob(
+                                BetaResponseOutputText.Logprob.builder()
+                                    .token("token")
+                                    .addByte(0L)
+                                    .logprob(0.0)
+                                    .addTopLogprob(
+                                        BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .agent(
+                        BetaResponseOutputItem.MultiAgentCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofWebSearchCall() {
+        val webSearchCall =
+            BetaResponseFunctionWebSearch.builder()
+                .id("id")
+                .action(
+                    BetaResponseFunctionWebSearch.Action.Search.builder()
+                        .addQuery("string")
+                        .query("query")
+                        .addSource(
+                            BetaResponseFunctionWebSearch.Action.Search.Source.builder()
+                                .url("https://example.com")
+                                .build()
+                        )
+                        .build()
+                )
+                .status(BetaResponseFunctionWebSearch.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionWebSearch.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofWebSearchCall(webSearchCall)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).contains(webSearchCall)
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofWebSearchCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofWebSearchCall(
+                BetaResponseFunctionWebSearch.builder()
+                    .id("id")
+                    .action(
+                        BetaResponseFunctionWebSearch.Action.Search.builder()
+                            .addQuery("string")
+                            .query("query")
+                            .addSource(
+                                BetaResponseFunctionWebSearch.Action.Search.Source.builder()
+                                    .url("https://example.com")
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .status(BetaResponseFunctionWebSearch.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseFunctionWebSearch.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofComputerCall() {
+        val computerCall =
+            BetaResponseComputerToolCall.builder()
+                .id("id")
+                .callId("call_id")
+                .addPendingSafetyCheck(
+                    BetaResponseComputerToolCall.PendingSafetyCheck.builder()
+                        .id("id")
+                        .code("code")
+                        .message("message")
+                        .build()
+                )
+                .status(BetaResponseComputerToolCall.Status.IN_PROGRESS)
+                .type(BetaResponseComputerToolCall.Type.COMPUTER_CALL)
+                .action(
+                    BetaComputerAction.Click.builder()
+                        .button(BetaComputerAction.Click.Button.LEFT)
+                        .x(0L)
+                        .y(0L)
+                        .addKey("string")
+                        .build()
+                )
+                .addAction(
+                    BetaComputerAction.Click.builder()
+                        .button(BetaComputerAction.Click.Button.LEFT)
+                        .x(0L)
+                        .y(0L)
+                        .addKey("string")
+                        .build()
+                )
+                .agent(BetaResponseComputerToolCall.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofComputerCall(computerCall)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).contains(computerCall)
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofComputerCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofComputerCall(
+                BetaResponseComputerToolCall.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .addPendingSafetyCheck(
+                        BetaResponseComputerToolCall.PendingSafetyCheck.builder()
+                            .id("id")
+                            .code("code")
+                            .message("message")
+                            .build()
+                    )
+                    .status(BetaResponseComputerToolCall.Status.IN_PROGRESS)
+                    .type(BetaResponseComputerToolCall.Type.COMPUTER_CALL)
+                    .action(
+                        BetaComputerAction.Click.builder()
+                            .button(BetaComputerAction.Click.Button.LEFT)
+                            .x(0L)
+                            .y(0L)
+                            .addKey("string")
+                            .build()
+                    )
+                    .addAction(
+                        BetaComputerAction.Click.builder()
+                            .button(BetaComputerAction.Click.Button.LEFT)
+                            .x(0L)
+                            .y(0L)
+                            .addKey("string")
+                            .build()
+                    )
+                    .agent(
+                        BetaResponseComputerToolCall.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofComputerCallOutput() {
+        val computerCallOutput =
+            BetaResponseComputerToolCallOutputItem.builder()
+                .id("id")
+                .callId("call_id")
+                .output(
+                    BetaResponseComputerToolCallOutputScreenshot.builder()
+                        .fileId("file_id")
+                        .imageUrl("https://example.com")
+                        .build()
+                )
+                .status(BetaResponseComputerToolCallOutputItem.Status.COMPLETED)
+                .addAcknowledgedSafetyCheck(
+                    BetaResponseComputerToolCallOutputItem.AcknowledgedSafetyCheck.builder()
+                        .id("id")
+                        .code("code")
+                        .message("message")
+                        .build()
+                )
+                .agent(
+                    BetaResponseComputerToolCallOutputItem.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofComputerCallOutput(computerCallOutput)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).contains(computerCallOutput)
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofComputerCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofComputerCallOutput(
+                BetaResponseComputerToolCallOutputItem.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .output(
+                        BetaResponseComputerToolCallOutputScreenshot.builder()
+                            .fileId("file_id")
+                            .imageUrl("https://example.com")
+                            .build()
+                    )
+                    .status(BetaResponseComputerToolCallOutputItem.Status.COMPLETED)
+                    .addAcknowledgedSafetyCheck(
+                        BetaResponseComputerToolCallOutputItem.AcknowledgedSafetyCheck.builder()
+                            .id("id")
+                            .code("code")
+                            .message("message")
+                            .build()
+                    )
+                    .agent(
+                        BetaResponseComputerToolCallOutputItem.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofReasoning() {
+        val reasoning =
+            BetaResponseReasoningItem.builder()
+                .id("id")
+                .addSummary(BetaResponseReasoningItem.Summary.builder().text("text").build())
+                .agent(BetaResponseReasoningItem.Agent.builder().agentName("agent_name").build())
+                .addContent(BetaResponseReasoningItem.Content.builder().text("text").build())
+                .encryptedContent("encrypted_content")
+                .status(BetaResponseReasoningItem.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofReasoning(reasoning)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).contains(reasoning)
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofReasoningRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofReasoning(
+                BetaResponseReasoningItem.builder()
+                    .id("id")
+                    .addSummary(BetaResponseReasoningItem.Summary.builder().text("text").build())
+                    .agent(
+                        BetaResponseReasoningItem.Agent.builder().agentName("agent_name").build()
+                    )
+                    .addContent(BetaResponseReasoningItem.Content.builder().text("text").build())
+                    .encryptedContent("encrypted_content")
+                    .status(BetaResponseReasoningItem.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofProgram() {
+        val program =
+            BetaResponseOutputItem.Program.builder()
+                .id("id")
+                .callId("call_id")
+                .code("code")
+                .fingerprint("fingerprint")
+                .agent(
+                    BetaResponseOutputItem.Program.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofProgram(program)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).contains(program)
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofProgramRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofProgram(
+                BetaResponseOutputItem.Program.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .code("code")
+                    .fingerprint("fingerprint")
+                    .agent(
+                        BetaResponseOutputItem.Program.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofProgramOutput() {
+        val programOutput =
+            BetaResponseOutputItem.ProgramOutput.builder()
+                .id("id")
+                .callId("call_id")
+                .result("result")
+                .status(BetaResponseOutputItem.ProgramOutput.Status.COMPLETED)
+                .agent(
+                    BetaResponseOutputItem.ProgramOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofProgramOutput(programOutput)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).contains(programOutput)
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofProgramOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofProgramOutput(
+                BetaResponseOutputItem.ProgramOutput.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .result("result")
+                    .status(BetaResponseOutputItem.ProgramOutput.Status.COMPLETED)
+                    .agent(
+                        BetaResponseOutputItem.ProgramOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofToolSearchCall() {
+        val toolSearchCall =
+            BetaResponseToolSearchCall.builder()
+                .id("id")
+                .arguments(JsonValue.from(mapOf<String, Any>()))
+                .callId("call_id")
+                .execution(BetaResponseToolSearchCall.Execution.SERVER)
+                .status(BetaResponseToolSearchCall.Status.IN_PROGRESS)
+                .agent(BetaResponseToolSearchCall.Agent.builder().agentName("agent_name").build())
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofToolSearchCall(toolSearchCall)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).contains(toolSearchCall)
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofToolSearchCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofToolSearchCall(
+                BetaResponseToolSearchCall.builder()
+                    .id("id")
+                    .arguments(JsonValue.from(mapOf<String, Any>()))
+                    .callId("call_id")
+                    .execution(BetaResponseToolSearchCall.Execution.SERVER)
+                    .status(BetaResponseToolSearchCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseToolSearchCall.Agent.builder().agentName("agent_name").build()
+                    )
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofToolSearchOutput() {
+        val toolSearchOutput =
+            BetaResponseToolSearchOutputItem.builder()
+                .id("id")
+                .callId("call_id")
+                .execution(BetaResponseToolSearchOutputItem.Execution.SERVER)
+                .status(BetaResponseToolSearchOutputItem.Status.IN_PROGRESS)
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .agent(
+                    BetaResponseToolSearchOutputItem.Agent.builder().agentName("agent_name").build()
+                )
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofToolSearchOutput(toolSearchOutput)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).contains(toolSearchOutput)
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofToolSearchOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofToolSearchOutput(
+                BetaResponseToolSearchOutputItem.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .execution(BetaResponseToolSearchOutputItem.Execution.SERVER)
+                    .status(BetaResponseToolSearchOutputItem.Status.IN_PROGRESS)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .agent(
+                        BetaResponseToolSearchOutputItem.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofAdditionalTools() {
+        val additionalTools =
+            BetaResponseOutputItem.AdditionalTools.builder()
+                .id("id")
+                .role(BetaResponseOutputItem.AdditionalTools.Role.UNKNOWN)
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .agent(
+                    BetaResponseOutputItem.AdditionalTools.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofAdditionalTools(additionalTools)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).contains(additionalTools)
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofAdditionalToolsRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofAdditionalTools(
+                BetaResponseOutputItem.AdditionalTools.builder()
+                    .id("id")
+                    .role(BetaResponseOutputItem.AdditionalTools.Role.UNKNOWN)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .agent(
+                        BetaResponseOutputItem.AdditionalTools.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofCompaction() {
+        val compaction =
+            BetaResponseCompactionItem.builder()
+                .id("id")
+                .encryptedContent("encrypted_content")
+                .agent(BetaResponseCompactionItem.Agent.builder().agentName("agent_name").build())
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofCompaction(compaction)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).contains(compaction)
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofCompactionRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofCompaction(
+                BetaResponseCompactionItem.builder()
+                    .id("id")
+                    .encryptedContent("encrypted_content")
+                    .agent(
+                        BetaResponseCompactionItem.Agent.builder().agentName("agent_name").build()
+                    )
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofImageGenerationCall() {
+        val imageGenerationCall =
+            BetaResponseOutputItem.ImageGenerationCall.builder()
+                .id("id")
+                .result("result")
+                .status(BetaResponseOutputItem.ImageGenerationCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseOutputItem.ImageGenerationCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofImageGenerationCall(imageGenerationCall)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).contains(imageGenerationCall)
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofImageGenerationCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofImageGenerationCall(
+                BetaResponseOutputItem.ImageGenerationCall.builder()
+                    .id("id")
+                    .result("result")
+                    .status(BetaResponseOutputItem.ImageGenerationCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseOutputItem.ImageGenerationCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofCodeInterpreterCall() {
+        val codeInterpreterCall =
+            BetaResponseCodeInterpreterToolCall.builder()
+                .id("id")
+                .code("code")
+                .containerId("container_id")
+                .addLogsOutput("logs")
+                .status(BetaResponseCodeInterpreterToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseCodeInterpreterToolCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofCodeInterpreterCall(codeInterpreterCall)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).contains(codeInterpreterCall)
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofCodeInterpreterCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofCodeInterpreterCall(
+                BetaResponseCodeInterpreterToolCall.builder()
+                    .id("id")
+                    .code("code")
+                    .containerId("container_id")
+                    .addLogsOutput("logs")
+                    .status(BetaResponseCodeInterpreterToolCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseCodeInterpreterToolCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofLocalShellCall() {
+        val localShellCall =
+            BetaResponseOutputItem.LocalShellCall.builder()
+                .id("id")
+                .action(
+                    BetaResponseOutputItem.LocalShellCall.Action.builder()
+                        .addCommand("string")
+                        .env(
+                            BetaResponseOutputItem.LocalShellCall.Action.Env.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .timeoutMs(0L)
+                        .user("user")
+                        .workingDirectory("working_directory")
+                        .build()
+                )
+                .callId("call_id")
+                .status(BetaResponseOutputItem.LocalShellCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseOutputItem.LocalShellCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofLocalShellCall(localShellCall)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).contains(localShellCall)
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofLocalShellCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofLocalShellCall(
+                BetaResponseOutputItem.LocalShellCall.builder()
+                    .id("id")
+                    .action(
+                        BetaResponseOutputItem.LocalShellCall.Action.builder()
+                            .addCommand("string")
+                            .env(
+                                BetaResponseOutputItem.LocalShellCall.Action.Env.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .timeoutMs(0L)
+                            .user("user")
+                            .workingDirectory("working_directory")
+                            .build()
+                    )
+                    .callId("call_id")
+                    .status(BetaResponseOutputItem.LocalShellCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseOutputItem.LocalShellCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofLocalShellCallOutput() {
+        val localShellCallOutput =
+            BetaResponseOutputItem.LocalShellCallOutput.builder()
+                .id("id")
+                .output("output")
+                .agent(
+                    BetaResponseOutputItem.LocalShellCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .status(BetaResponseOutputItem.LocalShellCallOutput.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofLocalShellCallOutput(localShellCallOutput)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).contains(localShellCallOutput)
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofLocalShellCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofLocalShellCallOutput(
+                BetaResponseOutputItem.LocalShellCallOutput.builder()
+                    .id("id")
+                    .output("output")
+                    .agent(
+                        BetaResponseOutputItem.LocalShellCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .status(BetaResponseOutputItem.LocalShellCallOutput.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofShellCall() {
+        val shellCall =
+            BetaResponseFunctionShellToolCall.builder()
+                .id("id")
+                .action(
+                    BetaResponseFunctionShellToolCall.Action.builder()
+                        .addCommand("string")
+                        .maxOutputLength(0L)
+                        .timeoutMs(0L)
+                        .build()
+                )
+                .callId("call_id")
+                .environment(BetaResponseLocalEnvironment.builder().build())
+                .status(BetaResponseFunctionShellToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionShellToolCall.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofShellCall(shellCall)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).contains(shellCall)
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofShellCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofShellCall(
+                BetaResponseFunctionShellToolCall.builder()
+                    .id("id")
+                    .action(
+                        BetaResponseFunctionShellToolCall.Action.builder()
+                            .addCommand("string")
+                            .maxOutputLength(0L)
+                            .timeoutMs(0L)
+                            .build()
+                    )
+                    .callId("call_id")
+                    .environment(BetaResponseLocalEnvironment.builder().build())
+                    .status(BetaResponseFunctionShellToolCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseFunctionShellToolCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofShellCallOutput() {
+        val shellCallOutput =
+            BetaResponseFunctionShellToolCallOutput.builder()
+                .id("id")
+                .callId("call_id")
+                .maxOutputLength(0L)
+                .addOutput(
+                    BetaResponseFunctionShellToolCallOutput.Output.builder()
+                        .outcomeTimeout()
+                        .stderr("stderr")
+                        .stdout("stdout")
+                        .createdBy("created_by")
+                        .build()
+                )
+                .status(BetaResponseFunctionShellToolCallOutput.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseFunctionShellToolCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofShellCallOutput(shellCallOutput)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).contains(shellCallOutput)
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofShellCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofShellCallOutput(
+                BetaResponseFunctionShellToolCallOutput.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .maxOutputLength(0L)
+                    .addOutput(
+                        BetaResponseFunctionShellToolCallOutput.Output.builder()
+                            .outcomeTimeout()
+                            .stderr("stderr")
+                            .stdout("stdout")
+                            .createdBy("created_by")
+                            .build()
+                    )
+                    .status(BetaResponseFunctionShellToolCallOutput.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseFunctionShellToolCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofApplyPatchCall() {
+        val applyPatchCall =
+            BetaResponseApplyPatchToolCall.builder()
+                .id("id")
+                .callId("call_id")
+                .operation(
+                    BetaResponseApplyPatchToolCall.Operation.CreateFile.builder()
+                        .diff("diff")
+                        .path("path")
+                        .build()
+                )
+                .status(BetaResponseApplyPatchToolCall.Status.IN_PROGRESS)
+                .agent(
+                    BetaResponseApplyPatchToolCall.Agent.builder().agentName("agent_name").build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofApplyPatchCall(applyPatchCall)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).contains(applyPatchCall)
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofApplyPatchCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofApplyPatchCall(
+                BetaResponseApplyPatchToolCall.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .operation(
+                        BetaResponseApplyPatchToolCall.Operation.CreateFile.builder()
+                            .diff("diff")
+                            .path("path")
+                            .build()
+                    )
+                    .status(BetaResponseApplyPatchToolCall.Status.IN_PROGRESS)
+                    .agent(
+                        BetaResponseApplyPatchToolCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofApplyPatchCallOutput() {
+        val applyPatchCallOutput =
+            BetaResponseApplyPatchToolCallOutput.builder()
+                .id("id")
+                .callId("call_id")
+                .status(BetaResponseApplyPatchToolCallOutput.Status.COMPLETED)
+                .agent(
+                    BetaResponseApplyPatchToolCallOutput.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callerDirect()
+                .createdBy("created_by")
+                .output("output")
+                .build()
+
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofApplyPatchCallOutput(applyPatchCallOutput)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).contains(applyPatchCallOutput)
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofApplyPatchCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofApplyPatchCallOutput(
+                BetaResponseApplyPatchToolCallOutput.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .status(BetaResponseApplyPatchToolCallOutput.Status.COMPLETED)
+                    .agent(
+                        BetaResponseApplyPatchToolCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .createdBy("created_by")
+                    .output("output")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofMcpCall() {
+        val mcpCall =
+            BetaResponseOutputItem.McpCall.builder()
+                .id("id")
+                .arguments("arguments")
+                .name("name")
+                .serverLabel("server_label")
+                .agent(
+                    BetaResponseOutputItem.McpCall.Agent.builder().agentName("agent_name").build()
+                )
+                .approvalRequestId("approval_request_id")
+                .error("error")
+                .output("output")
+                .status(BetaResponseOutputItem.McpCall.Status.IN_PROGRESS)
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofMcpCall(mcpCall)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).contains(mcpCall)
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMcpCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofMcpCall(
+                BetaResponseOutputItem.McpCall.builder()
+                    .id("id")
+                    .arguments("arguments")
+                    .name("name")
+                    .serverLabel("server_label")
+                    .agent(
+                        BetaResponseOutputItem.McpCall.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .approvalRequestId("approval_request_id")
+                    .error("error")
+                    .output("output")
+                    .status(BetaResponseOutputItem.McpCall.Status.IN_PROGRESS)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofMcpListTools() {
+        val mcpListTools =
+            BetaResponseOutputItem.McpListTools.builder()
+                .id("id")
+                .serverLabel("server_label")
+                .addTool(
+                    BetaResponseOutputItem.McpListTools.Tool.builder()
+                        .inputSchema(JsonValue.from(mapOf<String, Any>()))
+                        .name("name")
+                        .annotations(JsonValue.from(mapOf<String, Any>()))
+                        .description("description")
+                        .build()
+                )
+                .agent(
+                    BetaResponseOutputItem.McpListTools.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .error("error")
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofMcpListTools(mcpListTools)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).contains(mcpListTools)
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMcpListToolsRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofMcpListTools(
+                BetaResponseOutputItem.McpListTools.builder()
+                    .id("id")
+                    .serverLabel("server_label")
+                    .addTool(
+                        BetaResponseOutputItem.McpListTools.Tool.builder()
+                            .inputSchema(JsonValue.from(mapOf<String, Any>()))
+                            .name("name")
+                            .annotations(JsonValue.from(mapOf<String, Any>()))
+                            .description("description")
+                            .build()
+                    )
+                    .agent(
+                        BetaResponseOutputItem.McpListTools.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .error("error")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofMcpApprovalRequest() {
+        val mcpApprovalRequest =
+            BetaResponseOutputItem.McpApprovalRequest.builder()
+                .id("id")
+                .arguments("arguments")
+                .name("name")
+                .serverLabel("server_label")
+                .agent(
+                    BetaResponseOutputItem.McpApprovalRequest.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofMcpApprovalRequest(mcpApprovalRequest)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).contains(mcpApprovalRequest)
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMcpApprovalRequestRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofMcpApprovalRequest(
+                BetaResponseOutputItem.McpApprovalRequest.builder()
+                    .id("id")
+                    .arguments("arguments")
+                    .name("name")
+                    .serverLabel("server_label")
+                    .agent(
+                        BetaResponseOutputItem.McpApprovalRequest.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofMcpApprovalResponse() {
+        val mcpApprovalResponse =
+            BetaResponseOutputItem.McpApprovalResponse.builder()
+                .id("id")
+                .approvalRequestId("approval_request_id")
+                .approve(true)
+                .agent(
+                    BetaResponseOutputItem.McpApprovalResponse.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .reason("reason")
+                .build()
+
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofMcpApprovalResponse(mcpApprovalResponse)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).contains(mcpApprovalResponse)
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofMcpApprovalResponseRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofMcpApprovalResponse(
+                BetaResponseOutputItem.McpApprovalResponse.builder()
+                    .id("id")
+                    .approvalRequestId("approval_request_id")
+                    .approve(true)
+                    .agent(
+                        BetaResponseOutputItem.McpApprovalResponse.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .reason("reason")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofCustomToolCall() {
+        val customToolCall =
+            BetaResponseCustomToolCall.builder()
+                .callId("call_id")
+                .input("input")
+                .name("name")
+                .id("id")
+                .agent(BetaResponseCustomToolCall.Agent.builder().agentName("agent_name").build())
+                .callerDirect()
+                .namespace("namespace")
+                .build()
+
+        val betaResponseOutputItem = BetaResponseOutputItem.ofCustomToolCall(customToolCall)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).contains(customToolCall)
+        assertThat(betaResponseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofCustomToolCallRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofCustomToolCall(
+                BetaResponseCustomToolCall.builder()
+                    .callId("call_id")
+                    .input("input")
+                    .name("name")
+                    .id("id")
+                    .agent(
+                        BetaResponseCustomToolCall.Agent.builder().agentName("agent_name").build()
+                    )
+                    .callerDirect()
+                    .namespace("namespace")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    @Test
+    fun ofCustomToolCallOutput() {
+        val customToolCallOutput =
+            BetaResponseCustomToolCallOutputItem.builder()
+                .callId("call_id")
+                .output("string")
+                .id("id")
+                .agent(
+                    BetaResponseCustomToolCallOutput.Agent.builder().agentName("agent_name").build()
+                )
+                .callerDirect()
+                .status(BetaResponseCustomToolCallOutputItem.Status.IN_PROGRESS)
+                .createdBy("created_by")
+                .build()
+
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofCustomToolCallOutput(customToolCallOutput)
+
+        assertThat(betaResponseOutputItem.message()).isEmpty
+        assertThat(betaResponseOutputItem.fileSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCall()).isEmpty
+        assertThat(betaResponseOutputItem.functionCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.agentMessage()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCall()).isEmpty
+        assertThat(betaResponseOutputItem.multiAgentCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.webSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCall()).isEmpty
+        assertThat(betaResponseOutputItem.computerCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.reasoning()).isEmpty
+        assertThat(betaResponseOutputItem.program()).isEmpty
+        assertThat(betaResponseOutputItem.programOutput()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchCall()).isEmpty
+        assertThat(betaResponseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(betaResponseOutputItem.additionalTools()).isEmpty
+        assertThat(betaResponseOutputItem.compaction()).isEmpty
+        assertThat(betaResponseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(betaResponseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCall()).isEmpty
+        assertThat(betaResponseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.shellCall()).isEmpty
+        assertThat(betaResponseOutputItem.shellCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCall()).isEmpty
+        assertThat(betaResponseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(betaResponseOutputItem.mcpCall()).isEmpty
+        assertThat(betaResponseOutputItem.mcpListTools()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(betaResponseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCall()).isEmpty
+        assertThat(betaResponseOutputItem.customToolCallOutput()).contains(customToolCallOutput)
+    }
+
+    @Test
+    fun ofCustomToolCallOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputItem =
+            BetaResponseOutputItem.ofCustomToolCallOutput(
+                BetaResponseCustomToolCallOutputItem.builder()
+                    .callId("call_id")
+                    .output("string")
+                    .id("id")
+                    .agent(
+                        BetaResponseCustomToolCallOutput.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .callerDirect()
+                    .status(BetaResponseCustomToolCallOutputItem.Status.IN_PROGRESS)
+                    .createdBy("created_by")
+                    .build()
+            )
+
+        val roundtrippedBetaResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputItem),
+                jacksonTypeRef<BetaResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputItem).isEqualTo(betaResponseOutputItem)
+    }
+
+    enum class IncompatibleJsonShapeTestCase(val value: JsonValue) {
+        BOOLEAN(JsonValue.from(false)),
+        STRING(JsonValue.from("invalid")),
+        INTEGER(JsonValue.from(-1)),
+        FLOAT(JsonValue.from(3.14)),
+        ARRAY(JsonValue.from(listOf("invalid", "array"))),
+    }
+
+    @ParameterizedTest
+    @EnumSource
+    fun incompatibleJsonShapeDeserializesToUnknown(testCase: IncompatibleJsonShapeTestCase) {
+        val betaResponseOutputItem =
+            jsonMapper().convertValue(testCase.value, jacksonTypeRef<BetaResponseOutputItem>())
+
+        val e = assertThrows<OpenAIInvalidDataException> { betaResponseOutputItem.validate() }
+        assertThat(e).hasMessageStartingWith("Unknown ")
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputMessageTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputMessageTest.kt
new file mode 100644
index 000000000..ff2ba6a88
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputMessageTest.kt
@@ -0,0 +1,131 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseOutputMessageTest {
+
+    @Test
+    fun create() {
+        val betaResponseOutputMessage =
+            BetaResponseOutputMessage.builder()
+                .id("id")
+                .addContent(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                .agent(BetaResponseOutputMessage.Agent.builder().agentName("agent_name").build())
+                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                .build()
+
+        assertThat(betaResponseOutputMessage.id()).isEqualTo("id")
+        assertThat(betaResponseOutputMessage.content())
+            .containsExactly(
+                BetaResponseOutputMessage.Content.ofOutputText(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+            )
+        assertThat(betaResponseOutputMessage.status())
+            .isEqualTo(BetaResponseOutputMessage.Status.IN_PROGRESS)
+        assertThat(betaResponseOutputMessage.agent())
+            .contains(BetaResponseOutputMessage.Agent.builder().agentName("agent_name").build())
+        assertThat(betaResponseOutputMessage.phase())
+            .contains(BetaResponseOutputMessage.Phase.COMMENTARY)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputMessage =
+            BetaResponseOutputMessage.builder()
+                .id("id")
+                .addContent(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                .agent(BetaResponseOutputMessage.Agent.builder().agentName("agent_name").build())
+                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                .build()
+
+        val roundtrippedBetaResponseOutputMessage =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputMessage),
+                jacksonTypeRef<BetaResponseOutputMessage>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputMessage).isEqualTo(betaResponseOutputMessage)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputRefusalTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputRefusalTest.kt
new file mode 100644
index 000000000..e4a885e15
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputRefusalTest.kt
@@ -0,0 +1,34 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseOutputRefusalTest {
+
+    @Test
+    fun create() {
+        val betaResponseOutputRefusal =
+            BetaResponseOutputRefusal.builder().refusal("refusal").build()
+
+        assertThat(betaResponseOutputRefusal.refusal()).isEqualTo("refusal")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputRefusal =
+            BetaResponseOutputRefusal.builder().refusal("refusal").build()
+
+        val roundtrippedBetaResponseOutputRefusal =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputRefusal),
+                jacksonTypeRef<BetaResponseOutputRefusal>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputRefusal).isEqualTo(betaResponseOutputRefusal)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputTextAnnotationAddedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputTextAnnotationAddedEventTest.kt
new file mode 100644
index 000000000..afec36cbc
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputTextAnnotationAddedEventTest.kt
@@ -0,0 +1,72 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseOutputTextAnnotationAddedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseOutputTextAnnotationAddedEvent =
+            BetaResponseOutputTextAnnotationAddedEvent.builder()
+                .annotation(JsonValue.from(mapOf<String, Any>()))
+                .annotationIndex(0L)
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseOutputTextAnnotationAddedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseOutputTextAnnotationAddedEvent._annotation())
+            .isEqualTo(JsonValue.from(mapOf<String, Any>()))
+        assertThat(betaResponseOutputTextAnnotationAddedEvent.annotationIndex()).isEqualTo(0L)
+        assertThat(betaResponseOutputTextAnnotationAddedEvent.contentIndex()).isEqualTo(0L)
+        assertThat(betaResponseOutputTextAnnotationAddedEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseOutputTextAnnotationAddedEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseOutputTextAnnotationAddedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseOutputTextAnnotationAddedEvent.agent())
+            .contains(
+                BetaResponseOutputTextAnnotationAddedEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputTextAnnotationAddedEvent =
+            BetaResponseOutputTextAnnotationAddedEvent.builder()
+                .annotation(JsonValue.from(mapOf<String, Any>()))
+                .annotationIndex(0L)
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseOutputTextAnnotationAddedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseOutputTextAnnotationAddedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputTextAnnotationAddedEvent),
+                jacksonTypeRef<BetaResponseOutputTextAnnotationAddedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputTextAnnotationAddedEvent)
+            .isEqualTo(betaResponseOutputTextAnnotationAddedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputTextTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputTextTest.kt
new file mode 100644
index 000000000..cbd4e2460
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseOutputTextTest.kt
@@ -0,0 +1,106 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseOutputTextTest {
+
+    @Test
+    fun create() {
+        val betaResponseOutputText =
+            BetaResponseOutputText.builder()
+                .addAnnotation(
+                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                        .fileId("file_id")
+                        .filename("filename")
+                        .index(0L)
+                        .build()
+                )
+                .text("text")
+                .addLogprob(
+                    BetaResponseOutputText.Logprob.builder()
+                        .token("token")
+                        .addByte(0L)
+                        .logprob(0.0)
+                        .addTopLogprob(
+                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .build()
+                        )
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseOutputText.annotations())
+            .containsExactly(
+                BetaResponseOutputText.Annotation.ofFileCitation(
+                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                        .fileId("file_id")
+                        .filename("filename")
+                        .index(0L)
+                        .build()
+                )
+            )
+        assertThat(betaResponseOutputText.text()).isEqualTo("text")
+        assertThat(betaResponseOutputText.logprobs().getOrNull())
+            .containsExactly(
+                BetaResponseOutputText.Logprob.builder()
+                    .token("token")
+                    .addByte(0L)
+                    .logprob(0.0)
+                    .addTopLogprob(
+                        BetaResponseOutputText.Logprob.TopLogprob.builder()
+                            .token("token")
+                            .addByte(0L)
+                            .logprob(0.0)
+                            .build()
+                    )
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseOutputText =
+            BetaResponseOutputText.builder()
+                .addAnnotation(
+                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                        .fileId("file_id")
+                        .filename("filename")
+                        .index(0L)
+                        .build()
+                )
+                .text("text")
+                .addLogprob(
+                    BetaResponseOutputText.Logprob.builder()
+                        .token("token")
+                        .addByte(0L)
+                        .logprob(0.0)
+                        .addTopLogprob(
+                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .build()
+                        )
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseOutputText =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseOutputText),
+                jacksonTypeRef<BetaResponseOutputText>(),
+            )
+
+        assertThat(roundtrippedBetaResponseOutputText).isEqualTo(betaResponseOutputText)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponsePromptTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponsePromptTest.kt
new file mode 100644
index 000000000..bc9db70eb
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponsePromptTest.kt
@@ -0,0 +1,58 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponsePromptTest {
+
+    @Test
+    fun create() {
+        val betaResponsePrompt =
+            BetaResponsePrompt.builder()
+                .id("id")
+                .variables(
+                    BetaResponsePrompt.Variables.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                        .build()
+                )
+                .version("version")
+                .build()
+
+        assertThat(betaResponsePrompt.id()).isEqualTo("id")
+        assertThat(betaResponsePrompt.variables())
+            .contains(
+                BetaResponsePrompt.Variables.builder()
+                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                    .build()
+            )
+        assertThat(betaResponsePrompt.version()).contains("version")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsePrompt =
+            BetaResponsePrompt.builder()
+                .id("id")
+                .variables(
+                    BetaResponsePrompt.Variables.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                        .build()
+                )
+                .version("version")
+                .build()
+
+        val roundtrippedBetaResponsePrompt =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsePrompt),
+                jacksonTypeRef<BetaResponsePrompt>(),
+            )
+
+        assertThat(roundtrippedBetaResponsePrompt).isEqualTo(betaResponsePrompt)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseQueuedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseQueuedEventTest.kt
new file mode 100644
index 000000000..595aa8830
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseQueuedEventTest.kt
@@ -0,0 +1,683 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseQueuedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseQueuedEvent =
+            BetaResponseQueuedEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseQueuedEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        assertThat(betaResponseQueuedEvent.response())
+            .isEqualTo(
+                BetaResponse.builder()
+                    .id("id")
+                    .createdAt(0.0)
+                    .error(
+                        BetaResponseError.builder()
+                            .code(BetaResponseError.Code.SERVER_ERROR)
+                            .message("message")
+                            .build()
+                    )
+                    .incompleteDetails(
+                        BetaResponse.IncompleteDetails.builder()
+                            .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                            .build()
+                    )
+                    .instructions("string")
+                    .metadata(
+                        BetaResponse.Metadata.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                            .build()
+                    )
+                    .model(BetaResponse.Model.GPT_5_1)
+                    .addOutput(
+                        BetaResponseOutputMessage.builder()
+                            .id("id")
+                            .addContent(
+                                BetaResponseOutputText.builder()
+                                    .addAnnotation(
+                                        BetaResponseOutputText.Annotation.FileCitation.builder()
+                                            .fileId("file_id")
+                                            .filename("filename")
+                                            .index(0L)
+                                            .build()
+                                    )
+                                    .text("text")
+                                    .addLogprob(
+                                        BetaResponseOutputText.Logprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .addTopLogprob(
+                                                BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                            .agent(
+                                BetaResponseOutputMessage.Agent.builder()
+                                    .agentName("agent_name")
+                                    .build()
+                            )
+                            .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                            .build()
+                    )
+                    .parallelToolCalls(true)
+                    .temperature(1.0)
+                    .toolChoice(BetaToolChoiceOptions.NONE)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .topP(1.0)
+                    .background(true)
+                    .completedAt(0.0)
+                    .conversation(BetaResponse.Conversation.builder().id("id").build())
+                    .maxOutputTokens(0L)
+                    .maxToolCalls(0L)
+                    .moderation(
+                        BetaResponse.Moderation.builder()
+                            .input(
+                                BetaResponse.Moderation.Input.ModerationResult.builder()
+                                    .categories(
+                                        BetaResponse.Moderation.Input.ModerationResult.Categories
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(true))
+                                            .build()
+                                    )
+                                    .categoryAppliedInputTypes(
+                                        BetaResponse.Moderation.Input.ModerationResult
+                                            .CategoryAppliedInputTypes
+                                            .builder()
+                                            .putAdditionalProperty(
+                                                "foo",
+                                                JsonValue.from(listOf("text")),
+                                            )
+                                            .build()
+                                    )
+                                    .categoryScores(
+                                        BetaResponse.Moderation.Input.ModerationResult
+                                            .CategoryScores
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(0))
+                                            .build()
+                                    )
+                                    .flagged(true)
+                                    .model("model")
+                                    .build()
+                            )
+                            .output(
+                                BetaResponse.Moderation.Output.ModerationResult.builder()
+                                    .categories(
+                                        BetaResponse.Moderation.Output.ModerationResult.Categories
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(true))
+                                            .build()
+                                    )
+                                    .categoryAppliedInputTypes(
+                                        BetaResponse.Moderation.Output.ModerationResult
+                                            .CategoryAppliedInputTypes
+                                            .builder()
+                                            .putAdditionalProperty(
+                                                "foo",
+                                                JsonValue.from(listOf("text")),
+                                            )
+                                            .build()
+                                    )
+                                    .categoryScores(
+                                        BetaResponse.Moderation.Output.ModerationResult
+                                            .CategoryScores
+                                            .builder()
+                                            .putAdditionalProperty("foo", JsonValue.from(0))
+                                            .build()
+                                    )
+                                    .flagged(true)
+                                    .model("model")
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .previousResponseId("previous_response_id")
+                    .prompt(
+                        BetaResponsePrompt.builder()
+                            .id("id")
+                            .variables(
+                                BetaResponsePrompt.Variables.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .version("version")
+                            .build()
+                    )
+                    .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        BetaResponse.PromptCacheOptions.builder()
+                            .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
+                    .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                    .reasoning(
+                        BetaResponse.Reasoning.builder()
+                            .context(BetaResponse.Reasoning.Context.AUTO)
+                            .effort(BetaResponse.Reasoning.Effort.NONE)
+                            .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                            .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                            .summary(BetaResponse.Reasoning.Summary.AUTO)
+                            .build()
+                    )
+                    .safetyIdentifier("safety-identifier-1234")
+                    .serviceTier(BetaResponse.ServiceTier.AUTO)
+                    .status(BetaResponseStatus.COMPLETED)
+                    .text(
+                        BetaResponseTextConfig.builder()
+                            .formatText()
+                            .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                            .build()
+                    )
+                    .topLogprobs(0L)
+                    .truncation(BetaResponse.Truncation.AUTO)
+                    .usage(
+                        BetaResponseUsage.builder()
+                            .inputTokens(0L)
+                            .inputTokensDetails(
+                                BetaResponseUsage.InputTokensDetails.builder()
+                                    .cacheWriteTokens(0L)
+                                    .cachedTokens(0L)
+                                    .build()
+                            )
+                            .outputTokens(0L)
+                            .outputTokensDetails(
+                                BetaResponseUsage.OutputTokensDetails.builder()
+                                    .reasoningTokens(0L)
+                                    .build()
+                            )
+                            .totalTokens(0L)
+                            .build()
+                    )
+                    .user("user-1234")
+                    .build()
+            )
+        assertThat(betaResponseQueuedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseQueuedEvent.agent())
+            .contains(BetaResponseQueuedEvent.Agent.builder().agentName("agent_name").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseQueuedEvent =
+            BetaResponseQueuedEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseQueuedEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val roundtrippedBetaResponseQueuedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseQueuedEvent),
+                jacksonTypeRef<BetaResponseQueuedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseQueuedEvent).isEqualTo(betaResponseQueuedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningItemTest.kt
new file mode 100644
index 000000000..9e5e008b3
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningItemTest.kt
@@ -0,0 +1,58 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseReasoningItemTest {
+
+    @Test
+    fun create() {
+        val betaResponseReasoningItem =
+            BetaResponseReasoningItem.builder()
+                .id("id")
+                .addSummary(BetaResponseReasoningItem.Summary.builder().text("text").build())
+                .agent(BetaResponseReasoningItem.Agent.builder().agentName("agent_name").build())
+                .addContent(BetaResponseReasoningItem.Content.builder().text("text").build())
+                .encryptedContent("encrypted_content")
+                .status(BetaResponseReasoningItem.Status.IN_PROGRESS)
+                .build()
+
+        assertThat(betaResponseReasoningItem.id()).isEqualTo("id")
+        assertThat(betaResponseReasoningItem.summary())
+            .containsExactly(BetaResponseReasoningItem.Summary.builder().text("text").build())
+        assertThat(betaResponseReasoningItem.agent())
+            .contains(BetaResponseReasoningItem.Agent.builder().agentName("agent_name").build())
+        assertThat(betaResponseReasoningItem.content().getOrNull())
+            .containsExactly(BetaResponseReasoningItem.Content.builder().text("text").build())
+        assertThat(betaResponseReasoningItem.encryptedContent()).contains("encrypted_content")
+        assertThat(betaResponseReasoningItem.status())
+            .contains(BetaResponseReasoningItem.Status.IN_PROGRESS)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseReasoningItem =
+            BetaResponseReasoningItem.builder()
+                .id("id")
+                .addSummary(BetaResponseReasoningItem.Summary.builder().text("text").build())
+                .agent(BetaResponseReasoningItem.Agent.builder().agentName("agent_name").build())
+                .addContent(BetaResponseReasoningItem.Content.builder().text("text").build())
+                .encryptedContent("encrypted_content")
+                .status(BetaResponseReasoningItem.Status.IN_PROGRESS)
+                .build()
+
+        val roundtrippedBetaResponseReasoningItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseReasoningItem),
+                jacksonTypeRef<BetaResponseReasoningItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseReasoningItem).isEqualTo(betaResponseReasoningItem)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryPartAddedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryPartAddedEventTest.kt
new file mode 100644
index 000000000..c5be651d4
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryPartAddedEventTest.kt
@@ -0,0 +1,74 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseReasoningSummaryPartAddedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseReasoningSummaryPartAddedEvent =
+            BetaResponseReasoningSummaryPartAddedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .part(
+                    BetaResponseReasoningSummaryPartAddedEvent.Part.builder().text("text").build()
+                )
+                .sequenceNumber(0L)
+                .summaryIndex(0L)
+                .agent(
+                    BetaResponseReasoningSummaryPartAddedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseReasoningSummaryPartAddedEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseReasoningSummaryPartAddedEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseReasoningSummaryPartAddedEvent.part())
+            .isEqualTo(
+                BetaResponseReasoningSummaryPartAddedEvent.Part.builder().text("text").build()
+            )
+        assertThat(betaResponseReasoningSummaryPartAddedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseReasoningSummaryPartAddedEvent.summaryIndex()).isEqualTo(0L)
+        assertThat(betaResponseReasoningSummaryPartAddedEvent.agent())
+            .contains(
+                BetaResponseReasoningSummaryPartAddedEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseReasoningSummaryPartAddedEvent =
+            BetaResponseReasoningSummaryPartAddedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .part(
+                    BetaResponseReasoningSummaryPartAddedEvent.Part.builder().text("text").build()
+                )
+                .sequenceNumber(0L)
+                .summaryIndex(0L)
+                .agent(
+                    BetaResponseReasoningSummaryPartAddedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseReasoningSummaryPartAddedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseReasoningSummaryPartAddedEvent),
+                jacksonTypeRef<BetaResponseReasoningSummaryPartAddedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseReasoningSummaryPartAddedEvent)
+            .isEqualTo(betaResponseReasoningSummaryPartAddedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryPartDoneEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryPartDoneEventTest.kt
new file mode 100644
index 000000000..b0425eb0d
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryPartDoneEventTest.kt
@@ -0,0 +1,74 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseReasoningSummaryPartDoneEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseReasoningSummaryPartDoneEvent =
+            BetaResponseReasoningSummaryPartDoneEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .part(BetaResponseReasoningSummaryPartDoneEvent.Part.builder().text("text").build())
+                .sequenceNumber(0L)
+                .summaryIndex(0L)
+                .agent(
+                    BetaResponseReasoningSummaryPartDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .status(BetaResponseReasoningSummaryPartDoneEvent.Status.INCOMPLETE)
+                .build()
+
+        assertThat(betaResponseReasoningSummaryPartDoneEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseReasoningSummaryPartDoneEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseReasoningSummaryPartDoneEvent.part())
+            .isEqualTo(
+                BetaResponseReasoningSummaryPartDoneEvent.Part.builder().text("text").build()
+            )
+        assertThat(betaResponseReasoningSummaryPartDoneEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseReasoningSummaryPartDoneEvent.summaryIndex()).isEqualTo(0L)
+        assertThat(betaResponseReasoningSummaryPartDoneEvent.agent())
+            .contains(
+                BetaResponseReasoningSummaryPartDoneEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+        assertThat(betaResponseReasoningSummaryPartDoneEvent.status())
+            .contains(BetaResponseReasoningSummaryPartDoneEvent.Status.INCOMPLETE)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseReasoningSummaryPartDoneEvent =
+            BetaResponseReasoningSummaryPartDoneEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .part(BetaResponseReasoningSummaryPartDoneEvent.Part.builder().text("text").build())
+                .sequenceNumber(0L)
+                .summaryIndex(0L)
+                .agent(
+                    BetaResponseReasoningSummaryPartDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .status(BetaResponseReasoningSummaryPartDoneEvent.Status.INCOMPLETE)
+                .build()
+
+        val roundtrippedBetaResponseReasoningSummaryPartDoneEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseReasoningSummaryPartDoneEvent),
+                jacksonTypeRef<BetaResponseReasoningSummaryPartDoneEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseReasoningSummaryPartDoneEvent)
+            .isEqualTo(betaResponseReasoningSummaryPartDoneEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryTextDeltaEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryTextDeltaEventTest.kt
new file mode 100644
index 000000000..79183d8ba
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryTextDeltaEventTest.kt
@@ -0,0 +1,67 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseReasoningSummaryTextDeltaEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseReasoningSummaryTextDeltaEvent =
+            BetaResponseReasoningSummaryTextDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .summaryIndex(0L)
+                .agent(
+                    BetaResponseReasoningSummaryTextDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseReasoningSummaryTextDeltaEvent.delta()).isEqualTo("delta")
+        assertThat(betaResponseReasoningSummaryTextDeltaEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseReasoningSummaryTextDeltaEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseReasoningSummaryTextDeltaEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseReasoningSummaryTextDeltaEvent.summaryIndex()).isEqualTo(0L)
+        assertThat(betaResponseReasoningSummaryTextDeltaEvent.agent())
+            .contains(
+                BetaResponseReasoningSummaryTextDeltaEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseReasoningSummaryTextDeltaEvent =
+            BetaResponseReasoningSummaryTextDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .summaryIndex(0L)
+                .agent(
+                    BetaResponseReasoningSummaryTextDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseReasoningSummaryTextDeltaEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseReasoningSummaryTextDeltaEvent),
+                jacksonTypeRef<BetaResponseReasoningSummaryTextDeltaEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseReasoningSummaryTextDeltaEvent)
+            .isEqualTo(betaResponseReasoningSummaryTextDeltaEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryTextDoneEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryTextDoneEventTest.kt
new file mode 100644
index 000000000..9c51f0599
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningSummaryTextDoneEventTest.kt
@@ -0,0 +1,67 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseReasoningSummaryTextDoneEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseReasoningSummaryTextDoneEvent =
+            BetaResponseReasoningSummaryTextDoneEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .summaryIndex(0L)
+                .text("text")
+                .agent(
+                    BetaResponseReasoningSummaryTextDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseReasoningSummaryTextDoneEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseReasoningSummaryTextDoneEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseReasoningSummaryTextDoneEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseReasoningSummaryTextDoneEvent.summaryIndex()).isEqualTo(0L)
+        assertThat(betaResponseReasoningSummaryTextDoneEvent.text()).isEqualTo("text")
+        assertThat(betaResponseReasoningSummaryTextDoneEvent.agent())
+            .contains(
+                BetaResponseReasoningSummaryTextDoneEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseReasoningSummaryTextDoneEvent =
+            BetaResponseReasoningSummaryTextDoneEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .summaryIndex(0L)
+                .text("text")
+                .agent(
+                    BetaResponseReasoningSummaryTextDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseReasoningSummaryTextDoneEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseReasoningSummaryTextDoneEvent),
+                jacksonTypeRef<BetaResponseReasoningSummaryTextDoneEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseReasoningSummaryTextDoneEvent)
+            .isEqualTo(betaResponseReasoningSummaryTextDoneEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningTextDeltaEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningTextDeltaEventTest.kt
new file mode 100644
index 000000000..ef3c4a45f
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningTextDeltaEventTest.kt
@@ -0,0 +1,65 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseReasoningTextDeltaEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseReasoningTextDeltaEvent =
+            BetaResponseReasoningTextDeltaEvent.builder()
+                .contentIndex(0L)
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseReasoningTextDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseReasoningTextDeltaEvent.contentIndex()).isEqualTo(0L)
+        assertThat(betaResponseReasoningTextDeltaEvent.delta()).isEqualTo("delta")
+        assertThat(betaResponseReasoningTextDeltaEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseReasoningTextDeltaEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseReasoningTextDeltaEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseReasoningTextDeltaEvent.agent())
+            .contains(
+                BetaResponseReasoningTextDeltaEvent.Agent.builder().agentName("agent_name").build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseReasoningTextDeltaEvent =
+            BetaResponseReasoningTextDeltaEvent.builder()
+                .contentIndex(0L)
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseReasoningTextDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseReasoningTextDeltaEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseReasoningTextDeltaEvent),
+                jacksonTypeRef<BetaResponseReasoningTextDeltaEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseReasoningTextDeltaEvent)
+            .isEqualTo(betaResponseReasoningTextDeltaEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningTextDoneEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningTextDoneEventTest.kt
new file mode 100644
index 000000000..2aa527656
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseReasoningTextDoneEventTest.kt
@@ -0,0 +1,65 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseReasoningTextDoneEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseReasoningTextDoneEvent =
+            BetaResponseReasoningTextDoneEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .text("text")
+                .agent(
+                    BetaResponseReasoningTextDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseReasoningTextDoneEvent.contentIndex()).isEqualTo(0L)
+        assertThat(betaResponseReasoningTextDoneEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseReasoningTextDoneEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseReasoningTextDoneEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseReasoningTextDoneEvent.text()).isEqualTo("text")
+        assertThat(betaResponseReasoningTextDoneEvent.agent())
+            .contains(
+                BetaResponseReasoningTextDoneEvent.Agent.builder().agentName("agent_name").build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseReasoningTextDoneEvent =
+            BetaResponseReasoningTextDoneEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .text("text")
+                .agent(
+                    BetaResponseReasoningTextDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseReasoningTextDoneEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseReasoningTextDoneEvent),
+                jacksonTypeRef<BetaResponseReasoningTextDoneEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseReasoningTextDoneEvent)
+            .isEqualTo(betaResponseReasoningTextDoneEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseRefusalDeltaEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseRefusalDeltaEventTest.kt
new file mode 100644
index 000000000..8248c7ac2
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseRefusalDeltaEventTest.kt
@@ -0,0 +1,59 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseRefusalDeltaEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseRefusalDeltaEvent =
+            BetaResponseRefusalDeltaEvent.builder()
+                .contentIndex(0L)
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseRefusalDeltaEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        assertThat(betaResponseRefusalDeltaEvent.contentIndex()).isEqualTo(0L)
+        assertThat(betaResponseRefusalDeltaEvent.delta()).isEqualTo("delta")
+        assertThat(betaResponseRefusalDeltaEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseRefusalDeltaEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseRefusalDeltaEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseRefusalDeltaEvent.agent())
+            .contains(BetaResponseRefusalDeltaEvent.Agent.builder().agentName("agent_name").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseRefusalDeltaEvent =
+            BetaResponseRefusalDeltaEvent.builder()
+                .contentIndex(0L)
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseRefusalDeltaEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseRefusalDeltaEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseRefusalDeltaEvent),
+                jacksonTypeRef<BetaResponseRefusalDeltaEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseRefusalDeltaEvent)
+            .isEqualTo(betaResponseRefusalDeltaEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseRefusalDoneEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseRefusalDoneEventTest.kt
new file mode 100644
index 000000000..dec53dd34
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseRefusalDoneEventTest.kt
@@ -0,0 +1,54 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseRefusalDoneEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseRefusalDoneEvent =
+            BetaResponseRefusalDoneEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .refusal("refusal")
+                .sequenceNumber(0L)
+                .agent(BetaResponseRefusalDoneEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        assertThat(betaResponseRefusalDoneEvent.contentIndex()).isEqualTo(0L)
+        assertThat(betaResponseRefusalDoneEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseRefusalDoneEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseRefusalDoneEvent.refusal()).isEqualTo("refusal")
+        assertThat(betaResponseRefusalDoneEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseRefusalDoneEvent.agent())
+            .contains(BetaResponseRefusalDoneEvent.Agent.builder().agentName("agent_name").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseRefusalDoneEvent =
+            BetaResponseRefusalDoneEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .refusal("refusal")
+                .sequenceNumber(0L)
+                .agent(BetaResponseRefusalDoneEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val roundtrippedBetaResponseRefusalDoneEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseRefusalDoneEvent),
+                jacksonTypeRef<BetaResponseRefusalDoneEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseRefusalDoneEvent).isEqualTo(betaResponseRefusalDoneEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseStreamEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseStreamEventTest.kt
new file mode 100644
index 000000000..92b983e49
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseStreamEventTest.kt
@@ -0,0 +1,8177 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import com.openai.errors.OpenAIInvalidDataException
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.assertThrows
+import org.junit.jupiter.params.ParameterizedTest
+import org.junit.jupiter.params.provider.EnumSource
+
+internal class BetaResponseStreamEventTest {
+
+    @Test
+    fun ofResponseAudioDelta() {
+        val responseAudioDelta =
+            BetaResponseAudioDeltaEvent.builder()
+                .delta("delta")
+                .sequenceNumber(0L)
+                .agent(BetaResponseAudioDeltaEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseAudioDelta(responseAudioDelta)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).contains(responseAudioDelta)
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseAudioDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseAudioDelta(
+                BetaResponseAudioDeltaEvent.builder()
+                    .delta("delta")
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseAudioDeltaEvent.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseAudioDone() {
+        val responseAudioDone =
+            BetaResponseAudioDoneEvent.builder()
+                .sequenceNumber(0L)
+                .agent(BetaResponseAudioDoneEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponseStreamEvent = BetaResponseStreamEvent.ofResponseAudioDone(responseAudioDone)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).contains(responseAudioDone)
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseAudioDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseAudioDone(
+                BetaResponseAudioDoneEvent.builder()
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseAudioDoneEvent.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseAudioTranscriptDelta() {
+        val responseAudioTranscriptDelta =
+            BetaResponseAudioTranscriptDeltaEvent.builder()
+                .delta("delta")
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseAudioTranscriptDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseAudioTranscriptDelta(responseAudioTranscriptDelta)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta())
+            .contains(responseAudioTranscriptDelta)
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseAudioTranscriptDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseAudioTranscriptDelta(
+                BetaResponseAudioTranscriptDeltaEvent.builder()
+                    .delta("delta")
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseAudioTranscriptDeltaEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseAudioTranscriptDone() {
+        val responseAudioTranscriptDone =
+            BetaResponseAudioTranscriptDoneEvent.builder()
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseAudioTranscriptDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseAudioTranscriptDone(responseAudioTranscriptDone)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone())
+            .contains(responseAudioTranscriptDone)
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseAudioTranscriptDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseAudioTranscriptDone(
+                BetaResponseAudioTranscriptDoneEvent.builder()
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseAudioTranscriptDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallCodeDelta() {
+        val responseCodeInterpreterCallCodeDelta =
+            BetaResponseCodeInterpreterCallCodeDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallCodeDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseCodeInterpreterCallCodeDelta(
+                responseCodeInterpreterCallCodeDelta
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta())
+            .contains(responseCodeInterpreterCallCodeDelta)
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallCodeDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseCodeInterpreterCallCodeDelta(
+                BetaResponseCodeInterpreterCallCodeDeltaEvent.builder()
+                    .delta("delta")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseCodeInterpreterCallCodeDeltaEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallCodeDone() {
+        val responseCodeInterpreterCallCodeDone =
+            BetaResponseCodeInterpreterCallCodeDoneEvent.builder()
+                .code("code")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallCodeDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseCodeInterpreterCallCodeDone(
+                responseCodeInterpreterCallCodeDone
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone())
+            .contains(responseCodeInterpreterCallCodeDone)
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallCodeDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseCodeInterpreterCallCodeDone(
+                BetaResponseCodeInterpreterCallCodeDoneEvent.builder()
+                    .code("code")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseCodeInterpreterCallCodeDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallCompleted() {
+        val responseCodeInterpreterCallCompleted =
+            BetaResponseCodeInterpreterCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseCodeInterpreterCallCompleted(
+                responseCodeInterpreterCallCompleted
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted())
+            .contains(responseCodeInterpreterCallCompleted)
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallCompletedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseCodeInterpreterCallCompleted(
+                BetaResponseCodeInterpreterCallCompletedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseCodeInterpreterCallCompletedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallInProgress() {
+        val responseCodeInterpreterCallInProgress =
+            BetaResponseCodeInterpreterCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseCodeInterpreterCallInProgress(
+                responseCodeInterpreterCallInProgress
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress())
+            .contains(responseCodeInterpreterCallInProgress)
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallInProgressRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseCodeInterpreterCallInProgress(
+                BetaResponseCodeInterpreterCallInProgressEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseCodeInterpreterCallInProgressEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallInterpreting() {
+        val responseCodeInterpreterCallInterpreting =
+            BetaResponseCodeInterpreterCallInterpretingEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallInterpretingEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseCodeInterpreterCallInterpreting(
+                responseCodeInterpreterCallInterpreting
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting())
+            .contains(responseCodeInterpreterCallInterpreting)
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallInterpretingRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseCodeInterpreterCallInterpreting(
+                BetaResponseCodeInterpreterCallInterpretingEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseCodeInterpreterCallInterpretingEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseCompleted() {
+        val responseCompleted =
+            BetaResponseCompletedEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseCompletedEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponseStreamEvent = BetaResponseStreamEvent.ofResponseCompleted(responseCompleted)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).contains(responseCompleted)
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCompletedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseCompleted(
+                BetaResponseCompletedEvent.builder()
+                    .response(
+                        BetaResponse.builder()
+                            .id("id")
+                            .createdAt(0.0)
+                            .error(
+                                BetaResponseError.builder()
+                                    .code(BetaResponseError.Code.SERVER_ERROR)
+                                    .message("message")
+                                    .build()
+                            )
+                            .incompleteDetails(
+                                BetaResponse.IncompleteDetails.builder()
+                                    .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                    .build()
+                            )
+                            .instructions("string")
+                            .metadata(
+                                BetaResponse.Metadata.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .model(BetaResponse.Model.GPT_5_1)
+                            .addOutput(
+                                BetaResponseOutputMessage.builder()
+                                    .id("id")
+                                    .addContent(
+                                        BetaResponseOutputText.builder()
+                                            .addAnnotation(
+                                                BetaResponseOutputText.Annotation.FileCitation
+                                                    .builder()
+                                                    .fileId("file_id")
+                                                    .filename("filename")
+                                                    .index(0L)
+                                                    .build()
+                                            )
+                                            .text("text")
+                                            .addLogprob(
+                                                BetaResponseOutputText.Logprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .addTopLogprob(
+                                                        BetaResponseOutputText.Logprob.TopLogprob
+                                                            .builder()
+                                                            .token("token")
+                                                            .addByte(0L)
+                                                            .logprob(0.0)
+                                                            .build()
+                                                    )
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                    .agent(
+                                        BetaResponseOutputMessage.Agent.builder()
+                                            .agentName("agent_name")
+                                            .build()
+                                    )
+                                    .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                    .build()
+                            )
+                            .parallelToolCalls(true)
+                            .temperature(1.0)
+                            .toolChoice(BetaToolChoiceOptions.NONE)
+                            .addTool(
+                                BetaFunctionTool.builder()
+                                    .name("name")
+                                    .parameters(
+                                        BetaFunctionTool.Parameters.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .strict(true)
+                                    .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                    .deferLoading(true)
+                                    .description("description")
+                                    .outputSchema(
+                                        BetaFunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .topP(1.0)
+                            .background(true)
+                            .completedAt(0.0)
+                            .conversation(BetaResponse.Conversation.builder().id("id").build())
+                            .maxOutputTokens(0L)
+                            .maxToolCalls(0L)
+                            .moderation(
+                                BetaResponse.Moderation.builder()
+                                    .input(
+                                        BetaResponse.Moderation.Input.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .output(
+                                        BetaResponse.Moderation.Output.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .previousResponseId("previous_response_id")
+                            .prompt(
+                                BetaResponsePrompt.builder()
+                                    .id("id")
+                                    .variables(
+                                        BetaResponsePrompt.Variables.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                                            .build()
+                                    )
+                                    .version("version")
+                                    .build()
+                            )
+                            .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                BetaResponse.PromptCacheOptions.builder()
+                                    .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
+                            .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                            .reasoning(
+                                BetaResponse.Reasoning.builder()
+                                    .context(BetaResponse.Reasoning.Context.AUTO)
+                                    .effort(BetaResponse.Reasoning.Effort.NONE)
+                                    .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                    .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                    .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                    .build()
+                            )
+                            .safetyIdentifier("safety-identifier-1234")
+                            .serviceTier(BetaResponse.ServiceTier.AUTO)
+                            .status(BetaResponseStatus.COMPLETED)
+                            .text(
+                                BetaResponseTextConfig.builder()
+                                    .formatText()
+                                    .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                    .build()
+                            )
+                            .topLogprobs(0L)
+                            .truncation(BetaResponse.Truncation.AUTO)
+                            .usage(
+                                BetaResponseUsage.builder()
+                                    .inputTokens(0L)
+                                    .inputTokensDetails(
+                                        BetaResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
+                                            .cachedTokens(0L)
+                                            .build()
+                                    )
+                                    .outputTokens(0L)
+                                    .outputTokensDetails(
+                                        BetaResponseUsage.OutputTokensDetails.builder()
+                                            .reasoningTokens(0L)
+                                            .build()
+                                    )
+                                    .totalTokens(0L)
+                                    .build()
+                            )
+                            .user("user-1234")
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseCompletedEvent.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseContentPartAdded() {
+        val responseContentPartAdded =
+            BetaResponseContentPartAddedEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .part(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseContentPartAddedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseContentPartAdded(responseContentPartAdded)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded())
+            .contains(responseContentPartAdded)
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseContentPartAddedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseContentPartAdded(
+                BetaResponseContentPartAddedEvent.builder()
+                    .contentIndex(0L)
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .part(
+                        BetaResponseOutputText.builder()
+                            .addAnnotation(
+                                BetaResponseOutputText.Annotation.FileCitation.builder()
+                                    .fileId("file_id")
+                                    .filename("filename")
+                                    .index(0L)
+                                    .build()
+                            )
+                            .text("text")
+                            .addLogprob(
+                                BetaResponseOutputText.Logprob.builder()
+                                    .token("token")
+                                    .addByte(0L)
+                                    .logprob(0.0)
+                                    .addTopLogprob(
+                                        BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseContentPartAddedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseContentPartDone() {
+        val responseContentPartDone =
+            BetaResponseContentPartDoneEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .part(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseContentPartDoneEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseContentPartDone(responseContentPartDone)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone())
+            .contains(responseContentPartDone)
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseContentPartDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseContentPartDone(
+                BetaResponseContentPartDoneEvent.builder()
+                    .contentIndex(0L)
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .part(
+                        BetaResponseOutputText.builder()
+                            .addAnnotation(
+                                BetaResponseOutputText.Annotation.FileCitation.builder()
+                                    .fileId("file_id")
+                                    .filename("filename")
+                                    .index(0L)
+                                    .build()
+                            )
+                            .text("text")
+                            .addLogprob(
+                                BetaResponseOutputText.Logprob.builder()
+                                    .token("token")
+                                    .addByte(0L)
+                                    .logprob(0.0)
+                                    .addTopLogprob(
+                                        BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseContentPartDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseCreated() {
+        val responseCreated =
+            BetaResponseCreatedEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseCreatedEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponseStreamEvent = BetaResponseStreamEvent.ofResponseCreated(responseCreated)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).contains(responseCreated)
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCreatedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseCreated(
+                BetaResponseCreatedEvent.builder()
+                    .response(
+                        BetaResponse.builder()
+                            .id("id")
+                            .createdAt(0.0)
+                            .error(
+                                BetaResponseError.builder()
+                                    .code(BetaResponseError.Code.SERVER_ERROR)
+                                    .message("message")
+                                    .build()
+                            )
+                            .incompleteDetails(
+                                BetaResponse.IncompleteDetails.builder()
+                                    .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                    .build()
+                            )
+                            .instructions("string")
+                            .metadata(
+                                BetaResponse.Metadata.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .model(BetaResponse.Model.GPT_5_1)
+                            .addOutput(
+                                BetaResponseOutputMessage.builder()
+                                    .id("id")
+                                    .addContent(
+                                        BetaResponseOutputText.builder()
+                                            .addAnnotation(
+                                                BetaResponseOutputText.Annotation.FileCitation
+                                                    .builder()
+                                                    .fileId("file_id")
+                                                    .filename("filename")
+                                                    .index(0L)
+                                                    .build()
+                                            )
+                                            .text("text")
+                                            .addLogprob(
+                                                BetaResponseOutputText.Logprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .addTopLogprob(
+                                                        BetaResponseOutputText.Logprob.TopLogprob
+                                                            .builder()
+                                                            .token("token")
+                                                            .addByte(0L)
+                                                            .logprob(0.0)
+                                                            .build()
+                                                    )
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                    .agent(
+                                        BetaResponseOutputMessage.Agent.builder()
+                                            .agentName("agent_name")
+                                            .build()
+                                    )
+                                    .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                    .build()
+                            )
+                            .parallelToolCalls(true)
+                            .temperature(1.0)
+                            .toolChoice(BetaToolChoiceOptions.NONE)
+                            .addTool(
+                                BetaFunctionTool.builder()
+                                    .name("name")
+                                    .parameters(
+                                        BetaFunctionTool.Parameters.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .strict(true)
+                                    .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                    .deferLoading(true)
+                                    .description("description")
+                                    .outputSchema(
+                                        BetaFunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .topP(1.0)
+                            .background(true)
+                            .completedAt(0.0)
+                            .conversation(BetaResponse.Conversation.builder().id("id").build())
+                            .maxOutputTokens(0L)
+                            .maxToolCalls(0L)
+                            .moderation(
+                                BetaResponse.Moderation.builder()
+                                    .input(
+                                        BetaResponse.Moderation.Input.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .output(
+                                        BetaResponse.Moderation.Output.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .previousResponseId("previous_response_id")
+                            .prompt(
+                                BetaResponsePrompt.builder()
+                                    .id("id")
+                                    .variables(
+                                        BetaResponsePrompt.Variables.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                                            .build()
+                                    )
+                                    .version("version")
+                                    .build()
+                            )
+                            .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                BetaResponse.PromptCacheOptions.builder()
+                                    .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
+                            .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                            .reasoning(
+                                BetaResponse.Reasoning.builder()
+                                    .context(BetaResponse.Reasoning.Context.AUTO)
+                                    .effort(BetaResponse.Reasoning.Effort.NONE)
+                                    .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                    .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                    .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                    .build()
+                            )
+                            .safetyIdentifier("safety-identifier-1234")
+                            .serviceTier(BetaResponse.ServiceTier.AUTO)
+                            .status(BetaResponseStatus.COMPLETED)
+                            .text(
+                                BetaResponseTextConfig.builder()
+                                    .formatText()
+                                    .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                    .build()
+                            )
+                            .topLogprobs(0L)
+                            .truncation(BetaResponse.Truncation.AUTO)
+                            .usage(
+                                BetaResponseUsage.builder()
+                                    .inputTokens(0L)
+                                    .inputTokensDetails(
+                                        BetaResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
+                                            .cachedTokens(0L)
+                                            .build()
+                                    )
+                                    .outputTokens(0L)
+                                    .outputTokensDetails(
+                                        BetaResponseUsage.OutputTokensDetails.builder()
+                                            .reasoningTokens(0L)
+                                            .build()
+                                    )
+                                    .totalTokens(0L)
+                                    .build()
+                            )
+                            .user("user-1234")
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .agent(BetaResponseCreatedEvent.Agent.builder().agentName("agent_name").build())
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofError() {
+        val error =
+            BetaResponseErrorEvent.builder()
+                .code("code")
+                .message("message")
+                .param("param")
+                .sequenceNumber(0L)
+                .agent(BetaResponseErrorEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponseStreamEvent = BetaResponseStreamEvent.ofError(error)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).contains(error)
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofErrorRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofError(
+                BetaResponseErrorEvent.builder()
+                    .code("code")
+                    .message("message")
+                    .param("param")
+                    .sequenceNumber(0L)
+                    .agent(BetaResponseErrorEvent.Agent.builder().agentName("agent_name").build())
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseFileSearchCallCompleted() {
+        val responseFileSearchCallCompleted =
+            BetaResponseFileSearchCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFileSearchCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseFileSearchCallCompleted(
+                responseFileSearchCallCompleted
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted())
+            .contains(responseFileSearchCallCompleted)
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseFileSearchCallCompletedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseFileSearchCallCompleted(
+                BetaResponseFileSearchCallCompletedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseFileSearchCallCompletedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseFileSearchCallInProgress() {
+        val responseFileSearchCallInProgress =
+            BetaResponseFileSearchCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFileSearchCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseFileSearchCallInProgress(
+                responseFileSearchCallInProgress
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress())
+            .contains(responseFileSearchCallInProgress)
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseFileSearchCallInProgressRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseFileSearchCallInProgress(
+                BetaResponseFileSearchCallInProgressEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseFileSearchCallInProgressEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseFileSearchCallSearching() {
+        val responseFileSearchCallSearching =
+            BetaResponseFileSearchCallSearchingEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFileSearchCallSearchingEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseFileSearchCallSearching(
+                responseFileSearchCallSearching
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching())
+            .contains(responseFileSearchCallSearching)
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseFileSearchCallSearchingRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseFileSearchCallSearching(
+                BetaResponseFileSearchCallSearchingEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseFileSearchCallSearchingEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseFunctionCallArgumentsDelta() {
+        val responseFunctionCallArgumentsDelta =
+            BetaResponseFunctionCallArgumentsDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFunctionCallArgumentsDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseFunctionCallArgumentsDelta(
+                responseFunctionCallArgumentsDelta
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta())
+            .contains(responseFunctionCallArgumentsDelta)
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseFunctionCallArgumentsDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseFunctionCallArgumentsDelta(
+                BetaResponseFunctionCallArgumentsDeltaEvent.builder()
+                    .delta("delta")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseFunctionCallArgumentsDeltaEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseFunctionCallArgumentsDone() {
+        val responseFunctionCallArgumentsDone =
+            BetaResponseFunctionCallArgumentsDoneEvent.builder()
+                .arguments("arguments")
+                .itemId("item_id")
+                .name("name")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFunctionCallArgumentsDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseFunctionCallArgumentsDone(
+                responseFunctionCallArgumentsDone
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone())
+            .contains(responseFunctionCallArgumentsDone)
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseFunctionCallArgumentsDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseFunctionCallArgumentsDone(
+                BetaResponseFunctionCallArgumentsDoneEvent.builder()
+                    .arguments("arguments")
+                    .itemId("item_id")
+                    .name("name")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseFunctionCallArgumentsDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseInProgress() {
+        val responseInProgress =
+            BetaResponseInProgressEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseInProgressEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseInProgress(responseInProgress)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).contains(responseInProgress)
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseInProgressRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseInProgress(
+                BetaResponseInProgressEvent.builder()
+                    .response(
+                        BetaResponse.builder()
+                            .id("id")
+                            .createdAt(0.0)
+                            .error(
+                                BetaResponseError.builder()
+                                    .code(BetaResponseError.Code.SERVER_ERROR)
+                                    .message("message")
+                                    .build()
+                            )
+                            .incompleteDetails(
+                                BetaResponse.IncompleteDetails.builder()
+                                    .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                    .build()
+                            )
+                            .instructions("string")
+                            .metadata(
+                                BetaResponse.Metadata.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .model(BetaResponse.Model.GPT_5_1)
+                            .addOutput(
+                                BetaResponseOutputMessage.builder()
+                                    .id("id")
+                                    .addContent(
+                                        BetaResponseOutputText.builder()
+                                            .addAnnotation(
+                                                BetaResponseOutputText.Annotation.FileCitation
+                                                    .builder()
+                                                    .fileId("file_id")
+                                                    .filename("filename")
+                                                    .index(0L)
+                                                    .build()
+                                            )
+                                            .text("text")
+                                            .addLogprob(
+                                                BetaResponseOutputText.Logprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .addTopLogprob(
+                                                        BetaResponseOutputText.Logprob.TopLogprob
+                                                            .builder()
+                                                            .token("token")
+                                                            .addByte(0L)
+                                                            .logprob(0.0)
+                                                            .build()
+                                                    )
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                    .agent(
+                                        BetaResponseOutputMessage.Agent.builder()
+                                            .agentName("agent_name")
+                                            .build()
+                                    )
+                                    .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                    .build()
+                            )
+                            .parallelToolCalls(true)
+                            .temperature(1.0)
+                            .toolChoice(BetaToolChoiceOptions.NONE)
+                            .addTool(
+                                BetaFunctionTool.builder()
+                                    .name("name")
+                                    .parameters(
+                                        BetaFunctionTool.Parameters.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .strict(true)
+                                    .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                    .deferLoading(true)
+                                    .description("description")
+                                    .outputSchema(
+                                        BetaFunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .topP(1.0)
+                            .background(true)
+                            .completedAt(0.0)
+                            .conversation(BetaResponse.Conversation.builder().id("id").build())
+                            .maxOutputTokens(0L)
+                            .maxToolCalls(0L)
+                            .moderation(
+                                BetaResponse.Moderation.builder()
+                                    .input(
+                                        BetaResponse.Moderation.Input.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .output(
+                                        BetaResponse.Moderation.Output.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .previousResponseId("previous_response_id")
+                            .prompt(
+                                BetaResponsePrompt.builder()
+                                    .id("id")
+                                    .variables(
+                                        BetaResponsePrompt.Variables.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                                            .build()
+                                    )
+                                    .version("version")
+                                    .build()
+                            )
+                            .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                BetaResponse.PromptCacheOptions.builder()
+                                    .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
+                            .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                            .reasoning(
+                                BetaResponse.Reasoning.builder()
+                                    .context(BetaResponse.Reasoning.Context.AUTO)
+                                    .effort(BetaResponse.Reasoning.Effort.NONE)
+                                    .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                    .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                    .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                    .build()
+                            )
+                            .safetyIdentifier("safety-identifier-1234")
+                            .serviceTier(BetaResponse.ServiceTier.AUTO)
+                            .status(BetaResponseStatus.COMPLETED)
+                            .text(
+                                BetaResponseTextConfig.builder()
+                                    .formatText()
+                                    .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                    .build()
+                            )
+                            .topLogprobs(0L)
+                            .truncation(BetaResponse.Truncation.AUTO)
+                            .usage(
+                                BetaResponseUsage.builder()
+                                    .inputTokens(0L)
+                                    .inputTokensDetails(
+                                        BetaResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
+                                            .cachedTokens(0L)
+                                            .build()
+                                    )
+                                    .outputTokens(0L)
+                                    .outputTokensDetails(
+                                        BetaResponseUsage.OutputTokensDetails.builder()
+                                            .reasoningTokens(0L)
+                                            .build()
+                                    )
+                                    .totalTokens(0L)
+                                    .build()
+                            )
+                            .user("user-1234")
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseInProgressEvent.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseFailed() {
+        val responseFailed =
+            BetaResponseFailedEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseFailedEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponseStreamEvent = BetaResponseStreamEvent.ofResponseFailed(responseFailed)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).contains(responseFailed)
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseFailedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseFailed(
+                BetaResponseFailedEvent.builder()
+                    .response(
+                        BetaResponse.builder()
+                            .id("id")
+                            .createdAt(0.0)
+                            .error(
+                                BetaResponseError.builder()
+                                    .code(BetaResponseError.Code.SERVER_ERROR)
+                                    .message("message")
+                                    .build()
+                            )
+                            .incompleteDetails(
+                                BetaResponse.IncompleteDetails.builder()
+                                    .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                    .build()
+                            )
+                            .instructions("string")
+                            .metadata(
+                                BetaResponse.Metadata.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .model(BetaResponse.Model.GPT_5_1)
+                            .addOutput(
+                                BetaResponseOutputMessage.builder()
+                                    .id("id")
+                                    .addContent(
+                                        BetaResponseOutputText.builder()
+                                            .addAnnotation(
+                                                BetaResponseOutputText.Annotation.FileCitation
+                                                    .builder()
+                                                    .fileId("file_id")
+                                                    .filename("filename")
+                                                    .index(0L)
+                                                    .build()
+                                            )
+                                            .text("text")
+                                            .addLogprob(
+                                                BetaResponseOutputText.Logprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .addTopLogprob(
+                                                        BetaResponseOutputText.Logprob.TopLogprob
+                                                            .builder()
+                                                            .token("token")
+                                                            .addByte(0L)
+                                                            .logprob(0.0)
+                                                            .build()
+                                                    )
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                    .agent(
+                                        BetaResponseOutputMessage.Agent.builder()
+                                            .agentName("agent_name")
+                                            .build()
+                                    )
+                                    .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                    .build()
+                            )
+                            .parallelToolCalls(true)
+                            .temperature(1.0)
+                            .toolChoice(BetaToolChoiceOptions.NONE)
+                            .addTool(
+                                BetaFunctionTool.builder()
+                                    .name("name")
+                                    .parameters(
+                                        BetaFunctionTool.Parameters.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .strict(true)
+                                    .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                    .deferLoading(true)
+                                    .description("description")
+                                    .outputSchema(
+                                        BetaFunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .topP(1.0)
+                            .background(true)
+                            .completedAt(0.0)
+                            .conversation(BetaResponse.Conversation.builder().id("id").build())
+                            .maxOutputTokens(0L)
+                            .maxToolCalls(0L)
+                            .moderation(
+                                BetaResponse.Moderation.builder()
+                                    .input(
+                                        BetaResponse.Moderation.Input.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .output(
+                                        BetaResponse.Moderation.Output.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .previousResponseId("previous_response_id")
+                            .prompt(
+                                BetaResponsePrompt.builder()
+                                    .id("id")
+                                    .variables(
+                                        BetaResponsePrompt.Variables.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                                            .build()
+                                    )
+                                    .version("version")
+                                    .build()
+                            )
+                            .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                BetaResponse.PromptCacheOptions.builder()
+                                    .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
+                            .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                            .reasoning(
+                                BetaResponse.Reasoning.builder()
+                                    .context(BetaResponse.Reasoning.Context.AUTO)
+                                    .effort(BetaResponse.Reasoning.Effort.NONE)
+                                    .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                    .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                    .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                    .build()
+                            )
+                            .safetyIdentifier("safety-identifier-1234")
+                            .serviceTier(BetaResponse.ServiceTier.AUTO)
+                            .status(BetaResponseStatus.COMPLETED)
+                            .text(
+                                BetaResponseTextConfig.builder()
+                                    .formatText()
+                                    .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                    .build()
+                            )
+                            .topLogprobs(0L)
+                            .truncation(BetaResponse.Truncation.AUTO)
+                            .usage(
+                                BetaResponseUsage.builder()
+                                    .inputTokens(0L)
+                                    .inputTokensDetails(
+                                        BetaResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
+                                            .cachedTokens(0L)
+                                            .build()
+                                    )
+                                    .outputTokens(0L)
+                                    .outputTokensDetails(
+                                        BetaResponseUsage.OutputTokensDetails.builder()
+                                            .reasoningTokens(0L)
+                                            .build()
+                                    )
+                                    .totalTokens(0L)
+                                    .build()
+                            )
+                            .user("user-1234")
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .agent(BetaResponseFailedEvent.Agent.builder().agentName("agent_name").build())
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseIncomplete() {
+        val responseIncomplete =
+            BetaResponseIncompleteEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseIncompleteEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseIncomplete(responseIncomplete)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).contains(responseIncomplete)
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseIncompleteRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseIncomplete(
+                BetaResponseIncompleteEvent.builder()
+                    .response(
+                        BetaResponse.builder()
+                            .id("id")
+                            .createdAt(0.0)
+                            .error(
+                                BetaResponseError.builder()
+                                    .code(BetaResponseError.Code.SERVER_ERROR)
+                                    .message("message")
+                                    .build()
+                            )
+                            .incompleteDetails(
+                                BetaResponse.IncompleteDetails.builder()
+                                    .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                    .build()
+                            )
+                            .instructions("string")
+                            .metadata(
+                                BetaResponse.Metadata.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .model(BetaResponse.Model.GPT_5_1)
+                            .addOutput(
+                                BetaResponseOutputMessage.builder()
+                                    .id("id")
+                                    .addContent(
+                                        BetaResponseOutputText.builder()
+                                            .addAnnotation(
+                                                BetaResponseOutputText.Annotation.FileCitation
+                                                    .builder()
+                                                    .fileId("file_id")
+                                                    .filename("filename")
+                                                    .index(0L)
+                                                    .build()
+                                            )
+                                            .text("text")
+                                            .addLogprob(
+                                                BetaResponseOutputText.Logprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .addTopLogprob(
+                                                        BetaResponseOutputText.Logprob.TopLogprob
+                                                            .builder()
+                                                            .token("token")
+                                                            .addByte(0L)
+                                                            .logprob(0.0)
+                                                            .build()
+                                                    )
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                    .agent(
+                                        BetaResponseOutputMessage.Agent.builder()
+                                            .agentName("agent_name")
+                                            .build()
+                                    )
+                                    .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                    .build()
+                            )
+                            .parallelToolCalls(true)
+                            .temperature(1.0)
+                            .toolChoice(BetaToolChoiceOptions.NONE)
+                            .addTool(
+                                BetaFunctionTool.builder()
+                                    .name("name")
+                                    .parameters(
+                                        BetaFunctionTool.Parameters.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .strict(true)
+                                    .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                    .deferLoading(true)
+                                    .description("description")
+                                    .outputSchema(
+                                        BetaFunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .topP(1.0)
+                            .background(true)
+                            .completedAt(0.0)
+                            .conversation(BetaResponse.Conversation.builder().id("id").build())
+                            .maxOutputTokens(0L)
+                            .maxToolCalls(0L)
+                            .moderation(
+                                BetaResponse.Moderation.builder()
+                                    .input(
+                                        BetaResponse.Moderation.Input.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .output(
+                                        BetaResponse.Moderation.Output.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .previousResponseId("previous_response_id")
+                            .prompt(
+                                BetaResponsePrompt.builder()
+                                    .id("id")
+                                    .variables(
+                                        BetaResponsePrompt.Variables.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                                            .build()
+                                    )
+                                    .version("version")
+                                    .build()
+                            )
+                            .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                BetaResponse.PromptCacheOptions.builder()
+                                    .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
+                            .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                            .reasoning(
+                                BetaResponse.Reasoning.builder()
+                                    .context(BetaResponse.Reasoning.Context.AUTO)
+                                    .effort(BetaResponse.Reasoning.Effort.NONE)
+                                    .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                    .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                    .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                    .build()
+                            )
+                            .safetyIdentifier("safety-identifier-1234")
+                            .serviceTier(BetaResponse.ServiceTier.AUTO)
+                            .status(BetaResponseStatus.COMPLETED)
+                            .text(
+                                BetaResponseTextConfig.builder()
+                                    .formatText()
+                                    .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                    .build()
+                            )
+                            .topLogprobs(0L)
+                            .truncation(BetaResponse.Truncation.AUTO)
+                            .usage(
+                                BetaResponseUsage.builder()
+                                    .inputTokens(0L)
+                                    .inputTokensDetails(
+                                        BetaResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
+                                            .cachedTokens(0L)
+                                            .build()
+                                    )
+                                    .outputTokens(0L)
+                                    .outputTokensDetails(
+                                        BetaResponseUsage.OutputTokensDetails.builder()
+                                            .reasoningTokens(0L)
+                                            .build()
+                                    )
+                                    .totalTokens(0L)
+                                    .build()
+                            )
+                            .user("user-1234")
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseIncompleteEvent.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseOutputItemAdded() {
+        val responseOutputItemAdded =
+            BetaResponseOutputItemAddedEvent.builder()
+                .item(
+                    BetaResponseOutputMessage.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseOutputText.builder()
+                                .addAnnotation(
+                                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                                        .fileId("file_id")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                                .text("text")
+                                .addLogprob(
+                                    BetaResponseOutputText.Logprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .addTopLogprob(
+                                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                        .agent(
+                            BetaResponseOutputMessage.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                        .build()
+                )
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseOutputItemAddedEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseOutputItemAdded(responseOutputItemAdded)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded())
+            .contains(responseOutputItemAdded)
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseOutputItemAddedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseOutputItemAdded(
+                BetaResponseOutputItemAddedEvent.builder()
+                    .item(
+                        BetaResponseOutputMessage.builder()
+                            .id("id")
+                            .addContent(
+                                BetaResponseOutputText.builder()
+                                    .addAnnotation(
+                                        BetaResponseOutputText.Annotation.FileCitation.builder()
+                                            .fileId("file_id")
+                                            .filename("filename")
+                                            .index(0L)
+                                            .build()
+                                    )
+                                    .text("text")
+                                    .addLogprob(
+                                        BetaResponseOutputText.Logprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .addTopLogprob(
+                                                BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                            .agent(
+                                BetaResponseOutputMessage.Agent.builder()
+                                    .agentName("agent_name")
+                                    .build()
+                            )
+                            .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                            .build()
+                    )
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseOutputItemAddedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseOutputItemDone() {
+        val responseOutputItemDone =
+            BetaResponseOutputItemDoneEvent.builder()
+                .item(
+                    BetaResponseOutputMessage.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseOutputText.builder()
+                                .addAnnotation(
+                                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                                        .fileId("file_id")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                                .text("text")
+                                .addLogprob(
+                                    BetaResponseOutputText.Logprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .addTopLogprob(
+                                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                        .agent(
+                            BetaResponseOutputMessage.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                        .build()
+                )
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseOutputItemDoneEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseOutputItemDone(responseOutputItemDone)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone())
+            .contains(responseOutputItemDone)
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseOutputItemDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseOutputItemDone(
+                BetaResponseOutputItemDoneEvent.builder()
+                    .item(
+                        BetaResponseOutputMessage.builder()
+                            .id("id")
+                            .addContent(
+                                BetaResponseOutputText.builder()
+                                    .addAnnotation(
+                                        BetaResponseOutputText.Annotation.FileCitation.builder()
+                                            .fileId("file_id")
+                                            .filename("filename")
+                                            .index(0L)
+                                            .build()
+                                    )
+                                    .text("text")
+                                    .addLogprob(
+                                        BetaResponseOutputText.Logprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .addTopLogprob(
+                                                BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                            .agent(
+                                BetaResponseOutputMessage.Agent.builder()
+                                    .agentName("agent_name")
+                                    .build()
+                            )
+                            .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                            .build()
+                    )
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseOutputItemDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseReasoningSummaryPartAdded() {
+        val responseReasoningSummaryPartAdded =
+            BetaResponseReasoningSummaryPartAddedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .part(
+                    BetaResponseReasoningSummaryPartAddedEvent.Part.builder().text("text").build()
+                )
+                .sequenceNumber(0L)
+                .summaryIndex(0L)
+                .agent(
+                    BetaResponseReasoningSummaryPartAddedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseReasoningSummaryPartAdded(
+                responseReasoningSummaryPartAdded
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded())
+            .contains(responseReasoningSummaryPartAdded)
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseReasoningSummaryPartAddedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseReasoningSummaryPartAdded(
+                BetaResponseReasoningSummaryPartAddedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .part(
+                        BetaResponseReasoningSummaryPartAddedEvent.Part.builder()
+                            .text("text")
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .summaryIndex(0L)
+                    .agent(
+                        BetaResponseReasoningSummaryPartAddedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseReasoningSummaryPartDone() {
+        val responseReasoningSummaryPartDone =
+            BetaResponseReasoningSummaryPartDoneEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .part(BetaResponseReasoningSummaryPartDoneEvent.Part.builder().text("text").build())
+                .sequenceNumber(0L)
+                .summaryIndex(0L)
+                .agent(
+                    BetaResponseReasoningSummaryPartDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .status(BetaResponseReasoningSummaryPartDoneEvent.Status.INCOMPLETE)
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseReasoningSummaryPartDone(
+                responseReasoningSummaryPartDone
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone())
+            .contains(responseReasoningSummaryPartDone)
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseReasoningSummaryPartDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseReasoningSummaryPartDone(
+                BetaResponseReasoningSummaryPartDoneEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .part(
+                        BetaResponseReasoningSummaryPartDoneEvent.Part.builder()
+                            .text("text")
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .summaryIndex(0L)
+                    .agent(
+                        BetaResponseReasoningSummaryPartDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .status(BetaResponseReasoningSummaryPartDoneEvent.Status.INCOMPLETE)
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseReasoningSummaryTextDelta() {
+        val responseReasoningSummaryTextDelta =
+            BetaResponseReasoningSummaryTextDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .summaryIndex(0L)
+                .agent(
+                    BetaResponseReasoningSummaryTextDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseReasoningSummaryTextDelta(
+                responseReasoningSummaryTextDelta
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta())
+            .contains(responseReasoningSummaryTextDelta)
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseReasoningSummaryTextDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseReasoningSummaryTextDelta(
+                BetaResponseReasoningSummaryTextDeltaEvent.builder()
+                    .delta("delta")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .summaryIndex(0L)
+                    .agent(
+                        BetaResponseReasoningSummaryTextDeltaEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseReasoningSummaryTextDone() {
+        val responseReasoningSummaryTextDone =
+            BetaResponseReasoningSummaryTextDoneEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .summaryIndex(0L)
+                .text("text")
+                .agent(
+                    BetaResponseReasoningSummaryTextDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseReasoningSummaryTextDone(
+                responseReasoningSummaryTextDone
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone())
+            .contains(responseReasoningSummaryTextDone)
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseReasoningSummaryTextDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseReasoningSummaryTextDone(
+                BetaResponseReasoningSummaryTextDoneEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .summaryIndex(0L)
+                    .text("text")
+                    .agent(
+                        BetaResponseReasoningSummaryTextDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseReasoningTextDelta() {
+        val responseReasoningTextDelta =
+            BetaResponseReasoningTextDeltaEvent.builder()
+                .contentIndex(0L)
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseReasoningTextDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseReasoningTextDelta(responseReasoningTextDelta)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta())
+            .contains(responseReasoningTextDelta)
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseReasoningTextDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseReasoningTextDelta(
+                BetaResponseReasoningTextDeltaEvent.builder()
+                    .contentIndex(0L)
+                    .delta("delta")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseReasoningTextDeltaEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseReasoningTextDone() {
+        val responseReasoningTextDone =
+            BetaResponseReasoningTextDoneEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .text("text")
+                .agent(
+                    BetaResponseReasoningTextDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseReasoningTextDone(responseReasoningTextDone)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone())
+            .contains(responseReasoningTextDone)
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseReasoningTextDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseReasoningTextDone(
+                BetaResponseReasoningTextDoneEvent.builder()
+                    .contentIndex(0L)
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .text("text")
+                    .agent(
+                        BetaResponseReasoningTextDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseRefusalDelta() {
+        val responseRefusalDelta =
+            BetaResponseRefusalDeltaEvent.builder()
+                .contentIndex(0L)
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseRefusalDeltaEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseRefusalDelta(responseRefusalDelta)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).contains(responseRefusalDelta)
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseRefusalDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseRefusalDelta(
+                BetaResponseRefusalDeltaEvent.builder()
+                    .contentIndex(0L)
+                    .delta("delta")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseRefusalDeltaEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseRefusalDone() {
+        val responseRefusalDone =
+            BetaResponseRefusalDoneEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .refusal("refusal")
+                .sequenceNumber(0L)
+                .agent(BetaResponseRefusalDoneEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseRefusalDone(responseRefusalDone)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).contains(responseRefusalDone)
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseRefusalDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseRefusalDone(
+                BetaResponseRefusalDoneEvent.builder()
+                    .contentIndex(0L)
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .refusal("refusal")
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseRefusalDoneEvent.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseOutputTextDelta() {
+        val responseOutputTextDelta =
+            BetaResponseTextDeltaEvent.builder()
+                .contentIndex(0L)
+                .delta("delta")
+                .itemId("item_id")
+                .addLogprob(
+                    BetaResponseTextDeltaEvent.Logprob.builder()
+                        .token("token")
+                        .logprob(0.0)
+                        .addTopLogprob(
+                            BetaResponseTextDeltaEvent.Logprob.TopLogprob.builder()
+                                .token("token")
+                                .logprob(0.0)
+                                .build()
+                        )
+                        .build()
+                )
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(BetaResponseTextDeltaEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseOutputTextDelta(responseOutputTextDelta)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta())
+            .contains(responseOutputTextDelta)
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseOutputTextDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseOutputTextDelta(
+                BetaResponseTextDeltaEvent.builder()
+                    .contentIndex(0L)
+                    .delta("delta")
+                    .itemId("item_id")
+                    .addLogprob(
+                        BetaResponseTextDeltaEvent.Logprob.builder()
+                            .token("token")
+                            .logprob(0.0)
+                            .addTopLogprob(
+                                BetaResponseTextDeltaEvent.Logprob.TopLogprob.builder()
+                                    .token("token")
+                                    .logprob(0.0)
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseTextDeltaEvent.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseOutputTextDone() {
+        val responseOutputTextDone =
+            BetaResponseTextDoneEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .addLogprob(
+                    BetaResponseTextDoneEvent.Logprob.builder()
+                        .token("token")
+                        .logprob(0.0)
+                        .addTopLogprob(
+                            BetaResponseTextDoneEvent.Logprob.TopLogprob.builder()
+                                .token("token")
+                                .logprob(0.0)
+                                .build()
+                        )
+                        .build()
+                )
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .text("text")
+                .agent(BetaResponseTextDoneEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseOutputTextDone(responseOutputTextDone)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone())
+            .contains(responseOutputTextDone)
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseOutputTextDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseOutputTextDone(
+                BetaResponseTextDoneEvent.builder()
+                    .contentIndex(0L)
+                    .itemId("item_id")
+                    .addLogprob(
+                        BetaResponseTextDoneEvent.Logprob.builder()
+                            .token("token")
+                            .logprob(0.0)
+                            .addTopLogprob(
+                                BetaResponseTextDoneEvent.Logprob.TopLogprob.builder()
+                                    .token("token")
+                                    .logprob(0.0)
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .text("text")
+                    .agent(
+                        BetaResponseTextDoneEvent.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseWebSearchCallCompleted() {
+        val responseWebSearchCallCompleted =
+            BetaResponseWebSearchCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseWebSearchCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseWebSearchCallCompleted(responseWebSearchCallCompleted)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted())
+            .contains(responseWebSearchCallCompleted)
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseWebSearchCallCompletedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseWebSearchCallCompleted(
+                BetaResponseWebSearchCallCompletedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseWebSearchCallCompletedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseWebSearchCallInProgress() {
+        val responseWebSearchCallInProgress =
+            BetaResponseWebSearchCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseWebSearchCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseWebSearchCallInProgress(
+                responseWebSearchCallInProgress
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress())
+            .contains(responseWebSearchCallInProgress)
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseWebSearchCallInProgressRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseWebSearchCallInProgress(
+                BetaResponseWebSearchCallInProgressEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseWebSearchCallInProgressEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseWebSearchCallSearching() {
+        val responseWebSearchCallSearching =
+            BetaResponseWebSearchCallSearchingEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseWebSearchCallSearchingEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseWebSearchCallSearching(responseWebSearchCallSearching)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching())
+            .contains(responseWebSearchCallSearching)
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseWebSearchCallSearchingRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseWebSearchCallSearching(
+                BetaResponseWebSearchCallSearchingEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseWebSearchCallSearchingEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseImageGenerationCallCompleted() {
+        val responseImageGenerationCallCompleted =
+            BetaResponseImageGenCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseImageGenCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseImageGenerationCallCompleted(
+                responseImageGenerationCallCompleted
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted())
+            .contains(responseImageGenerationCallCompleted)
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseImageGenerationCallCompletedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseImageGenerationCallCompleted(
+                BetaResponseImageGenCallCompletedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseImageGenCallCompletedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseImageGenerationCallGenerating() {
+        val responseImageGenerationCallGenerating =
+            BetaResponseImageGenCallGeneratingEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseImageGenCallGeneratingEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseImageGenerationCallGenerating(
+                responseImageGenerationCallGenerating
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating())
+            .contains(responseImageGenerationCallGenerating)
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseImageGenerationCallGeneratingRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseImageGenerationCallGenerating(
+                BetaResponseImageGenCallGeneratingEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseImageGenCallGeneratingEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseImageGenerationCallInProgress() {
+        val responseImageGenerationCallInProgress =
+            BetaResponseImageGenCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseImageGenCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseImageGenerationCallInProgress(
+                responseImageGenerationCallInProgress
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress())
+            .contains(responseImageGenerationCallInProgress)
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseImageGenerationCallInProgressRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseImageGenerationCallInProgress(
+                BetaResponseImageGenCallInProgressEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseImageGenCallInProgressEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseImageGenerationCallPartialImage() {
+        val responseImageGenerationCallPartialImage =
+            BetaResponseImageGenCallPartialImageEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .partialImageB64("partial_image_b64")
+                .partialImageIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseImageGenCallPartialImageEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseImageGenerationCallPartialImage(
+                responseImageGenerationCallPartialImage
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage())
+            .contains(responseImageGenerationCallPartialImage)
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseImageGenerationCallPartialImageRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseImageGenerationCallPartialImage(
+                BetaResponseImageGenCallPartialImageEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .partialImageB64("partial_image_b64")
+                    .partialImageIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseImageGenCallPartialImageEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseMcpCallArgumentsDelta() {
+        val responseMcpCallArgumentsDelta =
+            BetaResponseMcpCallArgumentsDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallArgumentsDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseMcpCallArgumentsDelta(responseMcpCallArgumentsDelta)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta())
+            .contains(responseMcpCallArgumentsDelta)
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseMcpCallArgumentsDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseMcpCallArgumentsDelta(
+                BetaResponseMcpCallArgumentsDeltaEvent.builder()
+                    .delta("delta")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseMcpCallArgumentsDeltaEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseMcpCallArgumentsDone() {
+        val responseMcpCallArgumentsDone =
+            BetaResponseMcpCallArgumentsDoneEvent.builder()
+                .arguments("arguments")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallArgumentsDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseMcpCallArgumentsDone(responseMcpCallArgumentsDone)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone())
+            .contains(responseMcpCallArgumentsDone)
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseMcpCallArgumentsDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseMcpCallArgumentsDone(
+                BetaResponseMcpCallArgumentsDoneEvent.builder()
+                    .arguments("arguments")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseMcpCallArgumentsDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseMcpCallCompleted() {
+        val responseMcpCallCompleted =
+            BetaResponseMcpCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseMcpCallCompleted(responseMcpCallCompleted)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted())
+            .contains(responseMcpCallCompleted)
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseMcpCallCompletedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseMcpCallCompleted(
+                BetaResponseMcpCallCompletedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseMcpCallCompletedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseMcpCallFailed() {
+        val responseMcpCallFailed =
+            BetaResponseMcpCallFailedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallFailedEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseMcpCallFailed(responseMcpCallFailed)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).contains(responseMcpCallFailed)
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseMcpCallFailedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseMcpCallFailed(
+                BetaResponseMcpCallFailedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseMcpCallFailedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseMcpCallInProgress() {
+        val responseMcpCallInProgress =
+            BetaResponseMcpCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseMcpCallInProgress(responseMcpCallInProgress)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress())
+            .contains(responseMcpCallInProgress)
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseMcpCallInProgressRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseMcpCallInProgress(
+                BetaResponseMcpCallInProgressEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseMcpCallInProgressEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseMcpListToolsCompleted() {
+        val responseMcpListToolsCompleted =
+            BetaResponseMcpListToolsCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpListToolsCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseMcpListToolsCompleted(responseMcpListToolsCompleted)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted())
+            .contains(responseMcpListToolsCompleted)
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseMcpListToolsCompletedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseMcpListToolsCompleted(
+                BetaResponseMcpListToolsCompletedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseMcpListToolsCompletedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseMcpListToolsFailed() {
+        val responseMcpListToolsFailed =
+            BetaResponseMcpListToolsFailedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpListToolsFailedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseMcpListToolsFailed(responseMcpListToolsFailed)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed())
+            .contains(responseMcpListToolsFailed)
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseMcpListToolsFailedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseMcpListToolsFailed(
+                BetaResponseMcpListToolsFailedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseMcpListToolsFailedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseMcpListToolsInProgress() {
+        val responseMcpListToolsInProgress =
+            BetaResponseMcpListToolsInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpListToolsInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseMcpListToolsInProgress(responseMcpListToolsInProgress)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress())
+            .contains(responseMcpListToolsInProgress)
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseMcpListToolsInProgressRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseMcpListToolsInProgress(
+                BetaResponseMcpListToolsInProgressEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseMcpListToolsInProgressEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseOutputTextAnnotationAdded() {
+        val responseOutputTextAnnotationAdded =
+            BetaResponseOutputTextAnnotationAddedEvent.builder()
+                .annotation(JsonValue.from(mapOf<String, Any>()))
+                .annotationIndex(0L)
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseOutputTextAnnotationAddedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseOutputTextAnnotationAdded(
+                responseOutputTextAnnotationAdded
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded())
+            .contains(responseOutputTextAnnotationAdded)
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseOutputTextAnnotationAddedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseOutputTextAnnotationAdded(
+                BetaResponseOutputTextAnnotationAddedEvent.builder()
+                    .annotation(JsonValue.from(mapOf<String, Any>()))
+                    .annotationIndex(0L)
+                    .contentIndex(0L)
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseOutputTextAnnotationAddedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseQueued() {
+        val responseQueued =
+            BetaResponseQueuedEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseQueuedEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponseStreamEvent = BetaResponseStreamEvent.ofResponseQueued(responseQueued)
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).contains(responseQueued)
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseQueuedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseQueued(
+                BetaResponseQueuedEvent.builder()
+                    .response(
+                        BetaResponse.builder()
+                            .id("id")
+                            .createdAt(0.0)
+                            .error(
+                                BetaResponseError.builder()
+                                    .code(BetaResponseError.Code.SERVER_ERROR)
+                                    .message("message")
+                                    .build()
+                            )
+                            .incompleteDetails(
+                                BetaResponse.IncompleteDetails.builder()
+                                    .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                    .build()
+                            )
+                            .instructions("string")
+                            .metadata(
+                                BetaResponse.Metadata.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .model(BetaResponse.Model.GPT_5_1)
+                            .addOutput(
+                                BetaResponseOutputMessage.builder()
+                                    .id("id")
+                                    .addContent(
+                                        BetaResponseOutputText.builder()
+                                            .addAnnotation(
+                                                BetaResponseOutputText.Annotation.FileCitation
+                                                    .builder()
+                                                    .fileId("file_id")
+                                                    .filename("filename")
+                                                    .index(0L)
+                                                    .build()
+                                            )
+                                            .text("text")
+                                            .addLogprob(
+                                                BetaResponseOutputText.Logprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .addTopLogprob(
+                                                        BetaResponseOutputText.Logprob.TopLogprob
+                                                            .builder()
+                                                            .token("token")
+                                                            .addByte(0L)
+                                                            .logprob(0.0)
+                                                            .build()
+                                                    )
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                    .agent(
+                                        BetaResponseOutputMessage.Agent.builder()
+                                            .agentName("agent_name")
+                                            .build()
+                                    )
+                                    .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                    .build()
+                            )
+                            .parallelToolCalls(true)
+                            .temperature(1.0)
+                            .toolChoice(BetaToolChoiceOptions.NONE)
+                            .addTool(
+                                BetaFunctionTool.builder()
+                                    .name("name")
+                                    .parameters(
+                                        BetaFunctionTool.Parameters.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .strict(true)
+                                    .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                    .deferLoading(true)
+                                    .description("description")
+                                    .outputSchema(
+                                        BetaFunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .topP(1.0)
+                            .background(true)
+                            .completedAt(0.0)
+                            .conversation(BetaResponse.Conversation.builder().id("id").build())
+                            .maxOutputTokens(0L)
+                            .maxToolCalls(0L)
+                            .moderation(
+                                BetaResponse.Moderation.builder()
+                                    .input(
+                                        BetaResponse.Moderation.Input.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .output(
+                                        BetaResponse.Moderation.Output.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .previousResponseId("previous_response_id")
+                            .prompt(
+                                BetaResponsePrompt.builder()
+                                    .id("id")
+                                    .variables(
+                                        BetaResponsePrompt.Variables.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                                            .build()
+                                    )
+                                    .version("version")
+                                    .build()
+                            )
+                            .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                BetaResponse.PromptCacheOptions.builder()
+                                    .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
+                            .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                            .reasoning(
+                                BetaResponse.Reasoning.builder()
+                                    .context(BetaResponse.Reasoning.Context.AUTO)
+                                    .effort(BetaResponse.Reasoning.Effort.NONE)
+                                    .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                    .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                    .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                    .build()
+                            )
+                            .safetyIdentifier("safety-identifier-1234")
+                            .serviceTier(BetaResponse.ServiceTier.AUTO)
+                            .status(BetaResponseStatus.COMPLETED)
+                            .text(
+                                BetaResponseTextConfig.builder()
+                                    .formatText()
+                                    .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                    .build()
+                            )
+                            .topLogprobs(0L)
+                            .truncation(BetaResponse.Truncation.AUTO)
+                            .usage(
+                                BetaResponseUsage.builder()
+                                    .inputTokens(0L)
+                                    .inputTokensDetails(
+                                        BetaResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
+                                            .cachedTokens(0L)
+                                            .build()
+                                    )
+                                    .outputTokens(0L)
+                                    .outputTokensDetails(
+                                        BetaResponseUsage.OutputTokensDetails.builder()
+                                            .reasoningTokens(0L)
+                                            .build()
+                                    )
+                                    .totalTokens(0L)
+                                    .build()
+                            )
+                            .user("user-1234")
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .agent(BetaResponseQueuedEvent.Agent.builder().agentName("agent_name").build())
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseCustomToolCallInputDelta() {
+        val responseCustomToolCallInputDelta =
+            BetaResponseCustomToolCallInputDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCustomToolCallInputDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseCustomToolCallInputDelta(
+                responseCustomToolCallInputDelta
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta())
+            .contains(responseCustomToolCallInputDelta)
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCustomToolCallInputDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseCustomToolCallInputDelta(
+                BetaResponseCustomToolCallInputDeltaEvent.builder()
+                    .delta("delta")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseCustomToolCallInputDeltaEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    @Test
+    fun ofResponseCustomToolCallInputDone() {
+        val responseCustomToolCallInputDone =
+            BetaResponseCustomToolCallInputDoneEvent.builder()
+                .input("input")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCustomToolCallInputDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseCustomToolCallInputDone(
+                responseCustomToolCallInputDone
+            )
+
+        assertThat(betaResponseStreamEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCreated()).isEmpty
+        assertThat(betaResponseStreamEvent.error()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponseStreamEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponseStreamEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponseStreamEvent.responseQueued()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponseStreamEvent.responseCustomToolCallInputDone())
+            .contains(responseCustomToolCallInputDone)
+    }
+
+    @Test
+    fun ofResponseCustomToolCallInputDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseStreamEvent =
+            BetaResponseStreamEvent.ofResponseCustomToolCallInputDone(
+                BetaResponseCustomToolCallInputDoneEvent.builder()
+                    .input("input")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseCustomToolCallInputDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponseStreamEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseStreamEvent),
+                jacksonTypeRef<BetaResponseStreamEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseStreamEvent).isEqualTo(betaResponseStreamEvent)
+    }
+
+    enum class IncompatibleJsonShapeTestCase(val value: JsonValue) {
+        BOOLEAN(JsonValue.from(false)),
+        STRING(JsonValue.from("invalid")),
+        INTEGER(JsonValue.from(-1)),
+        FLOAT(JsonValue.from(3.14)),
+        ARRAY(JsonValue.from(listOf("invalid", "array"))),
+    }
+
+    @ParameterizedTest
+    @EnumSource
+    fun incompatibleJsonShapeDeserializesToUnknown(testCase: IncompatibleJsonShapeTestCase) {
+        val betaResponseStreamEvent =
+            jsonMapper().convertValue(testCase.value, jacksonTypeRef<BetaResponseStreamEvent>())
+
+        val e = assertThrows<OpenAIInvalidDataException> { betaResponseStreamEvent.validate() }
+        assertThat(e).hasMessageStartingWith("Unknown ")
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseTest.kt
new file mode 100644
index 000000000..dc6127f63
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseTest.kt
@@ -0,0 +1,660 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseTest {
+
+    @Test
+    fun create() {
+        val betaResponse =
+            BetaResponse.builder()
+                .id("id")
+                .createdAt(0.0)
+                .error(
+                    BetaResponseError.builder()
+                        .code(BetaResponseError.Code.SERVER_ERROR)
+                        .message("message")
+                        .build()
+                )
+                .incompleteDetails(
+                    BetaResponse.IncompleteDetails.builder()
+                        .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                        .build()
+                )
+                .instructions("string")
+                .metadata(
+                    BetaResponse.Metadata.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                        .build()
+                )
+                .model(BetaResponse.Model.GPT_5_1)
+                .addOutput(
+                    BetaResponseOutputMessage.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseOutputText.builder()
+                                .addAnnotation(
+                                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                                        .fileId("file_id")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                                .text("text")
+                                .addLogprob(
+                                    BetaResponseOutputText.Logprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .addTopLogprob(
+                                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                        .agent(
+                            BetaResponseOutputMessage.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                        .build()
+                )
+                .parallelToolCalls(true)
+                .temperature(1.0)
+                .toolChoice(BetaToolChoiceOptions.NONE)
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .topP(1.0)
+                .background(true)
+                .completedAt(0.0)
+                .conversation(BetaResponse.Conversation.builder().id("id").build())
+                .maxOutputTokens(0L)
+                .maxToolCalls(0L)
+                .moderation(
+                    BetaResponse.Moderation.builder()
+                        .input(
+                            BetaResponse.Moderation.Input.ModerationResult.builder()
+                                .categories(
+                                    BetaResponse.Moderation.Input.ModerationResult.Categories
+                                        .builder()
+                                        .putAdditionalProperty("foo", JsonValue.from(true))
+                                        .build()
+                                )
+                                .categoryAppliedInputTypes(
+                                    BetaResponse.Moderation.Input.ModerationResult
+                                        .CategoryAppliedInputTypes
+                                        .builder()
+                                        .putAdditionalProperty(
+                                            "foo",
+                                            JsonValue.from(listOf("text")),
+                                        )
+                                        .build()
+                                )
+                                .categoryScores(
+                                    BetaResponse.Moderation.Input.ModerationResult.CategoryScores
+                                        .builder()
+                                        .putAdditionalProperty("foo", JsonValue.from(0))
+                                        .build()
+                                )
+                                .flagged(true)
+                                .model("model")
+                                .build()
+                        )
+                        .output(
+                            BetaResponse.Moderation.Output.ModerationResult.builder()
+                                .categories(
+                                    BetaResponse.Moderation.Output.ModerationResult.Categories
+                                        .builder()
+                                        .putAdditionalProperty("foo", JsonValue.from(true))
+                                        .build()
+                                )
+                                .categoryAppliedInputTypes(
+                                    BetaResponse.Moderation.Output.ModerationResult
+                                        .CategoryAppliedInputTypes
+                                        .builder()
+                                        .putAdditionalProperty(
+                                            "foo",
+                                            JsonValue.from(listOf("text")),
+                                        )
+                                        .build()
+                                )
+                                .categoryScores(
+                                    BetaResponse.Moderation.Output.ModerationResult.CategoryScores
+                                        .builder()
+                                        .putAdditionalProperty("foo", JsonValue.from(0))
+                                        .build()
+                                )
+                                .flagged(true)
+                                .model("model")
+                                .build()
+                        )
+                        .build()
+                )
+                .previousResponseId("previous_response_id")
+                .prompt(
+                    BetaResponsePrompt.builder()
+                        .id("id")
+                        .variables(
+                            BetaResponsePrompt.Variables.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .version("version")
+                        .build()
+                )
+                .promptCacheKey("prompt-cache-key-1234")
+                .promptCacheOptions(
+                    BetaResponse.PromptCacheOptions.builder()
+                        .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                        .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                        .build()
+                )
+                .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                .reasoning(
+                    BetaResponse.Reasoning.builder()
+                        .context(BetaResponse.Reasoning.Context.AUTO)
+                        .effort(BetaResponse.Reasoning.Effort.NONE)
+                        .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                        .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                        .summary(BetaResponse.Reasoning.Summary.AUTO)
+                        .build()
+                )
+                .safetyIdentifier("safety-identifier-1234")
+                .serviceTier(BetaResponse.ServiceTier.AUTO)
+                .status(BetaResponseStatus.COMPLETED)
+                .text(
+                    BetaResponseTextConfig.builder()
+                        .formatText()
+                        .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                        .build()
+                )
+                .topLogprobs(0L)
+                .truncation(BetaResponse.Truncation.AUTO)
+                .usage(
+                    BetaResponseUsage.builder()
+                        .inputTokens(0L)
+                        .inputTokensDetails(
+                            BetaResponseUsage.InputTokensDetails.builder()
+                                .cacheWriteTokens(0L)
+                                .cachedTokens(0L)
+                                .build()
+                        )
+                        .outputTokens(0L)
+                        .outputTokensDetails(
+                            BetaResponseUsage.OutputTokensDetails.builder()
+                                .reasoningTokens(0L)
+                                .build()
+                        )
+                        .totalTokens(0L)
+                        .build()
+                )
+                .user("user-1234")
+                .build()
+
+        assertThat(betaResponse.id()).isEqualTo("id")
+        assertThat(betaResponse.createdAt()).isEqualTo(0.0)
+        assertThat(betaResponse.error())
+            .contains(
+                BetaResponseError.builder()
+                    .code(BetaResponseError.Code.SERVER_ERROR)
+                    .message("message")
+                    .build()
+            )
+        assertThat(betaResponse.incompleteDetails())
+            .contains(
+                BetaResponse.IncompleteDetails.builder()
+                    .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                    .build()
+            )
+        assertThat(betaResponse.instructions())
+            .contains(BetaResponse.Instructions.ofString("string"))
+        assertThat(betaResponse.metadata())
+            .contains(
+                BetaResponse.Metadata.builder()
+                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                    .build()
+            )
+        assertThat(betaResponse.model()).isEqualTo(BetaResponse.Model.GPT_5_1)
+        assertThat(betaResponse.output())
+            .containsExactly(
+                BetaResponseOutputItem.ofMessage(
+                    BetaResponseOutputMessage.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseOutputText.builder()
+                                .addAnnotation(
+                                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                                        .fileId("file_id")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                                .text("text")
+                                .addLogprob(
+                                    BetaResponseOutputText.Logprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .addTopLogprob(
+                                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                        .agent(
+                            BetaResponseOutputMessage.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                        .build()
+                )
+            )
+        assertThat(betaResponse.parallelToolCalls()).isEqualTo(true)
+        assertThat(betaResponse.temperature()).contains(1.0)
+        assertThat(betaResponse.toolChoice())
+            .isEqualTo(BetaResponse.ToolChoice.ofBetaToolChoiceOptions(BetaToolChoiceOptions.NONE))
+        assertThat(betaResponse.tools())
+            .containsExactly(
+                BetaTool.ofFunction(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+            )
+        assertThat(betaResponse.topP()).contains(1.0)
+        assertThat(betaResponse.background()).contains(true)
+        assertThat(betaResponse.completedAt()).contains(0.0)
+        assertThat(betaResponse.conversation())
+            .contains(BetaResponse.Conversation.builder().id("id").build())
+        assertThat(betaResponse.maxOutputTokens()).contains(0L)
+        assertThat(betaResponse.maxToolCalls()).contains(0L)
+        assertThat(betaResponse.moderation())
+            .contains(
+                BetaResponse.Moderation.builder()
+                    .input(
+                        BetaResponse.Moderation.Input.ModerationResult.builder()
+                            .categories(
+                                BetaResponse.Moderation.Input.ModerationResult.Categories.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from(true))
+                                    .build()
+                            )
+                            .categoryAppliedInputTypes(
+                                BetaResponse.Moderation.Input.ModerationResult
+                                    .CategoryAppliedInputTypes
+                                    .builder()
+                                    .putAdditionalProperty("foo", JsonValue.from(listOf("text")))
+                                    .build()
+                            )
+                            .categoryScores(
+                                BetaResponse.Moderation.Input.ModerationResult.CategoryScores
+                                    .builder()
+                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                    .build()
+                            )
+                            .flagged(true)
+                            .model("model")
+                            .build()
+                    )
+                    .output(
+                        BetaResponse.Moderation.Output.ModerationResult.builder()
+                            .categories(
+                                BetaResponse.Moderation.Output.ModerationResult.Categories.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from(true))
+                                    .build()
+                            )
+                            .categoryAppliedInputTypes(
+                                BetaResponse.Moderation.Output.ModerationResult
+                                    .CategoryAppliedInputTypes
+                                    .builder()
+                                    .putAdditionalProperty("foo", JsonValue.from(listOf("text")))
+                                    .build()
+                            )
+                            .categoryScores(
+                                BetaResponse.Moderation.Output.ModerationResult.CategoryScores
+                                    .builder()
+                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                    .build()
+                            )
+                            .flagged(true)
+                            .model("model")
+                            .build()
+                    )
+                    .build()
+            )
+        assertThat(betaResponse.previousResponseId()).contains("previous_response_id")
+        assertThat(betaResponse.prompt())
+            .contains(
+                BetaResponsePrompt.builder()
+                    .id("id")
+                    .variables(
+                        BetaResponsePrompt.Variables.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                            .build()
+                    )
+                    .version("version")
+                    .build()
+            )
+        assertThat(betaResponse.promptCacheKey()).contains("prompt-cache-key-1234")
+        assertThat(betaResponse.promptCacheOptions())
+            .contains(
+                BetaResponse.PromptCacheOptions.builder()
+                    .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                    .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                    .build()
+            )
+        assertThat(betaResponse.promptCacheRetention())
+            .contains(BetaResponse.PromptCacheRetention.IN_MEMORY)
+        assertThat(betaResponse.reasoning())
+            .contains(
+                BetaResponse.Reasoning.builder()
+                    .context(BetaResponse.Reasoning.Context.AUTO)
+                    .effort(BetaResponse.Reasoning.Effort.NONE)
+                    .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                    .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                    .summary(BetaResponse.Reasoning.Summary.AUTO)
+                    .build()
+            )
+        assertThat(betaResponse.safetyIdentifier()).contains("safety-identifier-1234")
+        assertThat(betaResponse.serviceTier()).contains(BetaResponse.ServiceTier.AUTO)
+        assertThat(betaResponse.status()).contains(BetaResponseStatus.COMPLETED)
+        assertThat(betaResponse.text())
+            .contains(
+                BetaResponseTextConfig.builder()
+                    .formatText()
+                    .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                    .build()
+            )
+        assertThat(betaResponse.topLogprobs()).contains(0L)
+        assertThat(betaResponse.truncation()).contains(BetaResponse.Truncation.AUTO)
+        assertThat(betaResponse.usage())
+            .contains(
+                BetaResponseUsage.builder()
+                    .inputTokens(0L)
+                    .inputTokensDetails(
+                        BetaResponseUsage.InputTokensDetails.builder()
+                            .cacheWriteTokens(0L)
+                            .cachedTokens(0L)
+                            .build()
+                    )
+                    .outputTokens(0L)
+                    .outputTokensDetails(
+                        BetaResponseUsage.OutputTokensDetails.builder().reasoningTokens(0L).build()
+                    )
+                    .totalTokens(0L)
+                    .build()
+            )
+        assertThat(betaResponse.user()).contains("user-1234")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponse =
+            BetaResponse.builder()
+                .id("id")
+                .createdAt(0.0)
+                .error(
+                    BetaResponseError.builder()
+                        .code(BetaResponseError.Code.SERVER_ERROR)
+                        .message("message")
+                        .build()
+                )
+                .incompleteDetails(
+                    BetaResponse.IncompleteDetails.builder()
+                        .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                        .build()
+                )
+                .instructions("string")
+                .metadata(
+                    BetaResponse.Metadata.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                        .build()
+                )
+                .model(BetaResponse.Model.GPT_5_1)
+                .addOutput(
+                    BetaResponseOutputMessage.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseOutputText.builder()
+                                .addAnnotation(
+                                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                                        .fileId("file_id")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                                .text("text")
+                                .addLogprob(
+                                    BetaResponseOutputText.Logprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .addTopLogprob(
+                                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                        .agent(
+                            BetaResponseOutputMessage.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                        .build()
+                )
+                .parallelToolCalls(true)
+                .temperature(1.0)
+                .toolChoice(BetaToolChoiceOptions.NONE)
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .topP(1.0)
+                .background(true)
+                .completedAt(0.0)
+                .conversation(BetaResponse.Conversation.builder().id("id").build())
+                .maxOutputTokens(0L)
+                .maxToolCalls(0L)
+                .moderation(
+                    BetaResponse.Moderation.builder()
+                        .input(
+                            BetaResponse.Moderation.Input.ModerationResult.builder()
+                                .categories(
+                                    BetaResponse.Moderation.Input.ModerationResult.Categories
+                                        .builder()
+                                        .putAdditionalProperty("foo", JsonValue.from(true))
+                                        .build()
+                                )
+                                .categoryAppliedInputTypes(
+                                    BetaResponse.Moderation.Input.ModerationResult
+                                        .CategoryAppliedInputTypes
+                                        .builder()
+                                        .putAdditionalProperty(
+                                            "foo",
+                                            JsonValue.from(listOf("text")),
+                                        )
+                                        .build()
+                                )
+                                .categoryScores(
+                                    BetaResponse.Moderation.Input.ModerationResult.CategoryScores
+                                        .builder()
+                                        .putAdditionalProperty("foo", JsonValue.from(0))
+                                        .build()
+                                )
+                                .flagged(true)
+                                .model("model")
+                                .build()
+                        )
+                        .output(
+                            BetaResponse.Moderation.Output.ModerationResult.builder()
+                                .categories(
+                                    BetaResponse.Moderation.Output.ModerationResult.Categories
+                                        .builder()
+                                        .putAdditionalProperty("foo", JsonValue.from(true))
+                                        .build()
+                                )
+                                .categoryAppliedInputTypes(
+                                    BetaResponse.Moderation.Output.ModerationResult
+                                        .CategoryAppliedInputTypes
+                                        .builder()
+                                        .putAdditionalProperty(
+                                            "foo",
+                                            JsonValue.from(listOf("text")),
+                                        )
+                                        .build()
+                                )
+                                .categoryScores(
+                                    BetaResponse.Moderation.Output.ModerationResult.CategoryScores
+                                        .builder()
+                                        .putAdditionalProperty("foo", JsonValue.from(0))
+                                        .build()
+                                )
+                                .flagged(true)
+                                .model("model")
+                                .build()
+                        )
+                        .build()
+                )
+                .previousResponseId("previous_response_id")
+                .prompt(
+                    BetaResponsePrompt.builder()
+                        .id("id")
+                        .variables(
+                            BetaResponsePrompt.Variables.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .version("version")
+                        .build()
+                )
+                .promptCacheKey("prompt-cache-key-1234")
+                .promptCacheOptions(
+                    BetaResponse.PromptCacheOptions.builder()
+                        .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                        .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                        .build()
+                )
+                .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                .reasoning(
+                    BetaResponse.Reasoning.builder()
+                        .context(BetaResponse.Reasoning.Context.AUTO)
+                        .effort(BetaResponse.Reasoning.Effort.NONE)
+                        .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                        .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                        .summary(BetaResponse.Reasoning.Summary.AUTO)
+                        .build()
+                )
+                .safetyIdentifier("safety-identifier-1234")
+                .serviceTier(BetaResponse.ServiceTier.AUTO)
+                .status(BetaResponseStatus.COMPLETED)
+                .text(
+                    BetaResponseTextConfig.builder()
+                        .formatText()
+                        .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                        .build()
+                )
+                .topLogprobs(0L)
+                .truncation(BetaResponse.Truncation.AUTO)
+                .usage(
+                    BetaResponseUsage.builder()
+                        .inputTokens(0L)
+                        .inputTokensDetails(
+                            BetaResponseUsage.InputTokensDetails.builder()
+                                .cacheWriteTokens(0L)
+                                .cachedTokens(0L)
+                                .build()
+                        )
+                        .outputTokens(0L)
+                        .outputTokensDetails(
+                            BetaResponseUsage.OutputTokensDetails.builder()
+                                .reasoningTokens(0L)
+                                .build()
+                        )
+                        .totalTokens(0L)
+                        .build()
+                )
+                .user("user-1234")
+                .build()
+
+        val roundtrippedBetaResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponse),
+                jacksonTypeRef<BetaResponse>(),
+            )
+
+        assertThat(roundtrippedBetaResponse).isEqualTo(betaResponse)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseTextConfigTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseTextConfigTest.kt
new file mode 100644
index 000000000..acfa5abca
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseTextConfigTest.kt
@@ -0,0 +1,42 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseTextConfigTest {
+
+    @Test
+    fun create() {
+        val betaResponseTextConfig =
+            BetaResponseTextConfig.builder()
+                .formatText()
+                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                .build()
+
+        assertThat(betaResponseTextConfig.format()).contains(BetaResponseFormatTextConfig.ofText())
+        assertThat(betaResponseTextConfig.verbosity())
+            .contains(BetaResponseTextConfig.Verbosity.LOW)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseTextConfig =
+            BetaResponseTextConfig.builder()
+                .formatText()
+                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                .build()
+
+        val roundtrippedBetaResponseTextConfig =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseTextConfig),
+                jacksonTypeRef<BetaResponseTextConfig>(),
+            )
+
+        assertThat(roundtrippedBetaResponseTextConfig).isEqualTo(betaResponseTextConfig)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseTextDeltaEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseTextDeltaEventTest.kt
new file mode 100644
index 000000000..89a3c9b56
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseTextDeltaEventTest.kt
@@ -0,0 +1,91 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseTextDeltaEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseTextDeltaEvent =
+            BetaResponseTextDeltaEvent.builder()
+                .contentIndex(0L)
+                .delta("delta")
+                .itemId("item_id")
+                .addLogprob(
+                    BetaResponseTextDeltaEvent.Logprob.builder()
+                        .token("token")
+                        .logprob(0.0)
+                        .addTopLogprob(
+                            BetaResponseTextDeltaEvent.Logprob.TopLogprob.builder()
+                                .token("token")
+                                .logprob(0.0)
+                                .build()
+                        )
+                        .build()
+                )
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(BetaResponseTextDeltaEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        assertThat(betaResponseTextDeltaEvent.contentIndex()).isEqualTo(0L)
+        assertThat(betaResponseTextDeltaEvent.delta()).isEqualTo("delta")
+        assertThat(betaResponseTextDeltaEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseTextDeltaEvent.logprobs())
+            .containsExactly(
+                BetaResponseTextDeltaEvent.Logprob.builder()
+                    .token("token")
+                    .logprob(0.0)
+                    .addTopLogprob(
+                        BetaResponseTextDeltaEvent.Logprob.TopLogprob.builder()
+                            .token("token")
+                            .logprob(0.0)
+                            .build()
+                    )
+                    .build()
+            )
+        assertThat(betaResponseTextDeltaEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseTextDeltaEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseTextDeltaEvent.agent())
+            .contains(BetaResponseTextDeltaEvent.Agent.builder().agentName("agent_name").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseTextDeltaEvent =
+            BetaResponseTextDeltaEvent.builder()
+                .contentIndex(0L)
+                .delta("delta")
+                .itemId("item_id")
+                .addLogprob(
+                    BetaResponseTextDeltaEvent.Logprob.builder()
+                        .token("token")
+                        .logprob(0.0)
+                        .addTopLogprob(
+                            BetaResponseTextDeltaEvent.Logprob.TopLogprob.builder()
+                                .token("token")
+                                .logprob(0.0)
+                                .build()
+                        )
+                        .build()
+                )
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(BetaResponseTextDeltaEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val roundtrippedBetaResponseTextDeltaEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseTextDeltaEvent),
+                jacksonTypeRef<BetaResponseTextDeltaEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseTextDeltaEvent).isEqualTo(betaResponseTextDeltaEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseTextDoneEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseTextDoneEventTest.kt
new file mode 100644
index 000000000..436cdaa35
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseTextDoneEventTest.kt
@@ -0,0 +1,91 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseTextDoneEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseTextDoneEvent =
+            BetaResponseTextDoneEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .addLogprob(
+                    BetaResponseTextDoneEvent.Logprob.builder()
+                        .token("token")
+                        .logprob(0.0)
+                        .addTopLogprob(
+                            BetaResponseTextDoneEvent.Logprob.TopLogprob.builder()
+                                .token("token")
+                                .logprob(0.0)
+                                .build()
+                        )
+                        .build()
+                )
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .text("text")
+                .agent(BetaResponseTextDoneEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        assertThat(betaResponseTextDoneEvent.contentIndex()).isEqualTo(0L)
+        assertThat(betaResponseTextDoneEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseTextDoneEvent.logprobs())
+            .containsExactly(
+                BetaResponseTextDoneEvent.Logprob.builder()
+                    .token("token")
+                    .logprob(0.0)
+                    .addTopLogprob(
+                        BetaResponseTextDoneEvent.Logprob.TopLogprob.builder()
+                            .token("token")
+                            .logprob(0.0)
+                            .build()
+                    )
+                    .build()
+            )
+        assertThat(betaResponseTextDoneEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseTextDoneEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseTextDoneEvent.text()).isEqualTo("text")
+        assertThat(betaResponseTextDoneEvent.agent())
+            .contains(BetaResponseTextDoneEvent.Agent.builder().agentName("agent_name").build())
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseTextDoneEvent =
+            BetaResponseTextDoneEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .addLogprob(
+                    BetaResponseTextDoneEvent.Logprob.builder()
+                        .token("token")
+                        .logprob(0.0)
+                        .addTopLogprob(
+                            BetaResponseTextDoneEvent.Logprob.TopLogprob.builder()
+                                .token("token")
+                                .logprob(0.0)
+                                .build()
+                        )
+                        .build()
+                )
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .text("text")
+                .agent(BetaResponseTextDoneEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val roundtrippedBetaResponseTextDoneEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseTextDoneEvent),
+                jacksonTypeRef<BetaResponseTextDoneEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseTextDoneEvent).isEqualTo(betaResponseTextDoneEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchCallTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchCallTest.kt
new file mode 100644
index 000000000..ddfc1be22
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchCallTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseToolSearchCallTest {
+
+    @Test
+    fun create() {
+        val betaResponseToolSearchCall =
+            BetaResponseToolSearchCall.builder()
+                .id("id")
+                .arguments(JsonValue.from(mapOf<String, Any>()))
+                .callId("call_id")
+                .execution(BetaResponseToolSearchCall.Execution.SERVER)
+                .status(BetaResponseToolSearchCall.Status.IN_PROGRESS)
+                .agent(BetaResponseToolSearchCall.Agent.builder().agentName("agent_name").build())
+                .createdBy("created_by")
+                .build()
+
+        assertThat(betaResponseToolSearchCall.id()).isEqualTo("id")
+        assertThat(betaResponseToolSearchCall._arguments())
+            .isEqualTo(JsonValue.from(mapOf<String, Any>()))
+        assertThat(betaResponseToolSearchCall.callId()).contains("call_id")
+        assertThat(betaResponseToolSearchCall.execution())
+            .isEqualTo(BetaResponseToolSearchCall.Execution.SERVER)
+        assertThat(betaResponseToolSearchCall.status())
+            .isEqualTo(BetaResponseToolSearchCall.Status.IN_PROGRESS)
+        assertThat(betaResponseToolSearchCall.agent())
+            .contains(BetaResponseToolSearchCall.Agent.builder().agentName("agent_name").build())
+        assertThat(betaResponseToolSearchCall.createdBy()).contains("created_by")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseToolSearchCall =
+            BetaResponseToolSearchCall.builder()
+                .id("id")
+                .arguments(JsonValue.from(mapOf<String, Any>()))
+                .callId("call_id")
+                .execution(BetaResponseToolSearchCall.Execution.SERVER)
+                .status(BetaResponseToolSearchCall.Status.IN_PROGRESS)
+                .agent(BetaResponseToolSearchCall.Agent.builder().agentName("agent_name").build())
+                .createdBy("created_by")
+                .build()
+
+        val roundtrippedBetaResponseToolSearchCall =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseToolSearchCall),
+                jacksonTypeRef<BetaResponseToolSearchCall>(),
+            )
+
+        assertThat(roundtrippedBetaResponseToolSearchCall).isEqualTo(betaResponseToolSearchCall)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItemParamTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItemParamTest.kt
new file mode 100644
index 000000000..e651463cd
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItemParamTest.kt
@@ -0,0 +1,127 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseToolSearchOutputItemParamTest {
+
+    @Test
+    fun create() {
+        val betaResponseToolSearchOutputItemParam =
+            BetaResponseToolSearchOutputItemParam.builder()
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .id("tso_123")
+                .agent(
+                    BetaResponseToolSearchOutputItemParam.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callId("x")
+                .execution(BetaResponseToolSearchOutputItemParam.Execution.SERVER)
+                .status(BetaResponseToolSearchOutputItemParam.Status.IN_PROGRESS)
+                .build()
+
+        assertThat(betaResponseToolSearchOutputItemParam.tools())
+            .containsExactly(
+                BetaTool.ofFunction(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+            )
+        assertThat(betaResponseToolSearchOutputItemParam.id()).contains("tso_123")
+        assertThat(betaResponseToolSearchOutputItemParam.agent())
+            .contains(
+                BetaResponseToolSearchOutputItemParam.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+        assertThat(betaResponseToolSearchOutputItemParam.callId()).contains("x")
+        assertThat(betaResponseToolSearchOutputItemParam.execution())
+            .contains(BetaResponseToolSearchOutputItemParam.Execution.SERVER)
+        assertThat(betaResponseToolSearchOutputItemParam.status())
+            .contains(BetaResponseToolSearchOutputItemParam.Status.IN_PROGRESS)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseToolSearchOutputItemParam =
+            BetaResponseToolSearchOutputItemParam.builder()
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .id("tso_123")
+                .agent(
+                    BetaResponseToolSearchOutputItemParam.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .callId("x")
+                .execution(BetaResponseToolSearchOutputItemParam.Execution.SERVER)
+                .status(BetaResponseToolSearchOutputItemParam.Status.IN_PROGRESS)
+                .build()
+
+        val roundtrippedBetaResponseToolSearchOutputItemParam =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseToolSearchOutputItemParam),
+                jacksonTypeRef<BetaResponseToolSearchOutputItemParam>(),
+            )
+
+        assertThat(roundtrippedBetaResponseToolSearchOutputItemParam)
+            .isEqualTo(betaResponseToolSearchOutputItemParam)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItemTest.kt
new file mode 100644
index 000000000..f2640bd52
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItemTest.kt
@@ -0,0 +1,124 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseToolSearchOutputItemTest {
+
+    @Test
+    fun create() {
+        val betaResponseToolSearchOutputItem =
+            BetaResponseToolSearchOutputItem.builder()
+                .id("id")
+                .callId("call_id")
+                .execution(BetaResponseToolSearchOutputItem.Execution.SERVER)
+                .status(BetaResponseToolSearchOutputItem.Status.IN_PROGRESS)
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .agent(
+                    BetaResponseToolSearchOutputItem.Agent.builder().agentName("agent_name").build()
+                )
+                .createdBy("created_by")
+                .build()
+
+        assertThat(betaResponseToolSearchOutputItem.id()).isEqualTo("id")
+        assertThat(betaResponseToolSearchOutputItem.callId()).contains("call_id")
+        assertThat(betaResponseToolSearchOutputItem.execution())
+            .isEqualTo(BetaResponseToolSearchOutputItem.Execution.SERVER)
+        assertThat(betaResponseToolSearchOutputItem.status())
+            .isEqualTo(BetaResponseToolSearchOutputItem.Status.IN_PROGRESS)
+        assertThat(betaResponseToolSearchOutputItem.tools())
+            .containsExactly(
+                BetaTool.ofFunction(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+            )
+        assertThat(betaResponseToolSearchOutputItem.agent())
+            .contains(
+                BetaResponseToolSearchOutputItem.Agent.builder().agentName("agent_name").build()
+            )
+        assertThat(betaResponseToolSearchOutputItem.createdBy()).contains("created_by")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseToolSearchOutputItem =
+            BetaResponseToolSearchOutputItem.builder()
+                .id("id")
+                .callId("call_id")
+                .execution(BetaResponseToolSearchOutputItem.Execution.SERVER)
+                .status(BetaResponseToolSearchOutputItem.Status.IN_PROGRESS)
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .agent(
+                    BetaResponseToolSearchOutputItem.Agent.builder().agentName("agent_name").build()
+                )
+                .createdBy("created_by")
+                .build()
+
+        val roundtrippedBetaResponseToolSearchOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseToolSearchOutputItem),
+                jacksonTypeRef<BetaResponseToolSearchOutputItem>(),
+            )
+
+        assertThat(roundtrippedBetaResponseToolSearchOutputItem)
+            .isEqualTo(betaResponseToolSearchOutputItem)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseUsageTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseUsageTest.kt
new file mode 100644
index 000000000..c829b0b1c
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseUsageTest.kt
@@ -0,0 +1,71 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseUsageTest {
+
+    @Test
+    fun create() {
+        val betaResponseUsage =
+            BetaResponseUsage.builder()
+                .inputTokens(0L)
+                .inputTokensDetails(
+                    BetaResponseUsage.InputTokensDetails.builder()
+                        .cacheWriteTokens(0L)
+                        .cachedTokens(0L)
+                        .build()
+                )
+                .outputTokens(0L)
+                .outputTokensDetails(
+                    BetaResponseUsage.OutputTokensDetails.builder().reasoningTokens(0L).build()
+                )
+                .totalTokens(0L)
+                .build()
+
+        assertThat(betaResponseUsage.inputTokens()).isEqualTo(0L)
+        assertThat(betaResponseUsage.inputTokensDetails())
+            .isEqualTo(
+                BetaResponseUsage.InputTokensDetails.builder()
+                    .cacheWriteTokens(0L)
+                    .cachedTokens(0L)
+                    .build()
+            )
+        assertThat(betaResponseUsage.outputTokens()).isEqualTo(0L)
+        assertThat(betaResponseUsage.outputTokensDetails())
+            .isEqualTo(BetaResponseUsage.OutputTokensDetails.builder().reasoningTokens(0L).build())
+        assertThat(betaResponseUsage.totalTokens()).isEqualTo(0L)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseUsage =
+            BetaResponseUsage.builder()
+                .inputTokens(0L)
+                .inputTokensDetails(
+                    BetaResponseUsage.InputTokensDetails.builder()
+                        .cacheWriteTokens(0L)
+                        .cachedTokens(0L)
+                        .build()
+                )
+                .outputTokens(0L)
+                .outputTokensDetails(
+                    BetaResponseUsage.OutputTokensDetails.builder().reasoningTokens(0L).build()
+                )
+                .totalTokens(0L)
+                .build()
+
+        val roundtrippedBetaResponseUsage =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseUsage),
+                jacksonTypeRef<BetaResponseUsage>(),
+            )
+
+        assertThat(roundtrippedBetaResponseUsage).isEqualTo(betaResponseUsage)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallCompletedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallCompletedEventTest.kt
new file mode 100644
index 000000000..de433c69c
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallCompletedEventTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseWebSearchCallCompletedEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseWebSearchCallCompletedEvent =
+            BetaResponseWebSearchCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseWebSearchCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseWebSearchCallCompletedEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseWebSearchCallCompletedEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseWebSearchCallCompletedEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseWebSearchCallCompletedEvent.agent())
+            .contains(
+                BetaResponseWebSearchCallCompletedEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseWebSearchCallCompletedEvent =
+            BetaResponseWebSearchCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseWebSearchCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseWebSearchCallCompletedEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseWebSearchCallCompletedEvent),
+                jacksonTypeRef<BetaResponseWebSearchCallCompletedEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseWebSearchCallCompletedEvent)
+            .isEqualTo(betaResponseWebSearchCallCompletedEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallInProgressEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallInProgressEventTest.kt
new file mode 100644
index 000000000..ede23b600
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallInProgressEventTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseWebSearchCallInProgressEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseWebSearchCallInProgressEvent =
+            BetaResponseWebSearchCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseWebSearchCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseWebSearchCallInProgressEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseWebSearchCallInProgressEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseWebSearchCallInProgressEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseWebSearchCallInProgressEvent.agent())
+            .contains(
+                BetaResponseWebSearchCallInProgressEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseWebSearchCallInProgressEvent =
+            BetaResponseWebSearchCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseWebSearchCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseWebSearchCallInProgressEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseWebSearchCallInProgressEvent),
+                jacksonTypeRef<BetaResponseWebSearchCallInProgressEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseWebSearchCallInProgressEvent)
+            .isEqualTo(betaResponseWebSearchCallInProgressEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallSearchingEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallSearchingEventTest.kt
new file mode 100644
index 000000000..648b58dac
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponseWebSearchCallSearchingEventTest.kt
@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseWebSearchCallSearchingEventTest {
+
+    @Test
+    fun create() {
+        val betaResponseWebSearchCallSearchingEvent =
+            BetaResponseWebSearchCallSearchingEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseWebSearchCallSearchingEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaResponseWebSearchCallSearchingEvent.itemId()).isEqualTo("item_id")
+        assertThat(betaResponseWebSearchCallSearchingEvent.outputIndex()).isEqualTo(0L)
+        assertThat(betaResponseWebSearchCallSearchingEvent.sequenceNumber()).isEqualTo(0L)
+        assertThat(betaResponseWebSearchCallSearchingEvent.agent())
+            .contains(
+                BetaResponseWebSearchCallSearchingEvent.Agent.builder()
+                    .agentName("agent_name")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseWebSearchCallSearchingEvent =
+            BetaResponseWebSearchCallSearchingEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseWebSearchCallSearchingEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaResponseWebSearchCallSearchingEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseWebSearchCallSearchingEvent),
+                jacksonTypeRef<BetaResponseWebSearchCallSearchingEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponseWebSearchCallSearchingEvent)
+            .isEqualTo(betaResponseWebSearchCallSearchingEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponsesClientEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponsesClientEventTest.kt
new file mode 100644
index 000000000..ec0fd1c69
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponsesClientEventTest.kt
@@ -0,0 +1,386 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import com.openai.errors.OpenAIInvalidDataException
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.assertThrows
+import org.junit.jupiter.params.ParameterizedTest
+import org.junit.jupiter.params.provider.EnumSource
+
+internal class BetaResponsesClientEventTest {
+
+    @Test
+    fun ofResponseCreate() {
+        val responseCreate =
+            BetaResponsesClientEvent.ResponseCreate.builder()
+                .background(true)
+                .addContextManagement(
+                    BetaResponsesClientEvent.ResponseCreate.ContextManagement.builder()
+                        .type("type")
+                        .compactThreshold(1000L)
+                        .build()
+                )
+                .conversation("string")
+                .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+                .input("string")
+                .instructions("instructions")
+                .maxOutputTokens(16L)
+                .maxToolCalls(0L)
+                .metadata(
+                    BetaResponsesClientEvent.ResponseCreate.Metadata.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                        .build()
+                )
+                .model(BetaResponsesClientEvent.ResponseCreate.Model.GPT_5_1)
+                .moderation(
+                    BetaResponsesClientEvent.ResponseCreate.Moderation.builder()
+                        .model("model")
+                        .policy(
+                            BetaResponsesClientEvent.ResponseCreate.Moderation.Policy.builder()
+                                .input(
+                                    BetaResponsesClientEvent.ResponseCreate.Moderation.Policy.Input
+                                        .builder()
+                                        .mode(
+                                            BetaResponsesClientEvent.ResponseCreate.Moderation
+                                                .Policy
+                                                .Input
+                                                .Mode
+                                                .SCORE
+                                        )
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponsesClientEvent.ResponseCreate.Moderation.Policy.Output
+                                        .builder()
+                                        .mode(
+                                            BetaResponsesClientEvent.ResponseCreate.Moderation
+                                                .Policy
+                                                .Output
+                                                .Mode
+                                                .SCORE
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .multiAgent(
+                    BetaResponsesClientEvent.ResponseCreate.MultiAgent.builder()
+                        .enabled(true)
+                        .maxConcurrentSubagents(1L)
+                        .build()
+                )
+                .parallelToolCalls(true)
+                .previousResponseId("previous_response_id")
+                .prompt(
+                    BetaResponsePrompt.builder()
+                        .id("id")
+                        .variables(
+                            BetaResponsePrompt.Variables.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .version("version")
+                        .build()
+                )
+                .promptCacheKey("prompt-cache-key-1234")
+                .promptCacheOptions(
+                    BetaResponsesClientEvent.ResponseCreate.PromptCacheOptions.builder()
+                        .mode(
+                            BetaResponsesClientEvent.ResponseCreate.PromptCacheOptions.Mode.IMPLICIT
+                        )
+                        .ttl(BetaResponsesClientEvent.ResponseCreate.PromptCacheOptions.Ttl._30M)
+                        .build()
+                )
+                .promptCacheRetention(
+                    BetaResponsesClientEvent.ResponseCreate.PromptCacheRetention.IN_MEMORY
+                )
+                .reasoning(
+                    BetaResponsesClientEvent.ResponseCreate.Reasoning.builder()
+                        .context(BetaResponsesClientEvent.ResponseCreate.Reasoning.Context.AUTO)
+                        .effort(BetaResponsesClientEvent.ResponseCreate.Reasoning.Effort.NONE)
+                        .generateSummary(
+                            BetaResponsesClientEvent.ResponseCreate.Reasoning.GenerateSummary.AUTO
+                        )
+                        .mode(BetaResponsesClientEvent.ResponseCreate.Reasoning.Mode.STANDARD)
+                        .summary(BetaResponsesClientEvent.ResponseCreate.Reasoning.Summary.AUTO)
+                        .build()
+                )
+                .safetyIdentifier("safety-identifier-1234")
+                .serviceTier(BetaResponsesClientEvent.ResponseCreate.ServiceTier.AUTO)
+                .store(true)
+                .stream(true)
+                .streamOptions(
+                    BetaResponsesClientEvent.ResponseCreate.StreamOptions.builder()
+                        .includeObfuscation(true)
+                        .build()
+                )
+                .temperature(1.0)
+                .text(
+                    BetaResponseTextConfig.builder()
+                        .formatText()
+                        .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                        .build()
+                )
+                .toolChoice(BetaToolChoiceOptions.NONE)
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .topLogprobs(0L)
+                .topP(1.0)
+                .truncation(BetaResponsesClientEvent.ResponseCreate.Truncation.AUTO)
+                .user("user-1234")
+                .build()
+
+        val betaResponsesClientEvent = BetaResponsesClientEvent.ofResponseCreate(responseCreate)
+
+        assertThat(betaResponsesClientEvent.responseCreate()).contains(responseCreate)
+        assertThat(betaResponsesClientEvent.responseInject()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCreateRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesClientEvent =
+            BetaResponsesClientEvent.ofResponseCreate(
+                BetaResponsesClientEvent.ResponseCreate.builder()
+                    .background(true)
+                    .addContextManagement(
+                        BetaResponsesClientEvent.ResponseCreate.ContextManagement.builder()
+                            .type("type")
+                            .compactThreshold(1000L)
+                            .build()
+                    )
+                    .conversation("string")
+                    .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+                    .input("string")
+                    .instructions("instructions")
+                    .maxOutputTokens(16L)
+                    .maxToolCalls(0L)
+                    .metadata(
+                        BetaResponsesClientEvent.ResponseCreate.Metadata.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                            .build()
+                    )
+                    .model(BetaResponsesClientEvent.ResponseCreate.Model.GPT_5_1)
+                    .moderation(
+                        BetaResponsesClientEvent.ResponseCreate.Moderation.builder()
+                            .model("model")
+                            .policy(
+                                BetaResponsesClientEvent.ResponseCreate.Moderation.Policy.builder()
+                                    .input(
+                                        BetaResponsesClientEvent.ResponseCreate.Moderation.Policy
+                                            .Input
+                                            .builder()
+                                            .mode(
+                                                BetaResponsesClientEvent.ResponseCreate.Moderation
+                                                    .Policy
+                                                    .Input
+                                                    .Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .output(
+                                        BetaResponsesClientEvent.ResponseCreate.Moderation.Policy
+                                            .Output
+                                            .builder()
+                                            .mode(
+                                                BetaResponsesClientEvent.ResponseCreate.Moderation
+                                                    .Policy
+                                                    .Output
+                                                    .Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .multiAgent(
+                        BetaResponsesClientEvent.ResponseCreate.MultiAgent.builder()
+                            .enabled(true)
+                            .maxConcurrentSubagents(1L)
+                            .build()
+                    )
+                    .parallelToolCalls(true)
+                    .previousResponseId("previous_response_id")
+                    .prompt(
+                        BetaResponsePrompt.builder()
+                            .id("id")
+                            .variables(
+                                BetaResponsePrompt.Variables.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .version("version")
+                            .build()
+                    )
+                    .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        BetaResponsesClientEvent.ResponseCreate.PromptCacheOptions.builder()
+                            .mode(
+                                BetaResponsesClientEvent.ResponseCreate.PromptCacheOptions.Mode
+                                    .IMPLICIT
+                            )
+                            .ttl(
+                                BetaResponsesClientEvent.ResponseCreate.PromptCacheOptions.Ttl._30M
+                            )
+                            .build()
+                    )
+                    .promptCacheRetention(
+                        BetaResponsesClientEvent.ResponseCreate.PromptCacheRetention.IN_MEMORY
+                    )
+                    .reasoning(
+                        BetaResponsesClientEvent.ResponseCreate.Reasoning.builder()
+                            .context(BetaResponsesClientEvent.ResponseCreate.Reasoning.Context.AUTO)
+                            .effort(BetaResponsesClientEvent.ResponseCreate.Reasoning.Effort.NONE)
+                            .generateSummary(
+                                BetaResponsesClientEvent.ResponseCreate.Reasoning.GenerateSummary
+                                    .AUTO
+                            )
+                            .mode(BetaResponsesClientEvent.ResponseCreate.Reasoning.Mode.STANDARD)
+                            .summary(BetaResponsesClientEvent.ResponseCreate.Reasoning.Summary.AUTO)
+                            .build()
+                    )
+                    .safetyIdentifier("safety-identifier-1234")
+                    .serviceTier(BetaResponsesClientEvent.ResponseCreate.ServiceTier.AUTO)
+                    .store(true)
+                    .stream(true)
+                    .streamOptions(
+                        BetaResponsesClientEvent.ResponseCreate.StreamOptions.builder()
+                            .includeObfuscation(true)
+                            .build()
+                    )
+                    .temperature(1.0)
+                    .text(
+                        BetaResponseTextConfig.builder()
+                            .formatText()
+                            .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                            .build()
+                    )
+                    .toolChoice(BetaToolChoiceOptions.NONE)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .topLogprobs(0L)
+                    .topP(1.0)
+                    .truncation(BetaResponsesClientEvent.ResponseCreate.Truncation.AUTO)
+                    .user("user-1234")
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesClientEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesClientEvent),
+                jacksonTypeRef<BetaResponsesClientEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesClientEvent).isEqualTo(betaResponsesClientEvent)
+    }
+
+    @Test
+    fun ofResponseInject() {
+        val responseInject =
+            BetaResponseInjectEvent.builder()
+                .addInput(
+                    BetaEasyInputMessage.builder()
+                        .content("string")
+                        .role(BetaEasyInputMessage.Role.USER)
+                        .phase(BetaEasyInputMessage.Phase.COMMENTARY)
+                        .type(BetaEasyInputMessage.Type.MESSAGE)
+                        .build()
+                )
+                .responseId("response_id")
+                .build()
+
+        val betaResponsesClientEvent = BetaResponsesClientEvent.ofResponseInject(responseInject)
+
+        assertThat(betaResponsesClientEvent.responseCreate()).isEmpty
+        assertThat(betaResponsesClientEvent.responseInject()).contains(responseInject)
+    }
+
+    @Test
+    fun ofResponseInjectRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesClientEvent =
+            BetaResponsesClientEvent.ofResponseInject(
+                BetaResponseInjectEvent.builder()
+                    .addInput(
+                        BetaEasyInputMessage.builder()
+                            .content("string")
+                            .role(BetaEasyInputMessage.Role.USER)
+                            .phase(BetaEasyInputMessage.Phase.COMMENTARY)
+                            .type(BetaEasyInputMessage.Type.MESSAGE)
+                            .build()
+                    )
+                    .responseId("response_id")
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesClientEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesClientEvent),
+                jacksonTypeRef<BetaResponsesClientEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesClientEvent).isEqualTo(betaResponsesClientEvent)
+    }
+
+    enum class IncompatibleJsonShapeTestCase(val value: JsonValue) {
+        BOOLEAN(JsonValue.from(false)),
+        STRING(JsonValue.from("invalid")),
+        INTEGER(JsonValue.from(-1)),
+        FLOAT(JsonValue.from(3.14)),
+        ARRAY(JsonValue.from(listOf("invalid", "array"))),
+    }
+
+    @ParameterizedTest
+    @EnumSource
+    fun incompatibleJsonShapeDeserializesToUnknown(testCase: IncompatibleJsonShapeTestCase) {
+        val betaResponsesClientEvent =
+            jsonMapper().convertValue(testCase.value, jacksonTypeRef<BetaResponsesClientEvent>())
+
+        val e = assertThrows<OpenAIInvalidDataException> { betaResponsesClientEvent.validate() }
+        assertThat(e).hasMessageStartingWith("Unknown ")
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponsesServerEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponsesServerEventTest.kt
new file mode 100644
index 000000000..c896d5ba4
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponsesServerEventTest.kt
@@ -0,0 +1,8501 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import com.openai.errors.OpenAIInvalidDataException
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.assertThrows
+import org.junit.jupiter.params.ParameterizedTest
+import org.junit.jupiter.params.provider.EnumSource
+
+internal class BetaResponsesServerEventTest {
+
+    @Test
+    fun ofResponseAudioDelta() {
+        val responseAudioDelta =
+            BetaResponseAudioDeltaEvent.builder()
+                .delta("delta")
+                .sequenceNumber(0L)
+                .agent(BetaResponseAudioDeltaEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseAudioDelta(responseAudioDelta)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).contains(responseAudioDelta)
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseAudioDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseAudioDelta(
+                BetaResponseAudioDeltaEvent.builder()
+                    .delta("delta")
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseAudioDeltaEvent.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseAudioDone() {
+        val responseAudioDone =
+            BetaResponseAudioDoneEvent.builder()
+                .sequenceNumber(0L)
+                .agent(BetaResponseAudioDoneEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseAudioDone(responseAudioDone)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).contains(responseAudioDone)
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseAudioDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseAudioDone(
+                BetaResponseAudioDoneEvent.builder()
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseAudioDoneEvent.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseAudioTranscriptDelta() {
+        val responseAudioTranscriptDelta =
+            BetaResponseAudioTranscriptDeltaEvent.builder()
+                .delta("delta")
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseAudioTranscriptDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseAudioTranscriptDelta(responseAudioTranscriptDelta)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta())
+            .contains(responseAudioTranscriptDelta)
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseAudioTranscriptDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseAudioTranscriptDelta(
+                BetaResponseAudioTranscriptDeltaEvent.builder()
+                    .delta("delta")
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseAudioTranscriptDeltaEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseAudioTranscriptDone() {
+        val responseAudioTranscriptDone =
+            BetaResponseAudioTranscriptDoneEvent.builder()
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseAudioTranscriptDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseAudioTranscriptDone(responseAudioTranscriptDone)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone())
+            .contains(responseAudioTranscriptDone)
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseAudioTranscriptDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseAudioTranscriptDone(
+                BetaResponseAudioTranscriptDoneEvent.builder()
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseAudioTranscriptDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallCodeDelta() {
+        val responseCodeInterpreterCallCodeDelta =
+            BetaResponseCodeInterpreterCallCodeDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallCodeDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCodeInterpreterCallCodeDelta(
+                responseCodeInterpreterCallCodeDelta
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta())
+            .contains(responseCodeInterpreterCallCodeDelta)
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallCodeDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCodeInterpreterCallCodeDelta(
+                BetaResponseCodeInterpreterCallCodeDeltaEvent.builder()
+                    .delta("delta")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseCodeInterpreterCallCodeDeltaEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallCodeDone() {
+        val responseCodeInterpreterCallCodeDone =
+            BetaResponseCodeInterpreterCallCodeDoneEvent.builder()
+                .code("code")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallCodeDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCodeInterpreterCallCodeDone(
+                responseCodeInterpreterCallCodeDone
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone())
+            .contains(responseCodeInterpreterCallCodeDone)
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallCodeDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCodeInterpreterCallCodeDone(
+                BetaResponseCodeInterpreterCallCodeDoneEvent.builder()
+                    .code("code")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseCodeInterpreterCallCodeDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallCompleted() {
+        val responseCodeInterpreterCallCompleted =
+            BetaResponseCodeInterpreterCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCodeInterpreterCallCompleted(
+                responseCodeInterpreterCallCompleted
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted())
+            .contains(responseCodeInterpreterCallCompleted)
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallCompletedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCodeInterpreterCallCompleted(
+                BetaResponseCodeInterpreterCallCompletedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseCodeInterpreterCallCompletedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallInProgress() {
+        val responseCodeInterpreterCallInProgress =
+            BetaResponseCodeInterpreterCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCodeInterpreterCallInProgress(
+                responseCodeInterpreterCallInProgress
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress())
+            .contains(responseCodeInterpreterCallInProgress)
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallInProgressRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCodeInterpreterCallInProgress(
+                BetaResponseCodeInterpreterCallInProgressEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseCodeInterpreterCallInProgressEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallInterpreting() {
+        val responseCodeInterpreterCallInterpreting =
+            BetaResponseCodeInterpreterCallInterpretingEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCodeInterpreterCallInterpretingEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCodeInterpreterCallInterpreting(
+                responseCodeInterpreterCallInterpreting
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting())
+            .contains(responseCodeInterpreterCallInterpreting)
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCodeInterpreterCallInterpretingRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCodeInterpreterCallInterpreting(
+                BetaResponseCodeInterpreterCallInterpretingEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseCodeInterpreterCallInterpretingEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseCompleted() {
+        val responseCompleted =
+            BetaResponseCompletedEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseCompletedEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCompleted(responseCompleted)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).contains(responseCompleted)
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCompletedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCompleted(
+                BetaResponseCompletedEvent.builder()
+                    .response(
+                        BetaResponse.builder()
+                            .id("id")
+                            .createdAt(0.0)
+                            .error(
+                                BetaResponseError.builder()
+                                    .code(BetaResponseError.Code.SERVER_ERROR)
+                                    .message("message")
+                                    .build()
+                            )
+                            .incompleteDetails(
+                                BetaResponse.IncompleteDetails.builder()
+                                    .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                    .build()
+                            )
+                            .instructions("string")
+                            .metadata(
+                                BetaResponse.Metadata.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .model(BetaResponse.Model.GPT_5_1)
+                            .addOutput(
+                                BetaResponseOutputMessage.builder()
+                                    .id("id")
+                                    .addContent(
+                                        BetaResponseOutputText.builder()
+                                            .addAnnotation(
+                                                BetaResponseOutputText.Annotation.FileCitation
+                                                    .builder()
+                                                    .fileId("file_id")
+                                                    .filename("filename")
+                                                    .index(0L)
+                                                    .build()
+                                            )
+                                            .text("text")
+                                            .addLogprob(
+                                                BetaResponseOutputText.Logprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .addTopLogprob(
+                                                        BetaResponseOutputText.Logprob.TopLogprob
+                                                            .builder()
+                                                            .token("token")
+                                                            .addByte(0L)
+                                                            .logprob(0.0)
+                                                            .build()
+                                                    )
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                    .agent(
+                                        BetaResponseOutputMessage.Agent.builder()
+                                            .agentName("agent_name")
+                                            .build()
+                                    )
+                                    .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                    .build()
+                            )
+                            .parallelToolCalls(true)
+                            .temperature(1.0)
+                            .toolChoice(BetaToolChoiceOptions.NONE)
+                            .addTool(
+                                BetaFunctionTool.builder()
+                                    .name("name")
+                                    .parameters(
+                                        BetaFunctionTool.Parameters.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .strict(true)
+                                    .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                    .deferLoading(true)
+                                    .description("description")
+                                    .outputSchema(
+                                        BetaFunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .topP(1.0)
+                            .background(true)
+                            .completedAt(0.0)
+                            .conversation(BetaResponse.Conversation.builder().id("id").build())
+                            .maxOutputTokens(0L)
+                            .maxToolCalls(0L)
+                            .moderation(
+                                BetaResponse.Moderation.builder()
+                                    .input(
+                                        BetaResponse.Moderation.Input.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .output(
+                                        BetaResponse.Moderation.Output.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .previousResponseId("previous_response_id")
+                            .prompt(
+                                BetaResponsePrompt.builder()
+                                    .id("id")
+                                    .variables(
+                                        BetaResponsePrompt.Variables.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                                            .build()
+                                    )
+                                    .version("version")
+                                    .build()
+                            )
+                            .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                BetaResponse.PromptCacheOptions.builder()
+                                    .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
+                            .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                            .reasoning(
+                                BetaResponse.Reasoning.builder()
+                                    .context(BetaResponse.Reasoning.Context.AUTO)
+                                    .effort(BetaResponse.Reasoning.Effort.NONE)
+                                    .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                    .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                    .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                    .build()
+                            )
+                            .safetyIdentifier("safety-identifier-1234")
+                            .serviceTier(BetaResponse.ServiceTier.AUTO)
+                            .status(BetaResponseStatus.COMPLETED)
+                            .text(
+                                BetaResponseTextConfig.builder()
+                                    .formatText()
+                                    .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                    .build()
+                            )
+                            .topLogprobs(0L)
+                            .truncation(BetaResponse.Truncation.AUTO)
+                            .usage(
+                                BetaResponseUsage.builder()
+                                    .inputTokens(0L)
+                                    .inputTokensDetails(
+                                        BetaResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
+                                            .cachedTokens(0L)
+                                            .build()
+                                    )
+                                    .outputTokens(0L)
+                                    .outputTokensDetails(
+                                        BetaResponseUsage.OutputTokensDetails.builder()
+                                            .reasoningTokens(0L)
+                                            .build()
+                                    )
+                                    .totalTokens(0L)
+                                    .build()
+                            )
+                            .user("user-1234")
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseCompletedEvent.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseContentPartAdded() {
+        val responseContentPartAdded =
+            BetaResponseContentPartAddedEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .part(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseContentPartAddedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseContentPartAdded(responseContentPartAdded)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded())
+            .contains(responseContentPartAdded)
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseContentPartAddedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseContentPartAdded(
+                BetaResponseContentPartAddedEvent.builder()
+                    .contentIndex(0L)
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .part(
+                        BetaResponseOutputText.builder()
+                            .addAnnotation(
+                                BetaResponseOutputText.Annotation.FileCitation.builder()
+                                    .fileId("file_id")
+                                    .filename("filename")
+                                    .index(0L)
+                                    .build()
+                            )
+                            .text("text")
+                            .addLogprob(
+                                BetaResponseOutputText.Logprob.builder()
+                                    .token("token")
+                                    .addByte(0L)
+                                    .logprob(0.0)
+                                    .addTopLogprob(
+                                        BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseContentPartAddedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseContentPartDone() {
+        val responseContentPartDone =
+            BetaResponseContentPartDoneEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .part(
+                    BetaResponseOutputText.builder()
+                        .addAnnotation(
+                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                .fileId("file_id")
+                                .filename("filename")
+                                .index(0L)
+                                .build()
+                        )
+                        .text("text")
+                        .addLogprob(
+                            BetaResponseOutputText.Logprob.builder()
+                                .token("token")
+                                .addByte(0L)
+                                .logprob(0.0)
+                                .addTopLogprob(
+                                    BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseContentPartDoneEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseContentPartDone(responseContentPartDone)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone())
+            .contains(responseContentPartDone)
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseContentPartDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseContentPartDone(
+                BetaResponseContentPartDoneEvent.builder()
+                    .contentIndex(0L)
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .part(
+                        BetaResponseOutputText.builder()
+                            .addAnnotation(
+                                BetaResponseOutputText.Annotation.FileCitation.builder()
+                                    .fileId("file_id")
+                                    .filename("filename")
+                                    .index(0L)
+                                    .build()
+                            )
+                            .text("text")
+                            .addLogprob(
+                                BetaResponseOutputText.Logprob.builder()
+                                    .token("token")
+                                    .addByte(0L)
+                                    .logprob(0.0)
+                                    .addTopLogprob(
+                                        BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseContentPartDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseCreated() {
+        val responseCreated =
+            BetaResponseCreatedEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseCreatedEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponsesServerEvent = BetaResponsesServerEvent.ofResponseCreated(responseCreated)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).contains(responseCreated)
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCreatedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCreated(
+                BetaResponseCreatedEvent.builder()
+                    .response(
+                        BetaResponse.builder()
+                            .id("id")
+                            .createdAt(0.0)
+                            .error(
+                                BetaResponseError.builder()
+                                    .code(BetaResponseError.Code.SERVER_ERROR)
+                                    .message("message")
+                                    .build()
+                            )
+                            .incompleteDetails(
+                                BetaResponse.IncompleteDetails.builder()
+                                    .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                    .build()
+                            )
+                            .instructions("string")
+                            .metadata(
+                                BetaResponse.Metadata.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .model(BetaResponse.Model.GPT_5_1)
+                            .addOutput(
+                                BetaResponseOutputMessage.builder()
+                                    .id("id")
+                                    .addContent(
+                                        BetaResponseOutputText.builder()
+                                            .addAnnotation(
+                                                BetaResponseOutputText.Annotation.FileCitation
+                                                    .builder()
+                                                    .fileId("file_id")
+                                                    .filename("filename")
+                                                    .index(0L)
+                                                    .build()
+                                            )
+                                            .text("text")
+                                            .addLogprob(
+                                                BetaResponseOutputText.Logprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .addTopLogprob(
+                                                        BetaResponseOutputText.Logprob.TopLogprob
+                                                            .builder()
+                                                            .token("token")
+                                                            .addByte(0L)
+                                                            .logprob(0.0)
+                                                            .build()
+                                                    )
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                    .agent(
+                                        BetaResponseOutputMessage.Agent.builder()
+                                            .agentName("agent_name")
+                                            .build()
+                                    )
+                                    .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                    .build()
+                            )
+                            .parallelToolCalls(true)
+                            .temperature(1.0)
+                            .toolChoice(BetaToolChoiceOptions.NONE)
+                            .addTool(
+                                BetaFunctionTool.builder()
+                                    .name("name")
+                                    .parameters(
+                                        BetaFunctionTool.Parameters.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .strict(true)
+                                    .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                    .deferLoading(true)
+                                    .description("description")
+                                    .outputSchema(
+                                        BetaFunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .topP(1.0)
+                            .background(true)
+                            .completedAt(0.0)
+                            .conversation(BetaResponse.Conversation.builder().id("id").build())
+                            .maxOutputTokens(0L)
+                            .maxToolCalls(0L)
+                            .moderation(
+                                BetaResponse.Moderation.builder()
+                                    .input(
+                                        BetaResponse.Moderation.Input.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .output(
+                                        BetaResponse.Moderation.Output.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .previousResponseId("previous_response_id")
+                            .prompt(
+                                BetaResponsePrompt.builder()
+                                    .id("id")
+                                    .variables(
+                                        BetaResponsePrompt.Variables.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                                            .build()
+                                    )
+                                    .version("version")
+                                    .build()
+                            )
+                            .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                BetaResponse.PromptCacheOptions.builder()
+                                    .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
+                            .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                            .reasoning(
+                                BetaResponse.Reasoning.builder()
+                                    .context(BetaResponse.Reasoning.Context.AUTO)
+                                    .effort(BetaResponse.Reasoning.Effort.NONE)
+                                    .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                    .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                    .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                    .build()
+                            )
+                            .safetyIdentifier("safety-identifier-1234")
+                            .serviceTier(BetaResponse.ServiceTier.AUTO)
+                            .status(BetaResponseStatus.COMPLETED)
+                            .text(
+                                BetaResponseTextConfig.builder()
+                                    .formatText()
+                                    .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                    .build()
+                            )
+                            .topLogprobs(0L)
+                            .truncation(BetaResponse.Truncation.AUTO)
+                            .usage(
+                                BetaResponseUsage.builder()
+                                    .inputTokens(0L)
+                                    .inputTokensDetails(
+                                        BetaResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
+                                            .cachedTokens(0L)
+                                            .build()
+                                    )
+                                    .outputTokens(0L)
+                                    .outputTokensDetails(
+                                        BetaResponseUsage.OutputTokensDetails.builder()
+                                            .reasoningTokens(0L)
+                                            .build()
+                                    )
+                                    .totalTokens(0L)
+                                    .build()
+                            )
+                            .user("user-1234")
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .agent(BetaResponseCreatedEvent.Agent.builder().agentName("agent_name").build())
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofError() {
+        val error =
+            BetaResponseErrorEvent.builder()
+                .code("code")
+                .message("message")
+                .param("param")
+                .sequenceNumber(0L)
+                .agent(BetaResponseErrorEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponsesServerEvent = BetaResponsesServerEvent.ofError(error)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).contains(error)
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofErrorRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofError(
+                BetaResponseErrorEvent.builder()
+                    .code("code")
+                    .message("message")
+                    .param("param")
+                    .sequenceNumber(0L)
+                    .agent(BetaResponseErrorEvent.Agent.builder().agentName("agent_name").build())
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseFileSearchCallCompleted() {
+        val responseFileSearchCallCompleted =
+            BetaResponseFileSearchCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFileSearchCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseFileSearchCallCompleted(
+                responseFileSearchCallCompleted
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted())
+            .contains(responseFileSearchCallCompleted)
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseFileSearchCallCompletedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseFileSearchCallCompleted(
+                BetaResponseFileSearchCallCompletedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseFileSearchCallCompletedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseFileSearchCallInProgress() {
+        val responseFileSearchCallInProgress =
+            BetaResponseFileSearchCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFileSearchCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseFileSearchCallInProgress(
+                responseFileSearchCallInProgress
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress())
+            .contains(responseFileSearchCallInProgress)
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseFileSearchCallInProgressRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseFileSearchCallInProgress(
+                BetaResponseFileSearchCallInProgressEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseFileSearchCallInProgressEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseFileSearchCallSearching() {
+        val responseFileSearchCallSearching =
+            BetaResponseFileSearchCallSearchingEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFileSearchCallSearchingEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseFileSearchCallSearching(
+                responseFileSearchCallSearching
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching())
+            .contains(responseFileSearchCallSearching)
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseFileSearchCallSearchingRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseFileSearchCallSearching(
+                BetaResponseFileSearchCallSearchingEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseFileSearchCallSearchingEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseFunctionCallArgumentsDelta() {
+        val responseFunctionCallArgumentsDelta =
+            BetaResponseFunctionCallArgumentsDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFunctionCallArgumentsDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseFunctionCallArgumentsDelta(
+                responseFunctionCallArgumentsDelta
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta())
+            .contains(responseFunctionCallArgumentsDelta)
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseFunctionCallArgumentsDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseFunctionCallArgumentsDelta(
+                BetaResponseFunctionCallArgumentsDeltaEvent.builder()
+                    .delta("delta")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseFunctionCallArgumentsDeltaEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseFunctionCallArgumentsDone() {
+        val responseFunctionCallArgumentsDone =
+            BetaResponseFunctionCallArgumentsDoneEvent.builder()
+                .arguments("arguments")
+                .itemId("item_id")
+                .name("name")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseFunctionCallArgumentsDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseFunctionCallArgumentsDone(
+                responseFunctionCallArgumentsDone
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone())
+            .contains(responseFunctionCallArgumentsDone)
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseFunctionCallArgumentsDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseFunctionCallArgumentsDone(
+                BetaResponseFunctionCallArgumentsDoneEvent.builder()
+                    .arguments("arguments")
+                    .itemId("item_id")
+                    .name("name")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseFunctionCallArgumentsDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseInProgress() {
+        val responseInProgress =
+            BetaResponseInProgressEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseInProgressEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseInProgress(responseInProgress)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).contains(responseInProgress)
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseInProgressRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseInProgress(
+                BetaResponseInProgressEvent.builder()
+                    .response(
+                        BetaResponse.builder()
+                            .id("id")
+                            .createdAt(0.0)
+                            .error(
+                                BetaResponseError.builder()
+                                    .code(BetaResponseError.Code.SERVER_ERROR)
+                                    .message("message")
+                                    .build()
+                            )
+                            .incompleteDetails(
+                                BetaResponse.IncompleteDetails.builder()
+                                    .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                    .build()
+                            )
+                            .instructions("string")
+                            .metadata(
+                                BetaResponse.Metadata.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .model(BetaResponse.Model.GPT_5_1)
+                            .addOutput(
+                                BetaResponseOutputMessage.builder()
+                                    .id("id")
+                                    .addContent(
+                                        BetaResponseOutputText.builder()
+                                            .addAnnotation(
+                                                BetaResponseOutputText.Annotation.FileCitation
+                                                    .builder()
+                                                    .fileId("file_id")
+                                                    .filename("filename")
+                                                    .index(0L)
+                                                    .build()
+                                            )
+                                            .text("text")
+                                            .addLogprob(
+                                                BetaResponseOutputText.Logprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .addTopLogprob(
+                                                        BetaResponseOutputText.Logprob.TopLogprob
+                                                            .builder()
+                                                            .token("token")
+                                                            .addByte(0L)
+                                                            .logprob(0.0)
+                                                            .build()
+                                                    )
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                    .agent(
+                                        BetaResponseOutputMessage.Agent.builder()
+                                            .agentName("agent_name")
+                                            .build()
+                                    )
+                                    .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                    .build()
+                            )
+                            .parallelToolCalls(true)
+                            .temperature(1.0)
+                            .toolChoice(BetaToolChoiceOptions.NONE)
+                            .addTool(
+                                BetaFunctionTool.builder()
+                                    .name("name")
+                                    .parameters(
+                                        BetaFunctionTool.Parameters.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .strict(true)
+                                    .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                    .deferLoading(true)
+                                    .description("description")
+                                    .outputSchema(
+                                        BetaFunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .topP(1.0)
+                            .background(true)
+                            .completedAt(0.0)
+                            .conversation(BetaResponse.Conversation.builder().id("id").build())
+                            .maxOutputTokens(0L)
+                            .maxToolCalls(0L)
+                            .moderation(
+                                BetaResponse.Moderation.builder()
+                                    .input(
+                                        BetaResponse.Moderation.Input.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .output(
+                                        BetaResponse.Moderation.Output.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .previousResponseId("previous_response_id")
+                            .prompt(
+                                BetaResponsePrompt.builder()
+                                    .id("id")
+                                    .variables(
+                                        BetaResponsePrompt.Variables.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                                            .build()
+                                    )
+                                    .version("version")
+                                    .build()
+                            )
+                            .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                BetaResponse.PromptCacheOptions.builder()
+                                    .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
+                            .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                            .reasoning(
+                                BetaResponse.Reasoning.builder()
+                                    .context(BetaResponse.Reasoning.Context.AUTO)
+                                    .effort(BetaResponse.Reasoning.Effort.NONE)
+                                    .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                    .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                    .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                    .build()
+                            )
+                            .safetyIdentifier("safety-identifier-1234")
+                            .serviceTier(BetaResponse.ServiceTier.AUTO)
+                            .status(BetaResponseStatus.COMPLETED)
+                            .text(
+                                BetaResponseTextConfig.builder()
+                                    .formatText()
+                                    .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                    .build()
+                            )
+                            .topLogprobs(0L)
+                            .truncation(BetaResponse.Truncation.AUTO)
+                            .usage(
+                                BetaResponseUsage.builder()
+                                    .inputTokens(0L)
+                                    .inputTokensDetails(
+                                        BetaResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
+                                            .cachedTokens(0L)
+                                            .build()
+                                    )
+                                    .outputTokens(0L)
+                                    .outputTokensDetails(
+                                        BetaResponseUsage.OutputTokensDetails.builder()
+                                            .reasoningTokens(0L)
+                                            .build()
+                                    )
+                                    .totalTokens(0L)
+                                    .build()
+                            )
+                            .user("user-1234")
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseInProgressEvent.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseFailed() {
+        val responseFailed =
+            BetaResponseFailedEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseFailedEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponsesServerEvent = BetaResponsesServerEvent.ofResponseFailed(responseFailed)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).contains(responseFailed)
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseFailedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseFailed(
+                BetaResponseFailedEvent.builder()
+                    .response(
+                        BetaResponse.builder()
+                            .id("id")
+                            .createdAt(0.0)
+                            .error(
+                                BetaResponseError.builder()
+                                    .code(BetaResponseError.Code.SERVER_ERROR)
+                                    .message("message")
+                                    .build()
+                            )
+                            .incompleteDetails(
+                                BetaResponse.IncompleteDetails.builder()
+                                    .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                    .build()
+                            )
+                            .instructions("string")
+                            .metadata(
+                                BetaResponse.Metadata.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .model(BetaResponse.Model.GPT_5_1)
+                            .addOutput(
+                                BetaResponseOutputMessage.builder()
+                                    .id("id")
+                                    .addContent(
+                                        BetaResponseOutputText.builder()
+                                            .addAnnotation(
+                                                BetaResponseOutputText.Annotation.FileCitation
+                                                    .builder()
+                                                    .fileId("file_id")
+                                                    .filename("filename")
+                                                    .index(0L)
+                                                    .build()
+                                            )
+                                            .text("text")
+                                            .addLogprob(
+                                                BetaResponseOutputText.Logprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .addTopLogprob(
+                                                        BetaResponseOutputText.Logprob.TopLogprob
+                                                            .builder()
+                                                            .token("token")
+                                                            .addByte(0L)
+                                                            .logprob(0.0)
+                                                            .build()
+                                                    )
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                    .agent(
+                                        BetaResponseOutputMessage.Agent.builder()
+                                            .agentName("agent_name")
+                                            .build()
+                                    )
+                                    .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                    .build()
+                            )
+                            .parallelToolCalls(true)
+                            .temperature(1.0)
+                            .toolChoice(BetaToolChoiceOptions.NONE)
+                            .addTool(
+                                BetaFunctionTool.builder()
+                                    .name("name")
+                                    .parameters(
+                                        BetaFunctionTool.Parameters.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .strict(true)
+                                    .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                    .deferLoading(true)
+                                    .description("description")
+                                    .outputSchema(
+                                        BetaFunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .topP(1.0)
+                            .background(true)
+                            .completedAt(0.0)
+                            .conversation(BetaResponse.Conversation.builder().id("id").build())
+                            .maxOutputTokens(0L)
+                            .maxToolCalls(0L)
+                            .moderation(
+                                BetaResponse.Moderation.builder()
+                                    .input(
+                                        BetaResponse.Moderation.Input.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .output(
+                                        BetaResponse.Moderation.Output.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .previousResponseId("previous_response_id")
+                            .prompt(
+                                BetaResponsePrompt.builder()
+                                    .id("id")
+                                    .variables(
+                                        BetaResponsePrompt.Variables.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                                            .build()
+                                    )
+                                    .version("version")
+                                    .build()
+                            )
+                            .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                BetaResponse.PromptCacheOptions.builder()
+                                    .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
+                            .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                            .reasoning(
+                                BetaResponse.Reasoning.builder()
+                                    .context(BetaResponse.Reasoning.Context.AUTO)
+                                    .effort(BetaResponse.Reasoning.Effort.NONE)
+                                    .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                    .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                    .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                    .build()
+                            )
+                            .safetyIdentifier("safety-identifier-1234")
+                            .serviceTier(BetaResponse.ServiceTier.AUTO)
+                            .status(BetaResponseStatus.COMPLETED)
+                            .text(
+                                BetaResponseTextConfig.builder()
+                                    .formatText()
+                                    .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                    .build()
+                            )
+                            .topLogprobs(0L)
+                            .truncation(BetaResponse.Truncation.AUTO)
+                            .usage(
+                                BetaResponseUsage.builder()
+                                    .inputTokens(0L)
+                                    .inputTokensDetails(
+                                        BetaResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
+                                            .cachedTokens(0L)
+                                            .build()
+                                    )
+                                    .outputTokens(0L)
+                                    .outputTokensDetails(
+                                        BetaResponseUsage.OutputTokensDetails.builder()
+                                            .reasoningTokens(0L)
+                                            .build()
+                                    )
+                                    .totalTokens(0L)
+                                    .build()
+                            )
+                            .user("user-1234")
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .agent(BetaResponseFailedEvent.Agent.builder().agentName("agent_name").build())
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseIncomplete() {
+        val responseIncomplete =
+            BetaResponseIncompleteEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseIncompleteEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseIncomplete(responseIncomplete)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).contains(responseIncomplete)
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseIncompleteRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseIncomplete(
+                BetaResponseIncompleteEvent.builder()
+                    .response(
+                        BetaResponse.builder()
+                            .id("id")
+                            .createdAt(0.0)
+                            .error(
+                                BetaResponseError.builder()
+                                    .code(BetaResponseError.Code.SERVER_ERROR)
+                                    .message("message")
+                                    .build()
+                            )
+                            .incompleteDetails(
+                                BetaResponse.IncompleteDetails.builder()
+                                    .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                    .build()
+                            )
+                            .instructions("string")
+                            .metadata(
+                                BetaResponse.Metadata.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .model(BetaResponse.Model.GPT_5_1)
+                            .addOutput(
+                                BetaResponseOutputMessage.builder()
+                                    .id("id")
+                                    .addContent(
+                                        BetaResponseOutputText.builder()
+                                            .addAnnotation(
+                                                BetaResponseOutputText.Annotation.FileCitation
+                                                    .builder()
+                                                    .fileId("file_id")
+                                                    .filename("filename")
+                                                    .index(0L)
+                                                    .build()
+                                            )
+                                            .text("text")
+                                            .addLogprob(
+                                                BetaResponseOutputText.Logprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .addTopLogprob(
+                                                        BetaResponseOutputText.Logprob.TopLogprob
+                                                            .builder()
+                                                            .token("token")
+                                                            .addByte(0L)
+                                                            .logprob(0.0)
+                                                            .build()
+                                                    )
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                    .agent(
+                                        BetaResponseOutputMessage.Agent.builder()
+                                            .agentName("agent_name")
+                                            .build()
+                                    )
+                                    .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                    .build()
+                            )
+                            .parallelToolCalls(true)
+                            .temperature(1.0)
+                            .toolChoice(BetaToolChoiceOptions.NONE)
+                            .addTool(
+                                BetaFunctionTool.builder()
+                                    .name("name")
+                                    .parameters(
+                                        BetaFunctionTool.Parameters.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .strict(true)
+                                    .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                    .deferLoading(true)
+                                    .description("description")
+                                    .outputSchema(
+                                        BetaFunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .topP(1.0)
+                            .background(true)
+                            .completedAt(0.0)
+                            .conversation(BetaResponse.Conversation.builder().id("id").build())
+                            .maxOutputTokens(0L)
+                            .maxToolCalls(0L)
+                            .moderation(
+                                BetaResponse.Moderation.builder()
+                                    .input(
+                                        BetaResponse.Moderation.Input.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .output(
+                                        BetaResponse.Moderation.Output.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .previousResponseId("previous_response_id")
+                            .prompt(
+                                BetaResponsePrompt.builder()
+                                    .id("id")
+                                    .variables(
+                                        BetaResponsePrompt.Variables.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                                            .build()
+                                    )
+                                    .version("version")
+                                    .build()
+                            )
+                            .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                BetaResponse.PromptCacheOptions.builder()
+                                    .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
+                            .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                            .reasoning(
+                                BetaResponse.Reasoning.builder()
+                                    .context(BetaResponse.Reasoning.Context.AUTO)
+                                    .effort(BetaResponse.Reasoning.Effort.NONE)
+                                    .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                    .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                    .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                    .build()
+                            )
+                            .safetyIdentifier("safety-identifier-1234")
+                            .serviceTier(BetaResponse.ServiceTier.AUTO)
+                            .status(BetaResponseStatus.COMPLETED)
+                            .text(
+                                BetaResponseTextConfig.builder()
+                                    .formatText()
+                                    .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                    .build()
+                            )
+                            .topLogprobs(0L)
+                            .truncation(BetaResponse.Truncation.AUTO)
+                            .usage(
+                                BetaResponseUsage.builder()
+                                    .inputTokens(0L)
+                                    .inputTokensDetails(
+                                        BetaResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
+                                            .cachedTokens(0L)
+                                            .build()
+                                    )
+                                    .outputTokens(0L)
+                                    .outputTokensDetails(
+                                        BetaResponseUsage.OutputTokensDetails.builder()
+                                            .reasoningTokens(0L)
+                                            .build()
+                                    )
+                                    .totalTokens(0L)
+                                    .build()
+                            )
+                            .user("user-1234")
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseIncompleteEvent.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseOutputItemAdded() {
+        val responseOutputItemAdded =
+            BetaResponseOutputItemAddedEvent.builder()
+                .item(
+                    BetaResponseOutputMessage.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseOutputText.builder()
+                                .addAnnotation(
+                                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                                        .fileId("file_id")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                                .text("text")
+                                .addLogprob(
+                                    BetaResponseOutputText.Logprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .addTopLogprob(
+                                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                        .agent(
+                            BetaResponseOutputMessage.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                        .build()
+                )
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseOutputItemAddedEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseOutputItemAdded(responseOutputItemAdded)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded())
+            .contains(responseOutputItemAdded)
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseOutputItemAddedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseOutputItemAdded(
+                BetaResponseOutputItemAddedEvent.builder()
+                    .item(
+                        BetaResponseOutputMessage.builder()
+                            .id("id")
+                            .addContent(
+                                BetaResponseOutputText.builder()
+                                    .addAnnotation(
+                                        BetaResponseOutputText.Annotation.FileCitation.builder()
+                                            .fileId("file_id")
+                                            .filename("filename")
+                                            .index(0L)
+                                            .build()
+                                    )
+                                    .text("text")
+                                    .addLogprob(
+                                        BetaResponseOutputText.Logprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .addTopLogprob(
+                                                BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                            .agent(
+                                BetaResponseOutputMessage.Agent.builder()
+                                    .agentName("agent_name")
+                                    .build()
+                            )
+                            .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                            .build()
+                    )
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseOutputItemAddedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseOutputItemDone() {
+        val responseOutputItemDone =
+            BetaResponseOutputItemDoneEvent.builder()
+                .item(
+                    BetaResponseOutputMessage.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseOutputText.builder()
+                                .addAnnotation(
+                                    BetaResponseOutputText.Annotation.FileCitation.builder()
+                                        .fileId("file_id")
+                                        .filename("filename")
+                                        .index(0L)
+                                        .build()
+                                )
+                                .text("text")
+                                .addLogprob(
+                                    BetaResponseOutputText.Logprob.builder()
+                                        .token("token")
+                                        .addByte(0L)
+                                        .logprob(0.0)
+                                        .addTopLogprob(
+                                            BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                        .agent(
+                            BetaResponseOutputMessage.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                        .build()
+                )
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseOutputItemDoneEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseOutputItemDone(responseOutputItemDone)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone())
+            .contains(responseOutputItemDone)
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseOutputItemDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseOutputItemDone(
+                BetaResponseOutputItemDoneEvent.builder()
+                    .item(
+                        BetaResponseOutputMessage.builder()
+                            .id("id")
+                            .addContent(
+                                BetaResponseOutputText.builder()
+                                    .addAnnotation(
+                                        BetaResponseOutputText.Annotation.FileCitation.builder()
+                                            .fileId("file_id")
+                                            .filename("filename")
+                                            .index(0L)
+                                            .build()
+                                    )
+                                    .text("text")
+                                    .addLogprob(
+                                        BetaResponseOutputText.Logprob.builder()
+                                            .token("token")
+                                            .addByte(0L)
+                                            .logprob(0.0)
+                                            .addTopLogprob(
+                                                BetaResponseOutputText.Logprob.TopLogprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                            .agent(
+                                BetaResponseOutputMessage.Agent.builder()
+                                    .agentName("agent_name")
+                                    .build()
+                            )
+                            .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                            .build()
+                    )
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseOutputItemDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseReasoningSummaryPartAdded() {
+        val responseReasoningSummaryPartAdded =
+            BetaResponseReasoningSummaryPartAddedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .part(
+                    BetaResponseReasoningSummaryPartAddedEvent.Part.builder().text("text").build()
+                )
+                .sequenceNumber(0L)
+                .summaryIndex(0L)
+                .agent(
+                    BetaResponseReasoningSummaryPartAddedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseReasoningSummaryPartAdded(
+                responseReasoningSummaryPartAdded
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded())
+            .contains(responseReasoningSummaryPartAdded)
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseReasoningSummaryPartAddedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseReasoningSummaryPartAdded(
+                BetaResponseReasoningSummaryPartAddedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .part(
+                        BetaResponseReasoningSummaryPartAddedEvent.Part.builder()
+                            .text("text")
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .summaryIndex(0L)
+                    .agent(
+                        BetaResponseReasoningSummaryPartAddedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseReasoningSummaryPartDone() {
+        val responseReasoningSummaryPartDone =
+            BetaResponseReasoningSummaryPartDoneEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .part(BetaResponseReasoningSummaryPartDoneEvent.Part.builder().text("text").build())
+                .sequenceNumber(0L)
+                .summaryIndex(0L)
+                .agent(
+                    BetaResponseReasoningSummaryPartDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .status(BetaResponseReasoningSummaryPartDoneEvent.Status.INCOMPLETE)
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseReasoningSummaryPartDone(
+                responseReasoningSummaryPartDone
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone())
+            .contains(responseReasoningSummaryPartDone)
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseReasoningSummaryPartDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseReasoningSummaryPartDone(
+                BetaResponseReasoningSummaryPartDoneEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .part(
+                        BetaResponseReasoningSummaryPartDoneEvent.Part.builder()
+                            .text("text")
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .summaryIndex(0L)
+                    .agent(
+                        BetaResponseReasoningSummaryPartDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .status(BetaResponseReasoningSummaryPartDoneEvent.Status.INCOMPLETE)
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseReasoningSummaryTextDelta() {
+        val responseReasoningSummaryTextDelta =
+            BetaResponseReasoningSummaryTextDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .summaryIndex(0L)
+                .agent(
+                    BetaResponseReasoningSummaryTextDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseReasoningSummaryTextDelta(
+                responseReasoningSummaryTextDelta
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta())
+            .contains(responseReasoningSummaryTextDelta)
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseReasoningSummaryTextDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseReasoningSummaryTextDelta(
+                BetaResponseReasoningSummaryTextDeltaEvent.builder()
+                    .delta("delta")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .summaryIndex(0L)
+                    .agent(
+                        BetaResponseReasoningSummaryTextDeltaEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseReasoningSummaryTextDone() {
+        val responseReasoningSummaryTextDone =
+            BetaResponseReasoningSummaryTextDoneEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .summaryIndex(0L)
+                .text("text")
+                .agent(
+                    BetaResponseReasoningSummaryTextDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseReasoningSummaryTextDone(
+                responseReasoningSummaryTextDone
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone())
+            .contains(responseReasoningSummaryTextDone)
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseReasoningSummaryTextDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseReasoningSummaryTextDone(
+                BetaResponseReasoningSummaryTextDoneEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .summaryIndex(0L)
+                    .text("text")
+                    .agent(
+                        BetaResponseReasoningSummaryTextDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseReasoningTextDelta() {
+        val responseReasoningTextDelta =
+            BetaResponseReasoningTextDeltaEvent.builder()
+                .contentIndex(0L)
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseReasoningTextDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseReasoningTextDelta(responseReasoningTextDelta)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta())
+            .contains(responseReasoningTextDelta)
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseReasoningTextDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseReasoningTextDelta(
+                BetaResponseReasoningTextDeltaEvent.builder()
+                    .contentIndex(0L)
+                    .delta("delta")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseReasoningTextDeltaEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseReasoningTextDone() {
+        val responseReasoningTextDone =
+            BetaResponseReasoningTextDoneEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .text("text")
+                .agent(
+                    BetaResponseReasoningTextDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseReasoningTextDone(responseReasoningTextDone)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone())
+            .contains(responseReasoningTextDone)
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseReasoningTextDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseReasoningTextDone(
+                BetaResponseReasoningTextDoneEvent.builder()
+                    .contentIndex(0L)
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .text("text")
+                    .agent(
+                        BetaResponseReasoningTextDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseRefusalDelta() {
+        val responseRefusalDelta =
+            BetaResponseRefusalDeltaEvent.builder()
+                .contentIndex(0L)
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseRefusalDeltaEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseRefusalDelta(responseRefusalDelta)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).contains(responseRefusalDelta)
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseRefusalDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseRefusalDelta(
+                BetaResponseRefusalDeltaEvent.builder()
+                    .contentIndex(0L)
+                    .delta("delta")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseRefusalDeltaEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseRefusalDone() {
+        val responseRefusalDone =
+            BetaResponseRefusalDoneEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .refusal("refusal")
+                .sequenceNumber(0L)
+                .agent(BetaResponseRefusalDoneEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseRefusalDone(responseRefusalDone)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).contains(responseRefusalDone)
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseRefusalDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseRefusalDone(
+                BetaResponseRefusalDoneEvent.builder()
+                    .contentIndex(0L)
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .refusal("refusal")
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseRefusalDoneEvent.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseOutputTextDelta() {
+        val responseOutputTextDelta =
+            BetaResponseTextDeltaEvent.builder()
+                .contentIndex(0L)
+                .delta("delta")
+                .itemId("item_id")
+                .addLogprob(
+                    BetaResponseTextDeltaEvent.Logprob.builder()
+                        .token("token")
+                        .logprob(0.0)
+                        .addTopLogprob(
+                            BetaResponseTextDeltaEvent.Logprob.TopLogprob.builder()
+                                .token("token")
+                                .logprob(0.0)
+                                .build()
+                        )
+                        .build()
+                )
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(BetaResponseTextDeltaEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseOutputTextDelta(responseOutputTextDelta)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta())
+            .contains(responseOutputTextDelta)
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseOutputTextDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseOutputTextDelta(
+                BetaResponseTextDeltaEvent.builder()
+                    .contentIndex(0L)
+                    .delta("delta")
+                    .itemId("item_id")
+                    .addLogprob(
+                        BetaResponseTextDeltaEvent.Logprob.builder()
+                            .token("token")
+                            .logprob(0.0)
+                            .addTopLogprob(
+                                BetaResponseTextDeltaEvent.Logprob.TopLogprob.builder()
+                                    .token("token")
+                                    .logprob(0.0)
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseTextDeltaEvent.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseOutputTextDone() {
+        val responseOutputTextDone =
+            BetaResponseTextDoneEvent.builder()
+                .contentIndex(0L)
+                .itemId("item_id")
+                .addLogprob(
+                    BetaResponseTextDoneEvent.Logprob.builder()
+                        .token("token")
+                        .logprob(0.0)
+                        .addTopLogprob(
+                            BetaResponseTextDoneEvent.Logprob.TopLogprob.builder()
+                                .token("token")
+                                .logprob(0.0)
+                                .build()
+                        )
+                        .build()
+                )
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .text("text")
+                .agent(BetaResponseTextDoneEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseOutputTextDone(responseOutputTextDone)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone())
+            .contains(responseOutputTextDone)
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseOutputTextDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseOutputTextDone(
+                BetaResponseTextDoneEvent.builder()
+                    .contentIndex(0L)
+                    .itemId("item_id")
+                    .addLogprob(
+                        BetaResponseTextDoneEvent.Logprob.builder()
+                            .token("token")
+                            .logprob(0.0)
+                            .addTopLogprob(
+                                BetaResponseTextDoneEvent.Logprob.TopLogprob.builder()
+                                    .token("token")
+                                    .logprob(0.0)
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .text("text")
+                    .agent(
+                        BetaResponseTextDoneEvent.Agent.builder().agentName("agent_name").build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseWebSearchCallCompleted() {
+        val responseWebSearchCallCompleted =
+            BetaResponseWebSearchCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseWebSearchCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseWebSearchCallCompleted(
+                responseWebSearchCallCompleted
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted())
+            .contains(responseWebSearchCallCompleted)
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseWebSearchCallCompletedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseWebSearchCallCompleted(
+                BetaResponseWebSearchCallCompletedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseWebSearchCallCompletedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseWebSearchCallInProgress() {
+        val responseWebSearchCallInProgress =
+            BetaResponseWebSearchCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseWebSearchCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseWebSearchCallInProgress(
+                responseWebSearchCallInProgress
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress())
+            .contains(responseWebSearchCallInProgress)
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseWebSearchCallInProgressRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseWebSearchCallInProgress(
+                BetaResponseWebSearchCallInProgressEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseWebSearchCallInProgressEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseWebSearchCallSearching() {
+        val responseWebSearchCallSearching =
+            BetaResponseWebSearchCallSearchingEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseWebSearchCallSearchingEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseWebSearchCallSearching(
+                responseWebSearchCallSearching
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching())
+            .contains(responseWebSearchCallSearching)
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseWebSearchCallSearchingRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseWebSearchCallSearching(
+                BetaResponseWebSearchCallSearchingEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseWebSearchCallSearchingEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseImageGenerationCallCompleted() {
+        val responseImageGenerationCallCompleted =
+            BetaResponseImageGenCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseImageGenCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseImageGenerationCallCompleted(
+                responseImageGenerationCallCompleted
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted())
+            .contains(responseImageGenerationCallCompleted)
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseImageGenerationCallCompletedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseImageGenerationCallCompleted(
+                BetaResponseImageGenCallCompletedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseImageGenCallCompletedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseImageGenerationCallGenerating() {
+        val responseImageGenerationCallGenerating =
+            BetaResponseImageGenCallGeneratingEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseImageGenCallGeneratingEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseImageGenerationCallGenerating(
+                responseImageGenerationCallGenerating
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating())
+            .contains(responseImageGenerationCallGenerating)
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseImageGenerationCallGeneratingRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseImageGenerationCallGenerating(
+                BetaResponseImageGenCallGeneratingEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseImageGenCallGeneratingEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseImageGenerationCallInProgress() {
+        val responseImageGenerationCallInProgress =
+            BetaResponseImageGenCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseImageGenCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseImageGenerationCallInProgress(
+                responseImageGenerationCallInProgress
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress())
+            .contains(responseImageGenerationCallInProgress)
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseImageGenerationCallInProgressRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseImageGenerationCallInProgress(
+                BetaResponseImageGenCallInProgressEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseImageGenCallInProgressEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseImageGenerationCallPartialImage() {
+        val responseImageGenerationCallPartialImage =
+            BetaResponseImageGenCallPartialImageEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .partialImageB64("partial_image_b64")
+                .partialImageIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseImageGenCallPartialImageEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseImageGenerationCallPartialImage(
+                responseImageGenerationCallPartialImage
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage())
+            .contains(responseImageGenerationCallPartialImage)
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseImageGenerationCallPartialImageRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseImageGenerationCallPartialImage(
+                BetaResponseImageGenCallPartialImageEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .partialImageB64("partial_image_b64")
+                    .partialImageIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseImageGenCallPartialImageEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseMcpCallArgumentsDelta() {
+        val responseMcpCallArgumentsDelta =
+            BetaResponseMcpCallArgumentsDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallArgumentsDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseMcpCallArgumentsDelta(responseMcpCallArgumentsDelta)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta())
+            .contains(responseMcpCallArgumentsDelta)
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseMcpCallArgumentsDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseMcpCallArgumentsDelta(
+                BetaResponseMcpCallArgumentsDeltaEvent.builder()
+                    .delta("delta")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseMcpCallArgumentsDeltaEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseMcpCallArgumentsDone() {
+        val responseMcpCallArgumentsDone =
+            BetaResponseMcpCallArgumentsDoneEvent.builder()
+                .arguments("arguments")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallArgumentsDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseMcpCallArgumentsDone(responseMcpCallArgumentsDone)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone())
+            .contains(responseMcpCallArgumentsDone)
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseMcpCallArgumentsDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseMcpCallArgumentsDone(
+                BetaResponseMcpCallArgumentsDoneEvent.builder()
+                    .arguments("arguments")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseMcpCallArgumentsDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseMcpCallCompleted() {
+        val responseMcpCallCompleted =
+            BetaResponseMcpCallCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseMcpCallCompleted(responseMcpCallCompleted)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted())
+            .contains(responseMcpCallCompleted)
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseMcpCallCompletedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseMcpCallCompleted(
+                BetaResponseMcpCallCompletedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseMcpCallCompletedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseMcpCallFailed() {
+        val responseMcpCallFailed =
+            BetaResponseMcpCallFailedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallFailedEvent.Agent.builder().agentName("agent_name").build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseMcpCallFailed(responseMcpCallFailed)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).contains(responseMcpCallFailed)
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseMcpCallFailedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseMcpCallFailed(
+                BetaResponseMcpCallFailedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseMcpCallFailedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseMcpCallInProgress() {
+        val responseMcpCallInProgress =
+            BetaResponseMcpCallInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpCallInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseMcpCallInProgress(responseMcpCallInProgress)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress())
+            .contains(responseMcpCallInProgress)
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseMcpCallInProgressRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseMcpCallInProgress(
+                BetaResponseMcpCallInProgressEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseMcpCallInProgressEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseMcpListToolsCompleted() {
+        val responseMcpListToolsCompleted =
+            BetaResponseMcpListToolsCompletedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpListToolsCompletedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseMcpListToolsCompleted(responseMcpListToolsCompleted)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted())
+            .contains(responseMcpListToolsCompleted)
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseMcpListToolsCompletedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseMcpListToolsCompleted(
+                BetaResponseMcpListToolsCompletedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseMcpListToolsCompletedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseMcpListToolsFailed() {
+        val responseMcpListToolsFailed =
+            BetaResponseMcpListToolsFailedEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpListToolsFailedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseMcpListToolsFailed(responseMcpListToolsFailed)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed())
+            .contains(responseMcpListToolsFailed)
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseMcpListToolsFailedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseMcpListToolsFailed(
+                BetaResponseMcpListToolsFailedEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseMcpListToolsFailedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseMcpListToolsInProgress() {
+        val responseMcpListToolsInProgress =
+            BetaResponseMcpListToolsInProgressEvent.builder()
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseMcpListToolsInProgressEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseMcpListToolsInProgress(
+                responseMcpListToolsInProgress
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress())
+            .contains(responseMcpListToolsInProgress)
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseMcpListToolsInProgressRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseMcpListToolsInProgress(
+                BetaResponseMcpListToolsInProgressEvent.builder()
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseMcpListToolsInProgressEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseOutputTextAnnotationAdded() {
+        val responseOutputTextAnnotationAdded =
+            BetaResponseOutputTextAnnotationAddedEvent.builder()
+                .annotation(JsonValue.from(mapOf<String, Any>()))
+                .annotationIndex(0L)
+                .contentIndex(0L)
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseOutputTextAnnotationAddedEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseOutputTextAnnotationAdded(
+                responseOutputTextAnnotationAdded
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded())
+            .contains(responseOutputTextAnnotationAdded)
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseOutputTextAnnotationAddedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseOutputTextAnnotationAdded(
+                BetaResponseOutputTextAnnotationAddedEvent.builder()
+                    .annotation(JsonValue.from(mapOf<String, Any>()))
+                    .annotationIndex(0L)
+                    .contentIndex(0L)
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseOutputTextAnnotationAddedEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseQueued() {
+        val responseQueued =
+            BetaResponseQueuedEvent.builder()
+                .response(
+                    BetaResponse.builder()
+                        .id("id")
+                        .createdAt(0.0)
+                        .error(
+                            BetaResponseError.builder()
+                                .code(BetaResponseError.Code.SERVER_ERROR)
+                                .message("message")
+                                .build()
+                        )
+                        .incompleteDetails(
+                            BetaResponse.IncompleteDetails.builder()
+                                .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                .build()
+                        )
+                        .instructions("string")
+                        .metadata(
+                            BetaResponse.Metadata.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .model(BetaResponse.Model.GPT_5_1)
+                        .addOutput(
+                            BetaResponseOutputMessage.builder()
+                                .id("id")
+                                .addContent(
+                                    BetaResponseOutputText.builder()
+                                        .addAnnotation(
+                                            BetaResponseOutputText.Annotation.FileCitation.builder()
+                                                .fileId("file_id")
+                                                .filename("filename")
+                                                .index(0L)
+                                                .build()
+                                        )
+                                        .text("text")
+                                        .addLogprob(
+                                            BetaResponseOutputText.Logprob.builder()
+                                                .token("token")
+                                                .addByte(0L)
+                                                .logprob(0.0)
+                                                .addTopLogprob(
+                                                    BetaResponseOutputText.Logprob.TopLogprob
+                                                        .builder()
+                                                        .token("token")
+                                                        .addByte(0L)
+                                                        .logprob(0.0)
+                                                        .build()
+                                                )
+                                                .build()
+                                        )
+                                        .build()
+                                )
+                                .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                .agent(
+                                    BetaResponseOutputMessage.Agent.builder()
+                                        .agentName("agent_name")
+                                        .build()
+                                )
+                                .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                .build()
+                        )
+                        .parallelToolCalls(true)
+                        .temperature(1.0)
+                        .toolChoice(BetaToolChoiceOptions.NONE)
+                        .addTool(
+                            BetaFunctionTool.builder()
+                                .name("name")
+                                .parameters(
+                                    BetaFunctionTool.Parameters.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .strict(true)
+                                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                .deferLoading(true)
+                                .description("description")
+                                .outputSchema(
+                                    BetaFunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .topP(1.0)
+                        .background(true)
+                        .completedAt(0.0)
+                        .conversation(BetaResponse.Conversation.builder().id("id").build())
+                        .maxOutputTokens(0L)
+                        .maxToolCalls(0L)
+                        .moderation(
+                            BetaResponse.Moderation.builder()
+                                .input(
+                                    BetaResponse.Moderation.Input.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Input.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .output(
+                                    BetaResponse.Moderation.Output.ModerationResult.builder()
+                                        .categories(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .Categories
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(true))
+                                                .build()
+                                        )
+                                        .categoryAppliedInputTypes(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryAppliedInputTypes
+                                                .builder()
+                                                .putAdditionalProperty(
+                                                    "foo",
+                                                    JsonValue.from(listOf("text")),
+                                                )
+                                                .build()
+                                        )
+                                        .categoryScores(
+                                            BetaResponse.Moderation.Output.ModerationResult
+                                                .CategoryScores
+                                                .builder()
+                                                .putAdditionalProperty("foo", JsonValue.from(0))
+                                                .build()
+                                        )
+                                        .flagged(true)
+                                        .model("model")
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .previousResponseId("previous_response_id")
+                        .prompt(
+                            BetaResponsePrompt.builder()
+                                .id("id")
+                                .variables(
+                                    BetaResponsePrompt.Variables.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                                        .build()
+                                )
+                                .version("version")
+                                .build()
+                        )
+                        .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            BetaResponse.PromptCacheOptions.builder()
+                                .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
+                        .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                        .reasoning(
+                            BetaResponse.Reasoning.builder()
+                                .context(BetaResponse.Reasoning.Context.AUTO)
+                                .effort(BetaResponse.Reasoning.Effort.NONE)
+                                .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                .build()
+                        )
+                        .safetyIdentifier("safety-identifier-1234")
+                        .serviceTier(BetaResponse.ServiceTier.AUTO)
+                        .status(BetaResponseStatus.COMPLETED)
+                        .text(
+                            BetaResponseTextConfig.builder()
+                                .formatText()
+                                .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                .build()
+                        )
+                        .topLogprobs(0L)
+                        .truncation(BetaResponse.Truncation.AUTO)
+                        .usage(
+                            BetaResponseUsage.builder()
+                                .inputTokens(0L)
+                                .inputTokensDetails(
+                                    BetaResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
+                                        .cachedTokens(0L)
+                                        .build()
+                                )
+                                .outputTokens(0L)
+                                .outputTokensDetails(
+                                    BetaResponseUsage.OutputTokensDetails.builder()
+                                        .reasoningTokens(0L)
+                                        .build()
+                                )
+                                .totalTokens(0L)
+                                .build()
+                        )
+                        .user("user-1234")
+                        .build()
+                )
+                .sequenceNumber(0L)
+                .agent(BetaResponseQueuedEvent.Agent.builder().agentName("agent_name").build())
+                .build()
+
+        val betaResponsesServerEvent = BetaResponsesServerEvent.ofResponseQueued(responseQueued)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).contains(responseQueued)
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseQueuedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseQueued(
+                BetaResponseQueuedEvent.builder()
+                    .response(
+                        BetaResponse.builder()
+                            .id("id")
+                            .createdAt(0.0)
+                            .error(
+                                BetaResponseError.builder()
+                                    .code(BetaResponseError.Code.SERVER_ERROR)
+                                    .message("message")
+                                    .build()
+                            )
+                            .incompleteDetails(
+                                BetaResponse.IncompleteDetails.builder()
+                                    .reason(BetaResponse.IncompleteDetails.Reason.MAX_OUTPUT_TOKENS)
+                                    .build()
+                            )
+                            .instructions("string")
+                            .metadata(
+                                BetaResponse.Metadata.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .model(BetaResponse.Model.GPT_5_1)
+                            .addOutput(
+                                BetaResponseOutputMessage.builder()
+                                    .id("id")
+                                    .addContent(
+                                        BetaResponseOutputText.builder()
+                                            .addAnnotation(
+                                                BetaResponseOutputText.Annotation.FileCitation
+                                                    .builder()
+                                                    .fileId("file_id")
+                                                    .filename("filename")
+                                                    .index(0L)
+                                                    .build()
+                                            )
+                                            .text("text")
+                                            .addLogprob(
+                                                BetaResponseOutputText.Logprob.builder()
+                                                    .token("token")
+                                                    .addByte(0L)
+                                                    .logprob(0.0)
+                                                    .addTopLogprob(
+                                                        BetaResponseOutputText.Logprob.TopLogprob
+                                                            .builder()
+                                                            .token("token")
+                                                            .addByte(0L)
+                                                            .logprob(0.0)
+                                                            .build()
+                                                    )
+                                                    .build()
+                                            )
+                                            .build()
+                                    )
+                                    .status(BetaResponseOutputMessage.Status.IN_PROGRESS)
+                                    .agent(
+                                        BetaResponseOutputMessage.Agent.builder()
+                                            .agentName("agent_name")
+                                            .build()
+                                    )
+                                    .phase(BetaResponseOutputMessage.Phase.COMMENTARY)
+                                    .build()
+                            )
+                            .parallelToolCalls(true)
+                            .temperature(1.0)
+                            .toolChoice(BetaToolChoiceOptions.NONE)
+                            .addTool(
+                                BetaFunctionTool.builder()
+                                    .name("name")
+                                    .parameters(
+                                        BetaFunctionTool.Parameters.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .strict(true)
+                                    .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                                    .deferLoading(true)
+                                    .description("description")
+                                    .outputSchema(
+                                        BetaFunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .topP(1.0)
+                            .background(true)
+                            .completedAt(0.0)
+                            .conversation(BetaResponse.Conversation.builder().id("id").build())
+                            .maxOutputTokens(0L)
+                            .maxToolCalls(0L)
+                            .moderation(
+                                BetaResponse.Moderation.builder()
+                                    .input(
+                                        BetaResponse.Moderation.Input.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Input.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .output(
+                                        BetaResponse.Moderation.Output.ModerationResult.builder()
+                                            .categories(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .Categories
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(true),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryAppliedInputTypes(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryAppliedInputTypes
+                                                    .builder()
+                                                    .putAdditionalProperty(
+                                                        "foo",
+                                                        JsonValue.from(listOf("text")),
+                                                    )
+                                                    .build()
+                                            )
+                                            .categoryScores(
+                                                BetaResponse.Moderation.Output.ModerationResult
+                                                    .CategoryScores
+                                                    .builder()
+                                                    .putAdditionalProperty("foo", JsonValue.from(0))
+                                                    .build()
+                                            )
+                                            .flagged(true)
+                                            .model("model")
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .previousResponseId("previous_response_id")
+                            .prompt(
+                                BetaResponsePrompt.builder()
+                                    .id("id")
+                                    .variables(
+                                        BetaResponsePrompt.Variables.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                                            .build()
+                                    )
+                                    .version("version")
+                                    .build()
+                            )
+                            .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                BetaResponse.PromptCacheOptions.builder()
+                                    .mode(BetaResponse.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(BetaResponse.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
+                            .promptCacheRetention(BetaResponse.PromptCacheRetention.IN_MEMORY)
+                            .reasoning(
+                                BetaResponse.Reasoning.builder()
+                                    .context(BetaResponse.Reasoning.Context.AUTO)
+                                    .effort(BetaResponse.Reasoning.Effort.NONE)
+                                    .generateSummary(BetaResponse.Reasoning.GenerateSummary.AUTO)
+                                    .mode(BetaResponse.Reasoning.Mode.STANDARD)
+                                    .summary(BetaResponse.Reasoning.Summary.AUTO)
+                                    .build()
+                            )
+                            .safetyIdentifier("safety-identifier-1234")
+                            .serviceTier(BetaResponse.ServiceTier.AUTO)
+                            .status(BetaResponseStatus.COMPLETED)
+                            .text(
+                                BetaResponseTextConfig.builder()
+                                    .formatText()
+                                    .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                                    .build()
+                            )
+                            .topLogprobs(0L)
+                            .truncation(BetaResponse.Truncation.AUTO)
+                            .usage(
+                                BetaResponseUsage.builder()
+                                    .inputTokens(0L)
+                                    .inputTokensDetails(
+                                        BetaResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
+                                            .cachedTokens(0L)
+                                            .build()
+                                    )
+                                    .outputTokens(0L)
+                                    .outputTokensDetails(
+                                        BetaResponseUsage.OutputTokensDetails.builder()
+                                            .reasoningTokens(0L)
+                                            .build()
+                                    )
+                                    .totalTokens(0L)
+                                    .build()
+                            )
+                            .user("user-1234")
+                            .build()
+                    )
+                    .sequenceNumber(0L)
+                    .agent(BetaResponseQueuedEvent.Agent.builder().agentName("agent_name").build())
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseCustomToolCallInputDelta() {
+        val responseCustomToolCallInputDelta =
+            BetaResponseCustomToolCallInputDeltaEvent.builder()
+                .delta("delta")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCustomToolCallInputDeltaEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCustomToolCallInputDelta(
+                responseCustomToolCallInputDelta
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta())
+            .contains(responseCustomToolCallInputDelta)
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCustomToolCallInputDeltaRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCustomToolCallInputDelta(
+                BetaResponseCustomToolCallInputDeltaEvent.builder()
+                    .delta("delta")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseCustomToolCallInputDeltaEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseCustomToolCallInputDone() {
+        val responseCustomToolCallInputDone =
+            BetaResponseCustomToolCallInputDoneEvent.builder()
+                .input("input")
+                .itemId("item_id")
+                .outputIndex(0L)
+                .sequenceNumber(0L)
+                .agent(
+                    BetaResponseCustomToolCallInputDoneEvent.Agent.builder()
+                        .agentName("agent_name")
+                        .build()
+                )
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCustomToolCallInputDone(
+                responseCustomToolCallInputDone
+            )
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone())
+            .contains(responseCustomToolCallInputDone)
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseCustomToolCallInputDoneRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseCustomToolCallInputDone(
+                BetaResponseCustomToolCallInputDoneEvent.builder()
+                    .input("input")
+                    .itemId("item_id")
+                    .outputIndex(0L)
+                    .sequenceNumber(0L)
+                    .agent(
+                        BetaResponseCustomToolCallInputDoneEvent.Agent.builder()
+                            .agentName("agent_name")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseInjectCreated() {
+        val responseInjectCreated =
+            BetaResponseInjectCreatedEvent.builder()
+                .responseId("response_id")
+                .sequenceNumber(0L)
+                .streamId("stream_id")
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseInjectCreated(responseInjectCreated)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).contains(responseInjectCreated)
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).isEmpty
+    }
+
+    @Test
+    fun ofResponseInjectCreatedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseInjectCreated(
+                BetaResponseInjectCreatedEvent.builder()
+                    .responseId("response_id")
+                    .sequenceNumber(0L)
+                    .streamId("stream_id")
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    @Test
+    fun ofResponseInjectFailed() {
+        val responseInjectFailed =
+            BetaResponseInjectFailedEvent.builder()
+                .error(
+                    BetaResponseInjectFailedEvent.Error.builder()
+                        .code(BetaResponseInjectFailedEvent.Error.Code.RESPONSE_ALREADY_COMPLETED)
+                        .message("message")
+                        .build()
+                )
+                .addInput(
+                    BetaEasyInputMessage.builder()
+                        .content("string")
+                        .role(BetaEasyInputMessage.Role.USER)
+                        .phase(BetaEasyInputMessage.Phase.COMMENTARY)
+                        .type(BetaEasyInputMessage.Type.MESSAGE)
+                        .build()
+                )
+                .responseId("response_id")
+                .sequenceNumber(0L)
+                .streamId("stream_id")
+                .build()
+
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseInjectFailed(responseInjectFailed)
+
+        assertThat(betaResponsesServerEvent.responseAudioDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseAudioTranscriptDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCodeDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCodeInterpreterCallInterpreting()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseContentPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.error()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFileSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFunctionCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseIncomplete()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputItemDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryPartDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningSummaryTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseReasoningTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseRefusalDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseWebSearchCallSearching()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallGenerating()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseImageGenerationCallPartialImage()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallArgumentsDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpCallInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsCompleted()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsFailed()).isEmpty
+        assertThat(betaResponsesServerEvent.responseMcpListToolsInProgress()).isEmpty
+        assertThat(betaResponsesServerEvent.responseOutputTextAnnotationAdded()).isEmpty
+        assertThat(betaResponsesServerEvent.responseQueued()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDelta()).isEmpty
+        assertThat(betaResponsesServerEvent.responseCustomToolCallInputDone()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectCreated()).isEmpty
+        assertThat(betaResponsesServerEvent.responseInjectFailed()).contains(responseInjectFailed)
+    }
+
+    @Test
+    fun ofResponseInjectFailedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponsesServerEvent =
+            BetaResponsesServerEvent.ofResponseInjectFailed(
+                BetaResponseInjectFailedEvent.builder()
+                    .error(
+                        BetaResponseInjectFailedEvent.Error.builder()
+                            .code(
+                                BetaResponseInjectFailedEvent.Error.Code.RESPONSE_ALREADY_COMPLETED
+                            )
+                            .message("message")
+                            .build()
+                    )
+                    .addInput(
+                        BetaEasyInputMessage.builder()
+                            .content("string")
+                            .role(BetaEasyInputMessage.Role.USER)
+                            .phase(BetaEasyInputMessage.Phase.COMMENTARY)
+                            .type(BetaEasyInputMessage.Type.MESSAGE)
+                            .build()
+                    )
+                    .responseId("response_id")
+                    .sequenceNumber(0L)
+                    .streamId("stream_id")
+                    .build()
+            )
+
+        val roundtrippedBetaResponsesServerEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponsesServerEvent),
+                jacksonTypeRef<BetaResponsesServerEvent>(),
+            )
+
+        assertThat(roundtrippedBetaResponsesServerEvent).isEqualTo(betaResponsesServerEvent)
+    }
+
+    enum class IncompatibleJsonShapeTestCase(val value: JsonValue) {
+        BOOLEAN(JsonValue.from(false)),
+        STRING(JsonValue.from("invalid")),
+        INTEGER(JsonValue.from(-1)),
+        FLOAT(JsonValue.from(3.14)),
+        ARRAY(JsonValue.from(listOf("invalid", "array"))),
+    }
+
+    @ParameterizedTest
+    @EnumSource
+    fun incompatibleJsonShapeDeserializesToUnknown(testCase: IncompatibleJsonShapeTestCase) {
+        val betaResponsesServerEvent =
+            jsonMapper().convertValue(testCase.value, jacksonTypeRef<BetaResponsesServerEvent>())
+
+        val e = assertThrows<OpenAIInvalidDataException> { betaResponsesServerEvent.validate() }
+        assertThat(e).hasMessageStartingWith("Unknown ")
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaSkillReferenceTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaSkillReferenceTest.kt
new file mode 100644
index 000000000..931100ef1
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaSkillReferenceTest.kt
@@ -0,0 +1,35 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaSkillReferenceTest {
+
+    @Test
+    fun create() {
+        val betaSkillReference =
+            BetaSkillReference.builder().skillId("x").version("version").build()
+
+        assertThat(betaSkillReference.skillId()).isEqualTo("x")
+        assertThat(betaSkillReference.version()).contains("version")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaSkillReference =
+            BetaSkillReference.builder().skillId("x").version("version").build()
+
+        val roundtrippedBetaSkillReference =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaSkillReference),
+                jacksonTypeRef<BetaSkillReference>(),
+            )
+
+        assertThat(roundtrippedBetaSkillReference).isEqualTo(betaSkillReference)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceAllowedTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceAllowedTest.kt
new file mode 100644
index 000000000..a813ba69d
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceAllowedTest.kt
@@ -0,0 +1,55 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaToolChoiceAllowedTest {
+
+    @Test
+    fun create() {
+        val betaToolChoiceAllowed =
+            BetaToolChoiceAllowed.builder()
+                .mode(BetaToolChoiceAllowed.Mode.AUTO)
+                .addTool(
+                    BetaToolChoiceAllowed.Tool.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                        .build()
+                )
+                .build()
+
+        assertThat(betaToolChoiceAllowed.mode()).isEqualTo(BetaToolChoiceAllowed.Mode.AUTO)
+        assertThat(betaToolChoiceAllowed.tools())
+            .containsExactly(
+                BetaToolChoiceAllowed.Tool.builder()
+                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaToolChoiceAllowed =
+            BetaToolChoiceAllowed.builder()
+                .mode(BetaToolChoiceAllowed.Mode.AUTO)
+                .addTool(
+                    BetaToolChoiceAllowed.Tool.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaToolChoiceAllowed =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaToolChoiceAllowed),
+                jacksonTypeRef<BetaToolChoiceAllowed>(),
+            )
+
+        assertThat(roundtrippedBetaToolChoiceAllowed).isEqualTo(betaToolChoiceAllowed)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceApplyPatchTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceApplyPatchTest.kt
new file mode 100644
index 000000000..ee653b67c
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceApplyPatchTest.kt
@@ -0,0 +1,30 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaToolChoiceApplyPatchTest {
+
+    @Test
+    fun create() {
+        val betaToolChoiceApplyPatch = BetaToolChoiceApplyPatch.builder().build()
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaToolChoiceApplyPatch = BetaToolChoiceApplyPatch.builder().build()
+
+        val roundtrippedBetaToolChoiceApplyPatch =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaToolChoiceApplyPatch),
+                jacksonTypeRef<BetaToolChoiceApplyPatch>(),
+            )
+
+        assertThat(roundtrippedBetaToolChoiceApplyPatch).isEqualTo(betaToolChoiceApplyPatch)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceCustomTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceCustomTest.kt
new file mode 100644
index 000000000..a2f460508
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceCustomTest.kt
@@ -0,0 +1,32 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaToolChoiceCustomTest {
+
+    @Test
+    fun create() {
+        val betaToolChoiceCustom = BetaToolChoiceCustom.builder().name("name").build()
+
+        assertThat(betaToolChoiceCustom.name()).isEqualTo("name")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaToolChoiceCustom = BetaToolChoiceCustom.builder().name("name").build()
+
+        val roundtrippedBetaToolChoiceCustom =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaToolChoiceCustom),
+                jacksonTypeRef<BetaToolChoiceCustom>(),
+            )
+
+        assertThat(roundtrippedBetaToolChoiceCustom).isEqualTo(betaToolChoiceCustom)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceFunctionTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceFunctionTest.kt
new file mode 100644
index 000000000..af236f1a9
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceFunctionTest.kt
@@ -0,0 +1,32 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaToolChoiceFunctionTest {
+
+    @Test
+    fun create() {
+        val betaToolChoiceFunction = BetaToolChoiceFunction.builder().name("name").build()
+
+        assertThat(betaToolChoiceFunction.name()).isEqualTo("name")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaToolChoiceFunction = BetaToolChoiceFunction.builder().name("name").build()
+
+        val roundtrippedBetaToolChoiceFunction =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaToolChoiceFunction),
+                jacksonTypeRef<BetaToolChoiceFunction>(),
+            )
+
+        assertThat(roundtrippedBetaToolChoiceFunction).isEqualTo(betaToolChoiceFunction)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceMcpTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceMcpTest.kt
new file mode 100644
index 000000000..30cbca84f
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceMcpTest.kt
@@ -0,0 +1,35 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaToolChoiceMcpTest {
+
+    @Test
+    fun create() {
+        val betaToolChoiceMcp =
+            BetaToolChoiceMcp.builder().serverLabel("server_label").name("name").build()
+
+        assertThat(betaToolChoiceMcp.serverLabel()).isEqualTo("server_label")
+        assertThat(betaToolChoiceMcp.name()).contains("name")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaToolChoiceMcp =
+            BetaToolChoiceMcp.builder().serverLabel("server_label").name("name").build()
+
+        val roundtrippedBetaToolChoiceMcp =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaToolChoiceMcp),
+                jacksonTypeRef<BetaToolChoiceMcp>(),
+            )
+
+        assertThat(roundtrippedBetaToolChoiceMcp).isEqualTo(betaToolChoiceMcp)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceShellTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceShellTest.kt
new file mode 100644
index 000000000..03c9fd187
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceShellTest.kt
@@ -0,0 +1,30 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaToolChoiceShellTest {
+
+    @Test
+    fun create() {
+        val betaToolChoiceShell = BetaToolChoiceShell.builder().build()
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaToolChoiceShell = BetaToolChoiceShell.builder().build()
+
+        val roundtrippedBetaToolChoiceShell =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaToolChoiceShell),
+                jacksonTypeRef<BetaToolChoiceShell>(),
+            )
+
+        assertThat(roundtrippedBetaToolChoiceShell).isEqualTo(betaToolChoiceShell)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceTypesTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceTypesTest.kt
new file mode 100644
index 000000000..7e677c1bf
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolChoiceTypesTest.kt
@@ -0,0 +1,34 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaToolChoiceTypesTest {
+
+    @Test
+    fun create() {
+        val betaToolChoiceTypes =
+            BetaToolChoiceTypes.builder().type(BetaToolChoiceTypes.Type.FILE_SEARCH).build()
+
+        assertThat(betaToolChoiceTypes.type()).isEqualTo(BetaToolChoiceTypes.Type.FILE_SEARCH)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaToolChoiceTypes =
+            BetaToolChoiceTypes.builder().type(BetaToolChoiceTypes.Type.FILE_SEARCH).build()
+
+        val roundtrippedBetaToolChoiceTypes =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaToolChoiceTypes),
+                jacksonTypeRef<BetaToolChoiceTypes>(),
+            )
+
+        assertThat(roundtrippedBetaToolChoiceTypes).isEqualTo(betaToolChoiceTypes)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolSearchToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolSearchToolTest.kt
new file mode 100644
index 000000000..acb5a09aa
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolSearchToolTest.kt
@@ -0,0 +1,45 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaToolSearchToolTest {
+
+    @Test
+    fun create() {
+        val betaToolSearchTool =
+            BetaToolSearchTool.builder()
+                .description("description")
+                .execution(BetaToolSearchTool.Execution.SERVER)
+                .parameters(JsonValue.from(mapOf<String, Any>()))
+                .build()
+
+        assertThat(betaToolSearchTool.description()).contains("description")
+        assertThat(betaToolSearchTool.execution()).contains(BetaToolSearchTool.Execution.SERVER)
+        assertThat(betaToolSearchTool._parameters()).isEqualTo(JsonValue.from(mapOf<String, Any>()))
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaToolSearchTool =
+            BetaToolSearchTool.builder()
+                .description("description")
+                .execution(BetaToolSearchTool.Execution.SERVER)
+                .parameters(JsonValue.from(mapOf<String, Any>()))
+                .build()
+
+        val roundtrippedBetaToolSearchTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaToolSearchTool),
+                jacksonTypeRef<BetaToolSearchTool>(),
+            )
+
+        assertThat(roundtrippedBetaToolSearchTool).isEqualTo(betaToolSearchTool)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolTest.kt
new file mode 100644
index 000000000..b2b387951
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaToolTest.kt
@@ -0,0 +1,980 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.JsonValue
+import com.openai.core.jsonMapper
+import com.openai.errors.OpenAIInvalidDataException
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.assertThrows
+import org.junit.jupiter.params.ParameterizedTest
+import org.junit.jupiter.params.provider.EnumSource
+
+internal class BetaToolTest {
+
+    @Test
+    fun ofFunction() {
+        val function =
+            BetaFunctionTool.builder()
+                .name("name")
+                .parameters(
+                    BetaFunctionTool.Parameters.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                        .build()
+                )
+                .strict(true)
+                .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                .deferLoading(true)
+                .description("description")
+                .outputSchema(
+                    BetaFunctionTool.OutputSchema.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                        .build()
+                )
+                .build()
+
+        val betaTool = BetaTool.ofFunction(function)
+
+        assertThat(betaTool.function()).contains(function)
+        assertThat(betaTool.fileSearch()).isEmpty
+        assertThat(betaTool.computer()).isEmpty
+        assertThat(betaTool.computerUsePreview()).isEmpty
+        assertThat(betaTool.webSearch()).isEmpty
+        assertThat(betaTool.mcp()).isEmpty
+        assertThat(betaTool.codeInterpreter()).isEmpty
+        assertThat(betaTool.programmaticToolCalling()).isEmpty
+        assertThat(betaTool.imageGeneration()).isEmpty
+        assertThat(betaTool.localShell()).isEmpty
+        assertThat(betaTool.shell()).isEmpty
+        assertThat(betaTool.custom()).isEmpty
+        assertThat(betaTool.namespace()).isEmpty
+        assertThat(betaTool.toolSearch()).isEmpty
+        assertThat(betaTool.webSearchPreview()).isEmpty
+        assertThat(betaTool.applyPatch()).isEmpty
+    }
+
+    @Test
+    fun ofFunctionRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaTool =
+            BetaTool.ofFunction(
+                BetaFunctionTool.builder()
+                    .name("name")
+                    .parameters(
+                        BetaFunctionTool.Parameters.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                            .build()
+                    )
+                    .strict(true)
+                    .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                    .deferLoading(true)
+                    .description("description")
+                    .outputSchema(
+                        BetaFunctionTool.OutputSchema.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaTool),
+                jacksonTypeRef<BetaTool>(),
+            )
+
+        assertThat(roundtrippedBetaTool).isEqualTo(betaTool)
+    }
+
+    @Test
+    fun ofFileSearch() {
+        val fileSearch =
+            BetaFileSearchTool.builder()
+                .addVectorStoreId("string")
+                .filters(
+                    BetaFileSearchTool.Filters.ComparisonFilter.builder()
+                        .key("key")
+                        .type(BetaFileSearchTool.Filters.ComparisonFilter.Type.EQ)
+                        .value("string")
+                        .build()
+                )
+                .maxNumResults(0L)
+                .rankingOptions(
+                    BetaFileSearchTool.RankingOptions.builder()
+                        .hybridSearch(
+                            BetaFileSearchTool.RankingOptions.HybridSearch.builder()
+                                .embeddingWeight(0.0)
+                                .textWeight(0.0)
+                                .build()
+                        )
+                        .ranker(BetaFileSearchTool.RankingOptions.Ranker.AUTO)
+                        .scoreThreshold(0.0)
+                        .build()
+                )
+                .build()
+
+        val betaTool = BetaTool.ofFileSearch(fileSearch)
+
+        assertThat(betaTool.function()).isEmpty
+        assertThat(betaTool.fileSearch()).contains(fileSearch)
+        assertThat(betaTool.computer()).isEmpty
+        assertThat(betaTool.computerUsePreview()).isEmpty
+        assertThat(betaTool.webSearch()).isEmpty
+        assertThat(betaTool.mcp()).isEmpty
+        assertThat(betaTool.codeInterpreter()).isEmpty
+        assertThat(betaTool.programmaticToolCalling()).isEmpty
+        assertThat(betaTool.imageGeneration()).isEmpty
+        assertThat(betaTool.localShell()).isEmpty
+        assertThat(betaTool.shell()).isEmpty
+        assertThat(betaTool.custom()).isEmpty
+        assertThat(betaTool.namespace()).isEmpty
+        assertThat(betaTool.toolSearch()).isEmpty
+        assertThat(betaTool.webSearchPreview()).isEmpty
+        assertThat(betaTool.applyPatch()).isEmpty
+    }
+
+    @Test
+    fun ofFileSearchRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaTool =
+            BetaTool.ofFileSearch(
+                BetaFileSearchTool.builder()
+                    .addVectorStoreId("string")
+                    .filters(
+                        BetaFileSearchTool.Filters.ComparisonFilter.builder()
+                            .key("key")
+                            .type(BetaFileSearchTool.Filters.ComparisonFilter.Type.EQ)
+                            .value("string")
+                            .build()
+                    )
+                    .maxNumResults(0L)
+                    .rankingOptions(
+                        BetaFileSearchTool.RankingOptions.builder()
+                            .hybridSearch(
+                                BetaFileSearchTool.RankingOptions.HybridSearch.builder()
+                                    .embeddingWeight(0.0)
+                                    .textWeight(0.0)
+                                    .build()
+                            )
+                            .ranker(BetaFileSearchTool.RankingOptions.Ranker.AUTO)
+                            .scoreThreshold(0.0)
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaTool),
+                jacksonTypeRef<BetaTool>(),
+            )
+
+        assertThat(roundtrippedBetaTool).isEqualTo(betaTool)
+    }
+
+    @Test
+    fun ofComputer() {
+        val computer = BetaComputerTool.builder().build()
+
+        val betaTool = BetaTool.ofComputer(computer)
+
+        assertThat(betaTool.function()).isEmpty
+        assertThat(betaTool.fileSearch()).isEmpty
+        assertThat(betaTool.computer()).contains(computer)
+        assertThat(betaTool.computerUsePreview()).isEmpty
+        assertThat(betaTool.webSearch()).isEmpty
+        assertThat(betaTool.mcp()).isEmpty
+        assertThat(betaTool.codeInterpreter()).isEmpty
+        assertThat(betaTool.programmaticToolCalling()).isEmpty
+        assertThat(betaTool.imageGeneration()).isEmpty
+        assertThat(betaTool.localShell()).isEmpty
+        assertThat(betaTool.shell()).isEmpty
+        assertThat(betaTool.custom()).isEmpty
+        assertThat(betaTool.namespace()).isEmpty
+        assertThat(betaTool.toolSearch()).isEmpty
+        assertThat(betaTool.webSearchPreview()).isEmpty
+        assertThat(betaTool.applyPatch()).isEmpty
+    }
+
+    @Test
+    fun ofComputerRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaTool = BetaTool.ofComputer(BetaComputerTool.builder().build())
+
+        val roundtrippedBetaTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaTool),
+                jacksonTypeRef<BetaTool>(),
+            )
+
+        assertThat(roundtrippedBetaTool).isEqualTo(betaTool)
+    }
+
+    @Test
+    fun ofComputerUsePreview() {
+        val computerUsePreview =
+            BetaComputerUsePreviewTool.builder()
+                .displayHeight(0L)
+                .displayWidth(0L)
+                .environment(BetaComputerUsePreviewTool.Environment.WINDOWS)
+                .build()
+
+        val betaTool = BetaTool.ofComputerUsePreview(computerUsePreview)
+
+        assertThat(betaTool.function()).isEmpty
+        assertThat(betaTool.fileSearch()).isEmpty
+        assertThat(betaTool.computer()).isEmpty
+        assertThat(betaTool.computerUsePreview()).contains(computerUsePreview)
+        assertThat(betaTool.webSearch()).isEmpty
+        assertThat(betaTool.mcp()).isEmpty
+        assertThat(betaTool.codeInterpreter()).isEmpty
+        assertThat(betaTool.programmaticToolCalling()).isEmpty
+        assertThat(betaTool.imageGeneration()).isEmpty
+        assertThat(betaTool.localShell()).isEmpty
+        assertThat(betaTool.shell()).isEmpty
+        assertThat(betaTool.custom()).isEmpty
+        assertThat(betaTool.namespace()).isEmpty
+        assertThat(betaTool.toolSearch()).isEmpty
+        assertThat(betaTool.webSearchPreview()).isEmpty
+        assertThat(betaTool.applyPatch()).isEmpty
+    }
+
+    @Test
+    fun ofComputerUsePreviewRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaTool =
+            BetaTool.ofComputerUsePreview(
+                BetaComputerUsePreviewTool.builder()
+                    .displayHeight(0L)
+                    .displayWidth(0L)
+                    .environment(BetaComputerUsePreviewTool.Environment.WINDOWS)
+                    .build()
+            )
+
+        val roundtrippedBetaTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaTool),
+                jacksonTypeRef<BetaTool>(),
+            )
+
+        assertThat(roundtrippedBetaTool).isEqualTo(betaTool)
+    }
+
+    @Test
+    fun ofWebSearch() {
+        val webSearch =
+            BetaWebSearchTool.builder()
+                .type(BetaWebSearchTool.Type.WEB_SEARCH)
+                .filters(BetaWebSearchTool.Filters.builder().addAllowedDomain("string").build())
+                .searchContextSize(BetaWebSearchTool.SearchContextSize.LOW)
+                .userLocation(
+                    BetaWebSearchTool.UserLocation.builder()
+                        .city("city")
+                        .country("country")
+                        .region("region")
+                        .timezone("timezone")
+                        .type(BetaWebSearchTool.UserLocation.Type.APPROXIMATE)
+                        .build()
+                )
+                .build()
+
+        val betaTool = BetaTool.ofWebSearch(webSearch)
+
+        assertThat(betaTool.function()).isEmpty
+        assertThat(betaTool.fileSearch()).isEmpty
+        assertThat(betaTool.computer()).isEmpty
+        assertThat(betaTool.computerUsePreview()).isEmpty
+        assertThat(betaTool.webSearch()).contains(webSearch)
+        assertThat(betaTool.mcp()).isEmpty
+        assertThat(betaTool.codeInterpreter()).isEmpty
+        assertThat(betaTool.programmaticToolCalling()).isEmpty
+        assertThat(betaTool.imageGeneration()).isEmpty
+        assertThat(betaTool.localShell()).isEmpty
+        assertThat(betaTool.shell()).isEmpty
+        assertThat(betaTool.custom()).isEmpty
+        assertThat(betaTool.namespace()).isEmpty
+        assertThat(betaTool.toolSearch()).isEmpty
+        assertThat(betaTool.webSearchPreview()).isEmpty
+        assertThat(betaTool.applyPatch()).isEmpty
+    }
+
+    @Test
+    fun ofWebSearchRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaTool =
+            BetaTool.ofWebSearch(
+                BetaWebSearchTool.builder()
+                    .type(BetaWebSearchTool.Type.WEB_SEARCH)
+                    .filters(BetaWebSearchTool.Filters.builder().addAllowedDomain("string").build())
+                    .searchContextSize(BetaWebSearchTool.SearchContextSize.LOW)
+                    .userLocation(
+                        BetaWebSearchTool.UserLocation.builder()
+                            .city("city")
+                            .country("country")
+                            .region("region")
+                            .timezone("timezone")
+                            .type(BetaWebSearchTool.UserLocation.Type.APPROXIMATE)
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaTool),
+                jacksonTypeRef<BetaTool>(),
+            )
+
+        assertThat(roundtrippedBetaTool).isEqualTo(betaTool)
+    }
+
+    @Test
+    fun ofMcp() {
+        val mcp =
+            BetaTool.Mcp.builder()
+                .serverLabel("server_label")
+                .addAllowedCaller(BetaTool.Mcp.AllowedCaller.DIRECT)
+                .allowedToolsOfMcp(listOf("string"))
+                .authorization("authorization")
+                .connectorId(BetaTool.Mcp.ConnectorId.CONNECTOR_DROPBOX)
+                .deferLoading(true)
+                .headers(
+                    BetaTool.Mcp.Headers.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                        .build()
+                )
+                .requireApproval(BetaTool.Mcp.RequireApproval.McpToolApprovalSetting.ALWAYS)
+                .serverDescription("server_description")
+                .serverUrl("https://example.com")
+                .tunnelId("tunnel_210b9798ad53ecc4y69z31e1071cx03v")
+                .build()
+
+        val betaTool = BetaTool.ofMcp(mcp)
+
+        assertThat(betaTool.function()).isEmpty
+        assertThat(betaTool.fileSearch()).isEmpty
+        assertThat(betaTool.computer()).isEmpty
+        assertThat(betaTool.computerUsePreview()).isEmpty
+        assertThat(betaTool.webSearch()).isEmpty
+        assertThat(betaTool.mcp()).contains(mcp)
+        assertThat(betaTool.codeInterpreter()).isEmpty
+        assertThat(betaTool.programmaticToolCalling()).isEmpty
+        assertThat(betaTool.imageGeneration()).isEmpty
+        assertThat(betaTool.localShell()).isEmpty
+        assertThat(betaTool.shell()).isEmpty
+        assertThat(betaTool.custom()).isEmpty
+        assertThat(betaTool.namespace()).isEmpty
+        assertThat(betaTool.toolSearch()).isEmpty
+        assertThat(betaTool.webSearchPreview()).isEmpty
+        assertThat(betaTool.applyPatch()).isEmpty
+    }
+
+    @Test
+    fun ofMcpRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaTool =
+            BetaTool.ofMcp(
+                BetaTool.Mcp.builder()
+                    .serverLabel("server_label")
+                    .addAllowedCaller(BetaTool.Mcp.AllowedCaller.DIRECT)
+                    .allowedToolsOfMcp(listOf("string"))
+                    .authorization("authorization")
+                    .connectorId(BetaTool.Mcp.ConnectorId.CONNECTOR_DROPBOX)
+                    .deferLoading(true)
+                    .headers(
+                        BetaTool.Mcp.Headers.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                            .build()
+                    )
+                    .requireApproval(BetaTool.Mcp.RequireApproval.McpToolApprovalSetting.ALWAYS)
+                    .serverDescription("server_description")
+                    .serverUrl("https://example.com")
+                    .tunnelId("tunnel_210b9798ad53ecc4y69z31e1071cx03v")
+                    .build()
+            )
+
+        val roundtrippedBetaTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaTool),
+                jacksonTypeRef<BetaTool>(),
+            )
+
+        assertThat(roundtrippedBetaTool).isEqualTo(betaTool)
+    }
+
+    @Test
+    fun ofCodeInterpreter() {
+        val codeInterpreter =
+            BetaTool.CodeInterpreter.builder()
+                .container("string")
+                .addAllowedCaller(BetaTool.CodeInterpreter.AllowedCaller.DIRECT)
+                .build()
+
+        val betaTool = BetaTool.ofCodeInterpreter(codeInterpreter)
+
+        assertThat(betaTool.function()).isEmpty
+        assertThat(betaTool.fileSearch()).isEmpty
+        assertThat(betaTool.computer()).isEmpty
+        assertThat(betaTool.computerUsePreview()).isEmpty
+        assertThat(betaTool.webSearch()).isEmpty
+        assertThat(betaTool.mcp()).isEmpty
+        assertThat(betaTool.codeInterpreter()).contains(codeInterpreter)
+        assertThat(betaTool.programmaticToolCalling()).isEmpty
+        assertThat(betaTool.imageGeneration()).isEmpty
+        assertThat(betaTool.localShell()).isEmpty
+        assertThat(betaTool.shell()).isEmpty
+        assertThat(betaTool.custom()).isEmpty
+        assertThat(betaTool.namespace()).isEmpty
+        assertThat(betaTool.toolSearch()).isEmpty
+        assertThat(betaTool.webSearchPreview()).isEmpty
+        assertThat(betaTool.applyPatch()).isEmpty
+    }
+
+    @Test
+    fun ofCodeInterpreterRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaTool =
+            BetaTool.ofCodeInterpreter(
+                BetaTool.CodeInterpreter.builder()
+                    .container("string")
+                    .addAllowedCaller(BetaTool.CodeInterpreter.AllowedCaller.DIRECT)
+                    .build()
+            )
+
+        val roundtrippedBetaTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaTool),
+                jacksonTypeRef<BetaTool>(),
+            )
+
+        assertThat(roundtrippedBetaTool).isEqualTo(betaTool)
+    }
+
+    @Test
+    fun ofProgrammaticToolCalling() {
+        val betaTool = BetaTool.ofProgrammaticToolCalling()
+
+        assertThat(betaTool.function()).isEmpty
+        assertThat(betaTool.fileSearch()).isEmpty
+        assertThat(betaTool.computer()).isEmpty
+        assertThat(betaTool.computerUsePreview()).isEmpty
+        assertThat(betaTool.webSearch()).isEmpty
+        assertThat(betaTool.mcp()).isEmpty
+        assertThat(betaTool.codeInterpreter()).isEmpty
+        assertThat(betaTool.programmaticToolCalling())
+            .contains(JsonValue.from(mapOf("type" to "programmatic_tool_calling")))
+        assertThat(betaTool.imageGeneration()).isEmpty
+        assertThat(betaTool.localShell()).isEmpty
+        assertThat(betaTool.shell()).isEmpty
+        assertThat(betaTool.custom()).isEmpty
+        assertThat(betaTool.namespace()).isEmpty
+        assertThat(betaTool.toolSearch()).isEmpty
+        assertThat(betaTool.webSearchPreview()).isEmpty
+        assertThat(betaTool.applyPatch()).isEmpty
+    }
+
+    @Test
+    fun ofProgrammaticToolCallingRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaTool = BetaTool.ofProgrammaticToolCalling()
+
+        val roundtrippedBetaTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaTool),
+                jacksonTypeRef<BetaTool>(),
+            )
+
+        assertThat(roundtrippedBetaTool).isEqualTo(betaTool)
+    }
+
+    @Test
+    fun ofImageGeneration() {
+        val imageGeneration =
+            BetaTool.ImageGeneration.builder()
+                .action(BetaTool.ImageGeneration.Action.GENERATE)
+                .background(BetaTool.ImageGeneration.Background.TRANSPARENT)
+                .inputFidelity(BetaTool.ImageGeneration.InputFidelity.HIGH)
+                .inputImageMask(
+                    BetaTool.ImageGeneration.InputImageMask.builder()
+                        .fileId("file_id")
+                        .imageUrl("image_url")
+                        .build()
+                )
+                .model(BetaTool.ImageGeneration.Model.GPT_IMAGE_1)
+                .moderation(BetaTool.ImageGeneration.Moderation.AUTO)
+                .outputCompression(0L)
+                .outputFormat(BetaTool.ImageGeneration.OutputFormat.PNG)
+                .partialImages(0L)
+                .quality(BetaTool.ImageGeneration.Quality.LOW)
+                .size(BetaTool.ImageGeneration.Size._1024X1024)
+                .build()
+
+        val betaTool = BetaTool.ofImageGeneration(imageGeneration)
+
+        assertThat(betaTool.function()).isEmpty
+        assertThat(betaTool.fileSearch()).isEmpty
+        assertThat(betaTool.computer()).isEmpty
+        assertThat(betaTool.computerUsePreview()).isEmpty
+        assertThat(betaTool.webSearch()).isEmpty
+        assertThat(betaTool.mcp()).isEmpty
+        assertThat(betaTool.codeInterpreter()).isEmpty
+        assertThat(betaTool.programmaticToolCalling()).isEmpty
+        assertThat(betaTool.imageGeneration()).contains(imageGeneration)
+        assertThat(betaTool.localShell()).isEmpty
+        assertThat(betaTool.shell()).isEmpty
+        assertThat(betaTool.custom()).isEmpty
+        assertThat(betaTool.namespace()).isEmpty
+        assertThat(betaTool.toolSearch()).isEmpty
+        assertThat(betaTool.webSearchPreview()).isEmpty
+        assertThat(betaTool.applyPatch()).isEmpty
+    }
+
+    @Test
+    fun ofImageGenerationRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaTool =
+            BetaTool.ofImageGeneration(
+                BetaTool.ImageGeneration.builder()
+                    .action(BetaTool.ImageGeneration.Action.GENERATE)
+                    .background(BetaTool.ImageGeneration.Background.TRANSPARENT)
+                    .inputFidelity(BetaTool.ImageGeneration.InputFidelity.HIGH)
+                    .inputImageMask(
+                        BetaTool.ImageGeneration.InputImageMask.builder()
+                            .fileId("file_id")
+                            .imageUrl("image_url")
+                            .build()
+                    )
+                    .model(BetaTool.ImageGeneration.Model.GPT_IMAGE_1)
+                    .moderation(BetaTool.ImageGeneration.Moderation.AUTO)
+                    .outputCompression(0L)
+                    .outputFormat(BetaTool.ImageGeneration.OutputFormat.PNG)
+                    .partialImages(0L)
+                    .quality(BetaTool.ImageGeneration.Quality.LOW)
+                    .size(BetaTool.ImageGeneration.Size._1024X1024)
+                    .build()
+            )
+
+        val roundtrippedBetaTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaTool),
+                jacksonTypeRef<BetaTool>(),
+            )
+
+        assertThat(roundtrippedBetaTool).isEqualTo(betaTool)
+    }
+
+    @Test
+    fun ofLocalShell() {
+        val betaTool = BetaTool.ofLocalShell()
+
+        assertThat(betaTool.function()).isEmpty
+        assertThat(betaTool.fileSearch()).isEmpty
+        assertThat(betaTool.computer()).isEmpty
+        assertThat(betaTool.computerUsePreview()).isEmpty
+        assertThat(betaTool.webSearch()).isEmpty
+        assertThat(betaTool.mcp()).isEmpty
+        assertThat(betaTool.codeInterpreter()).isEmpty
+        assertThat(betaTool.programmaticToolCalling()).isEmpty
+        assertThat(betaTool.imageGeneration()).isEmpty
+        assertThat(betaTool.localShell()).contains(JsonValue.from(mapOf("type" to "local_shell")))
+        assertThat(betaTool.shell()).isEmpty
+        assertThat(betaTool.custom()).isEmpty
+        assertThat(betaTool.namespace()).isEmpty
+        assertThat(betaTool.toolSearch()).isEmpty
+        assertThat(betaTool.webSearchPreview()).isEmpty
+        assertThat(betaTool.applyPatch()).isEmpty
+    }
+
+    @Test
+    fun ofLocalShellRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaTool = BetaTool.ofLocalShell()
+
+        val roundtrippedBetaTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaTool),
+                jacksonTypeRef<BetaTool>(),
+            )
+
+        assertThat(roundtrippedBetaTool).isEqualTo(betaTool)
+    }
+
+    @Test
+    fun ofShell() {
+        val shell =
+            BetaFunctionShellTool.builder()
+                .addAllowedCaller(BetaFunctionShellTool.AllowedCaller.DIRECT)
+                .environment(
+                    BetaContainerAuto.builder()
+                        .addFileId("file-123")
+                        .memoryLimit(BetaContainerAuto.MemoryLimit._1G)
+                        .networkPolicy(BetaContainerNetworkPolicyDisabled.builder().build())
+                        .addSkill(
+                            BetaSkillReference.builder().skillId("x").version("version").build()
+                        )
+                        .build()
+                )
+                .build()
+
+        val betaTool = BetaTool.ofShell(shell)
+
+        assertThat(betaTool.function()).isEmpty
+        assertThat(betaTool.fileSearch()).isEmpty
+        assertThat(betaTool.computer()).isEmpty
+        assertThat(betaTool.computerUsePreview()).isEmpty
+        assertThat(betaTool.webSearch()).isEmpty
+        assertThat(betaTool.mcp()).isEmpty
+        assertThat(betaTool.codeInterpreter()).isEmpty
+        assertThat(betaTool.programmaticToolCalling()).isEmpty
+        assertThat(betaTool.imageGeneration()).isEmpty
+        assertThat(betaTool.localShell()).isEmpty
+        assertThat(betaTool.shell()).contains(shell)
+        assertThat(betaTool.custom()).isEmpty
+        assertThat(betaTool.namespace()).isEmpty
+        assertThat(betaTool.toolSearch()).isEmpty
+        assertThat(betaTool.webSearchPreview()).isEmpty
+        assertThat(betaTool.applyPatch()).isEmpty
+    }
+
+    @Test
+    fun ofShellRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaTool =
+            BetaTool.ofShell(
+                BetaFunctionShellTool.builder()
+                    .addAllowedCaller(BetaFunctionShellTool.AllowedCaller.DIRECT)
+                    .environment(
+                        BetaContainerAuto.builder()
+                            .addFileId("file-123")
+                            .memoryLimit(BetaContainerAuto.MemoryLimit._1G)
+                            .networkPolicy(BetaContainerNetworkPolicyDisabled.builder().build())
+                            .addSkill(
+                                BetaSkillReference.builder().skillId("x").version("version").build()
+                            )
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaTool),
+                jacksonTypeRef<BetaTool>(),
+            )
+
+        assertThat(roundtrippedBetaTool).isEqualTo(betaTool)
+    }
+
+    @Test
+    fun ofCustom() {
+        val custom =
+            BetaCustomTool.builder()
+                .name("name")
+                .addAllowedCaller(BetaCustomTool.AllowedCaller.DIRECT)
+                .deferLoading(true)
+                .description("description")
+                .formatText()
+                .build()
+
+        val betaTool = BetaTool.ofCustom(custom)
+
+        assertThat(betaTool.function()).isEmpty
+        assertThat(betaTool.fileSearch()).isEmpty
+        assertThat(betaTool.computer()).isEmpty
+        assertThat(betaTool.computerUsePreview()).isEmpty
+        assertThat(betaTool.webSearch()).isEmpty
+        assertThat(betaTool.mcp()).isEmpty
+        assertThat(betaTool.codeInterpreter()).isEmpty
+        assertThat(betaTool.programmaticToolCalling()).isEmpty
+        assertThat(betaTool.imageGeneration()).isEmpty
+        assertThat(betaTool.localShell()).isEmpty
+        assertThat(betaTool.shell()).isEmpty
+        assertThat(betaTool.custom()).contains(custom)
+        assertThat(betaTool.namespace()).isEmpty
+        assertThat(betaTool.toolSearch()).isEmpty
+        assertThat(betaTool.webSearchPreview()).isEmpty
+        assertThat(betaTool.applyPatch()).isEmpty
+    }
+
+    @Test
+    fun ofCustomRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaTool =
+            BetaTool.ofCustom(
+                BetaCustomTool.builder()
+                    .name("name")
+                    .addAllowedCaller(BetaCustomTool.AllowedCaller.DIRECT)
+                    .deferLoading(true)
+                    .description("description")
+                    .formatText()
+                    .build()
+            )
+
+        val roundtrippedBetaTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaTool),
+                jacksonTypeRef<BetaTool>(),
+            )
+
+        assertThat(roundtrippedBetaTool).isEqualTo(betaTool)
+    }
+
+    @Test
+    fun ofNamespace() {
+        val namespace =
+            BetaNamespaceTool.builder()
+                .description("x")
+                .name("x")
+                .addTool(
+                    BetaNamespaceTool.Tool.Function.builder()
+                        .name("name")
+                        .addAllowedCaller(BetaNamespaceTool.Tool.Function.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaNamespaceTool.Tool.Function.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .parameters(JsonValue.from(mapOf<String, Any>()))
+                        .strict(true)
+                        .build()
+                )
+                .build()
+
+        val betaTool = BetaTool.ofNamespace(namespace)
+
+        assertThat(betaTool.function()).isEmpty
+        assertThat(betaTool.fileSearch()).isEmpty
+        assertThat(betaTool.computer()).isEmpty
+        assertThat(betaTool.computerUsePreview()).isEmpty
+        assertThat(betaTool.webSearch()).isEmpty
+        assertThat(betaTool.mcp()).isEmpty
+        assertThat(betaTool.codeInterpreter()).isEmpty
+        assertThat(betaTool.programmaticToolCalling()).isEmpty
+        assertThat(betaTool.imageGeneration()).isEmpty
+        assertThat(betaTool.localShell()).isEmpty
+        assertThat(betaTool.shell()).isEmpty
+        assertThat(betaTool.custom()).isEmpty
+        assertThat(betaTool.namespace()).contains(namespace)
+        assertThat(betaTool.toolSearch()).isEmpty
+        assertThat(betaTool.webSearchPreview()).isEmpty
+        assertThat(betaTool.applyPatch()).isEmpty
+    }
+
+    @Test
+    fun ofNamespaceRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaTool =
+            BetaTool.ofNamespace(
+                BetaNamespaceTool.builder()
+                    .description("x")
+                    .name("x")
+                    .addTool(
+                        BetaNamespaceTool.Tool.Function.builder()
+                            .name("name")
+                            .addAllowedCaller(BetaNamespaceTool.Tool.Function.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaNamespaceTool.Tool.Function.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .parameters(JsonValue.from(mapOf<String, Any>()))
+                            .strict(true)
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaTool),
+                jacksonTypeRef<BetaTool>(),
+            )
+
+        assertThat(roundtrippedBetaTool).isEqualTo(betaTool)
+    }
+
+    @Test
+    fun ofToolSearch() {
+        val toolSearch =
+            BetaToolSearchTool.builder()
+                .description("description")
+                .execution(BetaToolSearchTool.Execution.SERVER)
+                .parameters(JsonValue.from(mapOf<String, Any>()))
+                .build()
+
+        val betaTool = BetaTool.ofToolSearch(toolSearch)
+
+        assertThat(betaTool.function()).isEmpty
+        assertThat(betaTool.fileSearch()).isEmpty
+        assertThat(betaTool.computer()).isEmpty
+        assertThat(betaTool.computerUsePreview()).isEmpty
+        assertThat(betaTool.webSearch()).isEmpty
+        assertThat(betaTool.mcp()).isEmpty
+        assertThat(betaTool.codeInterpreter()).isEmpty
+        assertThat(betaTool.programmaticToolCalling()).isEmpty
+        assertThat(betaTool.imageGeneration()).isEmpty
+        assertThat(betaTool.localShell()).isEmpty
+        assertThat(betaTool.shell()).isEmpty
+        assertThat(betaTool.custom()).isEmpty
+        assertThat(betaTool.namespace()).isEmpty
+        assertThat(betaTool.toolSearch()).contains(toolSearch)
+        assertThat(betaTool.webSearchPreview()).isEmpty
+        assertThat(betaTool.applyPatch()).isEmpty
+    }
+
+    @Test
+    fun ofToolSearchRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaTool =
+            BetaTool.ofToolSearch(
+                BetaToolSearchTool.builder()
+                    .description("description")
+                    .execution(BetaToolSearchTool.Execution.SERVER)
+                    .parameters(JsonValue.from(mapOf<String, Any>()))
+                    .build()
+            )
+
+        val roundtrippedBetaTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaTool),
+                jacksonTypeRef<BetaTool>(),
+            )
+
+        assertThat(roundtrippedBetaTool).isEqualTo(betaTool)
+    }
+
+    @Test
+    fun ofWebSearchPreview() {
+        val webSearchPreview =
+            BetaWebSearchPreviewTool.builder()
+                .type(BetaWebSearchPreviewTool.Type.WEB_SEARCH_PREVIEW)
+                .addSearchContentType(BetaWebSearchPreviewTool.SearchContentType.TEXT)
+                .searchContextSize(BetaWebSearchPreviewTool.SearchContextSize.LOW)
+                .userLocation(
+                    BetaWebSearchPreviewTool.UserLocation.builder()
+                        .city("city")
+                        .country("country")
+                        .region("region")
+                        .timezone("timezone")
+                        .build()
+                )
+                .build()
+
+        val betaTool = BetaTool.ofWebSearchPreview(webSearchPreview)
+
+        assertThat(betaTool.function()).isEmpty
+        assertThat(betaTool.fileSearch()).isEmpty
+        assertThat(betaTool.computer()).isEmpty
+        assertThat(betaTool.computerUsePreview()).isEmpty
+        assertThat(betaTool.webSearch()).isEmpty
+        assertThat(betaTool.mcp()).isEmpty
+        assertThat(betaTool.codeInterpreter()).isEmpty
+        assertThat(betaTool.programmaticToolCalling()).isEmpty
+        assertThat(betaTool.imageGeneration()).isEmpty
+        assertThat(betaTool.localShell()).isEmpty
+        assertThat(betaTool.shell()).isEmpty
+        assertThat(betaTool.custom()).isEmpty
+        assertThat(betaTool.namespace()).isEmpty
+        assertThat(betaTool.toolSearch()).isEmpty
+        assertThat(betaTool.webSearchPreview()).contains(webSearchPreview)
+        assertThat(betaTool.applyPatch()).isEmpty
+    }
+
+    @Test
+    fun ofWebSearchPreviewRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaTool =
+            BetaTool.ofWebSearchPreview(
+                BetaWebSearchPreviewTool.builder()
+                    .type(BetaWebSearchPreviewTool.Type.WEB_SEARCH_PREVIEW)
+                    .addSearchContentType(BetaWebSearchPreviewTool.SearchContentType.TEXT)
+                    .searchContextSize(BetaWebSearchPreviewTool.SearchContextSize.LOW)
+                    .userLocation(
+                        BetaWebSearchPreviewTool.UserLocation.builder()
+                            .city("city")
+                            .country("country")
+                            .region("region")
+                            .timezone("timezone")
+                            .build()
+                    )
+                    .build()
+            )
+
+        val roundtrippedBetaTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaTool),
+                jacksonTypeRef<BetaTool>(),
+            )
+
+        assertThat(roundtrippedBetaTool).isEqualTo(betaTool)
+    }
+
+    @Test
+    fun ofApplyPatch() {
+        val applyPatch =
+            BetaApplyPatchTool.builder()
+                .addAllowedCaller(BetaApplyPatchTool.AllowedCaller.DIRECT)
+                .build()
+
+        val betaTool = BetaTool.ofApplyPatch(applyPatch)
+
+        assertThat(betaTool.function()).isEmpty
+        assertThat(betaTool.fileSearch()).isEmpty
+        assertThat(betaTool.computer()).isEmpty
+        assertThat(betaTool.computerUsePreview()).isEmpty
+        assertThat(betaTool.webSearch()).isEmpty
+        assertThat(betaTool.mcp()).isEmpty
+        assertThat(betaTool.codeInterpreter()).isEmpty
+        assertThat(betaTool.programmaticToolCalling()).isEmpty
+        assertThat(betaTool.imageGeneration()).isEmpty
+        assertThat(betaTool.localShell()).isEmpty
+        assertThat(betaTool.shell()).isEmpty
+        assertThat(betaTool.custom()).isEmpty
+        assertThat(betaTool.namespace()).isEmpty
+        assertThat(betaTool.toolSearch()).isEmpty
+        assertThat(betaTool.webSearchPreview()).isEmpty
+        assertThat(betaTool.applyPatch()).contains(applyPatch)
+    }
+
+    @Test
+    fun ofApplyPatchRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaTool =
+            BetaTool.ofApplyPatch(
+                BetaApplyPatchTool.builder()
+                    .addAllowedCaller(BetaApplyPatchTool.AllowedCaller.DIRECT)
+                    .build()
+            )
+
+        val roundtrippedBetaTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaTool),
+                jacksonTypeRef<BetaTool>(),
+            )
+
+        assertThat(roundtrippedBetaTool).isEqualTo(betaTool)
+    }
+
+    enum class IncompatibleJsonShapeTestCase(val value: JsonValue) {
+        BOOLEAN(JsonValue.from(false)),
+        STRING(JsonValue.from("invalid")),
+        INTEGER(JsonValue.from(-1)),
+        FLOAT(JsonValue.from(3.14)),
+        ARRAY(JsonValue.from(listOf("invalid", "array"))),
+    }
+
+    @ParameterizedTest
+    @EnumSource
+    fun incompatibleJsonShapeDeserializesToUnknown(testCase: IncompatibleJsonShapeTestCase) {
+        val betaTool = jsonMapper().convertValue(testCase.value, jacksonTypeRef<BetaTool>())
+
+        val e = assertThrows<OpenAIInvalidDataException> { betaTool.validate() }
+        assertThat(e).hasMessageStartingWith("Unknown ")
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaWebSearchPreviewToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaWebSearchPreviewToolTest.kt
new file mode 100644
index 000000000..e23938934
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaWebSearchPreviewToolTest.kt
@@ -0,0 +1,73 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaWebSearchPreviewToolTest {
+
+    @Test
+    fun create() {
+        val betaWebSearchPreviewTool =
+            BetaWebSearchPreviewTool.builder()
+                .type(BetaWebSearchPreviewTool.Type.WEB_SEARCH_PREVIEW)
+                .addSearchContentType(BetaWebSearchPreviewTool.SearchContentType.TEXT)
+                .searchContextSize(BetaWebSearchPreviewTool.SearchContextSize.LOW)
+                .userLocation(
+                    BetaWebSearchPreviewTool.UserLocation.builder()
+                        .city("city")
+                        .country("country")
+                        .region("region")
+                        .timezone("timezone")
+                        .build()
+                )
+                .build()
+
+        assertThat(betaWebSearchPreviewTool.type())
+            .isEqualTo(BetaWebSearchPreviewTool.Type.WEB_SEARCH_PREVIEW)
+        assertThat(betaWebSearchPreviewTool.searchContentTypes().getOrNull())
+            .containsExactly(BetaWebSearchPreviewTool.SearchContentType.TEXT)
+        assertThat(betaWebSearchPreviewTool.searchContextSize())
+            .contains(BetaWebSearchPreviewTool.SearchContextSize.LOW)
+        assertThat(betaWebSearchPreviewTool.userLocation())
+            .contains(
+                BetaWebSearchPreviewTool.UserLocation.builder()
+                    .city("city")
+                    .country("country")
+                    .region("region")
+                    .timezone("timezone")
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaWebSearchPreviewTool =
+            BetaWebSearchPreviewTool.builder()
+                .type(BetaWebSearchPreviewTool.Type.WEB_SEARCH_PREVIEW)
+                .addSearchContentType(BetaWebSearchPreviewTool.SearchContentType.TEXT)
+                .searchContextSize(BetaWebSearchPreviewTool.SearchContextSize.LOW)
+                .userLocation(
+                    BetaWebSearchPreviewTool.UserLocation.builder()
+                        .city("city")
+                        .country("country")
+                        .region("region")
+                        .timezone("timezone")
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaWebSearchPreviewTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaWebSearchPreviewTool),
+                jacksonTypeRef<BetaWebSearchPreviewTool>(),
+            )
+
+        assertThat(roundtrippedBetaWebSearchPreviewTool).isEqualTo(betaWebSearchPreviewTool)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaWebSearchToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaWebSearchToolTest.kt
new file mode 100644
index 000000000..5fe921778
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaWebSearchToolTest.kt
@@ -0,0 +1,74 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaWebSearchToolTest {
+
+    @Test
+    fun create() {
+        val betaWebSearchTool =
+            BetaWebSearchTool.builder()
+                .type(BetaWebSearchTool.Type.WEB_SEARCH)
+                .filters(BetaWebSearchTool.Filters.builder().addAllowedDomain("string").build())
+                .searchContextSize(BetaWebSearchTool.SearchContextSize.LOW)
+                .userLocation(
+                    BetaWebSearchTool.UserLocation.builder()
+                        .city("city")
+                        .country("country")
+                        .region("region")
+                        .timezone("timezone")
+                        .type(BetaWebSearchTool.UserLocation.Type.APPROXIMATE)
+                        .build()
+                )
+                .build()
+
+        assertThat(betaWebSearchTool.type()).isEqualTo(BetaWebSearchTool.Type.WEB_SEARCH)
+        assertThat(betaWebSearchTool.filters())
+            .contains(BetaWebSearchTool.Filters.builder().addAllowedDomain("string").build())
+        assertThat(betaWebSearchTool.searchContextSize())
+            .contains(BetaWebSearchTool.SearchContextSize.LOW)
+        assertThat(betaWebSearchTool.userLocation())
+            .contains(
+                BetaWebSearchTool.UserLocation.builder()
+                    .city("city")
+                    .country("country")
+                    .region("region")
+                    .timezone("timezone")
+                    .type(BetaWebSearchTool.UserLocation.Type.APPROXIMATE)
+                    .build()
+            )
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaWebSearchTool =
+            BetaWebSearchTool.builder()
+                .type(BetaWebSearchTool.Type.WEB_SEARCH)
+                .filters(BetaWebSearchTool.Filters.builder().addAllowedDomain("string").build())
+                .searchContextSize(BetaWebSearchTool.SearchContextSize.LOW)
+                .userLocation(
+                    BetaWebSearchTool.UserLocation.builder()
+                        .city("city")
+                        .country("country")
+                        .region("region")
+                        .timezone("timezone")
+                        .type(BetaWebSearchTool.UserLocation.Type.APPROXIMATE)
+                        .build()
+                )
+                .build()
+
+        val roundtrippedBetaWebSearchTool =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaWebSearchTool),
+                jacksonTypeRef<BetaWebSearchTool>(),
+            )
+
+        assertThat(roundtrippedBetaWebSearchTool).isEqualTo(betaWebSearchTool)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseCancelParamsTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseCancelParamsTest.kt
new file mode 100644
index 000000000..c275e5436
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseCancelParamsTest.kt
@@ -0,0 +1,56 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.openai.core.http.Headers
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ResponseCancelParamsTest {
+
+    @Test
+    fun create() {
+        ResponseCancelParams.builder()
+            .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+            .addBeta(ResponseCancelParams.Beta.RESPONSES_MULTI_AGENT_V1)
+            .build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params =
+            ResponseCancelParams.builder()
+                .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                .build()
+
+        assertThat(params._pathParam(0)).isEqualTo("resp_677efb5139a88190b512bc3fef8e535d")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun headers() {
+        val params =
+            ResponseCancelParams.builder()
+                .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                .addBeta(ResponseCancelParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                .build()
+
+        val headers = params._headers()
+
+        assertThat(headers)
+            .isEqualTo(Headers.builder().put("openai-beta", "responses_multi_agent=v1").build())
+    }
+
+    @Test
+    fun headersWithoutOptionalFields() {
+        val params =
+            ResponseCancelParams.builder()
+                .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                .build()
+
+        val headers = params._headers()
+
+        assertThat(headers).isEqualTo(Headers.builder().build())
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseCompactParamsTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseCompactParamsTest.kt
new file mode 100644
index 000000000..2739248d9
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseCompactParamsTest.kt
@@ -0,0 +1,115 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.openai.core.http.Headers
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ResponseCompactParamsTest {
+
+    @Test
+    fun create() {
+        ResponseCompactParams.builder()
+            .addBeta(ResponseCompactParams.Beta.RESPONSES_MULTI_AGENT_V1)
+            .model(ResponseCompactParams.Model.GPT_5_6_SOL)
+            .input("string")
+            .instructions("instructions")
+            .previousResponseId("resp_123")
+            .promptCacheKey("prompt_cache_key")
+            .promptCacheOptions(
+                ResponseCompactParams.PromptCacheOptions.builder()
+                    .mode(ResponseCompactParams.PromptCacheOptions.Mode.IMPLICIT)
+                    .ttl(ResponseCompactParams.PromptCacheOptions.Ttl._30M)
+                    .build()
+            )
+            .promptCacheRetention(ResponseCompactParams.PromptCacheRetention.IN_MEMORY)
+            .serviceTier(ResponseCompactParams.ServiceTier.AUTO)
+            .build()
+    }
+
+    @Test
+    fun headers() {
+        val params =
+            ResponseCompactParams.builder()
+                .addBeta(ResponseCompactParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                .model(ResponseCompactParams.Model.GPT_5_6_SOL)
+                .input("string")
+                .instructions("instructions")
+                .previousResponseId("resp_123")
+                .promptCacheKey("prompt_cache_key")
+                .promptCacheOptions(
+                    ResponseCompactParams.PromptCacheOptions.builder()
+                        .mode(ResponseCompactParams.PromptCacheOptions.Mode.IMPLICIT)
+                        .ttl(ResponseCompactParams.PromptCacheOptions.Ttl._30M)
+                        .build()
+                )
+                .promptCacheRetention(ResponseCompactParams.PromptCacheRetention.IN_MEMORY)
+                .serviceTier(ResponseCompactParams.ServiceTier.AUTO)
+                .build()
+
+        val headers = params._headers()
+
+        assertThat(headers)
+            .isEqualTo(Headers.builder().put("openai-beta", "responses_multi_agent=v1").build())
+    }
+
+    @Test
+    fun headersWithoutOptionalFields() {
+        val params =
+            ResponseCompactParams.builder().model(ResponseCompactParams.Model.GPT_5_6_SOL).build()
+
+        val headers = params._headers()
+
+        assertThat(headers).isEqualTo(Headers.builder().build())
+    }
+
+    @Test
+    fun body() {
+        val params =
+            ResponseCompactParams.builder()
+                .addBeta(ResponseCompactParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                .model(ResponseCompactParams.Model.GPT_5_6_SOL)
+                .input("string")
+                .instructions("instructions")
+                .previousResponseId("resp_123")
+                .promptCacheKey("prompt_cache_key")
+                .promptCacheOptions(
+                    ResponseCompactParams.PromptCacheOptions.builder()
+                        .mode(ResponseCompactParams.PromptCacheOptions.Mode.IMPLICIT)
+                        .ttl(ResponseCompactParams.PromptCacheOptions.Ttl._30M)
+                        .build()
+                )
+                .promptCacheRetention(ResponseCompactParams.PromptCacheRetention.IN_MEMORY)
+                .serviceTier(ResponseCompactParams.ServiceTier.AUTO)
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.model()).contains(ResponseCompactParams.Model.GPT_5_6_SOL)
+        assertThat(body.input()).contains(ResponseCompactParams.Input.ofString("string"))
+        assertThat(body.instructions()).contains("instructions")
+        assertThat(body.previousResponseId()).contains("resp_123")
+        assertThat(body.promptCacheKey()).contains("prompt_cache_key")
+        assertThat(body.promptCacheOptions())
+            .contains(
+                ResponseCompactParams.PromptCacheOptions.builder()
+                    .mode(ResponseCompactParams.PromptCacheOptions.Mode.IMPLICIT)
+                    .ttl(ResponseCompactParams.PromptCacheOptions.Ttl._30M)
+                    .build()
+            )
+        assertThat(body.promptCacheRetention())
+            .contains(ResponseCompactParams.PromptCacheRetention.IN_MEMORY)
+        assertThat(body.serviceTier()).contains(ResponseCompactParams.ServiceTier.AUTO)
+    }
+
+    @Test
+    fun bodyWithoutOptionalFields() {
+        val params =
+            ResponseCompactParams.builder().model(ResponseCompactParams.Model.GPT_5_6_SOL).build()
+
+        val body = params._body()
+
+        assertThat(body.model()).contains(ResponseCompactParams.Model.GPT_5_6_SOL)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseCreateParamsTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseCreateParamsTest.kt
new file mode 100644
index 000000000..b32c45006
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseCreateParamsTest.kt
@@ -0,0 +1,526 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.openai.core.JsonValue
+import com.openai.core.http.Headers
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ResponseCreateParamsTest {
+
+    @Test
+    fun create() {
+        ResponseCreateParams.builder()
+            .addBeta(ResponseCreateParams.Beta.RESPONSES_MULTI_AGENT_V1)
+            .background(true)
+            .addContextManagement(
+                ResponseCreateParams.ContextManagement.builder()
+                    .type("type")
+                    .compactThreshold(1000L)
+                    .build()
+            )
+            .conversation("string")
+            .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+            .input("string")
+            .instructions("instructions")
+            .maxOutputTokens(16L)
+            .maxToolCalls(0L)
+            .metadata(
+                ResponseCreateParams.Metadata.builder()
+                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                    .build()
+            )
+            .model(ResponseCreateParams.Model.GPT_5_1)
+            .moderation(
+                ResponseCreateParams.Moderation.builder()
+                    .model("model")
+                    .policy(
+                        ResponseCreateParams.Moderation.Policy.builder()
+                            .input(
+                                ResponseCreateParams.Moderation.Policy.Input.builder()
+                                    .mode(ResponseCreateParams.Moderation.Policy.Input.Mode.SCORE)
+                                    .build()
+                            )
+                            .output(
+                                ResponseCreateParams.Moderation.Policy.Output.builder()
+                                    .mode(ResponseCreateParams.Moderation.Policy.Output.Mode.SCORE)
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .build()
+            )
+            .multiAgent(
+                ResponseCreateParams.MultiAgent.builder()
+                    .enabled(true)
+                    .maxConcurrentSubagents(1L)
+                    .build()
+            )
+            .parallelToolCalls(true)
+            .previousResponseId("previous_response_id")
+            .prompt(
+                BetaResponsePrompt.builder()
+                    .id("id")
+                    .variables(
+                        BetaResponsePrompt.Variables.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                            .build()
+                    )
+                    .version("version")
+                    .build()
+            )
+            .promptCacheKey("prompt-cache-key-1234")
+            .promptCacheOptions(
+                ResponseCreateParams.PromptCacheOptions.builder()
+                    .mode(ResponseCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                    .ttl(ResponseCreateParams.PromptCacheOptions.Ttl._30M)
+                    .build()
+            )
+            .promptCacheRetention(ResponseCreateParams.PromptCacheRetention.IN_MEMORY)
+            .reasoning(
+                ResponseCreateParams.Reasoning.builder()
+                    .context(ResponseCreateParams.Reasoning.Context.AUTO)
+                    .effort(ResponseCreateParams.Reasoning.Effort.NONE)
+                    .generateSummary(ResponseCreateParams.Reasoning.GenerateSummary.AUTO)
+                    .mode(ResponseCreateParams.Reasoning.Mode.STANDARD)
+                    .summary(ResponseCreateParams.Reasoning.Summary.AUTO)
+                    .build()
+            )
+            .safetyIdentifier("safety-identifier-1234")
+            .serviceTier(ResponseCreateParams.ServiceTier.AUTO)
+            .store(true)
+            .streamOptions(
+                ResponseCreateParams.StreamOptions.builder().includeObfuscation(true).build()
+            )
+            .temperature(1.0)
+            .text(
+                BetaResponseTextConfig.builder()
+                    .formatText()
+                    .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                    .build()
+            )
+            .toolChoice(BetaToolChoiceOptions.NONE)
+            .addTool(
+                BetaFunctionTool.builder()
+                    .name("name")
+                    .parameters(
+                        BetaFunctionTool.Parameters.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                            .build()
+                    )
+                    .strict(true)
+                    .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                    .deferLoading(true)
+                    .description("description")
+                    .outputSchema(
+                        BetaFunctionTool.OutputSchema.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                            .build()
+                    )
+                    .build()
+            )
+            .topLogprobs(0L)
+            .topP(1.0)
+            .truncation(ResponseCreateParams.Truncation.AUTO)
+            .user("user-1234")
+            .build()
+    }
+
+    @Test
+    fun headers() {
+        val params =
+            ResponseCreateParams.builder()
+                .addBeta(ResponseCreateParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                .background(true)
+                .addContextManagement(
+                    ResponseCreateParams.ContextManagement.builder()
+                        .type("type")
+                        .compactThreshold(1000L)
+                        .build()
+                )
+                .conversation("string")
+                .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+                .input("string")
+                .instructions("instructions")
+                .maxOutputTokens(16L)
+                .maxToolCalls(0L)
+                .metadata(
+                    ResponseCreateParams.Metadata.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                        .build()
+                )
+                .model(ResponseCreateParams.Model.GPT_5_1)
+                .moderation(
+                    ResponseCreateParams.Moderation.builder()
+                        .model("model")
+                        .policy(
+                            ResponseCreateParams.Moderation.Policy.builder()
+                                .input(
+                                    ResponseCreateParams.Moderation.Policy.Input.builder()
+                                        .mode(
+                                            ResponseCreateParams.Moderation.Policy.Input.Mode.SCORE
+                                        )
+                                        .build()
+                                )
+                                .output(
+                                    ResponseCreateParams.Moderation.Policy.Output.builder()
+                                        .mode(
+                                            ResponseCreateParams.Moderation.Policy.Output.Mode.SCORE
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .multiAgent(
+                    ResponseCreateParams.MultiAgent.builder()
+                        .enabled(true)
+                        .maxConcurrentSubagents(1L)
+                        .build()
+                )
+                .parallelToolCalls(true)
+                .previousResponseId("previous_response_id")
+                .prompt(
+                    BetaResponsePrompt.builder()
+                        .id("id")
+                        .variables(
+                            BetaResponsePrompt.Variables.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .version("version")
+                        .build()
+                )
+                .promptCacheKey("prompt-cache-key-1234")
+                .promptCacheOptions(
+                    ResponseCreateParams.PromptCacheOptions.builder()
+                        .mode(ResponseCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                        .ttl(ResponseCreateParams.PromptCacheOptions.Ttl._30M)
+                        .build()
+                )
+                .promptCacheRetention(ResponseCreateParams.PromptCacheRetention.IN_MEMORY)
+                .reasoning(
+                    ResponseCreateParams.Reasoning.builder()
+                        .context(ResponseCreateParams.Reasoning.Context.AUTO)
+                        .effort(ResponseCreateParams.Reasoning.Effort.NONE)
+                        .generateSummary(ResponseCreateParams.Reasoning.GenerateSummary.AUTO)
+                        .mode(ResponseCreateParams.Reasoning.Mode.STANDARD)
+                        .summary(ResponseCreateParams.Reasoning.Summary.AUTO)
+                        .build()
+                )
+                .safetyIdentifier("safety-identifier-1234")
+                .serviceTier(ResponseCreateParams.ServiceTier.AUTO)
+                .store(true)
+                .streamOptions(
+                    ResponseCreateParams.StreamOptions.builder().includeObfuscation(true).build()
+                )
+                .temperature(1.0)
+                .text(
+                    BetaResponseTextConfig.builder()
+                        .formatText()
+                        .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                        .build()
+                )
+                .toolChoice(BetaToolChoiceOptions.NONE)
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .topLogprobs(0L)
+                .topP(1.0)
+                .truncation(ResponseCreateParams.Truncation.AUTO)
+                .user("user-1234")
+                .build()
+
+        val headers = params._headers()
+
+        assertThat(headers)
+            .isEqualTo(Headers.builder().put("openai-beta", "responses_multi_agent=v1").build())
+    }
+
+    @Test
+    fun headersWithoutOptionalFields() {
+        val params = ResponseCreateParams.builder().build()
+
+        val headers = params._headers()
+
+        assertThat(headers).isEqualTo(Headers.builder().build())
+    }
+
+    @Test
+    fun body() {
+        val params =
+            ResponseCreateParams.builder()
+                .addBeta(ResponseCreateParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                .background(true)
+                .addContextManagement(
+                    ResponseCreateParams.ContextManagement.builder()
+                        .type("type")
+                        .compactThreshold(1000L)
+                        .build()
+                )
+                .conversation("string")
+                .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+                .input("string")
+                .instructions("instructions")
+                .maxOutputTokens(16L)
+                .maxToolCalls(0L)
+                .metadata(
+                    ResponseCreateParams.Metadata.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("string"))
+                        .build()
+                )
+                .model(ResponseCreateParams.Model.GPT_5_1)
+                .moderation(
+                    ResponseCreateParams.Moderation.builder()
+                        .model("model")
+                        .policy(
+                            ResponseCreateParams.Moderation.Policy.builder()
+                                .input(
+                                    ResponseCreateParams.Moderation.Policy.Input.builder()
+                                        .mode(
+                                            ResponseCreateParams.Moderation.Policy.Input.Mode.SCORE
+                                        )
+                                        .build()
+                                )
+                                .output(
+                                    ResponseCreateParams.Moderation.Policy.Output.builder()
+                                        .mode(
+                                            ResponseCreateParams.Moderation.Policy.Output.Mode.SCORE
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
+                .multiAgent(
+                    ResponseCreateParams.MultiAgent.builder()
+                        .enabled(true)
+                        .maxConcurrentSubagents(1L)
+                        .build()
+                )
+                .parallelToolCalls(true)
+                .previousResponseId("previous_response_id")
+                .prompt(
+                    BetaResponsePrompt.builder()
+                        .id("id")
+                        .variables(
+                            BetaResponsePrompt.Variables.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("string"))
+                                .build()
+                        )
+                        .version("version")
+                        .build()
+                )
+                .promptCacheKey("prompt-cache-key-1234")
+                .promptCacheOptions(
+                    ResponseCreateParams.PromptCacheOptions.builder()
+                        .mode(ResponseCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                        .ttl(ResponseCreateParams.PromptCacheOptions.Ttl._30M)
+                        .build()
+                )
+                .promptCacheRetention(ResponseCreateParams.PromptCacheRetention.IN_MEMORY)
+                .reasoning(
+                    ResponseCreateParams.Reasoning.builder()
+                        .context(ResponseCreateParams.Reasoning.Context.AUTO)
+                        .effort(ResponseCreateParams.Reasoning.Effort.NONE)
+                        .generateSummary(ResponseCreateParams.Reasoning.GenerateSummary.AUTO)
+                        .mode(ResponseCreateParams.Reasoning.Mode.STANDARD)
+                        .summary(ResponseCreateParams.Reasoning.Summary.AUTO)
+                        .build()
+                )
+                .safetyIdentifier("safety-identifier-1234")
+                .serviceTier(ResponseCreateParams.ServiceTier.AUTO)
+                .store(true)
+                .streamOptions(
+                    ResponseCreateParams.StreamOptions.builder().includeObfuscation(true).build()
+                )
+                .temperature(1.0)
+                .text(
+                    BetaResponseTextConfig.builder()
+                        .formatText()
+                        .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                        .build()
+                )
+                .toolChoice(BetaToolChoiceOptions.NONE)
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .topLogprobs(0L)
+                .topP(1.0)
+                .truncation(ResponseCreateParams.Truncation.AUTO)
+                .user("user-1234")
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.background()).contains(true)
+        assertThat(body.contextManagement().getOrNull())
+            .containsExactly(
+                ResponseCreateParams.ContextManagement.builder()
+                    .type("type")
+                    .compactThreshold(1000L)
+                    .build()
+            )
+        assertThat(body.conversation()).contains(ResponseCreateParams.Conversation.ofId("string"))
+        assertThat(body.include().getOrNull())
+            .containsExactly(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+        assertThat(body.input()).contains(ResponseCreateParams.Input.ofText("string"))
+        assertThat(body.instructions()).contains("instructions")
+        assertThat(body.maxOutputTokens()).contains(16L)
+        assertThat(body.maxToolCalls()).contains(0L)
+        assertThat(body.metadata())
+            .contains(
+                ResponseCreateParams.Metadata.builder()
+                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                    .build()
+            )
+        assertThat(body.model()).contains(ResponseCreateParams.Model.GPT_5_1)
+        assertThat(body.moderation())
+            .contains(
+                ResponseCreateParams.Moderation.builder()
+                    .model("model")
+                    .policy(
+                        ResponseCreateParams.Moderation.Policy.builder()
+                            .input(
+                                ResponseCreateParams.Moderation.Policy.Input.builder()
+                                    .mode(ResponseCreateParams.Moderation.Policy.Input.Mode.SCORE)
+                                    .build()
+                            )
+                            .output(
+                                ResponseCreateParams.Moderation.Policy.Output.builder()
+                                    .mode(ResponseCreateParams.Moderation.Policy.Output.Mode.SCORE)
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .build()
+            )
+        assertThat(body.multiAgent())
+            .contains(
+                ResponseCreateParams.MultiAgent.builder()
+                    .enabled(true)
+                    .maxConcurrentSubagents(1L)
+                    .build()
+            )
+        assertThat(body.parallelToolCalls()).contains(true)
+        assertThat(body.previousResponseId()).contains("previous_response_id")
+        assertThat(body.prompt())
+            .contains(
+                BetaResponsePrompt.builder()
+                    .id("id")
+                    .variables(
+                        BetaResponsePrompt.Variables.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                            .build()
+                    )
+                    .version("version")
+                    .build()
+            )
+        assertThat(body.promptCacheKey()).contains("prompt-cache-key-1234")
+        assertThat(body.promptCacheOptions())
+            .contains(
+                ResponseCreateParams.PromptCacheOptions.builder()
+                    .mode(ResponseCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                    .ttl(ResponseCreateParams.PromptCacheOptions.Ttl._30M)
+                    .build()
+            )
+        assertThat(body.promptCacheRetention())
+            .contains(ResponseCreateParams.PromptCacheRetention.IN_MEMORY)
+        assertThat(body.reasoning())
+            .contains(
+                ResponseCreateParams.Reasoning.builder()
+                    .context(ResponseCreateParams.Reasoning.Context.AUTO)
+                    .effort(ResponseCreateParams.Reasoning.Effort.NONE)
+                    .generateSummary(ResponseCreateParams.Reasoning.GenerateSummary.AUTO)
+                    .mode(ResponseCreateParams.Reasoning.Mode.STANDARD)
+                    .summary(ResponseCreateParams.Reasoning.Summary.AUTO)
+                    .build()
+            )
+        assertThat(body.safetyIdentifier()).contains("safety-identifier-1234")
+        assertThat(body.serviceTier()).contains(ResponseCreateParams.ServiceTier.AUTO)
+        assertThat(body.store()).contains(true)
+        assertThat(body.streamOptions())
+            .contains(ResponseCreateParams.StreamOptions.builder().includeObfuscation(true).build())
+        assertThat(body.temperature()).contains(1.0)
+        assertThat(body.text())
+            .contains(
+                BetaResponseTextConfig.builder()
+                    .formatText()
+                    .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                    .build()
+            )
+        assertThat(body.toolChoice())
+            .contains(
+                ResponseCreateParams.ToolChoice.ofBetaToolChoiceOptions(BetaToolChoiceOptions.NONE)
+            )
+        assertThat(body.tools().getOrNull())
+            .containsExactly(
+                BetaTool.ofFunction(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+            )
+        assertThat(body.topLogprobs()).contains(0L)
+        assertThat(body.topP()).contains(1.0)
+        assertThat(body.truncation()).contains(ResponseCreateParams.Truncation.AUTO)
+        assertThat(body.user()).contains("user-1234")
+    }
+
+    @Test
+    fun bodyWithoutOptionalFields() {
+        val params = ResponseCreateParams.builder().build()
+
+        val body = params._body()
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseDeleteParamsTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseDeleteParamsTest.kt
new file mode 100644
index 000000000..7c91749f5
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseDeleteParamsTest.kt
@@ -0,0 +1,56 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.openai.core.http.Headers
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ResponseDeleteParamsTest {
+
+    @Test
+    fun create() {
+        ResponseDeleteParams.builder()
+            .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+            .addBeta(ResponseDeleteParams.Beta.RESPONSES_MULTI_AGENT_V1)
+            .build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params =
+            ResponseDeleteParams.builder()
+                .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                .build()
+
+        assertThat(params._pathParam(0)).isEqualTo("resp_677efb5139a88190b512bc3fef8e535d")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun headers() {
+        val params =
+            ResponseDeleteParams.builder()
+                .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                .addBeta(ResponseDeleteParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                .build()
+
+        val headers = params._headers()
+
+        assertThat(headers)
+            .isEqualTo(Headers.builder().put("openai-beta", "responses_multi_agent=v1").build())
+    }
+
+    @Test
+    fun headersWithoutOptionalFields() {
+        val params =
+            ResponseDeleteParams.builder()
+                .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                .build()
+
+        val headers = params._headers()
+
+        assertThat(headers).isEqualTo(Headers.builder().build())
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseRetrieveParamsTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseRetrieveParamsTest.kt
new file mode 100644
index 000000000..f81f8a19c
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/ResponseRetrieveParamsTest.kt
@@ -0,0 +1,98 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses
+
+import com.openai.core.http.Headers
+import com.openai.core.http.QueryParams
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class ResponseRetrieveParamsTest {
+
+    @Test
+    fun create() {
+        ResponseRetrieveParams.builder()
+            .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+            .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+            .includeObfuscation(true)
+            .startingAfter(0L)
+            .addBeta(ResponseRetrieveParams.Beta.RESPONSES_MULTI_AGENT_V1)
+            .build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params =
+            ResponseRetrieveParams.builder()
+                .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                .build()
+
+        assertThat(params._pathParam(0)).isEqualTo("resp_677efb5139a88190b512bc3fef8e535d")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun headers() {
+        val params =
+            ResponseRetrieveParams.builder()
+                .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+                .includeObfuscation(true)
+                .startingAfter(0L)
+                .addBeta(ResponseRetrieveParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                .build()
+
+        val headers = params._headers()
+
+        assertThat(headers)
+            .isEqualTo(Headers.builder().put("openai-beta", "responses_multi_agent=v1").build())
+    }
+
+    @Test
+    fun headersWithoutOptionalFields() {
+        val params =
+            ResponseRetrieveParams.builder()
+                .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                .build()
+
+        val headers = params._headers()
+
+        assertThat(headers).isEqualTo(Headers.builder().build())
+    }
+
+    @Test
+    fun queryParams() {
+        val params =
+            ResponseRetrieveParams.builder()
+                .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+                .includeObfuscation(true)
+                .startingAfter(0L)
+                .addBeta(ResponseRetrieveParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                .build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams)
+            .isEqualTo(
+                QueryParams.builder()
+                    .put("include[]", "file_search_call.results")
+                    .put("include_obfuscation", "true")
+                    .put("starting_after", "0")
+                    .build()
+            )
+    }
+
+    @Test
+    fun queryParamsWithoutOptionalFields() {
+        val params =
+            ResponseRetrieveParams.builder()
+                .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                .build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams).isEqualTo(QueryParams.builder().build())
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/inputitems/BetaResponseItemListTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/inputitems/BetaResponseItemListTest.kt
new file mode 100644
index 000000000..709b2efb7
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/inputitems/BetaResponseItemListTest.kt
@@ -0,0 +1,110 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses.inputitems
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import com.openai.models.beta.responses.BetaResponseInputMessageItem
+import com.openai.models.beta.responses.BetaResponseInputText
+import com.openai.models.beta.responses.BetaResponseItem
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class BetaResponseItemListTest {
+
+    @Test
+    fun create() {
+        val betaResponseItemList =
+            BetaResponseItemList.builder()
+                .addData(
+                    BetaResponseInputMessageItem.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseInputText.builder()
+                                .text("text")
+                                .promptCacheBreakpoint(
+                                    BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                                )
+                                .build()
+                        )
+                        .role(BetaResponseInputMessageItem.Role.USER)
+                        .agent(
+                            BetaResponseInputMessageItem.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .status(BetaResponseInputMessageItem.Status.IN_PROGRESS)
+                        .build()
+                )
+                .firstId("first_id")
+                .hasMore(true)
+                .lastId("last_id")
+                .build()
+
+        assertThat(betaResponseItemList.data())
+            .containsExactly(
+                BetaResponseItem.ofBetaResponseInputMessageItem(
+                    BetaResponseInputMessageItem.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseInputText.builder()
+                                .text("text")
+                                .promptCacheBreakpoint(
+                                    BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                                )
+                                .build()
+                        )
+                        .role(BetaResponseInputMessageItem.Role.USER)
+                        .agent(
+                            BetaResponseInputMessageItem.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .status(BetaResponseInputMessageItem.Status.IN_PROGRESS)
+                        .build()
+                )
+            )
+        assertThat(betaResponseItemList.firstId()).isEqualTo("first_id")
+        assertThat(betaResponseItemList.hasMore()).isEqualTo(true)
+        assertThat(betaResponseItemList.lastId()).isEqualTo("last_id")
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val betaResponseItemList =
+            BetaResponseItemList.builder()
+                .addData(
+                    BetaResponseInputMessageItem.builder()
+                        .id("id")
+                        .addContent(
+                            BetaResponseInputText.builder()
+                                .text("text")
+                                .promptCacheBreakpoint(
+                                    BetaResponseInputText.PromptCacheBreakpoint.builder().build()
+                                )
+                                .build()
+                        )
+                        .role(BetaResponseInputMessageItem.Role.USER)
+                        .agent(
+                            BetaResponseInputMessageItem.Agent.builder()
+                                .agentName("agent_name")
+                                .build()
+                        )
+                        .status(BetaResponseInputMessageItem.Status.IN_PROGRESS)
+                        .build()
+                )
+                .firstId("first_id")
+                .hasMore(true)
+                .lastId("last_id")
+                .build()
+
+        val roundtrippedBetaResponseItemList =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(betaResponseItemList),
+                jacksonTypeRef<BetaResponseItemList>(),
+            )
+
+        assertThat(roundtrippedBetaResponseItemList).isEqualTo(betaResponseItemList)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/inputitems/InputItemListParamsTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/inputitems/InputItemListParamsTest.kt
new file mode 100644
index 000000000..898919c37
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/inputitems/InputItemListParamsTest.kt
@@ -0,0 +1,94 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses.inputitems
+
+import com.openai.core.http.Headers
+import com.openai.core.http.QueryParams
+import com.openai.models.beta.responses.BetaResponseIncludable
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class InputItemListParamsTest {
+
+    @Test
+    fun create() {
+        InputItemListParams.builder()
+            .responseId("response_id")
+            .after("after")
+            .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+            .limit(0L)
+            .order(InputItemListParams.Order.ASC)
+            .addBeta(InputItemListParams.Beta.RESPONSES_MULTI_AGENT_V1)
+            .build()
+    }
+
+    @Test
+    fun pathParams() {
+        val params = InputItemListParams.builder().responseId("response_id").build()
+
+        assertThat(params._pathParam(0)).isEqualTo("response_id")
+        // out-of-bound path param
+        assertThat(params._pathParam(1)).isEqualTo("")
+    }
+
+    @Test
+    fun headers() {
+        val params =
+            InputItemListParams.builder()
+                .responseId("response_id")
+                .after("after")
+                .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+                .limit(0L)
+                .order(InputItemListParams.Order.ASC)
+                .addBeta(InputItemListParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                .build()
+
+        val headers = params._headers()
+
+        assertThat(headers)
+            .isEqualTo(Headers.builder().put("openai-beta", "responses_multi_agent=v1").build())
+    }
+
+    @Test
+    fun headersWithoutOptionalFields() {
+        val params = InputItemListParams.builder().responseId("response_id").build()
+
+        val headers = params._headers()
+
+        assertThat(headers).isEqualTo(Headers.builder().build())
+    }
+
+    @Test
+    fun queryParams() {
+        val params =
+            InputItemListParams.builder()
+                .responseId("response_id")
+                .after("after")
+                .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+                .limit(0L)
+                .order(InputItemListParams.Order.ASC)
+                .addBeta(InputItemListParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                .build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams)
+            .isEqualTo(
+                QueryParams.builder()
+                    .put("after", "after")
+                    .put("include[]", "file_search_call.results")
+                    .put("limit", "0")
+                    .put("order", "asc")
+                    .build()
+            )
+    }
+
+    @Test
+    fun queryParamsWithoutOptionalFields() {
+        val params = InputItemListParams.builder().responseId("response_id").build()
+
+        val queryParams = params._queryParams()
+
+        assertThat(queryParams).isEqualTo(QueryParams.builder().build())
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/inputtokens/InputTokenCountParamsTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/inputtokens/InputTokenCountParamsTest.kt
new file mode 100644
index 000000000..3f39c97ef
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/inputtokens/InputTokenCountParamsTest.kt
@@ -0,0 +1,242 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses.inputtokens
+
+import com.openai.core.JsonValue
+import com.openai.core.http.Headers
+import com.openai.models.beta.responses.BetaFunctionTool
+import com.openai.models.beta.responses.BetaTool
+import com.openai.models.beta.responses.BetaToolChoiceOptions
+import kotlin.jvm.optionals.getOrNull
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class InputTokenCountParamsTest {
+
+    @Test
+    fun create() {
+        InputTokenCountParams.builder()
+            .addBeta(InputTokenCountParams.Beta.RESPONSES_MULTI_AGENT_V1)
+            .conversation("string")
+            .input("string")
+            .instructions("instructions")
+            .model("model")
+            .parallelToolCalls(true)
+            .personality(InputTokenCountParams.Personality.FRIENDLY)
+            .previousResponseId("resp_123")
+            .reasoning(
+                InputTokenCountParams.Reasoning.builder()
+                    .context(InputTokenCountParams.Reasoning.Context.AUTO)
+                    .effort(InputTokenCountParams.Reasoning.Effort.NONE)
+                    .generateSummary(InputTokenCountParams.Reasoning.GenerateSummary.AUTO)
+                    .mode(InputTokenCountParams.Reasoning.Mode.STANDARD)
+                    .summary(InputTokenCountParams.Reasoning.Summary.AUTO)
+                    .build()
+            )
+            .text(
+                InputTokenCountParams.Text.builder()
+                    .formatText()
+                    .verbosity(InputTokenCountParams.Text.Verbosity.LOW)
+                    .build()
+            )
+            .toolChoice(BetaToolChoiceOptions.NONE)
+            .addTool(
+                BetaFunctionTool.builder()
+                    .name("name")
+                    .parameters(
+                        BetaFunctionTool.Parameters.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                            .build()
+                    )
+                    .strict(true)
+                    .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                    .deferLoading(true)
+                    .description("description")
+                    .outputSchema(
+                        BetaFunctionTool.OutputSchema.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                            .build()
+                    )
+                    .build()
+            )
+            .truncation(InputTokenCountParams.Truncation.AUTO)
+            .build()
+    }
+
+    @Test
+    fun headers() {
+        val params =
+            InputTokenCountParams.builder()
+                .addBeta(InputTokenCountParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                .conversation("string")
+                .input("string")
+                .instructions("instructions")
+                .model("model")
+                .parallelToolCalls(true)
+                .personality(InputTokenCountParams.Personality.FRIENDLY)
+                .previousResponseId("resp_123")
+                .reasoning(
+                    InputTokenCountParams.Reasoning.builder()
+                        .context(InputTokenCountParams.Reasoning.Context.AUTO)
+                        .effort(InputTokenCountParams.Reasoning.Effort.NONE)
+                        .generateSummary(InputTokenCountParams.Reasoning.GenerateSummary.AUTO)
+                        .mode(InputTokenCountParams.Reasoning.Mode.STANDARD)
+                        .summary(InputTokenCountParams.Reasoning.Summary.AUTO)
+                        .build()
+                )
+                .text(
+                    InputTokenCountParams.Text.builder()
+                        .formatText()
+                        .verbosity(InputTokenCountParams.Text.Verbosity.LOW)
+                        .build()
+                )
+                .toolChoice(BetaToolChoiceOptions.NONE)
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .truncation(InputTokenCountParams.Truncation.AUTO)
+                .build()
+
+        val headers = params._headers()
+
+        assertThat(headers)
+            .isEqualTo(Headers.builder().put("openai-beta", "responses_multi_agent=v1").build())
+    }
+
+    @Test
+    fun headersWithoutOptionalFields() {
+        val params = InputTokenCountParams.builder().build()
+
+        val headers = params._headers()
+
+        assertThat(headers).isEqualTo(Headers.builder().build())
+    }
+
+    @Test
+    fun body() {
+        val params =
+            InputTokenCountParams.builder()
+                .addBeta(InputTokenCountParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                .conversation("string")
+                .input("string")
+                .instructions("instructions")
+                .model("model")
+                .parallelToolCalls(true)
+                .personality(InputTokenCountParams.Personality.FRIENDLY)
+                .previousResponseId("resp_123")
+                .reasoning(
+                    InputTokenCountParams.Reasoning.builder()
+                        .context(InputTokenCountParams.Reasoning.Context.AUTO)
+                        .effort(InputTokenCountParams.Reasoning.Effort.NONE)
+                        .generateSummary(InputTokenCountParams.Reasoning.GenerateSummary.AUTO)
+                        .mode(InputTokenCountParams.Reasoning.Mode.STANDARD)
+                        .summary(InputTokenCountParams.Reasoning.Summary.AUTO)
+                        .build()
+                )
+                .text(
+                    InputTokenCountParams.Text.builder()
+                        .formatText()
+                        .verbosity(InputTokenCountParams.Text.Verbosity.LOW)
+                        .build()
+                )
+                .toolChoice(BetaToolChoiceOptions.NONE)
+                .addTool(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+                .truncation(InputTokenCountParams.Truncation.AUTO)
+                .build()
+
+        val body = params._body()
+
+        assertThat(body.conversation()).contains(InputTokenCountParams.Conversation.ofId("string"))
+        assertThat(body.input()).contains(InputTokenCountParams.Input.ofString("string"))
+        assertThat(body.instructions()).contains("instructions")
+        assertThat(body.model()).contains("model")
+        assertThat(body.parallelToolCalls()).contains(true)
+        assertThat(body.personality()).contains(InputTokenCountParams.Personality.FRIENDLY)
+        assertThat(body.previousResponseId()).contains("resp_123")
+        assertThat(body.reasoning())
+            .contains(
+                InputTokenCountParams.Reasoning.builder()
+                    .context(InputTokenCountParams.Reasoning.Context.AUTO)
+                    .effort(InputTokenCountParams.Reasoning.Effort.NONE)
+                    .generateSummary(InputTokenCountParams.Reasoning.GenerateSummary.AUTO)
+                    .mode(InputTokenCountParams.Reasoning.Mode.STANDARD)
+                    .summary(InputTokenCountParams.Reasoning.Summary.AUTO)
+                    .build()
+            )
+        assertThat(body.text())
+            .contains(
+                InputTokenCountParams.Text.builder()
+                    .formatText()
+                    .verbosity(InputTokenCountParams.Text.Verbosity.LOW)
+                    .build()
+            )
+        assertThat(body.toolChoice())
+            .contains(
+                InputTokenCountParams.ToolChoice.ofBetaToolChoiceOptions(BetaToolChoiceOptions.NONE)
+            )
+        assertThat(body.tools().getOrNull())
+            .containsExactly(
+                BetaTool.ofFunction(
+                    BetaFunctionTool.builder()
+                        .name("name")
+                        .parameters(
+                            BetaFunctionTool.Parameters.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .strict(true)
+                        .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                        .deferLoading(true)
+                        .description("description")
+                        .outputSchema(
+                            BetaFunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
+                        .build()
+                )
+            )
+        assertThat(body.truncation()).contains(InputTokenCountParams.Truncation.AUTO)
+    }
+
+    @Test
+    fun bodyWithoutOptionalFields() {
+        val params = InputTokenCountParams.builder().build()
+
+        val body = params._body()
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/inputtokens/InputTokenCountResponseTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/inputtokens/InputTokenCountResponseTest.kt
new file mode 100644
index 000000000..0b91e6681
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/responses/inputtokens/InputTokenCountResponseTest.kt
@@ -0,0 +1,32 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.beta.responses.inputtokens
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class InputTokenCountResponseTest {
+
+    @Test
+    fun create() {
+        val inputTokenCountResponse = InputTokenCountResponse.builder().inputTokens(123L).build()
+
+        assertThat(inputTokenCountResponse.inputTokens()).isEqualTo(123L)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val inputTokenCountResponse = InputTokenCountResponse.builder().inputTokens(123L).build()
+
+        val roundtrippedInputTokenCountResponse =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(inputTokenCountResponse),
+                jacksonTypeRef<InputTokenCountResponse>(),
+            )
+
+        assertThat(roundtrippedInputTokenCountResponse).isEqualTo(inputTokenCountResponse)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/threads/ThreadCreateAndRunParamsTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/threads/ThreadCreateAndRunParamsTest.kt
index dbaad8578..9d0b6e413 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/beta/threads/ThreadCreateAndRunParamsTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/threads/ThreadCreateAndRunParamsTest.kt
@@ -24,7 +24,7 @@ internal class ThreadCreateAndRunParamsTest {
                     .putAdditionalProperty("foo", JsonValue.from("string"))
                     .build()
             )
-            .model(ChatModel.GPT_5_4)
+            .model(ChatModel.GPT_5_6_SOL)
             .parallelToolCalls(true)
             .responseFormatAuto()
             .temperature(1.0)
@@ -128,7 +128,7 @@ internal class ThreadCreateAndRunParamsTest {
                         .putAdditionalProperty("foo", JsonValue.from("string"))
                         .build()
                 )
-                .model(ChatModel.GPT_5_4)
+                .model(ChatModel.GPT_5_6_SOL)
                 .parallelToolCalls(true)
                 .responseFormatAuto()
                 .temperature(1.0)
@@ -231,7 +231,7 @@ internal class ThreadCreateAndRunParamsTest {
                     .putAdditionalProperty("foo", JsonValue.from("string"))
                     .build()
             )
-        assertThat(body.model()).contains(ChatModel.GPT_5_4)
+        assertThat(body.model()).contains(ChatModel.GPT_5_6_SOL)
         assertThat(body.parallelToolCalls()).contains(true)
         assertThat(body.responseFormat()).contains(AssistantResponseFormatOption.ofAuto())
         assertThat(body.temperature()).contains(1.0)
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/beta/threads/runs/RunCreateParamsTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/beta/threads/runs/RunCreateParamsTest.kt
index f47b26ca3..4337f75af 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/beta/threads/runs/RunCreateParamsTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/beta/threads/runs/RunCreateParamsTest.kt
@@ -49,7 +49,7 @@ internal class RunCreateParamsTest {
                     .putAdditionalProperty("foo", JsonValue.from("string"))
                     .build()
             )
-            .model(ChatModel.GPT_5_4)
+            .model(ChatModel.GPT_5_6_SOL)
             .parallelToolCalls(true)
             .reasoningEffort(ReasoningEffort.NONE)
             .responseFormatAuto()
@@ -109,7 +109,7 @@ internal class RunCreateParamsTest {
                         .putAdditionalProperty("foo", JsonValue.from("string"))
                         .build()
                 )
-                .model(ChatModel.GPT_5_4)
+                .model(ChatModel.GPT_5_6_SOL)
                 .parallelToolCalls(true)
                 .reasoningEffort(ReasoningEffort.NONE)
                 .responseFormatAuto()
@@ -178,7 +178,7 @@ internal class RunCreateParamsTest {
                         .putAdditionalProperty("foo", JsonValue.from("string"))
                         .build()
                 )
-                .model(ChatModel.GPT_5_4)
+                .model(ChatModel.GPT_5_6_SOL)
                 .parallelToolCalls(true)
                 .reasoningEffort(ReasoningEffort.NONE)
                 .responseFormatAuto()
@@ -225,7 +225,7 @@ internal class RunCreateParamsTest {
                     .putAdditionalProperty("foo", JsonValue.from("string"))
                     .build()
             )
-        assertThat(body.model()).contains(ChatModel.GPT_5_4)
+        assertThat(body.model()).contains(ChatModel.GPT_5_6_SOL)
         assertThat(body.parallelToolCalls()).contains(true)
         assertThat(body.reasoningEffort()).contains(ReasoningEffort.NONE)
         assertThat(body.responseFormat()).contains(AssistantResponseFormatOption.ofAuto())
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionChunkTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionChunkTest.kt
index 6d485c9cc..eeca8ff46 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionChunkTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionChunkTest.kt
@@ -185,6 +185,7 @@ internal class ChatCompletionChunkTest {
                         .promptTokensDetails(
                             CompletionUsage.PromptTokensDetails.builder()
                                 .audioTokens(0L)
+                                .cacheWriteTokens(0L)
                                 .cachedTokens(0L)
                                 .build()
                         )
@@ -362,6 +363,7 @@ internal class ChatCompletionChunkTest {
                     .promptTokensDetails(
                         CompletionUsage.PromptTokensDetails.builder()
                             .audioTokens(0L)
+                            .cacheWriteTokens(0L)
                             .cachedTokens(0L)
                             .build()
                     )
@@ -544,6 +546,7 @@ internal class ChatCompletionChunkTest {
                         .promptTokensDetails(
                             CompletionUsage.PromptTokensDetails.builder()
                                 .audioTokens(0L)
+                                .cacheWriteTokens(0L)
                                 .cachedTokens(0L)
                                 .build()
                         )
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartImageTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartImageTest.kt
index 4844a05ee..15dc097eb 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartImageTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartImageTest.kt
@@ -19,6 +19,9 @@ internal class ChatCompletionContentPartImageTest {
                         .detail(ChatCompletionContentPartImage.ImageUrl.Detail.AUTO)
                         .build()
                 )
+                .promptCacheBreakpoint(
+                    ChatCompletionContentPartImage.PromptCacheBreakpoint.builder().build()
+                )
                 .build()
 
         assertThat(chatCompletionContentPartImage.imageUrl())
@@ -28,6 +31,8 @@ internal class ChatCompletionContentPartImageTest {
                     .detail(ChatCompletionContentPartImage.ImageUrl.Detail.AUTO)
                     .build()
             )
+        assertThat(chatCompletionContentPartImage.promptCacheBreakpoint())
+            .contains(ChatCompletionContentPartImage.PromptCacheBreakpoint.builder().build())
     }
 
     @Test
@@ -41,6 +46,9 @@ internal class ChatCompletionContentPartImageTest {
                         .detail(ChatCompletionContentPartImage.ImageUrl.Detail.AUTO)
                         .build()
                 )
+                .promptCacheBreakpoint(
+                    ChatCompletionContentPartImage.PromptCacheBreakpoint.builder().build()
+                )
                 .build()
 
         val roundtrippedChatCompletionContentPartImage =
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartInputAudioTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartInputAudioTest.kt
index e05d04f64..c8e9edfa2 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartInputAudioTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartInputAudioTest.kt
@@ -19,6 +19,9 @@ internal class ChatCompletionContentPartInputAudioTest {
                         .format(ChatCompletionContentPartInputAudio.InputAudio.Format.WAV)
                         .build()
                 )
+                .promptCacheBreakpoint(
+                    ChatCompletionContentPartInputAudio.PromptCacheBreakpoint.builder().build()
+                )
                 .build()
 
         assertThat(chatCompletionContentPartInputAudio.inputAudio())
@@ -28,6 +31,8 @@ internal class ChatCompletionContentPartInputAudioTest {
                     .format(ChatCompletionContentPartInputAudio.InputAudio.Format.WAV)
                     .build()
             )
+        assertThat(chatCompletionContentPartInputAudio.promptCacheBreakpoint())
+            .contains(ChatCompletionContentPartInputAudio.PromptCacheBreakpoint.builder().build())
     }
 
     @Test
@@ -41,6 +46,9 @@ internal class ChatCompletionContentPartInputAudioTest {
                         .format(ChatCompletionContentPartInputAudio.InputAudio.Format.WAV)
                         .build()
                 )
+                .promptCacheBreakpoint(
+                    ChatCompletionContentPartInputAudio.PromptCacheBreakpoint.builder().build()
+                )
                 .build()
 
         val roundtrippedChatCompletionContentPartInputAudio =
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartTest.kt
index 6fcb45bc0..96ac85e96 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartTest.kt
@@ -16,7 +16,13 @@ internal class ChatCompletionContentPartTest {
 
     @Test
     fun ofText() {
-        val text = ChatCompletionContentPartText.builder().text("text").build()
+        val text =
+            ChatCompletionContentPartText.builder()
+                .text("text")
+                .promptCacheBreakpoint(
+                    ChatCompletionContentPartText.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
 
         val chatCompletionContentPart = ChatCompletionContentPart.ofText(text)
 
@@ -31,7 +37,12 @@ internal class ChatCompletionContentPartTest {
         val jsonMapper = jsonMapper()
         val chatCompletionContentPart =
             ChatCompletionContentPart.ofText(
-                ChatCompletionContentPartText.builder().text("text").build()
+                ChatCompletionContentPartText.builder()
+                    .text("text")
+                    .promptCacheBreakpoint(
+                        ChatCompletionContentPartText.PromptCacheBreakpoint.builder().build()
+                    )
+                    .build()
             )
 
         val roundtrippedChatCompletionContentPart =
@@ -53,6 +64,9 @@ internal class ChatCompletionContentPartTest {
                         .detail(ChatCompletionContentPartImage.ImageUrl.Detail.AUTO)
                         .build()
                 )
+                .promptCacheBreakpoint(
+                    ChatCompletionContentPartImage.PromptCacheBreakpoint.builder().build()
+                )
                 .build()
 
         val chatCompletionContentPart = ChatCompletionContentPart.ofImageUrl(imageUrl)
@@ -75,6 +89,9 @@ internal class ChatCompletionContentPartTest {
                             .detail(ChatCompletionContentPartImage.ImageUrl.Detail.AUTO)
                             .build()
                     )
+                    .promptCacheBreakpoint(
+                        ChatCompletionContentPartImage.PromptCacheBreakpoint.builder().build()
+                    )
                     .build()
             )
 
@@ -97,6 +114,9 @@ internal class ChatCompletionContentPartTest {
                         .format(ChatCompletionContentPartInputAudio.InputAudio.Format.WAV)
                         .build()
                 )
+                .promptCacheBreakpoint(
+                    ChatCompletionContentPartInputAudio.PromptCacheBreakpoint.builder().build()
+                )
                 .build()
 
         val chatCompletionContentPart = ChatCompletionContentPart.ofInputAudio(inputAudio)
@@ -119,6 +139,9 @@ internal class ChatCompletionContentPartTest {
                             .format(ChatCompletionContentPartInputAudio.InputAudio.Format.WAV)
                             .build()
                     )
+                    .promptCacheBreakpoint(
+                        ChatCompletionContentPartInputAudio.PromptCacheBreakpoint.builder().build()
+                    )
                     .build()
             )
 
@@ -142,6 +165,9 @@ internal class ChatCompletionContentPartTest {
                         .filename("filename")
                         .build()
                 )
+                .promptCacheBreakpoint(
+                    ChatCompletionContentPart.File.PromptCacheBreakpoint.builder().build()
+                )
                 .build()
 
         val chatCompletionContentPart = ChatCompletionContentPart.ofFile(file)
@@ -165,6 +191,9 @@ internal class ChatCompletionContentPartTest {
                             .filename("filename")
                             .build()
                     )
+                    .promptCacheBreakpoint(
+                        ChatCompletionContentPart.File.PromptCacheBreakpoint.builder().build()
+                    )
                     .build()
             )
 
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartTextTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartTextTest.kt
index 37c242761..997db5105 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartTextTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionContentPartTextTest.kt
@@ -12,16 +12,28 @@ internal class ChatCompletionContentPartTextTest {
     @Test
     fun create() {
         val chatCompletionContentPartText =
-            ChatCompletionContentPartText.builder().text("text").build()
+            ChatCompletionContentPartText.builder()
+                .text("text")
+                .promptCacheBreakpoint(
+                    ChatCompletionContentPartText.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
 
         assertThat(chatCompletionContentPartText.text()).isEqualTo("text")
+        assertThat(chatCompletionContentPartText.promptCacheBreakpoint())
+            .contains(ChatCompletionContentPartText.PromptCacheBreakpoint.builder().build())
     }
 
     @Test
     fun roundtrip() {
         val jsonMapper = jsonMapper()
         val chatCompletionContentPartText =
-            ChatCompletionContentPartText.builder().text("text").build()
+            ChatCompletionContentPartText.builder()
+                .text("text")
+                .promptCacheBreakpoint(
+                    ChatCompletionContentPartText.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
 
         val roundtrippedChatCompletionContentPartText =
             jsonMapper.readValue(
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionCreateParamsTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionCreateParamsTest.kt
index 145dbb25a..d65292619 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionCreateParamsTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionCreateParamsTest.kt
@@ -54,12 +54,42 @@ internal class ChatCompletionCreateParamsTest {
                     .build()
             )
             .addModality(ChatCompletionCreateParams.Modality.TEXT)
-            .moderation(ChatCompletionCreateParams.Moderation.builder().model("model").build())
+            .moderation(
+                ChatCompletionCreateParams.Moderation.builder()
+                    .model("model")
+                    .policy(
+                        ChatCompletionCreateParams.Moderation.Policy.builder()
+                            .input(
+                                ChatCompletionCreateParams.Moderation.Policy.Input.builder()
+                                    .mode(
+                                        ChatCompletionCreateParams.Moderation.Policy.Input.Mode
+                                            .SCORE
+                                    )
+                                    .build()
+                            )
+                            .output(
+                                ChatCompletionCreateParams.Moderation.Policy.Output.builder()
+                                    .mode(
+                                        ChatCompletionCreateParams.Moderation.Policy.Output.Mode
+                                            .SCORE
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .build()
+            )
             .n(1L)
             .parallelToolCalls(true)
             .prediction(ChatCompletionPredictionContent.builder().content("string").build())
             .presencePenalty(-2.0)
             .promptCacheKey("prompt-cache-key-1234")
+            .promptCacheOptions(
+                ChatCompletionCreateParams.PromptCacheOptions.builder()
+                    .mode(ChatCompletionCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                    .ttl(ChatCompletionCreateParams.PromptCacheOptions.Ttl._30M)
+                    .build()
+            )
             .promptCacheRetention(ChatCompletionCreateParams.PromptCacheRetention.IN_MEMORY)
             .reasoningEffort(ReasoningEffort.NONE)
             .responseFormat(ResponseFormatText.builder().build())
@@ -159,12 +189,42 @@ internal class ChatCompletionCreateParamsTest {
                         .build()
                 )
                 .addModality(ChatCompletionCreateParams.Modality.TEXT)
-                .moderation(ChatCompletionCreateParams.Moderation.builder().model("model").build())
+                .moderation(
+                    ChatCompletionCreateParams.Moderation.builder()
+                        .model("model")
+                        .policy(
+                            ChatCompletionCreateParams.Moderation.Policy.builder()
+                                .input(
+                                    ChatCompletionCreateParams.Moderation.Policy.Input.builder()
+                                        .mode(
+                                            ChatCompletionCreateParams.Moderation.Policy.Input.Mode
+                                                .SCORE
+                                        )
+                                        .build()
+                                )
+                                .output(
+                                    ChatCompletionCreateParams.Moderation.Policy.Output.builder()
+                                        .mode(
+                                            ChatCompletionCreateParams.Moderation.Policy.Output.Mode
+                                                .SCORE
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
                 .n(1L)
                 .parallelToolCalls(true)
                 .prediction(ChatCompletionPredictionContent.builder().content("string").build())
                 .presencePenalty(-2.0)
                 .promptCacheKey("prompt-cache-key-1234")
+                .promptCacheOptions(
+                    ChatCompletionCreateParams.PromptCacheOptions.builder()
+                        .mode(ChatCompletionCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                        .ttl(ChatCompletionCreateParams.PromptCacheOptions.Ttl._30M)
+                        .build()
+                )
                 .promptCacheRetention(ChatCompletionCreateParams.PromptCacheRetention.IN_MEMORY)
                 .reasoningEffort(ReasoningEffort.NONE)
                 .responseFormat(ResponseFormatText.builder().build())
@@ -276,13 +336,44 @@ internal class ChatCompletionCreateParamsTest {
         assertThat(body.modalities().getOrNull())
             .containsExactly(ChatCompletionCreateParams.Modality.TEXT)
         assertThat(body.moderation())
-            .contains(ChatCompletionCreateParams.Moderation.builder().model("model").build())
+            .contains(
+                ChatCompletionCreateParams.Moderation.builder()
+                    .model("model")
+                    .policy(
+                        ChatCompletionCreateParams.Moderation.Policy.builder()
+                            .input(
+                                ChatCompletionCreateParams.Moderation.Policy.Input.builder()
+                                    .mode(
+                                        ChatCompletionCreateParams.Moderation.Policy.Input.Mode
+                                            .SCORE
+                                    )
+                                    .build()
+                            )
+                            .output(
+                                ChatCompletionCreateParams.Moderation.Policy.Output.builder()
+                                    .mode(
+                                        ChatCompletionCreateParams.Moderation.Policy.Output.Mode
+                                            .SCORE
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .build()
+            )
         assertThat(body.n()).contains(1L)
         assertThat(body.parallelToolCalls()).contains(true)
         assertThat(body.prediction())
             .contains(ChatCompletionPredictionContent.builder().content("string").build())
         assertThat(body.presencePenalty()).contains(-2.0)
         assertThat(body.promptCacheKey()).contains("prompt-cache-key-1234")
+        assertThat(body.promptCacheOptions())
+            .contains(
+                ChatCompletionCreateParams.PromptCacheOptions.builder()
+                    .mode(ChatCompletionCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                    .ttl(ChatCompletionCreateParams.PromptCacheOptions.Ttl._30M)
+                    .build()
+            )
         assertThat(body.promptCacheRetention())
             .contains(ChatCompletionCreateParams.PromptCacheRetention.IN_MEMORY)
         assertThat(body.reasoningEffort()).contains(ReasoningEffort.NONE)
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionListPageResponseTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionListPageResponseTest.kt
index 1d33b4d09..57830dab5 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionListPageResponseTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionListPageResponseTest.kt
@@ -222,6 +222,7 @@ internal class ChatCompletionListPageResponseTest {
                                 .promptTokensDetails(
                                     CompletionUsage.PromptTokensDetails.builder()
                                         .audioTokens(0L)
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -429,6 +430,7 @@ internal class ChatCompletionListPageResponseTest {
                             .promptTokensDetails(
                                 CompletionUsage.PromptTokensDetails.builder()
                                     .audioTokens(0L)
+                                    .cacheWriteTokens(0L)
                                     .cachedTokens(0L)
                                     .build()
                             )
@@ -653,6 +655,7 @@ internal class ChatCompletionListPageResponseTest {
                                 .promptTokensDetails(
                                     CompletionUsage.PromptTokensDetails.builder()
                                         .audioTokens(0L)
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionStoreMessageTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionStoreMessageTest.kt
index 3c5381ca9..daec836ea 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionStoreMessageTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionStoreMessageTest.kt
@@ -54,7 +54,14 @@ internal class ChatCompletionStoreMessageTest {
                         .build()
                 )
                 .id("id")
-                .addContentPart(ChatCompletionContentPartText.builder().text("text").build())
+                .addContentPart(
+                    ChatCompletionContentPartText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            ChatCompletionContentPartText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
                 .build()
 
         assertThat(chatCompletionStoreMessage.content()).contains("content")
@@ -106,7 +113,12 @@ internal class ChatCompletionStoreMessageTest {
         assertThat(chatCompletionStoreMessage.contentParts().getOrNull())
             .containsExactly(
                 ChatCompletionStoreMessage.ContentPart.ofChatCompletionContentPartText(
-                    ChatCompletionContentPartText.builder().text("text").build()
+                    ChatCompletionContentPartText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            ChatCompletionContentPartText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
                 )
             )
     }
@@ -156,7 +168,14 @@ internal class ChatCompletionStoreMessageTest {
                         .build()
                 )
                 .id("id")
-                .addContentPart(ChatCompletionContentPartText.builder().text("text").build())
+                .addContentPart(
+                    ChatCompletionContentPartText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            ChatCompletionContentPartText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
                 .build()
 
         val roundtrippedChatCompletionStoreMessage =
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionTest.kt
index c37f5acbe..3481f8beb 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/ChatCompletionTest.kt
@@ -196,6 +196,7 @@ internal class ChatCompletionTest {
                         .promptTokensDetails(
                             CompletionUsage.PromptTokensDetails.builder()
                                 .audioTokens(0L)
+                                .cacheWriteTokens(0L)
                                 .cachedTokens(0L)
                                 .build()
                         )
@@ -382,6 +383,7 @@ internal class ChatCompletionTest {
                     .promptTokensDetails(
                         CompletionUsage.PromptTokensDetails.builder()
                             .audioTokens(0L)
+                            .cacheWriteTokens(0L)
                             .cachedTokens(0L)
                             .build()
                     )
@@ -575,6 +577,7 @@ internal class ChatCompletionTest {
                         .promptTokensDetails(
                             CompletionUsage.PromptTokensDetails.builder()
                                 .audioTokens(0L)
+                                .cacheWriteTokens(0L)
                                 .cachedTokens(0L)
                                 .build()
                         )
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/messages/MessageListPageResponseTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/messages/MessageListPageResponseTest.kt
index 706a289a6..34ba80597 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/messages/MessageListPageResponseTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/messages/MessageListPageResponseTest.kt
@@ -61,7 +61,13 @@ internal class MessageListPageResponseTest {
                         )
                         .id("id")
                         .addContentPart(
-                            ChatCompletionContentPartText.builder().text("text").build()
+                            ChatCompletionContentPartText.builder()
+                                .text("text")
+                                .promptCacheBreakpoint(
+                                    ChatCompletionContentPartText.PromptCacheBreakpoint.builder()
+                                        .build()
+                                )
+                                .build()
                         )
                         .build()
                 )
@@ -113,7 +119,15 @@ internal class MessageListPageResponseTest {
                             .build()
                     )
                     .id("id")
-                    .addContentPart(ChatCompletionContentPartText.builder().text("text").build())
+                    .addContentPart(
+                        ChatCompletionContentPartText.builder()
+                            .text("text")
+                            .promptCacheBreakpoint(
+                                ChatCompletionContentPartText.PromptCacheBreakpoint.builder()
+                                    .build()
+                            )
+                            .build()
+                    )
                     .build()
             )
         assertThat(messageListPageResponse.firstId()).isEqualTo("first_id")
@@ -169,7 +183,13 @@ internal class MessageListPageResponseTest {
                         )
                         .id("id")
                         .addContentPart(
-                            ChatCompletionContentPartText.builder().text("text").build()
+                            ChatCompletionContentPartText.builder()
+                                .text("text")
+                                .promptCacheBreakpoint(
+                                    ChatCompletionContentPartText.PromptCacheBreakpoint.builder()
+                                        .build()
+                                )
+                                .build()
                         )
                         .build()
                 )
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/completions/CompletionTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/completions/CompletionTest.kt
index 880f395f4..81e2f2154 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/completions/CompletionTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/completions/CompletionTest.kt
@@ -53,6 +53,7 @@ internal class CompletionTest {
                         .promptTokensDetails(
                             CompletionUsage.PromptTokensDetails.builder()
                                 .audioTokens(0L)
+                                .cacheWriteTokens(0L)
                                 .cachedTokens(0L)
                                 .build()
                         )
@@ -101,6 +102,7 @@ internal class CompletionTest {
                     .promptTokensDetails(
                         CompletionUsage.PromptTokensDetails.builder()
                             .audioTokens(0L)
+                            .cacheWriteTokens(0L)
                             .cachedTokens(0L)
                             .build()
                     )
@@ -152,6 +154,7 @@ internal class CompletionTest {
                         .promptTokensDetails(
                             CompletionUsage.PromptTokensDetails.builder()
                                 .audioTokens(0L)
+                                .cacheWriteTokens(0L)
                                 .cachedTokens(0L)
                                 .build()
                         )
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/completions/CompletionUsageTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/completions/CompletionUsageTest.kt
index 9068bea23..9feecc4c5 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/completions/CompletionUsageTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/completions/CompletionUsageTest.kt
@@ -27,6 +27,7 @@ internal class CompletionUsageTest {
                 .promptTokensDetails(
                     CompletionUsage.PromptTokensDetails.builder()
                         .audioTokens(0L)
+                        .cacheWriteTokens(0L)
                         .cachedTokens(0L)
                         .build()
                 )
@@ -48,6 +49,7 @@ internal class CompletionUsageTest {
             .contains(
                 CompletionUsage.PromptTokensDetails.builder()
                     .audioTokens(0L)
+                    .cacheWriteTokens(0L)
                     .cachedTokens(0L)
                     .build()
             )
@@ -72,6 +74,7 @@ internal class CompletionUsageTest {
                 .promptTokensDetails(
                     CompletionUsage.PromptTokensDetails.builder()
                         .audioTokens(0L)
+                        .cacheWriteTokens(0L)
                         .cachedTokens(0L)
                         .build()
                 )
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/conversations/ComputerScreenshotContentTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/conversations/ComputerScreenshotContentTest.kt
index 33c65dc87..906eac84a 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/conversations/ComputerScreenshotContentTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/conversations/ComputerScreenshotContentTest.kt
@@ -16,12 +16,17 @@ internal class ComputerScreenshotContentTest {
                 .detail(ComputerScreenshotContent.Detail.LOW)
                 .fileId("file_id")
                 .imageUrl("https://example.com")
+                .promptCacheBreakpoint(
+                    ComputerScreenshotContent.PromptCacheBreakpoint.builder().build()
+                )
                 .build()
 
         assertThat(computerScreenshotContent.detail())
             .isEqualTo(ComputerScreenshotContent.Detail.LOW)
         assertThat(computerScreenshotContent.fileId()).contains("file_id")
         assertThat(computerScreenshotContent.imageUrl()).contains("https://example.com")
+        assertThat(computerScreenshotContent.promptCacheBreakpoint())
+            .contains(ComputerScreenshotContent.PromptCacheBreakpoint.builder().build())
     }
 
     @Test
@@ -32,6 +37,9 @@ internal class ComputerScreenshotContentTest {
                 .detail(ComputerScreenshotContent.Detail.LOW)
                 .fileId("file_id")
                 .imageUrl("https://example.com")
+                .promptCacheBreakpoint(
+                    ComputerScreenshotContent.PromptCacheBreakpoint.builder().build()
+                )
                 .build()
 
         val roundtrippedComputerScreenshotContent =
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/conversations/MessageTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/conversations/MessageTest.kt
index db242e069..04bbd06bb 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/conversations/MessageTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/conversations/MessageTest.kt
@@ -15,7 +15,14 @@ internal class MessageTest {
         val message =
             Message.builder()
                 .id("id")
-                .addInputTextContent("text")
+                .addContent(
+                    ResponseInputText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            ResponseInputText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
                 .role(Message.Role.UNKNOWN)
                 .status(Message.Status.IN_PROGRESS)
                 .phase(Message.Phase.COMMENTARY)
@@ -24,7 +31,14 @@ internal class MessageTest {
         assertThat(message.id()).isEqualTo("id")
         assertThat(message.content())
             .containsExactly(
-                Message.Content.ofInputText(ResponseInputText.builder().text("text").build())
+                Message.Content.ofInputText(
+                    ResponseInputText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            ResponseInputText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
             )
         assertThat(message.role()).isEqualTo(Message.Role.UNKNOWN)
         assertThat(message.status()).isEqualTo(Message.Status.IN_PROGRESS)
@@ -37,7 +51,14 @@ internal class MessageTest {
         val message =
             Message.builder()
                 .id("id")
-                .addInputTextContent("text")
+                .addContent(
+                    ResponseInputText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            ResponseInputText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
                 .role(Message.Role.UNKNOWN)
                 .status(Message.Status.IN_PROGRESS)
                 .phase(Message.Phase.COMMENTARY)
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/conversations/items/ConversationItemListTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/conversations/items/ConversationItemListTest.kt
index 135473c92..5a4b4d014 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/conversations/items/ConversationItemListTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/conversations/items/ConversationItemListTest.kt
@@ -5,6 +5,7 @@ package com.openai.models.conversations.items
 import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
 import com.openai.core.jsonMapper
 import com.openai.models.conversations.Message
+import com.openai.models.responses.ResponseInputText
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
 
@@ -17,7 +18,14 @@ internal class ConversationItemListTest {
                 .addData(
                     Message.builder()
                         .id("id")
-                        .addInputTextContent("text")
+                        .addContent(
+                            ResponseInputText.builder()
+                                .text("text")
+                                .promptCacheBreakpoint(
+                                    ResponseInputText.PromptCacheBreakpoint.builder().build()
+                                )
+                                .build()
+                        )
                         .role(Message.Role.UNKNOWN)
                         .status(Message.Status.IN_PROGRESS)
                         .phase(Message.Phase.COMMENTARY)
@@ -33,7 +41,14 @@ internal class ConversationItemListTest {
                 ConversationItem.ofMessage(
                     Message.builder()
                         .id("id")
-                        .addInputTextContent("text")
+                        .addContent(
+                            ResponseInputText.builder()
+                                .text("text")
+                                .promptCacheBreakpoint(
+                                    ResponseInputText.PromptCacheBreakpoint.builder().build()
+                                )
+                                .build()
+                        )
                         .role(Message.Role.UNKNOWN)
                         .status(Message.Status.IN_PROGRESS)
                         .phase(Message.Phase.COMMENTARY)
@@ -53,7 +68,14 @@ internal class ConversationItemListTest {
                 .addData(
                     Message.builder()
                         .id("id")
-                        .addInputTextContent("text")
+                        .addContent(
+                            ResponseInputText.builder()
+                                .text("text")
+                                .promptCacheBreakpoint(
+                                    ResponseInputText.PromptCacheBreakpoint.builder().build()
+                                )
+                                .build()
+                        )
                         .role(Message.Role.UNKNOWN)
                         .status(Message.Status.IN_PROGRESS)
                         .phase(Message.Phase.COMMENTARY)
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/conversations/items/ConversationItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/conversations/items/ConversationItemTest.kt
index 48d3f9456..cbaa8a534 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/conversations/items/ConversationItemTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/conversations/items/ConversationItemTest.kt
@@ -25,6 +25,7 @@ import com.openai.models.responses.ResponseFunctionToolCall
 import com.openai.models.responses.ResponseFunctionToolCallItem
 import com.openai.models.responses.ResponseFunctionToolCallOutputItem
 import com.openai.models.responses.ResponseFunctionWebSearch
+import com.openai.models.responses.ResponseInputText
 import com.openai.models.responses.ResponseLocalEnvironment
 import com.openai.models.responses.ResponseReasoningItem
 import com.openai.models.responses.ResponseToolSearchCall
@@ -42,7 +43,14 @@ internal class ConversationItemTest {
         val message =
             Message.builder()
                 .id("id")
-                .addInputTextContent("text")
+                .addContent(
+                    ResponseInputText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            ResponseInputText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
                 .role(Message.Role.UNKNOWN)
                 .status(Message.Status.IN_PROGRESS)
                 .phase(Message.Phase.COMMENTARY)
@@ -62,6 +70,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -85,7 +95,14 @@ internal class ConversationItemTest {
             ConversationItem.ofMessage(
                 Message.builder()
                     .id("id")
-                    .addInputTextContent("text")
+                    .addContent(
+                        ResponseInputText.builder()
+                            .text("text")
+                            .promptCacheBreakpoint(
+                                ResponseInputText.PromptCacheBreakpoint.builder().build()
+                            )
+                            .build()
+                    )
                     .role(Message.Role.UNKNOWN)
                     .status(Message.Status.IN_PROGRESS)
                     .phase(Message.Phase.COMMENTARY)
@@ -109,6 +126,7 @@ internal class ConversationItemTest {
                 .callId("call_id")
                 .name("name")
                 .id("id")
+                .callerDirect()
                 .namespace("namespace")
                 .status(ResponseFunctionToolCall.Status.IN_PROGRESS)
                 .createdBy("created_by")
@@ -128,6 +146,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -154,6 +174,7 @@ internal class ConversationItemTest {
                     .callId("call_id")
                     .name("name")
                     .id("id")
+                    .callerDirect()
                     .namespace("namespace")
                     .status(ResponseFunctionToolCall.Status.IN_PROGRESS)
                     .createdBy("created_by")
@@ -177,6 +198,7 @@ internal class ConversationItemTest {
                 .callId("call_id")
                 .output("string")
                 .status(ResponseFunctionToolCallOutputItem.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
@@ -194,6 +216,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -220,6 +244,7 @@ internal class ConversationItemTest {
                     .callId("call_id")
                     .output("string")
                     .status(ResponseFunctionToolCallOutputItem.Status.IN_PROGRESS)
+                    .callerDirect()
                     .createdBy("created_by")
                     .build()
             )
@@ -269,6 +294,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -352,6 +379,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -422,6 +451,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -506,6 +537,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -604,6 +637,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -681,6 +716,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -738,8 +775,14 @@ internal class ConversationItemTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .createdBy("created_by")
@@ -759,6 +802,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).contains(toolSearchOutput)
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -794,8 +839,14 @@ internal class ConversationItemTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .createdBy("created_by")
@@ -826,8 +877,14 @@ internal class ConversationItemTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .build()
@@ -846,6 +903,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).contains(additionalTools)
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -879,8 +938,14 @@ internal class ConversationItemTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .build()
@@ -920,6 +985,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).contains(reasoning)
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -959,6 +1026,134 @@ internal class ConversationItemTest {
         assertThat(roundtrippedConversationItem).isEqualTo(conversationItem)
     }
 
+    @Test
+    fun ofProgram() {
+        val program =
+            ConversationItem.Program.builder()
+                .id("id")
+                .callId("call_id")
+                .code("code")
+                .fingerprint("fingerprint")
+                .build()
+
+        val conversationItem = ConversationItem.ofProgram(program)
+
+        assertThat(conversationItem.message()).isEmpty
+        assertThat(conversationItem.functionCall()).isEmpty
+        assertThat(conversationItem.functionCallOutput()).isEmpty
+        assertThat(conversationItem.fileSearchCall()).isEmpty
+        assertThat(conversationItem.webSearchCall()).isEmpty
+        assertThat(conversationItem.imageGenerationCall()).isEmpty
+        assertThat(conversationItem.computerCall()).isEmpty
+        assertThat(conversationItem.computerCallOutput()).isEmpty
+        assertThat(conversationItem.toolSearchCall()).isEmpty
+        assertThat(conversationItem.toolSearchOutput()).isEmpty
+        assertThat(conversationItem.additionalTools()).isEmpty
+        assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).contains(program)
+        assertThat(conversationItem.programOutput()).isEmpty
+        assertThat(conversationItem.compaction()).isEmpty
+        assertThat(conversationItem.codeInterpreterCall()).isEmpty
+        assertThat(conversationItem.localShellCall()).isEmpty
+        assertThat(conversationItem.localShellCallOutput()).isEmpty
+        assertThat(conversationItem.shellCall()).isEmpty
+        assertThat(conversationItem.shellCallOutput()).isEmpty
+        assertThat(conversationItem.applyPatchCall()).isEmpty
+        assertThat(conversationItem.applyPatchCallOutput()).isEmpty
+        assertThat(conversationItem.mcpListTools()).isEmpty
+        assertThat(conversationItem.mcpApprovalRequest()).isEmpty
+        assertThat(conversationItem.mcpApprovalResponse()).isEmpty
+        assertThat(conversationItem.mcpCall()).isEmpty
+        assertThat(conversationItem.customToolCall()).isEmpty
+        assertThat(conversationItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofProgramRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val conversationItem =
+            ConversationItem.ofProgram(
+                ConversationItem.Program.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .code("code")
+                    .fingerprint("fingerprint")
+                    .build()
+            )
+
+        val roundtrippedConversationItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(conversationItem),
+                jacksonTypeRef<ConversationItem>(),
+            )
+
+        assertThat(roundtrippedConversationItem).isEqualTo(conversationItem)
+    }
+
+    @Test
+    fun ofProgramOutput() {
+        val programOutput =
+            ConversationItem.ProgramOutput.builder()
+                .id("id")
+                .callId("call_id")
+                .result("result")
+                .status(ConversationItem.ProgramOutput.Status.COMPLETED)
+                .build()
+
+        val conversationItem = ConversationItem.ofProgramOutput(programOutput)
+
+        assertThat(conversationItem.message()).isEmpty
+        assertThat(conversationItem.functionCall()).isEmpty
+        assertThat(conversationItem.functionCallOutput()).isEmpty
+        assertThat(conversationItem.fileSearchCall()).isEmpty
+        assertThat(conversationItem.webSearchCall()).isEmpty
+        assertThat(conversationItem.imageGenerationCall()).isEmpty
+        assertThat(conversationItem.computerCall()).isEmpty
+        assertThat(conversationItem.computerCallOutput()).isEmpty
+        assertThat(conversationItem.toolSearchCall()).isEmpty
+        assertThat(conversationItem.toolSearchOutput()).isEmpty
+        assertThat(conversationItem.additionalTools()).isEmpty
+        assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).contains(programOutput)
+        assertThat(conversationItem.compaction()).isEmpty
+        assertThat(conversationItem.codeInterpreterCall()).isEmpty
+        assertThat(conversationItem.localShellCall()).isEmpty
+        assertThat(conversationItem.localShellCallOutput()).isEmpty
+        assertThat(conversationItem.shellCall()).isEmpty
+        assertThat(conversationItem.shellCallOutput()).isEmpty
+        assertThat(conversationItem.applyPatchCall()).isEmpty
+        assertThat(conversationItem.applyPatchCallOutput()).isEmpty
+        assertThat(conversationItem.mcpListTools()).isEmpty
+        assertThat(conversationItem.mcpApprovalRequest()).isEmpty
+        assertThat(conversationItem.mcpApprovalResponse()).isEmpty
+        assertThat(conversationItem.mcpCall()).isEmpty
+        assertThat(conversationItem.customToolCall()).isEmpty
+        assertThat(conversationItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofProgramOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val conversationItem =
+            ConversationItem.ofProgramOutput(
+                ConversationItem.ProgramOutput.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .result("result")
+                    .status(ConversationItem.ProgramOutput.Status.COMPLETED)
+                    .build()
+            )
+
+        val roundtrippedConversationItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(conversationItem),
+                jacksonTypeRef<ConversationItem>(),
+            )
+
+        assertThat(roundtrippedConversationItem).isEqualTo(conversationItem)
+    }
+
     @Test
     fun ofCompaction() {
         val compaction =
@@ -982,6 +1177,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).contains(compaction)
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -1044,6 +1241,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).contains(codeInterpreterCall)
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -1119,6 +1318,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).contains(localShellCall)
@@ -1192,6 +1393,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -1244,6 +1447,7 @@ internal class ConversationItemTest {
                 .callId("call_id")
                 .environment(ResponseLocalEnvironment.builder().build())
                 .status(ResponseFunctionShellToolCall.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
@@ -1261,6 +1465,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -1294,6 +1500,7 @@ internal class ConversationItemTest {
                     .callId("call_id")
                     .environment(ResponseLocalEnvironment.builder().build())
                     .status(ResponseFunctionShellToolCall.Status.IN_PROGRESS)
+                    .callerDirect()
                     .createdBy("created_by")
                     .build()
             )
@@ -1323,6 +1530,7 @@ internal class ConversationItemTest {
                         .build()
                 )
                 .status(ResponseFunctionShellToolCallOutput.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
@@ -1340,6 +1548,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -1374,6 +1584,7 @@ internal class ConversationItemTest {
                             .build()
                     )
                     .status(ResponseFunctionShellToolCallOutput.Status.IN_PROGRESS)
+                    .callerDirect()
                     .createdBy("created_by")
                     .build()
             )
@@ -1400,6 +1611,7 @@ internal class ConversationItemTest {
                         .build()
                 )
                 .status(ResponseApplyPatchToolCall.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
@@ -1417,6 +1629,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -1448,6 +1662,7 @@ internal class ConversationItemTest {
                             .build()
                     )
                     .status(ResponseApplyPatchToolCall.Status.IN_PROGRESS)
+                    .callerDirect()
                     .createdBy("created_by")
                     .build()
             )
@@ -1468,6 +1683,7 @@ internal class ConversationItemTest {
                 .id("id")
                 .callId("call_id")
                 .status(ResponseApplyPatchToolCallOutput.Status.COMPLETED)
+                .callerDirect()
                 .createdBy("created_by")
                 .output("output")
                 .build()
@@ -1486,6 +1702,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -1511,6 +1729,7 @@ internal class ConversationItemTest {
                     .id("id")
                     .callId("call_id")
                     .status(ResponseApplyPatchToolCallOutput.Status.COMPLETED)
+                    .callerDirect()
                     .createdBy("created_by")
                     .output("output")
                     .build()
@@ -1556,6 +1775,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -1625,6 +1846,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -1687,6 +1910,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -1753,6 +1978,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -1803,6 +2030,7 @@ internal class ConversationItemTest {
                 .input("input")
                 .name("name")
                 .id("id")
+                .callerDirect()
                 .namespace("namespace")
                 .build()
 
@@ -1820,6 +2048,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -1846,6 +2076,7 @@ internal class ConversationItemTest {
                     .input("input")
                     .name("name")
                     .id("id")
+                    .callerDirect()
                     .namespace("namespace")
                     .build()
             )
@@ -1866,6 +2097,7 @@ internal class ConversationItemTest {
                 .callId("call_id")
                 .output("string")
                 .id("id")
+                .callerDirect()
                 .build()
 
         val conversationItem = ConversationItem.ofCustomToolCallOutput(customToolCallOutput)
@@ -1882,6 +2114,8 @@ internal class ConversationItemTest {
         assertThat(conversationItem.toolSearchOutput()).isEmpty
         assertThat(conversationItem.additionalTools()).isEmpty
         assertThat(conversationItem.reasoning()).isEmpty
+        assertThat(conversationItem.program()).isEmpty
+        assertThat(conversationItem.programOutput()).isEmpty
         assertThat(conversationItem.compaction()).isEmpty
         assertThat(conversationItem.codeInterpreterCall()).isEmpty
         assertThat(conversationItem.localShellCall()).isEmpty
@@ -1907,6 +2141,7 @@ internal class ConversationItemTest {
                     .callId("call_id")
                     .output("string")
                     .id("id")
+                    .callerDirect()
                     .build()
             )
 
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/graders/gradermodels/EvalContentItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/graders/gradermodels/EvalContentItemTest.kt
index b6028fc80..fec339aed 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/graders/gradermodels/EvalContentItemTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/graders/gradermodels/EvalContentItemTest.kt
@@ -45,7 +45,11 @@ internal class EvalContentItemTest {
 
     @Test
     fun ofResponseInputText() {
-        val responseInputText = ResponseInputText.builder().text("text").build()
+        val responseInputText =
+            ResponseInputText.builder()
+                .text("text")
+                .promptCacheBreakpoint(ResponseInputText.PromptCacheBreakpoint.builder().build())
+                .build()
 
         val evalContentItem = EvalContentItem.ofResponseInputText(responseInputText)
 
@@ -60,7 +64,14 @@ internal class EvalContentItemTest {
     fun ofResponseInputTextRoundtrip() {
         val jsonMapper = jsonMapper()
         val evalContentItem =
-            EvalContentItem.ofResponseInputText(ResponseInputText.builder().text("text").build())
+            EvalContentItem.ofResponseInputText(
+                ResponseInputText.builder()
+                    .text("text")
+                    .promptCacheBreakpoint(
+                        ResponseInputText.PromptCacheBreakpoint.builder().build()
+                    )
+                    .build()
+            )
 
         val roundtrippedEvalContentItem =
             jsonMapper.readValue(
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/realtime/RealtimeResponseCreateMcpToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/realtime/RealtimeResponseCreateMcpToolTest.kt
index 66cac84c2..225fd02d4 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/realtime/RealtimeResponseCreateMcpToolTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/realtime/RealtimeResponseCreateMcpToolTest.kt
@@ -5,6 +5,7 @@ package com.openai.models.realtime
 import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
 import com.openai.core.JsonValue
 import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
 
@@ -15,6 +16,7 @@ internal class RealtimeResponseCreateMcpToolTest {
         val realtimeResponseCreateMcpTool =
             RealtimeResponseCreateMcpTool.builder()
                 .serverLabel("server_label")
+                .addAllowedCaller(RealtimeResponseCreateMcpTool.AllowedCaller.DIRECT)
                 .allowedToolsOfMcp(listOf("string"))
                 .authorization("authorization")
                 .connectorId(RealtimeResponseCreateMcpTool.ConnectorId.CONNECTOR_DROPBOX)
@@ -33,6 +35,8 @@ internal class RealtimeResponseCreateMcpToolTest {
                 .build()
 
         assertThat(realtimeResponseCreateMcpTool.serverLabel()).isEqualTo("server_label")
+        assertThat(realtimeResponseCreateMcpTool.allowedCallers().getOrNull())
+            .containsExactly(RealtimeResponseCreateMcpTool.AllowedCaller.DIRECT)
         assertThat(realtimeResponseCreateMcpTool.allowedTools())
             .contains(RealtimeResponseCreateMcpTool.AllowedTools.ofMcp(listOf("string")))
         assertThat(realtimeResponseCreateMcpTool.authorization()).contains("authorization")
@@ -63,6 +67,7 @@ internal class RealtimeResponseCreateMcpToolTest {
         val realtimeResponseCreateMcpTool =
             RealtimeResponseCreateMcpTool.builder()
                 .serverLabel("server_label")
+                .addAllowedCaller(RealtimeResponseCreateMcpTool.AllowedCaller.DIRECT)
                 .allowedToolsOfMcp(listOf("string"))
                 .authorization("authorization")
                 .connectorId(RealtimeResponseCreateMcpTool.ConnectorId.CONNECTOR_DROPBOX)
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/realtime/RealtimeToolsConfigUnionTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/realtime/RealtimeToolsConfigUnionTest.kt
index fc3308a4e..cd6668bc3 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/realtime/RealtimeToolsConfigUnionTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/realtime/RealtimeToolsConfigUnionTest.kt
@@ -57,6 +57,7 @@ internal class RealtimeToolsConfigUnionTest {
         val mcp =
             RealtimeToolsConfigUnion.Mcp.builder()
                 .serverLabel("server_label")
+                .addAllowedCaller(RealtimeToolsConfigUnion.Mcp.AllowedCaller.DIRECT)
                 .allowedToolsOfMcp(listOf("string"))
                 .authorization("authorization")
                 .connectorId(RealtimeToolsConfigUnion.Mcp.ConnectorId.CONNECTOR_DROPBOX)
@@ -87,6 +88,7 @@ internal class RealtimeToolsConfigUnionTest {
             RealtimeToolsConfigUnion.ofMcp(
                 RealtimeToolsConfigUnion.Mcp.builder()
                     .serverLabel("server_label")
+                    .addAllowedCaller(RealtimeToolsConfigUnion.Mcp.AllowedCaller.DIRECT)
                     .allowedToolsOfMcp(listOf("string"))
                     .authorization("authorization")
                     .connectorId(RealtimeToolsConfigUnion.Mcp.ConnectorId.CONNECTOR_DROPBOX)
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ApplyPatchToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ApplyPatchToolTest.kt
index 08c6882d0..def922a66 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ApplyPatchToolTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ApplyPatchToolTest.kt
@@ -4,6 +4,7 @@ package com.openai.models.responses
 
 import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
 import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
 
@@ -11,13 +12,18 @@ internal class ApplyPatchToolTest {
 
     @Test
     fun create() {
-        val applyPatchTool = ApplyPatchTool.builder().build()
+        val applyPatchTool =
+            ApplyPatchTool.builder().addAllowedCaller(ApplyPatchTool.AllowedCaller.DIRECT).build()
+
+        assertThat(applyPatchTool.allowedCallers().getOrNull())
+            .containsExactly(ApplyPatchTool.AllowedCaller.DIRECT)
     }
 
     @Test
     fun roundtrip() {
         val jsonMapper = jsonMapper()
-        val applyPatchTool = ApplyPatchTool.builder().build()
+        val applyPatchTool =
+            ApplyPatchTool.builder().addAllowedCaller(ApplyPatchTool.AllowedCaller.DIRECT).build()
 
         val roundtrippedApplyPatchTool =
             jsonMapper.readValue(
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/CompactedResponseTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/CompactedResponseTest.kt
index 4c5377dbd..177fa8175 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/CompactedResponseTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/CompactedResponseTest.kt
@@ -52,7 +52,10 @@ internal class CompactedResponseTest {
                     ResponseUsage.builder()
                         .inputTokens(0L)
                         .inputTokensDetails(
-                            ResponseUsage.InputTokensDetails.builder().cachedTokens(0L).build()
+                            ResponseUsage.InputTokensDetails.builder()
+                                .cacheWriteTokens(0L)
+                                .cachedTokens(0L)
+                                .build()
                         )
                         .outputTokens(0L)
                         .outputTokensDetails(
@@ -106,7 +109,10 @@ internal class CompactedResponseTest {
                 ResponseUsage.builder()
                     .inputTokens(0L)
                     .inputTokensDetails(
-                        ResponseUsage.InputTokensDetails.builder().cachedTokens(0L).build()
+                        ResponseUsage.InputTokensDetails.builder()
+                            .cacheWriteTokens(0L)
+                            .cachedTokens(0L)
+                            .build()
                     )
                     .outputTokens(0L)
                     .outputTokensDetails(
@@ -161,7 +167,10 @@ internal class CompactedResponseTest {
                     ResponseUsage.builder()
                         .inputTokens(0L)
                         .inputTokensDetails(
-                            ResponseUsage.InputTokensDetails.builder().cachedTokens(0L).build()
+                            ResponseUsage.InputTokensDetails.builder()
+                                .cacheWriteTokens(0L)
+                                .cachedTokens(0L)
+                                .build()
                         )
                         .outputTokens(0L)
                         .outputTokensDetails(
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/CustomToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/CustomToolTest.kt
index 0de19049a..2288a5fa8 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/CustomToolTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/CustomToolTest.kt
@@ -5,6 +5,7 @@ package com.openai.models.responses
 import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
 import com.openai.core.jsonMapper
 import com.openai.models.CustomToolInputFormat
+import kotlin.jvm.optionals.getOrNull
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
 
@@ -15,12 +16,15 @@ internal class CustomToolTest {
         val customTool =
             CustomTool.builder()
                 .name("name")
+                .addAllowedCaller(CustomTool.AllowedCaller.DIRECT)
                 .deferLoading(true)
                 .description("description")
                 .formatText()
                 .build()
 
         assertThat(customTool.name()).isEqualTo("name")
+        assertThat(customTool.allowedCallers().getOrNull())
+            .containsExactly(CustomTool.AllowedCaller.DIRECT)
         assertThat(customTool.deferLoading()).contains(true)
         assertThat(customTool.description()).contains("description")
         assertThat(customTool.format()).contains(CustomToolInputFormat.ofText())
@@ -32,6 +36,7 @@ internal class CustomToolTest {
         val customTool =
             CustomTool.builder()
                 .name("name")
+                .addAllowedCaller(CustomTool.AllowedCaller.DIRECT)
                 .deferLoading(true)
                 .description("description")
                 .formatText()
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/FunctionShellToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/FunctionShellToolTest.kt
index 625d48bbd..6addacccd 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/FunctionShellToolTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/FunctionShellToolTest.kt
@@ -4,6 +4,7 @@ package com.openai.models.responses
 
 import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
 import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
 
@@ -13,6 +14,7 @@ internal class FunctionShellToolTest {
     fun create() {
         val functionShellTool =
             FunctionShellTool.builder()
+                .addAllowedCaller(FunctionShellTool.AllowedCaller.DIRECT)
                 .environment(
                     ContainerAuto.builder()
                         .addFileId("file-123")
@@ -23,6 +25,8 @@ internal class FunctionShellToolTest {
                 )
                 .build()
 
+        assertThat(functionShellTool.allowedCallers().getOrNull())
+            .containsExactly(FunctionShellTool.AllowedCaller.DIRECT)
         assertThat(functionShellTool.environment())
             .contains(
                 FunctionShellTool.Environment.ofContainerAuto(
@@ -41,6 +45,7 @@ internal class FunctionShellToolTest {
         val jsonMapper = jsonMapper()
         val functionShellTool =
             FunctionShellTool.builder()
+                .addAllowedCaller(FunctionShellTool.AllowedCaller.DIRECT)
                 .environment(
                     ContainerAuto.builder()
                         .addFileId("file-123")
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/FunctionToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/FunctionToolTest.kt
index e4ccf996d..a5dbf4d12 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/FunctionToolTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/FunctionToolTest.kt
@@ -5,6 +5,7 @@ package com.openai.models.responses
 import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
 import com.openai.core.JsonValue
 import com.openai.core.jsonMapper
+import kotlin.jvm.optionals.getOrNull
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
 
@@ -21,8 +22,14 @@ internal class FunctionToolTest {
                         .build()
                 )
                 .strict(true)
+                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                 .deferLoading(true)
                 .description("description")
+                .outputSchema(
+                    FunctionTool.OutputSchema.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                        .build()
+                )
                 .build()
 
         assertThat(functionTool.name()).isEqualTo("name")
@@ -33,8 +40,16 @@ internal class FunctionToolTest {
                     .build()
             )
         assertThat(functionTool.strict()).contains(true)
+        assertThat(functionTool.allowedCallers().getOrNull())
+            .containsExactly(FunctionTool.AllowedCaller.DIRECT)
         assertThat(functionTool.deferLoading()).contains(true)
         assertThat(functionTool.description()).contains("description")
+        assertThat(functionTool.outputSchema())
+            .contains(
+                FunctionTool.OutputSchema.builder()
+                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                    .build()
+            )
     }
 
     @Test
@@ -49,8 +64,14 @@ internal class FunctionToolTest {
                         .build()
                 )
                 .strict(true)
+                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                 .deferLoading(true)
                 .description("description")
+                .outputSchema(
+                    FunctionTool.OutputSchema.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                        .build()
+                )
                 .build()
 
         val roundtrippedFunctionTool =
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/NamespaceToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/NamespaceToolTest.kt
index 4bc1bd593..1f5022e87 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/NamespaceToolTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/NamespaceToolTest.kt
@@ -19,8 +19,14 @@ internal class NamespaceToolTest {
                 .addTool(
                     NamespaceTool.Tool.Function.builder()
                         .name("name")
+                        .addAllowedCaller(NamespaceTool.Tool.Function.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            NamespaceTool.Tool.Function.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .parameters(JsonValue.from(mapOf<String, Any>()))
                         .strict(true)
                         .build()
@@ -34,8 +40,14 @@ internal class NamespaceToolTest {
                 NamespaceTool.Tool.ofFunction(
                     NamespaceTool.Tool.Function.builder()
                         .name("name")
+                        .addAllowedCaller(NamespaceTool.Tool.Function.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            NamespaceTool.Tool.Function.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .parameters(JsonValue.from(mapOf<String, Any>()))
                         .strict(true)
                         .build()
@@ -53,8 +65,14 @@ internal class NamespaceToolTest {
                 .addTool(
                     NamespaceTool.Tool.Function.builder()
                         .name("name")
+                        .addAllowedCaller(NamespaceTool.Tool.Function.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            NamespaceTool.Tool.Function.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .parameters(JsonValue.from(mapOf<String, Any>()))
                         .strict(true)
                         .build()
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseApplyPatchToolCallOutputTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseApplyPatchToolCallOutputTest.kt
index 069e965f7..d0281961a 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseApplyPatchToolCallOutputTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseApplyPatchToolCallOutputTest.kt
@@ -16,6 +16,7 @@ internal class ResponseApplyPatchToolCallOutputTest {
                 .id("id")
                 .callId("call_id")
                 .status(ResponseApplyPatchToolCallOutput.Status.COMPLETED)
+                .callerDirect()
                 .createdBy("created_by")
                 .output("output")
                 .build()
@@ -24,6 +25,8 @@ internal class ResponseApplyPatchToolCallOutputTest {
         assertThat(responseApplyPatchToolCallOutput.callId()).isEqualTo("call_id")
         assertThat(responseApplyPatchToolCallOutput.status())
             .isEqualTo(ResponseApplyPatchToolCallOutput.Status.COMPLETED)
+        assertThat(responseApplyPatchToolCallOutput.caller())
+            .contains(ResponseApplyPatchToolCallOutput.Caller.ofDirect())
         assertThat(responseApplyPatchToolCallOutput.createdBy()).contains("created_by")
         assertThat(responseApplyPatchToolCallOutput.output()).contains("output")
     }
@@ -36,6 +39,7 @@ internal class ResponseApplyPatchToolCallOutputTest {
                 .id("id")
                 .callId("call_id")
                 .status(ResponseApplyPatchToolCallOutput.Status.COMPLETED)
+                .callerDirect()
                 .createdBy("created_by")
                 .output("output")
                 .build()
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseApplyPatchToolCallTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseApplyPatchToolCallTest.kt
index 22de50698..3291c5db5 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseApplyPatchToolCallTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseApplyPatchToolCallTest.kt
@@ -22,6 +22,7 @@ internal class ResponseApplyPatchToolCallTest {
                         .build()
                 )
                 .status(ResponseApplyPatchToolCall.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
@@ -38,6 +39,8 @@ internal class ResponseApplyPatchToolCallTest {
             )
         assertThat(responseApplyPatchToolCall.status())
             .isEqualTo(ResponseApplyPatchToolCall.Status.IN_PROGRESS)
+        assertThat(responseApplyPatchToolCall.caller())
+            .contains(ResponseApplyPatchToolCall.Caller.ofDirect())
         assertThat(responseApplyPatchToolCall.createdBy()).contains("created_by")
     }
 
@@ -55,6 +58,7 @@ internal class ResponseApplyPatchToolCallTest {
                         .build()
                 )
                 .status(ResponseApplyPatchToolCall.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCompactParamsTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCompactParamsTest.kt
index 4335ad412..4cf740f56 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCompactParamsTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCompactParamsTest.kt
@@ -10,11 +10,17 @@ internal class ResponseCompactParamsTest {
     @Test
     fun create() {
         ResponseCompactParams.builder()
-            .model(ResponseCompactParams.Model.GPT_5_4)
+            .model(ResponseCompactParams.Model.GPT_5_6_SOL)
             .input("string")
             .instructions("instructions")
             .previousResponseId("resp_123")
             .promptCacheKey("prompt_cache_key")
+            .promptCacheOptions(
+                ResponseCompactParams.PromptCacheOptions.builder()
+                    .mode(ResponseCompactParams.PromptCacheOptions.Mode.IMPLICIT)
+                    .ttl(ResponseCompactParams.PromptCacheOptions.Ttl._30M)
+                    .build()
+            )
             .promptCacheRetention(ResponseCompactParams.PromptCacheRetention.IN_MEMORY)
             .serviceTier(ResponseCompactParams.ServiceTier.AUTO)
             .build()
@@ -24,22 +30,35 @@ internal class ResponseCompactParamsTest {
     fun body() {
         val params =
             ResponseCompactParams.builder()
-                .model(ResponseCompactParams.Model.GPT_5_4)
+                .model(ResponseCompactParams.Model.GPT_5_6_SOL)
                 .input("string")
                 .instructions("instructions")
                 .previousResponseId("resp_123")
                 .promptCacheKey("prompt_cache_key")
+                .promptCacheOptions(
+                    ResponseCompactParams.PromptCacheOptions.builder()
+                        .mode(ResponseCompactParams.PromptCacheOptions.Mode.IMPLICIT)
+                        .ttl(ResponseCompactParams.PromptCacheOptions.Ttl._30M)
+                        .build()
+                )
                 .promptCacheRetention(ResponseCompactParams.PromptCacheRetention.IN_MEMORY)
                 .serviceTier(ResponseCompactParams.ServiceTier.AUTO)
                 .build()
 
         val body = params._body()
 
-        assertThat(body.model()).contains(ResponseCompactParams.Model.GPT_5_4)
+        assertThat(body.model()).contains(ResponseCompactParams.Model.GPT_5_6_SOL)
         assertThat(body.input()).contains(ResponseCompactParams.Input.ofString("string"))
         assertThat(body.instructions()).contains("instructions")
         assertThat(body.previousResponseId()).contains("resp_123")
         assertThat(body.promptCacheKey()).contains("prompt_cache_key")
+        assertThat(body.promptCacheOptions())
+            .contains(
+                ResponseCompactParams.PromptCacheOptions.builder()
+                    .mode(ResponseCompactParams.PromptCacheOptions.Mode.IMPLICIT)
+                    .ttl(ResponseCompactParams.PromptCacheOptions.Ttl._30M)
+                    .build()
+            )
         assertThat(body.promptCacheRetention())
             .contains(ResponseCompactParams.PromptCacheRetention.IN_MEMORY)
         assertThat(body.serviceTier()).contains(ResponseCompactParams.ServiceTier.AUTO)
@@ -48,10 +67,10 @@ internal class ResponseCompactParamsTest {
     @Test
     fun bodyWithoutOptionalFields() {
         val params =
-            ResponseCompactParams.builder().model(ResponseCompactParams.Model.GPT_5_4).build()
+            ResponseCompactParams.builder().model(ResponseCompactParams.Model.GPT_5_6_SOL).build()
 
         val body = params._body()
 
-        assertThat(body.model()).contains(ResponseCompactParams.Model.GPT_5_4)
+        assertThat(body.model()).contains(ResponseCompactParams.Model.GPT_5_6_SOL)
     }
 }
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCompletedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCompletedEventTest.kt
index e4357cdbc..2f5d6e24a 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCompletedEventTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCompletedEventTest.kt
@@ -85,8 +85,14 @@ internal class ResponseCompletedEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -170,12 +176,19 @@ internal class ResponseCompletedEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -195,6 +208,7 @@ internal class ResponseCompletedEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -281,8 +295,14 @@ internal class ResponseCompletedEventTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .topP(1.0)
@@ -364,12 +384,19 @@ internal class ResponseCompletedEventTest {
                             .build()
                     )
                     .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        Response.PromptCacheOptions.builder()
+                            .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(Response.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
                     .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                     .reasoning(
                         Reasoning.builder()
                             .context(Reasoning.Context.AUTO)
                             .effort(ReasoningEffort.NONE)
                             .generateSummary(Reasoning.GenerateSummary.AUTO)
+                            .mode(Reasoning.Mode.STANDARD)
                             .summary(Reasoning.Summary.AUTO)
                             .build()
                     )
@@ -388,7 +415,10 @@ internal class ResponseCompletedEventTest {
                         ResponseUsage.builder()
                             .inputTokens(0L)
                             .inputTokensDetails(
-                                ResponseUsage.InputTokensDetails.builder().cachedTokens(0L).build()
+                                ResponseUsage.InputTokensDetails.builder()
+                                    .cacheWriteTokens(0L)
+                                    .cachedTokens(0L)
+                                    .build()
                             )
                             .outputTokens(0L)
                             .outputTokensDetails(
@@ -477,8 +507,14 @@ internal class ResponseCompletedEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -562,12 +598,19 @@ internal class ResponseCompletedEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -587,6 +630,7 @@ internal class ResponseCompletedEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseContentTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseContentTest.kt
index cdedcf926..fcef86c9c 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseContentTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseContentTest.kt
@@ -16,7 +16,11 @@ internal class ResponseContentTest {
 
     @Test
     fun ofInputText() {
-        val inputText = ResponseInputText.builder().text("text").build()
+        val inputText =
+            ResponseInputText.builder()
+                .text("text")
+                .promptCacheBreakpoint(ResponseInputText.PromptCacheBreakpoint.builder().build())
+                .build()
 
         val responseContent = ResponseContent.ofInputText(inputText)
 
@@ -32,7 +36,14 @@ internal class ResponseContentTest {
     fun ofInputTextRoundtrip() {
         val jsonMapper = jsonMapper()
         val responseContent =
-            ResponseContent.ofInputText(ResponseInputText.builder().text("text").build())
+            ResponseContent.ofInputText(
+                ResponseInputText.builder()
+                    .text("text")
+                    .promptCacheBreakpoint(
+                        ResponseInputText.PromptCacheBreakpoint.builder().build()
+                    )
+                    .build()
+            )
 
         val roundtrippedResponseContent =
             jsonMapper.readValue(
@@ -50,6 +61,7 @@ internal class ResponseContentTest {
                 .detail(ResponseInputImage.Detail.LOW)
                 .fileId("file_id")
                 .imageUrl("https://example.com")
+                .promptCacheBreakpoint(ResponseInputImage.PromptCacheBreakpoint.builder().build())
                 .build()
 
         val responseContent = ResponseContent.ofInputImage(inputImage)
@@ -71,6 +83,9 @@ internal class ResponseContentTest {
                     .detail(ResponseInputImage.Detail.LOW)
                     .fileId("file_id")
                     .imageUrl("https://example.com")
+                    .promptCacheBreakpoint(
+                        ResponseInputImage.PromptCacheBreakpoint.builder().build()
+                    )
                     .build()
             )
 
@@ -87,11 +102,12 @@ internal class ResponseContentTest {
     fun ofInputFile() {
         val inputFile =
             ResponseInputFile.builder()
-                .detail(ResponseInputFile.Detail.LOW)
+                .detail(ResponseInputFile.Detail.AUTO)
                 .fileData("file_data")
                 .fileId("file_id")
                 .fileUrl("https://example.com")
                 .filename("filename")
+                .promptCacheBreakpoint(ResponseInputFile.PromptCacheBreakpoint.builder().build())
                 .build()
 
         val responseContent = ResponseContent.ofInputFile(inputFile)
@@ -110,11 +126,14 @@ internal class ResponseContentTest {
         val responseContent =
             ResponseContent.ofInputFile(
                 ResponseInputFile.builder()
-                    .detail(ResponseInputFile.Detail.LOW)
+                    .detail(ResponseInputFile.Detail.AUTO)
                     .fileData("file_data")
                     .fileId("file_id")
                     .fileUrl("https://example.com")
                     .filename("filename")
+                    .promptCacheBreakpoint(
+                        ResponseInputFile.PromptCacheBreakpoint.builder().build()
+                    )
                     .build()
             )
 
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCreateParamsTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCreateParamsTest.kt
index 4e7a040ed..b7c56a3c2 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCreateParamsTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCreateParamsTest.kt
@@ -36,7 +36,25 @@ internal class ResponseCreateParamsTest {
                     .build()
             )
             .model(ChatModel.GPT_5_1)
-            .moderation(ResponseCreateParams.Moderation.builder().model("model").build())
+            .moderation(
+                ResponseCreateParams.Moderation.builder()
+                    .model("model")
+                    .policy(
+                        ResponseCreateParams.Moderation.Policy.builder()
+                            .input(
+                                ResponseCreateParams.Moderation.Policy.Input.builder()
+                                    .mode(ResponseCreateParams.Moderation.Policy.Input.Mode.SCORE)
+                                    .build()
+                            )
+                            .output(
+                                ResponseCreateParams.Moderation.Policy.Output.builder()
+                                    .mode(ResponseCreateParams.Moderation.Policy.Output.Mode.SCORE)
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .build()
+            )
             .parallelToolCalls(true)
             .previousResponseId("previous_response_id")
             .prompt(
@@ -51,12 +69,19 @@ internal class ResponseCreateParamsTest {
                     .build()
             )
             .promptCacheKey("prompt-cache-key-1234")
+            .promptCacheOptions(
+                ResponseCreateParams.PromptCacheOptions.builder()
+                    .mode(ResponseCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                    .ttl(ResponseCreateParams.PromptCacheOptions.Ttl._30M)
+                    .build()
+            )
             .promptCacheRetention(ResponseCreateParams.PromptCacheRetention.IN_MEMORY)
             .reasoning(
                 Reasoning.builder()
                     .context(Reasoning.Context.AUTO)
                     .effort(ReasoningEffort.NONE)
                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                    .mode(Reasoning.Mode.STANDARD)
                     .summary(Reasoning.Summary.AUTO)
                     .build()
             )
@@ -83,8 +108,14 @@ internal class ResponseCreateParamsTest {
                             .build()
                     )
                     .strict(true)
+                    .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                     .deferLoading(true)
                     .description("description")
+                    .outputSchema(
+                        FunctionTool.OutputSchema.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                            .build()
+                    )
                     .build()
             )
             .topLogprobs(0L)
@@ -117,7 +148,29 @@ internal class ResponseCreateParamsTest {
                         .build()
                 )
                 .model(ChatModel.GPT_5_1)
-                .moderation(ResponseCreateParams.Moderation.builder().model("model").build())
+                .moderation(
+                    ResponseCreateParams.Moderation.builder()
+                        .model("model")
+                        .policy(
+                            ResponseCreateParams.Moderation.Policy.builder()
+                                .input(
+                                    ResponseCreateParams.Moderation.Policy.Input.builder()
+                                        .mode(
+                                            ResponseCreateParams.Moderation.Policy.Input.Mode.SCORE
+                                        )
+                                        .build()
+                                )
+                                .output(
+                                    ResponseCreateParams.Moderation.Policy.Output.builder()
+                                        .mode(
+                                            ResponseCreateParams.Moderation.Policy.Output.Mode.SCORE
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
                 .parallelToolCalls(true)
                 .previousResponseId("previous_response_id")
                 .prompt(
@@ -132,12 +185,19 @@ internal class ResponseCreateParamsTest {
                         .build()
                 )
                 .promptCacheKey("prompt-cache-key-1234")
+                .promptCacheOptions(
+                    ResponseCreateParams.PromptCacheOptions.builder()
+                        .mode(ResponseCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                        .ttl(ResponseCreateParams.PromptCacheOptions.Ttl._30M)
+                        .build()
+                )
                 .promptCacheRetention(ResponseCreateParams.PromptCacheRetention.IN_MEMORY)
                 .reasoning(
                     Reasoning.builder()
                         .context(Reasoning.Context.AUTO)
                         .effort(ReasoningEffort.NONE)
                         .generateSummary(Reasoning.GenerateSummary.AUTO)
+                        .mode(Reasoning.Mode.STANDARD)
                         .summary(Reasoning.Summary.AUTO)
                         .build()
                 )
@@ -164,8 +224,14 @@ internal class ResponseCreateParamsTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .topLogprobs(0L)
@@ -199,7 +265,25 @@ internal class ResponseCreateParamsTest {
             )
         assertThat(body.model()).contains(ResponsesModel.ofChat(ChatModel.GPT_5_1))
         assertThat(body.moderation())
-            .contains(ResponseCreateParams.Moderation.builder().model("model").build())
+            .contains(
+                ResponseCreateParams.Moderation.builder()
+                    .model("model")
+                    .policy(
+                        ResponseCreateParams.Moderation.Policy.builder()
+                            .input(
+                                ResponseCreateParams.Moderation.Policy.Input.builder()
+                                    .mode(ResponseCreateParams.Moderation.Policy.Input.Mode.SCORE)
+                                    .build()
+                            )
+                            .output(
+                                ResponseCreateParams.Moderation.Policy.Output.builder()
+                                    .mode(ResponseCreateParams.Moderation.Policy.Output.Mode.SCORE)
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .build()
+            )
         assertThat(body.parallelToolCalls()).contains(true)
         assertThat(body.previousResponseId()).contains("previous_response_id")
         assertThat(body.prompt())
@@ -215,6 +299,13 @@ internal class ResponseCreateParamsTest {
                     .build()
             )
         assertThat(body.promptCacheKey()).contains("prompt-cache-key-1234")
+        assertThat(body.promptCacheOptions())
+            .contains(
+                ResponseCreateParams.PromptCacheOptions.builder()
+                    .mode(ResponseCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                    .ttl(ResponseCreateParams.PromptCacheOptions.Ttl._30M)
+                    .build()
+            )
         assertThat(body.promptCacheRetention())
             .contains(ResponseCreateParams.PromptCacheRetention.IN_MEMORY)
         assertThat(body.reasoning())
@@ -223,6 +314,7 @@ internal class ResponseCreateParamsTest {
                     .context(Reasoning.Context.AUTO)
                     .effort(ReasoningEffort.NONE)
                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                    .mode(Reasoning.Mode.STANDARD)
                     .summary(Reasoning.Summary.AUTO)
                     .build()
             )
@@ -252,8 +344,14 @@ internal class ResponseCreateParamsTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
             )
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCreatedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCreatedEventTest.kt
index 9a8bf133a..dabcfcdcf 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCreatedEventTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCreatedEventTest.kt
@@ -85,8 +85,14 @@ internal class ResponseCreatedEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -170,12 +176,19 @@ internal class ResponseCreatedEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -195,6 +208,7 @@ internal class ResponseCreatedEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -281,8 +295,14 @@ internal class ResponseCreatedEventTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .topP(1.0)
@@ -364,12 +384,19 @@ internal class ResponseCreatedEventTest {
                             .build()
                     )
                     .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        Response.PromptCacheOptions.builder()
+                            .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(Response.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
                     .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                     .reasoning(
                         Reasoning.builder()
                             .context(Reasoning.Context.AUTO)
                             .effort(ReasoningEffort.NONE)
                             .generateSummary(Reasoning.GenerateSummary.AUTO)
+                            .mode(Reasoning.Mode.STANDARD)
                             .summary(Reasoning.Summary.AUTO)
                             .build()
                     )
@@ -388,7 +415,10 @@ internal class ResponseCreatedEventTest {
                         ResponseUsage.builder()
                             .inputTokens(0L)
                             .inputTokensDetails(
-                                ResponseUsage.InputTokensDetails.builder().cachedTokens(0L).build()
+                                ResponseUsage.InputTokensDetails.builder()
+                                    .cacheWriteTokens(0L)
+                                    .cachedTokens(0L)
+                                    .build()
                             )
                             .outputTokens(0L)
                             .outputTokensDetails(
@@ -477,8 +507,14 @@ internal class ResponseCreatedEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -562,12 +598,19 @@ internal class ResponseCreatedEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -587,6 +630,7 @@ internal class ResponseCreatedEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCustomToolCallItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCustomToolCallItemTest.kt
index 2c3fcd9c2..22f004616 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCustomToolCallItemTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCustomToolCallItemTest.kt
@@ -17,6 +17,7 @@ internal class ResponseCustomToolCallItemTest {
                 .input("input")
                 .name("name")
                 .id("id")
+                .callerDirect()
                 .namespace("namespace")
                 .status(ResponseCustomToolCallItem.Status.IN_PROGRESS)
                 .createdBy("created_by")
@@ -26,6 +27,8 @@ internal class ResponseCustomToolCallItemTest {
         assertThat(responseCustomToolCallItem.input()).isEqualTo("input")
         assertThat(responseCustomToolCallItem.name()).isEqualTo("name")
         assertThat(responseCustomToolCallItem.id()).contains("id")
+        assertThat(responseCustomToolCallItem.caller())
+            .contains(ResponseCustomToolCall.Caller.ofDirect())
         assertThat(responseCustomToolCallItem.namespace()).contains("namespace")
         assertThat(responseCustomToolCallItem.status())
             .isEqualTo(ResponseCustomToolCallItem.Status.IN_PROGRESS)
@@ -41,6 +44,7 @@ internal class ResponseCustomToolCallItemTest {
                 .input("input")
                 .name("name")
                 .id("id")
+                .callerDirect()
                 .namespace("namespace")
                 .status(ResponseCustomToolCallItem.Status.IN_PROGRESS)
                 .createdBy("created_by")
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCustomToolCallOutputItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCustomToolCallOutputItemTest.kt
index c823c2654..495ffe61a 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCustomToolCallOutputItemTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCustomToolCallOutputItemTest.kt
@@ -16,6 +16,7 @@ internal class ResponseCustomToolCallOutputItemTest {
                 .callId("call_id")
                 .output("string")
                 .id("id")
+                .callerDirect()
                 .status(ResponseCustomToolCallOutputItem.Status.IN_PROGRESS)
                 .createdBy("created_by")
                 .build()
@@ -24,6 +25,8 @@ internal class ResponseCustomToolCallOutputItemTest {
         assertThat(responseCustomToolCallOutputItem.output())
             .isEqualTo(ResponseCustomToolCallOutput.Output.ofString("string"))
         assertThat(responseCustomToolCallOutputItem.id()).contains("id")
+        assertThat(responseCustomToolCallOutputItem.caller())
+            .contains(ResponseCustomToolCallOutput.Caller.ofDirect())
         assertThat(responseCustomToolCallOutputItem.status())
             .isEqualTo(ResponseCustomToolCallOutputItem.Status.IN_PROGRESS)
         assertThat(responseCustomToolCallOutputItem.createdBy()).contains("created_by")
@@ -37,6 +40,7 @@ internal class ResponseCustomToolCallOutputItemTest {
                 .callId("call_id")
                 .output("string")
                 .id("id")
+                .callerDirect()
                 .status(ResponseCustomToolCallOutputItem.Status.IN_PROGRESS)
                 .createdBy("created_by")
                 .build()
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCustomToolCallOutputTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCustomToolCallOutputTest.kt
index 985d1b2cc..338af89cc 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCustomToolCallOutputTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCustomToolCallOutputTest.kt
@@ -16,12 +16,15 @@ internal class ResponseCustomToolCallOutputTest {
                 .callId("call_id")
                 .output("string")
                 .id("id")
+                .callerDirect()
                 .build()
 
         assertThat(responseCustomToolCallOutput.callId()).isEqualTo("call_id")
         assertThat(responseCustomToolCallOutput.output())
             .isEqualTo(ResponseCustomToolCallOutput.Output.ofString("string"))
         assertThat(responseCustomToolCallOutput.id()).contains("id")
+        assertThat(responseCustomToolCallOutput.caller())
+            .contains(ResponseCustomToolCallOutput.Caller.ofDirect())
     }
 
     @Test
@@ -32,6 +35,7 @@ internal class ResponseCustomToolCallOutputTest {
                 .callId("call_id")
                 .output("string")
                 .id("id")
+                .callerDirect()
                 .build()
 
         val roundtrippedResponseCustomToolCallOutput =
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCustomToolCallTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCustomToolCallTest.kt
index a74c90759..70ede7c73 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCustomToolCallTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseCustomToolCallTest.kt
@@ -17,6 +17,7 @@ internal class ResponseCustomToolCallTest {
                 .input("input")
                 .name("name")
                 .id("id")
+                .callerDirect()
                 .namespace("namespace")
                 .build()
 
@@ -24,6 +25,8 @@ internal class ResponseCustomToolCallTest {
         assertThat(responseCustomToolCall.input()).isEqualTo("input")
         assertThat(responseCustomToolCall.name()).isEqualTo("name")
         assertThat(responseCustomToolCall.id()).contains("id")
+        assertThat(responseCustomToolCall.caller())
+            .contains(ResponseCustomToolCall.Caller.ofDirect())
         assertThat(responseCustomToolCall.namespace()).contains("namespace")
     }
 
@@ -36,6 +39,7 @@ internal class ResponseCustomToolCallTest {
                 .input("input")
                 .name("name")
                 .id("id")
+                .callerDirect()
                 .namespace("namespace")
                 .build()
 
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFailedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFailedEventTest.kt
index ce40c5eb5..04d6aa15c 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFailedEventTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFailedEventTest.kt
@@ -85,8 +85,14 @@ internal class ResponseFailedEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -170,12 +176,19 @@ internal class ResponseFailedEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -195,6 +208,7 @@ internal class ResponseFailedEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -281,8 +295,14 @@ internal class ResponseFailedEventTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .topP(1.0)
@@ -364,12 +384,19 @@ internal class ResponseFailedEventTest {
                             .build()
                     )
                     .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        Response.PromptCacheOptions.builder()
+                            .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(Response.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
                     .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                     .reasoning(
                         Reasoning.builder()
                             .context(Reasoning.Context.AUTO)
                             .effort(ReasoningEffort.NONE)
                             .generateSummary(Reasoning.GenerateSummary.AUTO)
+                            .mode(Reasoning.Mode.STANDARD)
                             .summary(Reasoning.Summary.AUTO)
                             .build()
                     )
@@ -388,7 +415,10 @@ internal class ResponseFailedEventTest {
                         ResponseUsage.builder()
                             .inputTokens(0L)
                             .inputTokensDetails(
-                                ResponseUsage.InputTokensDetails.builder().cachedTokens(0L).build()
+                                ResponseUsage.InputTokensDetails.builder()
+                                    .cacheWriteTokens(0L)
+                                    .cachedTokens(0L)
+                                    .build()
                             )
                             .outputTokens(0L)
                             .outputTokensDetails(
@@ -477,8 +507,14 @@ internal class ResponseFailedEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -562,12 +598,19 @@ internal class ResponseFailedEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -587,6 +630,7 @@ internal class ResponseFailedEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionCallOutputItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionCallOutputItemTest.kt
index 641d62f1b..3fe079380 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionCallOutputItemTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionCallOutputItemTest.kt
@@ -16,7 +16,13 @@ internal class ResponseFunctionCallOutputItemTest {
 
     @Test
     fun ofInputText() {
-        val inputText = ResponseInputTextContent.builder().text("text").build()
+        val inputText =
+            ResponseInputTextContent.builder()
+                .text("text")
+                .promptCacheBreakpoint(
+                    ResponseInputTextContent.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
 
         val responseFunctionCallOutputItem = ResponseFunctionCallOutputItem.ofInputText(inputText)
 
@@ -30,7 +36,12 @@ internal class ResponseFunctionCallOutputItemTest {
         val jsonMapper = jsonMapper()
         val responseFunctionCallOutputItem =
             ResponseFunctionCallOutputItem.ofInputText(
-                ResponseInputTextContent.builder().text("text").build()
+                ResponseInputTextContent.builder()
+                    .text("text")
+                    .promptCacheBreakpoint(
+                        ResponseInputTextContent.PromptCacheBreakpoint.builder().build()
+                    )
+                    .build()
             )
 
         val roundtrippedResponseFunctionCallOutputItem =
@@ -50,6 +61,9 @@ internal class ResponseFunctionCallOutputItemTest {
                 .detail(ResponseInputImageContent.Detail.LOW)
                 .fileId("file-123")
                 .imageUrl("https://example.com")
+                .promptCacheBreakpoint(
+                    ResponseInputImageContent.PromptCacheBreakpoint.builder().build()
+                )
                 .build()
 
         val responseFunctionCallOutputItem = ResponseFunctionCallOutputItem.ofInputImage(inputImage)
@@ -68,6 +82,9 @@ internal class ResponseFunctionCallOutputItemTest {
                     .detail(ResponseInputImageContent.Detail.LOW)
                     .fileId("file-123")
                     .imageUrl("https://example.com")
+                    .promptCacheBreakpoint(
+                        ResponseInputImageContent.PromptCacheBreakpoint.builder().build()
+                    )
                     .build()
             )
 
@@ -85,11 +102,14 @@ internal class ResponseFunctionCallOutputItemTest {
     fun ofInputFile() {
         val inputFile =
             ResponseInputFileContent.builder()
-                .detail(ResponseInputFileContent.Detail.LOW)
+                .detail(ResponseInputFileContent.Detail.AUTO)
                 .fileData("file_data")
                 .fileId("file-123")
                 .fileUrl("https://example.com")
                 .filename("filename")
+                .promptCacheBreakpoint(
+                    ResponseInputFileContent.PromptCacheBreakpoint.builder().build()
+                )
                 .build()
 
         val responseFunctionCallOutputItem = ResponseFunctionCallOutputItem.ofInputFile(inputFile)
@@ -105,11 +125,14 @@ internal class ResponseFunctionCallOutputItemTest {
         val responseFunctionCallOutputItem =
             ResponseFunctionCallOutputItem.ofInputFile(
                 ResponseInputFileContent.builder()
-                    .detail(ResponseInputFileContent.Detail.LOW)
+                    .detail(ResponseInputFileContent.Detail.AUTO)
                     .fileData("file_data")
                     .fileId("file-123")
                     .fileUrl("https://example.com")
                     .filename("filename")
+                    .promptCacheBreakpoint(
+                        ResponseInputFileContent.PromptCacheBreakpoint.builder().build()
+                    )
                     .build()
             )
 
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionShellToolCallOutputTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionShellToolCallOutputTest.kt
index 3f8fb2241..de5c3339c 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionShellToolCallOutputTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionShellToolCallOutputTest.kt
@@ -25,6 +25,7 @@ internal class ResponseFunctionShellToolCallOutputTest {
                         .build()
                 )
                 .status(ResponseFunctionShellToolCallOutput.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
@@ -42,6 +43,8 @@ internal class ResponseFunctionShellToolCallOutputTest {
             )
         assertThat(responseFunctionShellToolCallOutput.status())
             .isEqualTo(ResponseFunctionShellToolCallOutput.Status.IN_PROGRESS)
+        assertThat(responseFunctionShellToolCallOutput.caller())
+            .contains(ResponseFunctionShellToolCallOutput.Caller.ofDirect())
         assertThat(responseFunctionShellToolCallOutput.createdBy()).contains("created_by")
     }
 
@@ -62,6 +65,7 @@ internal class ResponseFunctionShellToolCallOutputTest {
                         .build()
                 )
                 .status(ResponseFunctionShellToolCallOutput.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionShellToolCallTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionShellToolCallTest.kt
index 960df4c27..c3af011b3 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionShellToolCallTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionShellToolCallTest.kt
@@ -24,6 +24,7 @@ internal class ResponseFunctionShellToolCallTest {
                 .callId("call_id")
                 .environment(ResponseLocalEnvironment.builder().build())
                 .status(ResponseFunctionShellToolCall.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
@@ -45,6 +46,8 @@ internal class ResponseFunctionShellToolCallTest {
             )
         assertThat(responseFunctionShellToolCall.status())
             .isEqualTo(ResponseFunctionShellToolCall.Status.IN_PROGRESS)
+        assertThat(responseFunctionShellToolCall.caller())
+            .contains(ResponseFunctionShellToolCall.Caller.ofDirect())
         assertThat(responseFunctionShellToolCall.createdBy()).contains("created_by")
     }
 
@@ -64,6 +67,7 @@ internal class ResponseFunctionShellToolCallTest {
                 .callId("call_id")
                 .environment(ResponseLocalEnvironment.builder().build())
                 .status(ResponseFunctionShellToolCall.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionToolCallItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionToolCallItemTest.kt
index 658afc26b..965f1b930 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionToolCallItemTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionToolCallItemTest.kt
@@ -17,6 +17,7 @@ internal class ResponseFunctionToolCallItemTest {
                 .callId("call_id")
                 .name("name")
                 .id("id")
+                .callerDirect()
                 .namespace("namespace")
                 .status(ResponseFunctionToolCall.Status.IN_PROGRESS)
                 .createdBy("created_by")
@@ -26,6 +27,8 @@ internal class ResponseFunctionToolCallItemTest {
         assertThat(responseFunctionToolCallItem.callId()).isEqualTo("call_id")
         assertThat(responseFunctionToolCallItem.name()).isEqualTo("name")
         assertThat(responseFunctionToolCallItem.id()).contains("id")
+        assertThat(responseFunctionToolCallItem.caller())
+            .contains(ResponseFunctionToolCall.Caller.ofDirect())
         assertThat(responseFunctionToolCallItem.namespace()).contains("namespace")
         assertThat(responseFunctionToolCallItem.status())
             .contains(ResponseFunctionToolCall.Status.IN_PROGRESS)
@@ -41,6 +44,7 @@ internal class ResponseFunctionToolCallItemTest {
                 .callId("call_id")
                 .name("name")
                 .id("id")
+                .callerDirect()
                 .namespace("namespace")
                 .status(ResponseFunctionToolCall.Status.IN_PROGRESS)
                 .createdBy("created_by")
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionToolCallOutputItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionToolCallOutputItemTest.kt
index 9436cea9c..2ec0580db 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionToolCallOutputItemTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionToolCallOutputItemTest.kt
@@ -17,6 +17,7 @@ internal class ResponseFunctionToolCallOutputItemTest {
                 .callId("call_id")
                 .output("string")
                 .status(ResponseFunctionToolCallOutputItem.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
@@ -26,6 +27,8 @@ internal class ResponseFunctionToolCallOutputItemTest {
             .isEqualTo(ResponseFunctionToolCallOutputItem.Output.ofString("string"))
         assertThat(responseFunctionToolCallOutputItem.status())
             .isEqualTo(ResponseFunctionToolCallOutputItem.Status.IN_PROGRESS)
+        assertThat(responseFunctionToolCallOutputItem.caller())
+            .contains(ResponseFunctionToolCallOutputItem.Caller.ofDirect())
         assertThat(responseFunctionToolCallOutputItem.createdBy()).contains("created_by")
     }
 
@@ -38,6 +41,7 @@ internal class ResponseFunctionToolCallOutputItemTest {
                 .callId("call_id")
                 .output("string")
                 .status(ResponseFunctionToolCallOutputItem.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionToolCallTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionToolCallTest.kt
index 72d4b1711..0d8061061 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionToolCallTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseFunctionToolCallTest.kt
@@ -17,6 +17,7 @@ internal class ResponseFunctionToolCallTest {
                 .callId("call_id")
                 .name("name")
                 .id("id")
+                .callerDirect()
                 .namespace("namespace")
                 .status(ResponseFunctionToolCall.Status.IN_PROGRESS)
                 .build()
@@ -25,6 +26,8 @@ internal class ResponseFunctionToolCallTest {
         assertThat(responseFunctionToolCall.callId()).isEqualTo("call_id")
         assertThat(responseFunctionToolCall.name()).isEqualTo("name")
         assertThat(responseFunctionToolCall.id()).contains("id")
+        assertThat(responseFunctionToolCall.caller())
+            .contains(ResponseFunctionToolCall.Caller.ofDirect())
         assertThat(responseFunctionToolCall.namespace()).contains("namespace")
         assertThat(responseFunctionToolCall.status())
             .contains(ResponseFunctionToolCall.Status.IN_PROGRESS)
@@ -39,6 +42,7 @@ internal class ResponseFunctionToolCallTest {
                 .callId("call_id")
                 .name("name")
                 .id("id")
+                .callerDirect()
                 .namespace("namespace")
                 .status(ResponseFunctionToolCall.Status.IN_PROGRESS)
                 .build()
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInProgressEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInProgressEventTest.kt
index 3cf5f74f6..7699f928e 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInProgressEventTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInProgressEventTest.kt
@@ -85,8 +85,14 @@ internal class ResponseInProgressEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -170,12 +176,19 @@ internal class ResponseInProgressEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -195,6 +208,7 @@ internal class ResponseInProgressEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -281,8 +295,14 @@ internal class ResponseInProgressEventTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .topP(1.0)
@@ -364,12 +384,19 @@ internal class ResponseInProgressEventTest {
                             .build()
                     )
                     .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        Response.PromptCacheOptions.builder()
+                            .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(Response.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
                     .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                     .reasoning(
                         Reasoning.builder()
                             .context(Reasoning.Context.AUTO)
                             .effort(ReasoningEffort.NONE)
                             .generateSummary(Reasoning.GenerateSummary.AUTO)
+                            .mode(Reasoning.Mode.STANDARD)
                             .summary(Reasoning.Summary.AUTO)
                             .build()
                     )
@@ -388,7 +415,10 @@ internal class ResponseInProgressEventTest {
                         ResponseUsage.builder()
                             .inputTokens(0L)
                             .inputTokensDetails(
-                                ResponseUsage.InputTokensDetails.builder().cachedTokens(0L).build()
+                                ResponseUsage.InputTokensDetails.builder()
+                                    .cacheWriteTokens(0L)
+                                    .cachedTokens(0L)
+                                    .build()
                             )
                             .outputTokens(0L)
                             .outputTokensDetails(
@@ -477,8 +507,14 @@ internal class ResponseInProgressEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -562,12 +598,19 @@ internal class ResponseInProgressEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -587,6 +630,7 @@ internal class ResponseInProgressEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseIncompleteEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseIncompleteEventTest.kt
index 68575d138..3af877263 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseIncompleteEventTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseIncompleteEventTest.kt
@@ -85,8 +85,14 @@ internal class ResponseIncompleteEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -170,12 +176,19 @@ internal class ResponseIncompleteEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -195,6 +208,7 @@ internal class ResponseIncompleteEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -281,8 +295,14 @@ internal class ResponseIncompleteEventTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .topP(1.0)
@@ -364,12 +384,19 @@ internal class ResponseIncompleteEventTest {
                             .build()
                     )
                     .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        Response.PromptCacheOptions.builder()
+                            .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(Response.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
                     .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                     .reasoning(
                         Reasoning.builder()
                             .context(Reasoning.Context.AUTO)
                             .effort(ReasoningEffort.NONE)
                             .generateSummary(Reasoning.GenerateSummary.AUTO)
+                            .mode(Reasoning.Mode.STANDARD)
                             .summary(Reasoning.Summary.AUTO)
                             .build()
                     )
@@ -388,7 +415,10 @@ internal class ResponseIncompleteEventTest {
                         ResponseUsage.builder()
                             .inputTokens(0L)
                             .inputTokensDetails(
-                                ResponseUsage.InputTokensDetails.builder().cachedTokens(0L).build()
+                                ResponseUsage.InputTokensDetails.builder()
+                                    .cacheWriteTokens(0L)
+                                    .cachedTokens(0L)
+                                    .build()
                             )
                             .outputTokens(0L)
                             .outputTokensDetails(
@@ -477,8 +507,14 @@ internal class ResponseIncompleteEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -562,12 +598,19 @@ internal class ResponseIncompleteEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -587,6 +630,7 @@ internal class ResponseIncompleteEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputContentTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputContentTest.kt
index 478b5cf7c..2b6bdcf1d 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputContentTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputContentTest.kt
@@ -16,7 +16,11 @@ internal class ResponseInputContentTest {
 
     @Test
     fun ofInputText() {
-        val inputText = ResponseInputText.builder().text("text").build()
+        val inputText =
+            ResponseInputText.builder()
+                .text("text")
+                .promptCacheBreakpoint(ResponseInputText.PromptCacheBreakpoint.builder().build())
+                .build()
 
         val responseInputContent = ResponseInputContent.ofInputText(inputText)
 
@@ -29,7 +33,14 @@ internal class ResponseInputContentTest {
     fun ofInputTextRoundtrip() {
         val jsonMapper = jsonMapper()
         val responseInputContent =
-            ResponseInputContent.ofInputText(ResponseInputText.builder().text("text").build())
+            ResponseInputContent.ofInputText(
+                ResponseInputText.builder()
+                    .text("text")
+                    .promptCacheBreakpoint(
+                        ResponseInputText.PromptCacheBreakpoint.builder().build()
+                    )
+                    .build()
+            )
 
         val roundtrippedResponseInputContent =
             jsonMapper.readValue(
@@ -47,6 +58,7 @@ internal class ResponseInputContentTest {
                 .detail(ResponseInputImage.Detail.LOW)
                 .fileId("file_id")
                 .imageUrl("https://example.com")
+                .promptCacheBreakpoint(ResponseInputImage.PromptCacheBreakpoint.builder().build())
                 .build()
 
         val responseInputContent = ResponseInputContent.ofInputImage(inputImage)
@@ -65,6 +77,9 @@ internal class ResponseInputContentTest {
                     .detail(ResponseInputImage.Detail.LOW)
                     .fileId("file_id")
                     .imageUrl("https://example.com")
+                    .promptCacheBreakpoint(
+                        ResponseInputImage.PromptCacheBreakpoint.builder().build()
+                    )
                     .build()
             )
 
@@ -81,11 +96,12 @@ internal class ResponseInputContentTest {
     fun ofInputFile() {
         val inputFile =
             ResponseInputFile.builder()
-                .detail(ResponseInputFile.Detail.LOW)
+                .detail(ResponseInputFile.Detail.AUTO)
                 .fileData("file_data")
                 .fileId("file_id")
                 .fileUrl("https://example.com")
                 .filename("filename")
+                .promptCacheBreakpoint(ResponseInputFile.PromptCacheBreakpoint.builder().build())
                 .build()
 
         val responseInputContent = ResponseInputContent.ofInputFile(inputFile)
@@ -101,11 +117,14 @@ internal class ResponseInputContentTest {
         val responseInputContent =
             ResponseInputContent.ofInputFile(
                 ResponseInputFile.builder()
-                    .detail(ResponseInputFile.Detail.LOW)
+                    .detail(ResponseInputFile.Detail.AUTO)
                     .fileData("file_data")
                     .fileId("file_id")
                     .fileUrl("https://example.com")
                     .filename("filename")
+                    .promptCacheBreakpoint(
+                        ResponseInputFile.PromptCacheBreakpoint.builder().build()
+                    )
                     .build()
             )
 
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputFileContentTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputFileContentTest.kt
index 39ade6cab..b68dd2966 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputFileContentTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputFileContentTest.kt
@@ -13,18 +13,23 @@ internal class ResponseInputFileContentTest {
     fun create() {
         val responseInputFileContent =
             ResponseInputFileContent.builder()
-                .detail(ResponseInputFileContent.Detail.LOW)
+                .detail(ResponseInputFileContent.Detail.AUTO)
                 .fileData("file_data")
                 .fileId("file-123")
                 .fileUrl("https://example.com")
                 .filename("filename")
+                .promptCacheBreakpoint(
+                    ResponseInputFileContent.PromptCacheBreakpoint.builder().build()
+                )
                 .build()
 
-        assertThat(responseInputFileContent.detail()).contains(ResponseInputFileContent.Detail.LOW)
+        assertThat(responseInputFileContent.detail()).contains(ResponseInputFileContent.Detail.AUTO)
         assertThat(responseInputFileContent.fileData()).contains("file_data")
         assertThat(responseInputFileContent.fileId()).contains("file-123")
         assertThat(responseInputFileContent.fileUrl()).contains("https://example.com")
         assertThat(responseInputFileContent.filename()).contains("filename")
+        assertThat(responseInputFileContent.promptCacheBreakpoint())
+            .contains(ResponseInputFileContent.PromptCacheBreakpoint.builder().build())
     }
 
     @Test
@@ -32,11 +37,14 @@ internal class ResponseInputFileContentTest {
         val jsonMapper = jsonMapper()
         val responseInputFileContent =
             ResponseInputFileContent.builder()
-                .detail(ResponseInputFileContent.Detail.LOW)
+                .detail(ResponseInputFileContent.Detail.AUTO)
                 .fileData("file_data")
                 .fileId("file-123")
                 .fileUrl("https://example.com")
                 .filename("filename")
+                .promptCacheBreakpoint(
+                    ResponseInputFileContent.PromptCacheBreakpoint.builder().build()
+                )
                 .build()
 
         val roundtrippedResponseInputFileContent =
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputFileTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputFileTest.kt
index 056c2158f..814e56f24 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputFileTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputFileTest.kt
@@ -13,18 +13,21 @@ internal class ResponseInputFileTest {
     fun create() {
         val responseInputFile =
             ResponseInputFile.builder()
-                .detail(ResponseInputFile.Detail.LOW)
+                .detail(ResponseInputFile.Detail.AUTO)
                 .fileData("file_data")
                 .fileId("file_id")
                 .fileUrl("https://example.com")
                 .filename("filename")
+                .promptCacheBreakpoint(ResponseInputFile.PromptCacheBreakpoint.builder().build())
                 .build()
 
-        assertThat(responseInputFile.detail()).contains(ResponseInputFile.Detail.LOW)
+        assertThat(responseInputFile.detail()).contains(ResponseInputFile.Detail.AUTO)
         assertThat(responseInputFile.fileData()).contains("file_data")
         assertThat(responseInputFile.fileId()).contains("file_id")
         assertThat(responseInputFile.fileUrl()).contains("https://example.com")
         assertThat(responseInputFile.filename()).contains("filename")
+        assertThat(responseInputFile.promptCacheBreakpoint())
+            .contains(ResponseInputFile.PromptCacheBreakpoint.builder().build())
     }
 
     @Test
@@ -32,11 +35,12 @@ internal class ResponseInputFileTest {
         val jsonMapper = jsonMapper()
         val responseInputFile =
             ResponseInputFile.builder()
-                .detail(ResponseInputFile.Detail.LOW)
+                .detail(ResponseInputFile.Detail.AUTO)
                 .fileData("file_data")
                 .fileId("file_id")
                 .fileUrl("https://example.com")
                 .filename("filename")
+                .promptCacheBreakpoint(ResponseInputFile.PromptCacheBreakpoint.builder().build())
                 .build()
 
         val roundtrippedResponseInputFile =
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputImageContentTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputImageContentTest.kt
index d83425b2d..db6c45315 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputImageContentTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputImageContentTest.kt
@@ -16,12 +16,17 @@ internal class ResponseInputImageContentTest {
                 .detail(ResponseInputImageContent.Detail.LOW)
                 .fileId("file-123")
                 .imageUrl("https://example.com")
+                .promptCacheBreakpoint(
+                    ResponseInputImageContent.PromptCacheBreakpoint.builder().build()
+                )
                 .build()
 
         assertThat(responseInputImageContent.detail())
             .contains(ResponseInputImageContent.Detail.LOW)
         assertThat(responseInputImageContent.fileId()).contains("file-123")
         assertThat(responseInputImageContent.imageUrl()).contains("https://example.com")
+        assertThat(responseInputImageContent.promptCacheBreakpoint())
+            .contains(ResponseInputImageContent.PromptCacheBreakpoint.builder().build())
     }
 
     @Test
@@ -32,6 +37,9 @@ internal class ResponseInputImageContentTest {
                 .detail(ResponseInputImageContent.Detail.LOW)
                 .fileId("file-123")
                 .imageUrl("https://example.com")
+                .promptCacheBreakpoint(
+                    ResponseInputImageContent.PromptCacheBreakpoint.builder().build()
+                )
                 .build()
 
         val roundtrippedResponseInputImageContent =
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputImageTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputImageTest.kt
index fc2dab855..8a43ca273 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputImageTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputImageTest.kt
@@ -16,11 +16,14 @@ internal class ResponseInputImageTest {
                 .detail(ResponseInputImage.Detail.LOW)
                 .fileId("file_id")
                 .imageUrl("https://example.com")
+                .promptCacheBreakpoint(ResponseInputImage.PromptCacheBreakpoint.builder().build())
                 .build()
 
         assertThat(responseInputImage.detail()).isEqualTo(ResponseInputImage.Detail.LOW)
         assertThat(responseInputImage.fileId()).contains("file_id")
         assertThat(responseInputImage.imageUrl()).contains("https://example.com")
+        assertThat(responseInputImage.promptCacheBreakpoint())
+            .contains(ResponseInputImage.PromptCacheBreakpoint.builder().build())
     }
 
     @Test
@@ -31,6 +34,7 @@ internal class ResponseInputImageTest {
                 .detail(ResponseInputImage.Detail.LOW)
                 .fileId("file_id")
                 .imageUrl("https://example.com")
+                .promptCacheBreakpoint(ResponseInputImage.PromptCacheBreakpoint.builder().build())
                 .build()
 
         val roundtrippedResponseInputImage =
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputItemTest.kt
index bd9189e38..2280460cb 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputItemTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputItemTest.kt
@@ -56,6 +56,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -84,7 +86,14 @@ internal class ResponseInputItemTest {
     fun ofMessage() {
         val message =
             ResponseInputItem.Message.builder()
-                .addInputTextContent("text")
+                .addContent(
+                    ResponseInputText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            ResponseInputText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
                 .role(ResponseInputItem.Message.Role.USER)
                 .status(ResponseInputItem.Message.Status.IN_PROGRESS)
                 .type(ResponseInputItem.Message.Type.MESSAGE)
@@ -122,6 +131,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -130,7 +141,14 @@ internal class ResponseInputItemTest {
         val responseInputItem =
             ResponseInputItem.ofMessage(
                 ResponseInputItem.Message.builder()
-                    .addInputTextContent("text")
+                    .addContent(
+                        ResponseInputText.builder()
+                            .text("text")
+                            .promptCacheBreakpoint(
+                                ResponseInputText.PromptCacheBreakpoint.builder().build()
+                            )
+                            .build()
+                    )
                     .role(ResponseInputItem.Message.Role.USER)
                     .status(ResponseInputItem.Message.Status.IN_PROGRESS)
                     .type(ResponseInputItem.Message.Type.MESSAGE)
@@ -213,6 +231,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -316,6 +336,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -417,6 +439,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -518,6 +542,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -605,6 +631,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -646,6 +674,7 @@ internal class ResponseInputItemTest {
                 .callId("call_id")
                 .name("name")
                 .id("id")
+                .callerDirect()
                 .namespace("namespace")
                 .status(ResponseFunctionToolCall.Status.IN_PROGRESS)
                 .build()
@@ -682,6 +711,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -694,6 +725,7 @@ internal class ResponseInputItemTest {
                     .callId("call_id")
                     .name("name")
                     .id("id")
+                    .callerDirect()
                     .namespace("namespace")
                     .status(ResponseFunctionToolCall.Status.IN_PROGRESS)
                     .build()
@@ -715,6 +747,7 @@ internal class ResponseInputItemTest {
                 .callId("x")
                 .output("string")
                 .id("fc_123")
+                .callerDirect()
                 .status(ResponseInputItem.FunctionCallOutput.Status.IN_PROGRESS)
                 .build()
 
@@ -750,6 +783,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -761,6 +796,7 @@ internal class ResponseInputItemTest {
                     .callId("x")
                     .output("string")
                     .id("fc_123")
+                    .callerDirect()
                     .status(ResponseInputItem.FunctionCallOutput.Status.IN_PROGRESS)
                     .build()
             )
@@ -817,6 +853,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -855,8 +893,14 @@ internal class ResponseInputItemTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .id("tso_123")
@@ -897,6 +941,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -914,8 +960,14 @@ internal class ResponseInputItemTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .id("tso_123")
@@ -947,8 +999,14 @@ internal class ResponseInputItemTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .id("at_123")
@@ -986,6 +1044,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -1003,8 +1063,14 @@ internal class ResponseInputItemTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .id("at_123")
@@ -1063,6 +1129,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -1128,6 +1196,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -1191,6 +1261,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -1257,6 +1329,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -1336,6 +1410,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -1413,6 +1489,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -1449,6 +1527,7 @@ internal class ResponseInputItemTest {
                 )
                 .callId("x")
                 .id("sh_123")
+                .callerDirect()
                 .environment(
                     LocalEnvironment.builder()
                         .addSkill(
@@ -1495,6 +1574,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -1512,6 +1593,7 @@ internal class ResponseInputItemTest {
                     )
                     .callId("x")
                     .id("sh_123")
+                    .callerDirect()
                     .environment(
                         LocalEnvironment.builder()
                             .addSkill(
@@ -1549,6 +1631,7 @@ internal class ResponseInputItemTest {
                         .build()
                 )
                 .id("sho_123")
+                .callerDirect()
                 .maxOutputLength(0L)
                 .status(ResponseInputItem.ShellCallOutput.Status.IN_PROGRESS)
                 .build()
@@ -1585,6 +1668,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -1602,6 +1687,7 @@ internal class ResponseInputItemTest {
                             .build()
                     )
                     .id("sho_123")
+                    .callerDirect()
                     .maxOutputLength(0L)
                     .status(ResponseInputItem.ShellCallOutput.Status.IN_PROGRESS)
                     .build()
@@ -1629,6 +1715,7 @@ internal class ResponseInputItemTest {
                 )
                 .status(ResponseInputItem.ApplyPatchCall.Status.IN_PROGRESS)
                 .id("apc_123")
+                .callerDirect()
                 .build()
 
         val responseInputItem = ResponseInputItem.ofApplyPatchCall(applyPatchCall)
@@ -1663,6 +1750,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -1680,6 +1769,7 @@ internal class ResponseInputItemTest {
                     )
                     .status(ResponseInputItem.ApplyPatchCall.Status.IN_PROGRESS)
                     .id("apc_123")
+                    .callerDirect()
                     .build()
             )
 
@@ -1699,6 +1789,7 @@ internal class ResponseInputItemTest {
                 .callId("x")
                 .status(ResponseInputItem.ApplyPatchCallOutput.Status.COMPLETED)
                 .id("apco_123")
+                .callerDirect()
                 .output("output")
                 .build()
 
@@ -1734,6 +1825,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -1745,6 +1838,7 @@ internal class ResponseInputItemTest {
                     .callId("x")
                     .status(ResponseInputItem.ApplyPatchCallOutput.Status.COMPLETED)
                     .id("apco_123")
+                    .callerDirect()
                     .output("output")
                     .build()
             )
@@ -1807,6 +1901,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -1880,6 +1976,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -1946,6 +2044,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -2016,6 +2116,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -2051,6 +2153,7 @@ internal class ResponseInputItemTest {
                 .callId("call_id")
                 .output("string")
                 .id("id")
+                .callerDirect()
                 .build()
 
         val responseInputItem = ResponseInputItem.ofCustomToolCallOutput(customToolCallOutput)
@@ -2085,6 +2188,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -2096,6 +2201,7 @@ internal class ResponseInputItemTest {
                     .callId("call_id")
                     .output("string")
                     .id("id")
+                    .callerDirect()
                     .build()
             )
 
@@ -2116,6 +2222,7 @@ internal class ResponseInputItemTest {
                 .input("input")
                 .name("name")
                 .id("id")
+                .callerDirect()
                 .namespace("namespace")
                 .build()
 
@@ -2151,6 +2258,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).contains(customToolCall)
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -2163,6 +2272,7 @@ internal class ResponseInputItemTest {
                     .input("input")
                     .name("name")
                     .id("id")
+                    .callerDirect()
                     .namespace("namespace")
                     .build()
             )
@@ -2211,6 +2321,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.compactionTrigger())
             .contains(JsonValue.from(mapOf("type" to "compaction_trigger")))
         assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -2267,6 +2379,8 @@ internal class ResponseInputItemTest {
         assertThat(responseInputItem.customToolCall()).isEmpty
         assertThat(responseInputItem.compactionTrigger()).isEmpty
         assertThat(responseInputItem.itemReference()).contains(itemReference)
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).isEmpty
     }
 
     @Test
@@ -2289,6 +2403,142 @@ internal class ResponseInputItemTest {
         assertThat(roundtrippedResponseInputItem).isEqualTo(responseInputItem)
     }
 
+    @Test
+    fun ofProgram() {
+        val program =
+            ResponseInputItem.Program.builder()
+                .id("cm_123")
+                .callId("x")
+                .code("code")
+                .fingerprint("fingerprint")
+                .build()
+
+        val responseInputItem = ResponseInputItem.ofProgram(program)
+
+        assertThat(responseInputItem.easyInputMessage()).isEmpty
+        assertThat(responseInputItem.message()).isEmpty
+        assertThat(responseInputItem.responseOutputMessage()).isEmpty
+        assertThat(responseInputItem.fileSearchCall()).isEmpty
+        assertThat(responseInputItem.computerCall()).isEmpty
+        assertThat(responseInputItem.computerCallOutput()).isEmpty
+        assertThat(responseInputItem.webSearchCall()).isEmpty
+        assertThat(responseInputItem.functionCall()).isEmpty
+        assertThat(responseInputItem.functionCallOutput()).isEmpty
+        assertThat(responseInputItem.toolSearchCall()).isEmpty
+        assertThat(responseInputItem.toolSearchOutput()).isEmpty
+        assertThat(responseInputItem.additionalTools()).isEmpty
+        assertThat(responseInputItem.reasoning()).isEmpty
+        assertThat(responseInputItem.compaction()).isEmpty
+        assertThat(responseInputItem.imageGenerationCall()).isEmpty
+        assertThat(responseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(responseInputItem.localShellCall()).isEmpty
+        assertThat(responseInputItem.localShellCallOutput()).isEmpty
+        assertThat(responseInputItem.shellCall()).isEmpty
+        assertThat(responseInputItem.shellCallOutput()).isEmpty
+        assertThat(responseInputItem.applyPatchCall()).isEmpty
+        assertThat(responseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(responseInputItem.mcpListTools()).isEmpty
+        assertThat(responseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(responseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(responseInputItem.mcpCall()).isEmpty
+        assertThat(responseInputItem.customToolCallOutput()).isEmpty
+        assertThat(responseInputItem.customToolCall()).isEmpty
+        assertThat(responseInputItem.compactionTrigger()).isEmpty
+        assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).contains(program)
+        assertThat(responseInputItem.programOutput()).isEmpty
+    }
+
+    @Test
+    fun ofProgramRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val responseInputItem =
+            ResponseInputItem.ofProgram(
+                ResponseInputItem.Program.builder()
+                    .id("cm_123")
+                    .callId("x")
+                    .code("code")
+                    .fingerprint("fingerprint")
+                    .build()
+            )
+
+        val roundtrippedResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(responseInputItem),
+                jacksonTypeRef<ResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedResponseInputItem).isEqualTo(responseInputItem)
+    }
+
+    @Test
+    fun ofProgramOutput() {
+        val programOutput =
+            ResponseInputItem.ProgramOutput.builder()
+                .id("cmo_123")
+                .callId("x")
+                .result("result")
+                .status(ResponseInputItem.ProgramOutput.Status.COMPLETED)
+                .build()
+
+        val responseInputItem = ResponseInputItem.ofProgramOutput(programOutput)
+
+        assertThat(responseInputItem.easyInputMessage()).isEmpty
+        assertThat(responseInputItem.message()).isEmpty
+        assertThat(responseInputItem.responseOutputMessage()).isEmpty
+        assertThat(responseInputItem.fileSearchCall()).isEmpty
+        assertThat(responseInputItem.computerCall()).isEmpty
+        assertThat(responseInputItem.computerCallOutput()).isEmpty
+        assertThat(responseInputItem.webSearchCall()).isEmpty
+        assertThat(responseInputItem.functionCall()).isEmpty
+        assertThat(responseInputItem.functionCallOutput()).isEmpty
+        assertThat(responseInputItem.toolSearchCall()).isEmpty
+        assertThat(responseInputItem.toolSearchOutput()).isEmpty
+        assertThat(responseInputItem.additionalTools()).isEmpty
+        assertThat(responseInputItem.reasoning()).isEmpty
+        assertThat(responseInputItem.compaction()).isEmpty
+        assertThat(responseInputItem.imageGenerationCall()).isEmpty
+        assertThat(responseInputItem.codeInterpreterCall()).isEmpty
+        assertThat(responseInputItem.localShellCall()).isEmpty
+        assertThat(responseInputItem.localShellCallOutput()).isEmpty
+        assertThat(responseInputItem.shellCall()).isEmpty
+        assertThat(responseInputItem.shellCallOutput()).isEmpty
+        assertThat(responseInputItem.applyPatchCall()).isEmpty
+        assertThat(responseInputItem.applyPatchCallOutput()).isEmpty
+        assertThat(responseInputItem.mcpListTools()).isEmpty
+        assertThat(responseInputItem.mcpApprovalRequest()).isEmpty
+        assertThat(responseInputItem.mcpApprovalResponse()).isEmpty
+        assertThat(responseInputItem.mcpCall()).isEmpty
+        assertThat(responseInputItem.customToolCallOutput()).isEmpty
+        assertThat(responseInputItem.customToolCall()).isEmpty
+        assertThat(responseInputItem.compactionTrigger()).isEmpty
+        assertThat(responseInputItem.itemReference()).isEmpty
+        assertThat(responseInputItem.program()).isEmpty
+        assertThat(responseInputItem.programOutput()).contains(programOutput)
+    }
+
+    @Test
+    fun ofProgramOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val responseInputItem =
+            ResponseInputItem.ofProgramOutput(
+                ResponseInputItem.ProgramOutput.builder()
+                    .id("cmo_123")
+                    .callId("x")
+                    .result("result")
+                    .status(ResponseInputItem.ProgramOutput.Status.COMPLETED)
+                    .build()
+            )
+
+        val roundtrippedResponseInputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(responseInputItem),
+                jacksonTypeRef<ResponseInputItem>(),
+            )
+
+        assertThat(roundtrippedResponseInputItem).isEqualTo(responseInputItem)
+    }
+
     enum class IncompatibleJsonShapeTestCase(val value: JsonValue) {
         BOOLEAN(JsonValue.from(false)),
         STRING(JsonValue.from("invalid")),
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputMessageItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputMessageItemTest.kt
index 2eb6f128e..cb64906d2 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputMessageItemTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputMessageItemTest.kt
@@ -14,7 +14,14 @@ internal class ResponseInputMessageItemTest {
         val responseInputMessageItem =
             ResponseInputMessageItem.builder()
                 .id("id")
-                .addInputTextContent("text")
+                .addContent(
+                    ResponseInputText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            ResponseInputText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
                 .role(ResponseInputMessageItem.Role.USER)
                 .status(ResponseInputMessageItem.Status.IN_PROGRESS)
                 .build()
@@ -22,7 +29,14 @@ internal class ResponseInputMessageItemTest {
         assertThat(responseInputMessageItem.id()).isEqualTo("id")
         assertThat(responseInputMessageItem.content())
             .containsExactly(
-                ResponseInputContent.ofInputText(ResponseInputText.builder().text("text").build())
+                ResponseInputContent.ofInputText(
+                    ResponseInputText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            ResponseInputText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
             )
         assertThat(responseInputMessageItem.role()).isEqualTo(ResponseInputMessageItem.Role.USER)
         assertThat(responseInputMessageItem.status())
@@ -35,7 +49,14 @@ internal class ResponseInputMessageItemTest {
         val responseInputMessageItem =
             ResponseInputMessageItem.builder()
                 .id("id")
-                .addInputTextContent("text")
+                .addContent(
+                    ResponseInputText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            ResponseInputText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
                 .role(ResponseInputMessageItem.Role.USER)
                 .status(ResponseInputMessageItem.Status.IN_PROGRESS)
                 .build()
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputTextContentTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputTextContentTest.kt
index 7650497f7..1b757b828 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputTextContentTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputTextContentTest.kt
@@ -11,15 +11,29 @@ internal class ResponseInputTextContentTest {
 
     @Test
     fun create() {
-        val responseInputTextContent = ResponseInputTextContent.builder().text("text").build()
+        val responseInputTextContent =
+            ResponseInputTextContent.builder()
+                .text("text")
+                .promptCacheBreakpoint(
+                    ResponseInputTextContent.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
 
         assertThat(responseInputTextContent.text()).isEqualTo("text")
+        assertThat(responseInputTextContent.promptCacheBreakpoint())
+            .contains(ResponseInputTextContent.PromptCacheBreakpoint.builder().build())
     }
 
     @Test
     fun roundtrip() {
         val jsonMapper = jsonMapper()
-        val responseInputTextContent = ResponseInputTextContent.builder().text("text").build()
+        val responseInputTextContent =
+            ResponseInputTextContent.builder()
+                .text("text")
+                .promptCacheBreakpoint(
+                    ResponseInputTextContent.PromptCacheBreakpoint.builder().build()
+                )
+                .build()
 
         val roundtrippedResponseInputTextContent =
             jsonMapper.readValue(
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputTextTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputTextTest.kt
index 96c81e8a0..7f5c4adad 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputTextTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseInputTextTest.kt
@@ -11,15 +11,25 @@ internal class ResponseInputTextTest {
 
     @Test
     fun create() {
-        val responseInputText = ResponseInputText.builder().text("text").build()
+        val responseInputText =
+            ResponseInputText.builder()
+                .text("text")
+                .promptCacheBreakpoint(ResponseInputText.PromptCacheBreakpoint.builder().build())
+                .build()
 
         assertThat(responseInputText.text()).isEqualTo("text")
+        assertThat(responseInputText.promptCacheBreakpoint())
+            .contains(ResponseInputText.PromptCacheBreakpoint.builder().build())
     }
 
     @Test
     fun roundtrip() {
         val jsonMapper = jsonMapper()
-        val responseInputText = ResponseInputText.builder().text("text").build()
+        val responseInputText =
+            ResponseInputText.builder()
+                .text("text")
+                .promptCacheBreakpoint(ResponseInputText.PromptCacheBreakpoint.builder().build())
+                .build()
 
         val roundtrippedResponseInputText =
             jsonMapper.readValue(
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseItemTest.kt
index 395a36b57..cab1c89d4 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseItemTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseItemTest.kt
@@ -19,7 +19,14 @@ internal class ResponseItemTest {
         val responseInputMessageItem =
             ResponseInputMessageItem.builder()
                 .id("id")
-                .addInputTextContent("text")
+                .addContent(
+                    ResponseInputText.builder()
+                        .text("text")
+                        .promptCacheBreakpoint(
+                            ResponseInputText.PromptCacheBreakpoint.builder().build()
+                        )
+                        .build()
+                )
                 .role(ResponseInputMessageItem.Role.USER)
                 .status(ResponseInputMessageItem.Status.IN_PROGRESS)
                 .build()
@@ -38,6 +45,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -62,7 +71,14 @@ internal class ResponseItemTest {
             ResponseItem.ofResponseInputMessageItem(
                 ResponseInputMessageItem.builder()
                     .id("id")
-                    .addInputTextContent("text")
+                    .addContent(
+                        ResponseInputText.builder()
+                            .text("text")
+                            .promptCacheBreakpoint(
+                                ResponseInputText.PromptCacheBreakpoint.builder().build()
+                            )
+                            .build()
+                    )
                     .role(ResponseInputMessageItem.Role.USER)
                     .status(ResponseInputMessageItem.Status.IN_PROGRESS)
                     .build()
@@ -126,6 +142,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -226,6 +244,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -324,6 +344,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -423,6 +445,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -508,6 +532,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -564,6 +590,7 @@ internal class ResponseItemTest {
                 .callId("call_id")
                 .name("name")
                 .id("id")
+                .callerDirect()
                 .namespace("namespace")
                 .status(ResponseFunctionToolCall.Status.IN_PROGRESS)
                 .createdBy("created_by")
@@ -583,6 +610,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -610,6 +639,7 @@ internal class ResponseItemTest {
                     .callId("call_id")
                     .name("name")
                     .id("id")
+                    .callerDirect()
                     .namespace("namespace")
                     .status(ResponseFunctionToolCall.Status.IN_PROGRESS)
                     .createdBy("created_by")
@@ -633,6 +663,7 @@ internal class ResponseItemTest {
                 .callId("call_id")
                 .output("string")
                 .status(ResponseFunctionToolCallOutputItem.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
@@ -650,6 +681,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -677,6 +710,7 @@ internal class ResponseItemTest {
                     .callId("call_id")
                     .output("string")
                     .status(ResponseFunctionToolCallOutputItem.Status.IN_PROGRESS)
+                    .callerDirect()
                     .createdBy("created_by")
                     .build()
             )
@@ -716,6 +750,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -774,8 +810,14 @@ internal class ResponseItemTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .createdBy("created_by")
@@ -795,6 +837,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).contains(toolSearchOutput)
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -831,8 +875,14 @@ internal class ResponseItemTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .createdBy("created_by")
@@ -863,8 +913,14 @@ internal class ResponseItemTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .build()
@@ -883,6 +939,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).contains(additionalTools)
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -917,8 +975,14 @@ internal class ResponseItemTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .build()
@@ -958,6 +1022,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).contains(reasoning)
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -998,6 +1064,136 @@ internal class ResponseItemTest {
         assertThat(roundtrippedResponseItem).isEqualTo(responseItem)
     }
 
+    @Test
+    fun ofProgram() {
+        val program =
+            ResponseItem.Program.builder()
+                .id("id")
+                .callId("call_id")
+                .code("code")
+                .fingerprint("fingerprint")
+                .build()
+
+        val responseItem = ResponseItem.ofProgram(program)
+
+        assertThat(responseItem.responseInputMessageItem()).isEmpty
+        assertThat(responseItem.responseOutputMessage()).isEmpty
+        assertThat(responseItem.fileSearchCall()).isEmpty
+        assertThat(responseItem.computerCall()).isEmpty
+        assertThat(responseItem.computerCallOutput()).isEmpty
+        assertThat(responseItem.webSearchCall()).isEmpty
+        assertThat(responseItem.functionCall()).isEmpty
+        assertThat(responseItem.functionCallOutput()).isEmpty
+        assertThat(responseItem.toolSearchCall()).isEmpty
+        assertThat(responseItem.toolSearchOutput()).isEmpty
+        assertThat(responseItem.additionalTools()).isEmpty
+        assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).contains(program)
+        assertThat(responseItem.programOutput()).isEmpty
+        assertThat(responseItem.compaction()).isEmpty
+        assertThat(responseItem.imageGenerationCall()).isEmpty
+        assertThat(responseItem.codeInterpreterCall()).isEmpty
+        assertThat(responseItem.localShellCall()).isEmpty
+        assertThat(responseItem.localShellCallOutput()).isEmpty
+        assertThat(responseItem.shellCall()).isEmpty
+        assertThat(responseItem.shellCallOutput()).isEmpty
+        assertThat(responseItem.applyPatchCall()).isEmpty
+        assertThat(responseItem.applyPatchCallOutput()).isEmpty
+        assertThat(responseItem.mcpListTools()).isEmpty
+        assertThat(responseItem.mcpApprovalRequest()).isEmpty
+        assertThat(responseItem.mcpApprovalResponse()).isEmpty
+        assertThat(responseItem.mcpCall()).isEmpty
+        assertThat(responseItem.customToolCall()).isEmpty
+        assertThat(responseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofProgramRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val responseItem =
+            ResponseItem.ofProgram(
+                ResponseItem.Program.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .code("code")
+                    .fingerprint("fingerprint")
+                    .build()
+            )
+
+        val roundtrippedResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(responseItem),
+                jacksonTypeRef<ResponseItem>(),
+            )
+
+        assertThat(roundtrippedResponseItem).isEqualTo(responseItem)
+    }
+
+    @Test
+    fun ofProgramOutput() {
+        val programOutput =
+            ResponseItem.ProgramOutput.builder()
+                .id("id")
+                .callId("call_id")
+                .result("result")
+                .status(ResponseItem.ProgramOutput.Status.COMPLETED)
+                .build()
+
+        val responseItem = ResponseItem.ofProgramOutput(programOutput)
+
+        assertThat(responseItem.responseInputMessageItem()).isEmpty
+        assertThat(responseItem.responseOutputMessage()).isEmpty
+        assertThat(responseItem.fileSearchCall()).isEmpty
+        assertThat(responseItem.computerCall()).isEmpty
+        assertThat(responseItem.computerCallOutput()).isEmpty
+        assertThat(responseItem.webSearchCall()).isEmpty
+        assertThat(responseItem.functionCall()).isEmpty
+        assertThat(responseItem.functionCallOutput()).isEmpty
+        assertThat(responseItem.toolSearchCall()).isEmpty
+        assertThat(responseItem.toolSearchOutput()).isEmpty
+        assertThat(responseItem.additionalTools()).isEmpty
+        assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).contains(programOutput)
+        assertThat(responseItem.compaction()).isEmpty
+        assertThat(responseItem.imageGenerationCall()).isEmpty
+        assertThat(responseItem.codeInterpreterCall()).isEmpty
+        assertThat(responseItem.localShellCall()).isEmpty
+        assertThat(responseItem.localShellCallOutput()).isEmpty
+        assertThat(responseItem.shellCall()).isEmpty
+        assertThat(responseItem.shellCallOutput()).isEmpty
+        assertThat(responseItem.applyPatchCall()).isEmpty
+        assertThat(responseItem.applyPatchCallOutput()).isEmpty
+        assertThat(responseItem.mcpListTools()).isEmpty
+        assertThat(responseItem.mcpApprovalRequest()).isEmpty
+        assertThat(responseItem.mcpApprovalResponse()).isEmpty
+        assertThat(responseItem.mcpCall()).isEmpty
+        assertThat(responseItem.customToolCall()).isEmpty
+        assertThat(responseItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofProgramOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val responseItem =
+            ResponseItem.ofProgramOutput(
+                ResponseItem.ProgramOutput.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .result("result")
+                    .status(ResponseItem.ProgramOutput.Status.COMPLETED)
+                    .build()
+            )
+
+        val roundtrippedResponseItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(responseItem),
+                jacksonTypeRef<ResponseItem>(),
+            )
+
+        assertThat(roundtrippedResponseItem).isEqualTo(responseItem)
+    }
+
     @Test
     fun ofCompaction() {
         val compaction =
@@ -1021,6 +1217,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).contains(compaction)
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -1082,6 +1280,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).contains(imageGenerationCall)
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -1145,6 +1345,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).contains(codeInterpreterCall)
@@ -1221,6 +1423,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -1295,6 +1499,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -1348,6 +1554,7 @@ internal class ResponseItemTest {
                 .callId("call_id")
                 .environment(ResponseLocalEnvironment.builder().build())
                 .status(ResponseFunctionShellToolCall.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
@@ -1365,6 +1572,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -1399,6 +1608,7 @@ internal class ResponseItemTest {
                     .callId("call_id")
                     .environment(ResponseLocalEnvironment.builder().build())
                     .status(ResponseFunctionShellToolCall.Status.IN_PROGRESS)
+                    .callerDirect()
                     .createdBy("created_by")
                     .build()
             )
@@ -1428,6 +1638,7 @@ internal class ResponseItemTest {
                         .build()
                 )
                 .status(ResponseFunctionShellToolCallOutput.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
@@ -1445,6 +1656,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -1480,6 +1693,7 @@ internal class ResponseItemTest {
                             .build()
                     )
                     .status(ResponseFunctionShellToolCallOutput.Status.IN_PROGRESS)
+                    .callerDirect()
                     .createdBy("created_by")
                     .build()
             )
@@ -1506,6 +1720,7 @@ internal class ResponseItemTest {
                         .build()
                 )
                 .status(ResponseApplyPatchToolCall.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
@@ -1523,6 +1738,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -1555,6 +1772,7 @@ internal class ResponseItemTest {
                             .build()
                     )
                     .status(ResponseApplyPatchToolCall.Status.IN_PROGRESS)
+                    .callerDirect()
                     .createdBy("created_by")
                     .build()
             )
@@ -1575,6 +1793,7 @@ internal class ResponseItemTest {
                 .id("id")
                 .callId("call_id")
                 .status(ResponseApplyPatchToolCallOutput.Status.COMPLETED)
+                .callerDirect()
                 .createdBy("created_by")
                 .output("output")
                 .build()
@@ -1593,6 +1812,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -1619,6 +1840,7 @@ internal class ResponseItemTest {
                     .id("id")
                     .callId("call_id")
                     .status(ResponseApplyPatchToolCallOutput.Status.COMPLETED)
+                    .callerDirect()
                     .createdBy("created_by")
                     .output("output")
                     .build()
@@ -1664,6 +1886,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -1734,6 +1958,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -1797,6 +2023,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -1864,6 +2092,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -1915,6 +2145,7 @@ internal class ResponseItemTest {
                 .input("input")
                 .name("name")
                 .id("id")
+                .callerDirect()
                 .namespace("namespace")
                 .status(ResponseCustomToolCallItem.Status.IN_PROGRESS)
                 .createdBy("created_by")
@@ -1934,6 +2165,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -1961,6 +2194,7 @@ internal class ResponseItemTest {
                     .input("input")
                     .name("name")
                     .id("id")
+                    .callerDirect()
                     .namespace("namespace")
                     .status(ResponseCustomToolCallItem.Status.IN_PROGRESS)
                     .createdBy("created_by")
@@ -1983,6 +2217,7 @@ internal class ResponseItemTest {
                 .callId("call_id")
                 .output("string")
                 .id("id")
+                .callerDirect()
                 .status(ResponseCustomToolCallOutputItem.Status.IN_PROGRESS)
                 .createdBy("created_by")
                 .build()
@@ -2001,6 +2236,8 @@ internal class ResponseItemTest {
         assertThat(responseItem.toolSearchOutput()).isEmpty
         assertThat(responseItem.additionalTools()).isEmpty
         assertThat(responseItem.reasoning()).isEmpty
+        assertThat(responseItem.program()).isEmpty
+        assertThat(responseItem.programOutput()).isEmpty
         assertThat(responseItem.compaction()).isEmpty
         assertThat(responseItem.imageGenerationCall()).isEmpty
         assertThat(responseItem.codeInterpreterCall()).isEmpty
@@ -2027,6 +2264,7 @@ internal class ResponseItemTest {
                     .callId("call_id")
                     .output("string")
                     .id("id")
+                    .callerDirect()
                     .status(ResponseCustomToolCallOutputItem.Status.IN_PROGRESS)
                     .createdBy("created_by")
                     .build()
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseOutputItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseOutputItemTest.kt
index 46d40a84d..92c64aae0 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseOutputItemTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseOutputItemTest.kt
@@ -59,6 +59,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -158,6 +160,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -220,6 +224,7 @@ internal class ResponseOutputItemTest {
                 .callId("call_id")
                 .name("name")
                 .id("id")
+                .callerDirect()
                 .namespace("namespace")
                 .status(ResponseFunctionToolCall.Status.IN_PROGRESS)
                 .build()
@@ -234,6 +239,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -264,6 +271,7 @@ internal class ResponseOutputItemTest {
                     .callId("call_id")
                     .name("name")
                     .id("id")
+                    .callerDirect()
                     .namespace("namespace")
                     .status(ResponseFunctionToolCall.Status.IN_PROGRESS)
                     .build()
@@ -286,6 +294,7 @@ internal class ResponseOutputItemTest {
                 .callId("call_id")
                 .output("string")
                 .status(ResponseFunctionToolCallOutputItem.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
@@ -299,6 +308,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -329,6 +340,7 @@ internal class ResponseOutputItemTest {
                     .callId("call_id")
                     .output("string")
                     .status(ResponseFunctionToolCallOutputItem.Status.IN_PROGRESS)
+                    .callerDirect()
                     .createdBy("created_by")
                     .build()
             )
@@ -371,6 +383,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -465,6 +479,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).contains(computerCall)
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -563,6 +579,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).contains(computerCallOutput)
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -639,6 +657,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).contains(reasoning)
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -682,6 +702,134 @@ internal class ResponseOutputItemTest {
         assertThat(roundtrippedResponseOutputItem).isEqualTo(responseOutputItem)
     }
 
+    @Test
+    fun ofProgram() {
+        val program =
+            ResponseOutputItem.Program.builder()
+                .id("id")
+                .callId("call_id")
+                .code("code")
+                .fingerprint("fingerprint")
+                .build()
+
+        val responseOutputItem = ResponseOutputItem.ofProgram(program)
+
+        assertThat(responseOutputItem.message()).isEmpty
+        assertThat(responseOutputItem.fileSearchCall()).isEmpty
+        assertThat(responseOutputItem.functionCall()).isEmpty
+        assertThat(responseOutputItem.functionCallOutput()).isEmpty
+        assertThat(responseOutputItem.webSearchCall()).isEmpty
+        assertThat(responseOutputItem.computerCall()).isEmpty
+        assertThat(responseOutputItem.computerCallOutput()).isEmpty
+        assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).contains(program)
+        assertThat(responseOutputItem.programOutput()).isEmpty
+        assertThat(responseOutputItem.toolSearchCall()).isEmpty
+        assertThat(responseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(responseOutputItem.additionalTools()).isEmpty
+        assertThat(responseOutputItem.compaction()).isEmpty
+        assertThat(responseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(responseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(responseOutputItem.localShellCall()).isEmpty
+        assertThat(responseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(responseOutputItem.shellCall()).isEmpty
+        assertThat(responseOutputItem.shellCallOutput()).isEmpty
+        assertThat(responseOutputItem.applyPatchCall()).isEmpty
+        assertThat(responseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(responseOutputItem.mcpCall()).isEmpty
+        assertThat(responseOutputItem.mcpListTools()).isEmpty
+        assertThat(responseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(responseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(responseOutputItem.customToolCall()).isEmpty
+        assertThat(responseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofProgramRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val responseOutputItem =
+            ResponseOutputItem.ofProgram(
+                ResponseOutputItem.Program.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .code("code")
+                    .fingerprint("fingerprint")
+                    .build()
+            )
+
+        val roundtrippedResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(responseOutputItem),
+                jacksonTypeRef<ResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedResponseOutputItem).isEqualTo(responseOutputItem)
+    }
+
+    @Test
+    fun ofProgramOutput() {
+        val programOutput =
+            ResponseOutputItem.ProgramOutput.builder()
+                .id("id")
+                .callId("call_id")
+                .result("result")
+                .status(ResponseOutputItem.ProgramOutput.Status.COMPLETED)
+                .build()
+
+        val responseOutputItem = ResponseOutputItem.ofProgramOutput(programOutput)
+
+        assertThat(responseOutputItem.message()).isEmpty
+        assertThat(responseOutputItem.fileSearchCall()).isEmpty
+        assertThat(responseOutputItem.functionCall()).isEmpty
+        assertThat(responseOutputItem.functionCallOutput()).isEmpty
+        assertThat(responseOutputItem.webSearchCall()).isEmpty
+        assertThat(responseOutputItem.computerCall()).isEmpty
+        assertThat(responseOutputItem.computerCallOutput()).isEmpty
+        assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).contains(programOutput)
+        assertThat(responseOutputItem.toolSearchCall()).isEmpty
+        assertThat(responseOutputItem.toolSearchOutput()).isEmpty
+        assertThat(responseOutputItem.additionalTools()).isEmpty
+        assertThat(responseOutputItem.compaction()).isEmpty
+        assertThat(responseOutputItem.imageGenerationCall()).isEmpty
+        assertThat(responseOutputItem.codeInterpreterCall()).isEmpty
+        assertThat(responseOutputItem.localShellCall()).isEmpty
+        assertThat(responseOutputItem.localShellCallOutput()).isEmpty
+        assertThat(responseOutputItem.shellCall()).isEmpty
+        assertThat(responseOutputItem.shellCallOutput()).isEmpty
+        assertThat(responseOutputItem.applyPatchCall()).isEmpty
+        assertThat(responseOutputItem.applyPatchCallOutput()).isEmpty
+        assertThat(responseOutputItem.mcpCall()).isEmpty
+        assertThat(responseOutputItem.mcpListTools()).isEmpty
+        assertThat(responseOutputItem.mcpApprovalRequest()).isEmpty
+        assertThat(responseOutputItem.mcpApprovalResponse()).isEmpty
+        assertThat(responseOutputItem.customToolCall()).isEmpty
+        assertThat(responseOutputItem.customToolCallOutput()).isEmpty
+    }
+
+    @Test
+    fun ofProgramOutputRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val responseOutputItem =
+            ResponseOutputItem.ofProgramOutput(
+                ResponseOutputItem.ProgramOutput.builder()
+                    .id("id")
+                    .callId("call_id")
+                    .result("result")
+                    .status(ResponseOutputItem.ProgramOutput.Status.COMPLETED)
+                    .build()
+            )
+
+        val roundtrippedResponseOutputItem =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(responseOutputItem),
+                jacksonTypeRef<ResponseOutputItem>(),
+            )
+
+        assertThat(roundtrippedResponseOutputItem).isEqualTo(responseOutputItem)
+    }
+
     @Test
     fun ofToolSearchCall() {
         val toolSearchCall =
@@ -704,6 +852,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).contains(toolSearchCall)
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -765,8 +915,14 @@ internal class ResponseOutputItemTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .createdBy("created_by")
@@ -782,6 +938,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).contains(toolSearchOutput)
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -821,8 +979,14 @@ internal class ResponseOutputItemTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .createdBy("created_by")
@@ -853,8 +1017,14 @@ internal class ResponseOutputItemTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .build()
@@ -869,6 +1039,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).contains(additionalTools)
@@ -906,8 +1078,14 @@ internal class ResponseOutputItemTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .build()
@@ -941,6 +1119,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -1001,6 +1181,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -1063,6 +1245,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -1138,6 +1322,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -1211,6 +1397,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -1267,6 +1455,7 @@ internal class ResponseOutputItemTest {
                 .callId("call_id")
                 .environment(ResponseLocalEnvironment.builder().build())
                 .status(ResponseFunctionShellToolCall.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
@@ -1280,6 +1469,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -1317,6 +1508,7 @@ internal class ResponseOutputItemTest {
                     .callId("call_id")
                     .environment(ResponseLocalEnvironment.builder().build())
                     .status(ResponseFunctionShellToolCall.Status.IN_PROGRESS)
+                    .callerDirect()
                     .createdBy("created_by")
                     .build()
             )
@@ -1346,6 +1538,7 @@ internal class ResponseOutputItemTest {
                         .build()
                 )
                 .status(ResponseFunctionShellToolCallOutput.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
@@ -1359,6 +1552,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -1397,6 +1592,7 @@ internal class ResponseOutputItemTest {
                             .build()
                     )
                     .status(ResponseFunctionShellToolCallOutput.Status.IN_PROGRESS)
+                    .callerDirect()
                     .createdBy("created_by")
                     .build()
             )
@@ -1423,6 +1619,7 @@ internal class ResponseOutputItemTest {
                         .build()
                 )
                 .status(ResponseApplyPatchToolCall.Status.IN_PROGRESS)
+                .callerDirect()
                 .createdBy("created_by")
                 .build()
 
@@ -1436,6 +1633,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -1471,6 +1670,7 @@ internal class ResponseOutputItemTest {
                             .build()
                     )
                     .status(ResponseApplyPatchToolCall.Status.IN_PROGRESS)
+                    .callerDirect()
                     .createdBy("created_by")
                     .build()
             )
@@ -1491,6 +1691,7 @@ internal class ResponseOutputItemTest {
                 .id("id")
                 .callId("call_id")
                 .status(ResponseApplyPatchToolCallOutput.Status.COMPLETED)
+                .callerDirect()
                 .createdBy("created_by")
                 .output("output")
                 .build()
@@ -1505,6 +1706,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -1534,6 +1737,7 @@ internal class ResponseOutputItemTest {
                     .id("id")
                     .callId("call_id")
                     .status(ResponseApplyPatchToolCallOutput.Status.COMPLETED)
+                    .callerDirect()
                     .createdBy("created_by")
                     .output("output")
                     .build()
@@ -1572,6 +1776,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -1645,6 +1851,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -1714,6 +1922,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -1776,6 +1986,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -1826,6 +2038,7 @@ internal class ResponseOutputItemTest {
                 .input("input")
                 .name("name")
                 .id("id")
+                .callerDirect()
                 .namespace("namespace")
                 .build()
 
@@ -1839,6 +2052,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -1869,6 +2084,7 @@ internal class ResponseOutputItemTest {
                     .input("input")
                     .name("name")
                     .id("id")
+                    .callerDirect()
                     .namespace("namespace")
                     .build()
             )
@@ -1889,6 +2105,7 @@ internal class ResponseOutputItemTest {
                 .callId("call_id")
                 .output("string")
                 .id("id")
+                .callerDirect()
                 .status(ResponseCustomToolCallOutputItem.Status.IN_PROGRESS)
                 .createdBy("created_by")
                 .build()
@@ -1903,6 +2120,8 @@ internal class ResponseOutputItemTest {
         assertThat(responseOutputItem.computerCall()).isEmpty
         assertThat(responseOutputItem.computerCallOutput()).isEmpty
         assertThat(responseOutputItem.reasoning()).isEmpty
+        assertThat(responseOutputItem.program()).isEmpty
+        assertThat(responseOutputItem.programOutput()).isEmpty
         assertThat(responseOutputItem.toolSearchCall()).isEmpty
         assertThat(responseOutputItem.toolSearchOutput()).isEmpty
         assertThat(responseOutputItem.additionalTools()).isEmpty
@@ -1932,6 +2151,7 @@ internal class ResponseOutputItemTest {
                     .callId("call_id")
                     .output("string")
                     .id("id")
+                    .callerDirect()
                     .status(ResponseCustomToolCallOutputItem.Status.IN_PROGRESS)
                     .createdBy("created_by")
                     .build()
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseQueuedEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseQueuedEventTest.kt
index 6f0c8b7ee..685a5b46c 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseQueuedEventTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseQueuedEventTest.kt
@@ -85,8 +85,14 @@ internal class ResponseQueuedEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -170,12 +176,19 @@ internal class ResponseQueuedEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -195,6 +208,7 @@ internal class ResponseQueuedEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -281,8 +295,14 @@ internal class ResponseQueuedEventTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .topP(1.0)
@@ -364,12 +384,19 @@ internal class ResponseQueuedEventTest {
                             .build()
                     )
                     .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        Response.PromptCacheOptions.builder()
+                            .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(Response.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
                     .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                     .reasoning(
                         Reasoning.builder()
                             .context(Reasoning.Context.AUTO)
                             .effort(ReasoningEffort.NONE)
                             .generateSummary(Reasoning.GenerateSummary.AUTO)
+                            .mode(Reasoning.Mode.STANDARD)
                             .summary(Reasoning.Summary.AUTO)
                             .build()
                     )
@@ -388,7 +415,10 @@ internal class ResponseQueuedEventTest {
                         ResponseUsage.builder()
                             .inputTokens(0L)
                             .inputTokensDetails(
-                                ResponseUsage.InputTokensDetails.builder().cachedTokens(0L).build()
+                                ResponseUsage.InputTokensDetails.builder()
+                                    .cacheWriteTokens(0L)
+                                    .cachedTokens(0L)
+                                    .build()
                             )
                             .outputTokens(0L)
                             .outputTokensDetails(
@@ -477,8 +507,14 @@ internal class ResponseQueuedEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -562,12 +598,19 @@ internal class ResponseQueuedEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -587,6 +630,7 @@ internal class ResponseQueuedEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseReasoningSummaryPartDoneEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseReasoningSummaryPartDoneEventTest.kt
index a16fd3e57..2887256d0 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseReasoningSummaryPartDoneEventTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseReasoningSummaryPartDoneEventTest.kt
@@ -18,6 +18,7 @@ internal class ResponseReasoningSummaryPartDoneEventTest {
                 .part(ResponseReasoningSummaryPartDoneEvent.Part.builder().text("text").build())
                 .sequenceNumber(0L)
                 .summaryIndex(0L)
+                .status(ResponseReasoningSummaryPartDoneEvent.Status.INCOMPLETE)
                 .build()
 
         assertThat(responseReasoningSummaryPartDoneEvent.itemId()).isEqualTo("item_id")
@@ -26,6 +27,8 @@ internal class ResponseReasoningSummaryPartDoneEventTest {
             .isEqualTo(ResponseReasoningSummaryPartDoneEvent.Part.builder().text("text").build())
         assertThat(responseReasoningSummaryPartDoneEvent.sequenceNumber()).isEqualTo(0L)
         assertThat(responseReasoningSummaryPartDoneEvent.summaryIndex()).isEqualTo(0L)
+        assertThat(responseReasoningSummaryPartDoneEvent.status())
+            .contains(ResponseReasoningSummaryPartDoneEvent.Status.INCOMPLETE)
     }
 
     @Test
@@ -38,6 +41,7 @@ internal class ResponseReasoningSummaryPartDoneEventTest {
                 .part(ResponseReasoningSummaryPartDoneEvent.Part.builder().text("text").build())
                 .sequenceNumber(0L)
                 .summaryIndex(0L)
+                .status(ResponseReasoningSummaryPartDoneEvent.Status.INCOMPLETE)
                 .build()
 
         val roundtrippedResponseReasoningSummaryPartDoneEvent =
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseStreamEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseStreamEventTest.kt
index 732c8c2d2..4eb632757 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseStreamEventTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseStreamEventTest.kt
@@ -855,8 +855,14 @@ internal class ResponseStreamEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -940,12 +946,19 @@ internal class ResponseStreamEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -965,6 +978,7 @@ internal class ResponseStreamEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -1114,8 +1128,14 @@ internal class ResponseStreamEventTest {
                                             .build()
                                     )
                                     .strict(true)
+                                    .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                     .deferLoading(true)
                                     .description("description")
+                                    .outputSchema(
+                                        FunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
                                     .build()
                             )
                             .topP(1.0)
@@ -1207,12 +1227,19 @@ internal class ResponseStreamEventTest {
                                     .build()
                             )
                             .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                Response.PromptCacheOptions.builder()
+                                    .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
                             .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                             .reasoning(
                                 Reasoning.builder()
                                     .context(Reasoning.Context.AUTO)
                                     .effort(ReasoningEffort.NONE)
                                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                    .mode(Reasoning.Mode.STANDARD)
                                     .summary(Reasoning.Summary.AUTO)
                                     .build()
                             )
@@ -1232,6 +1259,7 @@ internal class ResponseStreamEventTest {
                                     .inputTokens(0L)
                                     .inputTokensDetails(
                                         ResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
                                             .cachedTokens(0L)
                                             .build()
                                     )
@@ -1613,8 +1641,14 @@ internal class ResponseStreamEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -1698,12 +1732,19 @@ internal class ResponseStreamEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -1723,6 +1764,7 @@ internal class ResponseStreamEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -1872,8 +1914,14 @@ internal class ResponseStreamEventTest {
                                             .build()
                                     )
                                     .strict(true)
+                                    .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                     .deferLoading(true)
                                     .description("description")
+                                    .outputSchema(
+                                        FunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
                                     .build()
                             )
                             .topP(1.0)
@@ -1965,12 +2013,19 @@ internal class ResponseStreamEventTest {
                                     .build()
                             )
                             .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                Response.PromptCacheOptions.builder()
+                                    .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
                             .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                             .reasoning(
                                 Reasoning.builder()
                                     .context(Reasoning.Context.AUTO)
                                     .effort(ReasoningEffort.NONE)
                                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                    .mode(Reasoning.Mode.STANDARD)
                                     .summary(Reasoning.Summary.AUTO)
                                     .build()
                             )
@@ -1990,6 +2045,7 @@ internal class ResponseStreamEventTest {
                                     .inputTokens(0L)
                                     .inputTokensDetails(
                                         ResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
                                             .cachedTokens(0L)
                                             .build()
                                     )
@@ -2627,8 +2683,14 @@ internal class ResponseStreamEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -2712,12 +2774,19 @@ internal class ResponseStreamEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -2737,6 +2806,7 @@ internal class ResponseStreamEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -2886,8 +2956,14 @@ internal class ResponseStreamEventTest {
                                             .build()
                                     )
                                     .strict(true)
+                                    .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                     .deferLoading(true)
                                     .description("description")
+                                    .outputSchema(
+                                        FunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
                                     .build()
                             )
                             .topP(1.0)
@@ -2979,12 +3055,19 @@ internal class ResponseStreamEventTest {
                                     .build()
                             )
                             .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                Response.PromptCacheOptions.builder()
+                                    .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
                             .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                             .reasoning(
                                 Reasoning.builder()
                                     .context(Reasoning.Context.AUTO)
                                     .effort(ReasoningEffort.NONE)
                                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                    .mode(Reasoning.Mode.STANDARD)
                                     .summary(Reasoning.Summary.AUTO)
                                     .build()
                             )
@@ -3004,6 +3087,7 @@ internal class ResponseStreamEventTest {
                                     .inputTokens(0L)
                                     .inputTokensDetails(
                                         ResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
                                             .cachedTokens(0L)
                                             .build()
                                     )
@@ -3103,8 +3187,14 @@ internal class ResponseStreamEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -3188,12 +3278,19 @@ internal class ResponseStreamEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -3213,6 +3310,7 @@ internal class ResponseStreamEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -3362,8 +3460,14 @@ internal class ResponseStreamEventTest {
                                             .build()
                                     )
                                     .strict(true)
+                                    .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                     .deferLoading(true)
                                     .description("description")
+                                    .outputSchema(
+                                        FunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
                                     .build()
                             )
                             .topP(1.0)
@@ -3455,12 +3559,19 @@ internal class ResponseStreamEventTest {
                                     .build()
                             )
                             .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                Response.PromptCacheOptions.builder()
+                                    .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
                             .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                             .reasoning(
                                 Reasoning.builder()
                                     .context(Reasoning.Context.AUTO)
                                     .effort(ReasoningEffort.NONE)
                                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                    .mode(Reasoning.Mode.STANDARD)
                                     .summary(Reasoning.Summary.AUTO)
                                     .build()
                             )
@@ -3480,6 +3591,7 @@ internal class ResponseStreamEventTest {
                                     .inputTokens(0L)
                                     .inputTokensDetails(
                                         ResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
                                             .cachedTokens(0L)
                                             .build()
                                     )
@@ -3579,8 +3691,14 @@ internal class ResponseStreamEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -3664,12 +3782,19 @@ internal class ResponseStreamEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -3689,6 +3814,7 @@ internal class ResponseStreamEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -3838,8 +3964,14 @@ internal class ResponseStreamEventTest {
                                             .build()
                                     )
                                     .strict(true)
+                                    .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                     .deferLoading(true)
                                     .description("description")
+                                    .outputSchema(
+                                        FunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
                                     .build()
                             )
                             .topP(1.0)
@@ -3931,12 +4063,19 @@ internal class ResponseStreamEventTest {
                                     .build()
                             )
                             .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                Response.PromptCacheOptions.builder()
+                                    .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
                             .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                             .reasoning(
                                 Reasoning.builder()
                                     .context(Reasoning.Context.AUTO)
                                     .effort(ReasoningEffort.NONE)
                                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                    .mode(Reasoning.Mode.STANDARD)
                                     .summary(Reasoning.Summary.AUTO)
                                     .build()
                             )
@@ -3956,6 +4095,7 @@ internal class ResponseStreamEventTest {
                                     .inputTokens(0L)
                                     .inputTokensDetails(
                                         ResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
                                             .cachedTokens(0L)
                                             .build()
                                     )
@@ -4390,6 +4530,7 @@ internal class ResponseStreamEventTest {
                 .part(ResponseReasoningSummaryPartDoneEvent.Part.builder().text("text").build())
                 .sequenceNumber(0L)
                 .summaryIndex(0L)
+                .status(ResponseReasoningSummaryPartDoneEvent.Status.INCOMPLETE)
                 .build()
 
         val responseStreamEvent =
@@ -4462,6 +4603,7 @@ internal class ResponseStreamEventTest {
                     .part(ResponseReasoningSummaryPartDoneEvent.Part.builder().text("text").build())
                     .sequenceNumber(0L)
                     .summaryIndex(0L)
+                    .status(ResponseReasoningSummaryPartDoneEvent.Status.INCOMPLETE)
                     .build()
             )
 
@@ -6745,8 +6887,14 @@ internal class ResponseStreamEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -6830,12 +6978,19 @@ internal class ResponseStreamEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -6855,6 +7010,7 @@ internal class ResponseStreamEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -7004,8 +7160,14 @@ internal class ResponseStreamEventTest {
                                             .build()
                                     )
                                     .strict(true)
+                                    .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                     .deferLoading(true)
                                     .description("description")
+                                    .outputSchema(
+                                        FunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
                                     .build()
                             )
                             .topP(1.0)
@@ -7097,12 +7259,19 @@ internal class ResponseStreamEventTest {
                                     .build()
                             )
                             .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                Response.PromptCacheOptions.builder()
+                                    .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
                             .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                             .reasoning(
                                 Reasoning.builder()
                                     .context(Reasoning.Context.AUTO)
                                     .effort(ReasoningEffort.NONE)
                                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                    .mode(Reasoning.Mode.STANDARD)
                                     .summary(Reasoning.Summary.AUTO)
                                     .build()
                             )
@@ -7122,6 +7291,7 @@ internal class ResponseStreamEventTest {
                                     .inputTokens(0L)
                                     .inputTokensDetails(
                                         ResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
                                             .cachedTokens(0L)
                                             .build()
                                     )
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseTest.kt
index 6f6d608e8..4e262bf8e 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseTest.kt
@@ -84,8 +84,14 @@ internal class ResponseTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .topP(1.0)
@@ -165,12 +171,19 @@ internal class ResponseTest {
                         .build()
                 )
                 .promptCacheKey("prompt-cache-key-1234")
+                .promptCacheOptions(
+                    Response.PromptCacheOptions.builder()
+                        .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                        .ttl(Response.PromptCacheOptions.Ttl._30M)
+                        .build()
+                )
                 .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                 .reasoning(
                     Reasoning.builder()
                         .context(Reasoning.Context.AUTO)
                         .effort(ReasoningEffort.NONE)
                         .generateSummary(Reasoning.GenerateSummary.AUTO)
+                        .mode(Reasoning.Mode.STANDARD)
                         .summary(Reasoning.Summary.AUTO)
                         .build()
                 )
@@ -189,7 +202,10 @@ internal class ResponseTest {
                     ResponseUsage.builder()
                         .inputTokens(0L)
                         .inputTokensDetails(
-                            ResponseUsage.InputTokensDetails.builder().cachedTokens(0L).build()
+                            ResponseUsage.InputTokensDetails.builder()
+                                .cacheWriteTokens(0L)
+                                .cachedTokens(0L)
+                                .build()
                         )
                         .outputTokens(0L)
                         .outputTokensDetails(
@@ -275,8 +291,14 @@ internal class ResponseTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
             )
@@ -351,6 +373,13 @@ internal class ResponseTest {
                     .build()
             )
         assertThat(response.promptCacheKey()).contains("prompt-cache-key-1234")
+        assertThat(response.promptCacheOptions())
+            .contains(
+                Response.PromptCacheOptions.builder()
+                    .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                    .ttl(Response.PromptCacheOptions.Ttl._30M)
+                    .build()
+            )
         assertThat(response.promptCacheRetention())
             .contains(Response.PromptCacheRetention.IN_MEMORY)
         assertThat(response.reasoning())
@@ -359,6 +388,7 @@ internal class ResponseTest {
                     .context(Reasoning.Context.AUTO)
                     .effort(ReasoningEffort.NONE)
                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                    .mode(Reasoning.Mode.STANDARD)
                     .summary(Reasoning.Summary.AUTO)
                     .build()
             )
@@ -379,7 +409,10 @@ internal class ResponseTest {
                 ResponseUsage.builder()
                     .inputTokens(0L)
                     .inputTokensDetails(
-                        ResponseUsage.InputTokensDetails.builder().cachedTokens(0L).build()
+                        ResponseUsage.InputTokensDetails.builder()
+                            .cacheWriteTokens(0L)
+                            .cachedTokens(0L)
+                            .build()
                     )
                     .outputTokens(0L)
                     .outputTokensDetails(
@@ -461,8 +494,14 @@ internal class ResponseTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .topP(1.0)
@@ -542,12 +581,19 @@ internal class ResponseTest {
                         .build()
                 )
                 .promptCacheKey("prompt-cache-key-1234")
+                .promptCacheOptions(
+                    Response.PromptCacheOptions.builder()
+                        .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                        .ttl(Response.PromptCacheOptions.Ttl._30M)
+                        .build()
+                )
                 .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                 .reasoning(
                     Reasoning.builder()
                         .context(Reasoning.Context.AUTO)
                         .effort(ReasoningEffort.NONE)
                         .generateSummary(Reasoning.GenerateSummary.AUTO)
+                        .mode(Reasoning.Mode.STANDARD)
                         .summary(Reasoning.Summary.AUTO)
                         .build()
                 )
@@ -566,7 +612,10 @@ internal class ResponseTest {
                     ResponseUsage.builder()
                         .inputTokens(0L)
                         .inputTokensDetails(
-                            ResponseUsage.InputTokensDetails.builder().cachedTokens(0L).build()
+                            ResponseUsage.InputTokensDetails.builder()
+                                .cacheWriteTokens(0L)
+                                .cachedTokens(0L)
+                                .build()
                         )
                         .outputTokens(0L)
                         .outputTokensDetails(
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseToolSearchOutputItemParamTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseToolSearchOutputItemParamTest.kt
index 91254f24b..487bafbf9 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseToolSearchOutputItemParamTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseToolSearchOutputItemParamTest.kt
@@ -23,8 +23,14 @@ internal class ResponseToolSearchOutputItemParamTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .id("tso_123")
@@ -44,8 +50,14 @@ internal class ResponseToolSearchOutputItemParamTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
             )
@@ -71,8 +83,14 @@ internal class ResponseToolSearchOutputItemParamTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .id("tso_123")
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseToolSearchOutputItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseToolSearchOutputItemTest.kt
index 4550a034c..fda9f9163 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseToolSearchOutputItemTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseToolSearchOutputItemTest.kt
@@ -27,8 +27,14 @@ internal class ResponseToolSearchOutputItemTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .createdBy("created_by")
@@ -51,8 +57,14 @@ internal class ResponseToolSearchOutputItemTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
             )
@@ -77,8 +89,14 @@ internal class ResponseToolSearchOutputItemTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .createdBy("created_by")
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseUsageTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseUsageTest.kt
index a2016e051..a8036ae70 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseUsageTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponseUsageTest.kt
@@ -15,7 +15,10 @@ internal class ResponseUsageTest {
             ResponseUsage.builder()
                 .inputTokens(0L)
                 .inputTokensDetails(
-                    ResponseUsage.InputTokensDetails.builder().cachedTokens(0L).build()
+                    ResponseUsage.InputTokensDetails.builder()
+                        .cacheWriteTokens(0L)
+                        .cachedTokens(0L)
+                        .build()
                 )
                 .outputTokens(0L)
                 .outputTokensDetails(
@@ -26,7 +29,12 @@ internal class ResponseUsageTest {
 
         assertThat(responseUsage.inputTokens()).isEqualTo(0L)
         assertThat(responseUsage.inputTokensDetails())
-            .isEqualTo(ResponseUsage.InputTokensDetails.builder().cachedTokens(0L).build())
+            .isEqualTo(
+                ResponseUsage.InputTokensDetails.builder()
+                    .cacheWriteTokens(0L)
+                    .cachedTokens(0L)
+                    .build()
+            )
         assertThat(responseUsage.outputTokens()).isEqualTo(0L)
         assertThat(responseUsage.outputTokensDetails())
             .isEqualTo(ResponseUsage.OutputTokensDetails.builder().reasoningTokens(0L).build())
@@ -40,7 +48,10 @@ internal class ResponseUsageTest {
             ResponseUsage.builder()
                 .inputTokens(0L)
                 .inputTokensDetails(
-                    ResponseUsage.InputTokensDetails.builder().cachedTokens(0L).build()
+                    ResponseUsage.InputTokensDetails.builder()
+                        .cacheWriteTokens(0L)
+                        .cachedTokens(0L)
+                        .build()
                 )
                 .outputTokens(0L)
                 .outputTokensDetails(
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponsesClientEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponsesClientEventTest.kt
index 2169585ff..435628276 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponsesClientEventTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponsesClientEventTest.kt
@@ -39,7 +39,29 @@ internal class ResponsesClientEventTest {
                         .build()
                 )
                 .model(ChatModel.GPT_5_1)
-                .moderation(ResponsesClientEvent.Moderation.builder().model("model").build())
+                .moderation(
+                    ResponsesClientEvent.Moderation.builder()
+                        .model("model")
+                        .policy(
+                            ResponsesClientEvent.Moderation.Policy.builder()
+                                .input(
+                                    ResponsesClientEvent.Moderation.Policy.Input.builder()
+                                        .mode(
+                                            ResponsesClientEvent.Moderation.Policy.Input.Mode.SCORE
+                                        )
+                                        .build()
+                                )
+                                .output(
+                                    ResponsesClientEvent.Moderation.Policy.Output.builder()
+                                        .mode(
+                                            ResponsesClientEvent.Moderation.Policy.Output.Mode.SCORE
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
                 .parallelToolCalls(true)
                 .previousResponseId("previous_response_id")
                 .prompt(
@@ -54,12 +76,19 @@ internal class ResponsesClientEventTest {
                         .build()
                 )
                 .promptCacheKey("prompt-cache-key-1234")
+                .promptCacheOptions(
+                    ResponsesClientEvent.PromptCacheOptions.builder()
+                        .mode(ResponsesClientEvent.PromptCacheOptions.Mode.IMPLICIT)
+                        .ttl(ResponsesClientEvent.PromptCacheOptions.Ttl._30M)
+                        .build()
+                )
                 .promptCacheRetention(ResponsesClientEvent.PromptCacheRetention.IN_MEMORY)
                 .reasoning(
                     Reasoning.builder()
                         .context(Reasoning.Context.AUTO)
                         .effort(ReasoningEffort.NONE)
                         .generateSummary(Reasoning.GenerateSummary.AUTO)
+                        .mode(Reasoning.Mode.STANDARD)
                         .summary(Reasoning.Summary.AUTO)
                         .build()
                 )
@@ -87,8 +116,14 @@ internal class ResponsesClientEventTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .topLogprobs(0L)
@@ -122,7 +157,25 @@ internal class ResponsesClientEventTest {
             )
         assertThat(responsesClientEvent.model()).contains(ResponsesModel.ofChat(ChatModel.GPT_5_1))
         assertThat(responsesClientEvent.moderation())
-            .contains(ResponsesClientEvent.Moderation.builder().model("model").build())
+            .contains(
+                ResponsesClientEvent.Moderation.builder()
+                    .model("model")
+                    .policy(
+                        ResponsesClientEvent.Moderation.Policy.builder()
+                            .input(
+                                ResponsesClientEvent.Moderation.Policy.Input.builder()
+                                    .mode(ResponsesClientEvent.Moderation.Policy.Input.Mode.SCORE)
+                                    .build()
+                            )
+                            .output(
+                                ResponsesClientEvent.Moderation.Policy.Output.builder()
+                                    .mode(ResponsesClientEvent.Moderation.Policy.Output.Mode.SCORE)
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .build()
+            )
         assertThat(responsesClientEvent.parallelToolCalls()).contains(true)
         assertThat(responsesClientEvent.previousResponseId()).contains("previous_response_id")
         assertThat(responsesClientEvent.prompt())
@@ -138,6 +191,13 @@ internal class ResponsesClientEventTest {
                     .build()
             )
         assertThat(responsesClientEvent.promptCacheKey()).contains("prompt-cache-key-1234")
+        assertThat(responsesClientEvent.promptCacheOptions())
+            .contains(
+                ResponsesClientEvent.PromptCacheOptions.builder()
+                    .mode(ResponsesClientEvent.PromptCacheOptions.Mode.IMPLICIT)
+                    .ttl(ResponsesClientEvent.PromptCacheOptions.Ttl._30M)
+                    .build()
+            )
         assertThat(responsesClientEvent.promptCacheRetention())
             .contains(ResponsesClientEvent.PromptCacheRetention.IN_MEMORY)
         assertThat(responsesClientEvent.reasoning())
@@ -146,6 +206,7 @@ internal class ResponsesClientEventTest {
                     .context(Reasoning.Context.AUTO)
                     .effort(ReasoningEffort.NONE)
                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                    .mode(Reasoning.Mode.STANDARD)
                     .summary(Reasoning.Summary.AUTO)
                     .build()
             )
@@ -177,8 +238,14 @@ internal class ResponsesClientEventTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
             )
@@ -212,7 +279,29 @@ internal class ResponsesClientEventTest {
                         .build()
                 )
                 .model(ChatModel.GPT_5_1)
-                .moderation(ResponsesClientEvent.Moderation.builder().model("model").build())
+                .moderation(
+                    ResponsesClientEvent.Moderation.builder()
+                        .model("model")
+                        .policy(
+                            ResponsesClientEvent.Moderation.Policy.builder()
+                                .input(
+                                    ResponsesClientEvent.Moderation.Policy.Input.builder()
+                                        .mode(
+                                            ResponsesClientEvent.Moderation.Policy.Input.Mode.SCORE
+                                        )
+                                        .build()
+                                )
+                                .output(
+                                    ResponsesClientEvent.Moderation.Policy.Output.builder()
+                                        .mode(
+                                            ResponsesClientEvent.Moderation.Policy.Output.Mode.SCORE
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
                 .parallelToolCalls(true)
                 .previousResponseId("previous_response_id")
                 .prompt(
@@ -227,12 +316,19 @@ internal class ResponsesClientEventTest {
                         .build()
                 )
                 .promptCacheKey("prompt-cache-key-1234")
+                .promptCacheOptions(
+                    ResponsesClientEvent.PromptCacheOptions.builder()
+                        .mode(ResponsesClientEvent.PromptCacheOptions.Mode.IMPLICIT)
+                        .ttl(ResponsesClientEvent.PromptCacheOptions.Ttl._30M)
+                        .build()
+                )
                 .promptCacheRetention(ResponsesClientEvent.PromptCacheRetention.IN_MEMORY)
                 .reasoning(
                     Reasoning.builder()
                         .context(Reasoning.Context.AUTO)
                         .effort(ReasoningEffort.NONE)
                         .generateSummary(Reasoning.GenerateSummary.AUTO)
+                        .mode(Reasoning.Mode.STANDARD)
                         .summary(Reasoning.Summary.AUTO)
                         .build()
                 )
@@ -260,8 +356,14 @@ internal class ResponsesClientEventTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .topLogprobs(0L)
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponsesServerEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponsesServerEventTest.kt
index 9a9afe1e8..b62065f35 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponsesServerEventTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ResponsesServerEventTest.kt
@@ -870,8 +870,14 @@ internal class ResponsesServerEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -955,12 +961,19 @@ internal class ResponsesServerEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -980,6 +993,7 @@ internal class ResponsesServerEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -1129,8 +1143,14 @@ internal class ResponsesServerEventTest {
                                             .build()
                                     )
                                     .strict(true)
+                                    .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                     .deferLoading(true)
                                     .description("description")
+                                    .outputSchema(
+                                        FunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
                                     .build()
                             )
                             .topP(1.0)
@@ -1222,12 +1242,19 @@ internal class ResponsesServerEventTest {
                                     .build()
                             )
                             .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                Response.PromptCacheOptions.builder()
+                                    .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
                             .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                             .reasoning(
                                 Reasoning.builder()
                                     .context(Reasoning.Context.AUTO)
                                     .effort(ReasoningEffort.NONE)
                                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                    .mode(Reasoning.Mode.STANDARD)
                                     .summary(Reasoning.Summary.AUTO)
                                     .build()
                             )
@@ -1247,6 +1274,7 @@ internal class ResponsesServerEventTest {
                                     .inputTokens(0L)
                                     .inputTokensDetails(
                                         ResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
                                             .cachedTokens(0L)
                                             .build()
                                     )
@@ -1631,8 +1659,14 @@ internal class ResponsesServerEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -1716,12 +1750,19 @@ internal class ResponsesServerEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -1741,6 +1782,7 @@ internal class ResponsesServerEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -1890,8 +1932,14 @@ internal class ResponsesServerEventTest {
                                             .build()
                                     )
                                     .strict(true)
+                                    .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                     .deferLoading(true)
                                     .description("description")
+                                    .outputSchema(
+                                        FunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
                                     .build()
                             )
                             .topP(1.0)
@@ -1983,12 +2031,19 @@ internal class ResponsesServerEventTest {
                                     .build()
                             )
                             .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                Response.PromptCacheOptions.builder()
+                                    .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
                             .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                             .reasoning(
                                 Reasoning.builder()
                                     .context(Reasoning.Context.AUTO)
                                     .effort(ReasoningEffort.NONE)
                                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                    .mode(Reasoning.Mode.STANDARD)
                                     .summary(Reasoning.Summary.AUTO)
                                     .build()
                             )
@@ -2008,6 +2063,7 @@ internal class ResponsesServerEventTest {
                                     .inputTokens(0L)
                                     .inputTokensDetails(
                                         ResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
                                             .cachedTokens(0L)
                                             .build()
                                     )
@@ -2653,8 +2709,14 @@ internal class ResponsesServerEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -2738,12 +2800,19 @@ internal class ResponsesServerEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -2763,6 +2832,7 @@ internal class ResponsesServerEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -2912,8 +2982,14 @@ internal class ResponsesServerEventTest {
                                             .build()
                                     )
                                     .strict(true)
+                                    .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                     .deferLoading(true)
                                     .description("description")
+                                    .outputSchema(
+                                        FunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
                                     .build()
                             )
                             .topP(1.0)
@@ -3005,12 +3081,19 @@ internal class ResponsesServerEventTest {
                                     .build()
                             )
                             .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                Response.PromptCacheOptions.builder()
+                                    .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
                             .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                             .reasoning(
                                 Reasoning.builder()
                                     .context(Reasoning.Context.AUTO)
                                     .effort(ReasoningEffort.NONE)
                                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                    .mode(Reasoning.Mode.STANDARD)
                                     .summary(Reasoning.Summary.AUTO)
                                     .build()
                             )
@@ -3030,6 +3113,7 @@ internal class ResponsesServerEventTest {
                                     .inputTokens(0L)
                                     .inputTokensDetails(
                                         ResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
                                             .cachedTokens(0L)
                                             .build()
                                     )
@@ -3129,8 +3213,14 @@ internal class ResponsesServerEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -3214,12 +3304,19 @@ internal class ResponsesServerEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -3239,6 +3336,7 @@ internal class ResponsesServerEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -3388,8 +3486,14 @@ internal class ResponsesServerEventTest {
                                             .build()
                                     )
                                     .strict(true)
+                                    .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                     .deferLoading(true)
                                     .description("description")
+                                    .outputSchema(
+                                        FunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
                                     .build()
                             )
                             .topP(1.0)
@@ -3481,12 +3585,19 @@ internal class ResponsesServerEventTest {
                                     .build()
                             )
                             .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                Response.PromptCacheOptions.builder()
+                                    .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
                             .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                             .reasoning(
                                 Reasoning.builder()
                                     .context(Reasoning.Context.AUTO)
                                     .effort(ReasoningEffort.NONE)
                                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                    .mode(Reasoning.Mode.STANDARD)
                                     .summary(Reasoning.Summary.AUTO)
                                     .build()
                             )
@@ -3506,6 +3617,7 @@ internal class ResponsesServerEventTest {
                                     .inputTokens(0L)
                                     .inputTokensDetails(
                                         ResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
                                             .cachedTokens(0L)
                                             .build()
                                     )
@@ -3605,8 +3717,14 @@ internal class ResponsesServerEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -3690,12 +3808,19 @@ internal class ResponsesServerEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -3715,6 +3840,7 @@ internal class ResponsesServerEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -3864,8 +3990,14 @@ internal class ResponsesServerEventTest {
                                             .build()
                                     )
                                     .strict(true)
+                                    .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                     .deferLoading(true)
                                     .description("description")
+                                    .outputSchema(
+                                        FunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
                                     .build()
                             )
                             .topP(1.0)
@@ -3957,12 +4089,19 @@ internal class ResponsesServerEventTest {
                                     .build()
                             )
                             .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                Response.PromptCacheOptions.builder()
+                                    .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
                             .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                             .reasoning(
                                 Reasoning.builder()
                                     .context(Reasoning.Context.AUTO)
                                     .effort(ReasoningEffort.NONE)
                                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                    .mode(Reasoning.Mode.STANDARD)
                                     .summary(Reasoning.Summary.AUTO)
                                     .build()
                             )
@@ -3982,6 +4121,7 @@ internal class ResponsesServerEventTest {
                                     .inputTokens(0L)
                                     .inputTokensDetails(
                                         ResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
                                             .cachedTokens(0L)
                                             .build()
                                     )
@@ -4420,6 +4560,7 @@ internal class ResponsesServerEventTest {
                 .part(ResponseReasoningSummaryPartDoneEvent.Part.builder().text("text").build())
                 .sequenceNumber(0L)
                 .summaryIndex(0L)
+                .status(ResponseReasoningSummaryPartDoneEvent.Status.INCOMPLETE)
                 .build()
 
         val responsesServerEvent =
@@ -4494,6 +4635,7 @@ internal class ResponsesServerEventTest {
                     .part(ResponseReasoningSummaryPartDoneEvent.Part.builder().text("text").build())
                     .sequenceNumber(0L)
                     .summaryIndex(0L)
+                    .status(ResponseReasoningSummaryPartDoneEvent.Status.INCOMPLETE)
                     .build()
             )
 
@@ -6814,8 +6956,14 @@ internal class ResponsesServerEventTest {
                                         .build()
                                 )
                                 .strict(true)
+                                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                 .deferLoading(true)
                                 .description("description")
+                                .outputSchema(
+                                    FunctionTool.OutputSchema.builder()
+                                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                        .build()
+                                )
                                 .build()
                         )
                         .topP(1.0)
@@ -6899,12 +7047,19 @@ internal class ResponsesServerEventTest {
                                 .build()
                         )
                         .promptCacheKey("prompt-cache-key-1234")
+                        .promptCacheOptions(
+                            Response.PromptCacheOptions.builder()
+                                .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                .build()
+                        )
                         .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                         .reasoning(
                             Reasoning.builder()
                                 .context(Reasoning.Context.AUTO)
                                 .effort(ReasoningEffort.NONE)
                                 .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                .mode(Reasoning.Mode.STANDARD)
                                 .summary(Reasoning.Summary.AUTO)
                                 .build()
                         )
@@ -6924,6 +7079,7 @@ internal class ResponsesServerEventTest {
                                 .inputTokens(0L)
                                 .inputTokensDetails(
                                     ResponseUsage.InputTokensDetails.builder()
+                                        .cacheWriteTokens(0L)
                                         .cachedTokens(0L)
                                         .build()
                                 )
@@ -7073,8 +7229,14 @@ internal class ResponsesServerEventTest {
                                             .build()
                                     )
                                     .strict(true)
+                                    .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                                     .deferLoading(true)
                                     .description("description")
+                                    .outputSchema(
+                                        FunctionTool.OutputSchema.builder()
+                                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                            .build()
+                                    )
                                     .build()
                             )
                             .topP(1.0)
@@ -7166,12 +7328,19 @@ internal class ResponsesServerEventTest {
                                     .build()
                             )
                             .promptCacheKey("prompt-cache-key-1234")
+                            .promptCacheOptions(
+                                Response.PromptCacheOptions.builder()
+                                    .mode(Response.PromptCacheOptions.Mode.IMPLICIT)
+                                    .ttl(Response.PromptCacheOptions.Ttl._30M)
+                                    .build()
+                            )
                             .promptCacheRetention(Response.PromptCacheRetention.IN_MEMORY)
                             .reasoning(
                                 Reasoning.builder()
                                     .context(Reasoning.Context.AUTO)
                                     .effort(ReasoningEffort.NONE)
                                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                                    .mode(Reasoning.Mode.STANDARD)
                                     .summary(Reasoning.Summary.AUTO)
                                     .build()
                             )
@@ -7191,6 +7360,7 @@ internal class ResponsesServerEventTest {
                                     .inputTokens(0L)
                                     .inputTokensDetails(
                                         ResponseUsage.InputTokensDetails.builder()
+                                            .cacheWriteTokens(0L)
                                             .cachedTokens(0L)
                                             .build()
                                     )
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/ToolTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/ToolTest.kt
index d75330f22..450e5eeba 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/ToolTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/ToolTest.kt
@@ -26,8 +26,14 @@ internal class ToolTest {
                         .build()
                 )
                 .strict(true)
+                .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                 .deferLoading(true)
                 .description("description")
+                .outputSchema(
+                    FunctionTool.OutputSchema.builder()
+                        .putAdditionalProperty("foo", JsonValue.from("bar"))
+                        .build()
+                )
                 .build()
 
         val tool = Tool.ofFunction(function)
@@ -39,6 +45,7 @@ internal class ToolTest {
         assertThat(tool.webSearch()).isEmpty
         assertThat(tool.mcp()).isEmpty
         assertThat(tool.codeInterpreter()).isEmpty
+        assertThat(tool.programmaticToolCalling()).isEmpty
         assertThat(tool.imageGeneration()).isEmpty
         assertThat(tool.localShell()).isEmpty
         assertThat(tool.shell()).isEmpty
@@ -62,8 +69,14 @@ internal class ToolTest {
                             .build()
                     )
                     .strict(true)
+                    .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                     .deferLoading(true)
                     .description("description")
+                    .outputSchema(
+                        FunctionTool.OutputSchema.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                            .build()
+                    )
                     .build()
             )
 
@@ -109,6 +122,7 @@ internal class ToolTest {
         assertThat(tool.webSearch()).isEmpty
         assertThat(tool.mcp()).isEmpty
         assertThat(tool.codeInterpreter()).isEmpty
+        assertThat(tool.programmaticToolCalling()).isEmpty
         assertThat(tool.imageGeneration()).isEmpty
         assertThat(tool.localShell()).isEmpty
         assertThat(tool.shell()).isEmpty
@@ -168,6 +182,7 @@ internal class ToolTest {
         assertThat(tool.webSearch()).isEmpty
         assertThat(tool.mcp()).isEmpty
         assertThat(tool.codeInterpreter()).isEmpty
+        assertThat(tool.programmaticToolCalling()).isEmpty
         assertThat(tool.imageGeneration()).isEmpty
         assertThat(tool.localShell()).isEmpty
         assertThat(tool.shell()).isEmpty
@@ -207,6 +222,7 @@ internal class ToolTest {
         assertThat(tool.webSearch()).isEmpty
         assertThat(tool.mcp()).isEmpty
         assertThat(tool.codeInterpreter()).isEmpty
+        assertThat(tool.programmaticToolCalling()).isEmpty
         assertThat(tool.imageGeneration()).isEmpty
         assertThat(tool.localShell()).isEmpty
         assertThat(tool.shell()).isEmpty
@@ -262,6 +278,7 @@ internal class ToolTest {
         assertThat(tool.webSearch()).contains(webSearch)
         assertThat(tool.mcp()).isEmpty
         assertThat(tool.codeInterpreter()).isEmpty
+        assertThat(tool.programmaticToolCalling()).isEmpty
         assertThat(tool.imageGeneration()).isEmpty
         assertThat(tool.localShell()).isEmpty
         assertThat(tool.shell()).isEmpty
@@ -304,6 +321,7 @@ internal class ToolTest {
         val mcp =
             Tool.Mcp.builder()
                 .serverLabel("server_label")
+                .addAllowedCaller(Tool.Mcp.AllowedCaller.DIRECT)
                 .allowedToolsOfMcp(listOf("string"))
                 .authorization("authorization")
                 .connectorId(Tool.Mcp.ConnectorId.CONNECTOR_DROPBOX)
@@ -328,6 +346,7 @@ internal class ToolTest {
         assertThat(tool.webSearch()).isEmpty
         assertThat(tool.mcp()).contains(mcp)
         assertThat(tool.codeInterpreter()).isEmpty
+        assertThat(tool.programmaticToolCalling()).isEmpty
         assertThat(tool.imageGeneration()).isEmpty
         assertThat(tool.localShell()).isEmpty
         assertThat(tool.shell()).isEmpty
@@ -345,6 +364,7 @@ internal class ToolTest {
             Tool.ofMcp(
                 Tool.Mcp.builder()
                     .serverLabel("server_label")
+                    .addAllowedCaller(Tool.Mcp.AllowedCaller.DIRECT)
                     .allowedToolsOfMcp(listOf("string"))
                     .authorization("authorization")
                     .connectorId(Tool.Mcp.ConnectorId.CONNECTOR_DROPBOX)
@@ -369,7 +389,11 @@ internal class ToolTest {
 
     @Test
     fun ofCodeInterpreter() {
-        val codeInterpreter = Tool.CodeInterpreter.builder().container("string").build()
+        val codeInterpreter =
+            Tool.CodeInterpreter.builder()
+                .container("string")
+                .addAllowedCaller(Tool.CodeInterpreter.AllowedCaller.DIRECT)
+                .build()
 
         val tool = Tool.ofCodeInterpreter(codeInterpreter)
 
@@ -380,6 +404,7 @@ internal class ToolTest {
         assertThat(tool.webSearch()).isEmpty
         assertThat(tool.mcp()).isEmpty
         assertThat(tool.codeInterpreter()).contains(codeInterpreter)
+        assertThat(tool.programmaticToolCalling()).isEmpty
         assertThat(tool.imageGeneration()).isEmpty
         assertThat(tool.localShell()).isEmpty
         assertThat(tool.shell()).isEmpty
@@ -394,7 +419,46 @@ internal class ToolTest {
     fun ofCodeInterpreterRoundtrip() {
         val jsonMapper = jsonMapper()
         val tool =
-            Tool.ofCodeInterpreter(Tool.CodeInterpreter.builder().container("string").build())
+            Tool.ofCodeInterpreter(
+                Tool.CodeInterpreter.builder()
+                    .container("string")
+                    .addAllowedCaller(Tool.CodeInterpreter.AllowedCaller.DIRECT)
+                    .build()
+            )
+
+        val roundtrippedTool =
+            jsonMapper.readValue(jsonMapper.writeValueAsString(tool), jacksonTypeRef<Tool>())
+
+        assertThat(roundtrippedTool).isEqualTo(tool)
+    }
+
+    @Test
+    fun ofProgrammaticToolCalling() {
+        val tool = Tool.ofProgrammaticToolCalling()
+
+        assertThat(tool.function()).isEmpty
+        assertThat(tool.fileSearch()).isEmpty
+        assertThat(tool.computer()).isEmpty
+        assertThat(tool.computerUsePreview()).isEmpty
+        assertThat(tool.webSearch()).isEmpty
+        assertThat(tool.mcp()).isEmpty
+        assertThat(tool.codeInterpreter()).isEmpty
+        assertThat(tool.programmaticToolCalling())
+            .contains(JsonValue.from(mapOf("type" to "programmatic_tool_calling")))
+        assertThat(tool.imageGeneration()).isEmpty
+        assertThat(tool.localShell()).isEmpty
+        assertThat(tool.shell()).isEmpty
+        assertThat(tool.custom()).isEmpty
+        assertThat(tool.namespace()).isEmpty
+        assertThat(tool.search()).isEmpty
+        assertThat(tool.webSearchPreview()).isEmpty
+        assertThat(tool.applyPatch()).isEmpty
+    }
+
+    @Test
+    fun ofProgrammaticToolCallingRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val tool = Tool.ofProgrammaticToolCalling()
 
         val roundtrippedTool =
             jsonMapper.readValue(jsonMapper.writeValueAsString(tool), jacksonTypeRef<Tool>())
@@ -433,6 +497,7 @@ internal class ToolTest {
         assertThat(tool.webSearch()).isEmpty
         assertThat(tool.mcp()).isEmpty
         assertThat(tool.codeInterpreter()).isEmpty
+        assertThat(tool.programmaticToolCalling()).isEmpty
         assertThat(tool.imageGeneration()).contains(imageGeneration)
         assertThat(tool.localShell()).isEmpty
         assertThat(tool.shell()).isEmpty
@@ -485,6 +550,7 @@ internal class ToolTest {
         assertThat(tool.webSearch()).isEmpty
         assertThat(tool.mcp()).isEmpty
         assertThat(tool.codeInterpreter()).isEmpty
+        assertThat(tool.programmaticToolCalling()).isEmpty
         assertThat(tool.imageGeneration()).isEmpty
         assertThat(tool.localShell()).contains(JsonValue.from(mapOf("type" to "local_shell")))
         assertThat(tool.shell()).isEmpty
@@ -510,6 +576,7 @@ internal class ToolTest {
     fun ofShell() {
         val shell =
             FunctionShellTool.builder()
+                .addAllowedCaller(FunctionShellTool.AllowedCaller.DIRECT)
                 .environment(
                     ContainerAuto.builder()
                         .addFileId("file-123")
@@ -529,6 +596,7 @@ internal class ToolTest {
         assertThat(tool.webSearch()).isEmpty
         assertThat(tool.mcp()).isEmpty
         assertThat(tool.codeInterpreter()).isEmpty
+        assertThat(tool.programmaticToolCalling()).isEmpty
         assertThat(tool.imageGeneration()).isEmpty
         assertThat(tool.localShell()).isEmpty
         assertThat(tool.shell()).contains(shell)
@@ -545,6 +613,7 @@ internal class ToolTest {
         val tool =
             Tool.ofShell(
                 FunctionShellTool.builder()
+                    .addAllowedCaller(FunctionShellTool.AllowedCaller.DIRECT)
                     .environment(
                         ContainerAuto.builder()
                             .addFileId("file-123")
@@ -569,6 +638,7 @@ internal class ToolTest {
         val custom =
             CustomTool.builder()
                 .name("name")
+                .addAllowedCaller(CustomTool.AllowedCaller.DIRECT)
                 .deferLoading(true)
                 .description("description")
                 .formatText()
@@ -583,6 +653,7 @@ internal class ToolTest {
         assertThat(tool.webSearch()).isEmpty
         assertThat(tool.mcp()).isEmpty
         assertThat(tool.codeInterpreter()).isEmpty
+        assertThat(tool.programmaticToolCalling()).isEmpty
         assertThat(tool.imageGeneration()).isEmpty
         assertThat(tool.localShell()).isEmpty
         assertThat(tool.shell()).isEmpty
@@ -600,6 +671,7 @@ internal class ToolTest {
             Tool.ofCustom(
                 CustomTool.builder()
                     .name("name")
+                    .addAllowedCaller(CustomTool.AllowedCaller.DIRECT)
                     .deferLoading(true)
                     .description("description")
                     .formatText()
@@ -621,8 +693,14 @@ internal class ToolTest {
                 .addTool(
                     NamespaceTool.Tool.Function.builder()
                         .name("name")
+                        .addAllowedCaller(NamespaceTool.Tool.Function.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            NamespaceTool.Tool.Function.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .parameters(JsonValue.from(mapOf<String, Any>()))
                         .strict(true)
                         .build()
@@ -638,6 +716,7 @@ internal class ToolTest {
         assertThat(tool.webSearch()).isEmpty
         assertThat(tool.mcp()).isEmpty
         assertThat(tool.codeInterpreter()).isEmpty
+        assertThat(tool.programmaticToolCalling()).isEmpty
         assertThat(tool.imageGeneration()).isEmpty
         assertThat(tool.localShell()).isEmpty
         assertThat(tool.shell()).isEmpty
@@ -659,8 +738,14 @@ internal class ToolTest {
                     .addTool(
                         NamespaceTool.Tool.Function.builder()
                             .name("name")
+                            .addAllowedCaller(NamespaceTool.Tool.Function.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                NamespaceTool.Tool.Function.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .parameters(JsonValue.from(mapOf<String, Any>()))
                             .strict(true)
                             .build()
@@ -692,6 +777,7 @@ internal class ToolTest {
         assertThat(tool.webSearch()).isEmpty
         assertThat(tool.mcp()).isEmpty
         assertThat(tool.codeInterpreter()).isEmpty
+        assertThat(tool.programmaticToolCalling()).isEmpty
         assertThat(tool.imageGeneration()).isEmpty
         assertThat(tool.localShell()).isEmpty
         assertThat(tool.shell()).isEmpty
@@ -746,6 +832,7 @@ internal class ToolTest {
         assertThat(tool.webSearch()).isEmpty
         assertThat(tool.mcp()).isEmpty
         assertThat(tool.codeInterpreter()).isEmpty
+        assertThat(tool.programmaticToolCalling()).isEmpty
         assertThat(tool.imageGeneration()).isEmpty
         assertThat(tool.localShell()).isEmpty
         assertThat(tool.shell()).isEmpty
@@ -784,7 +871,8 @@ internal class ToolTest {
 
     @Test
     fun ofApplyPatch() {
-        val applyPatch = ApplyPatchTool.builder().build()
+        val applyPatch =
+            ApplyPatchTool.builder().addAllowedCaller(ApplyPatchTool.AllowedCaller.DIRECT).build()
 
         val tool = Tool.ofApplyPatch(applyPatch)
 
@@ -795,6 +883,7 @@ internal class ToolTest {
         assertThat(tool.webSearch()).isEmpty
         assertThat(tool.mcp()).isEmpty
         assertThat(tool.codeInterpreter()).isEmpty
+        assertThat(tool.programmaticToolCalling()).isEmpty
         assertThat(tool.imageGeneration()).isEmpty
         assertThat(tool.localShell()).isEmpty
         assertThat(tool.shell()).isEmpty
@@ -808,7 +897,12 @@ internal class ToolTest {
     @Test
     fun ofApplyPatchRoundtrip() {
         val jsonMapper = jsonMapper()
-        val tool = Tool.ofApplyPatch(ApplyPatchTool.builder().build())
+        val tool =
+            Tool.ofApplyPatch(
+                ApplyPatchTool.builder()
+                    .addAllowedCaller(ApplyPatchTool.AllowedCaller.DIRECT)
+                    .build()
+            )
 
         val roundtrippedTool =
             jsonMapper.readValue(jsonMapper.writeValueAsString(tool), jacksonTypeRef<Tool>())
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/inputitems/ResponseItemListTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/inputitems/ResponseItemListTest.kt
index 3ea4d4166..3f05a9fe4 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/inputitems/ResponseItemListTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/inputitems/ResponseItemListTest.kt
@@ -5,6 +5,7 @@ package com.openai.models.responses.inputitems
 import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
 import com.openai.core.jsonMapper
 import com.openai.models.responses.ResponseInputMessageItem
+import com.openai.models.responses.ResponseInputText
 import com.openai.models.responses.ResponseItem
 import org.assertj.core.api.Assertions.assertThat
 import org.junit.jupiter.api.Test
@@ -18,7 +19,14 @@ internal class ResponseItemListTest {
                 .addData(
                     ResponseInputMessageItem.builder()
                         .id("id")
-                        .addInputTextContent("text")
+                        .addContent(
+                            ResponseInputText.builder()
+                                .text("text")
+                                .promptCacheBreakpoint(
+                                    ResponseInputText.PromptCacheBreakpoint.builder().build()
+                                )
+                                .build()
+                        )
                         .role(ResponseInputMessageItem.Role.USER)
                         .status(ResponseInputMessageItem.Status.IN_PROGRESS)
                         .build()
@@ -33,7 +41,14 @@ internal class ResponseItemListTest {
                 ResponseItem.ofResponseInputMessageItem(
                     ResponseInputMessageItem.builder()
                         .id("id")
-                        .addInputTextContent("text")
+                        .addContent(
+                            ResponseInputText.builder()
+                                .text("text")
+                                .promptCacheBreakpoint(
+                                    ResponseInputText.PromptCacheBreakpoint.builder().build()
+                                )
+                                .build()
+                        )
                         .role(ResponseInputMessageItem.Role.USER)
                         .status(ResponseInputMessageItem.Status.IN_PROGRESS)
                         .build()
@@ -52,7 +67,14 @@ internal class ResponseItemListTest {
                 .addData(
                     ResponseInputMessageItem.builder()
                         .id("id")
-                        .addInputTextContent("text")
+                        .addContent(
+                            ResponseInputText.builder()
+                                .text("text")
+                                .promptCacheBreakpoint(
+                                    ResponseInputText.PromptCacheBreakpoint.builder().build()
+                                )
+                                .build()
+                        )
                         .role(ResponseInputMessageItem.Role.USER)
                         .status(ResponseInputMessageItem.Status.IN_PROGRESS)
                         .build()
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/inputtokens/InputTokenCountParamsTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/inputtokens/InputTokenCountParamsTest.kt
index eb711c949..e026d3ea3 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/inputtokens/InputTokenCountParamsTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/inputtokens/InputTokenCountParamsTest.kt
@@ -30,6 +30,7 @@ internal class InputTokenCountParamsTest {
                     .context(Reasoning.Context.AUTO)
                     .effort(ReasoningEffort.NONE)
                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                    .mode(Reasoning.Mode.STANDARD)
                     .summary(Reasoning.Summary.AUTO)
                     .build()
             )
@@ -49,8 +50,14 @@ internal class InputTokenCountParamsTest {
                             .build()
                     )
                     .strict(true)
+                    .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                     .deferLoading(true)
                     .description("description")
+                    .outputSchema(
+                        FunctionTool.OutputSchema.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("bar"))
+                            .build()
+                    )
                     .build()
             )
             .truncation(InputTokenCountParams.Truncation.AUTO)
@@ -73,6 +80,7 @@ internal class InputTokenCountParamsTest {
                         .context(Reasoning.Context.AUTO)
                         .effort(ReasoningEffort.NONE)
                         .generateSummary(Reasoning.GenerateSummary.AUTO)
+                        .mode(Reasoning.Mode.STANDARD)
                         .summary(Reasoning.Summary.AUTO)
                         .build()
                 )
@@ -92,8 +100,14 @@ internal class InputTokenCountParamsTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
                 .truncation(InputTokenCountParams.Truncation.AUTO)
@@ -114,6 +128,7 @@ internal class InputTokenCountParamsTest {
                     .context(Reasoning.Context.AUTO)
                     .effort(ReasoningEffort.NONE)
                     .generateSummary(Reasoning.GenerateSummary.AUTO)
+                    .mode(Reasoning.Mode.STANDARD)
                     .summary(Reasoning.Summary.AUTO)
                     .build()
             )
@@ -137,8 +152,14 @@ internal class InputTokenCountParamsTest {
                                 .build()
                         )
                         .strict(true)
+                        .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                         .deferLoading(true)
                         .description("description")
+                        .outputSchema(
+                            FunctionTool.OutputSchema.builder()
+                                .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                .build()
+                        )
                         .build()
                 )
             )
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/webhooks/SafetyIdentifierBlockedWebhookEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/webhooks/SafetyIdentifierBlockedWebhookEventTest.kt
new file mode 100644
index 000000000..6238cf7b0
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/models/webhooks/SafetyIdentifierBlockedWebhookEventTest.kt
@@ -0,0 +1,74 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.models.webhooks
+
+import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
+import com.openai.core.jsonMapper
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.jupiter.api.Test
+
+internal class SafetyIdentifierBlockedWebhookEventTest {
+
+    @Test
+    fun create() {
+        val safetyIdentifierBlockedWebhookEvent =
+            SafetyIdentifierBlockedWebhookEvent.builder()
+                .id("id")
+                .createdAt(0L)
+                .data(
+                    SafetyIdentifierBlockedWebhookEvent.Data.builder()
+                        .safetyCategory("safety_category")
+                        .safetyIdentifier("safety_identifier")
+                        .model("model")
+                        .projectId("project_id")
+                        .requestId("request_id")
+                        .build()
+                )
+                .object_(SafetyIdentifierBlockedWebhookEvent.Object.EVENT)
+                .build()
+
+        assertThat(safetyIdentifierBlockedWebhookEvent.id()).isEqualTo("id")
+        assertThat(safetyIdentifierBlockedWebhookEvent.createdAt()).isEqualTo(0L)
+        assertThat(safetyIdentifierBlockedWebhookEvent.data())
+            .isEqualTo(
+                SafetyIdentifierBlockedWebhookEvent.Data.builder()
+                    .safetyCategory("safety_category")
+                    .safetyIdentifier("safety_identifier")
+                    .model("model")
+                    .projectId("project_id")
+                    .requestId("request_id")
+                    .build()
+            )
+        assertThat(safetyIdentifierBlockedWebhookEvent.object_())
+            .contains(SafetyIdentifierBlockedWebhookEvent.Object.EVENT)
+    }
+
+    @Test
+    fun roundtrip() {
+        val jsonMapper = jsonMapper()
+        val safetyIdentifierBlockedWebhookEvent =
+            SafetyIdentifierBlockedWebhookEvent.builder()
+                .id("id")
+                .createdAt(0L)
+                .data(
+                    SafetyIdentifierBlockedWebhookEvent.Data.builder()
+                        .safetyCategory("safety_category")
+                        .safetyIdentifier("safety_identifier")
+                        .model("model")
+                        .projectId("project_id")
+                        .requestId("request_id")
+                        .build()
+                )
+                .object_(SafetyIdentifierBlockedWebhookEvent.Object.EVENT)
+                .build()
+
+        val roundtrippedSafetyIdentifierBlockedWebhookEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(safetyIdentifierBlockedWebhookEvent),
+                jacksonTypeRef<SafetyIdentifierBlockedWebhookEvent>(),
+            )
+
+        assertThat(roundtrippedSafetyIdentifierBlockedWebhookEvent)
+            .isEqualTo(safetyIdentifierBlockedWebhookEvent)
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/webhooks/UnwrapWebhookEventTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/webhooks/UnwrapWebhookEventTest.kt
index daeba3517..017c69c06 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/webhooks/UnwrapWebhookEventTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/webhooks/UnwrapWebhookEventTest.kt
@@ -41,6 +41,7 @@ internal class UnwrapWebhookEventTest {
         assertThat(unwrapWebhookEvent.responseCompleted()).isEmpty
         assertThat(unwrapWebhookEvent.responseFailed()).isEmpty
         assertThat(unwrapWebhookEvent.responseIncomplete()).isEmpty
+        assertThat(unwrapWebhookEvent.safetyIdentifierBlocked()).isEmpty
     }
 
     @Test
@@ -92,6 +93,7 @@ internal class UnwrapWebhookEventTest {
         assertThat(unwrapWebhookEvent.responseCompleted()).isEmpty
         assertThat(unwrapWebhookEvent.responseFailed()).isEmpty
         assertThat(unwrapWebhookEvent.responseIncomplete()).isEmpty
+        assertThat(unwrapWebhookEvent.safetyIdentifierBlocked()).isEmpty
     }
 
     @Test
@@ -143,6 +145,7 @@ internal class UnwrapWebhookEventTest {
         assertThat(unwrapWebhookEvent.responseCompleted()).isEmpty
         assertThat(unwrapWebhookEvent.responseFailed()).isEmpty
         assertThat(unwrapWebhookEvent.responseIncomplete()).isEmpty
+        assertThat(unwrapWebhookEvent.safetyIdentifierBlocked()).isEmpty
     }
 
     @Test
@@ -194,6 +197,7 @@ internal class UnwrapWebhookEventTest {
         assertThat(unwrapWebhookEvent.responseCompleted()).isEmpty
         assertThat(unwrapWebhookEvent.responseFailed()).isEmpty
         assertThat(unwrapWebhookEvent.responseIncomplete()).isEmpty
+        assertThat(unwrapWebhookEvent.safetyIdentifierBlocked()).isEmpty
     }
 
     @Test
@@ -245,6 +249,7 @@ internal class UnwrapWebhookEventTest {
         assertThat(unwrapWebhookEvent.responseCompleted()).isEmpty
         assertThat(unwrapWebhookEvent.responseFailed()).isEmpty
         assertThat(unwrapWebhookEvent.responseIncomplete()).isEmpty
+        assertThat(unwrapWebhookEvent.safetyIdentifierBlocked()).isEmpty
     }
 
     @Test
@@ -296,6 +301,7 @@ internal class UnwrapWebhookEventTest {
         assertThat(unwrapWebhookEvent.responseCompleted()).isEmpty
         assertThat(unwrapWebhookEvent.responseFailed()).isEmpty
         assertThat(unwrapWebhookEvent.responseIncomplete()).isEmpty
+        assertThat(unwrapWebhookEvent.safetyIdentifierBlocked()).isEmpty
     }
 
     @Test
@@ -347,6 +353,7 @@ internal class UnwrapWebhookEventTest {
         assertThat(unwrapWebhookEvent.responseCompleted()).isEmpty
         assertThat(unwrapWebhookEvent.responseFailed()).isEmpty
         assertThat(unwrapWebhookEvent.responseIncomplete()).isEmpty
+        assertThat(unwrapWebhookEvent.safetyIdentifierBlocked()).isEmpty
     }
 
     @Test
@@ -398,6 +405,7 @@ internal class UnwrapWebhookEventTest {
         assertThat(unwrapWebhookEvent.responseCompleted()).isEmpty
         assertThat(unwrapWebhookEvent.responseFailed()).isEmpty
         assertThat(unwrapWebhookEvent.responseIncomplete()).isEmpty
+        assertThat(unwrapWebhookEvent.safetyIdentifierBlocked()).isEmpty
     }
 
     @Test
@@ -449,6 +457,7 @@ internal class UnwrapWebhookEventTest {
         assertThat(unwrapWebhookEvent.responseCompleted()).isEmpty
         assertThat(unwrapWebhookEvent.responseFailed()).isEmpty
         assertThat(unwrapWebhookEvent.responseIncomplete()).isEmpty
+        assertThat(unwrapWebhookEvent.safetyIdentifierBlocked()).isEmpty
     }
 
     @Test
@@ -500,6 +509,7 @@ internal class UnwrapWebhookEventTest {
         assertThat(unwrapWebhookEvent.responseCompleted()).isEmpty
         assertThat(unwrapWebhookEvent.responseFailed()).isEmpty
         assertThat(unwrapWebhookEvent.responseIncomplete()).isEmpty
+        assertThat(unwrapWebhookEvent.safetyIdentifierBlocked()).isEmpty
     }
 
     @Test
@@ -561,6 +571,7 @@ internal class UnwrapWebhookEventTest {
         assertThat(unwrapWebhookEvent.responseCompleted()).isEmpty
         assertThat(unwrapWebhookEvent.responseFailed()).isEmpty
         assertThat(unwrapWebhookEvent.responseIncomplete()).isEmpty
+        assertThat(unwrapWebhookEvent.safetyIdentifierBlocked()).isEmpty
     }
 
     @Test
@@ -622,6 +633,7 @@ internal class UnwrapWebhookEventTest {
         assertThat(unwrapWebhookEvent.responseCompleted()).isEmpty
         assertThat(unwrapWebhookEvent.responseFailed()).isEmpty
         assertThat(unwrapWebhookEvent.responseIncomplete()).isEmpty
+        assertThat(unwrapWebhookEvent.safetyIdentifierBlocked()).isEmpty
     }
 
     @Test
@@ -673,6 +685,7 @@ internal class UnwrapWebhookEventTest {
         assertThat(unwrapWebhookEvent.responseCompleted()).contains(responseCompleted)
         assertThat(unwrapWebhookEvent.responseFailed()).isEmpty
         assertThat(unwrapWebhookEvent.responseIncomplete()).isEmpty
+        assertThat(unwrapWebhookEvent.safetyIdentifierBlocked()).isEmpty
     }
 
     @Test
@@ -724,6 +737,7 @@ internal class UnwrapWebhookEventTest {
         assertThat(unwrapWebhookEvent.responseCompleted()).isEmpty
         assertThat(unwrapWebhookEvent.responseFailed()).contains(responseFailed)
         assertThat(unwrapWebhookEvent.responseIncomplete()).isEmpty
+        assertThat(unwrapWebhookEvent.safetyIdentifierBlocked()).isEmpty
     }
 
     @Test
@@ -775,6 +789,7 @@ internal class UnwrapWebhookEventTest {
         assertThat(unwrapWebhookEvent.responseCompleted()).isEmpty
         assertThat(unwrapWebhookEvent.responseFailed()).isEmpty
         assertThat(unwrapWebhookEvent.responseIncomplete()).contains(responseIncomplete)
+        assertThat(unwrapWebhookEvent.safetyIdentifierBlocked()).isEmpty
     }
 
     @Test
@@ -799,6 +814,75 @@ internal class UnwrapWebhookEventTest {
         assertThat(roundtrippedUnwrapWebhookEvent).isEqualTo(unwrapWebhookEvent)
     }
 
+    @Test
+    fun ofSafetyIdentifierBlocked() {
+        val safetyIdentifierBlocked =
+            SafetyIdentifierBlockedWebhookEvent.builder()
+                .id("id")
+                .createdAt(0L)
+                .data(
+                    SafetyIdentifierBlockedWebhookEvent.Data.builder()
+                        .safetyCategory("safety_category")
+                        .safetyIdentifier("safety_identifier")
+                        .model("model")
+                        .projectId("project_id")
+                        .requestId("request_id")
+                        .build()
+                )
+                .object_(SafetyIdentifierBlockedWebhookEvent.Object.EVENT)
+                .build()
+
+        val unwrapWebhookEvent =
+            UnwrapWebhookEvent.ofSafetyIdentifierBlocked(safetyIdentifierBlocked)
+
+        assertThat(unwrapWebhookEvent.batchCancelled()).isEmpty
+        assertThat(unwrapWebhookEvent.batchCompleted()).isEmpty
+        assertThat(unwrapWebhookEvent.batchExpired()).isEmpty
+        assertThat(unwrapWebhookEvent.batchFailed()).isEmpty
+        assertThat(unwrapWebhookEvent.evalRunCanceled()).isEmpty
+        assertThat(unwrapWebhookEvent.evalRunFailed()).isEmpty
+        assertThat(unwrapWebhookEvent.evalRunSucceeded()).isEmpty
+        assertThat(unwrapWebhookEvent.fineTuningJobCancelled()).isEmpty
+        assertThat(unwrapWebhookEvent.fineTuningJobFailed()).isEmpty
+        assertThat(unwrapWebhookEvent.fineTuningJobSucceeded()).isEmpty
+        assertThat(unwrapWebhookEvent.realtimeCallIncoming()).isEmpty
+        assertThat(unwrapWebhookEvent.responseCancelled()).isEmpty
+        assertThat(unwrapWebhookEvent.responseCompleted()).isEmpty
+        assertThat(unwrapWebhookEvent.responseFailed()).isEmpty
+        assertThat(unwrapWebhookEvent.responseIncomplete()).isEmpty
+        assertThat(unwrapWebhookEvent.safetyIdentifierBlocked()).contains(safetyIdentifierBlocked)
+    }
+
+    @Test
+    fun ofSafetyIdentifierBlockedRoundtrip() {
+        val jsonMapper = jsonMapper()
+        val unwrapWebhookEvent =
+            UnwrapWebhookEvent.ofSafetyIdentifierBlocked(
+                SafetyIdentifierBlockedWebhookEvent.builder()
+                    .id("id")
+                    .createdAt(0L)
+                    .data(
+                        SafetyIdentifierBlockedWebhookEvent.Data.builder()
+                            .safetyCategory("safety_category")
+                            .safetyIdentifier("safety_identifier")
+                            .model("model")
+                            .projectId("project_id")
+                            .requestId("request_id")
+                            .build()
+                    )
+                    .object_(SafetyIdentifierBlockedWebhookEvent.Object.EVENT)
+                    .build()
+            )
+
+        val roundtrippedUnwrapWebhookEvent =
+            jsonMapper.readValue(
+                jsonMapper.writeValueAsString(unwrapWebhookEvent),
+                jacksonTypeRef<UnwrapWebhookEvent>(),
+            )
+
+        assertThat(roundtrippedUnwrapWebhookEvent).isEqualTo(unwrapWebhookEvent)
+    }
+
     enum class IncompatibleJsonShapeTestCase(val value: JsonValue) {
         BOOLEAN(JsonValue.from(false)),
         STRING(JsonValue.from("invalid")),
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/ServiceParamsTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/ServiceParamsTest.kt
index 10a3f5b1b..a9bd9b0ce 100644
--- a/openai-java-core/src/test/kotlin/com/openai/services/ServiceParamsTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/services/ServiceParamsTest.kt
@@ -93,12 +93,42 @@ internal class ServiceParamsTest {
                         .build()
                 )
                 .addModality(ChatCompletionCreateParams.Modality.TEXT)
-                .moderation(ChatCompletionCreateParams.Moderation.builder().model("model").build())
+                .moderation(
+                    ChatCompletionCreateParams.Moderation.builder()
+                        .model("model")
+                        .policy(
+                            ChatCompletionCreateParams.Moderation.Policy.builder()
+                                .input(
+                                    ChatCompletionCreateParams.Moderation.Policy.Input.builder()
+                                        .mode(
+                                            ChatCompletionCreateParams.Moderation.Policy.Input.Mode
+                                                .SCORE
+                                        )
+                                        .build()
+                                )
+                                .output(
+                                    ChatCompletionCreateParams.Moderation.Policy.Output.builder()
+                                        .mode(
+                                            ChatCompletionCreateParams.Moderation.Policy.Output.Mode
+                                                .SCORE
+                                        )
+                                        .build()
+                                )
+                                .build()
+                        )
+                        .build()
+                )
                 .n(1L)
                 .parallelToolCalls(true)
                 .prediction(ChatCompletionPredictionContent.builder().content("string").build())
                 .presencePenalty(-2.0)
                 .promptCacheKey("prompt-cache-key-1234")
+                .promptCacheOptions(
+                    ChatCompletionCreateParams.PromptCacheOptions.builder()
+                        .mode(ChatCompletionCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                        .ttl(ChatCompletionCreateParams.PromptCacheOptions.Ttl._30M)
+                        .build()
+                )
                 .promptCacheRetention(ChatCompletionCreateParams.PromptCacheRetention.IN_MEMORY)
                 .reasoningEffort(ReasoningEffort.NONE)
                 .responseFormat(ResponseFormatText.builder().build())
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/async/ResponseServiceAsyncTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/async/ResponseServiceAsyncTest.kt
index 234f5d958..50ec0c7d0 100644
--- a/openai-java-core/src/test/kotlin/com/openai/services/async/ResponseServiceAsyncTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/services/async/ResponseServiceAsyncTest.kt
@@ -56,7 +56,31 @@ internal class ResponseServiceAsyncTest {
                             .build()
                     )
                     .model(ChatModel.GPT_5_1)
-                    .moderation(ResponseCreateParams.Moderation.builder().model("model").build())
+                    .moderation(
+                        ResponseCreateParams.Moderation.builder()
+                            .model("model")
+                            .policy(
+                                ResponseCreateParams.Moderation.Policy.builder()
+                                    .input(
+                                        ResponseCreateParams.Moderation.Policy.Input.builder()
+                                            .mode(
+                                                ResponseCreateParams.Moderation.Policy.Input.Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .output(
+                                        ResponseCreateParams.Moderation.Policy.Output.builder()
+                                            .mode(
+                                                ResponseCreateParams.Moderation.Policy.Output.Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
                     .parallelToolCalls(true)
                     .previousResponseId("previous_response_id")
                     .prompt(
@@ -71,12 +95,19 @@ internal class ResponseServiceAsyncTest {
                             .build()
                     )
                     .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        ResponseCreateParams.PromptCacheOptions.builder()
+                            .mode(ResponseCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(ResponseCreateParams.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
                     .promptCacheRetention(ResponseCreateParams.PromptCacheRetention.IN_MEMORY)
                     .reasoning(
                         Reasoning.builder()
                             .context(Reasoning.Context.AUTO)
                             .effort(ReasoningEffort.NONE)
                             .generateSummary(Reasoning.GenerateSummary.AUTO)
+                            .mode(Reasoning.Mode.STANDARD)
                             .summary(Reasoning.Summary.AUTO)
                             .build()
                     )
@@ -105,8 +136,14 @@ internal class ResponseServiceAsyncTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .topLogprobs(0L)
@@ -153,7 +190,31 @@ internal class ResponseServiceAsyncTest {
                             .build()
                     )
                     .model(ChatModel.GPT_5_1)
-                    .moderation(ResponseCreateParams.Moderation.builder().model("model").build())
+                    .moderation(
+                        ResponseCreateParams.Moderation.builder()
+                            .model("model")
+                            .policy(
+                                ResponseCreateParams.Moderation.Policy.builder()
+                                    .input(
+                                        ResponseCreateParams.Moderation.Policy.Input.builder()
+                                            .mode(
+                                                ResponseCreateParams.Moderation.Policy.Input.Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .output(
+                                        ResponseCreateParams.Moderation.Policy.Output.builder()
+                                            .mode(
+                                                ResponseCreateParams.Moderation.Policy.Output.Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
                     .parallelToolCalls(true)
                     .previousResponseId("previous_response_id")
                     .prompt(
@@ -168,12 +229,19 @@ internal class ResponseServiceAsyncTest {
                             .build()
                     )
                     .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        ResponseCreateParams.PromptCacheOptions.builder()
+                            .mode(ResponseCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(ResponseCreateParams.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
                     .promptCacheRetention(ResponseCreateParams.PromptCacheRetention.IN_MEMORY)
                     .reasoning(
                         Reasoning.builder()
                             .context(Reasoning.Context.AUTO)
                             .effort(ReasoningEffort.NONE)
                             .generateSummary(Reasoning.GenerateSummary.AUTO)
+                            .mode(Reasoning.Mode.STANDARD)
                             .summary(Reasoning.Summary.AUTO)
                             .build()
                     )
@@ -202,8 +270,14 @@ internal class ResponseServiceAsyncTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .topLogprobs(0L)
@@ -312,11 +386,17 @@ internal class ResponseServiceAsyncTest {
         val compactedResponseFuture =
             responseServiceAsync.compact(
                 ResponseCompactParams.builder()
-                    .model(ResponseCompactParams.Model.GPT_5_4)
+                    .model(ResponseCompactParams.Model.GPT_5_6_SOL)
                     .input("string")
                     .instructions("instructions")
                     .previousResponseId("resp_123")
                     .promptCacheKey("prompt_cache_key")
+                    .promptCacheOptions(
+                        ResponseCompactParams.PromptCacheOptions.builder()
+                            .mode(ResponseCompactParams.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(ResponseCompactParams.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
                     .promptCacheRetention(ResponseCompactParams.PromptCacheRetention.IN_MEMORY)
                     .serviceTier(ResponseCompactParams.ServiceTier.AUTO)
                     .build()
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/async/beta/ResponseServiceAsyncTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/async/beta/ResponseServiceAsyncTest.kt
new file mode 100644
index 000000000..fe6fcdd94
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/services/async/beta/ResponseServiceAsyncTest.kt
@@ -0,0 +1,436 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.async.beta
+
+import com.openai.TestServerExtension
+import com.openai.client.okhttp.OpenAIOkHttpClientAsync
+import com.openai.core.JsonValue
+import com.openai.models.beta.responses.BetaFunctionTool
+import com.openai.models.beta.responses.BetaResponseIncludable
+import com.openai.models.beta.responses.BetaResponsePrompt
+import com.openai.models.beta.responses.BetaResponseTextConfig
+import com.openai.models.beta.responses.BetaToolChoiceOptions
+import com.openai.models.beta.responses.ResponseCancelParams
+import com.openai.models.beta.responses.ResponseCompactParams
+import com.openai.models.beta.responses.ResponseCreateParams
+import com.openai.models.beta.responses.ResponseDeleteParams
+import com.openai.models.beta.responses.ResponseRetrieveParams
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.extension.ExtendWith
+
+@ExtendWith(TestServerExtension::class)
+internal class ResponseServiceAsyncTest {
+
+    @Test
+    fun create() {
+        val client =
+            OpenAIOkHttpClientAsync.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val responseServiceAsync = client.beta().responses()
+
+        val betaResponseFuture =
+            responseServiceAsync.create(
+                ResponseCreateParams.builder()
+                    .addBeta(ResponseCreateParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                    .background(true)
+                    .addContextManagement(
+                        ResponseCreateParams.ContextManagement.builder()
+                            .type("type")
+                            .compactThreshold(1000L)
+                            .build()
+                    )
+                    .conversation("string")
+                    .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+                    .input("string")
+                    .instructions("instructions")
+                    .maxOutputTokens(16L)
+                    .maxToolCalls(0L)
+                    .metadata(
+                        ResponseCreateParams.Metadata.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                            .build()
+                    )
+                    .model(ResponseCreateParams.Model.GPT_5_1)
+                    .moderation(
+                        ResponseCreateParams.Moderation.builder()
+                            .model("model")
+                            .policy(
+                                ResponseCreateParams.Moderation.Policy.builder()
+                                    .input(
+                                        ResponseCreateParams.Moderation.Policy.Input.builder()
+                                            .mode(
+                                                ResponseCreateParams.Moderation.Policy.Input.Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .output(
+                                        ResponseCreateParams.Moderation.Policy.Output.builder()
+                                            .mode(
+                                                ResponseCreateParams.Moderation.Policy.Output.Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .multiAgent(
+                        ResponseCreateParams.MultiAgent.builder()
+                            .enabled(true)
+                            .maxConcurrentSubagents(1L)
+                            .build()
+                    )
+                    .parallelToolCalls(true)
+                    .previousResponseId("previous_response_id")
+                    .prompt(
+                        BetaResponsePrompt.builder()
+                            .id("id")
+                            .variables(
+                                BetaResponsePrompt.Variables.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .version("version")
+                            .build()
+                    )
+                    .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        ResponseCreateParams.PromptCacheOptions.builder()
+                            .mode(ResponseCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(ResponseCreateParams.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
+                    .promptCacheRetention(ResponseCreateParams.PromptCacheRetention.IN_MEMORY)
+                    .reasoning(
+                        ResponseCreateParams.Reasoning.builder()
+                            .context(ResponseCreateParams.Reasoning.Context.AUTO)
+                            .effort(ResponseCreateParams.Reasoning.Effort.NONE)
+                            .generateSummary(ResponseCreateParams.Reasoning.GenerateSummary.AUTO)
+                            .mode(ResponseCreateParams.Reasoning.Mode.STANDARD)
+                            .summary(ResponseCreateParams.Reasoning.Summary.AUTO)
+                            .build()
+                    )
+                    .safetyIdentifier("safety-identifier-1234")
+                    .serviceTier(ResponseCreateParams.ServiceTier.AUTO)
+                    .store(true)
+                    .streamOptions(
+                        ResponseCreateParams.StreamOptions.builder()
+                            .includeObfuscation(true)
+                            .build()
+                    )
+                    .temperature(1.0)
+                    .text(
+                        BetaResponseTextConfig.builder()
+                            .formatText()
+                            .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                            .build()
+                    )
+                    .toolChoice(BetaToolChoiceOptions.NONE)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .topLogprobs(0L)
+                    .topP(1.0)
+                    .truncation(ResponseCreateParams.Truncation.AUTO)
+                    .user("user-1234")
+                    .build()
+            )
+
+        val betaResponse = betaResponseFuture.get()
+        betaResponse.validate()
+    }
+
+    @Test
+    fun createStreaming() {
+        val client =
+            OpenAIOkHttpClientAsync.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val responseServiceAsync = client.beta().responses()
+
+        val betaResponseStreamResponse =
+            responseServiceAsync.createStreaming(
+                ResponseCreateParams.builder()
+                    .addBeta(ResponseCreateParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                    .background(true)
+                    .addContextManagement(
+                        ResponseCreateParams.ContextManagement.builder()
+                            .type("type")
+                            .compactThreshold(1000L)
+                            .build()
+                    )
+                    .conversation("string")
+                    .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+                    .input("string")
+                    .instructions("instructions")
+                    .maxOutputTokens(16L)
+                    .maxToolCalls(0L)
+                    .metadata(
+                        ResponseCreateParams.Metadata.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                            .build()
+                    )
+                    .model(ResponseCreateParams.Model.GPT_5_1)
+                    .moderation(
+                        ResponseCreateParams.Moderation.builder()
+                            .model("model")
+                            .policy(
+                                ResponseCreateParams.Moderation.Policy.builder()
+                                    .input(
+                                        ResponseCreateParams.Moderation.Policy.Input.builder()
+                                            .mode(
+                                                ResponseCreateParams.Moderation.Policy.Input.Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .output(
+                                        ResponseCreateParams.Moderation.Policy.Output.builder()
+                                            .mode(
+                                                ResponseCreateParams.Moderation.Policy.Output.Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .multiAgent(
+                        ResponseCreateParams.MultiAgent.builder()
+                            .enabled(true)
+                            .maxConcurrentSubagents(1L)
+                            .build()
+                    )
+                    .parallelToolCalls(true)
+                    .previousResponseId("previous_response_id")
+                    .prompt(
+                        BetaResponsePrompt.builder()
+                            .id("id")
+                            .variables(
+                                BetaResponsePrompt.Variables.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .version("version")
+                            .build()
+                    )
+                    .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        ResponseCreateParams.PromptCacheOptions.builder()
+                            .mode(ResponseCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(ResponseCreateParams.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
+                    .promptCacheRetention(ResponseCreateParams.PromptCacheRetention.IN_MEMORY)
+                    .reasoning(
+                        ResponseCreateParams.Reasoning.builder()
+                            .context(ResponseCreateParams.Reasoning.Context.AUTO)
+                            .effort(ResponseCreateParams.Reasoning.Effort.NONE)
+                            .generateSummary(ResponseCreateParams.Reasoning.GenerateSummary.AUTO)
+                            .mode(ResponseCreateParams.Reasoning.Mode.STANDARD)
+                            .summary(ResponseCreateParams.Reasoning.Summary.AUTO)
+                            .build()
+                    )
+                    .safetyIdentifier("safety-identifier-1234")
+                    .serviceTier(ResponseCreateParams.ServiceTier.AUTO)
+                    .store(true)
+                    .streamOptions(
+                        ResponseCreateParams.StreamOptions.builder()
+                            .includeObfuscation(true)
+                            .build()
+                    )
+                    .temperature(1.0)
+                    .text(
+                        BetaResponseTextConfig.builder()
+                            .formatText()
+                            .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                            .build()
+                    )
+                    .toolChoice(BetaToolChoiceOptions.NONE)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .topLogprobs(0L)
+                    .topP(1.0)
+                    .truncation(ResponseCreateParams.Truncation.AUTO)
+                    .user("user-1234")
+                    .build()
+            )
+
+        val onCompleteFuture =
+            betaResponseStreamResponse
+                .subscribe { betaResponse -> betaResponse.validate() }
+                .onCompleteFuture()
+        onCompleteFuture.get()
+    }
+
+    @Test
+    fun retrieve() {
+        val client =
+            OpenAIOkHttpClientAsync.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val responseServiceAsync = client.beta().responses()
+
+        val betaResponseFuture =
+            responseServiceAsync.retrieve(
+                ResponseRetrieveParams.builder()
+                    .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                    .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+                    .includeObfuscation(true)
+                    .startingAfter(0L)
+                    .addBeta(ResponseRetrieveParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                    .build()
+            )
+
+        val betaResponse = betaResponseFuture.get()
+        betaResponse.validate()
+    }
+
+    @Test
+    fun retrieveStreaming() {
+        val client =
+            OpenAIOkHttpClientAsync.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val responseServiceAsync = client.beta().responses()
+
+        val betaResponseStreamResponse =
+            responseServiceAsync.retrieveStreaming(
+                ResponseRetrieveParams.builder()
+                    .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                    .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+                    .includeObfuscation(true)
+                    .startingAfter(0L)
+                    .addBeta(ResponseRetrieveParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                    .build()
+            )
+
+        val onCompleteFuture =
+            betaResponseStreamResponse
+                .subscribe { betaResponse -> betaResponse.validate() }
+                .onCompleteFuture()
+        onCompleteFuture.get()
+    }
+
+    @Test
+    fun delete() {
+        val client =
+            OpenAIOkHttpClientAsync.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val responseServiceAsync = client.beta().responses()
+
+        val future =
+            responseServiceAsync.delete(
+                ResponseDeleteParams.builder()
+                    .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                    .addBeta(ResponseDeleteParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                    .build()
+            )
+
+        val response = future.get()
+    }
+
+    @Test
+    fun cancel() {
+        val client =
+            OpenAIOkHttpClientAsync.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val responseServiceAsync = client.beta().responses()
+
+        val betaResponseFuture =
+            responseServiceAsync.cancel(
+                ResponseCancelParams.builder()
+                    .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                    .addBeta(ResponseCancelParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                    .build()
+            )
+
+        val betaResponse = betaResponseFuture.get()
+        betaResponse.validate()
+    }
+
+    @Test
+    fun compact() {
+        val client =
+            OpenAIOkHttpClientAsync.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val responseServiceAsync = client.beta().responses()
+
+        val betaCompactedResponseFuture =
+            responseServiceAsync.compact(
+                ResponseCompactParams.builder()
+                    .addBeta(ResponseCompactParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                    .model(ResponseCompactParams.Model.GPT_5_6_SOL)
+                    .input("string")
+                    .instructions("instructions")
+                    .previousResponseId("resp_123")
+                    .promptCacheKey("prompt_cache_key")
+                    .promptCacheOptions(
+                        ResponseCompactParams.PromptCacheOptions.builder()
+                            .mode(ResponseCompactParams.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(ResponseCompactParams.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
+                    .promptCacheRetention(ResponseCompactParams.PromptCacheRetention.IN_MEMORY)
+                    .serviceTier(ResponseCompactParams.ServiceTier.AUTO)
+                    .build()
+            )
+
+        val betaCompactedResponse = betaCompactedResponseFuture.get()
+        betaCompactedResponse.validate()
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/async/beta/ThreadServiceAsyncTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/async/beta/ThreadServiceAsyncTest.kt
index 3c32f60dd..20ff76611 100644
--- a/openai-java-core/src/test/kotlin/com/openai/services/async/beta/ThreadServiceAsyncTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/services/async/beta/ThreadServiceAsyncTest.kt
@@ -186,7 +186,7 @@ internal class ThreadServiceAsyncTest {
                             .putAdditionalProperty("foo", JsonValue.from("string"))
                             .build()
                     )
-                    .model(ChatModel.GPT_5_4)
+                    .model(ChatModel.GPT_5_6_SOL)
                     .parallelToolCalls(true)
                     .responseFormatAuto()
                     .temperature(1.0)
@@ -308,7 +308,7 @@ internal class ThreadServiceAsyncTest {
                             .putAdditionalProperty("foo", JsonValue.from("string"))
                             .build()
                     )
-                    .model(ChatModel.GPT_5_4)
+                    .model(ChatModel.GPT_5_6_SOL)
                     .parallelToolCalls(true)
                     .responseFormatAuto()
                     .temperature(1.0)
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/async/beta/responses/InputItemServiceAsyncTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/async/beta/responses/InputItemServiceAsyncTest.kt
new file mode 100644
index 000000000..c064753bd
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/services/async/beta/responses/InputItemServiceAsyncTest.kt
@@ -0,0 +1,28 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.async.beta.responses
+
+import com.openai.TestServerExtension
+import com.openai.client.okhttp.OpenAIOkHttpClientAsync
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.extension.ExtendWith
+
+@ExtendWith(TestServerExtension::class)
+internal class InputItemServiceAsyncTest {
+
+    @Test
+    fun list() {
+        val client =
+            OpenAIOkHttpClientAsync.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val inputItemServiceAsync = client.beta().responses().inputItems()
+
+        val pageFuture = inputItemServiceAsync.list("response_id")
+
+        val page = pageFuture.get()
+        page.response().validate()
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/async/beta/responses/InputTokenServiceAsyncTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/async/beta/responses/InputTokenServiceAsyncTest.kt
new file mode 100644
index 000000000..85b732016
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/services/async/beta/responses/InputTokenServiceAsyncTest.kt
@@ -0,0 +1,80 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.async.beta.responses
+
+import com.openai.TestServerExtension
+import com.openai.client.okhttp.OpenAIOkHttpClientAsync
+import com.openai.core.JsonValue
+import com.openai.models.beta.responses.BetaFunctionTool
+import com.openai.models.beta.responses.BetaToolChoiceOptions
+import com.openai.models.beta.responses.inputtokens.InputTokenCountParams
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.extension.ExtendWith
+
+@ExtendWith(TestServerExtension::class)
+internal class InputTokenServiceAsyncTest {
+
+    @Test
+    fun count() {
+        val client =
+            OpenAIOkHttpClientAsync.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val inputTokenServiceAsync = client.beta().responses().inputTokens()
+
+        val responseFuture =
+            inputTokenServiceAsync.count(
+                InputTokenCountParams.builder()
+                    .addBeta(InputTokenCountParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                    .conversation("string")
+                    .input("string")
+                    .instructions("instructions")
+                    .model("model")
+                    .parallelToolCalls(true)
+                    .personality(InputTokenCountParams.Personality.FRIENDLY)
+                    .previousResponseId("resp_123")
+                    .reasoning(
+                        InputTokenCountParams.Reasoning.builder()
+                            .context(InputTokenCountParams.Reasoning.Context.AUTO)
+                            .effort(InputTokenCountParams.Reasoning.Effort.NONE)
+                            .generateSummary(InputTokenCountParams.Reasoning.GenerateSummary.AUTO)
+                            .mode(InputTokenCountParams.Reasoning.Mode.STANDARD)
+                            .summary(InputTokenCountParams.Reasoning.Summary.AUTO)
+                            .build()
+                    )
+                    .text(
+                        InputTokenCountParams.Text.builder()
+                            .formatText()
+                            .verbosity(InputTokenCountParams.Text.Verbosity.LOW)
+                            .build()
+                    )
+                    .toolChoice(BetaToolChoiceOptions.NONE)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .truncation(InputTokenCountParams.Truncation.AUTO)
+                    .build()
+            )
+
+        val response = responseFuture.get()
+        response.validate()
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/async/beta/threads/RunServiceAsyncTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/async/beta/threads/RunServiceAsyncTest.kt
index ed9c64ec1..a88151547 100644
--- a/openai-java-core/src/test/kotlin/com/openai/services/async/beta/threads/RunServiceAsyncTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/services/async/beta/threads/RunServiceAsyncTest.kt
@@ -64,7 +64,7 @@ internal class RunServiceAsyncTest {
                             .putAdditionalProperty("foo", JsonValue.from("string"))
                             .build()
                     )
-                    .model(ChatModel.GPT_5_4)
+                    .model(ChatModel.GPT_5_6_SOL)
                     .parallelToolCalls(true)
                     .reasoningEffort(ReasoningEffort.NONE)
                     .responseFormatAuto()
@@ -128,7 +128,7 @@ internal class RunServiceAsyncTest {
                             .putAdditionalProperty("foo", JsonValue.from("string"))
                             .build()
                     )
-                    .model(ChatModel.GPT_5_4)
+                    .model(ChatModel.GPT_5_6_SOL)
                     .parallelToolCalls(true)
                     .reasoningEffort(ReasoningEffort.NONE)
                     .responseFormatAuto()
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/async/chat/ChatCompletionServiceAsyncTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/async/chat/ChatCompletionServiceAsyncTest.kt
index 693d1e6dc..3b159b2a9 100644
--- a/openai-java-core/src/test/kotlin/com/openai/services/async/chat/ChatCompletionServiceAsyncTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/services/async/chat/ChatCompletionServiceAsyncTest.kt
@@ -78,13 +78,44 @@ internal class ChatCompletionServiceAsyncTest {
                     )
                     .addModality(ChatCompletionCreateParams.Modality.TEXT)
                     .moderation(
-                        ChatCompletionCreateParams.Moderation.builder().model("model").build()
+                        ChatCompletionCreateParams.Moderation.builder()
+                            .model("model")
+                            .policy(
+                                ChatCompletionCreateParams.Moderation.Policy.builder()
+                                    .input(
+                                        ChatCompletionCreateParams.Moderation.Policy.Input.builder()
+                                            .mode(
+                                                ChatCompletionCreateParams.Moderation.Policy.Input
+                                                    .Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .output(
+                                        ChatCompletionCreateParams.Moderation.Policy.Output
+                                            .builder()
+                                            .mode(
+                                                ChatCompletionCreateParams.Moderation.Policy.Output
+                                                    .Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
                     )
                     .n(1L)
                     .parallelToolCalls(true)
                     .prediction(ChatCompletionPredictionContent.builder().content("string").build())
                     .presencePenalty(-2.0)
                     .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        ChatCompletionCreateParams.PromptCacheOptions.builder()
+                            .mode(ChatCompletionCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(ChatCompletionCreateParams.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
                     .promptCacheRetention(ChatCompletionCreateParams.PromptCacheRetention.IN_MEMORY)
                     .reasoningEffort(ReasoningEffort.NONE)
                     .responseFormat(ResponseFormatText.builder().build())
@@ -200,13 +231,44 @@ internal class ChatCompletionServiceAsyncTest {
                     )
                     .addModality(ChatCompletionCreateParams.Modality.TEXT)
                     .moderation(
-                        ChatCompletionCreateParams.Moderation.builder().model("model").build()
+                        ChatCompletionCreateParams.Moderation.builder()
+                            .model("model")
+                            .policy(
+                                ChatCompletionCreateParams.Moderation.Policy.builder()
+                                    .input(
+                                        ChatCompletionCreateParams.Moderation.Policy.Input.builder()
+                                            .mode(
+                                                ChatCompletionCreateParams.Moderation.Policy.Input
+                                                    .Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .output(
+                                        ChatCompletionCreateParams.Moderation.Policy.Output
+                                            .builder()
+                                            .mode(
+                                                ChatCompletionCreateParams.Moderation.Policy.Output
+                                                    .Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
                     )
                     .n(1L)
                     .parallelToolCalls(true)
                     .prediction(ChatCompletionPredictionContent.builder().content("string").build())
                     .presencePenalty(-2.0)
                     .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        ChatCompletionCreateParams.PromptCacheOptions.builder()
+                            .mode(ChatCompletionCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(ChatCompletionCreateParams.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
                     .promptCacheRetention(ChatCompletionCreateParams.PromptCacheRetention.IN_MEMORY)
                     .reasoningEffort(ReasoningEffort.NONE)
                     .responseFormat(ResponseFormatText.builder().build())
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/async/responses/InputTokenServiceAsyncTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/async/responses/InputTokenServiceAsyncTest.kt
index 933794417..ce430f975 100644
--- a/openai-java-core/src/test/kotlin/com/openai/services/async/responses/InputTokenServiceAsyncTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/services/async/responses/InputTokenServiceAsyncTest.kt
@@ -42,6 +42,7 @@ internal class InputTokenServiceAsyncTest {
                             .context(Reasoning.Context.AUTO)
                             .effort(ReasoningEffort.NONE)
                             .generateSummary(Reasoning.GenerateSummary.AUTO)
+                            .mode(Reasoning.Mode.STANDARD)
                             .summary(Reasoning.Summary.AUTO)
                             .build()
                     )
@@ -61,8 +62,14 @@ internal class InputTokenServiceAsyncTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .truncation(InputTokenCountParams.Truncation.AUTO)
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/blocking/ResponseServiceTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/blocking/ResponseServiceTest.kt
index 2685a4b70..bc4457c38 100644
--- a/openai-java-core/src/test/kotlin/com/openai/services/blocking/ResponseServiceTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/services/blocking/ResponseServiceTest.kt
@@ -56,7 +56,31 @@ internal class ResponseServiceTest {
                             .build()
                     )
                     .model(ChatModel.GPT_5_1)
-                    .moderation(ResponseCreateParams.Moderation.builder().model("model").build())
+                    .moderation(
+                        ResponseCreateParams.Moderation.builder()
+                            .model("model")
+                            .policy(
+                                ResponseCreateParams.Moderation.Policy.builder()
+                                    .input(
+                                        ResponseCreateParams.Moderation.Policy.Input.builder()
+                                            .mode(
+                                                ResponseCreateParams.Moderation.Policy.Input.Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .output(
+                                        ResponseCreateParams.Moderation.Policy.Output.builder()
+                                            .mode(
+                                                ResponseCreateParams.Moderation.Policy.Output.Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
                     .parallelToolCalls(true)
                     .previousResponseId("previous_response_id")
                     .prompt(
@@ -71,12 +95,19 @@ internal class ResponseServiceTest {
                             .build()
                     )
                     .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        ResponseCreateParams.PromptCacheOptions.builder()
+                            .mode(ResponseCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(ResponseCreateParams.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
                     .promptCacheRetention(ResponseCreateParams.PromptCacheRetention.IN_MEMORY)
                     .reasoning(
                         Reasoning.builder()
                             .context(Reasoning.Context.AUTO)
                             .effort(ReasoningEffort.NONE)
                             .generateSummary(Reasoning.GenerateSummary.AUTO)
+                            .mode(Reasoning.Mode.STANDARD)
                             .summary(Reasoning.Summary.AUTO)
                             .build()
                     )
@@ -105,8 +136,14 @@ internal class ResponseServiceTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .topLogprobs(0L)
@@ -152,7 +189,31 @@ internal class ResponseServiceTest {
                             .build()
                     )
                     .model(ChatModel.GPT_5_1)
-                    .moderation(ResponseCreateParams.Moderation.builder().model("model").build())
+                    .moderation(
+                        ResponseCreateParams.Moderation.builder()
+                            .model("model")
+                            .policy(
+                                ResponseCreateParams.Moderation.Policy.builder()
+                                    .input(
+                                        ResponseCreateParams.Moderation.Policy.Input.builder()
+                                            .mode(
+                                                ResponseCreateParams.Moderation.Policy.Input.Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .output(
+                                        ResponseCreateParams.Moderation.Policy.Output.builder()
+                                            .mode(
+                                                ResponseCreateParams.Moderation.Policy.Output.Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
                     .parallelToolCalls(true)
                     .previousResponseId("previous_response_id")
                     .prompt(
@@ -167,12 +228,19 @@ internal class ResponseServiceTest {
                             .build()
                     )
                     .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        ResponseCreateParams.PromptCacheOptions.builder()
+                            .mode(ResponseCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(ResponseCreateParams.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
                     .promptCacheRetention(ResponseCreateParams.PromptCacheRetention.IN_MEMORY)
                     .reasoning(
                         Reasoning.builder()
                             .context(Reasoning.Context.AUTO)
                             .effort(ReasoningEffort.NONE)
                             .generateSummary(Reasoning.GenerateSummary.AUTO)
+                            .mode(Reasoning.Mode.STANDARD)
                             .summary(Reasoning.Summary.AUTO)
                             .build()
                     )
@@ -201,8 +269,14 @@ internal class ResponseServiceTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .topLogprobs(0L)
@@ -307,11 +381,17 @@ internal class ResponseServiceTest {
         val compactedResponse =
             responseService.compact(
                 ResponseCompactParams.builder()
-                    .model(ResponseCompactParams.Model.GPT_5_4)
+                    .model(ResponseCompactParams.Model.GPT_5_6_SOL)
                     .input("string")
                     .instructions("instructions")
                     .previousResponseId("resp_123")
                     .promptCacheKey("prompt_cache_key")
+                    .promptCacheOptions(
+                        ResponseCompactParams.PromptCacheOptions.builder()
+                            .mode(ResponseCompactParams.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(ResponseCompactParams.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
                     .promptCacheRetention(ResponseCompactParams.PromptCacheRetention.IN_MEMORY)
                     .serviceTier(ResponseCompactParams.ServiceTier.AUTO)
                     .build()
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/ResponseServiceTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/ResponseServiceTest.kt
new file mode 100644
index 000000000..100013e41
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/ResponseServiceTest.kt
@@ -0,0 +1,425 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.blocking.beta
+
+import com.openai.TestServerExtension
+import com.openai.client.okhttp.OpenAIOkHttpClient
+import com.openai.core.JsonValue
+import com.openai.models.beta.responses.BetaFunctionTool
+import com.openai.models.beta.responses.BetaResponseIncludable
+import com.openai.models.beta.responses.BetaResponsePrompt
+import com.openai.models.beta.responses.BetaResponseTextConfig
+import com.openai.models.beta.responses.BetaToolChoiceOptions
+import com.openai.models.beta.responses.ResponseCancelParams
+import com.openai.models.beta.responses.ResponseCompactParams
+import com.openai.models.beta.responses.ResponseCreateParams
+import com.openai.models.beta.responses.ResponseDeleteParams
+import com.openai.models.beta.responses.ResponseRetrieveParams
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.extension.ExtendWith
+
+@ExtendWith(TestServerExtension::class)
+internal class ResponseServiceTest {
+
+    @Test
+    fun create() {
+        val client =
+            OpenAIOkHttpClient.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val responseService = client.beta().responses()
+
+        val betaResponse =
+            responseService.create(
+                ResponseCreateParams.builder()
+                    .addBeta(ResponseCreateParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                    .background(true)
+                    .addContextManagement(
+                        ResponseCreateParams.ContextManagement.builder()
+                            .type("type")
+                            .compactThreshold(1000L)
+                            .build()
+                    )
+                    .conversation("string")
+                    .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+                    .input("string")
+                    .instructions("instructions")
+                    .maxOutputTokens(16L)
+                    .maxToolCalls(0L)
+                    .metadata(
+                        ResponseCreateParams.Metadata.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                            .build()
+                    )
+                    .model(ResponseCreateParams.Model.GPT_5_1)
+                    .moderation(
+                        ResponseCreateParams.Moderation.builder()
+                            .model("model")
+                            .policy(
+                                ResponseCreateParams.Moderation.Policy.builder()
+                                    .input(
+                                        ResponseCreateParams.Moderation.Policy.Input.builder()
+                                            .mode(
+                                                ResponseCreateParams.Moderation.Policy.Input.Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .output(
+                                        ResponseCreateParams.Moderation.Policy.Output.builder()
+                                            .mode(
+                                                ResponseCreateParams.Moderation.Policy.Output.Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .multiAgent(
+                        ResponseCreateParams.MultiAgent.builder()
+                            .enabled(true)
+                            .maxConcurrentSubagents(1L)
+                            .build()
+                    )
+                    .parallelToolCalls(true)
+                    .previousResponseId("previous_response_id")
+                    .prompt(
+                        BetaResponsePrompt.builder()
+                            .id("id")
+                            .variables(
+                                BetaResponsePrompt.Variables.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .version("version")
+                            .build()
+                    )
+                    .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        ResponseCreateParams.PromptCacheOptions.builder()
+                            .mode(ResponseCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(ResponseCreateParams.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
+                    .promptCacheRetention(ResponseCreateParams.PromptCacheRetention.IN_MEMORY)
+                    .reasoning(
+                        ResponseCreateParams.Reasoning.builder()
+                            .context(ResponseCreateParams.Reasoning.Context.AUTO)
+                            .effort(ResponseCreateParams.Reasoning.Effort.NONE)
+                            .generateSummary(ResponseCreateParams.Reasoning.GenerateSummary.AUTO)
+                            .mode(ResponseCreateParams.Reasoning.Mode.STANDARD)
+                            .summary(ResponseCreateParams.Reasoning.Summary.AUTO)
+                            .build()
+                    )
+                    .safetyIdentifier("safety-identifier-1234")
+                    .serviceTier(ResponseCreateParams.ServiceTier.AUTO)
+                    .store(true)
+                    .streamOptions(
+                        ResponseCreateParams.StreamOptions.builder()
+                            .includeObfuscation(true)
+                            .build()
+                    )
+                    .temperature(1.0)
+                    .text(
+                        BetaResponseTextConfig.builder()
+                            .formatText()
+                            .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                            .build()
+                    )
+                    .toolChoice(BetaToolChoiceOptions.NONE)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .topLogprobs(0L)
+                    .topP(1.0)
+                    .truncation(ResponseCreateParams.Truncation.AUTO)
+                    .user("user-1234")
+                    .build()
+            )
+
+        betaResponse.validate()
+    }
+
+    @Test
+    fun createStreaming() {
+        val client =
+            OpenAIOkHttpClient.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val responseService = client.beta().responses()
+
+        val betaResponseStreamResponse =
+            responseService.createStreaming(
+                ResponseCreateParams.builder()
+                    .addBeta(ResponseCreateParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                    .background(true)
+                    .addContextManagement(
+                        ResponseCreateParams.ContextManagement.builder()
+                            .type("type")
+                            .compactThreshold(1000L)
+                            .build()
+                    )
+                    .conversation("string")
+                    .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+                    .input("string")
+                    .instructions("instructions")
+                    .maxOutputTokens(16L)
+                    .maxToolCalls(0L)
+                    .metadata(
+                        ResponseCreateParams.Metadata.builder()
+                            .putAdditionalProperty("foo", JsonValue.from("string"))
+                            .build()
+                    )
+                    .model(ResponseCreateParams.Model.GPT_5_1)
+                    .moderation(
+                        ResponseCreateParams.Moderation.builder()
+                            .model("model")
+                            .policy(
+                                ResponseCreateParams.Moderation.Policy.builder()
+                                    .input(
+                                        ResponseCreateParams.Moderation.Policy.Input.builder()
+                                            .mode(
+                                                ResponseCreateParams.Moderation.Policy.Input.Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .output(
+                                        ResponseCreateParams.Moderation.Policy.Output.builder()
+                                            .mode(
+                                                ResponseCreateParams.Moderation.Policy.Output.Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .multiAgent(
+                        ResponseCreateParams.MultiAgent.builder()
+                            .enabled(true)
+                            .maxConcurrentSubagents(1L)
+                            .build()
+                    )
+                    .parallelToolCalls(true)
+                    .previousResponseId("previous_response_id")
+                    .prompt(
+                        BetaResponsePrompt.builder()
+                            .id("id")
+                            .variables(
+                                BetaResponsePrompt.Variables.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("string"))
+                                    .build()
+                            )
+                            .version("version")
+                            .build()
+                    )
+                    .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        ResponseCreateParams.PromptCacheOptions.builder()
+                            .mode(ResponseCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(ResponseCreateParams.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
+                    .promptCacheRetention(ResponseCreateParams.PromptCacheRetention.IN_MEMORY)
+                    .reasoning(
+                        ResponseCreateParams.Reasoning.builder()
+                            .context(ResponseCreateParams.Reasoning.Context.AUTO)
+                            .effort(ResponseCreateParams.Reasoning.Effort.NONE)
+                            .generateSummary(ResponseCreateParams.Reasoning.GenerateSummary.AUTO)
+                            .mode(ResponseCreateParams.Reasoning.Mode.STANDARD)
+                            .summary(ResponseCreateParams.Reasoning.Summary.AUTO)
+                            .build()
+                    )
+                    .safetyIdentifier("safety-identifier-1234")
+                    .serviceTier(ResponseCreateParams.ServiceTier.AUTO)
+                    .store(true)
+                    .streamOptions(
+                        ResponseCreateParams.StreamOptions.builder()
+                            .includeObfuscation(true)
+                            .build()
+                    )
+                    .temperature(1.0)
+                    .text(
+                        BetaResponseTextConfig.builder()
+                            .formatText()
+                            .verbosity(BetaResponseTextConfig.Verbosity.LOW)
+                            .build()
+                    )
+                    .toolChoice(BetaToolChoiceOptions.NONE)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .topLogprobs(0L)
+                    .topP(1.0)
+                    .truncation(ResponseCreateParams.Truncation.AUTO)
+                    .user("user-1234")
+                    .build()
+            )
+
+        betaResponseStreamResponse.use {
+            betaResponseStreamResponse.stream().forEach { betaResponse -> betaResponse.validate() }
+        }
+    }
+
+    @Test
+    fun retrieve() {
+        val client =
+            OpenAIOkHttpClient.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val responseService = client.beta().responses()
+
+        val betaResponse =
+            responseService.retrieve(
+                ResponseRetrieveParams.builder()
+                    .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                    .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+                    .includeObfuscation(true)
+                    .startingAfter(0L)
+                    .addBeta(ResponseRetrieveParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                    .build()
+            )
+
+        betaResponse.validate()
+    }
+
+    @Test
+    fun retrieveStreaming() {
+        val client =
+            OpenAIOkHttpClient.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val responseService = client.beta().responses()
+
+        val betaResponseStreamResponse =
+            responseService.retrieveStreaming(
+                ResponseRetrieveParams.builder()
+                    .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                    .addInclude(BetaResponseIncludable.FILE_SEARCH_CALL_RESULTS)
+                    .includeObfuscation(true)
+                    .startingAfter(0L)
+                    .addBeta(ResponseRetrieveParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                    .build()
+            )
+
+        betaResponseStreamResponse.use {
+            betaResponseStreamResponse.stream().forEach { betaResponse -> betaResponse.validate() }
+        }
+    }
+
+    @Test
+    fun delete() {
+        val client =
+            OpenAIOkHttpClient.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val responseService = client.beta().responses()
+
+        responseService.delete(
+            ResponseDeleteParams.builder()
+                .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                .addBeta(ResponseDeleteParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                .build()
+        )
+    }
+
+    @Test
+    fun cancel() {
+        val client =
+            OpenAIOkHttpClient.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val responseService = client.beta().responses()
+
+        val betaResponse =
+            responseService.cancel(
+                ResponseCancelParams.builder()
+                    .responseId("resp_677efb5139a88190b512bc3fef8e535d")
+                    .addBeta(ResponseCancelParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                    .build()
+            )
+
+        betaResponse.validate()
+    }
+
+    @Test
+    fun compact() {
+        val client =
+            OpenAIOkHttpClient.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val responseService = client.beta().responses()
+
+        val betaCompactedResponse =
+            responseService.compact(
+                ResponseCompactParams.builder()
+                    .addBeta(ResponseCompactParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                    .model(ResponseCompactParams.Model.GPT_5_6_SOL)
+                    .input("string")
+                    .instructions("instructions")
+                    .previousResponseId("resp_123")
+                    .promptCacheKey("prompt_cache_key")
+                    .promptCacheOptions(
+                        ResponseCompactParams.PromptCacheOptions.builder()
+                            .mode(ResponseCompactParams.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(ResponseCompactParams.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
+                    .promptCacheRetention(ResponseCompactParams.PromptCacheRetention.IN_MEMORY)
+                    .serviceTier(ResponseCompactParams.ServiceTier.AUTO)
+                    .build()
+            )
+
+        betaCompactedResponse.validate()
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/ThreadServiceTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/ThreadServiceTest.kt
index 1b095af60..c6a012e25 100644
--- a/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/ThreadServiceTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/ThreadServiceTest.kt
@@ -182,7 +182,7 @@ internal class ThreadServiceTest {
                             .putAdditionalProperty("foo", JsonValue.from("string"))
                             .build()
                     )
-                    .model(ChatModel.GPT_5_4)
+                    .model(ChatModel.GPT_5_6_SOL)
                     .parallelToolCalls(true)
                     .responseFormatAuto()
                     .temperature(1.0)
@@ -303,7 +303,7 @@ internal class ThreadServiceTest {
                             .putAdditionalProperty("foo", JsonValue.from("string"))
                             .build()
                     )
-                    .model(ChatModel.GPT_5_4)
+                    .model(ChatModel.GPT_5_6_SOL)
                     .parallelToolCalls(true)
                     .responseFormatAuto()
                     .temperature(1.0)
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/responses/InputItemServiceTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/responses/InputItemServiceTest.kt
new file mode 100644
index 000000000..e503a88b4
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/responses/InputItemServiceTest.kt
@@ -0,0 +1,27 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.blocking.beta.responses
+
+import com.openai.TestServerExtension
+import com.openai.client.okhttp.OpenAIOkHttpClient
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.extension.ExtendWith
+
+@ExtendWith(TestServerExtension::class)
+internal class InputItemServiceTest {
+
+    @Test
+    fun list() {
+        val client =
+            OpenAIOkHttpClient.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val inputItemService = client.beta().responses().inputItems()
+
+        val page = inputItemService.list("response_id")
+
+        page.response().validate()
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/responses/InputTokenServiceTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/responses/InputTokenServiceTest.kt
new file mode 100644
index 000000000..c11e0cfde
--- /dev/null
+++ b/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/responses/InputTokenServiceTest.kt
@@ -0,0 +1,79 @@
+// File generated from our OpenAPI spec by Stainless.
+
+package com.openai.services.blocking.beta.responses
+
+import com.openai.TestServerExtension
+import com.openai.client.okhttp.OpenAIOkHttpClient
+import com.openai.core.JsonValue
+import com.openai.models.beta.responses.BetaFunctionTool
+import com.openai.models.beta.responses.BetaToolChoiceOptions
+import com.openai.models.beta.responses.inputtokens.InputTokenCountParams
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.extension.ExtendWith
+
+@ExtendWith(TestServerExtension::class)
+internal class InputTokenServiceTest {
+
+    @Test
+    fun count() {
+        val client =
+            OpenAIOkHttpClient.builder()
+                .baseUrl(TestServerExtension.BASE_URL)
+                .apiKey("My API Key")
+                .adminApiKey("My Admin API Key")
+                .build()
+        val inputTokenService = client.beta().responses().inputTokens()
+
+        val response =
+            inputTokenService.count(
+                InputTokenCountParams.builder()
+                    .addBeta(InputTokenCountParams.Beta.RESPONSES_MULTI_AGENT_V1)
+                    .conversation("string")
+                    .input("string")
+                    .instructions("instructions")
+                    .model("model")
+                    .parallelToolCalls(true)
+                    .personality(InputTokenCountParams.Personality.FRIENDLY)
+                    .previousResponseId("resp_123")
+                    .reasoning(
+                        InputTokenCountParams.Reasoning.builder()
+                            .context(InputTokenCountParams.Reasoning.Context.AUTO)
+                            .effort(InputTokenCountParams.Reasoning.Effort.NONE)
+                            .generateSummary(InputTokenCountParams.Reasoning.GenerateSummary.AUTO)
+                            .mode(InputTokenCountParams.Reasoning.Mode.STANDARD)
+                            .summary(InputTokenCountParams.Reasoning.Summary.AUTO)
+                            .build()
+                    )
+                    .text(
+                        InputTokenCountParams.Text.builder()
+                            .formatText()
+                            .verbosity(InputTokenCountParams.Text.Verbosity.LOW)
+                            .build()
+                    )
+                    .toolChoice(BetaToolChoiceOptions.NONE)
+                    .addTool(
+                        BetaFunctionTool.builder()
+                            .name("name")
+                            .parameters(
+                                BetaFunctionTool.Parameters.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .strict(true)
+                            .addAllowedCaller(BetaFunctionTool.AllowedCaller.DIRECT)
+                            .deferLoading(true)
+                            .description("description")
+                            .outputSchema(
+                                BetaFunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
+                            .build()
+                    )
+                    .truncation(InputTokenCountParams.Truncation.AUTO)
+                    .build()
+            )
+
+        response.validate()
+    }
+}
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/threads/RunServiceTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/threads/RunServiceTest.kt
index 73a86454c..60c4d000b 100644
--- a/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/threads/RunServiceTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/threads/RunServiceTest.kt
@@ -64,7 +64,7 @@ internal class RunServiceTest {
                             .putAdditionalProperty("foo", JsonValue.from("string"))
                             .build()
                     )
-                    .model(ChatModel.GPT_5_4)
+                    .model(ChatModel.GPT_5_6_SOL)
                     .parallelToolCalls(true)
                     .reasoningEffort(ReasoningEffort.NONE)
                     .responseFormatAuto()
@@ -127,7 +127,7 @@ internal class RunServiceTest {
                             .putAdditionalProperty("foo", JsonValue.from("string"))
                             .build()
                     )
-                    .model(ChatModel.GPT_5_4)
+                    .model(ChatModel.GPT_5_6_SOL)
                     .parallelToolCalls(true)
                     .reasoningEffort(ReasoningEffort.NONE)
                     .responseFormatAuto()
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/blocking/chat/ChatCompletionServiceTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/blocking/chat/ChatCompletionServiceTest.kt
index 1e08d5079..fb613e361 100644
--- a/openai-java-core/src/test/kotlin/com/openai/services/blocking/chat/ChatCompletionServiceTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/services/blocking/chat/ChatCompletionServiceTest.kt
@@ -78,13 +78,44 @@ internal class ChatCompletionServiceTest {
                     )
                     .addModality(ChatCompletionCreateParams.Modality.TEXT)
                     .moderation(
-                        ChatCompletionCreateParams.Moderation.builder().model("model").build()
+                        ChatCompletionCreateParams.Moderation.builder()
+                            .model("model")
+                            .policy(
+                                ChatCompletionCreateParams.Moderation.Policy.builder()
+                                    .input(
+                                        ChatCompletionCreateParams.Moderation.Policy.Input.builder()
+                                            .mode(
+                                                ChatCompletionCreateParams.Moderation.Policy.Input
+                                                    .Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .output(
+                                        ChatCompletionCreateParams.Moderation.Policy.Output
+                                            .builder()
+                                            .mode(
+                                                ChatCompletionCreateParams.Moderation.Policy.Output
+                                                    .Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
                     )
                     .n(1L)
                     .parallelToolCalls(true)
                     .prediction(ChatCompletionPredictionContent.builder().content("string").build())
                     .presencePenalty(-2.0)
                     .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        ChatCompletionCreateParams.PromptCacheOptions.builder()
+                            .mode(ChatCompletionCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(ChatCompletionCreateParams.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
                     .promptCacheRetention(ChatCompletionCreateParams.PromptCacheRetention.IN_MEMORY)
                     .reasoningEffort(ReasoningEffort.NONE)
                     .responseFormat(ResponseFormatText.builder().build())
@@ -199,13 +230,44 @@ internal class ChatCompletionServiceTest {
                     )
                     .addModality(ChatCompletionCreateParams.Modality.TEXT)
                     .moderation(
-                        ChatCompletionCreateParams.Moderation.builder().model("model").build()
+                        ChatCompletionCreateParams.Moderation.builder()
+                            .model("model")
+                            .policy(
+                                ChatCompletionCreateParams.Moderation.Policy.builder()
+                                    .input(
+                                        ChatCompletionCreateParams.Moderation.Policy.Input.builder()
+                                            .mode(
+                                                ChatCompletionCreateParams.Moderation.Policy.Input
+                                                    .Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .output(
+                                        ChatCompletionCreateParams.Moderation.Policy.Output
+                                            .builder()
+                                            .mode(
+                                                ChatCompletionCreateParams.Moderation.Policy.Output
+                                                    .Mode
+                                                    .SCORE
+                                            )
+                                            .build()
+                                    )
+                                    .build()
+                            )
+                            .build()
                     )
                     .n(1L)
                     .parallelToolCalls(true)
                     .prediction(ChatCompletionPredictionContent.builder().content("string").build())
                     .presencePenalty(-2.0)
                     .promptCacheKey("prompt-cache-key-1234")
+                    .promptCacheOptions(
+                        ChatCompletionCreateParams.PromptCacheOptions.builder()
+                            .mode(ChatCompletionCreateParams.PromptCacheOptions.Mode.IMPLICIT)
+                            .ttl(ChatCompletionCreateParams.PromptCacheOptions.Ttl._30M)
+                            .build()
+                    )
                     .promptCacheRetention(ChatCompletionCreateParams.PromptCacheRetention.IN_MEMORY)
                     .reasoningEffort(ReasoningEffort.NONE)
                     .responseFormat(ResponseFormatText.builder().build())
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/blocking/responses/InputTokenServiceTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/blocking/responses/InputTokenServiceTest.kt
index 469e9cbab..2afe02e5f 100644
--- a/openai-java-core/src/test/kotlin/com/openai/services/blocking/responses/InputTokenServiceTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/services/blocking/responses/InputTokenServiceTest.kt
@@ -42,6 +42,7 @@ internal class InputTokenServiceTest {
                             .context(Reasoning.Context.AUTO)
                             .effort(ReasoningEffort.NONE)
                             .generateSummary(Reasoning.GenerateSummary.AUTO)
+                            .mode(Reasoning.Mode.STANDARD)
                             .summary(Reasoning.Summary.AUTO)
                             .build()
                     )
@@ -61,8 +62,14 @@ internal class InputTokenServiceTest {
                                     .build()
                             )
                             .strict(true)
+                            .addAllowedCaller(FunctionTool.AllowedCaller.DIRECT)
                             .deferLoading(true)
                             .description("description")
+                            .outputSchema(
+                                FunctionTool.OutputSchema.builder()
+                                    .putAdditionalProperty("foo", JsonValue.from("bar"))
+                                    .build()
+                            )
                             .build()
                     )
                     .truncation(InputTokenCountParams.Truncation.AUTO)
diff --git a/openai-java-proguard-test/src/test/kotlin/com/openai/proguard/ProGuardCompatibilityTest.kt b/openai-java-proguard-test/src/test/kotlin/com/openai/proguard/ProGuardCompatibilityTest.kt
index a6df4f753..15c8026c0 100644
--- a/openai-java-proguard-test/src/test/kotlin/com/openai/proguard/ProGuardCompatibilityTest.kt
+++ b/openai-java-proguard-test/src/test/kotlin/com/openai/proguard/ProGuardCompatibilityTest.kt
@@ -271,6 +271,7 @@ internal class ProGuardCompatibilityTest {
                         .promptTokensDetails(
                             CompletionUsage.PromptTokensDetails.builder()
                                 .audioTokens(0L)
+                                .cacheWriteTokens(0L)
                                 .cachedTokens(0L)
                                 .build()
                         )
@@ -292,7 +293,12 @@ internal class ProGuardCompatibilityTest {
         val jsonMapper = jsonMapper()
         val chatCompletionContentPart =
             ChatCompletionContentPart.ofText(
-                ChatCompletionContentPartText.builder().text("text").build()
+                ChatCompletionContentPartText.builder()
+                    .text("text")
+                    .promptCacheBreakpoint(
+                        ChatCompletionContentPartText.PromptCacheBreakpoint.builder().build()
+                    )
+                    .build()
             )
 
         val roundtrippedChatCompletionContentPart =

From 73f67f286ef5147fc252090f9d3b8e44a857a208 Mon Sep 17 00:00:00 2001
From: Alex Chang <apcha@openai.com>
Date: Thu, 9 Jul 2026 13:13:35 -0400
Subject: [PATCH 2/6] fix(api): restore beta responses custom code

---
 .../StructuredChatCompletionCreateParams.kt   | 11 ++++++
 .../models/responses/StructuredResponse.kt    |  8 +++++
 .../StructuredResponseCreateParams.kt         | 21 ++++++++++++
 .../responses/StructuredResponseOutputItem.kt | 34 +++++++++++++++++++
 .../openai/services/async/BetaServiceAsync.kt |  4 ++-
 .../services/async/BetaServiceAsyncImpl.kt    | 10 ++++--
 .../async/beta/ResponseServiceAsyncImpl.kt    |  3 +-
 .../openai/services/blocking/BetaService.kt   |  4 ++-
 .../services/blocking/BetaServiceImpl.kt      | 10 ++++--
 .../blocking/beta/ResponseServiceImpl.kt      |  3 +-
 ...tructuredChatCompletionCreateParamsTest.kt |  4 +++
 .../StructuredResponseCreateParamsTest.kt     |  5 +++
 .../StructuredResponseOutputItemTest.kt       | 24 +++++++++++++
 .../responses/StructuredResponseTest.kt       |  2 ++
 .../async/beta/ResponseServiceAsyncTest.kt    |  5 +--
 .../blocking/beta/ResponseServiceTest.kt      |  4 +--
 16 files changed, 137 insertions(+), 15 deletions(-)

diff --git a/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/StructuredChatCompletionCreateParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/StructuredChatCompletionCreateParams.kt
index e4be88ddb..3843fc914 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/StructuredChatCompletionCreateParams.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/chat/completions/StructuredChatCompletionCreateParams.kt
@@ -413,6 +413,17 @@ internal constructor(
             paramsBuilder.promptCacheKey(promptCacheKey)
         }
 
+        /** @see ChatCompletionCreateParams.Builder.promptCacheOptions */
+        fun promptCacheOptions(promptCacheOptions: ChatCompletionCreateParams.PromptCacheOptions) =
+            apply {
+                paramsBuilder.promptCacheOptions(promptCacheOptions)
+            }
+
+        /** @see ChatCompletionCreateParams.Builder.promptCacheOptions */
+        fun promptCacheOptions(
+            promptCacheOptions: JsonField<ChatCompletionCreateParams.PromptCacheOptions>
+        ) = apply { paramsBuilder.promptCacheOptions(promptCacheOptions) }
+
         /** @see ChatCompletionCreateParams.Builder.promptCacheRetention */
         fun promptCacheRetention(
             promptCacheRetention: ChatCompletionCreateParams.PromptCacheRetention?
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/StructuredResponse.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/StructuredResponse.kt
index 7da256a1f..548284aa5 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/StructuredResponse.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/StructuredResponse.kt
@@ -88,6 +88,10 @@ class StructuredResponse<T : Any>(
     /** @see Response.promptCacheKey */
     fun promptCacheKey(): Optional<String> = rawResponse.promptCacheKey()
 
+    /** @see Response.promptCacheOptions */
+    fun promptCacheOptions(): Optional<Response.PromptCacheOptions> =
+        rawResponse.promptCacheOptions()
+
     /** @see Response.promptCacheRetention */
     fun promptCacheRetention(): Optional<Response.PromptCacheRetention> =
         rawResponse.promptCacheRetention()
@@ -186,6 +190,10 @@ class StructuredResponse<T : Any>(
     /** @see Response._promptCacheKey */
     fun _promptCacheKey(): JsonField<String> = rawResponse._promptCacheKey()
 
+    /** @see Response._promptCacheOptions */
+    fun _promptCacheOptions(): JsonField<Response.PromptCacheOptions> =
+        rawResponse._promptCacheOptions()
+
     /** @see Response._promptCacheRetention */
     fun _promptCacheRetention(): JsonField<Response.PromptCacheRetention> =
         rawResponse._promptCacheRetention()
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/StructuredResponseCreateParams.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/StructuredResponseCreateParams.kt
index 877b220f5..49b6737c8 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/StructuredResponseCreateParams.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/StructuredResponseCreateParams.kt
@@ -310,6 +310,17 @@ class StructuredResponseCreateParams<T : Any>(
             paramsBuilder.promptCacheKey(promptCacheKey)
         }
 
+        /** @see ResponseCreateParams.Builder.promptCacheOptions */
+        fun promptCacheOptions(promptCacheOptions: ResponseCreateParams.PromptCacheOptions) =
+            apply {
+                paramsBuilder.promptCacheOptions(promptCacheOptions)
+            }
+
+        /** @see ResponseCreateParams.Builder.promptCacheOptions */
+        fun promptCacheOptions(
+            promptCacheOptions: JsonField<ResponseCreateParams.PromptCacheOptions>
+        ) = apply { paramsBuilder.promptCacheOptions(promptCacheOptions) }
+
         /** @see ResponseCreateParams.Builder.promptCacheRetention */
         fun promptCacheRetention(promptCacheRetention: ResponseCreateParams.PromptCacheRetention?) =
             apply {
@@ -454,6 +465,11 @@ class StructuredResponseCreateParams<T : Any>(
         /** @see ResponseCreateParams.Builder.toolChoice */
         fun toolChoice(shell: ToolChoiceShell) = apply { paramsBuilder.toolChoice(shell) }
 
+        /** @see ResponseCreateParams.Builder.toolChoiceSpecificProgrammaticToolCallingParam */
+        fun toolChoiceSpecificProgrammaticToolCallingParam() = apply {
+            paramsBuilder.toolChoiceSpecificProgrammaticToolCallingParam()
+        }
+
         /** @see ResponseCreateParams.Builder.tools */
         fun tools(tools: List<Tool>) = apply { paramsBuilder.tools(tools) }
 
@@ -540,6 +556,11 @@ class StructuredResponseCreateParams<T : Any>(
         /** @see ResponseCreateParams.Builder.addToolLocalShell */
         fun addToolLocalShell() = apply { paramsBuilder.addToolLocalShell() }
 
+        /** @see ResponseCreateParams.Builder.addToolProgrammaticToolCalling */
+        fun addToolProgrammaticToolCalling() = apply {
+            paramsBuilder.addToolProgrammaticToolCalling()
+        }
+
         /** @see ResponseCreateParams.Builder.addTool */
         fun addTool(shell: FunctionShellTool) = apply { paramsBuilder.addTool(shell) }
 
diff --git a/openai-java-core/src/main/kotlin/com/openai/models/responses/StructuredResponseOutputItem.kt b/openai-java-core/src/main/kotlin/com/openai/models/responses/StructuredResponseOutputItem.kt
index 1eda61e00..9bc9b2966 100644
--- a/openai-java-core/src/main/kotlin/com/openai/models/responses/StructuredResponseOutputItem.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/models/responses/StructuredResponseOutputItem.kt
@@ -60,6 +60,12 @@ class StructuredResponseOutputItem<T : Any>(
     /** @see ResponseOutputItem.reasoning */
     fun reasoning(): Optional<ResponseReasoningItem> = rawOutputItem.reasoning()
 
+    /** @see ResponseOutputItem.program */
+    fun program(): Optional<ResponseOutputItem.Program> = rawOutputItem.program()
+
+    /** @see ResponseOutputItem.programOutput */
+    fun programOutput(): Optional<ResponseOutputItem.ProgramOutput> = rawOutputItem.programOutput()
+
     /** @see ResponseOutputItem.compaction */
     fun compaction(): Optional<ResponseCompactionItem> = rawOutputItem.compaction()
 
@@ -147,6 +153,12 @@ class StructuredResponseOutputItem<T : Any>(
     /** @see ResponseOutputItem.isReasoning */
     fun isReasoning(): Boolean = rawOutputItem.isReasoning()
 
+    /** @see ResponseOutputItem.isProgram */
+    fun isProgram(): Boolean = rawOutputItem.isProgram()
+
+    /** @see ResponseOutputItem.isProgramOutput */
+    fun isProgramOutput(): Boolean = rawOutputItem.isProgramOutput()
+
     /** @see ResponseOutputItem.isCompaction */
     fun isCompaction(): Boolean = rawOutputItem.isCompaction()
 
@@ -231,6 +243,12 @@ class StructuredResponseOutputItem<T : Any>(
     /** @see ResponseOutputItem.asReasoning */
     fun asReasoning(): ResponseReasoningItem = rawOutputItem.asReasoning()
 
+    /** @see ResponseOutputItem.asProgram */
+    fun asProgram(): ResponseOutputItem.Program = rawOutputItem.asProgram()
+
+    /** @see ResponseOutputItem.asProgramOutput */
+    fun asProgramOutput(): ResponseOutputItem.ProgramOutput = rawOutputItem.asProgramOutput()
+
     /** @see ResponseOutputItem.asCompaction */
     fun asCompaction(): ResponseCompactionItem = rawOutputItem.asCompaction()
 
@@ -300,6 +318,8 @@ class StructuredResponseOutputItem<T : Any>(
             isComputerCall() -> visitor.visitComputerCall(asComputerCall())
             isComputerCallOutput() -> visitor.visitComputerCallOutput(asComputerCallOutput())
             isReasoning() -> visitor.visitReasoning(asReasoning())
+            isProgram() -> visitor.visitProgram(asProgram())
+            isProgramOutput() -> visitor.visitProgramOutput(asProgramOutput())
             isCompaction() -> visitor.visitCompaction(asCompaction())
             isCodeInterpreterCall() -> visitor.visitCodeInterpreterCall(asCodeInterpreterCall())
             isImageGenerationCall() -> visitor.visitImageGenerationCall(asImageGenerationCall())
@@ -378,6 +398,14 @@ class StructuredResponseOutputItem<T : Any>(
                     reasoning.validate()
                 }
 
+                override fun visitProgram(program: ResponseOutputItem.Program) {
+                    program.validate()
+                }
+
+                override fun visitProgramOutput(programOutput: ResponseOutputItem.ProgramOutput) {
+                    programOutput.validate()
+                }
+
                 override fun visitCompaction(compaction: ResponseCompactionItem) {
                     compaction.validate()
                 }
@@ -522,6 +550,12 @@ class StructuredResponseOutputItem<T : Any>(
         /** @see ResponseOutputItem.Visitor.visitReasoning */
         fun visitReasoning(reasoning: ResponseReasoningItem): T
 
+        /** @see ResponseOutputItem.Visitor.visitProgram */
+        fun visitProgram(program: ResponseOutputItem.Program): T
+
+        /** @see ResponseOutputItem.Visitor.visitProgramOutput */
+        fun visitProgramOutput(programOutput: ResponseOutputItem.ProgramOutput): T
+
         /** @see ResponseOutputItem.Visitor.visitCompaction */
         fun visitCompaction(compaction: ResponseCompactionItem): T
 
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt b/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt
index 41deb75b4..761616917 100644
--- a/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt
@@ -5,7 +5,7 @@ package com.openai.services.async
 import com.openai.core.ClientOptions
 import com.openai.services.async.beta.AssistantServiceAsync
 import com.openai.services.async.beta.ChatKitServiceAsync
-import com.openai.services.async.beta.RealtimeServiceAsync
+import com.openai.services.async.beta.ResponseServiceAsync
 import com.openai.services.async.beta.ThreadServiceAsync
 import java.util.function.Consumer
 
@@ -23,6 +23,7 @@ interface BetaServiceAsync {
      */
     fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaServiceAsync
 
+    fun responses(): ResponseServiceAsync
 
     fun chatkit(): ChatKitServiceAsync
 
@@ -43,6 +44,7 @@ interface BetaServiceAsync {
          */
         fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaServiceAsync.WithRawResponse
 
+        fun responses(): ResponseServiceAsync.WithRawResponse
 
         fun chatkit(): ChatKitServiceAsync.WithRawResponse
 
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsyncImpl.kt b/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsyncImpl.kt
index d567c77ee..3d1aa3887 100644
--- a/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsyncImpl.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsyncImpl.kt
@@ -7,8 +7,8 @@ import com.openai.services.async.beta.AssistantServiceAsync
 import com.openai.services.async.beta.AssistantServiceAsyncImpl
 import com.openai.services.async.beta.ChatKitServiceAsync
 import com.openai.services.async.beta.ChatKitServiceAsyncImpl
-import com.openai.services.async.beta.RealtimeServiceAsync
-import com.openai.services.async.beta.RealtimeServiceAsyncImpl
+import com.openai.services.async.beta.ResponseServiceAsync
+import com.openai.services.async.beta.ResponseServiceAsyncImpl
 import com.openai.services.async.beta.ThreadServiceAsync
 import com.openai.services.async.beta.ThreadServiceAsyncImpl
 import java.util.function.Consumer
@@ -20,6 +20,7 @@ class BetaServiceAsyncImpl internal constructor(private val clientOptions: Clien
         WithRawResponseImpl(clientOptions)
     }
 
+    private val responses: ResponseServiceAsync by lazy { ResponseServiceAsyncImpl(clientOptions) }
 
     private val chatkit: ChatKitServiceAsync by lazy { ChatKitServiceAsyncImpl(clientOptions) }
 
@@ -34,6 +35,7 @@ class BetaServiceAsyncImpl internal constructor(private val clientOptions: Clien
     override fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaServiceAsync =
         BetaServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
+    override fun responses(): ResponseServiceAsync = responses
 
     override fun chatkit(): ChatKitServiceAsync = chatkit
 
@@ -47,6 +49,9 @@ class BetaServiceAsyncImpl internal constructor(private val clientOptions: Clien
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
         BetaServiceAsync.WithRawResponse {
 
+        private val responses: ResponseServiceAsync.WithRawResponse by lazy {
+            ResponseServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
 
         private val chatkit: ChatKitServiceAsync.WithRawResponse by lazy {
             ChatKitServiceAsyncImpl.WithRawResponseImpl(clientOptions)
@@ -67,6 +72,7 @@ class BetaServiceAsyncImpl internal constructor(private val clientOptions: Clien
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
+        override fun responses(): ResponseServiceAsync.WithRawResponse = responses
 
         override fun chatkit(): ChatKitServiceAsync.WithRawResponse = chatkit
 
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/async/beta/ResponseServiceAsyncImpl.kt b/openai-java-core/src/main/kotlin/com/openai/services/async/beta/ResponseServiceAsyncImpl.kt
index 9ac4eb375..8ddc77f6c 100644
--- a/openai-java-core/src/main/kotlin/com/openai/services/async/beta/ResponseServiceAsyncImpl.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/services/async/beta/ResponseServiceAsyncImpl.kt
@@ -282,7 +282,8 @@ class ResponseServiceAsyncImpl internal constructor(private val clientOptions: C
                     .method(HttpMethod.GET)
                     .baseUrl(clientOptions.baseUrl())
                     .addPathSegments("responses", params._pathParam(0))
-                    .putAllQueryParams(mapOf("beta" to "true", "stream" to "true"))
+                    .putQueryParam("beta", "true")
+                    .putQueryParam("stream", "true")
                     .putHeader("Accept", "text/event-stream")
                     .build()
                     .prepareAsync(
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaService.kt b/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaService.kt
index e8e313176..c8d55b74a 100644
--- a/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaService.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaService.kt
@@ -5,7 +5,7 @@ package com.openai.services.blocking
 import com.openai.core.ClientOptions
 import com.openai.services.blocking.beta.AssistantService
 import com.openai.services.blocking.beta.ChatKitService
-import com.openai.services.blocking.beta.RealtimeService
+import com.openai.services.blocking.beta.ResponseService
 import com.openai.services.blocking.beta.ThreadService
 import java.util.function.Consumer
 
@@ -23,6 +23,7 @@ interface BetaService {
      */
     fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaService
 
+    fun responses(): ResponseService
 
     fun chatkit(): ChatKitService
 
@@ -43,6 +44,7 @@ interface BetaService {
          */
         fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaService.WithRawResponse
 
+        fun responses(): ResponseService.WithRawResponse
 
         fun chatkit(): ChatKitService.WithRawResponse
 
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaServiceImpl.kt b/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaServiceImpl.kt
index 448a0c05f..6d43821f1 100644
--- a/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaServiceImpl.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaServiceImpl.kt
@@ -7,8 +7,8 @@ import com.openai.services.blocking.beta.AssistantService
 import com.openai.services.blocking.beta.AssistantServiceImpl
 import com.openai.services.blocking.beta.ChatKitService
 import com.openai.services.blocking.beta.ChatKitServiceImpl
-import com.openai.services.blocking.beta.RealtimeService
-import com.openai.services.blocking.beta.RealtimeServiceImpl
+import com.openai.services.blocking.beta.ResponseService
+import com.openai.services.blocking.beta.ResponseServiceImpl
 import com.openai.services.blocking.beta.ThreadService
 import com.openai.services.blocking.beta.ThreadServiceImpl
 import java.util.function.Consumer
@@ -19,6 +19,7 @@ class BetaServiceImpl internal constructor(private val clientOptions: ClientOpti
         WithRawResponseImpl(clientOptions)
     }
 
+    private val responses: ResponseService by lazy { ResponseServiceImpl(clientOptions) }
 
     private val chatkit: ChatKitService by lazy { ChatKitServiceImpl(clientOptions) }
 
@@ -31,6 +32,7 @@ class BetaServiceImpl internal constructor(private val clientOptions: ClientOpti
     override fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaService =
         BetaServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
+    override fun responses(): ResponseService = responses
 
     override fun chatkit(): ChatKitService = chatkit
 
@@ -44,6 +46,9 @@ class BetaServiceImpl internal constructor(private val clientOptions: ClientOpti
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
         BetaService.WithRawResponse {
 
+        private val responses: ResponseService.WithRawResponse by lazy {
+            ResponseServiceImpl.WithRawResponseImpl(clientOptions)
+        }
 
         private val chatkit: ChatKitService.WithRawResponse by lazy {
             ChatKitServiceImpl.WithRawResponseImpl(clientOptions)
@@ -64,6 +69,7 @@ class BetaServiceImpl internal constructor(private val clientOptions: ClientOpti
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
+        override fun responses(): ResponseService.WithRawResponse = responses
 
         override fun chatkit(): ChatKitService.WithRawResponse = chatkit
 
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/ResponseServiceImpl.kt b/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/ResponseServiceImpl.kt
index 98a378825..e5967a5e9 100644
--- a/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/ResponseServiceImpl.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/services/blocking/beta/ResponseServiceImpl.kt
@@ -258,7 +258,8 @@ class ResponseServiceImpl internal constructor(private val clientOptions: Client
                     .method(HttpMethod.GET)
                     .baseUrl(clientOptions.baseUrl())
                     .addPathSegments("responses", params._pathParam(0))
-                    .putAllQueryParams(mapOf("beta" to "true", "stream" to "true"))
+                    .putQueryParam("beta", "true")
+                    .putQueryParam("stream", "true")
                     .putHeader("Accept", "text/event-stream")
                     .build()
                     .prepare(
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/StructuredChatCompletionCreateParamsTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/StructuredChatCompletionCreateParamsTest.kt
index fecdbbd31..67bae2e09 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/StructuredChatCompletionCreateParamsTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/chat/completions/StructuredChatCompletionCreateParamsTest.kt
@@ -83,6 +83,8 @@ internal class StructuredChatCompletionCreateParamsTest {
 
         private val PROMPT_CACHE_RETENTION =
             ChatCompletionCreateParams.PromptCacheRetention.IN_MEMORY
+        private val PROMPT_CACHE_OPTIONS =
+            ChatCompletionCreateParams.PromptCacheOptions.builder().build()
         private val PROMPT_CACHE_RETENTION_OPTIONAL = Optional.of(PROMPT_CACHE_RETENTION)
         private val PROMPT_CACHE_RETENTION_JSON_FIELD = JsonField.of(PROMPT_CACHE_RETENTION)
 
@@ -232,6 +234,8 @@ internal class StructuredChatCompletionCreateParamsTest {
                 DelegationWriteTestCase("prediction", JSON_FIELD),
                 DelegationWriteTestCase("promptCacheKey", STRING),
                 DelegationWriteTestCase("promptCacheKey", JSON_FIELD),
+                DelegationWriteTestCase("promptCacheOptions", PROMPT_CACHE_OPTIONS),
+                DelegationWriteTestCase("promptCacheOptions", JSON_FIELD),
                 DelegationWriteTestCase("promptCacheRetention", PROMPT_CACHE_RETENTION),
                 DelegationWriteTestCase("promptCacheRetention", PROMPT_CACHE_RETENTION_OPTIONAL),
                 DelegationWriteTestCase("promptCacheRetention", PROMPT_CACHE_RETENTION_JSON_FIELD),
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/StructuredResponseCreateParamsTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/StructuredResponseCreateParamsTest.kt
index b4156cbb5..fcc944ec6 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/StructuredResponseCreateParamsTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/StructuredResponseCreateParamsTest.kt
@@ -63,6 +63,7 @@ internal class StructuredResponseCreateParamsTest {
         private val SERVICE_TIER = ResponseCreateParams.ServiceTier.AUTO
         private val REASONING = Reasoning.builder().build()
         private val PROMPT = ResponsePrompt.builder().id("test-prompt-id").build()
+        private val PROMPT_CACHE_OPTIONS = ResponseCreateParams.PromptCacheOptions.builder().build()
         private val RESPONSE_CONVERSATION_PARAM =
             ResponseConversationParam.builder().id(STRING).build()
         private val CONVERSATION = ResponseCreateParams.Conversation.ofId(STRING)
@@ -185,6 +186,8 @@ internal class StructuredResponseCreateParamsTest {
                 DelegationWriteTestCase("prompt", JSON_FIELD),
                 DelegationWriteTestCase("promptCacheKey", STRING),
                 DelegationWriteTestCase("promptCacheKey", JSON_FIELD),
+                DelegationWriteTestCase("promptCacheOptions", PROMPT_CACHE_OPTIONS),
+                DelegationWriteTestCase("promptCacheOptions", JSON_FIELD),
                 DelegationWriteTestCase("promptCacheRetention", PROMPT_CACHE_RETENTION),
                 DelegationWriteTestCase("promptCacheRetention", PROMPT_CACHE_RETENTION_OPTIONAL),
                 DelegationWriteTestCase("promptCacheRetention", PROMPT_CACHE_RETENTION_JSON_FIELD),
@@ -218,6 +221,7 @@ internal class StructuredResponseCreateParamsTest {
                 DelegationWriteTestCase("toolChoice", TOOL_CHOICE_CUSTOM),
                 DelegationWriteTestCase("toolChoice", TOOL_CHOICE_APPLY_PATCH),
                 DelegationWriteTestCase("toolChoice", TOOL_CHOICE_SHELL),
+                DelegationWriteTestCase("toolChoiceSpecificProgrammaticToolCallingParam"),
                 DelegationWriteTestCase("tools", LIST),
                 DelegationWriteTestCase("tools", JSON_FIELD),
                 DelegationWriteTestCase("addTool", TOOL),
@@ -240,6 +244,7 @@ internal class StructuredResponseCreateParamsTest {
                 DelegationWriteTestCase("addCodeInterpreterTool", CODE_INTERPRETER_TOOL_AUTO),
                 DelegationWriteTestCase("addTool", IMAGE_GENERATION_TOOL),
                 DelegationWriteTestCase("addToolLocalShell"),
+                DelegationWriteTestCase("addToolProgrammaticToolCalling"),
                 DelegationWriteTestCase("addTool", FUNCTION_SHELL_TOOL),
                 DelegationWriteTestCase("addTool", CUSTOM_TOOL),
                 DelegationWriteTestCase("addCustomTool", STRING),
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/StructuredResponseOutputItemTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/StructuredResponseOutputItemTest.kt
index 8075af612..7f850b69a 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/StructuredResponseOutputItemTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/StructuredResponseOutputItemTest.kt
@@ -118,6 +118,20 @@ internal class StructuredResponseOutputItemTest {
                 .build()
         private val REASONING_ITEM =
             ResponseReasoningItem.builder().id(STRING).summary(listOf()).build()
+        private val PROGRAM =
+            ResponseOutputItem.Program.builder()
+                .id(STRING)
+                .callId(STRING)
+                .code(STRING)
+                .fingerprint(STRING)
+                .build()
+        private val PROGRAM_OUTPUT =
+            ResponseOutputItem.ProgramOutput.builder()
+                .id(STRING)
+                .callId(STRING)
+                .result(STRING)
+                .status(ResponseOutputItem.ProgramOutput.Status.COMPLETED)
+                .build()
         private val COMPACTION_ITEM =
             ResponseCompactionItem.builder().id(STRING).encryptedContent(STRING).build()
         private val CODE_INTERPRETER_CALL =
@@ -262,6 +276,8 @@ internal class StructuredResponseOutputItemTest {
                 DelegationReadTestCase("computerCall", OPTIONAL),
                 DelegationReadTestCase("computerCallOutput", OPTIONAL),
                 DelegationReadTestCase("reasoning", OPTIONAL),
+                DelegationReadTestCase("program", OPTIONAL),
+                DelegationReadTestCase("programOutput", OPTIONAL),
                 DelegationReadTestCase("compaction", OPTIONAL),
                 DelegationReadTestCase("localShellCall", OPTIONAL),
                 DelegationReadTestCase("localShellCallOutput", OPTIONAL),
@@ -298,6 +314,10 @@ internal class StructuredResponseOutputItemTest {
                 DelegationReadTestCase("isComputerCallOutput", false),
                 DelegationReadTestCase("isReasoning", true),
                 DelegationReadTestCase("isReasoning", false),
+                DelegationReadTestCase("isProgram", true),
+                DelegationReadTestCase("isProgram", false),
+                DelegationReadTestCase("isProgramOutput", true),
+                DelegationReadTestCase("isProgramOutput", false),
                 DelegationReadTestCase("isCompaction", true),
                 DelegationReadTestCase("isCompaction", false),
                 DelegationReadTestCase("isLocalShellCall", true),
@@ -335,6 +355,8 @@ internal class StructuredResponseOutputItemTest {
                 DelegationReadTestCase("asComputerCall", COMPUTER_TOOL_CALL),
                 DelegationReadTestCase("asComputerCallOutput", COMPUTER_TOOL_CALL_OUTPUT),
                 DelegationReadTestCase("asReasoning", REASONING_ITEM),
+                DelegationReadTestCase("asProgram", PROGRAM),
+                DelegationReadTestCase("asProgramOutput", PROGRAM_OUTPUT),
                 DelegationReadTestCase("asCompaction", COMPACTION_ITEM),
                 DelegationReadTestCase("asCodeInterpreterCall", CODE_INTERPRETER_CALL),
                 DelegationReadTestCase("asImageGenerationCall", IMAGE_GENERATION_CALL),
@@ -420,6 +442,8 @@ internal class StructuredResponseOutputItemTest {
                     "visitCodeInterpreterCall",
                     "visitImageGenerationCall",
                     "visitCompaction",
+                    "visitProgram",
+                    "visitProgramOutput",
                     "visitFunctionCallOutput",
                     "visitComputerCallOutput",
                     "visitMcpApprovalRequest",
diff --git a/openai-java-core/src/test/kotlin/com/openai/models/responses/StructuredResponseTest.kt b/openai-java-core/src/test/kotlin/com/openai/models/responses/StructuredResponseTest.kt
index 8496c5716..84c744171 100644
--- a/openai-java-core/src/test/kotlin/com/openai/models/responses/StructuredResponseTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/models/responses/StructuredResponseTest.kt
@@ -76,6 +76,7 @@ internal class StructuredResponseTest {
                 DelegationReadTestCase("previousResponseId", OPTIONAL),
                 DelegationReadTestCase("prompt", OPTIONAL),
                 DelegationReadTestCase("promptCacheKey", OPTIONAL),
+                DelegationReadTestCase("promptCacheOptions", OPTIONAL),
                 DelegationReadTestCase("promptCacheRetention", OPTIONAL),
                 DelegationReadTestCase("reasoning", OPTIONAL),
                 DelegationReadTestCase("safetyIdentifier", OPTIONAL),
@@ -105,6 +106,7 @@ internal class StructuredResponseTest {
                 DelegationReadTestCase("_previousResponseId", JSON_FIELD),
                 DelegationReadTestCase("_prompt", JSON_FIELD),
                 DelegationReadTestCase("_promptCacheKey", JSON_FIELD),
+                DelegationReadTestCase("_promptCacheOptions", JSON_FIELD),
                 DelegationReadTestCase("_promptCacheRetention", JSON_FIELD),
                 DelegationReadTestCase("_reasoning", JSON_FIELD),
                 DelegationReadTestCase("_safetyIdentifier", JSON_FIELD),
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/async/beta/ResponseServiceAsyncTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/async/beta/ResponseServiceAsyncTest.kt
index fe6fcdd94..3817d8406 100644
--- a/openai-java-core/src/test/kotlin/com/openai/services/async/beta/ResponseServiceAsyncTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/services/async/beta/ResponseServiceAsyncTest.kt
@@ -297,10 +297,7 @@ internal class ResponseServiceAsyncTest {
                     .build()
             )
 
-        val onCompleteFuture =
-            betaResponseStreamResponse
-                .subscribe { betaResponse -> betaResponse.validate() }
-                .onCompleteFuture()
+        val onCompleteFuture = betaResponseStreamResponse.subscribe {}.onCompleteFuture()
         onCompleteFuture.get()
     }
 
diff --git a/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/ResponseServiceTest.kt b/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/ResponseServiceTest.kt
index 100013e41..172a277f8 100644
--- a/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/ResponseServiceTest.kt
+++ b/openai-java-core/src/test/kotlin/com/openai/services/blocking/beta/ResponseServiceTest.kt
@@ -296,9 +296,7 @@ internal class ResponseServiceTest {
                     .build()
             )
 
-        betaResponseStreamResponse.use {
-            betaResponseStreamResponse.stream().forEach { betaResponse -> betaResponse.validate() }
-        }
+        betaResponseStreamResponse.use { check(betaResponseStreamResponse.stream().count() > 0) }
     }
 
     @Test

From a1cd1f1ad58f7009073819765792d62995650da7 Mon Sep 17 00:00:00 2001
From: Alex Chang <apcha@openai.com>
Date: Thu, 9 Jul 2026 14:12:07 -0400
Subject: [PATCH 3/6] fix(api): preserve deprecated beta realtime accessors

---
 .../openai/services/async/BetaServiceAsync.kt  | 11 +++++++++++
 .../services/async/BetaServiceAsyncImpl.kt     | 18 ++++++++++++++++++
 .../openai/services/blocking/BetaService.kt    | 11 +++++++++++
 .../services/blocking/BetaServiceImpl.kt       | 18 ++++++++++++++++++
 4 files changed, 58 insertions(+)

diff --git a/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt b/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt
index 761616917..42c3fd7cf 100644
--- a/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt
@@ -5,6 +5,7 @@ package com.openai.services.async
 import com.openai.core.ClientOptions
 import com.openai.services.async.beta.AssistantServiceAsync
 import com.openai.services.async.beta.ChatKitServiceAsync
+import com.openai.services.async.beta.RealtimeServiceAsync
 import com.openai.services.async.beta.ResponseServiceAsync
 import com.openai.services.async.beta.ThreadServiceAsync
 import java.util.function.Consumer
@@ -23,6 +24,11 @@ interface BetaServiceAsync {
      */
     fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaServiceAsync
 
+    @Deprecated(
+        "Realtime has now launched and is generally available. The old beta API is now deprecated."
+    )
+    fun realtime(): RealtimeServiceAsync
+
     fun responses(): ResponseServiceAsync
 
     fun chatkit(): ChatKitServiceAsync
@@ -44,6 +50,11 @@ interface BetaServiceAsync {
          */
         fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaServiceAsync.WithRawResponse
 
+        @Deprecated(
+            "Realtime has now launched and is generally available. The old beta API is now deprecated."
+        )
+        fun realtime(): RealtimeServiceAsync.WithRawResponse
+
         fun responses(): ResponseServiceAsync.WithRawResponse
 
         fun chatkit(): ChatKitServiceAsync.WithRawResponse
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsyncImpl.kt b/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsyncImpl.kt
index 3d1aa3887..2dc0b526a 100644
--- a/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsyncImpl.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsyncImpl.kt
@@ -7,6 +7,8 @@ import com.openai.services.async.beta.AssistantServiceAsync
 import com.openai.services.async.beta.AssistantServiceAsyncImpl
 import com.openai.services.async.beta.ChatKitServiceAsync
 import com.openai.services.async.beta.ChatKitServiceAsyncImpl
+import com.openai.services.async.beta.RealtimeServiceAsync
+import com.openai.services.async.beta.RealtimeServiceAsyncImpl
 import com.openai.services.async.beta.ResponseServiceAsync
 import com.openai.services.async.beta.ResponseServiceAsyncImpl
 import com.openai.services.async.beta.ThreadServiceAsync
@@ -20,6 +22,8 @@ class BetaServiceAsyncImpl internal constructor(private val clientOptions: Clien
         WithRawResponseImpl(clientOptions)
     }
 
+    private val realtime: RealtimeServiceAsync by lazy { RealtimeServiceAsyncImpl(clientOptions) }
+
     private val responses: ResponseServiceAsync by lazy { ResponseServiceAsyncImpl(clientOptions) }
 
     private val chatkit: ChatKitServiceAsync by lazy { ChatKitServiceAsyncImpl(clientOptions) }
@@ -35,6 +39,11 @@ class BetaServiceAsyncImpl internal constructor(private val clientOptions: Clien
     override fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaServiceAsync =
         BetaServiceAsyncImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
+    @Deprecated(
+        "Realtime has now launched and is generally available. The old beta API is now deprecated."
+    )
+    override fun realtime(): RealtimeServiceAsync = realtime
+
     override fun responses(): ResponseServiceAsync = responses
 
     override fun chatkit(): ChatKitServiceAsync = chatkit
@@ -49,6 +58,10 @@ class BetaServiceAsyncImpl internal constructor(private val clientOptions: Clien
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
         BetaServiceAsync.WithRawResponse {
 
+        private val realtime: RealtimeServiceAsync.WithRawResponse by lazy {
+            RealtimeServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
         private val responses: ResponseServiceAsync.WithRawResponse by lazy {
             ResponseServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
@@ -72,6 +85,11 @@ class BetaServiceAsyncImpl internal constructor(private val clientOptions: Clien
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
+        @Deprecated(
+            "Realtime has now launched and is generally available. The old beta API is now deprecated."
+        )
+        override fun realtime(): RealtimeServiceAsync.WithRawResponse = realtime
+
         override fun responses(): ResponseServiceAsync.WithRawResponse = responses
 
         override fun chatkit(): ChatKitServiceAsync.WithRawResponse = chatkit
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaService.kt b/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaService.kt
index c8d55b74a..fc0cc5644 100644
--- a/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaService.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaService.kt
@@ -5,6 +5,7 @@ package com.openai.services.blocking
 import com.openai.core.ClientOptions
 import com.openai.services.blocking.beta.AssistantService
 import com.openai.services.blocking.beta.ChatKitService
+import com.openai.services.blocking.beta.RealtimeService
 import com.openai.services.blocking.beta.ResponseService
 import com.openai.services.blocking.beta.ThreadService
 import java.util.function.Consumer
@@ -23,6 +24,11 @@ interface BetaService {
      */
     fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaService
 
+    @Deprecated(
+        "Realtime has now launched and is generally available. The old beta API is now deprecated."
+    )
+    fun realtime(): RealtimeService
+
     fun responses(): ResponseService
 
     fun chatkit(): ChatKitService
@@ -44,6 +50,11 @@ interface BetaService {
          */
         fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaService.WithRawResponse
 
+        @Deprecated(
+            "Realtime has now launched and is generally available. The old beta API is now deprecated."
+        )
+        fun realtime(): RealtimeService.WithRawResponse
+
         fun responses(): ResponseService.WithRawResponse
 
         fun chatkit(): ChatKitService.WithRawResponse
diff --git a/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaServiceImpl.kt b/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaServiceImpl.kt
index 6d43821f1..c2c2bc220 100644
--- a/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaServiceImpl.kt
+++ b/openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaServiceImpl.kt
@@ -7,6 +7,8 @@ import com.openai.services.blocking.beta.AssistantService
 import com.openai.services.blocking.beta.AssistantServiceImpl
 import com.openai.services.blocking.beta.ChatKitService
 import com.openai.services.blocking.beta.ChatKitServiceImpl
+import com.openai.services.blocking.beta.RealtimeService
+import com.openai.services.blocking.beta.RealtimeServiceImpl
 import com.openai.services.blocking.beta.ResponseService
 import com.openai.services.blocking.beta.ResponseServiceImpl
 import com.openai.services.blocking.beta.ThreadService
@@ -19,6 +21,8 @@ class BetaServiceImpl internal constructor(private val clientOptions: ClientOpti
         WithRawResponseImpl(clientOptions)
     }
 
+    private val realtime: RealtimeService by lazy { RealtimeServiceImpl(clientOptions) }
+
     private val responses: ResponseService by lazy { ResponseServiceImpl(clientOptions) }
 
     private val chatkit: ChatKitService by lazy { ChatKitServiceImpl(clientOptions) }
@@ -32,6 +36,11 @@ class BetaServiceImpl internal constructor(private val clientOptions: ClientOpti
     override fun withOptions(modifier: Consumer<ClientOptions.Builder>): BetaService =
         BetaServiceImpl(clientOptions.toBuilder().apply(modifier::accept).build())
 
+    @Deprecated(
+        "Realtime has now launched and is generally available. The old beta API is now deprecated."
+    )
+    override fun realtime(): RealtimeService = realtime
+
     override fun responses(): ResponseService = responses
 
     override fun chatkit(): ChatKitService = chatkit
@@ -46,6 +55,10 @@ class BetaServiceImpl internal constructor(private val clientOptions: ClientOpti
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
         BetaService.WithRawResponse {
 
+        private val realtime: RealtimeService.WithRawResponse by lazy {
+            RealtimeServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
         private val responses: ResponseService.WithRawResponse by lazy {
             ResponseServiceImpl.WithRawResponseImpl(clientOptions)
         }
@@ -69,6 +82,11 @@ class BetaServiceImpl internal constructor(private val clientOptions: ClientOpti
                 clientOptions.toBuilder().apply(modifier::accept).build()
             )
 
+        @Deprecated(
+            "Realtime has now launched and is generally available. The old beta API is now deprecated."
+        )
+        override fun realtime(): RealtimeService.WithRawResponse = realtime
+
         override fun responses(): ResponseService.WithRawResponse = responses
 
         override fun chatkit(): ChatKitService.WithRawResponse = chatkit

From a3006ee468a3e4d4167368cf5a2e66590e4a65a0 Mon Sep 17 00:00:00 2001
From: Alex Chang <apcha@openai.com>
Date: Thu, 9 Jul 2026 14:32:26 -0400
Subject: [PATCH 4/6] chore: retrigger release automation


From 449baf79c38c6384c66c495a6786d4507bf0b5c9 Mon Sep 17 00:00:00 2001
From: "stainless-app[bot]"
 <142633134+stainless-app[bot]@users.noreply.github.com>
Date: Thu, 9 Jul 2026 18:39:51 +0000
Subject: [PATCH 5/6] codegen metadata

---
 .stats.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.stats.yml b/.stats.yml
index 4e142c3c3..2fd90dc18 100644
--- a/.stats.yml
+++ b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 270
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai/openai-356010b9b9fd6228b457b8fcfa376cf4928a8f3bd4728e7ba5e4b6b5ef4f5843.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai/openai-39637fc9365e6f80f12424e7c87179553f157b96b47c599b96d5a02f6966d3da.yml
 openapi_spec_hash: 885864ae98a443166f585f856c464fb2
-config_hash: 1f1e3b4050e2cb4bc780ce0b70e2b3e6
+config_hash: b40012963b4619be8229fcca0105b627

From 6bbc5a6f88ec1bd1b171c2ef9b573fb611157f86 Mon Sep 17 00:00:00 2001
From: Alex Chang <apcha@openai.com>
Date: Thu, 9 Jul 2026 15:25:32 -0400
Subject: [PATCH 6/6] release: 4.42.0

---
 .release-please-manifest.json |  2 +-
 CHANGELOG.md                  | 18 ++++++++++++++++++
 README.md                     | 14 +++++++-------
 build.gradle.kts              |  2 +-
 4 files changed, 27 insertions(+), 9 deletions(-)

diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 807cc3abe..803fec4ac 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "4.41.0"
+  ".": "4.42.0"
 }
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3b43c539f..4d98688b0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,23 @@
 # Changelog
 
+## [4.42.0](https://github.com/openai/openai-java/compare/v4.41.0...v4.42.0) (2026-07-09)
+
+
+### Features
+
+* **api:** gpt-5.6-sol updates ([2ca768a](https://github.com/openai/openai-java/commit/2ca768ad80da1643680ce99fee977080e19f2e2b))
+
+
+### Bug Fixes
+
+* **api:** preserve deprecated beta realtime accessors ([a1cd1f1](https://github.com/openai/openai-java/commit/a1cd1f1ad58f7009073819765792d62995650da7))
+* **api:** restore beta responses custom code ([73f67f2](https://github.com/openai/openai-java/commit/73f67f286ef5147fc252090f9d3b8e44a857a208))
+
+
+### Chores
+
+* retrigger release automation ([a3006ee](https://github.com/openai/openai-java/commit/a3006ee468a3e4d4167368cf5a2e66590e4a65a0))
+
 ## 4.41.0 (2026-06-17)
 
 Full Changelog: [v4.40.0...v4.41.0](https://github.com/openai/openai-java/compare/v4.40.0...v4.41.0)
diff --git a/README.md b/README.md
index 3fc418846..e8ba7a1ec 100644
--- a/README.md
+++ b/README.md
@@ -2,8 +2,8 @@
 
 <!-- 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/4.41.0)
-[![javadoc](https://javadoc.io/badge2/com.openai/openai-java/4.41.0/javadoc.svg)](https://javadoc.io/doc/com.openai/openai-java/4.41.0)
+[![Maven Central](https://img.shields.io/maven-central/v/com.openai/openai-java)](https://central.sonatype.com/artifact/com.openai/openai-java/4.42.0)
+[![javadoc](https://javadoc.io/badge2/com.openai/openai-java/4.42.0/javadoc.svg)](https://javadoc.io/doc/com.openai/openai-java/4.42.0)
 
 <!-- x-release-please-end -->
 
@@ -11,7 +11,7 @@ The OpenAI Java SDK provides convenient access to the [OpenAI REST API](https://
 
 <!-- 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/4.41.0).
+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/4.42.0).
 
 <!-- x-release-please-end -->
 
@@ -24,7 +24,7 @@ The REST API documentation can be found on [platform.openai.com](https://platfor
 ### Gradle
 
 ```kotlin
-implementation("com.openai:openai-java:4.41.0")
+implementation("com.openai:openai-java:4.42.0")
 ```
 
 ### Maven
@@ -33,7 +33,7 @@ implementation("com.openai:openai-java:4.41.0")
 <dependency>
   <groupId>com.openai</groupId>
   <artifactId>openai-java</artifactId>
-  <version>4.41.0</version>
+  <version>4.42.0</version>
 </dependency>
 ```
 
@@ -1433,7 +1433,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:4.41.0")
+implementation("com.openai:openai-java-spring-boot-starter:4.42.0")
 ```
 
 #### Maven
@@ -1442,7 +1442,7 @@ implementation("com.openai:openai-java-spring-boot-starter:4.41.0")
 <dependency>
   <groupId>com.openai</groupId>
   <artifactId>openai-java-spring-boot-starter</artifactId>
-  <version>4.41.0</version>
+  <version>4.42.0</version>
 </dependency>
 ```
 
diff --git a/build.gradle.kts b/build.gradle.kts
index 0a533a3ee..98cc6dac2 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -8,7 +8,7 @@ repositories {
 
 allprojects {
     group = "com.openai"
-    version = "4.41.0" // x-release-please-version
+    version = "4.42.0" // x-release-please-version
 }
 
 subprojects {